From 1f64a1bb551829b57f0b8403ce4aab641a6ee11d Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
<66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Thu, 5 Sep 2024 11:07:32 +0200
Subject: [PATCH 001/504] =?UTF-8?q?=E2=AC=86=20[pre-commit.ci]=20pre-commi?=
=?UTF-8?q?t=20autoupdate=20(#12115)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
* ⬆ [pre-commit.ci] pre-commit autoupdate
updates:
- [github.com/astral-sh/ruff-pre-commit: v0.6.2 → v0.6.3](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.2...v0.6.3)
* bump ruff as well
---------
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Sofie Van Landeghem <svlandeg@users.noreply.github.com>
Co-authored-by: svlandeg <svlandeg@github.com>
---
.pre-commit-config.yaml | 2 +-
requirements-tests.txt | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 317514062..7e58afd4b 100644
--- a/.pre-commit-config.yaml
+++ b/.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.6.2
+ rev: v0.6.3
hooks:
- id: ruff
args:
diff --git a/requirements-tests.txt b/requirements-tests.txt
index 08561d23a..de5fdb8a2 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -3,7 +3,7 @@
pytest >=7.1.3,<8.0.0
coverage[toml] >= 6.5.0,< 8.0
mypy ==1.8.0
-ruff ==0.6.1
+ruff ==0.6.3
dirty-equals ==0.6.0
# TODO: once removing databases from tutorial, upgrade SQLAlchemy
# probably when including SQLModel
From 68e5ef6968f8a2799d9db927b5db5b8e86d8b5f0 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 5 Sep 2024 09:07:55 +0000
Subject: [PATCH 002/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 70dbce539..c54971b73 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -39,6 +39,7 @@ hide:
### Internal
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12115](https://github.com/fastapi/fastapi/pull/12115) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* ⬆ Bump pypa/gh-action-pypi-publish from 1.10.0 to 1.10.1. PR [#12120](https://github.com/fastapi/fastapi/pull/12120) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump pillow from 10.3.0 to 10.4.0. PR [#12105](https://github.com/fastapi/fastapi/pull/12105) by [@dependabot[bot]](https://github.com/apps/dependabot).
* 💚 Set `include-hidden-files` to `True` when using the `upload-artifact` GH action. PR [#12118](https://github.com/fastapi/fastapi/pull/12118) by [@svlandeg](https://github.com/svlandeg).
From 7213d421f5bf0a4b9b8815e69a141550b4fc3f09 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 11:13:32 +0200
Subject: [PATCH 003/504] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
=?UTF-8?q?2.3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
fastapi/__init__.py | 2 +-
2 files changed, 5 insertions(+), 1 deletion(-)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c54971b73..cdd6cdc90 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+## 0.112.3
+
+This release is mainly internal refactors, it shouldn't affect apps using FastAPI in any way. You don't even have to upgrade to this version yet. There are a few bigger releases coming right after. 🚀
+
### Refactors
* ♻️ Refactor internal `check_file_field()`, rename to `ensure_multipart_is_installed()` to clarify its purpose. PR [#12106](https://github.com/fastapi/fastapi/pull/12106) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index ac2508d89..1bc1bfd82 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
"""FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
-__version__ = "0.112.2"
+__version__ = "0.112.3"
from starlette import status as status
From aa21814a89853c17c139054a5c51f0bb1ea68a0a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 13:24:36 +0200
Subject: [PATCH 004/504] =?UTF-8?q?=E2=99=BB=EF=B8=8F=20Refactor=20decidin?=
=?UTF-8?q?g=20if=20`embed`=20body=20fields,=20do=20not=20overwrite=20fiel?=
=?UTF-8?q?ds,=20compute=20once=20per=20router,=20refactor=20internals=20i?=
=?UTF-8?q?n=20preparation=20for=20Pydantic=20models=20in=20`Form`,=20`Que?=
=?UTF-8?q?ry`=20and=20others=20(#12117)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
fastapi/_compat.py | 15 ++
fastapi/dependencies/utils.py | 300 ++++++++++++++++++-------------
fastapi/param_functions.py | 4 +-
fastapi/params.py | 3 +-
fastapi/routing.py | 26 ++-
tests/test_compat.py | 13 +-
tests/test_forms_single_param.py | 99 ++++++++++
7 files changed, 324 insertions(+), 136 deletions(-)
create mode 100644 tests/test_forms_single_param.py
diff --git a/fastapi/_compat.py b/fastapi/_compat.py
index 06b847b4f..f940d6597 100644
--- a/fastapi/_compat.py
+++ b/fastapi/_compat.py
@@ -279,6 +279,12 @@ if PYDANTIC_V2:
BodyModel: Type[BaseModel] = create_model(model_name, **field_params) # type: ignore[call-overload]
return BodyModel
+ def get_model_fields(model: Type[BaseModel]) -> List[ModelField]:
+ return [
+ ModelField(field_info=field_info, name=name)
+ for name, field_info in model.model_fields.items()
+ ]
+
else:
from fastapi.openapi.constants import REF_PREFIX as REF_PREFIX
from pydantic import AnyUrl as Url # noqa: F401
@@ -513,6 +519,9 @@ else:
BodyModel.__fields__[f.name] = f # type: ignore[index]
return BodyModel
+ def get_model_fields(model: Type[BaseModel]) -> List[ModelField]:
+ return list(model.__fields__.values()) # type: ignore[attr-defined]
+
def _regenerate_error_with_loc(
*, errors: Sequence[Any], loc_prefix: Tuple[Union[str, int], ...]
@@ -532,6 +541,12 @@ def _annotation_is_sequence(annotation: Union[Type[Any], None]) -> bool:
def field_annotation_is_sequence(annotation: Union[Type[Any], None]) -> bool:
+ origin = get_origin(annotation)
+ if origin is Union or origin is UnionType:
+ for arg in get_args(annotation):
+ if field_annotation_is_sequence(arg):
+ return True
+ return False
return _annotation_is_sequence(annotation) or _annotation_is_sequence(
get_origin(annotation)
)
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 0dcba62f1..7ac18d941 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -59,7 +59,13 @@ from fastapi.utils import create_model_field, get_path_param_names
from pydantic.fields import FieldInfo
from starlette.background import BackgroundTasks as StarletteBackgroundTasks
from starlette.concurrency import run_in_threadpool
-from starlette.datastructures import FormData, Headers, QueryParams, UploadFile
+from starlette.datastructures import (
+ FormData,
+ Headers,
+ ImmutableMultiDict,
+ QueryParams,
+ UploadFile,
+)
from starlette.requests import HTTPConnection, Request
from starlette.responses import Response
from starlette.websockets import WebSocket
@@ -282,7 +288,7 @@ def get_dependant(
), f"Cannot specify multiple FastAPI annotations for {param_name!r}"
continue
assert param_details.field is not None
- if is_body_param(param_field=param_details.field, is_path_param=is_path_param):
+ if isinstance(param_details.field.field_info, params.Body):
dependant.body_params.append(param_details.field)
else:
add_param_to_fields(field=param_details.field, dependant=dependant)
@@ -466,29 +472,16 @@ def analyze_param(
required=field_info.default in (Required, Undefined),
field_info=field_info,
)
+ if is_path_param:
+ assert is_scalar_field(
+ field=field
+ ), "Path params must be of one of the supported types"
+ elif isinstance(field_info, params.Query):
+ assert is_scalar_field(field) or is_scalar_sequence_field(field)
return ParamDetails(type_annotation=type_annotation, depends=depends, field=field)
-def is_body_param(*, param_field: ModelField, is_path_param: bool) -> bool:
- if is_path_param:
- assert is_scalar_field(
- field=param_field
- ), "Path params must be of one of the supported types"
- return False
- elif is_scalar_field(field=param_field):
- return False
- elif isinstance(
- param_field.field_info, (params.Query, params.Header)
- ) and is_scalar_sequence_field(param_field):
- return False
- else:
- assert isinstance(
- param_field.field_info, params.Body
- ), f"Param: {param_field.name} can only be a request body, using Body()"
- return True
-
-
def add_param_to_fields(*, field: ModelField, dependant: Dependant) -> None:
field_info = field.field_info
field_info_in = getattr(field_info, "in_", None)
@@ -557,6 +550,7 @@ async def solve_dependencies(
dependency_overrides_provider: Optional[Any] = None,
dependency_cache: Optional[Dict[Tuple[Callable[..., Any], Tuple[str]], Any]] = None,
async_exit_stack: AsyncExitStack,
+ embed_body_fields: bool,
) -> SolvedDependency:
values: Dict[str, Any] = {}
errors: List[Any] = []
@@ -598,6 +592,7 @@ async def solve_dependencies(
dependency_overrides_provider=dependency_overrides_provider,
dependency_cache=dependency_cache,
async_exit_stack=async_exit_stack,
+ embed_body_fields=embed_body_fields,
)
background_tasks = solved_result.background_tasks
dependency_cache.update(solved_result.dependency_cache)
@@ -640,7 +635,9 @@ async def solve_dependencies(
body_values,
body_errors,
) = await request_body_to_args( # body_params checked above
- required_params=dependant.body_params, received_body=body
+ body_fields=dependant.body_params,
+ received_body=body,
+ embed_body_fields=embed_body_fields,
)
values.update(body_values)
errors.extend(body_errors)
@@ -669,138 +666,185 @@ async def solve_dependencies(
)
+def _validate_value_with_model_field(
+ *, field: ModelField, value: Any, values: Dict[str, Any], loc: Tuple[str, ...]
+) -> Tuple[Any, List[Any]]:
+ if value is None:
+ if field.required:
+ return None, [get_missing_field_error(loc=loc)]
+ else:
+ return deepcopy(field.default), []
+ v_, errors_ = field.validate(value, values, loc=loc)
+ if isinstance(errors_, ErrorWrapper):
+ return None, [errors_]
+ elif isinstance(errors_, list):
+ new_errors = _regenerate_error_with_loc(errors=errors_, loc_prefix=())
+ return None, new_errors
+ else:
+ return v_, []
+
+
+def _get_multidict_value(field: ModelField, values: Mapping[str, Any]) -> Any:
+ if is_sequence_field(field) and isinstance(values, (ImmutableMultiDict, Headers)):
+ value = values.getlist(field.alias)
+ else:
+ value = values.get(field.alias, None)
+ if (
+ value is None
+ or (
+ isinstance(field.field_info, params.Form)
+ and isinstance(value, str) # For type checks
+ and value == ""
+ )
+ or (is_sequence_field(field) and len(value) == 0)
+ ):
+ if field.required:
+ return
+ else:
+ return deepcopy(field.default)
+ return value
+
+
def request_params_to_args(
- required_params: Sequence[ModelField],
+ fields: Sequence[ModelField],
received_params: Union[Mapping[str, Any], QueryParams, Headers],
) -> Tuple[Dict[str, Any], List[Any]]:
- values = {}
+ values: Dict[str, Any] = {}
errors = []
- for field in required_params:
- if is_scalar_sequence_field(field) and isinstance(
- received_params, (QueryParams, Headers)
- ):
- value = received_params.getlist(field.alias) or field.default
- else:
- value = received_params.get(field.alias)
+ for field in fields:
+ value = _get_multidict_value(field, received_params)
field_info = field.field_info
assert isinstance(
field_info, params.Param
), "Params must be subclasses of Param"
loc = (field_info.in_.value, field.alias)
- if value is None:
- if field.required:
- errors.append(get_missing_field_error(loc=loc))
- else:
- values[field.name] = deepcopy(field.default)
- continue
- v_, errors_ = field.validate(value, values, loc=loc)
- if isinstance(errors_, ErrorWrapper):
- errors.append(errors_)
- elif isinstance(errors_, list):
- new_errors = _regenerate_error_with_loc(errors=errors_, loc_prefix=())
- errors.extend(new_errors)
+ v_, errors_ = _validate_value_with_model_field(
+ field=field, value=value, values=values, loc=loc
+ )
+ if errors_:
+ errors.extend(errors_)
else:
values[field.name] = v_
return values, errors
+def _should_embed_body_fields(fields: List[ModelField]) -> bool:
+ if not fields:
+ return False
+ # More than one dependency could have the same field, it would show up as multiple
+ # fields but it's the same one, so count them by name
+ body_param_names_set = {field.name for field in fields}
+ # A top level field has to be a single field, not multiple
+ if len(body_param_names_set) > 1:
+ return True
+ first_field = fields[0]
+ # 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
+ # otherwise it has to be embedded, so that the key value pair can be extracted
+ if isinstance(first_field.field_info, params.Form):
+ return True
+ return False
+
+
+async def _extract_form_body(
+ body_fields: List[ModelField],
+ received_body: FormData,
+) -> Dict[str, Any]:
+ values = {}
+ first_field = body_fields[0]
+ first_field_info = first_field.field_info
+
+ for field in body_fields:
+ value = _get_multidict_value(field, received_body)
+ if (
+ isinstance(first_field_info, params.File)
+ and is_bytes_field(field)
+ and isinstance(value, UploadFile)
+ ):
+ value = await value.read()
+ elif (
+ is_bytes_sequence_field(field)
+ and isinstance(first_field_info, params.File)
+ and value_is_sequence(value)
+ ):
+ # For types
+ assert isinstance(value, sequence_types) # type: ignore[arg-type]
+ results: List[Union[bytes, str]] = []
+
+ async def process_fn(
+ fn: Callable[[], Coroutine[Any, Any, Any]],
+ ) -> None:
+ result = await fn()
+ results.append(result) # noqa: B023
+
+ async with anyio.create_task_group() as tg:
+ for sub_value in value:
+ tg.start_soon(process_fn, sub_value.read)
+ value = serialize_sequence_value(field=field, value=results)
+ values[field.name] = value
+ return values
+
+
async def request_body_to_args(
- required_params: List[ModelField],
+ body_fields: List[ModelField],
received_body: Optional[Union[Dict[str, Any], FormData]],
+ embed_body_fields: bool,
) -> Tuple[Dict[str, Any], List[Dict[str, Any]]]:
- values = {}
+ values: Dict[str, Any] = {}
errors: List[Dict[str, Any]] = []
- if required_params:
- field = required_params[0]
- field_info = field.field_info
- embed = getattr(field_info, "embed", None)
- field_alias_omitted = len(required_params) == 1 and not embed
- if field_alias_omitted:
- received_body = {field.alias: received_body}
-
- for field in required_params:
- loc: Tuple[str, ...]
- if field_alias_omitted:
- loc = ("body",)
- else:
- loc = ("body", field.alias)
-
- value: Optional[Any] = None
- if received_body is not None:
- if (is_sequence_field(field)) and isinstance(received_body, FormData):
- value = received_body.getlist(field.alias)
- else:
- try:
- value = received_body.get(field.alias)
- except AttributeError:
- errors.append(get_missing_field_error(loc))
- continue
- if (
- value is None
- or (isinstance(field_info, params.Form) and value == "")
- or (
- isinstance(field_info, params.Form)
- and is_sequence_field(field)
- and len(value) == 0
- )
- ):
- if field.required:
- errors.append(get_missing_field_error(loc))
- else:
- values[field.name] = deepcopy(field.default)
+ assert body_fields, "request_body_to_args() should be called with fields"
+ single_not_embedded_field = len(body_fields) == 1 and not embed_body_fields
+ first_field = body_fields[0]
+ body_to_process = received_body
+ if isinstance(received_body, FormData):
+ body_to_process = await _extract_form_body(body_fields, received_body)
+
+ if single_not_embedded_field:
+ loc: Tuple[str, ...] = ("body",)
+ v_, errors_ = _validate_value_with_model_field(
+ field=first_field, value=body_to_process, values=values, loc=loc
+ )
+ return {first_field.name: v_}, errors_
+ for field in body_fields:
+ loc = ("body", field.alias)
+ value: Optional[Any] = None
+ if body_to_process is not None:
+ try:
+ value = body_to_process.get(field.alias)
+ # If the received body is a list, not a dict
+ except AttributeError:
+ errors.append(get_missing_field_error(loc))
continue
- if (
- isinstance(field_info, params.File)
- and is_bytes_field(field)
- and isinstance(value, UploadFile)
- ):
- value = await value.read()
- elif (
- is_bytes_sequence_field(field)
- and isinstance(field_info, params.File)
- and value_is_sequence(value)
- ):
- # For types
- assert isinstance(value, sequence_types) # type: ignore[arg-type]
- results: List[Union[bytes, str]] = []
-
- async def process_fn(
- fn: Callable[[], Coroutine[Any, Any, Any]],
- ) -> None:
- result = await fn()
- results.append(result) # noqa: B023
-
- async with anyio.create_task_group() as tg:
- for sub_value in value:
- tg.start_soon(process_fn, sub_value.read)
- value = serialize_sequence_value(field=field, value=results)
-
- v_, errors_ = field.validate(value, values, loc=loc)
-
- if isinstance(errors_, list):
- errors.extend(errors_)
- elif errors_:
- errors.append(errors_)
- else:
- values[field.name] = v_
+ v_, errors_ = _validate_value_with_model_field(
+ field=field, value=value, values=values, loc=loc
+ )
+ if errors_:
+ errors.extend(errors_)
+ else:
+ values[field.name] = v_
return values, errors
-def get_body_field(*, dependant: Dependant, name: str) -> Optional[ModelField]:
- flat_dependant = get_flat_dependant(dependant)
+def get_body_field(
+ *, flat_dependant: Dependant, name: str, embed_body_fields: bool
+) -> Optional[ModelField]:
+ """
+ Get a ModelField representing the request body for a path operation, combining
+ all body parameters into a single field if necessary.
+
+ Used to check if it's form data (with `isinstance(body_field, params.Form)`)
+ or JSON and to generate the JSON Schema for a request body.
+
+ This is **not** used to validate/parse the request body, that's done with each
+ individual body parameter.
+ """
if not flat_dependant.body_params:
return None
first_param = flat_dependant.body_params[0]
- field_info = first_param.field_info
- embed = getattr(field_info, "embed", None)
- body_param_names_set = {param.name for param in flat_dependant.body_params}
- if len(body_param_names_set) == 1 and not embed:
+ if not embed_body_fields:
return first_param
- # If one field requires to embed, all have to be embedded
- # in case a sub-dependency is evaluated with a single unique body field
- # That is combined (embedded) with other body fields
- for param in flat_dependant.body_params:
- setattr(param.field_info, "embed", True) # noqa: B010
model_name = "Body_" + name
BodyModel = create_body_model(
fields=flat_dependant.body_params, model_name=model_name
diff --git a/fastapi/param_functions.py b/fastapi/param_functions.py
index 0d5f27af4..7ddaace25 100644
--- a/fastapi/param_functions.py
+++ b/fastapi/param_functions.py
@@ -1282,7 +1282,7 @@ def Body( # noqa: N802
),
] = _Unset,
embed: Annotated[
- bool,
+ Union[bool, None],
Doc(
"""
When `embed` is `True`, the parameter will be expected in a JSON body as a
@@ -1294,7 +1294,7 @@ def Body( # noqa: N802
[FastAPI docs for Body - Multiple Parameters](https://fastapi.tiangolo.com/tutorial/body-multiple-params/#embed-a-single-body-parameter).
"""
),
- ] = False,
+ ] = None,
media_type: Annotated[
str,
Doc(
diff --git a/fastapi/params.py b/fastapi/params.py
index cc2a5c13c..3dfa5a1a3 100644
--- a/fastapi/params.py
+++ b/fastapi/params.py
@@ -479,7 +479,7 @@ class Body(FieldInfo):
*,
default_factory: Union[Callable[[], Any], None] = _Unset,
annotation: Optional[Any] = None,
- embed: bool = False,
+ embed: Union[bool, None] = None,
media_type: str = "application/json",
alias: Optional[str] = None,
alias_priority: Union[int, None] = _Unset,
@@ -642,7 +642,6 @@ class Form(Body):
default=default,
default_factory=default_factory,
annotation=annotation,
- embed=True,
media_type=media_type,
alias=alias,
alias_priority=alias_priority,
diff --git a/fastapi/routing.py b/fastapi/routing.py
index 61a112fc4..86e303602 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -33,8 +33,10 @@ from fastapi._compat import (
from fastapi.datastructures import Default, DefaultPlaceholder
from fastapi.dependencies.models import Dependant
from fastapi.dependencies.utils import (
+ _should_embed_body_fields,
get_body_field,
get_dependant,
+ get_flat_dependant,
get_parameterless_sub_dependant,
get_typed_return_annotation,
solve_dependencies,
@@ -225,6 +227,7 @@ def get_request_handler(
response_model_exclude_defaults: bool = False,
response_model_exclude_none: bool = False,
dependency_overrides_provider: Optional[Any] = None,
+ embed_body_fields: bool = False,
) -> Callable[[Request], Coroutine[Any, Any, Response]]:
assert dependant.call is not None, "dependant.call must be a function"
is_coroutine = asyncio.iscoroutinefunction(dependant.call)
@@ -291,6 +294,7 @@ def get_request_handler(
body=body,
dependency_overrides_provider=dependency_overrides_provider,
async_exit_stack=async_exit_stack,
+ embed_body_fields=embed_body_fields,
)
errors = solved_result.errors
if not errors:
@@ -354,7 +358,9 @@ def get_request_handler(
def get_websocket_app(
- dependant: Dependant, dependency_overrides_provider: Optional[Any] = None
+ dependant: Dependant,
+ dependency_overrides_provider: Optional[Any] = None,
+ embed_body_fields: bool = False,
) -> Callable[[WebSocket], Coroutine[Any, Any, Any]]:
async def app(websocket: WebSocket) -> None:
async with AsyncExitStack() as async_exit_stack:
@@ -367,6 +373,7 @@ def get_websocket_app(
dependant=dependant,
dependency_overrides_provider=dependency_overrides_provider,
async_exit_stack=async_exit_stack,
+ embed_body_fields=embed_body_fields,
)
if solved_result.errors:
raise WebSocketRequestValidationError(
@@ -399,11 +406,15 @@ class APIWebSocketRoute(routing.WebSocketRoute):
0,
get_parameterless_sub_dependant(depends=depends, path=self.path_format),
)
-
+ self._flat_dependant = get_flat_dependant(self.dependant)
+ self._embed_body_fields = _should_embed_body_fields(
+ self._flat_dependant.body_params
+ )
self.app = websocket_session(
get_websocket_app(
dependant=self.dependant,
dependency_overrides_provider=dependency_overrides_provider,
+ embed_body_fields=self._embed_body_fields,
)
)
@@ -544,7 +555,15 @@ class APIRoute(routing.Route):
0,
get_parameterless_sub_dependant(depends=depends, path=self.path_format),
)
- self.body_field = get_body_field(dependant=self.dependant, name=self.unique_id)
+ self._flat_dependant = get_flat_dependant(self.dependant)
+ self._embed_body_fields = _should_embed_body_fields(
+ self._flat_dependant.body_params
+ )
+ self.body_field = get_body_field(
+ flat_dependant=self._flat_dependant,
+ name=self.unique_id,
+ embed_body_fields=self._embed_body_fields,
+ )
self.app = request_response(self.get_route_handler())
def get_route_handler(self) -> Callable[[Request], Coroutine[Any, Any, Response]]:
@@ -561,6 +580,7 @@ class APIRoute(routing.Route):
response_model_exclude_defaults=self.response_model_exclude_defaults,
response_model_exclude_none=self.response_model_exclude_none,
dependency_overrides_provider=self.dependency_overrides_provider,
+ embed_body_fields=self._embed_body_fields,
)
def matches(self, scope: Scope) -> Tuple[Match, Scope]:
diff --git a/tests/test_compat.py b/tests/test_compat.py
index bf268b860..270475bf3 100644
--- a/tests/test_compat.py
+++ b/tests/test_compat.py
@@ -1,11 +1,13 @@
-from typing import List, Union
+from typing import Any, Dict, List, Union
from fastapi import FastAPI, UploadFile
from fastapi._compat import (
ModelField,
Undefined,
_get_model_config,
+ get_model_fields,
is_bytes_sequence_annotation,
+ is_scalar_field,
is_uploadfile_sequence_annotation,
)
from fastapi.testclient import TestClient
@@ -91,3 +93,12 @@ def test_is_uploadfile_sequence_annotation():
# and other types, but I'm not even sure it's a good idea to support it as a first
# class "feature"
assert is_uploadfile_sequence_annotation(Union[List[str], List[UploadFile]])
+
+
+def test_is_pv1_scalar_field():
+ # For coverage
+ class Model(BaseModel):
+ foo: Union[str, Dict[str, Any]]
+
+ fields = get_model_fields(Model)
+ assert not is_scalar_field(fields[0])
diff --git a/tests/test_forms_single_param.py b/tests/test_forms_single_param.py
new file mode 100644
index 000000000..3bb951441
--- /dev/null
+++ b/tests/test_forms_single_param.py
@@ -0,0 +1,99 @@
+from fastapi import FastAPI, Form
+from fastapi.testclient import TestClient
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+@app.post("/form/")
+def post_form(username: Annotated[str, Form()]):
+ return username
+
+
+client = TestClient(app)
+
+
+def test_single_form_field():
+ response = client.post("/form/", data={"username": "Rick"})
+ assert response.status_code == 200, response.text
+ assert response.json() == "Rick"
+
+
+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/": {
+ "post": {
+ "summary": "Post Form",
+ "operationId": "post_form_form__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {
+ "$ref": "#/components/schemas/Body_post_form_form__post"
+ }
+ }
+ },
+ "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": {
+ "Body_post_form_form__post": {
+ "properties": {"username": {"type": "string", "title": "Username"}},
+ "type": "object",
+ "required": ["username"],
+ "title": "Body_post_form_form__post",
+ },
+ "HTTPValidationError": {
+ "properties": {
+ "detail": {
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ "type": "array",
+ "title": "Detail",
+ }
+ },
+ "type": "object",
+ "title": "HTTPValidationError",
+ },
+ "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",
+ },
+ }
+ },
+ }
From 832e634fd4b8c4e1a5714b5ad73f2cdc04e05e43 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 5 Sep 2024 11:25:02 +0000
Subject: [PATCH 005/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index cdd6cdc90..2fe884615 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Refactors
+
+* ♻️ Refactor deciding if `embed` body fields, do not overwrite fields, compute once per router, refactor internals in preparation for Pydantic models in `Form`, `Query` and others. PR [#12117](https://github.com/fastapi/fastapi/pull/12117) by [@tiangolo](https://github.com/tiangolo).
+
## 0.112.3
This release is mainly internal refactors, it shouldn't affect apps using FastAPI in any way. You don't even have to upgrade to this version yet. There are a few bigger releases coming right after. 🚀
From 0f3e65b00712a59d763cf9c7715cde353bb94b02 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 16:40:48 +0200
Subject: [PATCH 006/504] =?UTF-8?q?=E2=9C=A8=20Add=20support=20for=20Pydan?=
=?UTF-8?q?tic=20models=20in=20`Form`=20parameters=20(#12127)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../tutorial/request-form-models/image01.png | Bin 0 -> 44487 bytes
docs/en/docs/tutorial/request-form-models.md | 65 +++++
docs/en/mkdocs.yml | 1 +
docs_src/request_form_models/tutorial001.py | 14 +
.../request_form_models/tutorial001_an.py | 15 ++
.../tutorial001_an_py39.py | 16 ++
fastapi/dependencies/utils.py | 17 +-
.../playwright/request_form_models/image01.py | 36 +++
tests/test_forms_single_model.py | 129 ++++++++++
.../test_request_form_models/__init__.py | 0
.../test_tutorial001.py | 232 +++++++++++++++++
.../test_tutorial001_an.py | 232 +++++++++++++++++
.../test_tutorial001_an_py39.py | 240 ++++++++++++++++++
13 files changed, 994 insertions(+), 3 deletions(-)
create mode 100644 docs/en/docs/img/tutorial/request-form-models/image01.png
create mode 100644 docs/en/docs/tutorial/request-form-models.md
create mode 100644 docs_src/request_form_models/tutorial001.py
create mode 100644 docs_src/request_form_models/tutorial001_an.py
create mode 100644 docs_src/request_form_models/tutorial001_an_py39.py
create mode 100644 scripts/playwright/request_form_models/image01.py
create mode 100644 tests/test_forms_single_model.py
create mode 100644 tests/test_tutorial/test_request_form_models/__init__.py
create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001.py
create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py
diff --git a/docs/en/docs/img/tutorial/request-form-models/image01.png b/docs/en/docs/img/tutorial/request-form-models/image01.png
new file mode 100644
index 0000000000000000000000000000000000000000..3fe32c03d589e76abec5e9c6b71374ebd4e8cd2c
GIT binary patch
literal 44487
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
CMaG{1
literal 0
HcmV?d00001
diff --git a/docs/en/docs/tutorial/request-form-models.md b/docs/en/docs/tutorial/request-form-models.md
new file mode 100644
index 000000000..8bb1ffb1f
--- /dev/null
+++ b/docs/en/docs/tutorial/request-form-models.md
@@ -0,0 +1,65 @@
+# Form Models
+
+You can use Pydantic models to declare form fields in FastAPI.
+
+/// info
+
+To use forms, first install <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
+
+Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install it, for example:
+
+```console
+$ pip install python-multipart
+```
+
+///
+
+/// note
+
+This is supported since FastAPI version `0.113.0`. 🤓
+
+///
+
+## Pydantic Models for Forms
+
+You just need to declare a Pydantic model with the fields you want to receive as form fields, and then declare the parameter as `Form`:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9-11 15"
+{!> ../../../docs_src/request_form_models/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="8-10 14"
+{!> ../../../docs_src/request_form_models/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="7-9 13"
+{!> ../../../docs_src/request_form_models/tutorial001.py!}
+```
+
+////
+
+FastAPI will extract the data for each field from the form data in the request and give you the Pydantic model you defined.
+
+## Check the Docs
+
+You can verify it in the docs UI at `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/request-form-models/image01.png">
+</div>
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 528c80b8e..7c810c2d7 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -129,6 +129,7 @@ nav:
- tutorial/extra-models.md
- tutorial/response-status-code.md
- tutorial/request-forms.md
+ - tutorial/request-form-models.md
- tutorial/request-files.md
- tutorial/request-forms-and-files.md
- tutorial/handling-errors.md
diff --git a/docs_src/request_form_models/tutorial001.py b/docs_src/request_form_models/tutorial001.py
new file mode 100644
index 000000000..98feff0b9
--- /dev/null
+++ b/docs_src/request_form_models/tutorial001.py
@@ -0,0 +1,14 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+
+
+@app.post("/login/")
+async def login(data: FormData = Form()):
+ return data
diff --git a/docs_src/request_form_models/tutorial001_an.py b/docs_src/request_form_models/tutorial001_an.py
new file mode 100644
index 000000000..30483d445
--- /dev/null
+++ b/docs_src/request_form_models/tutorial001_an.py
@@ -0,0 +1,15 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+ return data
diff --git a/docs_src/request_form_models/tutorial001_an_py39.py b/docs_src/request_form_models/tutorial001_an_py39.py
new file mode 100644
index 000000000..7cc81aae9
--- /dev/null
+++ b/docs_src/request_form_models/tutorial001_an_py39.py
@@ -0,0 +1,16 @@
+from typing import Annotated
+
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+ return data
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 7ac18d941..98ce17b55 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -33,6 +33,7 @@ from fastapi._compat import (
field_annotation_is_scalar,
get_annotation_from_field_info,
get_missing_field_error,
+ get_model_fields,
is_bytes_field,
is_bytes_sequence_field,
is_scalar_field,
@@ -56,6 +57,7 @@ from fastapi.security.base import SecurityBase
from fastapi.security.oauth2 import OAuth2, SecurityScopes
from fastapi.security.open_id_connect_url import OpenIdConnect
from fastapi.utils import create_model_field, get_path_param_names
+from pydantic import BaseModel
from pydantic.fields import FieldInfo
from starlette.background import BackgroundTasks as StarletteBackgroundTasks
from starlette.concurrency import run_in_threadpool
@@ -743,7 +745,9 @@ def _should_embed_body_fields(fields: List[ModelField]) -> bool:
return True
# If it's a Form (or File) field, it has to be a BaseModel 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):
+ if isinstance(first_field.field_info, params.Form) and not lenient_issubclass(
+ first_field.type_, BaseModel
+ ):
return True
return False
@@ -783,7 +787,8 @@ async def _extract_form_body(
for sub_value in value:
tg.start_soon(process_fn, sub_value.read)
value = serialize_sequence_value(field=field, value=results)
- values[field.name] = value
+ if value is not None:
+ values[field.name] = value
return values
@@ -798,8 +803,14 @@ async def request_body_to_args(
single_not_embedded_field = len(body_fields) == 1 and not embed_body_fields
first_field = body_fields[0]
body_to_process = received_body
+
+ fields_to_extract: List[ModelField] = body_fields
+
+ if single_not_embedded_field and lenient_issubclass(first_field.type_, BaseModel):
+ fields_to_extract = get_model_fields(first_field.type_)
+
if isinstance(received_body, FormData):
- body_to_process = await _extract_form_body(body_fields, received_body)
+ body_to_process = await _extract_form_body(fields_to_extract, received_body)
if single_not_embedded_field:
loc: Tuple[str, ...] = ("body",)
diff --git a/scripts/playwright/request_form_models/image01.py b/scripts/playwright/request_form_models/image01.py
new file mode 100644
index 000000000..15bd3858c
--- /dev/null
+++ b/scripts/playwright/request_form_models/image01.py
@@ -0,0 +1,36 @@
+import subprocess
+import time
+
+import httpx
+from playwright.sync_api import Playwright, sync_playwright
+
+
+# Run playwright codegen to generate the code below, copy paste the sections in run()
+def run(playwright: Playwright) -> None:
+ browser = playwright.chromium.launch(headless=False)
+ context = browser.new_context()
+ page = context.new_page()
+ page.goto("http://localhost:8000/docs")
+ page.get_by_role("button", name="POST /login/ Login").click()
+ page.get_by_role("button", name="Try it out").click()
+ page.screenshot(path="docs/en/docs/img/tutorial/request-form-models/image01.png")
+
+ # ---------------------
+ context.close()
+ browser.close()
+
+
+process = subprocess.Popen(
+ ["fastapi", "run", "docs_src/request_form_models/tutorial001.py"]
+)
+try:
+ for _ in range(3):
+ try:
+ response = httpx.get("http://localhost:8000/docs")
+ except httpx.ConnectError:
+ time.sleep(1)
+ break
+ with sync_playwright() as playwright:
+ run(playwright)
+finally:
+ process.terminate()
diff --git a/tests/test_forms_single_model.py b/tests/test_forms_single_model.py
new file mode 100644
index 000000000..7ed3ba3a2
--- /dev/null
+++ b/tests/test_forms_single_model.py
@@ -0,0 +1,129 @@
+from typing import List, Optional
+
+from dirty_equals import IsDict
+from fastapi import FastAPI, Form
+from fastapi.testclient import TestClient
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class FormModel(BaseModel):
+ username: str
+ lastname: str
+ age: Optional[int] = None
+ tags: List[str] = ["foo", "bar"]
+
+
+@app.post("/form/")
+def post_form(user: Annotated[FormModel, Form()]):
+ return user
+
+
+client = TestClient(app)
+
+
+def test_send_all_data():
+ response = client.post(
+ "/form/",
+ data={
+ "username": "Rick",
+ "lastname": "Sanchez",
+ "age": "70",
+ "tags": ["plumbus", "citadel"],
+ },
+ )
+ assert response.status_code == 200, response.text
+ assert response.json() == {
+ "username": "Rick",
+ "lastname": "Sanchez",
+ "age": 70,
+ "tags": ["plumbus", "citadel"],
+ }
+
+
+def test_defaults():
+ response = client.post("/form/", data={"username": "Rick", "lastname": "Sanchez"})
+ assert response.status_code == 200, response.text
+ assert response.json() == {
+ "username": "Rick",
+ "lastname": "Sanchez",
+ "age": None,
+ "tags": ["foo", "bar"],
+ }
+
+
+def test_invalid_data():
+ response = client.post(
+ "/form/",
+ data={
+ "username": "Rick",
+ "lastname": "Sanchez",
+ "age": "seventy",
+ "tags": ["plumbus", "citadel"],
+ },
+ )
+ assert response.status_code == 422, response.text
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "int_parsing",
+ "loc": ["body", "age"],
+ "msg": "Input should be a valid integer, unable to parse string as an integer",
+ "input": "seventy",
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "age"],
+ "msg": "value is not a valid integer",
+ "type": "type_error.integer",
+ }
+ ]
+ }
+ )
+
+
+def test_no_data():
+ response = client.post("/form/")
+ assert response.status_code == 422, response.text
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {"tags": ["foo", "bar"]},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "lastname"],
+ "msg": "Field required",
+ "input": {"tags": ["foo", "bar"]},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "lastname"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
diff --git a/tests/test_tutorial/test_request_form_models/__init__.py b/tests/test_tutorial/test_request_form_models/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial001.py b/tests/test_tutorial/test_request_form_models/test_tutorial001.py
new file mode 100644
index 000000000..46c130ee8
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial001.py
@@ -0,0 +1,232 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+ from docs_src.request_form_models.tutorial001 import app
+
+ client = TestClient(app)
+ return client
+
+
+def test_post_body_form(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+ assert response.status_code == 200
+ assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+def test_post_body_form_no_password(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo"})
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {"username": "Foo"},
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ }
+ ]
+ }
+ )
+
+
+def test_post_body_form_no_username(client: TestClient):
+ response = client.post("/login/", data={"password": "secret"})
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {"password": "secret"},
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ }
+ ]
+ }
+ )
+
+
+def test_post_body_form_no_data(client: TestClient):
+ response = client.post("/login/")
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
+
+
+def test_post_body_json(client: TestClient):
+ response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+ assert response.status_code == 422, response.text
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
+
+
+def test_openapi_schema(client: TestClient):
+ 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": {
+ "/login/": {
+ "post": {
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ "summary": "Login",
+ "operationId": "login_login__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {"$ref": "#/components/schemas/FormData"}
+ }
+ },
+ "required": True,
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "FormData": {
+ "properties": {
+ "username": {"type": "string", "title": "Username"},
+ "password": {"type": "string", "title": "Password"},
+ },
+ "type": "object",
+ "required": ["username", "password"],
+ "title": "FormData",
+ },
+ "ValidationError": {
+ "title": "ValidationError",
+ "required": ["loc", "msg", "type"],
+ "type": "object",
+ "properties": {
+ "loc": {
+ "title": "Location",
+ "type": "array",
+ "items": {
+ "anyOf": [{"type": "string"}, {"type": "integer"}]
+ },
+ },
+ "msg": {"title": "Message", "type": "string"},
+ "type": {"title": "Error Type", "type": "string"},
+ },
+ },
+ "HTTPValidationError": {
+ "title": "HTTPValidationError",
+ "type": "object",
+ "properties": {
+ "detail": {
+ "title": "Detail",
+ "type": "array",
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ }
+ },
+ },
+ }
+ },
+ }
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial001_an.py b/tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
new file mode 100644
index 000000000..4e14d89c8
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
@@ -0,0 +1,232 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+ from docs_src.request_form_models.tutorial001_an import app
+
+ client = TestClient(app)
+ return client
+
+
+def test_post_body_form(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+ assert response.status_code == 200
+ assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+def test_post_body_form_no_password(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo"})
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {"username": "Foo"},
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ }
+ ]
+ }
+ )
+
+
+def test_post_body_form_no_username(client: TestClient):
+ response = client.post("/login/", data={"password": "secret"})
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {"password": "secret"},
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ }
+ ]
+ }
+ )
+
+
+def test_post_body_form_no_data(client: TestClient):
+ response = client.post("/login/")
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
+
+
+def test_post_body_json(client: TestClient):
+ response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+ assert response.status_code == 422, response.text
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
+
+
+def test_openapi_schema(client: TestClient):
+ 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": {
+ "/login/": {
+ "post": {
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ "summary": "Login",
+ "operationId": "login_login__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {"$ref": "#/components/schemas/FormData"}
+ }
+ },
+ "required": True,
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "FormData": {
+ "properties": {
+ "username": {"type": "string", "title": "Username"},
+ "password": {"type": "string", "title": "Password"},
+ },
+ "type": "object",
+ "required": ["username", "password"],
+ "title": "FormData",
+ },
+ "ValidationError": {
+ "title": "ValidationError",
+ "required": ["loc", "msg", "type"],
+ "type": "object",
+ "properties": {
+ "loc": {
+ "title": "Location",
+ "type": "array",
+ "items": {
+ "anyOf": [{"type": "string"}, {"type": "integer"}]
+ },
+ },
+ "msg": {"title": "Message", "type": "string"},
+ "type": {"title": "Error Type", "type": "string"},
+ },
+ },
+ "HTTPValidationError": {
+ "title": "HTTPValidationError",
+ "type": "object",
+ "properties": {
+ "detail": {
+ "title": "Detail",
+ "type": "array",
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ }
+ },
+ },
+ }
+ },
+ }
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py b/tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py
new file mode 100644
index 000000000..2e6426aa7
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py
@@ -0,0 +1,240 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_py39
+
+
+@pytest.fixture(name="client")
+def get_client():
+ from docs_src.request_form_models.tutorial001_an_py39 import app
+
+ client = TestClient(app)
+ return client
+
+
+@needs_py39
+def test_post_body_form(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+ assert response.status_code == 200
+ assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+@needs_py39
+def test_post_body_form_no_password(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo"})
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {"username": "Foo"},
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ }
+ ]
+ }
+ )
+
+
+@needs_py39
+def test_post_body_form_no_username(client: TestClient):
+ response = client.post("/login/", data={"password": "secret"})
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {"password": "secret"},
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ }
+ ]
+ }
+ )
+
+
+@needs_py39
+def test_post_body_form_no_data(client: TestClient):
+ response = client.post("/login/")
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
+
+
+@needs_py39
+def test_post_body_json(client: TestClient):
+ response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+ assert response.status_code == 422, response.text
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
+
+
+@needs_py39
+def test_openapi_schema(client: TestClient):
+ 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": {
+ "/login/": {
+ "post": {
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ "summary": "Login",
+ "operationId": "login_login__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {"$ref": "#/components/schemas/FormData"}
+ }
+ },
+ "required": True,
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "FormData": {
+ "properties": {
+ "username": {"type": "string", "title": "Username"},
+ "password": {"type": "string", "title": "Password"},
+ },
+ "type": "object",
+ "required": ["username", "password"],
+ "title": "FormData",
+ },
+ "ValidationError": {
+ "title": "ValidationError",
+ "required": ["loc", "msg", "type"],
+ "type": "object",
+ "properties": {
+ "loc": {
+ "title": "Location",
+ "type": "array",
+ "items": {
+ "anyOf": [{"type": "string"}, {"type": "integer"}]
+ },
+ },
+ "msg": {"title": "Message", "type": "string"},
+ "type": {"title": "Error Type", "type": "string"},
+ },
+ },
+ "HTTPValidationError": {
+ "title": "HTTPValidationError",
+ "type": "object",
+ "properties": {
+ "detail": {
+ "title": "Detail",
+ "type": "array",
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ }
+ },
+ },
+ }
+ },
+ }
From ccb19c4c3506d7cb05218076d0e3527cb21eed81 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 5 Sep 2024 14:41:11 +0000
Subject: [PATCH 007/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2fe884615..8fe8be6a7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Features
+
+* ✨ Add support for Pydantic models in `Form` parameters. PR [#12127](https://github.com/fastapi/fastapi/pull/12127) by [@tiangolo](https://github.com/tiangolo).
+
### Refactors
* ♻️ Refactor deciding if `embed` body fields, do not overwrite fields, compute once per router, refactor internals in preparation for Pydantic models in `Form`, `Query` and others. PR [#12117](https://github.com/fastapi/fastapi/pull/12117) by [@tiangolo](https://github.com/tiangolo).
From 8e6cf9ee9c9d87b6b658cc240146121c80f71476 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 16:55:44 +0200
Subject: [PATCH 008/504] =?UTF-8?q?=E2=8F=AA=EF=B8=8F=20Temporarily=20reve?=
=?UTF-8?q?rt=20"=E2=9C=A8=20Add=20support=20for=20Pydantic=20models=20in?=
=?UTF-8?q?=20`Form`=20parameters"=20to=20make=20a=20checkpoint=20release?=
=?UTF-8?q?=20(#12128)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Revert "✨ Add support for Pydantic models in `Form` parameters (#12127)"
This reverts commit 0f3e65b00712a59d763cf9c7715cde353bb94b02.
---
.../tutorial/request-form-models/image01.png | Bin 44487 -> 0 bytes
docs/en/docs/tutorial/request-form-models.md | 65 -----
docs/en/mkdocs.yml | 1 -
docs_src/request_form_models/tutorial001.py | 14 -
.../request_form_models/tutorial001_an.py | 15 --
.../tutorial001_an_py39.py | 16 --
fastapi/dependencies/utils.py | 17 +-
.../playwright/request_form_models/image01.py | 36 ---
tests/test_forms_single_model.py | 129 ----------
.../test_request_form_models/__init__.py | 0
.../test_tutorial001.py | 232 -----------------
.../test_tutorial001_an.py | 232 -----------------
.../test_tutorial001_an_py39.py | 240 ------------------
13 files changed, 3 insertions(+), 994 deletions(-)
delete mode 100644 docs/en/docs/img/tutorial/request-form-models/image01.png
delete mode 100644 docs/en/docs/tutorial/request-form-models.md
delete mode 100644 docs_src/request_form_models/tutorial001.py
delete mode 100644 docs_src/request_form_models/tutorial001_an.py
delete mode 100644 docs_src/request_form_models/tutorial001_an_py39.py
delete mode 100644 scripts/playwright/request_form_models/image01.py
delete mode 100644 tests/test_forms_single_model.py
delete mode 100644 tests/test_tutorial/test_request_form_models/__init__.py
delete mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001.py
delete mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
delete mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py
diff --git a/docs/en/docs/img/tutorial/request-form-models/image01.png b/docs/en/docs/img/tutorial/request-form-models/image01.png
deleted file mode 100644
index 3fe32c03d589e76abec5e9c6b71374ebd4e8cd2c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 44487
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
CMaG{1
diff --git a/docs/en/docs/tutorial/request-form-models.md b/docs/en/docs/tutorial/request-form-models.md
deleted file mode 100644
index 8bb1ffb1f..000000000
--- a/docs/en/docs/tutorial/request-form-models.md
+++ /dev/null
@@ -1,65 +0,0 @@
-# Form Models
-
-You can use Pydantic models to declare form fields in FastAPI.
-
-/// info
-
-To use forms, first install <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
-
-Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install it, for example:
-
-```console
-$ pip install python-multipart
-```
-
-///
-
-/// note
-
-This is supported since FastAPI version `0.113.0`. 🤓
-
-///
-
-## Pydantic Models for Forms
-
-You just need to declare a Pydantic model with the fields you want to receive as form fields, and then declare the parameter as `Form`:
-
-//// tab | Python 3.9+
-
-```Python hl_lines="9-11 15"
-{!> ../../../docs_src/request_form_models/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="8-10 14"
-{!> ../../../docs_src/request_form_models/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="7-9 13"
-{!> ../../../docs_src/request_form_models/tutorial001.py!}
-```
-
-////
-
-FastAPI will extract the data for each field from the form data in the request and give you the Pydantic model you defined.
-
-## Check the Docs
-
-You can verify it in the docs UI at `/docs`:
-
-<div class="screenshot">
-<img src="/img/tutorial/request-form-models/image01.png">
-</div>
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 7c810c2d7..528c80b8e 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -129,7 +129,6 @@ nav:
- tutorial/extra-models.md
- tutorial/response-status-code.md
- tutorial/request-forms.md
- - tutorial/request-form-models.md
- tutorial/request-files.md
- tutorial/request-forms-and-files.md
- tutorial/handling-errors.md
diff --git a/docs_src/request_form_models/tutorial001.py b/docs_src/request_form_models/tutorial001.py
deleted file mode 100644
index 98feff0b9..000000000
--- a/docs_src/request_form_models/tutorial001.py
+++ /dev/null
@@ -1,14 +0,0 @@
-from fastapi import FastAPI, Form
-from pydantic import BaseModel
-
-app = FastAPI()
-
-
-class FormData(BaseModel):
- username: str
- password: str
-
-
-@app.post("/login/")
-async def login(data: FormData = Form()):
- return data
diff --git a/docs_src/request_form_models/tutorial001_an.py b/docs_src/request_form_models/tutorial001_an.py
deleted file mode 100644
index 30483d445..000000000
--- a/docs_src/request_form_models/tutorial001_an.py
+++ /dev/null
@@ -1,15 +0,0 @@
-from fastapi import FastAPI, Form
-from pydantic import BaseModel
-from typing_extensions import Annotated
-
-app = FastAPI()
-
-
-class FormData(BaseModel):
- username: str
- password: str
-
-
-@app.post("/login/")
-async def login(data: Annotated[FormData, Form()]):
- return data
diff --git a/docs_src/request_form_models/tutorial001_an_py39.py b/docs_src/request_form_models/tutorial001_an_py39.py
deleted file mode 100644
index 7cc81aae9..000000000
--- a/docs_src/request_form_models/tutorial001_an_py39.py
+++ /dev/null
@@ -1,16 +0,0 @@
-from typing import Annotated
-
-from fastapi import FastAPI, Form
-from pydantic import BaseModel
-
-app = FastAPI()
-
-
-class FormData(BaseModel):
- username: str
- password: str
-
-
-@app.post("/login/")
-async def login(data: Annotated[FormData, Form()]):
- return data
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 98ce17b55..7ac18d941 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -33,7 +33,6 @@ from fastapi._compat import (
field_annotation_is_scalar,
get_annotation_from_field_info,
get_missing_field_error,
- get_model_fields,
is_bytes_field,
is_bytes_sequence_field,
is_scalar_field,
@@ -57,7 +56,6 @@ from fastapi.security.base import SecurityBase
from fastapi.security.oauth2 import OAuth2, SecurityScopes
from fastapi.security.open_id_connect_url import OpenIdConnect
from fastapi.utils import create_model_field, get_path_param_names
-from pydantic import BaseModel
from pydantic.fields import FieldInfo
from starlette.background import BackgroundTasks as StarletteBackgroundTasks
from starlette.concurrency import run_in_threadpool
@@ -745,9 +743,7 @@ def _should_embed_body_fields(fields: List[ModelField]) -> bool:
return True
# If it's a Form (or File) field, it has to be a BaseModel 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(
- first_field.type_, BaseModel
- ):
+ if isinstance(first_field.field_info, params.Form):
return True
return False
@@ -787,8 +783,7 @@ async def _extract_form_body(
for sub_value in value:
tg.start_soon(process_fn, sub_value.read)
value = serialize_sequence_value(field=field, value=results)
- if value is not None:
- values[field.name] = value
+ values[field.name] = value
return values
@@ -803,14 +798,8 @@ async def request_body_to_args(
single_not_embedded_field = len(body_fields) == 1 and not embed_body_fields
first_field = body_fields[0]
body_to_process = received_body
-
- fields_to_extract: List[ModelField] = body_fields
-
- if single_not_embedded_field and lenient_issubclass(first_field.type_, BaseModel):
- fields_to_extract = get_model_fields(first_field.type_)
-
if isinstance(received_body, FormData):
- body_to_process = await _extract_form_body(fields_to_extract, received_body)
+ body_to_process = await _extract_form_body(body_fields, received_body)
if single_not_embedded_field:
loc: Tuple[str, ...] = ("body",)
diff --git a/scripts/playwright/request_form_models/image01.py b/scripts/playwright/request_form_models/image01.py
deleted file mode 100644
index 15bd3858c..000000000
--- a/scripts/playwright/request_form_models/image01.py
+++ /dev/null
@@ -1,36 +0,0 @@
-import subprocess
-import time
-
-import httpx
-from playwright.sync_api import Playwright, sync_playwright
-
-
-# Run playwright codegen to generate the code below, copy paste the sections in run()
-def run(playwright: Playwright) -> None:
- browser = playwright.chromium.launch(headless=False)
- context = browser.new_context()
- page = context.new_page()
- page.goto("http://localhost:8000/docs")
- page.get_by_role("button", name="POST /login/ Login").click()
- page.get_by_role("button", name="Try it out").click()
- page.screenshot(path="docs/en/docs/img/tutorial/request-form-models/image01.png")
-
- # ---------------------
- context.close()
- browser.close()
-
-
-process = subprocess.Popen(
- ["fastapi", "run", "docs_src/request_form_models/tutorial001.py"]
-)
-try:
- for _ in range(3):
- try:
- response = httpx.get("http://localhost:8000/docs")
- except httpx.ConnectError:
- time.sleep(1)
- break
- with sync_playwright() as playwright:
- run(playwright)
-finally:
- process.terminate()
diff --git a/tests/test_forms_single_model.py b/tests/test_forms_single_model.py
deleted file mode 100644
index 7ed3ba3a2..000000000
--- a/tests/test_forms_single_model.py
+++ /dev/null
@@ -1,129 +0,0 @@
-from typing import List, Optional
-
-from dirty_equals import IsDict
-from fastapi import FastAPI, Form
-from fastapi.testclient import TestClient
-from pydantic import BaseModel
-from typing_extensions import Annotated
-
-app = FastAPI()
-
-
-class FormModel(BaseModel):
- username: str
- lastname: str
- age: Optional[int] = None
- tags: List[str] = ["foo", "bar"]
-
-
-@app.post("/form/")
-def post_form(user: Annotated[FormModel, Form()]):
- return user
-
-
-client = TestClient(app)
-
-
-def test_send_all_data():
- response = client.post(
- "/form/",
- data={
- "username": "Rick",
- "lastname": "Sanchez",
- "age": "70",
- "tags": ["plumbus", "citadel"],
- },
- )
- assert response.status_code == 200, response.text
- assert response.json() == {
- "username": "Rick",
- "lastname": "Sanchez",
- "age": 70,
- "tags": ["plumbus", "citadel"],
- }
-
-
-def test_defaults():
- response = client.post("/form/", data={"username": "Rick", "lastname": "Sanchez"})
- assert response.status_code == 200, response.text
- assert response.json() == {
- "username": "Rick",
- "lastname": "Sanchez",
- "age": None,
- "tags": ["foo", "bar"],
- }
-
-
-def test_invalid_data():
- response = client.post(
- "/form/",
- data={
- "username": "Rick",
- "lastname": "Sanchez",
- "age": "seventy",
- "tags": ["plumbus", "citadel"],
- },
- )
- assert response.status_code == 422, response.text
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "int_parsing",
- "loc": ["body", "age"],
- "msg": "Input should be a valid integer, unable to parse string as an integer",
- "input": "seventy",
- }
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "age"],
- "msg": "value is not a valid integer",
- "type": "type_error.integer",
- }
- ]
- }
- )
-
-
-def test_no_data():
- response = client.post("/form/")
- assert response.status_code == 422, response.text
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "missing",
- "loc": ["body", "username"],
- "msg": "Field required",
- "input": {"tags": ["foo", "bar"]},
- },
- {
- "type": "missing",
- "loc": ["body", "lastname"],
- "msg": "Field required",
- "input": {"tags": ["foo", "bar"]},
- },
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "username"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- {
- "loc": ["body", "lastname"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- ]
- }
- )
diff --git a/tests/test_tutorial/test_request_form_models/__init__.py b/tests/test_tutorial/test_request_form_models/__init__.py
deleted file mode 100644
index e69de29bb..000000000
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial001.py b/tests/test_tutorial/test_request_form_models/test_tutorial001.py
deleted file mode 100644
index 46c130ee8..000000000
--- a/tests/test_tutorial/test_request_form_models/test_tutorial001.py
+++ /dev/null
@@ -1,232 +0,0 @@
-import pytest
-from dirty_equals import IsDict
-from fastapi.testclient import TestClient
-
-
-@pytest.fixture(name="client")
-def get_client():
- from docs_src.request_form_models.tutorial001 import app
-
- client = TestClient(app)
- return client
-
-
-def test_post_body_form(client: TestClient):
- response = client.post("/login/", data={"username": "Foo", "password": "secret"})
- assert response.status_code == 200
- assert response.json() == {"username": "Foo", "password": "secret"}
-
-
-def test_post_body_form_no_password(client: TestClient):
- response = client.post("/login/", data={"username": "Foo"})
- assert response.status_code == 422
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "missing",
- "loc": ["body", "password"],
- "msg": "Field required",
- "input": {"username": "Foo"},
- }
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "password"],
- "msg": "field required",
- "type": "value_error.missing",
- }
- ]
- }
- )
-
-
-def test_post_body_form_no_username(client: TestClient):
- response = client.post("/login/", data={"password": "secret"})
- assert response.status_code == 422
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "missing",
- "loc": ["body", "username"],
- "msg": "Field required",
- "input": {"password": "secret"},
- }
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "username"],
- "msg": "field required",
- "type": "value_error.missing",
- }
- ]
- }
- )
-
-
-def test_post_body_form_no_data(client: TestClient):
- response = client.post("/login/")
- assert response.status_code == 422
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "missing",
- "loc": ["body", "username"],
- "msg": "Field required",
- "input": {},
- },
- {
- "type": "missing",
- "loc": ["body", "password"],
- "msg": "Field required",
- "input": {},
- },
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "username"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- {
- "loc": ["body", "password"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- ]
- }
- )
-
-
-def test_post_body_json(client: TestClient):
- response = client.post("/login/", json={"username": "Foo", "password": "secret"})
- assert response.status_code == 422, response.text
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "missing",
- "loc": ["body", "username"],
- "msg": "Field required",
- "input": {},
- },
- {
- "type": "missing",
- "loc": ["body", "password"],
- "msg": "Field required",
- "input": {},
- },
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "username"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- {
- "loc": ["body", "password"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- ]
- }
- )
-
-
-def test_openapi_schema(client: TestClient):
- 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": {
- "/login/": {
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {"application/json": {"schema": {}}},
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Login",
- "operationId": "login_login__post",
- "requestBody": {
- "content": {
- "application/x-www-form-urlencoded": {
- "schema": {"$ref": "#/components/schemas/FormData"}
- }
- },
- "required": True,
- },
- }
- }
- },
- "components": {
- "schemas": {
- "FormData": {
- "properties": {
- "username": {"type": "string", "title": "Username"},
- "password": {"type": "string", "title": "Password"},
- },
- "type": "object",
- "required": ["username", "password"],
- "title": "FormData",
- },
- "ValidationError": {
- "title": "ValidationError",
- "required": ["loc", "msg", "type"],
- "type": "object",
- "properties": {
- "loc": {
- "title": "Location",
- "type": "array",
- "items": {
- "anyOf": [{"type": "string"}, {"type": "integer"}]
- },
- },
- "msg": {"title": "Message", "type": "string"},
- "type": {"title": "Error Type", "type": "string"},
- },
- },
- "HTTPValidationError": {
- "title": "HTTPValidationError",
- "type": "object",
- "properties": {
- "detail": {
- "title": "Detail",
- "type": "array",
- "items": {"$ref": "#/components/schemas/ValidationError"},
- }
- },
- },
- }
- },
- }
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial001_an.py b/tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
deleted file mode 100644
index 4e14d89c8..000000000
--- a/tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
+++ /dev/null
@@ -1,232 +0,0 @@
-import pytest
-from dirty_equals import IsDict
-from fastapi.testclient import TestClient
-
-
-@pytest.fixture(name="client")
-def get_client():
- from docs_src.request_form_models.tutorial001_an import app
-
- client = TestClient(app)
- return client
-
-
-def test_post_body_form(client: TestClient):
- response = client.post("/login/", data={"username": "Foo", "password": "secret"})
- assert response.status_code == 200
- assert response.json() == {"username": "Foo", "password": "secret"}
-
-
-def test_post_body_form_no_password(client: TestClient):
- response = client.post("/login/", data={"username": "Foo"})
- assert response.status_code == 422
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "missing",
- "loc": ["body", "password"],
- "msg": "Field required",
- "input": {"username": "Foo"},
- }
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "password"],
- "msg": "field required",
- "type": "value_error.missing",
- }
- ]
- }
- )
-
-
-def test_post_body_form_no_username(client: TestClient):
- response = client.post("/login/", data={"password": "secret"})
- assert response.status_code == 422
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "missing",
- "loc": ["body", "username"],
- "msg": "Field required",
- "input": {"password": "secret"},
- }
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "username"],
- "msg": "field required",
- "type": "value_error.missing",
- }
- ]
- }
- )
-
-
-def test_post_body_form_no_data(client: TestClient):
- response = client.post("/login/")
- assert response.status_code == 422
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "missing",
- "loc": ["body", "username"],
- "msg": "Field required",
- "input": {},
- },
- {
- "type": "missing",
- "loc": ["body", "password"],
- "msg": "Field required",
- "input": {},
- },
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "username"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- {
- "loc": ["body", "password"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- ]
- }
- )
-
-
-def test_post_body_json(client: TestClient):
- response = client.post("/login/", json={"username": "Foo", "password": "secret"})
- assert response.status_code == 422, response.text
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "missing",
- "loc": ["body", "username"],
- "msg": "Field required",
- "input": {},
- },
- {
- "type": "missing",
- "loc": ["body", "password"],
- "msg": "Field required",
- "input": {},
- },
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "username"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- {
- "loc": ["body", "password"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- ]
- }
- )
-
-
-def test_openapi_schema(client: TestClient):
- 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": {
- "/login/": {
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {"application/json": {"schema": {}}},
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Login",
- "operationId": "login_login__post",
- "requestBody": {
- "content": {
- "application/x-www-form-urlencoded": {
- "schema": {"$ref": "#/components/schemas/FormData"}
- }
- },
- "required": True,
- },
- }
- }
- },
- "components": {
- "schemas": {
- "FormData": {
- "properties": {
- "username": {"type": "string", "title": "Username"},
- "password": {"type": "string", "title": "Password"},
- },
- "type": "object",
- "required": ["username", "password"],
- "title": "FormData",
- },
- "ValidationError": {
- "title": "ValidationError",
- "required": ["loc", "msg", "type"],
- "type": "object",
- "properties": {
- "loc": {
- "title": "Location",
- "type": "array",
- "items": {
- "anyOf": [{"type": "string"}, {"type": "integer"}]
- },
- },
- "msg": {"title": "Message", "type": "string"},
- "type": {"title": "Error Type", "type": "string"},
- },
- },
- "HTTPValidationError": {
- "title": "HTTPValidationError",
- "type": "object",
- "properties": {
- "detail": {
- "title": "Detail",
- "type": "array",
- "items": {"$ref": "#/components/schemas/ValidationError"},
- }
- },
- },
- }
- },
- }
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py b/tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py
deleted file mode 100644
index 2e6426aa7..000000000
--- a/tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py
+++ /dev/null
@@ -1,240 +0,0 @@
-import pytest
-from dirty_equals import IsDict
-from fastapi.testclient import TestClient
-
-from tests.utils import needs_py39
-
-
-@pytest.fixture(name="client")
-def get_client():
- from docs_src.request_form_models.tutorial001_an_py39 import app
-
- client = TestClient(app)
- return client
-
-
-@needs_py39
-def test_post_body_form(client: TestClient):
- response = client.post("/login/", data={"username": "Foo", "password": "secret"})
- assert response.status_code == 200
- assert response.json() == {"username": "Foo", "password": "secret"}
-
-
-@needs_py39
-def test_post_body_form_no_password(client: TestClient):
- response = client.post("/login/", data={"username": "Foo"})
- assert response.status_code == 422
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "missing",
- "loc": ["body", "password"],
- "msg": "Field required",
- "input": {"username": "Foo"},
- }
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "password"],
- "msg": "field required",
- "type": "value_error.missing",
- }
- ]
- }
- )
-
-
-@needs_py39
-def test_post_body_form_no_username(client: TestClient):
- response = client.post("/login/", data={"password": "secret"})
- assert response.status_code == 422
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "missing",
- "loc": ["body", "username"],
- "msg": "Field required",
- "input": {"password": "secret"},
- }
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "username"],
- "msg": "field required",
- "type": "value_error.missing",
- }
- ]
- }
- )
-
-
-@needs_py39
-def test_post_body_form_no_data(client: TestClient):
- response = client.post("/login/")
- assert response.status_code == 422
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "missing",
- "loc": ["body", "username"],
- "msg": "Field required",
- "input": {},
- },
- {
- "type": "missing",
- "loc": ["body", "password"],
- "msg": "Field required",
- "input": {},
- },
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "username"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- {
- "loc": ["body", "password"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- ]
- }
- )
-
-
-@needs_py39
-def test_post_body_json(client: TestClient):
- response = client.post("/login/", json={"username": "Foo", "password": "secret"})
- assert response.status_code == 422, response.text
- assert response.json() == IsDict(
- {
- "detail": [
- {
- "type": "missing",
- "loc": ["body", "username"],
- "msg": "Field required",
- "input": {},
- },
- {
- "type": "missing",
- "loc": ["body", "password"],
- "msg": "Field required",
- "input": {},
- },
- ]
- }
- ) | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {
- "detail": [
- {
- "loc": ["body", "username"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- {
- "loc": ["body", "password"],
- "msg": "field required",
- "type": "value_error.missing",
- },
- ]
- }
- )
-
-
-@needs_py39
-def test_openapi_schema(client: TestClient):
- 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": {
- "/login/": {
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {"application/json": {"schema": {}}},
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Login",
- "operationId": "login_login__post",
- "requestBody": {
- "content": {
- "application/x-www-form-urlencoded": {
- "schema": {"$ref": "#/components/schemas/FormData"}
- }
- },
- "required": True,
- },
- }
- }
- },
- "components": {
- "schemas": {
- "FormData": {
- "properties": {
- "username": {"type": "string", "title": "Username"},
- "password": {"type": "string", "title": "Password"},
- },
- "type": "object",
- "required": ["username", "password"],
- "title": "FormData",
- },
- "ValidationError": {
- "title": "ValidationError",
- "required": ["loc", "msg", "type"],
- "type": "object",
- "properties": {
- "loc": {
- "title": "Location",
- "type": "array",
- "items": {
- "anyOf": [{"type": "string"}, {"type": "integer"}]
- },
- },
- "msg": {"title": "Message", "type": "string"},
- "type": {"title": "Error Type", "type": "string"},
- },
- },
- "HTTPValidationError": {
- "title": "HTTPValidationError",
- "type": "object",
- "properties": {
- "detail": {
- "title": "Detail",
- "type": "array",
- "items": {"$ref": "#/components/schemas/ValidationError"},
- }
- },
- },
- }
- },
- }
From b69e8b24af305ddceaa9c63c8d2eebf80672caed Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 5 Sep 2024 14:56:10 +0000
Subject: [PATCH 009/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8fe8be6a7..3c5fbb731 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -15,6 +15,10 @@ hide:
* ♻️ Refactor deciding if `embed` body fields, do not overwrite fields, compute once per router, refactor internals in preparation for Pydantic models in `Form`, `Query` and others. PR [#12117](https://github.com/fastapi/fastapi/pull/12117) by [@tiangolo](https://github.com/tiangolo).
+### Internal
+
+* ⏪️ Temporarily revert "✨ Add support for Pydantic models in `Form` parameters" to make a checkpoint release. PR [#12128](https://github.com/fastapi/fastapi/pull/12128) by [@tiangolo](https://github.com/tiangolo).
+
## 0.112.3
This release is mainly internal refactors, it shouldn't affect apps using FastAPI in any way. You don't even have to upgrade to this version yet. There are a few bigger releases coming right after. 🚀
From 8224addd8f31325ad465af994da8421a69f494ba Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 16:57:57 +0200
Subject: [PATCH 010/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3c5fbb731..22a224a5a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,7 +9,7 @@ hide:
### Features
-* ✨ Add support for Pydantic models in `Form` parameters. PR [#12127](https://github.com/fastapi/fastapi/pull/12127) by [@tiangolo](https://github.com/tiangolo).
+## 0.112.4
### Refactors
@@ -18,6 +18,7 @@ hide:
### Internal
* ⏪️ Temporarily revert "✨ Add support for Pydantic models in `Form` parameters" to make a checkpoint release. PR [#12128](https://github.com/fastapi/fastapi/pull/12128) by [@tiangolo](https://github.com/tiangolo).
+* ✨ Add support for Pydantic models in `Form` parameters. PR [#12127](https://github.com/fastapi/fastapi/pull/12127) by [@tiangolo](https://github.com/tiangolo). Reverted to make a checkpoint release with only refactors.
## 0.112.3
From 96c7e7e0f34730e6f6333ced9476bfd62f384cfe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 17:00:13 +0200
Subject: [PATCH 011/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 22a224a5a..43ce86c99 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,10 +7,12 @@ hide:
## Latest Changes
-### Features
-
## 0.112.4
+This release is mainly a big internal refactor to enable adding support for Pydantic models for `Form` fields, but that feature comes in the next release.
+
+This release shouldn't affect apps using FastAPI in any way. You don't even have to upgrade to this version yet. It's just a checkpoint. 🤓
+
### Refactors
* ♻️ Refactor deciding if `embed` body fields, do not overwrite fields, compute once per router, refactor internals in preparation for Pydantic models in `Form`, `Query` and others. PR [#12117](https://github.com/fastapi/fastapi/pull/12117) by [@tiangolo](https://github.com/tiangolo).
From 999eeb6c76ff37f94612dd140ce8091932f56c54 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 17:00:33 +0200
Subject: [PATCH 012/504] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
=?UTF-8?q?2.4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
fastapi/__init__.py | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 1bc1bfd82..1e10bf557 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
"""FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
-__version__ = "0.112.3"
+__version__ = "0.112.4"
from starlette import status as status
From 965fc8301e8fa7a7228bee33873387f4852a30df Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 17:09:31 +0200
Subject: [PATCH 013/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 43ce86c99..9b44bc9a8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -19,8 +19,8 @@ This release shouldn't affect apps using FastAPI in any way. You don't even have
### Internal
-* ⏪️ Temporarily revert "✨ Add support for Pydantic models in `Form` parameters" to make a checkpoint release. PR [#12128](https://github.com/fastapi/fastapi/pull/12128) by [@tiangolo](https://github.com/tiangolo).
-* ✨ Add support for Pydantic models in `Form` parameters. PR [#12127](https://github.com/fastapi/fastapi/pull/12127) by [@tiangolo](https://github.com/tiangolo). Reverted to make a checkpoint release with only refactors.
+* ⏪️ Temporarily revert "✨ Add support for Pydantic models in `Form` parameters" to make a checkpoint release. PR [#12128](https://github.com/fastapi/fastapi/pull/12128) by [@tiangolo](https://github.com/tiangolo). Restored by PR [#12129](https://github.com/fastapi/fastapi/pull/12129).
+* ✨ Add support for Pydantic models in `Form` parameters. PR [#12127](https://github.com/fastapi/fastapi/pull/12127) by [@tiangolo](https://github.com/tiangolo). Reverted by PR [#12128](https://github.com/fastapi/fastapi/pull/12128) to make a checkpoint release with only refactors. Restored by PR [#12129](https://github.com/fastapi/fastapi/pull/12129).
## 0.112.3
From 7bad7c09757f8a06cf62cc0838082a766065883e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 17:16:50 +0200
Subject: [PATCH 014/504] =?UTF-8?q?=E2=9C=A8=20Add=20support=20for=20Pydan?=
=?UTF-8?q?tic=20models=20in=20`Form`=20parameters=20(#12129)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Revert "⏪️ Temporarily revert "✨ Add support for Pydantic models in `Form` pa…"
This reverts commit 8e6cf9ee9c9d87b6b658cc240146121c80f71476.
---
.../tutorial/request-form-models/image01.png | Bin 0 -> 44487 bytes
docs/en/docs/tutorial/request-form-models.md | 65 +++++
docs/en/mkdocs.yml | 1 +
docs_src/request_form_models/tutorial001.py | 14 +
.../request_form_models/tutorial001_an.py | 15 ++
.../tutorial001_an_py39.py | 16 ++
fastapi/dependencies/utils.py | 17 +-
.../playwright/request_form_models/image01.py | 36 +++
tests/test_forms_single_model.py | 129 ++++++++++
.../test_request_form_models/__init__.py | 0
.../test_tutorial001.py | 232 +++++++++++++++++
.../test_tutorial001_an.py | 232 +++++++++++++++++
.../test_tutorial001_an_py39.py | 240 ++++++++++++++++++
13 files changed, 994 insertions(+), 3 deletions(-)
create mode 100644 docs/en/docs/img/tutorial/request-form-models/image01.png
create mode 100644 docs/en/docs/tutorial/request-form-models.md
create mode 100644 docs_src/request_form_models/tutorial001.py
create mode 100644 docs_src/request_form_models/tutorial001_an.py
create mode 100644 docs_src/request_form_models/tutorial001_an_py39.py
create mode 100644 scripts/playwright/request_form_models/image01.py
create mode 100644 tests/test_forms_single_model.py
create mode 100644 tests/test_tutorial/test_request_form_models/__init__.py
create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001.py
create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py
diff --git a/docs/en/docs/img/tutorial/request-form-models/image01.png b/docs/en/docs/img/tutorial/request-form-models/image01.png
new file mode 100644
index 0000000000000000000000000000000000000000..3fe32c03d589e76abec5e9c6b71374ebd4e8cd2c
GIT binary patch
literal 44487
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
CMaG{1
literal 0
HcmV?d00001
diff --git a/docs/en/docs/tutorial/request-form-models.md b/docs/en/docs/tutorial/request-form-models.md
new file mode 100644
index 000000000..8bb1ffb1f
--- /dev/null
+++ b/docs/en/docs/tutorial/request-form-models.md
@@ -0,0 +1,65 @@
+# Form Models
+
+You can use Pydantic models to declare form fields in FastAPI.
+
+/// info
+
+To use forms, first install <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
+
+Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install it, for example:
+
+```console
+$ pip install python-multipart
+```
+
+///
+
+/// note
+
+This is supported since FastAPI version `0.113.0`. 🤓
+
+///
+
+## Pydantic Models for Forms
+
+You just need to declare a Pydantic model with the fields you want to receive as form fields, and then declare the parameter as `Form`:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9-11 15"
+{!> ../../../docs_src/request_form_models/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="8-10 14"
+{!> ../../../docs_src/request_form_models/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="7-9 13"
+{!> ../../../docs_src/request_form_models/tutorial001.py!}
+```
+
+////
+
+FastAPI will extract the data for each field from the form data in the request and give you the Pydantic model you defined.
+
+## Check the Docs
+
+You can verify it in the docs UI at `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/request-form-models/image01.png">
+</div>
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 528c80b8e..7c810c2d7 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -129,6 +129,7 @@ nav:
- tutorial/extra-models.md
- tutorial/response-status-code.md
- tutorial/request-forms.md
+ - tutorial/request-form-models.md
- tutorial/request-files.md
- tutorial/request-forms-and-files.md
- tutorial/handling-errors.md
diff --git a/docs_src/request_form_models/tutorial001.py b/docs_src/request_form_models/tutorial001.py
new file mode 100644
index 000000000..98feff0b9
--- /dev/null
+++ b/docs_src/request_form_models/tutorial001.py
@@ -0,0 +1,14 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+
+
+@app.post("/login/")
+async def login(data: FormData = Form()):
+ return data
diff --git a/docs_src/request_form_models/tutorial001_an.py b/docs_src/request_form_models/tutorial001_an.py
new file mode 100644
index 000000000..30483d445
--- /dev/null
+++ b/docs_src/request_form_models/tutorial001_an.py
@@ -0,0 +1,15 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+ return data
diff --git a/docs_src/request_form_models/tutorial001_an_py39.py b/docs_src/request_form_models/tutorial001_an_py39.py
new file mode 100644
index 000000000..7cc81aae9
--- /dev/null
+++ b/docs_src/request_form_models/tutorial001_an_py39.py
@@ -0,0 +1,16 @@
+from typing import Annotated
+
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+ return data
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 7ac18d941..98ce17b55 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -33,6 +33,7 @@ from fastapi._compat import (
field_annotation_is_scalar,
get_annotation_from_field_info,
get_missing_field_error,
+ get_model_fields,
is_bytes_field,
is_bytes_sequence_field,
is_scalar_field,
@@ -56,6 +57,7 @@ from fastapi.security.base import SecurityBase
from fastapi.security.oauth2 import OAuth2, SecurityScopes
from fastapi.security.open_id_connect_url import OpenIdConnect
from fastapi.utils import create_model_field, get_path_param_names
+from pydantic import BaseModel
from pydantic.fields import FieldInfo
from starlette.background import BackgroundTasks as StarletteBackgroundTasks
from starlette.concurrency import run_in_threadpool
@@ -743,7 +745,9 @@ def _should_embed_body_fields(fields: List[ModelField]) -> bool:
return True
# If it's a Form (or File) field, it has to be a BaseModel 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):
+ if isinstance(first_field.field_info, params.Form) and not lenient_issubclass(
+ first_field.type_, BaseModel
+ ):
return True
return False
@@ -783,7 +787,8 @@ async def _extract_form_body(
for sub_value in value:
tg.start_soon(process_fn, sub_value.read)
value = serialize_sequence_value(field=field, value=results)
- values[field.name] = value
+ if value is not None:
+ values[field.name] = value
return values
@@ -798,8 +803,14 @@ async def request_body_to_args(
single_not_embedded_field = len(body_fields) == 1 and not embed_body_fields
first_field = body_fields[0]
body_to_process = received_body
+
+ fields_to_extract: List[ModelField] = body_fields
+
+ if single_not_embedded_field and lenient_issubclass(first_field.type_, BaseModel):
+ fields_to_extract = get_model_fields(first_field.type_)
+
if isinstance(received_body, FormData):
- body_to_process = await _extract_form_body(body_fields, received_body)
+ body_to_process = await _extract_form_body(fields_to_extract, received_body)
if single_not_embedded_field:
loc: Tuple[str, ...] = ("body",)
diff --git a/scripts/playwright/request_form_models/image01.py b/scripts/playwright/request_form_models/image01.py
new file mode 100644
index 000000000..15bd3858c
--- /dev/null
+++ b/scripts/playwright/request_form_models/image01.py
@@ -0,0 +1,36 @@
+import subprocess
+import time
+
+import httpx
+from playwright.sync_api import Playwright, sync_playwright
+
+
+# Run playwright codegen to generate the code below, copy paste the sections in run()
+def run(playwright: Playwright) -> None:
+ browser = playwright.chromium.launch(headless=False)
+ context = browser.new_context()
+ page = context.new_page()
+ page.goto("http://localhost:8000/docs")
+ page.get_by_role("button", name="POST /login/ Login").click()
+ page.get_by_role("button", name="Try it out").click()
+ page.screenshot(path="docs/en/docs/img/tutorial/request-form-models/image01.png")
+
+ # ---------------------
+ context.close()
+ browser.close()
+
+
+process = subprocess.Popen(
+ ["fastapi", "run", "docs_src/request_form_models/tutorial001.py"]
+)
+try:
+ for _ in range(3):
+ try:
+ response = httpx.get("http://localhost:8000/docs")
+ except httpx.ConnectError:
+ time.sleep(1)
+ break
+ with sync_playwright() as playwright:
+ run(playwright)
+finally:
+ process.terminate()
diff --git a/tests/test_forms_single_model.py b/tests/test_forms_single_model.py
new file mode 100644
index 000000000..7ed3ba3a2
--- /dev/null
+++ b/tests/test_forms_single_model.py
@@ -0,0 +1,129 @@
+from typing import List, Optional
+
+from dirty_equals import IsDict
+from fastapi import FastAPI, Form
+from fastapi.testclient import TestClient
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class FormModel(BaseModel):
+ username: str
+ lastname: str
+ age: Optional[int] = None
+ tags: List[str] = ["foo", "bar"]
+
+
+@app.post("/form/")
+def post_form(user: Annotated[FormModel, Form()]):
+ return user
+
+
+client = TestClient(app)
+
+
+def test_send_all_data():
+ response = client.post(
+ "/form/",
+ data={
+ "username": "Rick",
+ "lastname": "Sanchez",
+ "age": "70",
+ "tags": ["plumbus", "citadel"],
+ },
+ )
+ assert response.status_code == 200, response.text
+ assert response.json() == {
+ "username": "Rick",
+ "lastname": "Sanchez",
+ "age": 70,
+ "tags": ["plumbus", "citadel"],
+ }
+
+
+def test_defaults():
+ response = client.post("/form/", data={"username": "Rick", "lastname": "Sanchez"})
+ assert response.status_code == 200, response.text
+ assert response.json() == {
+ "username": "Rick",
+ "lastname": "Sanchez",
+ "age": None,
+ "tags": ["foo", "bar"],
+ }
+
+
+def test_invalid_data():
+ response = client.post(
+ "/form/",
+ data={
+ "username": "Rick",
+ "lastname": "Sanchez",
+ "age": "seventy",
+ "tags": ["plumbus", "citadel"],
+ },
+ )
+ assert response.status_code == 422, response.text
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "int_parsing",
+ "loc": ["body", "age"],
+ "msg": "Input should be a valid integer, unable to parse string as an integer",
+ "input": "seventy",
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "age"],
+ "msg": "value is not a valid integer",
+ "type": "type_error.integer",
+ }
+ ]
+ }
+ )
+
+
+def test_no_data():
+ response = client.post("/form/")
+ assert response.status_code == 422, response.text
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {"tags": ["foo", "bar"]},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "lastname"],
+ "msg": "Field required",
+ "input": {"tags": ["foo", "bar"]},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "lastname"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
diff --git a/tests/test_tutorial/test_request_form_models/__init__.py b/tests/test_tutorial/test_request_form_models/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial001.py b/tests/test_tutorial/test_request_form_models/test_tutorial001.py
new file mode 100644
index 000000000..46c130ee8
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial001.py
@@ -0,0 +1,232 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+ from docs_src.request_form_models.tutorial001 import app
+
+ client = TestClient(app)
+ return client
+
+
+def test_post_body_form(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+ assert response.status_code == 200
+ assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+def test_post_body_form_no_password(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo"})
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {"username": "Foo"},
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ }
+ ]
+ }
+ )
+
+
+def test_post_body_form_no_username(client: TestClient):
+ response = client.post("/login/", data={"password": "secret"})
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {"password": "secret"},
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ }
+ ]
+ }
+ )
+
+
+def test_post_body_form_no_data(client: TestClient):
+ response = client.post("/login/")
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
+
+
+def test_post_body_json(client: TestClient):
+ response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+ assert response.status_code == 422, response.text
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
+
+
+def test_openapi_schema(client: TestClient):
+ 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": {
+ "/login/": {
+ "post": {
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ "summary": "Login",
+ "operationId": "login_login__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {"$ref": "#/components/schemas/FormData"}
+ }
+ },
+ "required": True,
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "FormData": {
+ "properties": {
+ "username": {"type": "string", "title": "Username"},
+ "password": {"type": "string", "title": "Password"},
+ },
+ "type": "object",
+ "required": ["username", "password"],
+ "title": "FormData",
+ },
+ "ValidationError": {
+ "title": "ValidationError",
+ "required": ["loc", "msg", "type"],
+ "type": "object",
+ "properties": {
+ "loc": {
+ "title": "Location",
+ "type": "array",
+ "items": {
+ "anyOf": [{"type": "string"}, {"type": "integer"}]
+ },
+ },
+ "msg": {"title": "Message", "type": "string"},
+ "type": {"title": "Error Type", "type": "string"},
+ },
+ },
+ "HTTPValidationError": {
+ "title": "HTTPValidationError",
+ "type": "object",
+ "properties": {
+ "detail": {
+ "title": "Detail",
+ "type": "array",
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ }
+ },
+ },
+ }
+ },
+ }
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial001_an.py b/tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
new file mode 100644
index 000000000..4e14d89c8
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial001_an.py
@@ -0,0 +1,232 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+ from docs_src.request_form_models.tutorial001_an import app
+
+ client = TestClient(app)
+ return client
+
+
+def test_post_body_form(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+ assert response.status_code == 200
+ assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+def test_post_body_form_no_password(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo"})
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {"username": "Foo"},
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ }
+ ]
+ }
+ )
+
+
+def test_post_body_form_no_username(client: TestClient):
+ response = client.post("/login/", data={"password": "secret"})
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {"password": "secret"},
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ }
+ ]
+ }
+ )
+
+
+def test_post_body_form_no_data(client: TestClient):
+ response = client.post("/login/")
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
+
+
+def test_post_body_json(client: TestClient):
+ response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+ assert response.status_code == 422, response.text
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
+
+
+def test_openapi_schema(client: TestClient):
+ 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": {
+ "/login/": {
+ "post": {
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ "summary": "Login",
+ "operationId": "login_login__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {"$ref": "#/components/schemas/FormData"}
+ }
+ },
+ "required": True,
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "FormData": {
+ "properties": {
+ "username": {"type": "string", "title": "Username"},
+ "password": {"type": "string", "title": "Password"},
+ },
+ "type": "object",
+ "required": ["username", "password"],
+ "title": "FormData",
+ },
+ "ValidationError": {
+ "title": "ValidationError",
+ "required": ["loc", "msg", "type"],
+ "type": "object",
+ "properties": {
+ "loc": {
+ "title": "Location",
+ "type": "array",
+ "items": {
+ "anyOf": [{"type": "string"}, {"type": "integer"}]
+ },
+ },
+ "msg": {"title": "Message", "type": "string"},
+ "type": {"title": "Error Type", "type": "string"},
+ },
+ },
+ "HTTPValidationError": {
+ "title": "HTTPValidationError",
+ "type": "object",
+ "properties": {
+ "detail": {
+ "title": "Detail",
+ "type": "array",
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ }
+ },
+ },
+ }
+ },
+ }
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py b/tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py
new file mode 100644
index 000000000..2e6426aa7
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial001_an_py39.py
@@ -0,0 +1,240 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_py39
+
+
+@pytest.fixture(name="client")
+def get_client():
+ from docs_src.request_form_models.tutorial001_an_py39 import app
+
+ client = TestClient(app)
+ return client
+
+
+@needs_py39
+def test_post_body_form(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+ assert response.status_code == 200
+ assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+@needs_py39
+def test_post_body_form_no_password(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo"})
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {"username": "Foo"},
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ }
+ ]
+ }
+ )
+
+
+@needs_py39
+def test_post_body_form_no_username(client: TestClient):
+ response = client.post("/login/", data={"password": "secret"})
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {"password": "secret"},
+ }
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ }
+ ]
+ }
+ )
+
+
+@needs_py39
+def test_post_body_form_no_data(client: TestClient):
+ response = client.post("/login/")
+ assert response.status_code == 422
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
+
+
+@needs_py39
+def test_post_body_json(client: TestClient):
+ response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+ assert response.status_code == 422, response.text
+ assert response.json() == IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+ ) | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "loc": ["body", "username"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ {
+ "loc": ["body", "password"],
+ "msg": "field required",
+ "type": "value_error.missing",
+ },
+ ]
+ }
+ )
+
+
+@needs_py39
+def test_openapi_schema(client: TestClient):
+ 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": {
+ "/login/": {
+ "post": {
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ "summary": "Login",
+ "operationId": "login_login__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {"$ref": "#/components/schemas/FormData"}
+ }
+ },
+ "required": True,
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "FormData": {
+ "properties": {
+ "username": {"type": "string", "title": "Username"},
+ "password": {"type": "string", "title": "Password"},
+ },
+ "type": "object",
+ "required": ["username", "password"],
+ "title": "FormData",
+ },
+ "ValidationError": {
+ "title": "ValidationError",
+ "required": ["loc", "msg", "type"],
+ "type": "object",
+ "properties": {
+ "loc": {
+ "title": "Location",
+ "type": "array",
+ "items": {
+ "anyOf": [{"type": "string"}, {"type": "integer"}]
+ },
+ },
+ "msg": {"title": "Message", "type": "string"},
+ "type": {"title": "Error Type", "type": "string"},
+ },
+ },
+ "HTTPValidationError": {
+ "title": "HTTPValidationError",
+ "type": "object",
+ "properties": {
+ "detail": {
+ "title": "Detail",
+ "type": "array",
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ }
+ },
+ },
+ }
+ },
+ }
From e787f854ddbe12d08ae6b13298b6d5eda7e20928 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 5 Sep 2024 15:17:13 +0000
Subject: [PATCH 015/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9b44bc9a8..c6cbc7658 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Features
+
+* ✨ Add support for Pydantic models in `Form` parameters. PR [#12129](https://github.com/fastapi/fastapi/pull/12129) by [@tiangolo](https://github.com/tiangolo).
+
## 0.112.4
This release is mainly a big internal refactor to enable adding support for Pydantic models for `Form` fields, but that feature comes in the next release.
From afdda4e50ba002c951233f5bedcc64068d59d212 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 17:21:35 +0200
Subject: [PATCH 016/504] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors:=20Coh?=
=?UTF-8?q?erence=20link=20(#12130)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
README.md | 2 +-
docs/en/data/sponsors.yml | 2 +-
docs/en/docs/deployment/cloud.md | 2 +-
docs/en/overrides/main.html | 2 +-
4 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/README.md b/README.md
index 5554f71d4..3b01b713a 100644
--- a/README.md
+++ b/README.md
@@ -52,7 +52,7 @@ The key features are:
<a href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank" title="Automate FastAPI documentation generation with Bump.sh"><img src="https://fastapi.tiangolo.com/img/sponsors/bump-sh.svg"></a>
<a href="https://github.com/scalar/scalar/?utm_source=fastapi&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Scalar: Beautiful Open-Source API References from Swagger/OpenAPI files"><img src="https://fastapi.tiangolo.com/img/sponsors/scalar.svg"></a>
<a href="https://www.propelauth.com/?utm_source=fastapi&utm_campaign=1223&utm_medium=mainbadge" target="_blank" title="Auth, user management and more for your B2B product"><img src="https://fastapi.tiangolo.com/img/sponsors/propelauth.png"></a>
-<a href="https://docs.withcoherence.com/coherence-templates/full-stack-template/#fastapi?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs" target="_blank" title="Coherence"><img src="https://fastapi.tiangolo.com/img/sponsors/coherence.png"></a>
+<a href="https://www.withcoherence.com/?utm_medium=advertising&utm_source=fastapi&utm_campaign=website" target="_blank" title="Coherence"><img src="https://fastapi.tiangolo.com/img/sponsors/coherence.png"></a>
<a href="https://www.mongodb.com/developer/languages/python/python-quickstart-fastapi/?utm_campaign=fastapi_framework&utm_source=fastapi_sponsorship&utm_medium=web_referral" target="_blank" title="Simplify Full Stack Development with FastAPI & MongoDB"><img src="https://fastapi.tiangolo.com/img/sponsors/mongodb.png"></a>
<a href="https://zuplo.link/fastapi-gh" target="_blank" title="Zuplo: Scale, Protect, Document, and Monetize your FastAPI"><img src="https://fastapi.tiangolo.com/img/sponsors/zuplo.png"></a>
<a href="https://fine.dev?ref=fastapibadge" target="_blank" title="Fine's AI FastAPI Workflow: Effortlessly Deploy and Integrate FastAPI into Your Project"><img src="https://fastapi.tiangolo.com/img/sponsors/fine.png"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 3a767b6b1..d96646fb3 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -17,7 +17,7 @@ gold:
- url: https://www.propelauth.com/?utm_source=fastapi&utm_campaign=1223&utm_medium=mainbadge
title: Auth, user management and more for your B2B product
img: https://fastapi.tiangolo.com/img/sponsors/propelauth.png
- - url: https://docs.withcoherence.com/coherence-templates/full-stack-template/#fastapi?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs
+ - url: https://www.withcoherence.com/?utm_medium=advertising&utm_source=fastapi&utm_campaign=website
title: Coherence
img: https://fastapi.tiangolo.com/img/sponsors/coherence.png
- url: https://www.mongodb.com/developer/languages/python/python-quickstart-fastapi/?utm_campaign=fastapi_framework&utm_source=fastapi_sponsorship&utm_medium=web_referral
diff --git a/docs/en/docs/deployment/cloud.md b/docs/en/docs/deployment/cloud.md
index 3ea5087f8..41ada859d 100644
--- a/docs/en/docs/deployment/cloud.md
+++ b/docs/en/docs/deployment/cloud.md
@@ -14,4 +14,4 @@ You might want to try their services and follow their guides:
* <a href="https://docs.platform.sh/languages/python.html?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" class="external-link" target="_blank">Platform.sh</a>
* <a href="https://docs.porter.run/language-specific-guides/fastapi" class="external-link" target="_blank">Porter</a>
-* <a href="https://docs.withcoherence.com/coherence-templates/full-stack-template/#fastapi?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs" class="external-link" target="_blank">Coherence</a>
+* <a href="https://www.withcoherence.com/?utm_medium=advertising&utm_source=fastapi&utm_campaign=website" class="external-link" target="_blank">Coherence</a>
diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index 47e46c4bf..463c5af3b 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -59,7 +59,7 @@
</a>
</div>
<div class="item">
- <a title="Coherence" style="display: block; position: relative;" href="https://docs.withcoherence.com/coherence-templates/full-stack-template/#fastapi?utm_medium=advertising&utm_source=fastapi&utm_campaign=docs" target="_blank">
+ <a title="Coherence" style="display: block; position: relative;" href="https://www.withcoherence.com/?utm_medium=advertising&utm_source=fastapi&utm_campaign=website" target="_blank">
<span class="sponsor-badge">sponsor</span>
<img class="sponsor-image" src="/img/sponsors/coherence-banner.png" />
</a>
From 179f838c366b1d9ac74e114949c5c6cfe713ec03 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 5 Sep 2024 15:23:05 +0000
Subject: [PATCH 017/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c6cbc7658..acf53e3de 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -11,6 +11,10 @@ hide:
* ✨ Add support for Pydantic models in `Form` parameters. PR [#12129](https://github.com/fastapi/fastapi/pull/12129) by [@tiangolo](https://github.com/tiangolo).
+### Internal
+
+* 🔧 Update sponsors: Coherence link. PR [#12130](https://github.com/fastapi/fastapi/pull/12130) by [@tiangolo](https://github.com/tiangolo).
+
## 0.112.4
This release is mainly a big internal refactor to enable adding support for Pydantic models for `Form` fields, but that feature comes in the next release.
From d86f6603029def91e0798ca42f5fd12eff13c87b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 5 Sep 2024 17:25:29 +0200
Subject: [PATCH 018/504] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
=?UTF-8?q?3.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 25 +++++++++++++++++++++++++
fastapi/__init__.py | 2 +-
2 files changed, 26 insertions(+), 1 deletion(-)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index acf53e3de..0571523bf 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,31 @@ hide:
## Latest Changes
+## 0.113.0
+
+Now you can declare form fields with Pydantic models:
+
+```python
+from typing import Annotated
+
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+ return data
+```
+
+Read the new docs: [Form Models](https://fastapi.tiangolo.com/tutorial/request-form-models/).
+
### Features
* ✨ Add support for Pydantic models in `Form` parameters. PR [#12129](https://github.com/fastapi/fastapi/pull/12129) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 1e10bf557..f785f81cd 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
"""FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
-__version__ = "0.112.4"
+__version__ = "0.113.0"
from starlette import status as status
From c411b81c29f0e8365e0710baf951b4a42039a2e5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 6 Sep 2024 17:57:43 +0200
Subject: [PATCH 019/504] =?UTF-8?q?=E2=9C=85=20Update=20internal=20tests?=
=?UTF-8?q?=20for=20latest=20Pydantic,=20including=20CI=20tweaks=20to=20in?=
=?UTF-8?q?stall=20the=20latest=20Pydantic=20(#12147)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/workflows/test.yml | 4 ++--
tests/test_openapi_examples.py | 27 ++++++++++++++++++++-------
2 files changed, 22 insertions(+), 9 deletions(-)
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index e9db49b51..fb4b083c4 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -37,7 +37,7 @@ jobs:
if: steps.cache.outputs.cache-hit != 'true'
run: pip install -r requirements-tests.txt
- name: Install Pydantic v2
- run: pip install "pydantic>=2.0.2,<3.0.0"
+ run: pip install --upgrade "pydantic>=2.0.2,<3.0.0"
- name: Lint
run: bash scripts/lint.sh
@@ -79,7 +79,7 @@ jobs:
run: pip install "pydantic>=1.10.0,<2.0.0"
- name: Install Pydantic v2
if: matrix.pydantic-version == 'pydantic-v2'
- run: pip install "pydantic>=2.0.2,<3.0.0"
+ run: pip install --upgrade "pydantic>=2.0.2,<3.0.0"
- run: mkdir coverage
- name: Test
run: bash scripts/test.sh
diff --git a/tests/test_openapi_examples.py b/tests/test_openapi_examples.py
index 6597e5058..b3f83ae23 100644
--- a/tests/test_openapi_examples.py
+++ b/tests/test_openapi_examples.py
@@ -155,13 +155,26 @@ def test_openapi_schema():
"requestBody": {
"content": {
"application/json": {
- "schema": {
- "allOf": [{"$ref": "#/components/schemas/Item"}],
- "title": "Item",
- "examples": [
- {"data": "Data in Body examples, example1"}
- ],
- },
+ "schema": IsDict(
+ {
+ "$ref": "#/components/schemas/Item",
+ "examples": [
+ {"data": "Data in Body examples, example1"}
+ ],
+ }
+ )
+ | IsDict(
+ {
+ # TODO: remove when deprecating Pydantic v1
+ "allOf": [
+ {"$ref": "#/components/schemas/Item"}
+ ],
+ "title": "Item",
+ "examples": [
+ {"data": "Data in Body examples, example1"}
+ ],
+ }
+ ),
"examples": {
"Example One": {
"summary": "Example One Summary",
From 1b06b532677c91006efe01e4bd09b5d91f5df261 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 6 Sep 2024 15:58:05 +0000
Subject: [PATCH 020/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 0571523bf..2b9bd3e87 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Internal
+
+* ✅ Update internal tests for latest Pydantic, including CI tweaks to install the latest Pydantic. PR [#12147](https://github.com/fastapi/fastapi/pull/12147) by [@tiangolo](https://github.com/tiangolo).
+
## 0.113.0
Now you can declare form fields with Pydantic models:
From 4633b1bca933e68dac5c3bcce797ff5963debe2a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 6 Sep 2024 19:31:18 +0200
Subject: [PATCH 021/504] =?UTF-8?q?=E2=9C=A8=20Add=20support=20for=20forbi?=
=?UTF-8?q?dding=20extra=20form=20fields=20with=20Pydantic=20models=20(#12?=
=?UTF-8?q?134)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Co-authored-by: Sofie Van Landeghem <svlandeg@users.noreply.github.com>
---
docs/en/docs/tutorial/request-form-models.md | 75 ++++++-
docs_src/request_form_models/tutorial002.py | 15 ++
.../request_form_models/tutorial002_an.py | 16 ++
.../tutorial002_an_py39.py | 17 ++
.../request_form_models/tutorial002_pv1.py | 17 ++
.../request_form_models/tutorial002_pv1_an.py | 18 ++
.../tutorial002_pv1_an_py39.py | 19 ++
fastapi/dependencies/utils.py | 3 +
.../test_tutorial002.py | 196 +++++++++++++++++
.../test_tutorial002_an.py | 196 +++++++++++++++++
.../test_tutorial002_an_py39.py | 203 ++++++++++++++++++
.../test_tutorial002_pv1.py | 189 ++++++++++++++++
.../test_tutorial002_pv1_an.py | 196 +++++++++++++++++
.../test_tutorial002_pv1_an_p39.py | 203 ++++++++++++++++++
14 files changed, 1360 insertions(+), 3 deletions(-)
create mode 100644 docs_src/request_form_models/tutorial002.py
create mode 100644 docs_src/request_form_models/tutorial002_an.py
create mode 100644 docs_src/request_form_models/tutorial002_an_py39.py
create mode 100644 docs_src/request_form_models/tutorial002_pv1.py
create mode 100644 docs_src/request_form_models/tutorial002_pv1_an.py
create mode 100644 docs_src/request_form_models/tutorial002_pv1_an_py39.py
create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial002.py
create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial002_an.py
create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial002_an_py39.py
create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial002_pv1.py
create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an.py
create mode 100644 tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an_p39.py
diff --git a/docs/en/docs/tutorial/request-form-models.md b/docs/en/docs/tutorial/request-form-models.md
index 8bb1ffb1f..a317ee14d 100644
--- a/docs/en/docs/tutorial/request-form-models.md
+++ b/docs/en/docs/tutorial/request-form-models.md
@@ -1,6 +1,6 @@
# Form Models
-You can use Pydantic models to declare form fields in FastAPI.
+You can use **Pydantic models** to declare **form fields** in FastAPI.
/// info
@@ -22,7 +22,7 @@ This is supported since FastAPI version `0.113.0`. 🤓
## Pydantic Models for Forms
-You just need to declare a Pydantic model with the fields you want to receive as form fields, and then declare the parameter as `Form`:
+You just need to declare a **Pydantic model** with the fields you want to receive as **form fields**, and then declare the parameter as `Form`:
//// tab | Python 3.9+
@@ -54,7 +54,7 @@ Prefer to use the `Annotated` version if possible.
////
-FastAPI will extract the data for each field from the form data in the request and give you the Pydantic model you defined.
+**FastAPI** will **extract** the data for **each field** from the **form data** in the request and give you the Pydantic model you defined.
## Check the Docs
@@ -63,3 +63,72 @@ You can verify it in the docs UI at `/docs`:
<div class="screenshot">
<img src="/img/tutorial/request-form-models/image01.png">
</div>
+
+## Restrict Extra Form Fields
+
+In some special use cases (probably not very common), you might want to **restrict** the form fields to only those declared in the Pydantic model. And **forbid** any **extra** fields.
+
+/// note
+
+This is supported since FastAPI version `0.114.0`. 🤓
+
+///
+
+You can use Pydantic's model configuration to `forbid` any `extra` fields:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="12"
+{!> ../../../docs_src/request_form_models/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../../docs_src/request_form_models/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="10"
+{!> ../../../docs_src/request_form_models/tutorial002.py!}
+```
+
+////
+
+If a client tries to send some extra data, they will receive an **error** response.
+
+For example, if the client tries to send the form fields:
+
+* `username`: `Rick`
+* `password`: `Portal Gun`
+* `extra`: `Mr. Poopybutthole`
+
+They will receive an error response telling them that the field `extra` is not allowed:
+
+```json
+{
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["body", "extra"],
+ "msg": "Extra inputs are not permitted",
+ "input": "Mr. Poopybutthole"
+ }
+ ]
+}
+```
+
+## Summary
+
+You can use Pydantic models to declare form fields in FastAPI. 😎
diff --git a/docs_src/request_form_models/tutorial002.py b/docs_src/request_form_models/tutorial002.py
new file mode 100644
index 000000000..59b329e8d
--- /dev/null
+++ b/docs_src/request_form_models/tutorial002.py
@@ -0,0 +1,15 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+ model_config = {"extra": "forbid"}
+
+
+@app.post("/login/")
+async def login(data: FormData = Form()):
+ return data
diff --git a/docs_src/request_form_models/tutorial002_an.py b/docs_src/request_form_models/tutorial002_an.py
new file mode 100644
index 000000000..bcb022795
--- /dev/null
+++ b/docs_src/request_form_models/tutorial002_an.py
@@ -0,0 +1,16 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+ model_config = {"extra": "forbid"}
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+ return data
diff --git a/docs_src/request_form_models/tutorial002_an_py39.py b/docs_src/request_form_models/tutorial002_an_py39.py
new file mode 100644
index 000000000..3004e0852
--- /dev/null
+++ b/docs_src/request_form_models/tutorial002_an_py39.py
@@ -0,0 +1,17 @@
+from typing import Annotated
+
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+ model_config = {"extra": "forbid"}
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+ return data
diff --git a/docs_src/request_form_models/tutorial002_pv1.py b/docs_src/request_form_models/tutorial002_pv1.py
new file mode 100644
index 000000000..d5f7db2a6
--- /dev/null
+++ b/docs_src/request_form_models/tutorial002_pv1.py
@@ -0,0 +1,17 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+
+ class Config:
+ extra = "forbid"
+
+
+@app.post("/login/")
+async def login(data: FormData = Form()):
+ return data
diff --git a/docs_src/request_form_models/tutorial002_pv1_an.py b/docs_src/request_form_models/tutorial002_pv1_an.py
new file mode 100644
index 000000000..fe9dbc344
--- /dev/null
+++ b/docs_src/request_form_models/tutorial002_pv1_an.py
@@ -0,0 +1,18 @@
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+
+ class Config:
+ extra = "forbid"
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+ return data
diff --git a/docs_src/request_form_models/tutorial002_pv1_an_py39.py b/docs_src/request_form_models/tutorial002_pv1_an_py39.py
new file mode 100644
index 000000000..942d5d411
--- /dev/null
+++ b/docs_src/request_form_models/tutorial002_pv1_an_py39.py
@@ -0,0 +1,19 @@
+from typing import Annotated
+
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+
+ class Config:
+ extra = "forbid"
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+ return data
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 98ce17b55..6083b7319 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -789,6 +789,9 @@ async def _extract_form_body(
value = serialize_sequence_value(field=field, value=results)
if value is not None:
values[field.name] = value
+ for key, value in received_body.items():
+ if key not in values:
+ values[key] = value
return values
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial002.py b/tests/test_tutorial/test_request_form_models/test_tutorial002.py
new file mode 100644
index 000000000..76f480001
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial002.py
@@ -0,0 +1,196 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client():
+ from docs_src.request_form_models.tutorial002 import app
+
+ client = TestClient(app)
+ return client
+
+
+@needs_pydanticv2
+def test_post_body_form(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+ assert response.status_code == 200
+ assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+@needs_pydanticv2
+def test_post_body_extra_form(client: TestClient):
+ response = client.post(
+ "/login/", data={"username": "Foo", "password": "secret", "extra": "extra"}
+ )
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["body", "extra"],
+ "msg": "Extra inputs are not permitted",
+ "input": "extra",
+ }
+ ]
+ }
+
+
+@needs_pydanticv2
+def test_post_body_form_no_password(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo"})
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {"username": "Foo"},
+ }
+ ]
+ }
+
+
+@needs_pydanticv2
+def test_post_body_form_no_username(client: TestClient):
+ response = client.post("/login/", data={"password": "secret"})
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {"password": "secret"},
+ }
+ ]
+ }
+
+
+@needs_pydanticv2
+def test_post_body_form_no_data(client: TestClient):
+ response = client.post("/login/")
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+
+
+@needs_pydanticv2
+def test_post_body_json(client: TestClient):
+ response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+ assert response.status_code == 422, response.text
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+
+
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient):
+ 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": {
+ "/login/": {
+ "post": {
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ "summary": "Login",
+ "operationId": "login_login__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {"$ref": "#/components/schemas/FormData"}
+ }
+ },
+ "required": True,
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "FormData": {
+ "properties": {
+ "username": {"type": "string", "title": "Username"},
+ "password": {"type": "string", "title": "Password"},
+ },
+ "additionalProperties": False,
+ "type": "object",
+ "required": ["username", "password"],
+ "title": "FormData",
+ },
+ "ValidationError": {
+ "title": "ValidationError",
+ "required": ["loc", "msg", "type"],
+ "type": "object",
+ "properties": {
+ "loc": {
+ "title": "Location",
+ "type": "array",
+ "items": {
+ "anyOf": [{"type": "string"}, {"type": "integer"}]
+ },
+ },
+ "msg": {"title": "Message", "type": "string"},
+ "type": {"title": "Error Type", "type": "string"},
+ },
+ },
+ "HTTPValidationError": {
+ "title": "HTTPValidationError",
+ "type": "object",
+ "properties": {
+ "detail": {
+ "title": "Detail",
+ "type": "array",
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ }
+ },
+ },
+ }
+ },
+ }
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial002_an.py b/tests/test_tutorial/test_request_form_models/test_tutorial002_an.py
new file mode 100644
index 000000000..179b2977d
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial002_an.py
@@ -0,0 +1,196 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client():
+ from docs_src.request_form_models.tutorial002_an import app
+
+ client = TestClient(app)
+ return client
+
+
+@needs_pydanticv2
+def test_post_body_form(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+ assert response.status_code == 200
+ assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+@needs_pydanticv2
+def test_post_body_extra_form(client: TestClient):
+ response = client.post(
+ "/login/", data={"username": "Foo", "password": "secret", "extra": "extra"}
+ )
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["body", "extra"],
+ "msg": "Extra inputs are not permitted",
+ "input": "extra",
+ }
+ ]
+ }
+
+
+@needs_pydanticv2
+def test_post_body_form_no_password(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo"})
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {"username": "Foo"},
+ }
+ ]
+ }
+
+
+@needs_pydanticv2
+def test_post_body_form_no_username(client: TestClient):
+ response = client.post("/login/", data={"password": "secret"})
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {"password": "secret"},
+ }
+ ]
+ }
+
+
+@needs_pydanticv2
+def test_post_body_form_no_data(client: TestClient):
+ response = client.post("/login/")
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+
+
+@needs_pydanticv2
+def test_post_body_json(client: TestClient):
+ response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+ assert response.status_code == 422, response.text
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+
+
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient):
+ 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": {
+ "/login/": {
+ "post": {
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ "summary": "Login",
+ "operationId": "login_login__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {"$ref": "#/components/schemas/FormData"}
+ }
+ },
+ "required": True,
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "FormData": {
+ "properties": {
+ "username": {"type": "string", "title": "Username"},
+ "password": {"type": "string", "title": "Password"},
+ },
+ "additionalProperties": False,
+ "type": "object",
+ "required": ["username", "password"],
+ "title": "FormData",
+ },
+ "ValidationError": {
+ "title": "ValidationError",
+ "required": ["loc", "msg", "type"],
+ "type": "object",
+ "properties": {
+ "loc": {
+ "title": "Location",
+ "type": "array",
+ "items": {
+ "anyOf": [{"type": "string"}, {"type": "integer"}]
+ },
+ },
+ "msg": {"title": "Message", "type": "string"},
+ "type": {"title": "Error Type", "type": "string"},
+ },
+ },
+ "HTTPValidationError": {
+ "title": "HTTPValidationError",
+ "type": "object",
+ "properties": {
+ "detail": {
+ "title": "Detail",
+ "type": "array",
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ }
+ },
+ },
+ }
+ },
+ }
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial002_an_py39.py b/tests/test_tutorial/test_request_form_models/test_tutorial002_an_py39.py
new file mode 100644
index 000000000..510ad9d7c
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial002_an_py39.py
@@ -0,0 +1,203 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_py39, needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client():
+ from docs_src.request_form_models.tutorial002_an_py39 import app
+
+ client = TestClient(app)
+ return client
+
+
+@needs_pydanticv2
+@needs_py39
+def test_post_body_form(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+ assert response.status_code == 200
+ assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+@needs_pydanticv2
+@needs_py39
+def test_post_body_extra_form(client: TestClient):
+ response = client.post(
+ "/login/", data={"username": "Foo", "password": "secret", "extra": "extra"}
+ )
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["body", "extra"],
+ "msg": "Extra inputs are not permitted",
+ "input": "extra",
+ }
+ ]
+ }
+
+
+@needs_pydanticv2
+@needs_py39
+def test_post_body_form_no_password(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo"})
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {"username": "Foo"},
+ }
+ ]
+ }
+
+
+@needs_pydanticv2
+@needs_py39
+def test_post_body_form_no_username(client: TestClient):
+ response = client.post("/login/", data={"password": "secret"})
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {"password": "secret"},
+ }
+ ]
+ }
+
+
+@needs_pydanticv2
+@needs_py39
+def test_post_body_form_no_data(client: TestClient):
+ response = client.post("/login/")
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+
+
+@needs_pydanticv2
+@needs_py39
+def test_post_body_json(client: TestClient):
+ response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+ assert response.status_code == 422, response.text
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["body", "username"],
+ "msg": "Field required",
+ "input": {},
+ },
+ {
+ "type": "missing",
+ "loc": ["body", "password"],
+ "msg": "Field required",
+ "input": {},
+ },
+ ]
+ }
+
+
+@needs_pydanticv2
+@needs_py39
+def test_openapi_schema(client: TestClient):
+ 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": {
+ "/login/": {
+ "post": {
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ "summary": "Login",
+ "operationId": "login_login__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {"$ref": "#/components/schemas/FormData"}
+ }
+ },
+ "required": True,
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "FormData": {
+ "properties": {
+ "username": {"type": "string", "title": "Username"},
+ "password": {"type": "string", "title": "Password"},
+ },
+ "additionalProperties": False,
+ "type": "object",
+ "required": ["username", "password"],
+ "title": "FormData",
+ },
+ "ValidationError": {
+ "title": "ValidationError",
+ "required": ["loc", "msg", "type"],
+ "type": "object",
+ "properties": {
+ "loc": {
+ "title": "Location",
+ "type": "array",
+ "items": {
+ "anyOf": [{"type": "string"}, {"type": "integer"}]
+ },
+ },
+ "msg": {"title": "Message", "type": "string"},
+ "type": {"title": "Error Type", "type": "string"},
+ },
+ },
+ "HTTPValidationError": {
+ "title": "HTTPValidationError",
+ "type": "object",
+ "properties": {
+ "detail": {
+ "title": "Detail",
+ "type": "array",
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ }
+ },
+ },
+ }
+ },
+ }
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1.py b/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1.py
new file mode 100644
index 000000000..249b9379d
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1.py
@@ -0,0 +1,189 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_pydanticv1
+
+
+@pytest.fixture(name="client")
+def get_client():
+ from docs_src.request_form_models.tutorial002_pv1 import app
+
+ client = TestClient(app)
+ return client
+
+
+@needs_pydanticv1
+def test_post_body_form(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+ assert response.status_code == 200
+ assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+@needs_pydanticv1
+def test_post_body_extra_form(client: TestClient):
+ response = client.post(
+ "/login/", data={"username": "Foo", "password": "secret", "extra": "extra"}
+ )
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.extra",
+ "loc": ["body", "extra"],
+ "msg": "extra fields not permitted",
+ }
+ ]
+ }
+
+
+@needs_pydanticv1
+def test_post_body_form_no_password(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo"})
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "password"],
+ "msg": "field required",
+ }
+ ]
+ }
+
+
+@needs_pydanticv1
+def test_post_body_form_no_username(client: TestClient):
+ response = client.post("/login/", data={"password": "secret"})
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "username"],
+ "msg": "field required",
+ }
+ ]
+ }
+
+
+@needs_pydanticv1
+def test_post_body_form_no_data(client: TestClient):
+ response = client.post("/login/")
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "username"],
+ "msg": "field required",
+ },
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "password"],
+ "msg": "field required",
+ },
+ ]
+ }
+
+
+@needs_pydanticv1
+def test_post_body_json(client: TestClient):
+ response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+ assert response.status_code == 422, response.text
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "username"],
+ "msg": "field required",
+ },
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "password"],
+ "msg": "field required",
+ },
+ ]
+ }
+
+
+@needs_pydanticv1
+def test_openapi_schema(client: TestClient):
+ 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": {
+ "/login/": {
+ "post": {
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ "summary": "Login",
+ "operationId": "login_login__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {"$ref": "#/components/schemas/FormData"}
+ }
+ },
+ "required": True,
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "FormData": {
+ "properties": {
+ "username": {"type": "string", "title": "Username"},
+ "password": {"type": "string", "title": "Password"},
+ },
+ "additionalProperties": False,
+ "type": "object",
+ "required": ["username", "password"],
+ "title": "FormData",
+ },
+ "ValidationError": {
+ "title": "ValidationError",
+ "required": ["loc", "msg", "type"],
+ "type": "object",
+ "properties": {
+ "loc": {
+ "title": "Location",
+ "type": "array",
+ "items": {
+ "anyOf": [{"type": "string"}, {"type": "integer"}]
+ },
+ },
+ "msg": {"title": "Message", "type": "string"},
+ "type": {"title": "Error Type", "type": "string"},
+ },
+ },
+ "HTTPValidationError": {
+ "title": "HTTPValidationError",
+ "type": "object",
+ "properties": {
+ "detail": {
+ "title": "Detail",
+ "type": "array",
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ }
+ },
+ },
+ }
+ },
+ }
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an.py b/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an.py
new file mode 100644
index 000000000..44cb3c32b
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an.py
@@ -0,0 +1,196 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_pydanticv1
+
+
+@pytest.fixture(name="client")
+def get_client():
+ from docs_src.request_form_models.tutorial002_pv1_an import app
+
+ client = TestClient(app)
+ return client
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_post_body_form(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+ assert response.status_code == 200
+ assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_post_body_extra_form(client: TestClient):
+ response = client.post(
+ "/login/", data={"username": "Foo", "password": "secret", "extra": "extra"}
+ )
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.extra",
+ "loc": ["body", "extra"],
+ "msg": "extra fields not permitted",
+ }
+ ]
+ }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_post_body_form_no_password(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo"})
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "password"],
+ "msg": "field required",
+ }
+ ]
+ }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_post_body_form_no_username(client: TestClient):
+ response = client.post("/login/", data={"password": "secret"})
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "username"],
+ "msg": "field required",
+ }
+ ]
+ }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_post_body_form_no_data(client: TestClient):
+ response = client.post("/login/")
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "username"],
+ "msg": "field required",
+ },
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "password"],
+ "msg": "field required",
+ },
+ ]
+ }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_post_body_json(client: TestClient):
+ response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+ assert response.status_code == 422, response.text
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "username"],
+ "msg": "field required",
+ },
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "password"],
+ "msg": "field required",
+ },
+ ]
+ }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_openapi_schema(client: TestClient):
+ 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": {
+ "/login/": {
+ "post": {
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ "summary": "Login",
+ "operationId": "login_login__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {"$ref": "#/components/schemas/FormData"}
+ }
+ },
+ "required": True,
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "FormData": {
+ "properties": {
+ "username": {"type": "string", "title": "Username"},
+ "password": {"type": "string", "title": "Password"},
+ },
+ "additionalProperties": False,
+ "type": "object",
+ "required": ["username", "password"],
+ "title": "FormData",
+ },
+ "ValidationError": {
+ "title": "ValidationError",
+ "required": ["loc", "msg", "type"],
+ "type": "object",
+ "properties": {
+ "loc": {
+ "title": "Location",
+ "type": "array",
+ "items": {
+ "anyOf": [{"type": "string"}, {"type": "integer"}]
+ },
+ },
+ "msg": {"title": "Message", "type": "string"},
+ "type": {"title": "Error Type", "type": "string"},
+ },
+ },
+ "HTTPValidationError": {
+ "title": "HTTPValidationError",
+ "type": "object",
+ "properties": {
+ "detail": {
+ "title": "Detail",
+ "type": "array",
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ }
+ },
+ },
+ }
+ },
+ }
diff --git a/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an_p39.py b/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an_p39.py
new file mode 100644
index 000000000..899549e40
--- /dev/null
+++ b/tests/test_tutorial/test_request_form_models/test_tutorial002_pv1_an_p39.py
@@ -0,0 +1,203 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from tests.utils import needs_py39, needs_pydanticv1
+
+
+@pytest.fixture(name="client")
+def get_client():
+ from docs_src.request_form_models.tutorial002_pv1_an_py39 import app
+
+ client = TestClient(app)
+ return client
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@needs_py39
+def test_post_body_form(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo", "password": "secret"})
+ assert response.status_code == 200
+ assert response.json() == {"username": "Foo", "password": "secret"}
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@needs_py39
+def test_post_body_extra_form(client: TestClient):
+ response = client.post(
+ "/login/", data={"username": "Foo", "password": "secret", "extra": "extra"}
+ )
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.extra",
+ "loc": ["body", "extra"],
+ "msg": "extra fields not permitted",
+ }
+ ]
+ }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@needs_py39
+def test_post_body_form_no_password(client: TestClient):
+ response = client.post("/login/", data={"username": "Foo"})
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "password"],
+ "msg": "field required",
+ }
+ ]
+ }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@needs_py39
+def test_post_body_form_no_username(client: TestClient):
+ response = client.post("/login/", data={"password": "secret"})
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "username"],
+ "msg": "field required",
+ }
+ ]
+ }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@needs_py39
+def test_post_body_form_no_data(client: TestClient):
+ response = client.post("/login/")
+ assert response.status_code == 422
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "username"],
+ "msg": "field required",
+ },
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "password"],
+ "msg": "field required",
+ },
+ ]
+ }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@needs_py39
+def test_post_body_json(client: TestClient):
+ response = client.post("/login/", json={"username": "Foo", "password": "secret"})
+ assert response.status_code == 422, response.text
+ assert response.json() == {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "username"],
+ "msg": "field required",
+ },
+ {
+ "type": "value_error.missing",
+ "loc": ["body", "password"],
+ "msg": "field required",
+ },
+ ]
+ }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+@needs_py39
+def test_openapi_schema(client: TestClient):
+ 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": {
+ "/login/": {
+ "post": {
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ "summary": "Login",
+ "operationId": "login_login__post",
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {"$ref": "#/components/schemas/FormData"}
+ }
+ },
+ "required": True,
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "FormData": {
+ "properties": {
+ "username": {"type": "string", "title": "Username"},
+ "password": {"type": "string", "title": "Password"},
+ },
+ "additionalProperties": False,
+ "type": "object",
+ "required": ["username", "password"],
+ "title": "FormData",
+ },
+ "ValidationError": {
+ "title": "ValidationError",
+ "required": ["loc", "msg", "type"],
+ "type": "object",
+ "properties": {
+ "loc": {
+ "title": "Location",
+ "type": "array",
+ "items": {
+ "anyOf": [{"type": "string"}, {"type": "integer"}]
+ },
+ },
+ "msg": {"title": "Message", "type": "string"},
+ "type": {"title": "Error Type", "type": "string"},
+ },
+ },
+ "HTTPValidationError": {
+ "title": "HTTPValidationError",
+ "type": "object",
+ "properties": {
+ "detail": {
+ "title": "Detail",
+ "type": "array",
+ "items": {"$ref": "#/components/schemas/ValidationError"},
+ }
+ },
+ },
+ }
+ },
+ }
From a11e392f5f0ae8b50f92252f811764d48929466f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 6 Sep 2024 17:31:44 +0000
Subject: [PATCH 022/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2b9bd3e87..7f4353cfe 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Features
+
+* ✨ Add support for forbidding extra form fields with Pydantic models. PR [#12134](https://github.com/fastapi/fastapi/pull/12134) by [@tiangolo](https://github.com/tiangolo).
+
### Internal
* ✅ Update internal tests for latest Pydantic, including CI tweaks to install the latest Pydantic. PR [#12147](https://github.com/fastapi/fastapi/pull/12147) by [@tiangolo](https://github.com/tiangolo).
From 4ff22a0c4167e5fe5dc039b29531329398d67ad5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 6 Sep 2024 19:38:23 +0200
Subject: [PATCH 023/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20docs,=20Form=20?=
=?UTF-8?q?Models=20section=20title,=20to=20match=20config=20name=20(#1215?=
=?UTF-8?q?2)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/request-form-models.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/en/docs/tutorial/request-form-models.md b/docs/en/docs/tutorial/request-form-models.md
index a317ee14d..1440d17b8 100644
--- a/docs/en/docs/tutorial/request-form-models.md
+++ b/docs/en/docs/tutorial/request-form-models.md
@@ -64,7 +64,7 @@ You can verify it in the docs UI at `/docs`:
<img src="/img/tutorial/request-form-models/image01.png">
</div>
-## Restrict Extra Form Fields
+## Forbid Extra Form Fields
In some special use cases (probably not very common), you might want to **restrict** the form fields to only those declared in the Pydantic model. And **forbid** any **extra** fields.
From e68d8c60fbe22609b6e3c3a652474088eeba18e6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 6 Sep 2024 17:38:50 +0000
Subject: [PATCH 024/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 7f4353cfe..b7db0f780 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -11,6 +11,10 @@ hide:
* ✨ Add support for forbidding extra form fields with Pydantic models. PR [#12134](https://github.com/fastapi/fastapi/pull/12134) by [@tiangolo](https://github.com/tiangolo).
+### Docs
+
+* 📝 Update docs, Form Models section title, to match config name. PR [#12152](https://github.com/fastapi/fastapi/pull/12152) by [@tiangolo](https://github.com/tiangolo).
+
### Internal
* ✅ Update internal tests for latest Pydantic, including CI tweaks to install the latest Pydantic. PR [#12147](https://github.com/fastapi/fastapi/pull/12147) by [@tiangolo](https://github.com/tiangolo).
From 74842f0a604f9e90e6ffb71c352186389060b1b6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 6 Sep 2024 19:40:27 +0200
Subject: [PATCH 025/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 24 ++++++++++++++++++++++++
1 file changed, 24 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b7db0f780..94f494375 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,30 @@ hide:
## Latest Changes
+You can restrict form fields to only include those declared in a Pydantic model and forbid any extra field sent in the request using Pydantic's `model_config = {"extra": "forbid"}`:
+
+```python
+from typing import Annotated
+
+from fastapi import FastAPI, Form
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class FormData(BaseModel):
+ username: str
+ password: str
+ model_config = {"extra": "forbid"}
+
+
+@app.post("/login/")
+async def login(data: Annotated[FormData, Form()]):
+ return data
+```
+
+Read the new docs: [Form Models - Forbid Extra Form Fields](https://fastapi.tiangolo.com/tutorial/request-form-models/#forbid-extra-form-fields).
+
### Features
* ✨ Add support for forbidding extra form fields with Pydantic models. PR [#12134](https://github.com/fastapi/fastapi/pull/12134) by [@tiangolo](https://github.com/tiangolo).
From bde12faea20313e4570f7cb896c201058c26e546 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 6 Sep 2024 19:41:13 +0200
Subject: [PATCH 026/504] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
=?UTF-8?q?4.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 2 ++
fastapi/__init__.py | 2 +-
2 files changed, 3 insertions(+), 1 deletion(-)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 94f494375..557498278 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
## Latest Changes
+## 0.114.0
+
You can restrict form fields to only include those declared in a Pydantic model and forbid any extra field sent in the request using Pydantic's `model_config = {"extra": "forbid"}`:
```python
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index f785f81cd..dce17360f 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
"""FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
-__version__ = "0.113.0"
+__version__ = "0.114.0"
from starlette import status as status
From b60d36e7533e0ae299cdff0d72b078d1f036ac67 Mon Sep 17 00:00:00 2001
From: Vaibhav <35167042+surreal30@users.noreply.github.com>
Date: Fri, 6 Sep 2024 23:36:20 +0530
Subject: [PATCH 027/504] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typo=20in=20?=
=?UTF-8?q?`fastapi/params.py`=20(#12143)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
fastapi/params.py | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/fastapi/params.py b/fastapi/params.py
index 3dfa5a1a3..90ca7cb01 100644
--- a/fastapi/params.py
+++ b/fastapi/params.py
@@ -556,7 +556,7 @@ class Body(FieldInfo):
kwargs["examples"] = examples
if regex is not None:
warnings.warn(
- "`regex` has been depreacated, please use `pattern` instead",
+ "`regex` has been deprecated, please use `pattern` instead",
category=DeprecationWarning,
stacklevel=4,
)
From 4b9e5b3a7433f13dcb1ca6d284326b1753231af2 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 6 Sep 2024 18:06:45 +0000
Subject: [PATCH 028/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 557498278..23bb2d9d1 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Internal
+
+* ✏️ Fix typo in `fastapi/params.py`. PR [#12143](https://github.com/fastapi/fastapi/pull/12143) by [@surreal30](https://github.com/surreal30).
+
## 0.114.0
You can restrict form fields to only include those declared in a Pydantic model and forbid any extra field sent in the request using Pydantic's `model_config = {"extra": "forbid"}`:
From edb584199f3341b205da5d7e1686c54d8719b82d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 7 Sep 2024 17:21:14 +0200
Subject: [PATCH 029/504] =?UTF-8?q?=F0=9F=91=B7=20Update=20`issue-manager.?=
=?UTF-8?q?yml`=20(#12159)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/workflows/issue-manager.yml | 7 ++++---
1 file changed, 4 insertions(+), 3 deletions(-)
diff --git a/.github/workflows/issue-manager.yml b/.github/workflows/issue-manager.yml
index d5b947a9c..fbb856792 100644
--- a/.github/workflows/issue-manager.yml
+++ b/.github/workflows/issue-manager.yml
@@ -2,7 +2,7 @@ name: Issue Manager
on:
schedule:
- - cron: "10 3 * * *"
+ - cron: "13 22 * * *"
issue_comment:
types:
- created
@@ -16,6 +16,7 @@ on:
permissions:
issues: write
+ pull-requests: write
jobs:
issue-manager:
@@ -35,8 +36,8 @@ jobs:
"delay": 864000,
"message": "Assuming the original need was handled, this will be automatically closed now. But feel free to add more comments or create new issues or PRs."
},
- "changes-requested": {
+ "waiting": {
"delay": 2628000,
- "message": "As this PR had requested changes to be applied but has been inactive for a while, it's now going to be closed. But if there's anyone interested, feel free to create a new PR."
+ "message": "As this PR has been waiting for the original user for a while but seems to be inactive, it's now going to be closed. But if there's anyone interested, feel free to create a new PR."
}
}
From b501fc6dafbef19a9d17b8484469ca81426c8e9d Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 7 Sep 2024 15:24:06 +0000
Subject: [PATCH 030/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 23bb2d9d1..16bd6e526 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Internal
+* 👷 Update `issue-manager.yml`. PR [#12159](https://github.com/fastapi/fastapi/pull/12159) by [@tiangolo](https://github.com/tiangolo).
* ✏️ Fix typo in `fastapi/params.py`. PR [#12143](https://github.com/fastapi/fastapi/pull/12143) by [@surreal30](https://github.com/surreal30).
## 0.114.0
From ec2a50829202ab98f166f581053d82b74d3f1130 Mon Sep 17 00:00:00 2001
From: BORA <88664069+BORA040126@users.noreply.github.com>
Date: Sun, 8 Sep 2024 08:35:43 +0900
Subject: [PATCH 031/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/project-generation.md`=20(#12157)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/project-generation.md | 28 ++++++++++++++++++++++++++++
1 file changed, 28 insertions(+)
create mode 100644 docs/ko/docs/project-generation.md
diff --git a/docs/ko/docs/project-generation.md b/docs/ko/docs/project-generation.md
new file mode 100644
index 000000000..019919f77
--- /dev/null
+++ b/docs/ko/docs/project-generation.md
@@ -0,0 +1,28 @@
+# Full Stack FastAPI 템플릿
+
+템플릿은 일반적으로 특정 설정과 함께 제공되지만, 유연하고 커스터마이징이 가능하게 디자인 되었습니다. 이 특성들은 여러분이 프로젝트의 요구사항에 맞춰 수정, 적용을 할 수 있게 해주고, 템플릿이 완벽한 시작점이 되게 해줍니다. 🏁
+
+많은 초기 설정, 보안, 데이터베이스 및 일부 API 엔드포인트가 이미 준비되어 있으므로, 여러분은 이 템플릿을 (프로젝트를) 시작하는 데 사용할 수 있습니다.
+
+GitHub 저장소: <a href="https://github.com/tiangolo/full-stack-fastapi-template" class="external-link" target="_blank">Full Stack FastAPI 템플릿</a>
+
+## Full Stack FastAPI 템플릿 - 기술 스택과 기능들
+
+- ⚡ [**FastAPI**](https://fastapi.tiangolo.com): Python 백엔드 API.
+ - 🧰 [SQLModel](https://sqlmodel.tiangolo.com): Python SQL 데이터 상호작용을 위한 (ORM).
+ - 🔍 [Pydantic](https://docs.pydantic.dev): FastAPI에 의해 사용되는, 데이터 검증과 설정관리.
+ - 💾 [PostgreSQL](https://www.postgresql.org): SQL 데이터베이스.
+- 🚀 [React](https://react.dev): 프론트엔드.
+ - 💃 TypeScript, hooks, Vite 및 기타 현대적인 프론트엔드 스택을 사용.
+ - 🎨 [Chakra UI](https://chakra-ui.com): 프론트엔드 컴포넌트.
+ - 🤖 자동으로 생성된 프론트엔드 클라이언트.
+ - 🧪 E2E 테스트를 위한 Playwright.
+ - 🦇 다크 모드 지원.
+- 🐋 [Docker Compose](https://www.docker.com): 개발 환경과 프로덕션(운영).
+- 🔒 기본으로 지원되는 안전한 비밀번호 해싱.
+- 🔑 JWT 토큰 인증.
+- 📫 이메일 기반 비밀번호 복구.
+- ✅ [Pytest]를 이용한 테스트(https://pytest.org).
+- 📞 [Traefik](https://traefik.io): 리버스 프록시 / 로드 밸런서.
+- 🚢 Docker Compose를 이용한 배포 지침: 자동 HTTPS 인증서를 처리하기 위한 프론트엔드 Traefik 프록시 설정 방법을 포함.
+- 🏭 GitHub Actions를 기반으로 CI (지속적인 통합) 및 CD (지속적인 배포).
From 3a4431b6feb50a86a60ce034580cf9fbacee9d32 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 7 Sep 2024 23:36:05 +0000
Subject: [PATCH 032/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 16bd6e526..e09eb57b6 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Translations
+
+* 🌐 Add Korean translation for `docs/ko/docs/project-generation.md`. PR [#12157](https://github.com/fastapi/fastapi/pull/12157) by [@BORA040126](https://github.com/BORA040126).
+
### Internal
* 👷 Update `issue-manager.yml`. PR [#12159](https://github.com/fastapi/fastapi/pull/12159) by [@tiangolo](https://github.com/tiangolo).
From 270aef71c47694ca349afeba95d13ade195185d2 Mon Sep 17 00:00:00 2001
From: Guillaume Fassot <97948781+prometek@users.noreply.github.com>
Date: Sun, 8 Sep 2024 22:36:53 +0200
Subject: [PATCH 033/504] =?UTF-8?q?=F0=9F=93=9D=20Remove=20duplicate=20lin?=
=?UTF-8?q?e=20in=20docs=20for=20`docs/en/docs/environment-variables.md`?=
=?UTF-8?q?=20(#12169)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/environment-variables.md | 2 --
1 file changed, 2 deletions(-)
diff --git a/docs/en/docs/environment-variables.md b/docs/en/docs/environment-variables.md
index 78e82d5af..43dd06add 100644
--- a/docs/en/docs/environment-variables.md
+++ b/docs/en/docs/environment-variables.md
@@ -243,8 +243,6 @@ This way, when you type `python` in the terminal, the system will find the Pytho
////
-This way, when you type `python` in the terminal, the system will find the Python program in `/opt/custompython/bin` (the last directory) and use that one.
-
So, if you type:
<div class="termy">
From c49c4e7df8eef1ab4ed5baacdf02df3a10aaaae1 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 8 Sep 2024 20:37:14 +0000
Subject: [PATCH 034/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e09eb57b6..6e84911e9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Docs
+
+* 📝 Remove duplicate line in docs for `docs/en/docs/environment-variables.md`. PR [#12169](https://github.com/fastapi/fastapi/pull/12169) by [@prometek](https://github.com/prometek).
+
### Translations
* 🌐 Add Korean translation for `docs/ko/docs/project-generation.md`. PR [#12157](https://github.com/fastapi/fastapi/pull/12157) by [@BORA040126](https://github.com/BORA040126).
From a67167dce3f3b33ef1789c0eeb7a2dcdf2cc4314 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
<66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 9 Sep 2024 20:35:50 +0200
Subject: [PATCH 035/504] =?UTF-8?q?=E2=AC=86=20[pre-commit.ci]=20pre-commi?=
=?UTF-8?q?t=20autoupdate=20(#12176)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
* ⬆ [pre-commit.ci] pre-commit autoupdate
updates:
- [github.com/astral-sh/ruff-pre-commit: v0.6.3 → v0.6.4](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.3...v0.6.4)
* bump ruff in tests requirements as well
---------
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: svlandeg <svlandeg@github.com>
---
.pre-commit-config.yaml | 2 +-
requirements-tests.txt | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 7e58afd4b..f74816f12 100644
--- a/.pre-commit-config.yaml
+++ b/.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.6.3
+ rev: v0.6.4
hooks:
- id: ruff
args:
diff --git a/requirements-tests.txt b/requirements-tests.txt
index de5fdb8a2..809a19c0c 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -3,7 +3,7 @@
pytest >=7.1.3,<8.0.0
coverage[toml] >= 6.5.0,< 8.0
mypy ==1.8.0
-ruff ==0.6.3
+ruff ==0.6.4
dirty-equals ==0.6.0
# TODO: once removing databases from tutorial, upgrade SQLAlchemy
# probably when including SQLModel
From da4670cf775ff7c2ef98b7157a71a91fe980816e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 9 Sep 2024 18:36:15 +0000
Subject: [PATCH 036/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6e84911e9..3af1a5ade 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -17,6 +17,7 @@ hide:
### Internal
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12176](https://github.com/fastapi/fastapi/pull/12176) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* 👷 Update `issue-manager.yml`. PR [#12159](https://github.com/fastapi/fastapi/pull/12159) by [@tiangolo](https://github.com/tiangolo).
* ✏️ Fix typo in `fastapi/params.py`. PR [#12143](https://github.com/fastapi/fastapi/pull/12143) by [@surreal30](https://github.com/surreal30).
From fc601bcb4b2dd97e3c7918c8f59f97a62df06abc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 10 Sep 2024 11:07:46 +0200
Subject: [PATCH 037/504] =?UTF-8?q?=E2=AC=86=20Bump=20tiangolo/issue-manag?=
=?UTF-8?q?er=20from=200.5.0=20to=200.5.1=20(#12173)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Bumps [tiangolo/issue-manager](https://github.com/tiangolo/issue-manager) from 0.5.0 to 0.5.1.
- [Release notes](https://github.com/tiangolo/issue-manager/releases)
- [Commits](https://github.com/tiangolo/issue-manager/compare/0.5.0...0.5.1)
---
updated-dependencies:
- dependency-name: tiangolo/issue-manager
dependency-type: direct:production
update-type: version-update:semver-patch
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
.github/workflows/issue-manager.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.github/workflows/issue-manager.yml b/.github/workflows/issue-manager.yml
index fbb856792..439084434 100644
--- a/.github/workflows/issue-manager.yml
+++ b/.github/workflows/issue-manager.yml
@@ -27,7 +27,7 @@ jobs:
env:
GITHUB_CONTEXT: ${{ toJson(github) }}
run: echo "$GITHUB_CONTEXT"
- - uses: tiangolo/issue-manager@0.5.0
+ - uses: tiangolo/issue-manager@0.5.1
with:
token: ${{ secrets.GITHUB_TOKEN }}
config: >
From bc715d55bc1ee3aedf4d429ca4e08ae39e0bbb90 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 10 Sep 2024 09:08:09 +0000
Subject: [PATCH 038/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3af1a5ade..b9eaed65d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -17,6 +17,7 @@ hide:
### Internal
+* ⬆ Bump tiangolo/issue-manager from 0.5.0 to 0.5.1. PR [#12173](https://github.com/fastapi/fastapi/pull/12173) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12176](https://github.com/fastapi/fastapi/pull/12176) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* 👷 Update `issue-manager.yml`. PR [#12159](https://github.com/fastapi/fastapi/pull/12159) by [@tiangolo](https://github.com/tiangolo).
* ✏️ Fix typo in `fastapi/params.py`. PR [#12143](https://github.com/fastapi/fastapi/pull/12143) by [@surreal30](https://github.com/surreal30).
From 80e2cd12747df2de38b4ab3ee1ee1cb889ee242b Mon Sep 17 00:00:00 2001
From: marcelomarkus <marcelomarkus@gmail.com>
Date: Tue, 10 Sep 2024 07:34:25 -0300
Subject: [PATCH 039/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/debugging.md`=20(#12165)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/tutorial/debugging.md | 115 +++++++++++++++++++++++++++++
1 file changed, 115 insertions(+)
create mode 100644 docs/pt/docs/tutorial/debugging.md
diff --git a/docs/pt/docs/tutorial/debugging.md b/docs/pt/docs/tutorial/debugging.md
new file mode 100644
index 000000000..54582fcbc
--- /dev/null
+++ b/docs/pt/docs/tutorial/debugging.md
@@ -0,0 +1,115 @@
+# Depuração
+
+Você pode conectar o depurador no seu editor, por exemplo, com o Visual Studio Code ou PyCharm.
+
+## Chamar `uvicorn`
+
+Em seu aplicativo FastAPI, importe e execute `uvicorn` diretamente:
+
+```Python hl_lines="1 15"
+{!../../../docs_src/debugging/tutorial001.py!}
+```
+
+### Sobre `__name__ == "__main__"`
+
+O objetivo principal de `__name__ == "__main__"` é ter algum código que seja executado quando seu arquivo for chamado com:
+
+<div class="termy">
+
+```console
+$ python myapp.py
+```
+
+</div>
+
+mas não é chamado quando outro arquivo o importa, como em:
+
+```Python
+from myapp import app
+```
+
+#### Mais detalhes
+
+Digamos que seu arquivo se chama `myapp.py`.
+
+Se você executá-lo com:
+
+<div class="termy">
+
+```console
+$ python myapp.py
+```
+
+</div>
+
+então a variável interna `__name__` no seu arquivo, criada automaticamente pelo Python, terá como valor a string `"__main__"`.
+
+Então, a seção:
+
+```Python
+ uvicorn.run(app, host="0.0.0.0", port=8000)
+```
+
+vai executar.
+
+---
+
+Isso não acontecerá se você importar esse módulo (arquivo).
+
+Então, se você tiver outro arquivo `importer.py` com:
+
+```Python
+from myapp import app
+
+# Mais um pouco de código
+```
+
+nesse caso, a variável criada automaticamente dentro de `myapp.py` não terá a variável `__name__` com o valor `"__main__"`.
+
+Então, a linha:
+
+```Python
+ uvicorn.run(app, host="0.0.0.0", port=8000)
+```
+
+não será executada.
+
+/// info | "Informação"
+
+Para mais informações, consulte <a href="https://docs.python.org/3/library/__main__.html" class="external-link" target="_blank">a documentação oficial do Python</a>.
+
+///
+
+## Execute seu código com seu depurador
+
+Como você está executando o servidor Uvicorn diretamente do seu código, você pode chamar seu programa Python (seu aplicativo FastAPI) diretamente do depurador.
+
+---
+
+Por exemplo, no Visual Studio Code, você pode:
+
+* Ir para o painel "Debug".
+* "Add configuration...".
+* Selecionar "Python"
+* Executar o depurador com a opção "`Python: Current File (Integrated Terminal)`".
+
+Em seguida, ele iniciará o servidor com seu código **FastAPI**, parará em seus pontos de interrupção, etc.
+
+Veja como pode parecer:
+
+<img src="/img/tutorial/debugging/image01.png">
+
+---
+
+Se você usar o Pycharm, você pode:
+
+* Abrir o menu "Executar".
+* Selecionar a opção "Depurar...".
+* Então um menu de contexto aparece.
+* Selecionar o arquivo para depurar (neste caso, `main.py`).
+
+Em seguida, ele iniciará o servidor com seu código **FastAPI**, parará em seus pontos de interrupção, etc.
+
+Veja como pode parecer:
+
+<img src="/img/tutorial/debugging/image02.png">
From 73d4f347df83c8e59ab55c9dfdbd974351e6efc5 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 10 Sep 2024 10:34:46 +0000
Subject: [PATCH 040/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b9eaed65d..7492242a4 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/debugging.md`. PR [#12165](https://github.com/fastapi/fastapi/pull/12165) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Korean translation for `docs/ko/docs/project-generation.md`. PR [#12157](https://github.com/fastapi/fastapi/pull/12157) by [@BORA040126](https://github.com/BORA040126).
### Internal
From a4a7925045e42030528c6f1fdeaa059e811455c0 Mon Sep 17 00:00:00 2001
From: marcelomarkus <marcelomarkus@gmail.com>
Date: Tue, 10 Sep 2024 07:35:14 -0300
Subject: [PATCH 041/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/testing.md`=20(#12164)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/tutorial/testing.md | 249 +++++++++++++++++++++++++++++++
1 file changed, 249 insertions(+)
create mode 100644 docs/pt/docs/tutorial/testing.md
diff --git a/docs/pt/docs/tutorial/testing.md b/docs/pt/docs/tutorial/testing.md
new file mode 100644
index 000000000..f734a7d9a
--- /dev/null
+++ b/docs/pt/docs/tutorial/testing.md
@@ -0,0 +1,249 @@
+# Testando
+
+Graças ao <a href="https://www.starlette.io/testclient/" class="external-link" target="_blank">Starlette</a>, testar aplicativos **FastAPI** é fácil e agradável.
+
+Ele é baseado no <a href="https://www.python-httpx.org" class="external-link" target="_blank">HTTPX</a>, que por sua vez é projetado com base em Requests, por isso é muito familiar e intuitivo.
+
+Com ele, você pode usar o <a href="https://docs.pytest.org/" class="external-link" target="_blank">pytest</a> diretamente com **FastAPI**.
+
+## Usando `TestClient`
+
+/// info | "Informação"
+
+Para usar o `TestClient`, primeiro instale o <a href="https://www.python-httpx.org" class="external-link" target="_blank">`httpx`</a>.
+
+Certifique-se de criar um [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, ativá-lo e instalá-lo, por exemplo:
+
+```console
+$ pip install httpx
+```
+
+///
+
+Importe `TestClient`.
+
+Crie um `TestClient` passando seu aplicativo **FastAPI** para ele.
+
+Crie funções com um nome que comece com `test_` (essa é a convenção padrão do `pytest`).
+
+Use o objeto `TestClient` da mesma forma que você faz com `httpx`.
+
+Escreva instruções `assert` simples com as expressões Python padrão que você precisa verificar (novamente, `pytest` padrão).
+
+```Python hl_lines="2 12 15-18"
+{!../../../docs_src/app_testing/tutorial001.py!}
+```
+
+/// tip | "Dica"
+
+Observe que as funções de teste são `def` normais, não `async def`.
+
+E as chamadas para o cliente também são chamadas normais, não usando `await`.
+
+Isso permite que você use `pytest` diretamente sem complicações.
+
+///
+
+/// note | "Detalhes técnicos"
+
+Você também pode usar `from starlette.testclient import TestClient`.
+
+**FastAPI** fornece o mesmo `starlette.testclient` que `fastapi.testclient` apenas como uma conveniência para você, o desenvolvedor. Mas ele vem diretamente da Starlette.
+
+///
+
+/// tip | "Dica"
+
+Se você quiser chamar funções `async` em seus testes além de enviar solicitações ao seu aplicativo FastAPI (por exemplo, funções de banco de dados assíncronas), dê uma olhada em [Testes assíncronos](../advanced/async-tests.md){.internal-link target=_blank} no tutorial avançado.
+
+///
+
+## Separando testes
+
+Em uma aplicação real, você provavelmente teria seus testes em um arquivo diferente.
+
+E seu aplicativo **FastAPI** também pode ser composto de vários arquivos/módulos, etc.
+
+### Arquivo do aplicativo **FastAPI**
+
+Digamos que você tenha uma estrutura de arquivo conforme descrito em [Aplicativos maiores](bigger-applications.md){.internal-link target=_blank}:
+
+```
+.
+├── app
+│ ├── __init__.py
+│ └── main.py
+```
+
+No arquivo `main.py` você tem seu aplicativo **FastAPI**:
+
+
+```Python
+{!../../../docs_src/app_testing/main.py!}
+```
+
+### Arquivo de teste
+
+Então você poderia ter um arquivo `test_main.py` com seus testes. Ele poderia estar no mesmo pacote Python (o mesmo diretório com um arquivo `__init__.py`):
+
+``` hl_lines="5"
+.
+├── app
+│ ├── __init__.py
+│ ├── main.py
+│ └── test_main.py
+```
+
+Como esse arquivo está no mesmo pacote, você pode usar importações relativas para importar o objeto `app` do módulo `main` (`main.py`):
+
+```Python hl_lines="3"
+{!../../../docs_src/app_testing/test_main.py!}
+```
+
+...e ter o código para os testes como antes.
+
+## Testando: exemplo estendido
+
+Agora vamos estender este exemplo e adicionar mais detalhes para ver como testar diferentes partes.
+
+### Arquivo de aplicativo **FastAPI** estendido
+
+Vamos continuar com a mesma estrutura de arquivo de antes:
+
+```
+.
+├── app
+│ ├── __init__.py
+│ ├── main.py
+│ └── test_main.py
+```
+
+Digamos que agora o arquivo `main.py` com seu aplicativo **FastAPI** tenha algumas outras **operações de rotas**.
+
+Ele tem uma operação `GET` que pode retornar um erro.
+
+Ele tem uma operação `POST` que pode retornar vários erros.
+
+Ambas as *operações de rotas* requerem um cabeçalho `X-Token`.
+
+//// tab | Python 3.10+
+
+```Python
+{!> ../../../docs_src/app_testing/app_b_an_py310/main.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!> ../../../docs_src/app_testing/app_b_an_py39/main.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python
+{!> ../../../docs_src/app_testing/app_b_an/main.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | "Dica"
+
+Prefira usar a versão `Annotated` se possível.
+
+///
+
+```Python
+{!> ../../../docs_src/app_testing/app_b_py310/main.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | "Dica"
+
+Prefira usar a versão `Annotated` se possível.
+
+///
+
+```Python
+{!> ../../../docs_src/app_testing/app_b/main.py!}
+```
+
+////
+
+### Arquivo de teste estendido
+
+Você pode então atualizar `test_main.py` com os testes estendidos:
+
+```Python
+{!> ../../../docs_src/app_testing/app_b/test_main.py!}
+```
+
+Sempre que você precisar que o cliente passe informações na requisição e não souber como, você pode pesquisar (no Google) como fazer isso no `httpx`, ou até mesmo como fazer isso com `requests`, já que o design do HTTPX é baseado no design do Requests.
+
+Depois é só fazer o mesmo nos seus testes.
+
+Por exemplo:
+
+* Para passar um parâmetro *path* ou *query*, adicione-o à própria URL.
+* Para passar um corpo JSON, passe um objeto Python (por exemplo, um `dict`) para o parâmetro `json`.
+* Se você precisar enviar *Dados de Formulário* em vez de JSON, use o parâmetro `data`.
+* Para passar *headers*, use um `dict` no parâmetro `headers`.
+* Para *cookies*, um `dict` no parâmetro `cookies`.
+
+Para mais informações sobre como passar dados para o backend (usando `httpx` ou `TestClient`), consulte a <a href="https://www.python-httpx.org" class="external-link" target="_blank">documentação do HTTPX</a>.
+
+/// info | "Informação"
+
+Observe que o `TestClient` recebe dados que podem ser convertidos para JSON, não para modelos Pydantic.
+
+Se você tiver um modelo Pydantic em seu teste e quiser enviar seus dados para o aplicativo durante o teste, poderá usar o `jsonable_encoder` descrito em [Codificador compatível com JSON](encoder.md){.internal-link target=_blank}.
+
+///
+
+## Execute-o
+
+Depois disso, você só precisa instalar o `pytest`.
+
+Certifique-se de criar um [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, ativá-lo e instalá-lo, por exemplo:
+
+<div class="termy">
+
+```console
+$ pip install pytest
+
+---> 100%
+```
+
+</div>
+
+Ele detectará os arquivos e os testes automaticamente, os executará e informará os resultados para você.
+
+Execute os testes com:
+
+<div class="termy">
+
+```console
+$ pytest
+
+================ test session starts ================
+platform linux -- Python 3.6.9, pytest-5.3.5, py-1.8.1, pluggy-0.13.1
+rootdir: /home/user/code/superawesome-cli/app
+plugins: forked-1.1.3, xdist-1.31.0, cov-2.8.1
+collected 6 items
+
+---> 100%
+
+test_main.py <span style="color: green; white-space: pre;">...... [100%]</span>
+
+<span style="color: green;">================= 1 passed in 0.03s =================</span>
+```
+
+</div>
From e69ba263861b440fce06b55bedf83bd08646452b Mon Sep 17 00:00:00 2001
From: marcelomarkus <marcelomarkus@gmail.com>
Date: Tue, 10 Sep 2024 07:36:42 -0300
Subject: [PATCH 042/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/environment-variables.md`=20(#1216?=
=?UTF-8?q?2)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/environment-variables.md | 298 ++++++++++++++++++++++++++
1 file changed, 298 insertions(+)
create mode 100644 docs/pt/docs/environment-variables.md
diff --git a/docs/pt/docs/environment-variables.md b/docs/pt/docs/environment-variables.md
new file mode 100644
index 000000000..360d1c496
--- /dev/null
+++ b/docs/pt/docs/environment-variables.md
@@ -0,0 +1,298 @@
+# Variáveis de Ambiente
+
+/// tip | "Dica"
+
+Se você já sabe o que são "variáveis de ambiente" e como usá-las, pode pular esta seção.
+
+///
+
+Uma variável de ambiente (também conhecida como "**env var**") é uma variável que existe **fora** do código Python, no **sistema operacional**, e pode ser lida pelo seu código Python (ou por outros programas também).
+
+Variáveis de ambiente podem ser úteis para lidar com **configurações** do aplicativo, como parte da **instalação** do Python, etc.
+
+## Criar e Usar Variáveis de Ambiente
+
+Você pode **criar** e usar variáveis de ambiente no **shell (terminal)**, sem precisar do Python:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// Você pode criar uma variável de ambiente MY_NAME com
+$ export MY_NAME="Wade Wilson"
+
+// Então você pode usá-la com outros programas, como
+$ echo "Hello $MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// Criar uma variável de ambiente MY_NAME
+$ $Env:MY_NAME = "Wade Wilson"
+
+// Usá-la com outros programas, como
+$ echo "Hello $Env:MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+## Ler Variáveis de Ambiente no Python
+
+Você também pode criar variáveis de ambiente **fora** do Python, no terminal (ou com qualquer outro método) e depois **lê-las no Python**.
+
+Por exemplo, você poderia ter um arquivo `main.py` com:
+
+```Python hl_lines="3"
+import os
+
+name = os.getenv("MY_NAME", "World")
+print(f"Hello {name} from Python")
+```
+
+/// tip | "Dica"
+
+O segundo argumento para <a href="https://docs.python.org/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> é o valor padrão a ser retornado.
+
+Se não for fornecido, é `None` por padrão, Aqui fornecemos `"World"` como o valor padrão a ser usado.
+
+///
+
+Então você poderia chamar esse programa Python:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// Aqui ainda não definimos a variável de ambiente
+$ python main.py
+
+// Como não definimos a variável de ambiente, obtemos o valor padrão
+
+Hello World from Python
+
+// Mas se criarmos uma variável de ambiente primeiro
+$ export MY_NAME="Wade Wilson"
+
+// E então chamar o programa novamente
+$ python main.py
+
+// Agora ele pode ler a variável de ambiente
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// Aqui ainda não definimos a variável de ambiente
+$ python main.py
+
+// Como não definimos a variável de ambiente, obtemos o valor padrão
+
+Hello World from Python
+
+// Mas se criarmos uma variável de ambiente primeiro
+$ $Env:MY_NAME = "Wade Wilson"
+
+// E então chamar o programa novamente
+$ python main.py
+
+// Agora ele pode ler a variável de ambiente
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+Como as variáveis de ambiente podem ser definidas fora do código, mas podem ser lidas pelo código e não precisam ser armazenadas (com versão no `git`) com o restante dos arquivos, é comum usá-las para configurações ou **definições**.
+
+Você também pode criar uma variável de ambiente apenas para uma **invocação específica do programa**, que só está disponível para aquele programa e apenas pela duração dele.
+
+Para fazer isso, crie-a na mesma linha, antes do próprio programa:
+
+<div class="termy">
+
+```console
+// Criar uma variável de ambiente MY_NAME para esta chamada de programa
+$ MY_NAME="Wade Wilson" python main.py
+
+// Agora ele pode ler a variável de ambiente
+
+Hello Wade Wilson from Python
+
+// A variável de ambiente não existe mais depois
+$ python main.py
+
+Hello World from Python
+```
+
+</div>
+
+/// tip | "Dica"
+
+Você pode ler mais sobre isso em <a href="https://12factor.net/config" class="external-link" target="_blank">The Twelve-Factor App: Config</a>.
+
+///
+
+## Tipos e Validação
+
+Essas variáveis de ambiente só podem lidar com **strings de texto**, pois são externas ao Python e precisam ser compatíveis com outros programas e com o resto do sistema (e até mesmo com diferentes sistemas operacionais, como Linux, Windows, macOS).
+
+Isso significa que **qualquer valor** lido em Python de uma variável de ambiente **será uma `str`**, e qualquer conversão para um tipo diferente ou qualquer validação precisa ser feita no código.
+
+Você aprenderá mais sobre como usar variáveis de ambiente para lidar com **configurações do aplicativo** no [Guia do Usuário Avançado - Configurações e Variáveis de Ambiente](./advanced/settings.md){.internal-link target=_blank}.
+
+## Variável de Ambiente `PATH`
+
+Existe uma variável de ambiente **especial** chamada **`PATH`** que é usada pelos sistemas operacionais (Linux, macOS, Windows) para encontrar programas para executar.
+
+O valor da variável `PATH` é uma longa string composta por diretórios separados por dois pontos `:` no Linux e macOS, e por ponto e vírgula `;` no Windows.
+
+Por exemplo, a variável de ambiente `PATH` poderia ter esta aparência:
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+Isso significa que o sistema deve procurar programas nos diretórios:
+
+* `/usr/local/bin`
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32
+```
+
+Isso significa que o sistema deve procurar programas nos diretórios:
+
+* `C:\Program Files\Python312\Scripts`
+* `C:\Program Files\Python312`
+* `C:\Windows\System32`
+
+////
+
+Quando você digita um **comando** no terminal, o sistema operacional **procura** o programa em **cada um dos diretórios** listados na variável de ambiente `PATH`.
+
+Por exemplo, quando você digita `python` no terminal, o sistema operacional procura um programa chamado `python` no **primeiro diretório** dessa lista.
+
+Se ele o encontrar, então ele o **usará**. Caso contrário, ele continua procurando nos **outros diretórios**.
+
+### Instalando o Python e Atualizando o `PATH`
+
+Durante a instalação do Python, você pode ser questionado sobre a atualização da variável de ambiente `PATH`.
+
+//// tab | Linux, macOS
+
+Vamos supor que você instale o Python e ele fique em um diretório `/opt/custompython/bin`.
+
+Se você concordar em atualizar a variável de ambiente `PATH`, o instalador adicionará `/opt/custompython/bin` para a variável de ambiente `PATH`.
+
+Poderia parecer assim:
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin
+```
+
+Dessa forma, ao digitar `python` no terminal, o sistema encontrará o programa Python em `/opt/custompython/bin` (último diretório) e o utilizará.
+
+////
+
+//// tab | Windows
+
+Digamos que você instala o Python e ele acaba em um diretório `C:\opt\custompython\bin`.
+
+Se você disser sim para atualizar a variável de ambiente `PATH`, o instalador adicionará `C:\opt\custompython\bin` à variável de ambiente `PATH`.
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin
+```
+
+Dessa forma, quando você digitar `python` no terminal, o sistema encontrará o programa Python em `C:\opt\custompython\bin` (o último diretório) e o utilizará.
+
+////
+
+Então, se você digitar:
+
+<div class="termy">
+
+```console
+$ python
+```
+
+</div>
+
+//// tab | Linux, macOS
+
+O sistema **encontrará** o programa `python` em `/opt/custompython/bin` e o executará.
+
+Seria aproximadamente equivalente a digitar:
+
+<div class="termy">
+
+```console
+$ /opt/custompython/bin/python
+```
+
+</div>
+
+////
+
+//// tab | Windows
+
+O sistema **encontrará** o programa `python` em `C:\opt\custompython\bin\python` e o executará.
+
+Seria aproximadamente equivalente a digitar:
+
+<div class="termy">
+
+```console
+$ C:\opt\custompython\bin\python
+```
+
+</div>
+
+////
+
+Essas informações serão úteis ao aprender sobre [Ambientes Virtuais](virtual-environments.md){.internal-link target=_blank}.
+
+## Conclusão
+
+Com isso, você deve ter uma compreensão básica do que são **variáveis de ambiente** e como usá-las em Python.
+
+Você também pode ler mais sobre elas na <a href="https://en.wikipedia.org/wiki/Environment_variable" class="external-link" target="_blank">Wikipedia para Variáveis de Ambiente</a>.
+
+Em muitos casos, não é muito óbvio como as variáveis de ambiente seriam úteis e aplicáveis imediatamente. Mas elas continuam aparecendo em muitos cenários diferentes quando você está desenvolvendo, então é bom saber sobre elas.
+
+Por exemplo, você precisará dessas informações na próxima seção, sobre [Ambientes Virtuais](virtual-environments.md).
From 944b6e507e326f986061e99936c80aa565da669f Mon Sep 17 00:00:00 2001
From: marcelomarkus <marcelomarkus@gmail.com>
Date: Tue, 10 Sep 2024 07:37:13 -0300
Subject: [PATCH 043/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/virtual-environments.md`=20(#12163?=
=?UTF-8?q?)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/virtual-environments.md | 844 +++++++++++++++++++++++++++
1 file changed, 844 insertions(+)
create mode 100644 docs/pt/docs/virtual-environments.md
diff --git a/docs/pt/docs/virtual-environments.md b/docs/pt/docs/virtual-environments.md
new file mode 100644
index 000000000..863c8d65e
--- /dev/null
+++ b/docs/pt/docs/virtual-environments.md
@@ -0,0 +1,844 @@
+# Ambientes Virtuais
+
+Ao trabalhar em projetos Python, você provavelmente deve usar um **ambiente virtual** (ou um mecanismo similar) para isolar os pacotes que você instala para cada projeto.
+
+/// info | "Informação"
+
+Se você já sabe sobre ambientes virtuais, como criá-los e usá-los, talvez seja melhor pular esta seção. 🤓
+
+///
+
+/// tip | "Dica"
+
+Um **ambiente virtual** é diferente de uma **variável de ambiente**.
+
+Uma **variável de ambiente** é uma variável no sistema que pode ser usada por programas.
+
+Um **ambiente virtual** é um diretório com alguns arquivos.
+
+///
+
+/// info | "Informação"
+
+Esta página lhe ensinará como usar **ambientes virtuais** e como eles funcionam.
+
+Se você estiver pronto para adotar uma **ferramenta que gerencia tudo** para você (incluindo a instalação do Python), experimente <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">uv</a>.
+
+///
+
+## Criar um Projeto
+
+Primeiro, crie um diretório para seu projeto.
+
+O que normalmente faço é criar um diretório chamado `code` dentro do meu diretório home/user.
+
+E dentro disso eu crio um diretório por projeto.
+
+<div class="termy">
+
+```console
+// Vá para o diretório inicial
+$ cd
+// Crie um diretório para todos os seus projetos de código
+$ mkdir code
+// Entre nesse diretório de código
+$ cd code
+// Crie um diretório para este projeto
+$ mkdir awesome-project
+// Entre no diretório do projeto
+$ cd awesome-project
+```
+
+</div>
+
+## Crie um ambiente virtual
+
+Ao começar a trabalhar em um projeto Python **pela primeira vez**, crie um ambiente virtual **<abbr title="existem outras opções, esta é uma diretriz simples">dentro do seu projeto</abbr>**.
+
+/// tip | "Dica"
+
+Você só precisa fazer isso **uma vez por projeto**, não toda vez que trabalhar.
+
+///
+
+//// tab | `venv`
+
+Para criar um ambiente virtual, você pode usar o módulo `venv` que vem com o Python.
+
+<div class="termy">
+
+```console
+$ python -m venv .venv
+```
+
+</div>
+
+/// details | O que esse comando significa
+
+* `python`: usa o programa chamado `python`
+* `-m`: chama um módulo como um script, nós diremos a ele qual módulo vem em seguida
+* `venv`: usa o módulo chamado `venv` que normalmente vem instalado com o Python
+* `.venv`: cria o ambiente virtual no novo diretório `.venv`
+
+///
+
+////
+
+//// tab | `uv`
+
+Se você tiver o <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a> instalado, poderá usá-lo para criar um ambiente virtual.
+
+<div class="termy">
+
+```console
+$ uv venv
+```
+
+</div>
+
+/// tip | "Dica"
+
+Por padrão, `uv` criará um ambiente virtual em um diretório chamado `.venv`.
+
+Mas você pode personalizá-lo passando um argumento adicional com o nome do diretório.
+
+///
+
+////
+
+Esse comando cria um novo ambiente virtual em um diretório chamado `.venv`.
+
+/// details | `.venv` ou outro nome
+
+Você pode criar o ambiente virtual em um diretório diferente, mas há uma convenção para chamá-lo de `.venv`.
+
+///
+
+## Ative o ambiente virtual
+
+Ative o novo ambiente virtual para que qualquer comando Python que você executar ou pacote que você instalar o utilize.
+
+/// tip | "Dica"
+
+Faça isso **toda vez** que iniciar uma **nova sessão de terminal** para trabalhar no projeto.
+
+///
+
+//// tab | Linux, macOS
+
+<div class="termy">
+
+```console
+$ source .venv/bin/activate
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ .venv\Scripts\Activate.ps1
+```
+
+</div>
+
+////
+
+//// tab | Windows Bash
+
+Ou se você usa o Bash para Windows (por exemplo, <a href="https://gitforwindows.org/" class="external-link" target="_blank">Git Bash</a>):
+
+<div class="termy">
+
+```console
+$ source .venv/Scripts/activate
+```
+
+</div>
+
+////
+
+/// tip | "Dica"
+
+Toda vez que você instalar um **novo pacote** naquele ambiente, **ative** o ambiente novamente.
+
+Isso garante que, se você usar um **programa de terminal (<abbr title="interface de linha de comando">CLI</abbr>)** instalado por esse pacote, você usará aquele do seu ambiente virtual e não qualquer outro que possa ser instalado globalmente, provavelmente com uma versão diferente do que você precisa.
+
+///
+
+## Verifique se o ambiente virtual está ativo
+
+Verifique se o ambiente virtual está ativo (o comando anterior funcionou).
+
+/// tip | "Dica"
+
+Isso é **opcional**, mas é uma boa maneira de **verificar** se tudo está funcionando conforme o esperado e se você está usando o ambiente virtual pretendido.
+
+///
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+$ which python
+
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+</div>
+
+Se ele mostrar o binário `python` em `.venv/bin/python`, dentro do seu projeto (neste caso `awesome-project`), então funcionou. 🎉
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ Get-Command python
+
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+</div>
+
+Se ele mostrar o binário `python` em `.venv\Scripts\python`, dentro do seu projeto (neste caso `awesome-project`), então funcionou. 🎉
+
+////
+
+## Atualizar `pip`
+
+/// tip | "Dica"
+
+Se você usar <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>, você o usará para instalar coisas em vez do `pip`, então não precisará atualizar o `pip`. 😎
+
+///
+
+Se você estiver usando `pip` para instalar pacotes (ele vem por padrão com o Python), você deve **atualizá-lo** para a versão mais recente.
+
+Muitos erros exóticos durante a instalação de um pacote são resolvidos apenas atualizando o `pip` primeiro.
+
+/// tip | "Dica"
+
+Normalmente, você faria isso **uma vez**, logo após criar o ambiente virtual.
+
+///
+
+Certifique-se de que o ambiente virtual esteja ativo (com o comando acima) e execute:
+
+<div class="termy">
+
+```console
+$ python -m pip install --upgrade pip
+
+---> 100%
+```
+
+</div>
+
+## Adicionar `.gitignore`
+
+Se você estiver usando **Git** (você deveria), adicione um arquivo `.gitignore` para excluir tudo em seu `.venv` do Git.
+
+/// tip | "Dica"
+
+Se você usou <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a> para criar o ambiente virtual, ele já fez isso para você, você pode pular esta etapa. 😎
+
+///
+
+/// tip | "Dica"
+
+Faça isso **uma vez**, logo após criar o ambiente virtual.
+
+///
+
+<div class="termy">
+
+```console
+$ echo "*" > .venv/.gitignore
+```
+
+</div>
+
+/// details | O que esse comando significa
+
+* `echo "*"`: irá "imprimir" o texto `*` no terminal (a próxima parte muda isso um pouco)
+* `>`: qualquer coisa impressa no terminal pelo comando à esquerda de `>` não deve ser impressa, mas sim escrita no arquivo que vai à direita de `>`
+* `.gitignore`: o nome do arquivo onde o texto deve ser escrito
+
+E `*` para Git significa "tudo". Então, ele ignorará tudo no diretório `.venv`.
+
+Esse comando criará um arquivo `.gitignore` com o conteúdo:
+
+```gitignore
+*
+```
+
+///
+
+## Instalar Pacotes
+
+Após ativar o ambiente, você pode instalar pacotes nele.
+
+/// tip | "Dica"
+
+Faça isso **uma vez** ao instalar ou atualizar os pacotes que seu projeto precisa.
+
+Se precisar atualizar uma versão ou adicionar um novo pacote, você **fará isso novamente**.
+
+///
+
+### Instalar pacotes diretamente
+
+Se estiver com pressa e não quiser usar um arquivo para declarar os requisitos de pacote do seu projeto, você pode instalá-los diretamente.
+
+/// tip | "Dica"
+
+É uma (muito) boa ideia colocar os pacotes e versões que seu programa precisa em um arquivo (por exemplo `requirements.txt` ou `pyproject.toml`).
+
+///
+
+//// tab | `pip`
+
+<div class="termy">
+
+```console
+$ pip install "fastapi[standard]"
+
+---> 100%
+```
+
+</div>
+
+////
+
+//// tab | `uv`
+
+Se você tem o <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>:
+
+<div class="termy">
+
+```console
+$ uv pip install "fastapi[standard]"
+---> 100%
+```
+
+</div>
+
+////
+
+### Instalar a partir de `requirements.txt`
+
+Se você tiver um `requirements.txt`, agora poderá usá-lo para instalar seus pacotes.
+
+//// tab | `pip`
+
+<div class="termy">
+
+```console
+$ pip install -r requirements.txt
+---> 100%
+```
+
+</div>
+
+////
+
+//// tab | `uv`
+
+Se você tem o <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>:
+
+<div class="termy">
+
+```console
+$ uv pip install -r requirements.txt
+---> 100%
+```
+
+</div>
+
+////
+
+/// details | `requirements.txt`
+
+Um `requirements.txt` com alguns pacotes poderia se parecer com:
+
+```requirements.txt
+fastapi[standard]==0.113.0
+pydantic==2.8.0
+```
+
+///
+
+## Execute seu programa
+
+Depois de ativar o ambiente virtual, você pode executar seu programa, e ele usará o Python dentro do seu ambiente virtual com os pacotes que você instalou lá.
+
+<div class="termy">
+
+```console
+$ python main.py
+
+Hello World
+```
+
+</div>
+
+## Configure seu editor
+
+Você provavelmente usaria um editor. Certifique-se de configurá-lo para usar o mesmo ambiente virtual que você criou (ele provavelmente o detectará automaticamente) para que você possa obter erros de preenchimento automático e em linha.
+
+Por exemplo:
+
+* <a href="https://code.visualstudio.com/docs/python/environments#_select-and-activate-an-environment" class="external-link" target="_blank">VS Code</a>
+* <a href="https://www.jetbrains.com/help/pycharm/creating-virtual-environment.html" class="external-link" target="_blank">PyCharm</a>
+
+/// tip | "Dica"
+
+Normalmente, você só precisa fazer isso **uma vez**, ao criar o ambiente virtual.
+
+///
+
+## Desativar o ambiente virtual
+
+Quando terminar de trabalhar no seu projeto, você pode **desativar** o ambiente virtual.
+
+<div class="termy">
+
+```console
+$ deactivate
+```
+
+</div>
+
+Dessa forma, quando você executar `python`, ele não tentará executá-lo naquele ambiente virtual com os pacotes instalados nele.
+
+## Pronto para trabalhar
+
+Agora você está pronto para começar a trabalhar no seu projeto.
+
+
+
+/// tip | "Dica"
+
+Você quer entender o que é tudo isso acima?
+
+Continue lendo. 👇🤓
+
+///
+
+## Por que ambientes virtuais
+
+Para trabalhar com o FastAPI, você precisa instalar o <a href="https://www.python.org/" class="external-link" target="_blank">Python</a>.
+
+Depois disso, você precisará **instalar** o FastAPI e quaisquer outros **pacotes** que queira usar.
+
+Para instalar pacotes, você normalmente usaria o comando `pip` que vem com o Python (ou alternativas semelhantes).
+
+No entanto, se você usar `pip` diretamente, os pacotes serão instalados no seu **ambiente Python global** (a instalação global do Python).
+
+### O Problema
+
+Então, qual é o problema em instalar pacotes no ambiente global do Python?
+
+Em algum momento, você provavelmente acabará escrevendo muitos programas diferentes que dependem de **pacotes diferentes**. E alguns desses projetos em que você trabalha dependerão de **versões diferentes** do mesmo pacote. 😱
+
+Por exemplo, você pode criar um projeto chamado `philosophers-stone`, este programa depende de outro pacote chamado **`harry`, usando a versão `1`**. Então, você precisa instalar `harry`.
+
+```mermaid
+flowchart LR
+ stone(philosophers-stone) -->|requires| harry-1[harry v1]
+```
+
+Então, em algum momento depois, você cria outro projeto chamado `prisoner-of-azkaban`, e esse projeto também depende de `harry`, mas esse projeto precisa do **`harry` versão `3`**.
+
+```mermaid
+flowchart LR
+ azkaban(prisoner-of-azkaban) --> |requires| harry-3[harry v3]
+```
+
+Mas agora o problema é que, se você instalar os pacotes globalmente (no ambiente global) em vez de em um **ambiente virtual** local, você terá que escolher qual versão do `harry` instalar.
+
+Se você quiser executar `philosophers-stone`, precisará primeiro instalar `harry` versão `1`, por exemplo com:
+
+<div class="termy">
+
+```console
+$ pip install "harry==1"
+```
+
+</div>
+
+E então você acabaria com `harry` versão `1` instalado em seu ambiente Python global.
+
+```mermaid
+flowchart LR
+ subgraph global[global env]
+ harry-1[harry v1]
+ end
+ subgraph stone-project[philosophers-stone project]
+ stone(philosophers-stone) -->|requires| harry-1
+ end
+```
+
+Mas se você quiser executar `prisoner-of-azkaban`, você precisará desinstalar `harry` versão `1` e instalar `harry` versão `3` (ou apenas instalar a versão `3` desinstalaria automaticamente a versão `1`).
+
+<div class="termy">
+
+```console
+$ pip install "harry==3"
+```
+
+</div>
+
+E então você acabaria com `harry` versão `3` instalado em seu ambiente Python global.
+
+E se você tentar executar `philosophers-stone` novamente, há uma chance de que **não funcione** porque ele precisa de `harry` versão `1`.
+
+```mermaid
+flowchart LR
+ subgraph global[global env]
+ harry-1[<strike>harry v1</strike>]
+ style harry-1 fill:#ccc,stroke-dasharray: 5 5
+ harry-3[harry v3]
+ end
+ subgraph stone-project[philosophers-stone project]
+ stone(philosophers-stone) -.-x|⛔️| harry-1
+ end
+ subgraph azkaban-project[prisoner-of-azkaban project]
+ azkaban(prisoner-of-azkaban) --> |requires| harry-3
+ end
+```
+
+/// tip | "Dica"
+
+É muito comum em pacotes Python tentar ao máximo **evitar alterações drásticas** em **novas versões**, mas é melhor prevenir do que remediar e instalar versões mais recentes intencionalmente e, quando possível, executar os testes para verificar se tudo está funcionando corretamente.
+
+///
+
+Agora, imagine isso com **muitos** outros **pacotes** dos quais todos os seus **projetos dependem**. Isso é muito difícil de gerenciar. E você provavelmente acabaria executando alguns projetos com algumas **versões incompatíveis** dos pacotes, e não saberia por que algo não está funcionando.
+
+Além disso, dependendo do seu sistema operacional (por exemplo, Linux, Windows, macOS), ele pode ter vindo com o Python já instalado. E, nesse caso, provavelmente tinha alguns pacotes pré-instalados com algumas versões específicas **necessárias para o seu sistema**. Se você instalar pacotes no ambiente global do Python, poderá acabar **quebrando** alguns dos programas que vieram com seu sistema operacional.
+
+## Onde os pacotes são instalados
+
+Quando você instala o Python, ele cria alguns diretórios com alguns arquivos no seu computador.
+
+Alguns desses diretórios são os responsáveis por ter todos os pacotes que você instala.
+
+Quando você executa:
+
+<div class="termy">
+
+```console
+// Não execute isso agora, é apenas um exemplo 🤓
+$ pip install "fastapi[standard]"
+---> 100%
+```
+
+</div>
+
+Isso fará o download de um arquivo compactado com o código FastAPI, normalmente do <a href="https://pypi.org/project/fastapi/" class="external-link" target="_blank">PyPI</a>.
+
+Ele também fará o **download** de arquivos para outros pacotes dos quais o FastAPI depende.
+
+Em seguida, ele **extrairá** todos esses arquivos e os colocará em um diretório no seu computador.
+
+Por padrão, ele colocará os arquivos baixados e extraídos no diretório que vem com a instalação do Python, que é o **ambiente global**.
+
+## O que são ambientes virtuais
+
+A solução para os problemas de ter todos os pacotes no ambiente global é usar um **ambiente virtual para cada projeto** em que você trabalha.
+
+Um ambiente virtual é um **diretório**, muito semelhante ao global, onde você pode instalar os pacotes para um projeto.
+
+Dessa forma, cada projeto terá seu próprio ambiente virtual (diretório `.venv`) com seus próprios pacotes.
+
+```mermaid
+flowchart TB
+ subgraph stone-project[philosophers-stone project]
+ stone(philosophers-stone) --->|requires| harry-1
+ subgraph venv1[.venv]
+ harry-1[harry v1]
+ end
+ end
+ subgraph azkaban-project[prisoner-of-azkaban project]
+ azkaban(prisoner-of-azkaban) --->|requires| harry-3
+ subgraph venv2[.venv]
+ harry-3[harry v3]
+ end
+ end
+ stone-project ~~~ azkaban-project
+```
+
+## O que significa ativar um ambiente virtual
+
+Quando você ativa um ambiente virtual, por exemplo com:
+
+//// tab | Linux, macOS
+
+<div class="termy">
+
+```console
+$ source .venv/bin/activate
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ .venv\Scripts\Activate.ps1
+```
+
+</div>
+
+////
+
+//// tab | Windows Bash
+
+Ou se você usa o Bash para Windows (por exemplo, <a href="https://gitforwindows.org/" class="external-link" target="_blank">Git Bash</a>):
+
+<div class="termy">
+
+```console
+$ source .venv/Scripts/activate
+```
+
+</div>
+
+////
+
+Esse comando criará ou modificará algumas [variáveis de ambiente](environment-variables.md){.internal-link target=_blank} que estarão disponíveis para os próximos comandos.
+
+Uma dessas variáveis é a variável `PATH`.
+
+/// tip | "Dica"
+
+Você pode aprender mais sobre a variável de ambiente `PATH` na seção [Variáveis de ambiente](environment-variables.md#path-environment-variable){.internal-link target=_blank}.
+
+///
+
+A ativação de um ambiente virtual adiciona seu caminho `.venv/bin` (no Linux e macOS) ou `.venv\Scripts` (no Windows) à variável de ambiente `PATH`.
+
+Digamos que antes de ativar o ambiente, a variável `PATH` estava assim:
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+Isso significa que o sistema procuraria programas em:
+
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Windows\System32
+```
+
+Isso significa que o sistema procuraria programas em:
+
+* `C:\Windows\System32`
+
+////
+
+Após ativar o ambiente virtual, a variável `PATH` ficaria mais ou menos assim:
+
+//// tab | Linux, macOS
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+Isso significa que o sistema agora começará a procurar primeiro por programas em:
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin
+```
+
+antes de procurar nos outros diretórios.
+
+Então, quando você digita `python` no terminal, o sistema encontrará o programa Python em
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+e usa esse.
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts;C:\Windows\System32
+```
+
+Isso significa que o sistema agora começará a procurar primeiro por programas em:
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts
+```
+
+antes de procurar nos outros diretórios.
+
+Então, quando você digita `python` no terminal, o sistema encontrará o programa Python em
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+e usa esse.
+
+////
+
+Um detalhe importante é que ele colocará o caminho do ambiente virtual no **início** da variável `PATH`. O sistema o encontrará **antes** de encontrar qualquer outro Python disponível. Dessa forma, quando você executar `python`, ele usará o Python **do ambiente virtual** em vez de qualquer outro `python` (por exemplo, um `python` de um ambiente global).
+
+Ativar um ambiente virtual também muda algumas outras coisas, mas esta é uma das mais importantes.
+
+## Verificando um ambiente virtual
+
+Ao verificar se um ambiente virtual está ativo, por exemplo com:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+$ which python
+
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ Get-Command python
+
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+</div>
+
+////
+
+Isso significa que o programa `python` que será usado é aquele **no ambiente virtual**.
+
+você usa `which` no Linux e macOS e `Get-Command` no Windows PowerShell.
+
+A maneira como esse comando funciona é que ele vai e verifica na variável de ambiente `PATH`, passando por **cada caminho em ordem**, procurando pelo programa chamado `python`. Uma vez que ele o encontre, ele **mostrará o caminho** para esse programa.
+
+A parte mais importante é que quando você chama ``python`, esse é exatamente o "`python`" que será executado.
+
+Assim, você pode confirmar se está no ambiente virtual correto.
+
+/// tip | "Dica"
+
+É fácil ativar um ambiente virtual, obter um Python e então **ir para outro projeto**.
+
+E o segundo projeto **não funcionaria** porque você está usando o **Python incorreto**, de um ambiente virtual para outro projeto.
+
+É útil poder verificar qual `python` está sendo usado. 🤓
+
+///
+
+## Por que desativar um ambiente virtual
+
+Por exemplo, você pode estar trabalhando em um projeto `philosophers-stone`, **ativar esse ambiente virtual**, instalar pacotes e trabalhar com esse ambiente.
+
+E então você quer trabalhar em **outro projeto** `prisoner-of-azkaban`.
+
+Você vai para aquele projeto:
+
+<div class="termy">
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+```
+
+</div>
+
+Se você não desativar o ambiente virtual para `philosophers-stone`, quando você executar `python` no terminal, ele tentará usar o Python de `philosophers-stone`.
+
+<div class="termy">
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+
+$ python main.py
+
+// Erro ao importar o Sirius, ele não está instalado 😱
+Traceback (most recent call last):
+ File "main.py", line 1, in <module>
+ import sirius
+```
+
+</div>
+
+Mas se você desativar o ambiente virtual e ativar o novo para `prisoner-of-askaban`, quando você executar `python`, ele usará o Python do ambiente virtual em `prisoner-of-azkaban`.
+
+<div class="termy">
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+
+// Você não precisa estar no diretório antigo para desativar, você pode fazer isso de onde estiver, mesmo depois de ir para o outro projeto 😎
+$ deactivate
+
+// Ative o ambiente virtual em prisoner-of-azkaban/.venv 🚀
+$ source .venv/bin/activate
+
+// Agora, quando você executar o python, ele encontrará o pacote sirius instalado neste ambiente virtual ✨
+$ python main.py
+
+Eu juro solenemente 🐺
+```
+
+</div>
+
+## Alternativas
+
+Este é um guia simples para você começar e lhe ensinar como tudo funciona **por baixo**.
+
+Existem muitas **alternativas** para gerenciar ambientes virtuais, dependências de pacotes (requisitos) e projetos.
+
+Quando estiver pronto e quiser usar uma ferramenta para **gerenciar todo o projeto**, dependências de pacotes, ambientes virtuais, etc., sugiro que você experimente o <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">uv</a>.
+
+`uv` pode fazer muitas coisas, ele pode:
+
+* **Instalar o Python** para você, incluindo versões diferentes
+* Gerenciar o **ambiente virtual** para seus projetos
+* Instalar **pacotes**
+* Gerenciar **dependências e versões** de pacotes para seu projeto
+* Certifique-se de ter um conjunto **exato** de pacotes e versões para instalar, incluindo suas dependências, para que você possa ter certeza de que pode executar seu projeto em produção exatamente da mesma forma que em seu computador durante o desenvolvimento, isso é chamado de **bloqueio**
+* E muitas outras coisas
+
+## Conclusão
+
+Se você leu e entendeu tudo isso, agora **você sabe muito mais** sobre ambientes virtuais do que muitos desenvolvedores por aí. 🤓
+
+Saber esses detalhes provavelmente será útil no futuro, quando você estiver depurando algo que parece complexo, mas você saberá **como tudo funciona**. 😎
From eb45bade63972dec674b83524e010e19ebdcd457 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 10 Sep 2024 10:37:36 +0000
Subject: [PATCH 044/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 7492242a4..114841f2d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/testing.md`. PR [#12164](https://github.com/fastapi/fastapi/pull/12164) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/debugging.md`. PR [#12165](https://github.com/fastapi/fastapi/pull/12165) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Korean translation for `docs/ko/docs/project-generation.md`. PR [#12157](https://github.com/fastapi/fastapi/pull/12157) by [@BORA040126](https://github.com/BORA040126).
From a4c5f7f62fbb2fbfc3daefd3ddcefa8b65e103d8 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 10 Sep 2024 10:38:58 +0000
Subject: [PATCH 045/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 114841f2d..11289cfe8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/environment-variables.md`. PR [#12162](https://github.com/fastapi/fastapi/pull/12162) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/testing.md`. PR [#12164](https://github.com/fastapi/fastapi/pull/12164) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/debugging.md`. PR [#12165](https://github.com/fastapi/fastapi/pull/12165) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Korean translation for `docs/ko/docs/project-generation.md`. PR [#12157](https://github.com/fastapi/fastapi/pull/12157) by [@BORA040126](https://github.com/BORA040126).
From 74451189f6f243833674fc22a1fe57dfb21f9831 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 10 Sep 2024 10:40:52 +0000
Subject: [PATCH 046/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 11289cfe8..a72775416 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/virtual-environments.md`. PR [#12163](https://github.com/fastapi/fastapi/pull/12163) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/environment-variables.md`. PR [#12162](https://github.com/fastapi/fastapi/pull/12162) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/testing.md`. PR [#12164](https://github.com/fastapi/fastapi/pull/12164) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/debugging.md`. PR [#12165](https://github.com/fastapi/fastapi/pull/12165) by [@marcelomarkus](https://github.com/marcelomarkus).
From b0eedbb5804a6ac32e4ee8d029d462d950ff8848 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 11 Sep 2024 09:45:30 +0200
Subject: [PATCH 047/504] =?UTF-8?q?=E2=9A=A1=EF=B8=8F=20Improve=20performa?=
=?UTF-8?q?nce=20in=20request=20body=20parsing=20with=20a=20cache=20for=20?=
=?UTF-8?q?internal=20model=20fields=20(#12184)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
fastapi/_compat.py | 6 ++++++
fastapi/dependencies/utils.py | 4 ++--
tests/test_compat.py | 16 ++++++++++++++++
3 files changed, 24 insertions(+), 2 deletions(-)
diff --git a/fastapi/_compat.py b/fastapi/_compat.py
index f940d6597..4b07b44fa 100644
--- a/fastapi/_compat.py
+++ b/fastapi/_compat.py
@@ -2,6 +2,7 @@ from collections import deque
from copy import copy
from dataclasses import dataclass, is_dataclass
from enum import Enum
+from functools import lru_cache
from typing import (
Any,
Callable,
@@ -649,3 +650,8 @@ def is_uploadfile_sequence_annotation(annotation: Any) -> bool:
is_uploadfile_or_nonable_uploadfile_annotation(sub_annotation)
for sub_annotation in get_args(annotation)
)
+
+
+@lru_cache
+def get_cached_model_fields(model: Type[BaseModel]) -> List[ModelField]:
+ return get_model_fields(model)
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 6083b7319..f18eace9d 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -32,8 +32,8 @@ from fastapi._compat import (
evaluate_forwardref,
field_annotation_is_scalar,
get_annotation_from_field_info,
+ get_cached_model_fields,
get_missing_field_error,
- get_model_fields,
is_bytes_field,
is_bytes_sequence_field,
is_scalar_field,
@@ -810,7 +810,7 @@ async def request_body_to_args(
fields_to_extract: List[ModelField] = body_fields
if single_not_embedded_field and lenient_issubclass(first_field.type_, BaseModel):
- fields_to_extract = get_model_fields(first_field.type_)
+ fields_to_extract = get_cached_model_fields(first_field.type_)
if isinstance(received_body, FormData):
body_to_process = await _extract_form_body(fields_to_extract, received_body)
diff --git a/tests/test_compat.py b/tests/test_compat.py
index 270475bf3..f4a3093c5 100644
--- a/tests/test_compat.py
+++ b/tests/test_compat.py
@@ -5,6 +5,7 @@ from fastapi._compat import (
ModelField,
Undefined,
_get_model_config,
+ get_cached_model_fields,
get_model_fields,
is_bytes_sequence_annotation,
is_scalar_field,
@@ -102,3 +103,18 @@ def test_is_pv1_scalar_field():
fields = get_model_fields(Model)
assert not is_scalar_field(fields[0])
+
+
+def test_get_model_fields_cached():
+ class Model(BaseModel):
+ foo: str
+
+ non_cached_fields = get_model_fields(Model)
+ non_cached_fields2 = get_model_fields(Model)
+ cached_fields = get_cached_model_fields(Model)
+ cached_fields2 = get_cached_model_fields(Model)
+ for f1, f2 in zip(cached_fields, cached_fields2):
+ assert f1 is f2
+
+ assert non_cached_fields is not non_cached_fields2
+ assert cached_fields is cached_fields2
From 8dc882f75121414eb44db590efae83fbddf43f72 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 11 Sep 2024 07:45:49 +0000
Subject: [PATCH 048/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a72775416..647b51b19 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Refactors
+
+* ⚡️ Improve performance in request body parsing with a cache for internal model fields. PR [#12184](https://github.com/fastapi/fastapi/pull/12184) by [@tiangolo](https://github.com/tiangolo).
+
### Docs
* 📝 Remove duplicate line in docs for `docs/en/docs/environment-variables.md`. PR [#12169](https://github.com/fastapi/fastapi/pull/12169) by [@prometek](https://github.com/prometek).
From 212fd5e247279073dceaba346fd4afc52f627232 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 11 Sep 2024 09:46:34 +0200
Subject: [PATCH 049/504] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
=?UTF-8?q?4.1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 2 ++
fastapi/__init__.py | 2 +-
2 files changed, 3 insertions(+), 1 deletion(-)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 647b51b19..97f472815 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
## Latest Changes
+## 0.114.1
+
### Refactors
* ⚡️ Improve performance in request body parsing with a cache for internal model fields. PR [#12184](https://github.com/fastapi/fastapi/pull/12184) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index dce17360f..c2ed4859a 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
"""FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
-__version__ = "0.114.0"
+__version__ = "0.114.1"
from starlette import status as status
From 24b8f2668beb773895a93040a2ae284898dc58b1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 12 Sep 2024 00:49:55 +0200
Subject: [PATCH 050/504] =?UTF-8?q?=E2=9E=95=20Add=20inline-snapshot=20for?=
=?UTF-8?q?=20tests=20(#12189)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
pyproject.toml | 4 ++++
requirements-tests.txt | 2 +-
2 files changed, 5 insertions(+), 1 deletion(-)
diff --git a/pyproject.toml b/pyproject.toml
index bb87be470..1be2817a1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -241,3 +241,7 @@ known-third-party = ["fastapi", "pydantic", "starlette"]
[tool.ruff.lint.pyupgrade]
# Preserve types, even if a file imports `from __future__ import annotations`.
keep-runtime-typing = true
+
+[tool.inline-snapshot]
+# default-flags=["fix"]
+# default-flags=["create"]
diff --git a/requirements-tests.txt b/requirements-tests.txt
index 809a19c0c..2f2576dd5 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -14,7 +14,7 @@ anyio[trio] >=3.2.1,<4.0.0
PyJWT==2.8.0
pyyaml >=5.3.1,<7.0.0
passlib[bcrypt] >=1.7.2,<2.0.0
-
+inline-snapshot==0.13.0
# types
types-ujson ==5.7.0.1
types-orjson ==3.6.2
From ba0bb6212e553e779f75f973d07a4db112b43cf0 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 11 Sep 2024 22:50:18 +0000
Subject: [PATCH 051/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 97f472815..01c9fb225 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Internal
+
+* ➕ Add inline-snapshot for tests. PR [#12189](https://github.com/fastapi/fastapi/pull/12189) by [@tiangolo](https://github.com/tiangolo).
+
## 0.114.1
### Refactors
From c8e644d19e688e00e51cdca2c1bb15d274d70801 Mon Sep 17 00:00:00 2001
From: Max Scheijen <47034840+maxscheijen@users.noreply.github.com>
Date: Thu, 12 Sep 2024 19:00:36 +0200
Subject: [PATCH 052/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Dutch=20translatio?=
=?UTF-8?q?n=20for=20`docs/nl/docs/python-types.md`=20(#12158)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/nl/docs/python-types.md | 597 +++++++++++++++++++++++++++++++++++
1 file changed, 597 insertions(+)
create mode 100644 docs/nl/docs/python-types.md
diff --git a/docs/nl/docs/python-types.md b/docs/nl/docs/python-types.md
new file mode 100644
index 000000000..a5562b795
--- /dev/null
+++ b/docs/nl/docs/python-types.md
@@ -0,0 +1,597 @@
+# Introductie tot Python Types
+
+Python biedt ondersteuning voor optionele "type hints" (ook wel "type annotaties" genoemd).
+
+Deze **"type hints"** of annotaties zijn een speciale syntax waarmee het <abbr title="bijvoorbeeld: str, int, float, bool">type</abbr> van een variabele kan worden gedeclareerd.
+
+Door types voor je variabelen te declareren, kunnen editors en hulpmiddelen je beter ondersteunen.
+
+Dit is slechts een **korte tutorial/opfrisser** over Python type hints. Het behandelt enkel het minimum dat nodig is om ze te gebruiken met **FastAPI**... en dat is relatief weinig.
+
+**FastAPI** is helemaal gebaseerd op deze type hints, ze geven veel voordelen.
+
+Maar zelfs als je **FastAPI** nooit gebruikt, heb je er baat bij om er iets over te leren.
+
+/// note
+
+Als je een Python expert bent en alles al weet over type hints, sla dan dit hoofdstuk over.
+
+///
+
+## Motivatie
+
+Laten we beginnen met een eenvoudig voorbeeld:
+
+```Python
+{!../../../docs_src/python_types/tutorial001.py!}
+```
+
+Het aanroepen van dit programma leidt tot het volgende resultaat:
+
+```
+John Doe
+```
+
+De functie voert het volgende uit:
+
+* Neem een `first_name` en een `last_name`
+* Converteer de eerste letter van elk naar een hoofdletter met `title()`.
+``
+* <abbr title="Voegt ze samen, als één. Met de inhoud van de een na de ander.">Voeg samen</abbr> met een spatie in het midden.
+
+```Python hl_lines="2"
+{!../../../docs_src/python_types/tutorial001.py!}
+```
+
+### Bewerk het
+
+Dit is een heel eenvoudig programma.
+
+Maar stel je nu voor dat je het vanaf nul zou moeten maken.
+
+Op een gegeven moment zou je aan de definitie van de functie zijn begonnen, je had de parameters klaar...
+
+Maar dan moet je “die methode die de eerste letter naar hoofdletters converteert” aanroepen.
+
+Was het `upper`? Was het `uppercase`? `first_uppercase`? `capitalize`?
+
+Dan roep je de hulp in van je oude programmeursvriend, (automatische) code aanvulling in je editor.
+
+Je typt de eerste parameter van de functie, `first_name`, dan een punt (`.`) en drukt dan op `Ctrl+Spatie` om de aanvulling te activeren.
+
+Maar helaas krijg je niets bruikbaars:
+
+<img src="/img/python-types/image01.png">
+
+### Types toevoegen
+
+Laten we een enkele regel uit de vorige versie aanpassen.
+
+We zullen precies dit fragment, de parameters van de functie, wijzigen van:
+
+```Python
+ first_name, last_name
+```
+
+naar:
+
+```Python
+ first_name: str, last_name: str
+```
+
+Dat is alles.
+
+Dat zijn de "type hints":
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial002.py!}
+```
+
+Dit is niet hetzelfde als het declareren van standaardwaarden zoals bij:
+
+```Python
+ first_name="john", last_name="doe"
+```
+
+Het is iets anders.
+
+We gebruiken dubbele punten (`:`), geen gelijkheidstekens (`=`).
+
+Het toevoegen van type hints verandert normaal gesproken niet wat er gebeurt in je programma t.o.v. wat er zonder type hints zou gebeuren.
+
+Maar stel je voor dat je weer bezig bent met het maken van een functie, maar deze keer met type hints.
+
+Op hetzelfde moment probeer je de automatische aanvulling te activeren met `Ctrl+Spatie` en je ziet:
+
+<img src="/img/python-types/image02.png">
+
+Nu kun je de opties bekijken en er doorheen scrollen totdat je de optie vindt die “een belletje doet rinkelen”:
+
+<img src="/img/python-types/image03.png">
+
+### Meer motivatie
+
+Bekijk deze functie, deze heeft al type hints:
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial003.py!}
+```
+
+Omdat de editor de types van de variabelen kent, krijgt u niet alleen aanvulling, maar ook controles op fouten:
+
+<img src="/img/python-types/image04.png">
+
+Nu weet je hoe je het moet oplossen, converteer `age` naar een string met `str(age)`:
+
+```Python hl_lines="2"
+{!../../../docs_src/python_types/tutorial004.py!}
+```
+
+## Types declareren
+
+Je hebt net de belangrijkste plek om type hints te declareren gezien. Namelijk als functieparameters.
+
+Dit is ook de belangrijkste plek waar je ze gebruikt met **FastAPI**.
+
+### Eenvoudige types
+
+Je kunt alle standaard Python types declareren, niet alleen `str`.
+
+Je kunt bijvoorbeeld het volgende gebruiken:
+
+* `int`
+* `float`
+* `bool`
+* `bytes`
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial005.py!}
+```
+
+### Generieke types met typeparameters
+
+Er zijn enkele datastructuren die andere waarden kunnen bevatten, zoals `dict`, `list`, `set` en `tuple` en waar ook de interne waarden hun eigen type kunnen hebben.
+
+Deze types die interne types hebben worden “**generieke**” types genoemd. Het is mogelijk om ze te declareren, zelfs met hun interne types.
+
+Om deze types en de interne types te declareren, kun je de standaard Python module `typing` gebruiken. Deze module is speciaal gemaakt om deze type hints te ondersteunen.
+
+#### Nieuwere versies van Python
+
+De syntax met `typing` is **verenigbaar** met alle versies, van Python 3.6 tot aan de nieuwste, inclusief Python 3.9, Python 3.10, enz.
+
+Naarmate Python zich ontwikkelt, worden **nieuwere versies**, met verbeterde ondersteuning voor deze type annotaties, beschikbaar. In veel gevallen hoef je niet eens de `typing` module te importeren en te gebruiken om de type annotaties te declareren.
+
+Als je een recentere versie van Python kunt kiezen voor je project, kun je profiteren van die extra eenvoud.
+
+In alle documentatie staan voorbeelden die compatibel zijn met elke versie van Python (als er een verschil is).
+
+Bijvoorbeeld “**Python 3.6+**” betekent dat het compatibel is met Python 3.6 of hoger (inclusief 3.7, 3.8, 3.9, 3.10, etc). En “**Python 3.9+**” betekent dat het compatibel is met Python 3.9 of hoger (inclusief 3.10, etc).
+
+Als je de **laatste versies van Python** kunt gebruiken, gebruik dan de voorbeelden voor de laatste versie, die hebben de **beste en eenvoudigste syntax**, bijvoorbeeld “**Python 3.10+**”.
+
+#### List
+
+Laten we bijvoorbeeld een variabele definiëren als een `list` van `str`.
+
+//// tab | Python 3.9+
+
+Declareer de variabele met dezelfde dubbele punt (`:`) syntax.
+
+Als type, vul `list` in.
+
+Doordat de list een type is dat enkele interne types bevat, zet je ze tussen vierkante haakjes:
+
+```Python hl_lines="1"
+{!> ../../../docs_src/python_types/tutorial006_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+Van `typing`, importeer `List` (met een hoofdletter `L`):
+
+```Python hl_lines="1"
+{!> ../../../docs_src/python_types/tutorial006.py!}
+```
+
+Declareer de variabele met dezelfde dubbele punt (`:`) syntax.
+
+Zet als type de `List` die je hebt geïmporteerd uit `typing`.
+
+Doordat de list een type is dat enkele interne types bevat, zet je ze tussen vierkante haakjes:
+
+```Python hl_lines="4"
+{!> ../../../docs_src/python_types/tutorial006.py!}
+```
+
+////
+
+/// info
+
+De interne types tussen vierkante haakjes worden “typeparameters” genoemd.
+
+In dit geval is `str` de typeparameter die wordt doorgegeven aan `List` (of `list` in Python 3.9 en hoger).
+
+///
+
+Dat betekent: “de variabele `items` is een `list`, en elk van de items in deze list is een `str`”.
+
+/// tip
+
+Als je Python 3.9 of hoger gebruikt, hoef je `List` niet te importeren uit `typing`, je kunt in plaats daarvan hetzelfde reguliere `list` type gebruiken.
+
+///
+
+Door dat te doen, kan je editor ondersteuning bieden, zelfs tijdens het verwerken van items uit de list:
+
+<img src="/img/python-types/image05.png">
+
+Zonder types is dat bijna onmogelijk om te bereiken.
+
+Merk op dat de variabele `item` een van de elementen is in de lijst `items`.
+
+Toch weet de editor dat het een `str` is, en biedt daar vervolgens ondersteuning voor aan.
+
+#### Tuple en Set
+
+Je kunt hetzelfde doen om `tuple`s en `set`s te declareren:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="1"
+{!> ../../../docs_src/python_types/tutorial007_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1 4"
+{!> ../../../docs_src/python_types/tutorial007.py!}
+```
+
+////
+
+Dit betekent:
+
+* De variabele `items_t` is een `tuple` met 3 items, een `int`, nog een `int`, en een `str`.
+* De variabele `items_s` is een `set`, en elk van de items is van het type `bytes`.
+
+#### Dict
+
+Om een `dict` te definiëren, geef je 2 typeparameters door, gescheiden door komma's.
+
+De eerste typeparameter is voor de sleutels (keys) van de `dict`.
+
+De tweede typeparameter is voor de waarden (values) van het `dict`:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="1"
+{!> ../../../docs_src/python_types/tutorial008_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1 4"
+{!> ../../../docs_src/python_types/tutorial008.py!}
+```
+
+////
+
+Dit betekent:
+
+* De variabele `prices` is een `dict`:
+ * De sleutels van dit `dict` zijn van het type `str` (bijvoorbeeld de naam van elk item).
+ * De waarden van dit `dict` zijn van het type `float` (bijvoorbeeld de prijs van elk item).
+
+#### Union
+
+Je kunt een variable declareren die van **verschillende types** kan zijn, bijvoorbeeld een `int` of een `str`.
+
+In Python 3.6 en hoger (inclusief Python 3.10) kun je het `Union`-type van `typing` gebruiken en de mogelijke types die je wilt accepteren, tussen de vierkante haakjes zetten.
+
+In Python 3.10 is er ook een **nieuwe syntax** waarin je de mogelijke types kunt scheiden door een <abbr title='ook wel "bitwise of operator" genoemd, maar die betekenis is hier niet relevant'>verticale balk (`|`)</abbr>.
+
+//// tab | Python 3.10+
+
+```Python hl_lines="1"
+{!> ../../../docs_src/python_types/tutorial008b_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1 4"
+{!> ../../../docs_src/python_types/tutorial008b.py!}
+```
+
+////
+
+In beide gevallen betekent dit dat `item` een `int` of een `str` kan zijn.
+
+#### Mogelijk `None`
+
+Je kunt declareren dat een waarde een type kan hebben, zoals `str`, maar dat het ook `None` kan zijn.
+
+In Python 3.6 en hoger (inclusief Python 3.10) kun je het declareren door `Optional` te importeren en te gebruiken vanuit de `typing`-module.
+
+```Python hl_lines="1 4"
+{!../../../docs_src/python_types/tutorial009.py!}
+```
+
+Door `Optional[str]` te gebruiken in plaats van alleen `str`, kan de editor je helpen fouten te detecteren waarbij je ervan uit zou kunnen gaan dat een waarde altijd een `str` is, terwijl het in werkelijkheid ook `None` zou kunnen zijn.
+
+`Optional[EenType]` is eigenlijk een snelkoppeling voor `Union[EenType, None]`, ze zijn equivalent.
+
+Dit betekent ook dat je in Python 3.10 `EenType | None` kunt gebruiken:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="1"
+{!> ../../../docs_src/python_types/tutorial009_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1 4"
+{!> ../../../docs_src/python_types/tutorial009.py!}
+```
+
+////
+
+//// tab | Python 3.8+ alternative
+
+```Python hl_lines="1 4"
+{!> ../../../docs_src/python_types/tutorial009b.py!}
+```
+
+////
+
+#### Gebruik van `Union` of `Optional`
+
+Als je een Python versie lager dan 3.10 gebruikt, is dit een tip vanuit mijn **subjectieve** standpunt:
+
+* 🚨 Vermijd het gebruik van `Optional[EenType]`.
+* Gebruik in plaats daarvan **`Union[EenType, None]`** ✨.
+
+Beide zijn gelijkwaardig en onderliggend zijn ze hetzelfde, maar ik zou `Union` aanraden in plaats van `Optional` omdat het woord “**optional**” lijkt te impliceren dat de waarde optioneel is, en het eigenlijk betekent “het kan `None` zijn”, zelfs als het niet optioneel is en nog steeds vereist is.
+
+Ik denk dat `Union[SomeType, None]` explicieter is over wat het betekent.
+
+Het gaat alleen om de woorden en naamgeving. Maar die naamgeving kan invloed hebben op hoe jij en je teamgenoten over de code denken.
+
+Laten we als voorbeeld deze functie nemen:
+
+```Python hl_lines="1 4"
+{!../../../docs_src/python_types/tutorial009c.py!}
+```
+
+De parameter `name` is gedefinieerd als `Optional[str]`, maar is **niet optioneel**, je kunt de functie niet aanroepen zonder de parameter:
+
+```Python
+say_hi() # Oh, nee, dit geeft een foutmelding! 😱
+```
+
+De `name` parameter is **nog steeds vereist** (niet *optioneel*) omdat het geen standaardwaarde heeft. Toch accepteert `name` `None` als waarde:
+
+```Python
+say_hi(name=None) # Dit werkt, None is geldig 🎉
+```
+
+Het goede nieuws is dat als je eenmaal Python 3.10 gebruikt, je je daar geen zorgen meer over hoeft te maken, omdat je dan gewoon `|` kunt gebruiken om unions van types te definiëren:
+
+```Python hl_lines="1 4"
+{!../../../docs_src/python_types/tutorial009c_py310.py!}
+```
+
+Dan hoef je je geen zorgen te maken over namen als `Optional` en `Union`. 😎
+
+#### Generieke typen
+
+De types die typeparameters in vierkante haakjes gebruiken, worden **Generieke types** of **Generics** genoemd, bijvoorbeeld:
+
+//// tab | Python 3.10+
+
+Je kunt dezelfde ingebouwde types gebruiken als generics (met vierkante haakjes en types erin):
+
+* `list`
+* `tuple`
+* `set`
+* `dict`
+
+Hetzelfde als bij Python 3.8, uit de `typing`-module:
+
+* `Union`
+* `Optional` (hetzelfde als bij Python 3.8)
+* ...en anderen.
+
+In Python 3.10 kun je , als alternatief voor de generieke `Union` en `Optional`, de <abbr title='ook wel "bitwise or operator" genoemd, maar die betekenis is hier niet relevant'>verticale lijn (`|`)</abbr> gebruiken om unions van typen te voorzien, dat is veel beter en eenvoudiger.
+
+////
+
+//// tab | Python 3.9+
+
+Je kunt dezelfde ingebouwde types gebruiken als generieke types (met vierkante haakjes en types erin):
+
+* `list`
+* `tuple`
+* `set`
+* `dict`
+
+En hetzelfde als met Python 3.8, vanuit de `typing`-module:
+
+* `Union`
+* `Optional`
+* ...en anderen.
+
+////
+
+//// tab | Python 3.8+
+
+* `List`
+* `Tuple`
+* `Set`
+* `Dict`
+* `Union`
+* `Optional`
+* ...en anderen.
+
+////
+
+### Klassen als types
+
+Je kunt een klasse ook declareren als het type van een variabele.
+
+Stel dat je een klasse `Person` hebt, met een naam:
+
+```Python hl_lines="1-3"
+{!../../../docs_src/python_types/tutorial010.py!}
+```
+
+Vervolgens kun je een variabele van het type `Persoon` declareren:
+
+```Python hl_lines="6"
+{!../../../docs_src/python_types/tutorial010.py!}
+```
+
+Dan krijg je ook nog eens volledige editorondersteuning:
+
+<img src="/img/python-types/image06.png">
+
+Merk op dat dit betekent dat "`one_person` een **instantie** is van de klasse `Person`".
+
+Dit betekent niet dat `one_person` de **klasse** is met de naam `Person`.
+
+## Pydantic modellen
+
+<a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic</a> is een Python-pakket voor het uitvoeren van datavalidatie.
+
+Je declareert de "vorm" van de data als klassen met attributen.
+
+Elk attribuut heeft een type.
+
+Vervolgens maak je een instantie van die klasse met een aantal waarden en het valideert de waarden, converteert ze naar het juiste type (als dat het geval is) en geeft je een object met alle data terug.
+
+Daarnaast krijg je volledige editorondersteuning met dat resulterende object.
+
+Een voorbeeld uit de officiële Pydantic-documentatie:
+
+//// tab | Python 3.10+
+
+```Python
+{!> ../../../docs_src/python_types/tutorial011_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!> ../../../docs_src/python_types/tutorial011_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python
+{!> ../../../docs_src/python_types/tutorial011.py!}
+```
+
+////
+
+/// info
+
+Om meer te leren over <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic, bekijk de documentatie</a>.
+
+///
+
+**FastAPI** is volledig gebaseerd op Pydantic.
+
+Je zult veel meer van dit alles in de praktijk zien in de [Tutorial - Gebruikershandleiding](tutorial/index.md){.internal-link target=_blank}.
+
+/// tip
+
+Pydantic heeft een speciaal gedrag wanneer je `Optional` of `Union[EenType, None]` gebruikt zonder een standaardwaarde, je kunt er meer over lezen in de Pydantic-documentatie over <a href="https://docs.pydantic.dev/2.3/usage/models/#required-fields" class="external-link" target="_blank">Verplichte optionele velden</a>.
+
+///
+
+## Type Hints met Metadata Annotaties
+
+Python heeft ook een functie waarmee je **extra <abbr title="Data over de data, in dit geval informatie over het type, bijvoorbeeld een beschrijving.">metadata</abbr>** in deze type hints kunt toevoegen met behulp van `Annotated`.
+
+//// tab | Python 3.9+
+
+In Python 3.9 is `Annotated` onderdeel van de standaardpakket, dus je kunt het importeren vanuit `typing`.
+
+```Python hl_lines="1 4"
+{!> ../../../docs_src/python_types/tutorial013_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+In versies lager dan Python 3.9 importeer je `Annotated` vanuit `typing_extensions`.
+
+Het wordt al geïnstalleerd met **FastAPI**.
+
+```Python hl_lines="1 4"
+{!> ../../../docs_src/python_types/tutorial013.py!}
+```
+
+////
+
+Python zelf doet niets met deze `Annotated` en voor editors en andere hulpmiddelen is het type nog steeds een `str`.
+
+Maar je kunt deze ruimte in `Annotated` gebruiken om **FastAPI** te voorzien van extra metadata over hoe je wilt dat je applicatie zich gedraagt.
+
+Het belangrijkste om te onthouden is dat **de eerste *typeparameter*** die je doorgeeft aan `Annotated` het **werkelijke type** is. De rest is gewoon metadata voor andere hulpmiddelen.
+
+Voor nu hoef je alleen te weten dat `Annotated` bestaat en dat het standaard Python is. 😎
+
+Later zul je zien hoe **krachtig** het kan zijn.
+
+/// tip
+
+Het feit dat dit **standaard Python** is, betekent dat je nog steeds de **best mogelijke ontwikkelaarservaring** krijgt in je editor, met de hulpmiddelen die je gebruikt om je code te analyseren en te refactoren, enz. ✨
+
+Daarnaast betekent het ook dat je code zeer verenigbaar zal zijn met veel andere Python-hulpmiddelen en -pakketten. 🚀
+
+///
+
+## Type hints in **FastAPI**
+
+**FastAPI** maakt gebruik van type hints om verschillende dingen te doen.
+
+Met **FastAPI** declareer je parameters met type hints en krijg je:
+
+* **Editor ondersteuning**.
+* **Type checks**.
+
+...en **FastAPI** gebruikt dezelfde declaraties om:
+
+* **Vereisten te definïeren **: van request pad parameters, query parameters, headers, bodies, dependencies, enz.
+* **Data te converteren**: van de request naar het vereiste type.
+* **Data te valideren**: afkomstig van elke request:
+ * **Automatische foutmeldingen** te genereren die naar de client worden geretourneerd wanneer de data ongeldig is.
+* De API met OpenAPI te **documenteren**:
+ * die vervolgens wordt gebruikt door de automatische interactieve documentatie gebruikersinterfaces.
+
+Dit klinkt misschien allemaal abstract. Maak je geen zorgen. Je ziet dit allemaal in actie in de [Tutorial - Gebruikershandleiding](tutorial/index.md){.internal-link target=_blank}.
+
+Het belangrijkste is dat door standaard Python types te gebruiken, op één plek (in plaats van meer klassen, decorators, enz. toe te voegen), **FastAPI** een groot deel van het werk voor je doet.
+
+/// info
+
+Als je de hele tutorial al hebt doorgenomen en terug bent gekomen om meer te weten te komen over types, is een goede bron <a href="https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html" class="external-link" target="_blank">het "cheat sheet" van `mypy`</a>.
+
+///
From 492943fdb1f726800ab7a42ead08e297813c8e68 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 12 Sep 2024 17:01:01 +0000
Subject: [PATCH 053/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 01c9fb225..c3bf2bb8d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Translations
+
+* 🌐 Add Dutch translation for `docs/nl/docs/python-types.md`. PR [#12158](https://github.com/fastapi/fastapi/pull/12158) by [@maxscheijen](https://github.com/maxscheijen).
+
### Internal
* ➕ Add inline-snapshot for tests. PR [#12189](https://github.com/fastapi/fastapi/pull/12189) by [@tiangolo](https://github.com/tiangolo).
From 4a94fe3c8249e2c13999964ac9f707ab0ca069ee Mon Sep 17 00:00:00 2001
From: Waket Zheng <waketzheng@gmail.com>
Date: Fri, 13 Sep 2024 01:01:54 +0800
Subject: [PATCH 054/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Chinese=20translat?=
=?UTF-8?q?ion=20for=20`docs/zh/docs/project-generation.md`=20(#12170)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh/docs/project-generation.md | 112 ++++++++---------------------
1 file changed, 28 insertions(+), 84 deletions(-)
diff --git a/docs/zh/docs/project-generation.md b/docs/zh/docs/project-generation.md
index 0655cb0a9..9b3735539 100644
--- a/docs/zh/docs/project-generation.md
+++ b/docs/zh/docs/project-generation.md
@@ -1,84 +1,28 @@
-# 项目生成 - 模板
-
-项目生成器一般都会提供很多初始设置、安全措施、数据库，甚至还准备好了第一个 API 端点，能帮助您快速上手。
-
-项目生成器的设置通常都很主观，您可以按需更新或修改，但对于您的项目来说，它是非常好的起点。
-
-## 全栈 FastAPI + PostgreSQL
-
-GitHub：<a href="https://github.com/tiangolo/full-stack-fastapi-postgresql" class="external-link" target="_blank">https://github.com/tiangolo/full-stack-fastapi-postgresql</a>
-
-### 全栈 FastAPI + PostgreSQL - 功能
-
-* 完整的 **Docker** 集成（基于 Docker）
-* Docker Swarm 开发模式
-* **Docker Compose** 本地开发集成与优化
-* **生产可用**的 Python 网络服务器，使用 Uvicorn 或 Gunicorn
-* Python <a href="https://github.com/fastapi/fastapi" class="external-link" target="_blank">**FastAPI**</a> 后端：
-* * **速度快**：可与 **NodeJS** 和 **Go** 比肩的极高性能（归功于 Starlette 和 Pydantic）
- * **直观**：强大的编辑器支持，处处皆可<abbr title="也叫自动完成、智能感知">自动补全</abbr>，减少调试时间
- * **简单**：易学、易用，阅读文档所需时间更短
- * **简短**：代码重复最小化，每次参数声明都可以实现多个功能
- * **健壮**： 生产级别的代码，还有自动交互文档
- * **基于标准**：完全兼容并基于 API 开放标准：<a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a> 和 <a href="https://json-schema.org/" class="external-link" target="_blank">JSON Schema</a>
- * <a href="https://fastapi.tiangolo.com/features/" class="external-link" target="_blank">**更多功能**</a>包括自动验证、序列化、交互文档、OAuth2 JWT 令牌身份验证等
-* **安全密码**，默认使用密码哈希
-* **JWT 令牌**身份验证
-* **SQLAlchemy** 模型（独立于 Flask 扩展，可直接用于 Celery Worker）
-* 基础的用户模型（可按需修改或删除）
-* **Alembic** 迁移
-* **CORS**（跨域资源共享）
-* **Celery** Worker 可从后端其它部分有选择地导入并使用模型和代码
-* REST 后端测试基于 Pytest，并与 Docker 集成，可独立于数据库实现完整的 API 交互测试。因为是在 Docker 中运行，每次都可从头构建新的数据存储（使用 ElasticSearch、MongoDB、CouchDB 等数据库，仅测试 API 运行）
-* Python 与 **Jupyter Kernels** 集成，用于远程或 Docker 容器内部开发，使用 Atom Hydrogen 或 Visual Studio Code 的 Jupyter 插件
-* **Vue** 前端：
- * 由 Vue CLI 生成
- * **JWT 身份验证**处理
- * 登录视图
- * 登录后显示主仪表盘视图
- * 主仪表盘支持用户创建与编辑
- * 用户信息编辑
- * **Vuex**
- * **Vue-router**
- * **Vuetify** 美化组件
- * **TypeScript**
- * 基于 **Nginx** 的 Docker 服务器（优化了 Vue-router 配置）
- * Docker 多阶段构建，无需保存或提交编译的代码
- * 在构建时运行前端测试（可禁用）
- * 尽量模块化，开箱即用，但仍可使用 Vue CLI 重新生成或创建所需项目，或复用所需内容
-* 使用 **PGAdmin** 管理 PostgreSQL 数据库，可轻松替换为 PHPMyAdmin 或 MySQL
-* 使用 **Flower** 监控 Celery 任务
-* 使用 **Traefik** 处理前后端负载平衡，可把前后端放在同一个域下，按路径分隔，但在不同容器中提供服务
-* Traefik 集成，包括自动生成 Let's Encrypt **HTTPS** 凭证
-* GitLab **CI**（持续集成），包括前后端测试
-
-## 全栈 FastAPI + Couchbase
-
-GitHub：<a href="https://github.com/tiangolo/full-stack-fastapi-couchbase" class="external-link" target="_blank">https://github.com/tiangolo/full-stack-fastapi-couchbase</a>
-
-⚠️ **警告** ⚠️
-
-如果您想从头开始创建新项目，建议使用以下备选方案。
-
-例如，项目生成器<a href="https://github.com/tiangolo/full-stack-fastapi-postgresql" class="external-link" target="_blank">全栈 FastAPI + PostgreSQL </a>会更适用，这个项目的维护积极，用的人也多，还包括了所有新功能和改进内容。
-
-当然，您也可以放心使用这个基于 Couchbase 的生成器，它也能正常使用。就算用它生成项目也没有任何问题（为了更好地满足需求，您可以自行更新这个项目）。
-
-详见资源仓库中的文档。
-
-## 全栈 FastAPI + MongoDB
-
-……敬请期待，得看我有没有时间做这个项目。😅 🎉
-
-## FastAPI + spaCy 机器学习模型
-
-GitHub：<a href="https://github.com/microsoft/cookiecutter-spacy-fastapi" class="external-link" target="_blank">https://github.com/microsoft/cookiecutter-spacy-fastapi</a>
-
-### FastAPI + spaCy 机器学习模型 - 功能
-
-* 集成 **spaCy** NER 模型
-* 内置 **Azure 认知搜索**请求格式
-* **生产可用**的 Python 网络服务器，使用 Uvicorn 与 Gunicorn
-* 内置 **Azure DevOps** Kubernetes (AKS) CI/CD 开发
-* **多语**支持，可在项目设置时选择 spaCy 内置的语言
-* 不仅局限于 spaCy，可**轻松扩展**至其它模型框架（Pytorch、TensorFlow）
+# FastAPI全栈模板
+
+模板通常带有特定的设置，而且被设计为灵活和可定制的。这允许您根据项目的需求修改和调整它们，使它们成为一个很好的起点。🏁
+
+您可以使用此模板开始，因为它包含了许多已经为您完成的初始设置、安全性、数据库和一些API端点。
+
+代码仓： <a href="https://github.com/fastapi/full-stack-fastapi-template" class="external-link" target="_blank">Full Stack FastAPI Template</a>
+
+## FastAPI全栈模板 - 技术栈和特性
+
+- ⚡ [**FastAPI**](https://fastapi.tiangolo.com) 用于Python后端API.
+ - 🧰 [SQLModel](https://sqlmodel.tiangolo.com) 用于Python和SQL数据库的集成（ORM）。
+ - 🔍 [Pydantic](https://docs.pydantic.dev) FastAPI的依赖项之一，用于数据验证和配置管理。
+ - 💾 [PostgreSQL](https://www.postgresql.org) 作为SQL数据库。
+- 🚀 [React](https://react.dev) 用于前端。
+ - 💃 使用了TypeScript、hooks、Vite和其他一些现代化的前端技术栈。
+ - 🎨 [Chakra UI](https://chakra-ui.com) 用于前端组件。
+ - 🤖 一个自动化生成的前端客户端。
+ - 🧪 Playwright用于端到端测试。
+ - 🦇 支持暗黑主题（Dark mode）。
+- 🐋 [Docker Compose](https://www.docker.com) 用于开发环境和生产环境。
+- 🔒 默认使用密码哈希来保证安全。
+- 🔑 JWT令牌用于权限验证。
+- 📫 使用邮箱来进行密码恢复。
+- ✅ 单元测试用了[Pytest](https://pytest.org).
+- 📞 [Traefik](https://traefik.io) 用于反向代理和负载均衡。
+- 🚢 部署指南（Docker Compose）包含了如何起一个Traefik前端代理来自动化HTTPS认证。
+- 🏭 CI（持续集成）和 CD（持续部署）基于GitHub Actions。
From 93e50e373b0651c22a6743a4e907dafbadc8d27e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 12 Sep 2024 17:03:26 +0000
Subject: [PATCH 055/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c3bf2bb8d..ac2398759 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Chinese translation for `docs/zh/docs/project-generation.md`. PR [#12170](https://github.com/fastapi/fastapi/pull/12170) by [@waketzheng](https://github.com/waketzheng).
* 🌐 Add Dutch translation for `docs/nl/docs/python-types.md`. PR [#12158](https://github.com/fastapi/fastapi/pull/12158) by [@maxscheijen](https://github.com/maxscheijen).
### Internal
From e50facaf227f4725d64c7166c2fe3438367705c7 Mon Sep 17 00:00:00 2001
From: Rafael de Oliveira Marques <rafaelomarques@gmail.com>
Date: Thu, 12 Sep 2024 14:03:48 -0300
Subject: [PATCH 056/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/request-form-models.md`?=
=?UTF-8?q?=20(#12175)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/tutorial/request-form-models.md | 134 +++++++++++++++++++
1 file changed, 134 insertions(+)
create mode 100644 docs/pt/docs/tutorial/request-form-models.md
diff --git a/docs/pt/docs/tutorial/request-form-models.md b/docs/pt/docs/tutorial/request-form-models.md
new file mode 100644
index 000000000..a9db18e9d
--- /dev/null
+++ b/docs/pt/docs/tutorial/request-form-models.md
@@ -0,0 +1,134 @@
+# Modelos de Formulários
+
+Você pode utilizar **Modelos Pydantic** para declarar **campos de formulários** no FastAPI.
+
+/// info | "Informação"
+
+Para utilizar formulários, instale primeiramente o <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
+
+Certifique-se de criar um [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, ativá-lo, e então instalar. Por exemplo:
+
+```console
+$ pip install python-multipart
+```
+
+///
+
+/// note | "Nota"
+
+Isto é suportado desde a versão `0.113.0` do FastAPI. 🤓
+
+///
+
+## Modelos Pydantic para Formulários
+
+Você precisa apenas declarar um **modelo Pydantic** com os campos que deseja receber como **campos de formulários**, e então declarar o parâmetro como um `Form`:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9-11 15"
+{!> ../../../docs_src/request_form_models/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="8-10 14"
+{!> ../../../docs_src/request_form_models/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | "Dica"
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="7-9 13"
+{!> ../../../docs_src/request_form_models/tutorial001.py!}
+```
+
+////
+
+O **FastAPI** irá **extrair** as informações para **cada campo** dos **dados do formulário** na requisição e dar para você o modelo Pydantic que você definiu.
+
+## Confira os Documentos
+
+Você pode verificar na UI de documentação em `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/request-form-models/image01.png">
+</div>
+
+## Proibir Campos Extras de Formulários
+
+Em alguns casos de uso especiais (provavelmente não muito comum), você pode desejar **restringir** os campos do formulário para aceitar apenas os declarados no modelo Pydantic. E **proibir** qualquer campo **extra**.
+
+/// note | "Nota"
+
+Isso é suportado deste a versão `0.114.0` do FastAPI. 🤓
+
+///
+
+Você pode utilizar a configuração de modelo do Pydantic para `proibir` qualquer campo `extra`:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="12"
+{!> ../../../docs_src/request_form_models/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../../docs_src/request_form_models/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="10"
+{!> ../../../docs_src/request_form_models/tutorial002.py!}
+```
+
+////
+
+Caso um cliente tente enviar informações adicionais, ele receberá um retorno de **erro**.
+
+Por exemplo, se o cliente tentar enviar os campos de formulário:
+
+* `username`: `Rick`
+* `password`: `Portal Gun`
+* `extra`: `Mr. Poopybutthole`
+
+Ele receberá um retorno de erro informando-o que o campo `extra` não é permitido:
+
+```json
+{
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["body", "extra"],
+ "msg": "Extra inputs are not permitted",
+ "input": "Mr. Poopybutthole"
+ }
+ ]
+}
+```
+
+## Resumo
+
+Você pode utilizar modelos Pydantic para declarar campos de formulários no FastAPI. 😎
From ed66d705139b67665db1742797fdbeba7490c0e2 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 12 Sep 2024 17:06:34 +0000
Subject: [PATCH 057/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ac2398759..6534adb03 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/request-form-models.md`. PR [#12175](https://github.com/fastapi/fastapi/pull/12175) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Add Chinese translation for `docs/zh/docs/project-generation.md`. PR [#12170](https://github.com/fastapi/fastapi/pull/12170) by [@waketzheng](https://github.com/waketzheng).
* 🌐 Add Dutch translation for `docs/nl/docs/python-types.md`. PR [#12158](https://github.com/fastapi/fastapi/pull/12158) by [@maxscheijen](https://github.com/maxscheijen).
From 2a4351105ed968002ad15530dec35c6bb453a042 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 13 Sep 2024 11:14:46 +0200
Subject: [PATCH 058/504] =?UTF-8?q?=F0=9F=92=A1=20Add=20comments=20with=20?=
=?UTF-8?q?instructions=20for=20Playwright=20screenshot=20scripts=20(#1219?=
=?UTF-8?q?3)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
scripts/playwright/request_form_models/image01.py | 4 +++-
scripts/playwright/separate_openapi_schemas/image01.py | 3 +++
scripts/playwright/separate_openapi_schemas/image02.py | 3 +++
scripts/playwright/separate_openapi_schemas/image03.py | 3 +++
scripts/playwright/separate_openapi_schemas/image04.py | 3 +++
scripts/playwright/separate_openapi_schemas/image05.py | 3 +++
6 files changed, 18 insertions(+), 1 deletion(-)
diff --git a/scripts/playwright/request_form_models/image01.py b/scripts/playwright/request_form_models/image01.py
index 15bd3858c..fe4da32fc 100644
--- a/scripts/playwright/request_form_models/image01.py
+++ b/scripts/playwright/request_form_models/image01.py
@@ -8,11 +8,13 @@ from playwright.sync_api import Playwright, sync_playwright
# Run playwright codegen to generate the code below, copy paste the sections in run()
def run(playwright: Playwright) -> None:
browser = playwright.chromium.launch(headless=False)
- context = browser.new_context()
+ # Update the viewport manually
+ context = browser.new_context(viewport={"width": 960, "height": 1080})
page = context.new_page()
page.goto("http://localhost:8000/docs")
page.get_by_role("button", name="POST /login/ Login").click()
page.get_by_role("button", name="Try it out").click()
+ # Manually add the screenshot
page.screenshot(path="docs/en/docs/img/tutorial/request-form-models/image01.png")
# ---------------------
diff --git a/scripts/playwright/separate_openapi_schemas/image01.py b/scripts/playwright/separate_openapi_schemas/image01.py
index 0b40f3bbc..0eb55fb73 100644
--- a/scripts/playwright/separate_openapi_schemas/image01.py
+++ b/scripts/playwright/separate_openapi_schemas/image01.py
@@ -3,13 +3,16 @@ import subprocess
from playwright.sync_api import Playwright, sync_playwright
+# Run playwright codegen to generate the code below, copy paste the sections in run()
def run(playwright: Playwright) -> None:
browser = playwright.chromium.launch(headless=False)
+ # Update the viewport manually
context = browser.new_context(viewport={"width": 960, "height": 1080})
page = context.new_page()
page.goto("http://localhost:8000/docs")
page.get_by_text("POST/items/Create Item").click()
page.get_by_role("tab", name="Schema").first.click()
+ # Manually add the screenshot
page.screenshot(
path="docs/en/docs/img/tutorial/separate-openapi-schemas/image01.png"
)
diff --git a/scripts/playwright/separate_openapi_schemas/image02.py b/scripts/playwright/separate_openapi_schemas/image02.py
index f76af7ee2..0eb6c3c79 100644
--- a/scripts/playwright/separate_openapi_schemas/image02.py
+++ b/scripts/playwright/separate_openapi_schemas/image02.py
@@ -3,14 +3,17 @@ import subprocess
from playwright.sync_api import Playwright, sync_playwright
+# Run playwright codegen to generate the code below, copy paste the sections in run()
def run(playwright: Playwright) -> None:
browser = playwright.chromium.launch(headless=False)
+ # Update the viewport manually
context = browser.new_context(viewport={"width": 960, "height": 1080})
page = context.new_page()
page.goto("http://localhost:8000/docs")
page.get_by_text("GET/items/Read Items").click()
page.get_by_role("button", name="Try it out").click()
page.get_by_role("button", name="Execute").click()
+ # Manually add the screenshot
page.screenshot(
path="docs/en/docs/img/tutorial/separate-openapi-schemas/image02.png"
)
diff --git a/scripts/playwright/separate_openapi_schemas/image03.py b/scripts/playwright/separate_openapi_schemas/image03.py
index 127f5c428..b68e9d7db 100644
--- a/scripts/playwright/separate_openapi_schemas/image03.py
+++ b/scripts/playwright/separate_openapi_schemas/image03.py
@@ -3,14 +3,17 @@ import subprocess
from playwright.sync_api import Playwright, sync_playwright
+# Run playwright codegen to generate the code below, copy paste the sections in run()
def run(playwright: Playwright) -> None:
browser = playwright.chromium.launch(headless=False)
+ # Update the viewport manually
context = browser.new_context(viewport={"width": 960, "height": 1080})
page = context.new_page()
page.goto("http://localhost:8000/docs")
page.get_by_text("GET/items/Read Items").click()
page.get_by_role("tab", name="Schema").click()
page.get_by_label("Schema").get_by_role("button", name="Expand all").click()
+ # Manually add the screenshot
page.screenshot(
path="docs/en/docs/img/tutorial/separate-openapi-schemas/image03.png"
)
diff --git a/scripts/playwright/separate_openapi_schemas/image04.py b/scripts/playwright/separate_openapi_schemas/image04.py
index 208eaf8a0..a36c2f6b2 100644
--- a/scripts/playwright/separate_openapi_schemas/image04.py
+++ b/scripts/playwright/separate_openapi_schemas/image04.py
@@ -3,14 +3,17 @@ import subprocess
from playwright.sync_api import Playwright, sync_playwright
+# Run playwright codegen to generate the code below, copy paste the sections in run()
def run(playwright: Playwright) -> None:
browser = playwright.chromium.launch(headless=False)
+ # Update the viewport manually
context = browser.new_context(viewport={"width": 960, "height": 1080})
page = context.new_page()
page.goto("http://localhost:8000/docs")
page.get_by_role("button", name="Item-Input").click()
page.get_by_role("button", name="Item-Output").click()
page.set_viewport_size({"width": 960, "height": 820})
+ # Manually add the screenshot
page.screenshot(
path="docs/en/docs/img/tutorial/separate-openapi-schemas/image04.png"
)
diff --git a/scripts/playwright/separate_openapi_schemas/image05.py b/scripts/playwright/separate_openapi_schemas/image05.py
index 83966b449..0da5db0cf 100644
--- a/scripts/playwright/separate_openapi_schemas/image05.py
+++ b/scripts/playwright/separate_openapi_schemas/image05.py
@@ -3,13 +3,16 @@ import subprocess
from playwright.sync_api import Playwright, sync_playwright
+# Run playwright codegen to generate the code below, copy paste the sections in run()
def run(playwright: Playwright) -> None:
browser = playwright.chromium.launch(headless=False)
+ # Update the viewport manually
context = browser.new_context(viewport={"width": 960, "height": 1080})
page = context.new_page()
page.goto("http://localhost:8000/docs")
page.get_by_role("button", name="Item", exact=True).click()
page.set_viewport_size({"width": 960, "height": 700})
+ # Manually add the screenshot
page.screenshot(
path="docs/en/docs/img/tutorial/separate-openapi-schemas/image05.png"
)
From 0fc6e34135b2436a8749f5aa3b8f8ad92da106d5 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 13 Sep 2024 09:15:10 +0000
Subject: [PATCH 059/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6534adb03..f00c3fed3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -15,6 +15,7 @@ hide:
### Internal
+* 💡 Add comments with instructions for Playwright screenshot scripts. PR [#12193](https://github.com/fastapi/fastapi/pull/12193) by [@tiangolo](https://github.com/tiangolo).
* ➕ Add inline-snapshot for tests. PR [#12189](https://github.com/fastapi/fastapi/pull/12189) by [@tiangolo](https://github.com/tiangolo).
## 0.114.1
From 88d4f2cb1814392f54011b2bbd3fe55c5f2a3278 Mon Sep 17 00:00:00 2001
From: Nico Tonnhofer <github@wurstnase.de>
Date: Fri, 13 Sep 2024 11:51:00 +0200
Subject: [PATCH 060/504] =?UTF-8?q?=F0=9F=90=9B=20Fix=20form=20field=20reg?=
=?UTF-8?q?ression=20(#12194)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
fastapi/dependencies/utils.py | 2 +-
tests/test_forms_single_model.py | 10 +++++++---
2 files changed, 8 insertions(+), 4 deletions(-)
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index f18eace9d..7548cf0c7 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -788,7 +788,7 @@ async def _extract_form_body(
tg.start_soon(process_fn, sub_value.read)
value = serialize_sequence_value(field=field, value=results)
if value is not None:
- values[field.name] = value
+ values[field.alias] = value
for key, value in received_body.items():
if key not in values:
values[key] = value
diff --git a/tests/test_forms_single_model.py b/tests/test_forms_single_model.py
index 7ed3ba3a2..880ab3820 100644
--- a/tests/test_forms_single_model.py
+++ b/tests/test_forms_single_model.py
@@ -3,7 +3,7 @@ from typing import List, Optional
from dirty_equals import IsDict
from fastapi import FastAPI, Form
from fastapi.testclient import TestClient
-from pydantic import BaseModel
+from pydantic import BaseModel, Field
from typing_extensions import Annotated
app = FastAPI()
@@ -14,6 +14,7 @@ class FormModel(BaseModel):
lastname: str
age: Optional[int] = None
tags: List[str] = ["foo", "bar"]
+ alias_with: str = Field(alias="with", default="nothing")
@app.post("/form/")
@@ -32,6 +33,7 @@ def test_send_all_data():
"lastname": "Sanchez",
"age": "70",
"tags": ["plumbus", "citadel"],
+ "with": "something",
},
)
assert response.status_code == 200, response.text
@@ -40,6 +42,7 @@ def test_send_all_data():
"lastname": "Sanchez",
"age": 70,
"tags": ["plumbus", "citadel"],
+ "with": "something",
}
@@ -51,6 +54,7 @@ def test_defaults():
"lastname": "Sanchez",
"age": None,
"tags": ["foo", "bar"],
+ "with": "nothing",
}
@@ -100,13 +104,13 @@ def test_no_data():
"type": "missing",
"loc": ["body", "username"],
"msg": "Field required",
- "input": {"tags": ["foo", "bar"]},
+ "input": {"tags": ["foo", "bar"], "with": "nothing"},
},
{
"type": "missing",
"loc": ["body", "lastname"],
"msg": "Field required",
- "input": {"tags": ["foo", "bar"]},
+ "input": {"tags": ["foo", "bar"], "with": "nothing"},
},
]
}
From 3a5fd71f5596ad7437394597fc09f1b8e8ec73f2 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 13 Sep 2024 09:51:26 +0000
Subject: [PATCH 061/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f00c3fed3..9370a1f3f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Fixes
+
+* 🐛 Fix form field regression with `alias`. PR [#12194](https://github.com/fastapi/fastapi/pull/12194) by [@Wurstnase](https://github.com/Wurstnase).
+
### Translations
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/request-form-models.md`. PR [#12175](https://github.com/fastapi/fastapi/pull/12175) by [@ceb10n](https://github.com/ceb10n).
From 2ada1615a338a415a0ad7a9b879a1e7c09b9cce6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 13 Sep 2024 22:46:33 +0200
Subject: [PATCH 062/504] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
=?UTF-8?q?4.2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 2 ++
fastapi/__init__.py | 2 +-
2 files changed, 3 insertions(+), 1 deletion(-)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9370a1f3f..3f0b60fd3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
## Latest Changes
+## 0.114.2
+
### Fixes
* 🐛 Fix form field regression with `alias`. PR [#12194](https://github.com/fastapi/fastapi/pull/12194) by [@Wurstnase](https://github.com/Wurstnase).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index c2ed4859a..3925d3603 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
"""FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
-__version__ = "0.114.1"
+__version__ = "0.114.2"
from starlette import status as status
From 8eb3c5621ff2b946e7dd7a1a7ffd709e27de9ac6 Mon Sep 17 00:00:00 2001
From: Rafael de Oliveira Marques <rafaelomarques@gmail.com>
Date: Sun, 15 Sep 2024 16:04:17 -0300
Subject: [PATCH 063/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/security/http-basic-auth.?=
=?UTF-8?q?md`=20(#12195)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../docs/advanced/security/http-basic-auth.md | 192 ++++++++++++++++++
1 file changed, 192 insertions(+)
create mode 100644 docs/pt/docs/advanced/security/http-basic-auth.md
diff --git a/docs/pt/docs/advanced/security/http-basic-auth.md b/docs/pt/docs/advanced/security/http-basic-auth.md
new file mode 100644
index 000000000..12b8ab01c
--- /dev/null
+++ b/docs/pt/docs/advanced/security/http-basic-auth.md
@@ -0,0 +1,192 @@
+# HTTP Basic Auth
+
+Para os casos mais simples, você pode utilizar o HTTP Basic Auth.
+
+No HTTP Basic Auth, a aplicação espera um cabeçalho que contém um usuário e uma senha.
+
+Caso ela não receba, ela retorna um erro HTTP 401 "Unauthorized" (*Não Autorizado*).
+
+E retorna um cabeçalho `WWW-Authenticate` com o valor `Basic`, e um parâmetro opcional `realm`.
+
+Isso sinaliza ao navegador para mostrar o prompt integrado para um usuário e senha.
+
+Então, quando você digitar o usuário e senha, o navegador os envia automaticamente no cabeçalho.
+
+## HTTP Basic Auth Simples
+
+* Importe `HTTPBasic` e `HTTPBasicCredentials`.
+* Crie um "esquema `security`" utilizando `HTTPBasic`.
+* Utilize o `security` com uma dependência em sua *operação de rota*.
+* Isso retorna um objeto do tipo `HTTPBasicCredentials`:
+ * Isto contém o `username` e o `password` enviado.
+
+//// tab | Python 3.9+
+
+```Python hl_lines="4 8 12"
+{!> ../../../docs_src/security/tutorial006_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="2 7 11"
+{!> ../../../docs_src/security/tutorial006_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | "Dica"
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="2 6 10"
+{!> ../../../docs_src/security/tutorial006.py!}
+```
+
+////
+
+Quando você tentar abrir a URL pela primeira vez (ou clicar no botão "Executar" nos documentos) o navegador vai pedir pelo seu usuário e senha:
+
+<img src="/img/tutorial/security/image12.png">
+
+## Verifique o usuário
+
+Aqui está um exemplo mais completo.
+
+Utilize uma dependência para verificar se o usuário e a senha estão corretos.
+
+Para isso, utilize o módulo padrão do Python <a href="https://docs.python.org/3/library/secrets.html" class="external-link" target="_blank">`secrets`</a> para verificar o usuário e senha.
+
+O `secrets.compare_digest()` necessita receber `bytes` ou `str` que possuem apenas caracteres ASCII (os em Inglês). Isso significa que não funcionaria com caracteres como o `á`, como em `Sebastián`.
+
+Para lidar com isso, primeiramente nós convertemos o `username` e o `password` para `bytes`, codificando-os com UTF-8.
+
+Então nós podemos utilizar o `secrets.compare_digest()` para garantir que o `credentials.username` é `"stanleyjobson"`, e que o `credentials.password` é `"swordfish"`.
+
+//// tab | Python 3.9+
+
+```Python hl_lines="1 12-24"
+{!> ../../../docs_src/security/tutorial007_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1 12-24"
+{!> ../../../docs_src/security/tutorial007_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | "Dica"
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="1 11-21"
+{!> ../../../docs_src/security/tutorial007.py!}
+```
+
+////
+
+Isso seria parecido com:
+
+```Python
+if not (credentials.username == "stanleyjobson") or not (credentials.password == "swordfish"):
+ # Return some error
+ ...
+```
+
+Porém ao utilizar o `secrets.compare_digest()`, isso estará seguro contra um tipo de ataque chamado "ataque de temporização (timing attacks)".
+
+### Ataques de Temporização
+
+Mas o que é um "ataque de temporização"?
+
+Vamos imaginar que alguns invasores estão tentando adivinhar o usuário e a senha.
+
+E eles enviam uma requisição com um usuário `johndoe` e uma senha `love123`.
+
+Então o código Python em sua aplicação seria equivalente a algo como:
+
+```Python
+if "johndoe" == "stanleyjobson" and "love123" == "swordfish":
+ ...
+```
+
+Mas no exato momento que o Python compara o primeiro `j` em `johndoe` contra o primeiro `s` em `stanleyjobson`, ele retornará `False`, porque ele já sabe que aquelas duas strings não são a mesma, pensando que "não existe a necessidade de desperdiçar mais poder computacional comparando o resto das letras". E a sua aplicação dirá "Usuário ou senha incorretos".
+
+Mas então os invasores vão tentar com o usuário `stanleyjobsox` e a senha `love123`.
+
+E a sua aplicação faz algo como:
+
+```Python
+if "stanleyjobsox" == "stanleyjobson" and "love123" == "swordfish":
+ ...
+```
+
+O Python terá que comparar todo o `stanleyjobso` tanto em `stanleyjobsox` como em `stanleyjobson` antes de perceber que as strings não são a mesma. Então isso levará alguns microsegundos a mais para retornar "Usuário ou senha incorretos".
+
+#### O tempo para responder ajuda os invasores
+
+Neste ponto, ao perceber que o servidor demorou alguns microsegundos a mais para enviar o retorno "Usuário ou senha incorretos", os invasores irão saber que eles acertaram _alguma coisa_, algumas das letras iniciais estavam certas.
+
+E eles podem tentar de novo sabendo que provavelmente é algo mais parecido com `stanleyjobsox` do que com `johndoe`.
+
+#### Um ataque "profissional"
+
+Claro, os invasores não tentariam tudo isso de forma manual, eles escreveriam um programa para fazer isso, possivelmente com milhares ou milhões de testes por segundo. E obteriam apenas uma letra a mais por vez.
+
+Mas fazendo isso, em alguns minutos ou horas os invasores teriam adivinhado o usuário e senha corretos, com a "ajuda" da nossa aplicação, apenas usando o tempo levado para responder.
+
+#### Corrija com o `secrets.compare_digest()`
+
+Mas em nosso código nós estamos utilizando o `secrets.compare_digest()`.
+
+Resumindo, levará o mesmo tempo para comparar `stanleyjobsox` com `stanleyjobson` do que comparar `johndoe` com `stanleyjobson`. E o mesmo para a senha.
+
+Deste modo, ao utilizar `secrets.compare_digest()` no código de sua aplicação, ela esterá a salvo contra toda essa gama de ataques de segurança.
+
+
+### Retorne o erro
+
+Depois de detectar que as credenciais estão incorretas, retorne um `HTTPException` com o status 401 (o mesmo retornado quando nenhuma credencial foi informada) e adicione o cabeçalho `WWW-Authenticate` para fazer com que o navegador mostre o prompt de login novamente:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="26-30"
+{!> ../../../docs_src/security/tutorial007_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="26-30"
+{!> ../../../docs_src/security/tutorial007_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | "Dica"
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="23-27"
+{!> ../../../docs_src/security/tutorial007.py!}
+```
+
+////
From 35df20c79c8ce482c314934098e8875cf011c56e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 15 Sep 2024 19:04:38 +0000
Subject: [PATCH 064/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3f0b60fd3..7f5e86b30 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Translations
+
+* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/security/http-basic-auth.md`. PR [#12195](https://github.com/fastapi/fastapi/pull/12195) by [@ceb10n](https://github.com/ceb10n).
+
## 0.114.2
### Fixes
From 4b2b14a8e89a46a3c37dbf49746c5cd0e6f678f2 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
<66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 17 Sep 2024 00:00:09 +0200
Subject: [PATCH 065/504] =?UTF-8?q?=E2=AC=86=20[pre-commit.ci]=20pre-commi?=
=?UTF-8?q?t=20autoupdate=20(#12204)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
updates:
- [github.com/astral-sh/ruff-pre-commit: v0.6.4 → v0.6.5](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.4...v0.6.5)
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
.pre-commit-config.yaml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index f74816f12..4b1b10a68 100644
--- a/.pre-commit-config.yaml
+++ b/.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.6.4
+ rev: v0.6.5
hooks:
- id: ruff
args:
From 0903da78c9940b094e13732264b5e462a426e5cc Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 16 Sep 2024 22:00:35 +0000
Subject: [PATCH 066/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 7f5e86b30..d6d2a05b3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -11,6 +11,10 @@ hide:
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/security/http-basic-auth.md`. PR [#12195](https://github.com/fastapi/fastapi/pull/12195) by [@ceb10n](https://github.com/ceb10n).
+### Internal
+
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12204](https://github.com/fastapi/fastapi/pull/12204) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+
## 0.114.2
### Fixes
From 55035f440bf852f739e3ccd71b67034016ae9bba Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 17 Sep 2024 20:54:10 +0200
Subject: [PATCH 067/504] =?UTF-8?q?=E2=9C=A8=20Add=20support=20for=20Pydan?=
=?UTF-8?q?tic=20models=20for=20parameters=20using=20`Query`,=20`Cookie`,?=
=?UTF-8?q?=20`Header`=20(#12199)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../tutorial/cookie-param-models/image01.png | Bin 0 -> 45217 bytes
.../tutorial/header-param-models/image01.png | Bin 0 -> 62257 bytes
.../tutorial/query-param-models/image01.png | Bin 0 -> 45571 bytes
docs/en/docs/tutorial/cookie-param-models.md | 154 ++++++++++
docs/en/docs/tutorial/header-param-models.md | 184 ++++++++++++
docs/en/docs/tutorial/query-param-models.md | 196 ++++++++++++
docs/en/mkdocs.yml | 3 +
docs_src/cookie_param_models/tutorial001.py | 17 ++
.../cookie_param_models/tutorial001_an.py | 18 ++
.../tutorial001_an_py310.py | 17 ++
.../tutorial001_an_py39.py | 17 ++
.../cookie_param_models/tutorial001_py310.py | 15 +
docs_src/cookie_param_models/tutorial002.py | 19 ++
.../cookie_param_models/tutorial002_an.py | 20 ++
.../tutorial002_an_py310.py | 19 ++
.../tutorial002_an_py39.py | 19 ++
.../cookie_param_models/tutorial002_pv1.py | 20 ++
.../cookie_param_models/tutorial002_pv1_an.py | 21 ++
.../tutorial002_pv1_an_py310.py | 20 ++
.../tutorial002_pv1_an_py39.py | 20 ++
.../tutorial002_pv1_py310.py | 18 ++
.../cookie_param_models/tutorial002_py310.py | 17 ++
docs_src/header_param_models/tutorial001.py | 19 ++
.../header_param_models/tutorial001_an.py | 20 ++
.../tutorial001_an_py310.py | 19 ++
.../tutorial001_an_py39.py | 19 ++
.../header_param_models/tutorial001_py310.py | 17 ++
.../header_param_models/tutorial001_py39.py | 19 ++
docs_src/header_param_models/tutorial002.py | 21 ++
.../header_param_models/tutorial002_an.py | 22 ++
.../tutorial002_an_py310.py | 21 ++
.../tutorial002_an_py39.py | 21 ++
.../header_param_models/tutorial002_pv1.py | 22 ++
.../header_param_models/tutorial002_pv1_an.py | 23 ++
.../tutorial002_pv1_an_py310.py | 22 ++
.../tutorial002_pv1_an_py39.py | 22 ++
.../tutorial002_pv1_py310.py | 20 ++
.../tutorial002_pv1_py39.py | 22 ++
.../header_param_models/tutorial002_py310.py | 19 ++
.../header_param_models/tutorial002_py39.py | 21 ++
docs_src/query_param_models/tutorial001.py | 19 ++
docs_src/query_param_models/tutorial001_an.py | 19 ++
.../tutorial001_an_py310.py | 18 ++
.../query_param_models/tutorial001_an_py39.py | 17 ++
.../query_param_models/tutorial001_py310.py | 18 ++
.../query_param_models/tutorial001_py39.py | 17 ++
docs_src/query_param_models/tutorial002.py | 21 ++
docs_src/query_param_models/tutorial002_an.py | 21 ++
.../tutorial002_an_py310.py | 20 ++
.../query_param_models/tutorial002_an_py39.py | 19 ++
.../query_param_models/tutorial002_pv1.py | 22 ++
.../query_param_models/tutorial002_pv1_an.py | 22 ++
.../tutorial002_pv1_an_py310.py | 21 ++
.../tutorial002_pv1_an_py39.py | 20 ++
.../tutorial002_pv1_py310.py | 21 ++
.../tutorial002_pv1_py39.py | 20 ++
.../query_param_models/tutorial002_py310.py | 20 ++
.../query_param_models/tutorial002_py39.py | 19 ++
fastapi/dependencies/utils.py | 90 +++++-
fastapi/openapi/utils.py | 86 +++---
.../playwright/cookie_param_models/image01.py | 39 +++
.../playwright/header_param_models/image01.py | 38 +++
.../playwright/query_param_models/image01.py | 41 +++
.../test_cookie_param_models/__init__.py | 0
.../test_tutorial001.py | 205 +++++++++++++
.../test_tutorial002.py | 233 +++++++++++++++
.../test_header_param_models/__init__.py | 0
.../test_tutorial001.py | 238 +++++++++++++++
.../test_tutorial002.py | 249 ++++++++++++++++
.../test_query_param_models/__init__.py | 0
.../test_tutorial001.py | 260 ++++++++++++++++
.../test_tutorial002.py | 282 ++++++++++++++++++
72 files changed, 3253 insertions(+), 45 deletions(-)
create mode 100644 docs/en/docs/img/tutorial/cookie-param-models/image01.png
create mode 100644 docs/en/docs/img/tutorial/header-param-models/image01.png
create mode 100644 docs/en/docs/img/tutorial/query-param-models/image01.png
create mode 100644 docs/en/docs/tutorial/cookie-param-models.md
create mode 100644 docs/en/docs/tutorial/header-param-models.md
create mode 100644 docs/en/docs/tutorial/query-param-models.md
create mode 100644 docs_src/cookie_param_models/tutorial001.py
create mode 100644 docs_src/cookie_param_models/tutorial001_an.py
create mode 100644 docs_src/cookie_param_models/tutorial001_an_py310.py
create mode 100644 docs_src/cookie_param_models/tutorial001_an_py39.py
create mode 100644 docs_src/cookie_param_models/tutorial001_py310.py
create mode 100644 docs_src/cookie_param_models/tutorial002.py
create mode 100644 docs_src/cookie_param_models/tutorial002_an.py
create mode 100644 docs_src/cookie_param_models/tutorial002_an_py310.py
create mode 100644 docs_src/cookie_param_models/tutorial002_an_py39.py
create mode 100644 docs_src/cookie_param_models/tutorial002_pv1.py
create mode 100644 docs_src/cookie_param_models/tutorial002_pv1_an.py
create mode 100644 docs_src/cookie_param_models/tutorial002_pv1_an_py310.py
create mode 100644 docs_src/cookie_param_models/tutorial002_pv1_an_py39.py
create mode 100644 docs_src/cookie_param_models/tutorial002_pv1_py310.py
create mode 100644 docs_src/cookie_param_models/tutorial002_py310.py
create mode 100644 docs_src/header_param_models/tutorial001.py
create mode 100644 docs_src/header_param_models/tutorial001_an.py
create mode 100644 docs_src/header_param_models/tutorial001_an_py310.py
create mode 100644 docs_src/header_param_models/tutorial001_an_py39.py
create mode 100644 docs_src/header_param_models/tutorial001_py310.py
create mode 100644 docs_src/header_param_models/tutorial001_py39.py
create mode 100644 docs_src/header_param_models/tutorial002.py
create mode 100644 docs_src/header_param_models/tutorial002_an.py
create mode 100644 docs_src/header_param_models/tutorial002_an_py310.py
create mode 100644 docs_src/header_param_models/tutorial002_an_py39.py
create mode 100644 docs_src/header_param_models/tutorial002_pv1.py
create mode 100644 docs_src/header_param_models/tutorial002_pv1_an.py
create mode 100644 docs_src/header_param_models/tutorial002_pv1_an_py310.py
create mode 100644 docs_src/header_param_models/tutorial002_pv1_an_py39.py
create mode 100644 docs_src/header_param_models/tutorial002_pv1_py310.py
create mode 100644 docs_src/header_param_models/tutorial002_pv1_py39.py
create mode 100644 docs_src/header_param_models/tutorial002_py310.py
create mode 100644 docs_src/header_param_models/tutorial002_py39.py
create mode 100644 docs_src/query_param_models/tutorial001.py
create mode 100644 docs_src/query_param_models/tutorial001_an.py
create mode 100644 docs_src/query_param_models/tutorial001_an_py310.py
create mode 100644 docs_src/query_param_models/tutorial001_an_py39.py
create mode 100644 docs_src/query_param_models/tutorial001_py310.py
create mode 100644 docs_src/query_param_models/tutorial001_py39.py
create mode 100644 docs_src/query_param_models/tutorial002.py
create mode 100644 docs_src/query_param_models/tutorial002_an.py
create mode 100644 docs_src/query_param_models/tutorial002_an_py310.py
create mode 100644 docs_src/query_param_models/tutorial002_an_py39.py
create mode 100644 docs_src/query_param_models/tutorial002_pv1.py
create mode 100644 docs_src/query_param_models/tutorial002_pv1_an.py
create mode 100644 docs_src/query_param_models/tutorial002_pv1_an_py310.py
create mode 100644 docs_src/query_param_models/tutorial002_pv1_an_py39.py
create mode 100644 docs_src/query_param_models/tutorial002_pv1_py310.py
create mode 100644 docs_src/query_param_models/tutorial002_pv1_py39.py
create mode 100644 docs_src/query_param_models/tutorial002_py310.py
create mode 100644 docs_src/query_param_models/tutorial002_py39.py
create mode 100644 scripts/playwright/cookie_param_models/image01.py
create mode 100644 scripts/playwright/header_param_models/image01.py
create mode 100644 scripts/playwright/query_param_models/image01.py
create mode 100644 tests/test_tutorial/test_cookie_param_models/__init__.py
create mode 100644 tests/test_tutorial/test_cookie_param_models/test_tutorial001.py
create mode 100644 tests/test_tutorial/test_cookie_param_models/test_tutorial002.py
create mode 100644 tests/test_tutorial/test_header_param_models/__init__.py
create mode 100644 tests/test_tutorial/test_header_param_models/test_tutorial001.py
create mode 100644 tests/test_tutorial/test_header_param_models/test_tutorial002.py
create mode 100644 tests/test_tutorial/test_query_param_models/__init__.py
create mode 100644 tests/test_tutorial/test_query_param_models/test_tutorial001.py
create mode 100644 tests/test_tutorial/test_query_param_models/test_tutorial002.py
diff --git a/docs/en/docs/img/tutorial/cookie-param-models/image01.png b/docs/en/docs/img/tutorial/cookie-param-models/image01.png
new file mode 100644
index 0000000000000000000000000000000000000000..85c370f80a42e52768a412c066e686e4f2773ccd
GIT binary patch
literal 45217
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
literal 0
HcmV?d00001
diff --git a/docs/en/docs/img/tutorial/header-param-models/image01.png b/docs/en/docs/img/tutorial/header-param-models/image01.png
new file mode 100644
index 0000000000000000000000000000000000000000..849dea3d8b6fd9a857065208bb49ef7d33fa1568
GIT binary patch
literal 62257
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	TT)vm_&h-i@{l=?q3#J@QQqf?x
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
B?=t`Z
literal 0
HcmV?d00001
diff --git a/docs/en/docs/img/tutorial/query-param-models/image01.png b/docs/en/docs/img/tutorial/query-param-models/image01.png
new file mode 100644
index 0000000000000000000000000000000000000000..e7a61b61fb4f66857abe4b63aea3e901efd7482c
GIT binary patch
literal 45571
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%0A>3X(
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
literal 0
HcmV?d00001
diff --git a/docs/en/docs/tutorial/cookie-param-models.md b/docs/en/docs/tutorial/cookie-param-models.md
new file mode 100644
index 000000000..2aa3a1f59
--- /dev/null
+++ b/docs/en/docs/tutorial/cookie-param-models.md
@@ -0,0 +1,154 @@
+# Cookie Parameter Models
+
+If you have a group of **cookies** that are related, you can create a **Pydantic model** to declare them. 🍪
+
+This would allow you to **re-use the model** in **multiple places** and also to declare validations and metadata for all the parameters at once. 😎
+
+/// note
+
+This is supported since FastAPI version `0.115.0`. 🤓
+
+///
+
+/// tip
+
+This same technique applies to `Query`, `Cookie`, and `Header`. 😎
+
+///
+
+## Cookies with a Pydantic Model
+
+Declare the **cookie** parameters that you need in a **Pydantic model**, and then declare the parameter as `Cookie`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="9-12 16"
+{!> ../../../docs_src/cookie_param_models/tutorial001_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9-12 16"
+{!> ../../../docs_src/cookie_param_models/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="10-13 17"
+{!> ../../../docs_src/cookie_param_models/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="7-10 14"
+{!> ../../../docs_src/cookie_param_models/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="9-12 16"
+{!> ../../../docs_src/cookie_param_models/tutorial001.py!}
+```
+
+////
+
+**FastAPI** will **extract** the data for **each field** from the **cookies** received in the request and give you the Pydantic model you defined.
+
+## Check the Docs
+
+You can see the defined cookies in the docs UI at `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/cookie-param-models/image01.png">
+</div>
+
+/// info
+
+Have in mind that, as **browsers handle cookies** in special ways and behind the scenes, they **don't** easily allow **JavaScript** to touch them.
+
+If you go to the **API docs UI** at `/docs` you will be able to see the **documentation** for cookies for your *path operations*.
+
+But even if you **fill the data** and click "Execute", because the docs UI works with **JavaScript**, the cookies won't be sent, and you will see an **error** message as if you didn't write any values.
+
+///
+
+## Forbid Extra Cookies
+
+In some special use cases (probably not very common), you might want to **restrict** the cookies that you want to receive.
+
+Your API now has the power to control its own <abbr title="This is a joke, just in case. It has nothing to do with cookie consents, but it's funny that even the API can now reject the poor cookies. Have a cookie. 🍪">cookie consent</abbr>. 🤪🍪
+
+You can use Pydantic's model configuration to `forbid` any `extra` fields:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="10"
+{!> ../../../docs_src/cookie_param_models/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../../docs_src/cookie_param_models/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="10"
+{!> ../../../docs_src/cookie_param_models/tutorial002.py!}
+```
+
+////
+
+If a client tries to send some **extra cookies**, they will receive an **error** response.
+
+Poor cookie banners with all their effort to get your consent for the <abbr title="This is another joke. Don't pay attention to me. Have some coffee for your cookie. ☕">API to reject it</abbr>. 🍪
+
+For example, if the client tries to send a `santa_tracker` cookie with a value of `good-list-please`, the client will receive an **error** response telling them that the `santa_tracker` <abbr title="Santa disapproves the lack of cookies. 🎅 Okay, no more cookie jokes.">cookie is not allowed</abbr>:
+
+```json
+{
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["cookie", "santa_tracker"],
+ "msg": "Extra inputs are not permitted",
+ "input": "good-list-please",
+ }
+ ]
+}
+```
+
+## Summary
+
+You can use **Pydantic models** to declare <abbr title="Have a last cookie before you go. 🍪">**cookies**</abbr> in **FastAPI**. 😎
diff --git a/docs/en/docs/tutorial/header-param-models.md b/docs/en/docs/tutorial/header-param-models.md
new file mode 100644
index 000000000..8deb0a455
--- /dev/null
+++ b/docs/en/docs/tutorial/header-param-models.md
@@ -0,0 +1,184 @@
+# Header Parameter Models
+
+If you have a group of related **header parameters**, you can create a **Pydantic model** to declare them.
+
+This would allow you to **re-use the model** in **multiple places** and also to declare validations and metadata for all the parameters at once. 😎
+
+/// note
+
+This is supported since FastAPI version `0.115.0`. 🤓
+
+///
+
+## Header Parameters with a Pydantic Model
+
+Declare the **header parameters** that you need in a **Pydantic model**, and then declare the parameter as `Header`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="9-14 18"
+{!> ../../../docs_src/header_param_models/tutorial001_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9-14 18"
+{!> ../../../docs_src/header_param_models/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="10-15 19"
+{!> ../../../docs_src/header_param_models/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="7-12 16"
+{!> ../../../docs_src/header_param_models/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="9-14 18"
+{!> ../../../docs_src/header_param_models/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="7-12 16"
+{!> ../../../docs_src/header_param_models/tutorial001_py310.py!}
+```
+
+////
+
+**FastAPI** will **extract** the data for **each field** from the **headers** in the request and give you the Pydantic model you defined.
+
+## Check the Docs
+
+You can see the required headers in the docs UI at `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/header-param-models/image01.png">
+</div>
+
+## Forbid Extra Headers
+
+In some special use cases (probably not very common), you might want to **restrict** the headers that you want to receive.
+
+You can use Pydantic's model configuration to `forbid` any `extra` fields:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="10"
+{!> ../../../docs_src/header_param_models/tutorial002_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="10"
+{!> ../../../docs_src/header_param_models/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../../docs_src/header_param_models/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="8"
+{!> ../../../docs_src/header_param_models/tutorial002_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="10"
+{!> ../../../docs_src/header_param_models/tutorial002_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="10"
+{!> ../../../docs_src/header_param_models/tutorial002.py!}
+```
+
+////
+
+If a client tries to send some **extra headers**, they will receive an **error** response.
+
+For example, if the client tries to send a `tool` header with a value of `plumbus`, they will receive an **error** response telling them that the header parameter `tool` is not allowed:
+
+```json
+{
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["header", "tool"],
+ "msg": "Extra inputs are not permitted",
+ "input": "plumbus",
+ }
+ ]
+}
+```
+
+## Summary
+
+You can use **Pydantic models** to declare **headers** in **FastAPI**. 😎
diff --git a/docs/en/docs/tutorial/query-param-models.md b/docs/en/docs/tutorial/query-param-models.md
new file mode 100644
index 000000000..02e36dc0f
--- /dev/null
+++ b/docs/en/docs/tutorial/query-param-models.md
@@ -0,0 +1,196 @@
+# Query Parameter Models
+
+If you have a group of **query parameters** that are related, you can create a **Pydantic model** to declare them.
+
+This would allow you to **re-use the model** in **multiple places** and also to declare validations and metadata for all the parameters at once. 😎
+
+/// note
+
+This is supported since FastAPI version `0.115.0`. 🤓
+
+///
+
+## Query Parameters with a Pydantic Model
+
+Declare the **query parameters** that you need in a **Pydantic model**, and then declare the parameter as `Query`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="9-13 17"
+{!> ../../../docs_src/query_param_models/tutorial001_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="8-12 16"
+{!> ../../../docs_src/query_param_models/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="10-14 18"
+{!> ../../../docs_src/query_param_models/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="9-13 17"
+{!> ../../../docs_src/query_param_models/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="8-12 16"
+{!> ../../../docs_src/query_param_models/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="9-13 17"
+{!> ../../../docs_src/query_param_models/tutorial001_py310.py!}
+```
+
+////
+
+**FastAPI** will **extract** the data for **each field** from the **query parameters** in the request and give you the Pydantic model you defined.
+
+## Check the Docs
+
+You can see the query parameters in the docs UI at `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/query-param-models/image01.png">
+</div>
+
+## Forbid Extra Query Parameters
+
+In some special use cases (probably not very common), you might want to **restrict** the query parameters that you want to receive.
+
+You can use Pydantic's model configuration to `forbid` any `extra` fields:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="10"
+{!> ../../../docs_src/query_param_models/tutorial002_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9"
+{!> ../../../docs_src/query_param_models/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../../docs_src/query_param_models/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="10"
+{!> ../../../docs_src/query_param_models/tutorial002_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="9"
+{!> ../../../docs_src/query_param_models/tutorial002_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip
+
+Prefer to use the `Annotated` version if possible.
+
+///
+
+```Python hl_lines="11"
+{!> ../../../docs_src/query_param_models/tutorial002.py!}
+```
+
+////
+
+If a client tries to send some **extra** data in the **query parameters**, they will receive an **error** response.
+
+For example, if the client tries to send a `tool` query parameter with a value of `plumbus`, like:
+
+```http
+https://example.com/items/?limit=10&tool=plumbus
+```
+
+They will receive an **error** response telling them that the query parameter `tool` is not allowed:
+
+```json
+{
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["query", "tool"],
+ "msg": "Extra inputs are not permitted",
+ "input": "plumbus"
+ }
+ ]
+}
+```
+
+## Summary
+
+You can use **Pydantic models** to declare **query parameters** in **FastAPI**. 😎
+
+/// tip
+
+Spoiler alert: you can also use Pydantic models to declare cookies and headers, but you will read about that later in the tutorial. 🤫
+
+///
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 7c810c2d7..5161b891b 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -118,6 +118,7 @@ nav:
- tutorial/body.md
- tutorial/query-params-str-validations.md
- tutorial/path-params-numeric-validations.md
+ - tutorial/query-param-models.md
- tutorial/body-multiple-params.md
- tutorial/body-fields.md
- tutorial/body-nested-models.md
@@ -125,6 +126,8 @@ nav:
- tutorial/extra-data-types.md
- tutorial/cookie-params.md
- tutorial/header-params.md
+ - tutorial/cookie-param-models.md
+ - tutorial/header-param-models.md
- tutorial/response-model.md
- tutorial/extra-models.md
- tutorial/response-status-code.md
diff --git a/docs_src/cookie_param_models/tutorial001.py b/docs_src/cookie_param_models/tutorial001.py
new file mode 100644
index 000000000..cc65c43e1
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial001.py
@@ -0,0 +1,17 @@
+from typing import Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ session_id: str
+ fatebook_tracker: Union[str, None] = None
+ googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Cookies = Cookie()):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial001_an.py b/docs_src/cookie_param_models/tutorial001_an.py
new file mode 100644
index 000000000..e5839ffd5
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial001_an.py
@@ -0,0 +1,18 @@
+from typing import Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ session_id: str
+ fatebook_tracker: Union[str, None] = None
+ googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial001_an_py310.py b/docs_src/cookie_param_models/tutorial001_an_py310.py
new file mode 100644
index 000000000..24cc889a9
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial001_an_py310.py
@@ -0,0 +1,17 @@
+from typing import Annotated
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ session_id: str
+ fatebook_tracker: str | None = None
+ googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial001_an_py39.py b/docs_src/cookie_param_models/tutorial001_an_py39.py
new file mode 100644
index 000000000..3d90c2007
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial001_an_py39.py
@@ -0,0 +1,17 @@
+from typing import Annotated, Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ session_id: str
+ fatebook_tracker: Union[str, None] = None
+ googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial001_py310.py b/docs_src/cookie_param_models/tutorial001_py310.py
new file mode 100644
index 000000000..7cdee5a92
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial001_py310.py
@@ -0,0 +1,15 @@
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ session_id: str
+ fatebook_tracker: str | None = None
+ googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Cookies = Cookie()):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial002.py b/docs_src/cookie_param_models/tutorial002.py
new file mode 100644
index 000000000..9679e890f
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002.py
@@ -0,0 +1,19 @@
+from typing import Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ session_id: str
+ fatebook_tracker: Union[str, None] = None
+ googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Cookies = Cookie()):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_an.py b/docs_src/cookie_param_models/tutorial002_an.py
new file mode 100644
index 000000000..ce5644b7b
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_an.py
@@ -0,0 +1,20 @@
+from typing import Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ session_id: str
+ fatebook_tracker: Union[str, None] = None
+ googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_an_py310.py b/docs_src/cookie_param_models/tutorial002_an_py310.py
new file mode 100644
index 000000000..7fa70fe92
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_an_py310.py
@@ -0,0 +1,19 @@
+from typing import Annotated
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ session_id: str
+ fatebook_tracker: str | None = None
+ googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_an_py39.py b/docs_src/cookie_param_models/tutorial002_an_py39.py
new file mode 100644
index 000000000..a906ce6a1
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_an_py39.py
@@ -0,0 +1,19 @@
+from typing import Annotated, Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ session_id: str
+ fatebook_tracker: Union[str, None] = None
+ googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_pv1.py b/docs_src/cookie_param_models/tutorial002_pv1.py
new file mode 100644
index 000000000..13f78b850
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_pv1.py
@@ -0,0 +1,20 @@
+from typing import Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ session_id: str
+ fatebook_tracker: Union[str, None] = None
+ googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Cookies = Cookie()):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_pv1_an.py b/docs_src/cookie_param_models/tutorial002_pv1_an.py
new file mode 100644
index 000000000..ddfda9b6f
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_pv1_an.py
@@ -0,0 +1,21 @@
+from typing import Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ session_id: str
+ fatebook_tracker: Union[str, None] = None
+ googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_pv1_an_py310.py b/docs_src/cookie_param_models/tutorial002_pv1_an_py310.py
new file mode 100644
index 000000000..ac00360b6
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_pv1_an_py310.py
@@ -0,0 +1,20 @@
+from typing import Annotated
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ session_id: str
+ fatebook_tracker: str | None = None
+ googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_pv1_an_py39.py b/docs_src/cookie_param_models/tutorial002_pv1_an_py39.py
new file mode 100644
index 000000000..573caea4b
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_pv1_an_py39.py
@@ -0,0 +1,20 @@
+from typing import Annotated, Union
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ session_id: str
+ fatebook_tracker: Union[str, None] = None
+ googall_tracker: Union[str, None] = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_pv1_py310.py b/docs_src/cookie_param_models/tutorial002_pv1_py310.py
new file mode 100644
index 000000000..2c59aad12
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_pv1_py310.py
@@ -0,0 +1,18 @@
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ session_id: str
+ fatebook_tracker: str | None = None
+ googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Cookies = Cookie()):
+ return cookies
diff --git a/docs_src/cookie_param_models/tutorial002_py310.py b/docs_src/cookie_param_models/tutorial002_py310.py
new file mode 100644
index 000000000..f011aa1af
--- /dev/null
+++ b/docs_src/cookie_param_models/tutorial002_py310.py
@@ -0,0 +1,17 @@
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ session_id: str
+ fatebook_tracker: str | None = None
+ googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Cookies = Cookie()):
+ return cookies
diff --git a/docs_src/header_param_models/tutorial001.py b/docs_src/header_param_models/tutorial001.py
new file mode 100644
index 000000000..4caaba87b
--- /dev/null
+++ b/docs_src/header_param_models/tutorial001.py
@@ -0,0 +1,19 @@
+from typing import List, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ host: str
+ save_data: bool
+ if_modified_since: Union[str, None] = None
+ traceparent: Union[str, None] = None
+ x_tag: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+ return headers
diff --git a/docs_src/header_param_models/tutorial001_an.py b/docs_src/header_param_models/tutorial001_an.py
new file mode 100644
index 000000000..b55c6b56b
--- /dev/null
+++ b/docs_src/header_param_models/tutorial001_an.py
@@ -0,0 +1,20 @@
+from typing import List, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ host: str
+ save_data: bool
+ if_modified_since: Union[str, None] = None
+ traceparent: Union[str, None] = None
+ x_tag: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+ return headers
diff --git a/docs_src/header_param_models/tutorial001_an_py310.py b/docs_src/header_param_models/tutorial001_an_py310.py
new file mode 100644
index 000000000..acfb6b9bf
--- /dev/null
+++ b/docs_src/header_param_models/tutorial001_an_py310.py
@@ -0,0 +1,19 @@
+from typing import Annotated
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ host: str
+ save_data: bool
+ if_modified_since: str | None = None
+ traceparent: str | None = None
+ x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+ return headers
diff --git a/docs_src/header_param_models/tutorial001_an_py39.py b/docs_src/header_param_models/tutorial001_an_py39.py
new file mode 100644
index 000000000..51a5f94fc
--- /dev/null
+++ b/docs_src/header_param_models/tutorial001_an_py39.py
@@ -0,0 +1,19 @@
+from typing import Annotated, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ host: str
+ save_data: bool
+ if_modified_since: Union[str, None] = None
+ traceparent: Union[str, None] = None
+ x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+ return headers
diff --git a/docs_src/header_param_models/tutorial001_py310.py b/docs_src/header_param_models/tutorial001_py310.py
new file mode 100644
index 000000000..7239c64ce
--- /dev/null
+++ b/docs_src/header_param_models/tutorial001_py310.py
@@ -0,0 +1,17 @@
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ host: str
+ save_data: bool
+ if_modified_since: str | None = None
+ traceparent: str | None = None
+ x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+ return headers
diff --git a/docs_src/header_param_models/tutorial001_py39.py b/docs_src/header_param_models/tutorial001_py39.py
new file mode 100644
index 000000000..4c1137813
--- /dev/null
+++ b/docs_src/header_param_models/tutorial001_py39.py
@@ -0,0 +1,19 @@
+from typing import Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ host: str
+ save_data: bool
+ if_modified_since: Union[str, None] = None
+ traceparent: Union[str, None] = None
+ x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+ return headers
diff --git a/docs_src/header_param_models/tutorial002.py b/docs_src/header_param_models/tutorial002.py
new file mode 100644
index 000000000..3f9aac58d
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002.py
@@ -0,0 +1,21 @@
+from typing import List, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ host: str
+ save_data: bool
+ if_modified_since: Union[str, None] = None
+ traceparent: Union[str, None] = None
+ x_tag: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+ return headers
diff --git a/docs_src/header_param_models/tutorial002_an.py b/docs_src/header_param_models/tutorial002_an.py
new file mode 100644
index 000000000..771135d77
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_an.py
@@ -0,0 +1,22 @@
+from typing import List, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ host: str
+ save_data: bool
+ if_modified_since: Union[str, None] = None
+ traceparent: Union[str, None] = None
+ x_tag: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+ return headers
diff --git a/docs_src/header_param_models/tutorial002_an_py310.py b/docs_src/header_param_models/tutorial002_an_py310.py
new file mode 100644
index 000000000..e9535f045
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_an_py310.py
@@ -0,0 +1,21 @@
+from typing import Annotated
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ host: str
+ save_data: bool
+ if_modified_since: str | None = None
+ traceparent: str | None = None
+ x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+ return headers
diff --git a/docs_src/header_param_models/tutorial002_an_py39.py b/docs_src/header_param_models/tutorial002_an_py39.py
new file mode 100644
index 000000000..ca5208c9d
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_an_py39.py
@@ -0,0 +1,21 @@
+from typing import Annotated, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ host: str
+ save_data: bool
+ if_modified_since: Union[str, None] = None
+ traceparent: Union[str, None] = None
+ x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+ return headers
diff --git a/docs_src/header_param_models/tutorial002_pv1.py b/docs_src/header_param_models/tutorial002_pv1.py
new file mode 100644
index 000000000..7e56cd993
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_pv1.py
@@ -0,0 +1,22 @@
+from typing import List, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ host: str
+ save_data: bool
+ if_modified_since: Union[str, None] = None
+ traceparent: Union[str, None] = None
+ x_tag: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+ return headers
diff --git a/docs_src/header_param_models/tutorial002_pv1_an.py b/docs_src/header_param_models/tutorial002_pv1_an.py
new file mode 100644
index 000000000..236778231
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_pv1_an.py
@@ -0,0 +1,23 @@
+from typing import List, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ host: str
+ save_data: bool
+ if_modified_since: Union[str, None] = None
+ traceparent: Union[str, None] = None
+ x_tag: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+ return headers
diff --git a/docs_src/header_param_models/tutorial002_pv1_an_py310.py b/docs_src/header_param_models/tutorial002_pv1_an_py310.py
new file mode 100644
index 000000000..e99e24ea5
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_pv1_an_py310.py
@@ -0,0 +1,22 @@
+from typing import Annotated
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ host: str
+ save_data: bool
+ if_modified_since: str | None = None
+ traceparent: str | None = None
+ x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+ return headers
diff --git a/docs_src/header_param_models/tutorial002_pv1_an_py39.py b/docs_src/header_param_models/tutorial002_pv1_an_py39.py
new file mode 100644
index 000000000..18398b726
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_pv1_an_py39.py
@@ -0,0 +1,22 @@
+from typing import Annotated, Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ host: str
+ save_data: bool
+ if_modified_since: Union[str, None] = None
+ traceparent: Union[str, None] = None
+ x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+ return headers
diff --git a/docs_src/header_param_models/tutorial002_pv1_py310.py b/docs_src/header_param_models/tutorial002_pv1_py310.py
new file mode 100644
index 000000000..3dbff9d7b
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_pv1_py310.py
@@ -0,0 +1,20 @@
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ host: str
+ save_data: bool
+ if_modified_since: str | None = None
+ traceparent: str | None = None
+ x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+ return headers
diff --git a/docs_src/header_param_models/tutorial002_pv1_py39.py b/docs_src/header_param_models/tutorial002_pv1_py39.py
new file mode 100644
index 000000000..86e19be0d
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_pv1_py39.py
@@ -0,0 +1,22 @@
+from typing import Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ host: str
+ save_data: bool
+ if_modified_since: Union[str, None] = None
+ traceparent: Union[str, None] = None
+ x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+ return headers
diff --git a/docs_src/header_param_models/tutorial002_py310.py b/docs_src/header_param_models/tutorial002_py310.py
new file mode 100644
index 000000000..3d2296345
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_py310.py
@@ -0,0 +1,19 @@
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ host: str
+ save_data: bool
+ if_modified_since: str | None = None
+ traceparent: str | None = None
+ x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+ return headers
diff --git a/docs_src/header_param_models/tutorial002_py39.py b/docs_src/header_param_models/tutorial002_py39.py
new file mode 100644
index 000000000..f8ce559a7
--- /dev/null
+++ b/docs_src/header_param_models/tutorial002_py39.py
@@ -0,0 +1,21 @@
+from typing import Union
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ host: str
+ save_data: bool
+ if_modified_since: Union[str, None] = None
+ traceparent: Union[str, None] = None
+ x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: CommonHeaders = Header()):
+ return headers
diff --git a/docs_src/query_param_models/tutorial001.py b/docs_src/query_param_models/tutorial001.py
new file mode 100644
index 000000000..0c0ab315e
--- /dev/null
+++ b/docs_src/query_param_models/tutorial001.py
@@ -0,0 +1,19 @@
+from typing import List
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial001_an.py b/docs_src/query_param_models/tutorial001_an.py
new file mode 100644
index 000000000..28375057c
--- /dev/null
+++ b/docs_src/query_param_models/tutorial001_an.py
@@ -0,0 +1,19 @@
+from typing import List
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Annotated, Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial001_an_py310.py b/docs_src/query_param_models/tutorial001_an_py310.py
new file mode 100644
index 000000000..71427acae
--- /dev/null
+++ b/docs_src/query_param_models/tutorial001_an_py310.py
@@ -0,0 +1,18 @@
+from typing import Annotated, Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial001_an_py39.py b/docs_src/query_param_models/tutorial001_an_py39.py
new file mode 100644
index 000000000..ba690d3e3
--- /dev/null
+++ b/docs_src/query_param_models/tutorial001_an_py39.py
@@ -0,0 +1,17 @@
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Annotated, Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial001_py310.py b/docs_src/query_param_models/tutorial001_py310.py
new file mode 100644
index 000000000..3ebf9f4d7
--- /dev/null
+++ b/docs_src/query_param_models/tutorial001_py310.py
@@ -0,0 +1,18 @@
+from typing import Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial001_py39.py b/docs_src/query_param_models/tutorial001_py39.py
new file mode 100644
index 000000000..54b52a054
--- /dev/null
+++ b/docs_src/query_param_models/tutorial001_py39.py
@@ -0,0 +1,17 @@
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial002.py b/docs_src/query_param_models/tutorial002.py
new file mode 100644
index 000000000..1633bc464
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002.py
@@ -0,0 +1,21 @@
+from typing import List
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial002_an.py b/docs_src/query_param_models/tutorial002_an.py
new file mode 100644
index 000000000..69705d4b4
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_an.py
@@ -0,0 +1,21 @@
+from typing import List
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Annotated, Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial002_an_py310.py b/docs_src/query_param_models/tutorial002_an_py310.py
new file mode 100644
index 000000000..975956502
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_an_py310.py
@@ -0,0 +1,20 @@
+from typing import Annotated, Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial002_an_py39.py b/docs_src/query_param_models/tutorial002_an_py39.py
new file mode 100644
index 000000000..2d4c1a62b
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_an_py39.py
@@ -0,0 +1,19 @@
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Annotated, Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial002_pv1.py b/docs_src/query_param_models/tutorial002_pv1.py
new file mode 100644
index 000000000..71ccd961d
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_pv1.py
@@ -0,0 +1,22 @@
+from typing import List
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial002_pv1_an.py b/docs_src/query_param_models/tutorial002_pv1_an.py
new file mode 100644
index 000000000..1dd29157a
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_pv1_an.py
@@ -0,0 +1,22 @@
+from typing import List
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Annotated, Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: List[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial002_pv1_an_py310.py b/docs_src/query_param_models/tutorial002_pv1_an_py310.py
new file mode 100644
index 000000000..d635aae88
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_pv1_an_py310.py
@@ -0,0 +1,21 @@
+from typing import Annotated, Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial002_pv1_an_py39.py b/docs_src/query_param_models/tutorial002_pv1_an_py39.py
new file mode 100644
index 000000000..494fef11f
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_pv1_an_py39.py
@@ -0,0 +1,20 @@
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Annotated, Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial002_pv1_py310.py b/docs_src/query_param_models/tutorial002_pv1_py310.py
new file mode 100644
index 000000000..9ffdeefc0
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_pv1_py310.py
@@ -0,0 +1,21 @@
+from typing import Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial002_pv1_py39.py b/docs_src/query_param_models/tutorial002_pv1_py39.py
new file mode 100644
index 000000000..7fa456a79
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_pv1_py39.py
@@ -0,0 +1,20 @@
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ class Config:
+ extra = "forbid"
+
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial002_py310.py b/docs_src/query_param_models/tutorial002_py310.py
new file mode 100644
index 000000000..6ec418499
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_py310.py
@@ -0,0 +1,20 @@
+from typing import Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+ return filter_query
diff --git a/docs_src/query_param_models/tutorial002_py39.py b/docs_src/query_param_models/tutorial002_py39.py
new file mode 100644
index 000000000..f9bba028c
--- /dev/null
+++ b/docs_src/query_param_models/tutorial002_py39.py
@@ -0,0 +1,19 @@
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+from typing_extensions import Literal
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: FilterParams = Query()):
+ return filter_query
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 7548cf0c7..5cebbf00f 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -201,14 +201,23 @@ def get_flat_dependant(
return flat_dependant
+def _get_flat_fields_from_params(fields: List[ModelField]) -> List[ModelField]:
+ if not fields:
+ return fields
+ first_field = fields[0]
+ if len(fields) == 1 and lenient_issubclass(first_field.type_, BaseModel):
+ fields_to_extract = get_cached_model_fields(first_field.type_)
+ return fields_to_extract
+ return fields
+
+
def get_flat_params(dependant: Dependant) -> List[ModelField]:
flat_dependant = get_flat_dependant(dependant, skip_repeats=True)
- return (
- flat_dependant.path_params
- + flat_dependant.query_params
- + flat_dependant.header_params
- + flat_dependant.cookie_params
- )
+ path_params = _get_flat_fields_from_params(flat_dependant.path_params)
+ query_params = _get_flat_fields_from_params(flat_dependant.query_params)
+ header_params = _get_flat_fields_from_params(flat_dependant.header_params)
+ cookie_params = _get_flat_fields_from_params(flat_dependant.cookie_params)
+ return path_params + query_params + header_params + cookie_params
def get_typed_signature(call: Callable[..., Any]) -> inspect.Signature:
@@ -479,7 +488,15 @@ def analyze_param(
field=field
), "Path params must be of one of the supported types"
elif isinstance(field_info, params.Query):
- assert is_scalar_field(field) or is_scalar_sequence_field(field)
+ assert (
+ is_scalar_field(field)
+ or is_scalar_sequence_field(field)
+ or (
+ lenient_issubclass(field.type_, BaseModel)
+ # For Pydantic v1
+ and getattr(field, "shape", 1) == 1
+ )
+ )
return ParamDetails(type_annotation=type_annotation, depends=depends, field=field)
@@ -686,11 +703,14 @@ def _validate_value_with_model_field(
return v_, []
-def _get_multidict_value(field: ModelField, values: Mapping[str, Any]) -> Any:
+def _get_multidict_value(
+ field: ModelField, values: Mapping[str, Any], alias: Union[str, None] = None
+) -> Any:
+ alias = alias or field.alias
if is_sequence_field(field) and isinstance(values, (ImmutableMultiDict, Headers)):
- value = values.getlist(field.alias)
+ value = values.getlist(alias)
else:
- value = values.get(field.alias, None)
+ value = values.get(alias, None)
if (
value is None
or (
@@ -712,7 +732,55 @@ def request_params_to_args(
received_params: Union[Mapping[str, Any], QueryParams, Headers],
) -> Tuple[Dict[str, Any], List[Any]]:
values: Dict[str, Any] = {}
- errors = []
+ errors: List[Dict[str, Any]] = []
+
+ if not fields:
+ return values, errors
+
+ first_field = fields[0]
+ fields_to_extract = fields
+ single_not_embedded_field = False
+ if len(fields) == 1 and lenient_issubclass(first_field.type_, BaseModel):
+ fields_to_extract = get_cached_model_fields(first_field.type_)
+ single_not_embedded_field = True
+
+ params_to_process: Dict[str, Any] = {}
+
+ processed_keys = set()
+
+ for field in fields_to_extract:
+ alias = None
+ if isinstance(received_params, Headers):
+ # Handle fields extracted from a Pydantic Model for a header, each field
+ # doesn't have a FieldInfo of type Header with the default convert_underscores=True
+ convert_underscores = getattr(field.field_info, "convert_underscores", True)
+ if convert_underscores:
+ alias = (
+ field.alias
+ if field.alias != field.name
+ else field.name.replace("_", "-")
+ )
+ value = _get_multidict_value(field, received_params, alias=alias)
+ if value is not None:
+ params_to_process[field.name] = value
+ processed_keys.add(alias or field.alias)
+ processed_keys.add(field.name)
+
+ for key, value in received_params.items():
+ if key not in processed_keys:
+ params_to_process[key] = value
+
+ if single_not_embedded_field:
+ field_info = first_field.field_info
+ assert isinstance(
+ field_info, params.Param
+ ), "Params must be subclasses of Param"
+ loc: Tuple[str, ...] = (field_info.in_.value,)
+ v_, errors_ = _validate_value_with_model_field(
+ field=first_field, value=params_to_process, values=values, loc=loc
+ )
+ return {first_field.name: v_}, errors_
+
for field in fields:
value = _get_multidict_value(field, received_params)
field_info = field.field_info
diff --git a/fastapi/openapi/utils.py b/fastapi/openapi/utils.py
index 79ad9f83f..947eca948 100644
--- a/fastapi/openapi/utils.py
+++ b/fastapi/openapi/utils.py
@@ -16,11 +16,15 @@ from fastapi._compat import (
)
from fastapi.datastructures import DefaultPlaceholder
from fastapi.dependencies.models import Dependant
-from fastapi.dependencies.utils import get_flat_dependant, get_flat_params
+from fastapi.dependencies.utils import (
+ _get_flat_fields_from_params,
+ get_flat_dependant,
+ get_flat_params,
+)
from fastapi.encoders import jsonable_encoder
from fastapi.openapi.constants import METHODS_WITH_BODY, REF_PREFIX, REF_TEMPLATE
from fastapi.openapi.models import OpenAPI
-from fastapi.params import Body, Param
+from fastapi.params import Body, ParamTypes
from fastapi.responses import Response
from fastapi.types import ModelNameMap
from fastapi.utils import (
@@ -87,9 +91,9 @@ def get_openapi_security_definitions(
return security_definitions, operation_security
-def get_openapi_operation_parameters(
+def _get_openapi_operation_parameters(
*,
- all_route_params: Sequence[ModelField],
+ dependant: Dependant,
schema_generator: GenerateJsonSchema,
model_name_map: ModelNameMap,
field_mapping: Dict[
@@ -98,33 +102,47 @@ def get_openapi_operation_parameters(
separate_input_output_schemas: bool = True,
) -> List[Dict[str, Any]]:
parameters = []
- for param in all_route_params:
- field_info = param.field_info
- field_info = cast(Param, field_info)
- if not field_info.include_in_schema:
- continue
- param_schema = get_schema_from_model_field(
- field=param,
- schema_generator=schema_generator,
- model_name_map=model_name_map,
- field_mapping=field_mapping,
- separate_input_output_schemas=separate_input_output_schemas,
- )
- parameter = {
- "name": param.alias,
- "in": field_info.in_.value,
- "required": param.required,
- "schema": param_schema,
- }
- if field_info.description:
- parameter["description"] = field_info.description
- if field_info.openapi_examples:
- parameter["examples"] = jsonable_encoder(field_info.openapi_examples)
- elif field_info.example != Undefined:
- parameter["example"] = jsonable_encoder(field_info.example)
- if field_info.deprecated:
- parameter["deprecated"] = True
- parameters.append(parameter)
+ flat_dependant = get_flat_dependant(dependant, skip_repeats=True)
+ path_params = _get_flat_fields_from_params(flat_dependant.path_params)
+ query_params = _get_flat_fields_from_params(flat_dependant.query_params)
+ header_params = _get_flat_fields_from_params(flat_dependant.header_params)
+ cookie_params = _get_flat_fields_from_params(flat_dependant.cookie_params)
+ parameter_groups = [
+ (ParamTypes.path, path_params),
+ (ParamTypes.query, query_params),
+ (ParamTypes.header, header_params),
+ (ParamTypes.cookie, cookie_params),
+ ]
+ for param_type, param_group in parameter_groups:
+ for param in param_group:
+ field_info = param.field_info
+ # field_info = cast(Param, field_info)
+ if not getattr(field_info, "include_in_schema", True):
+ continue
+ param_schema = get_schema_from_model_field(
+ field=param,
+ schema_generator=schema_generator,
+ model_name_map=model_name_map,
+ field_mapping=field_mapping,
+ separate_input_output_schemas=separate_input_output_schemas,
+ )
+ parameter = {
+ "name": param.alias,
+ "in": param_type.value,
+ "required": param.required,
+ "schema": param_schema,
+ }
+ if field_info.description:
+ parameter["description"] = field_info.description
+ openapi_examples = getattr(field_info, "openapi_examples", None)
+ example = getattr(field_info, "example", None)
+ if openapi_examples:
+ parameter["examples"] = jsonable_encoder(openapi_examples)
+ elif example != Undefined:
+ parameter["example"] = jsonable_encoder(example)
+ if getattr(field_info, "deprecated", None):
+ parameter["deprecated"] = True
+ parameters.append(parameter)
return parameters
@@ -247,9 +265,8 @@ def get_openapi_path(
operation.setdefault("security", []).extend(operation_security)
if security_definitions:
security_schemes.update(security_definitions)
- all_route_params = get_flat_params(route.dependant)
- operation_parameters = get_openapi_operation_parameters(
- all_route_params=all_route_params,
+ operation_parameters = _get_openapi_operation_parameters(
+ dependant=route.dependant,
schema_generator=schema_generator,
model_name_map=model_name_map,
field_mapping=field_mapping,
@@ -379,6 +396,7 @@ def get_openapi_path(
deep_dict_update(openapi_response, process_response)
openapi_response["description"] = description
http422 = str(HTTP_422_UNPROCESSABLE_ENTITY)
+ all_route_params = get_flat_params(route.dependant)
if (all_route_params or route.body_field) and not any(
status in operation["responses"]
for status in [http422, "4XX", "default"]
diff --git a/scripts/playwright/cookie_param_models/image01.py b/scripts/playwright/cookie_param_models/image01.py
new file mode 100644
index 000000000..77c91bfe2
--- /dev/null
+++ b/scripts/playwright/cookie_param_models/image01.py
@@ -0,0 +1,39 @@
+import subprocess
+import time
+
+import httpx
+from playwright.sync_api import Playwright, sync_playwright
+
+
+# Run playwright codegen to generate the code below, copy paste the sections in run()
+def run(playwright: Playwright) -> None:
+ browser = playwright.chromium.launch(headless=False)
+ # Update the viewport manually
+ context = browser.new_context(viewport={"width": 960, "height": 1080})
+ browser = playwright.chromium.launch(headless=False)
+ context = browser.new_context()
+ page = context.new_page()
+ page.goto("http://localhost:8000/docs")
+ page.get_by_role("link", name="/items/").click()
+ # Manually add the screenshot
+ page.screenshot(path="docs/en/docs/img/tutorial/cookie-param-models/image01.png")
+
+ # ---------------------
+ context.close()
+ browser.close()
+
+
+process = subprocess.Popen(
+ ["fastapi", "run", "docs_src/cookie_param_models/tutorial001.py"]
+)
+try:
+ for _ in range(3):
+ try:
+ response = httpx.get("http://localhost:8000/docs")
+ except httpx.ConnectError:
+ time.sleep(1)
+ break
+ with sync_playwright() as playwright:
+ run(playwright)
+finally:
+ process.terminate()
diff --git a/scripts/playwright/header_param_models/image01.py b/scripts/playwright/header_param_models/image01.py
new file mode 100644
index 000000000..53914251e
--- /dev/null
+++ b/scripts/playwright/header_param_models/image01.py
@@ -0,0 +1,38 @@
+import subprocess
+import time
+
+import httpx
+from playwright.sync_api import Playwright, sync_playwright
+
+
+# Run playwright codegen to generate the code below, copy paste the sections in run()
+def run(playwright: Playwright) -> None:
+ browser = playwright.chromium.launch(headless=False)
+ # Update the viewport manually
+ context = browser.new_context(viewport={"width": 960, "height": 1080})
+ page = context.new_page()
+ page.goto("http://localhost:8000/docs")
+ page.get_by_role("button", name="GET /items/ Read Items").click()
+ page.get_by_role("button", name="Try it out").click()
+ # Manually add the screenshot
+ page.screenshot(path="docs/en/docs/img/tutorial/header-param-models/image01.png")
+
+ # ---------------------
+ context.close()
+ browser.close()
+
+
+process = subprocess.Popen(
+ ["fastapi", "run", "docs_src/header_param_models/tutorial001.py"]
+)
+try:
+ for _ in range(3):
+ try:
+ response = httpx.get("http://localhost:8000/docs")
+ except httpx.ConnectError:
+ time.sleep(1)
+ break
+ with sync_playwright() as playwright:
+ run(playwright)
+finally:
+ process.terminate()
diff --git a/scripts/playwright/query_param_models/image01.py b/scripts/playwright/query_param_models/image01.py
new file mode 100644
index 000000000..0ea1d0df4
--- /dev/null
+++ b/scripts/playwright/query_param_models/image01.py
@@ -0,0 +1,41 @@
+import subprocess
+import time
+
+import httpx
+from playwright.sync_api import Playwright, sync_playwright
+
+
+# Run playwright codegen to generate the code below, copy paste the sections in run()
+def run(playwright: Playwright) -> None:
+ browser = playwright.chromium.launch(headless=False)
+ # Update the viewport manually
+ context = browser.new_context(viewport={"width": 960, "height": 1080})
+ browser = playwright.chromium.launch(headless=False)
+ context = browser.new_context()
+ page = context.new_page()
+ page.goto("http://localhost:8000/docs")
+ page.get_by_role("button", name="GET /items/ Read Items").click()
+ page.get_by_role("button", name="Try it out").click()
+ page.get_by_role("heading", name="Servers").click()
+ # Manually add the screenshot
+ page.screenshot(path="docs/en/docs/img/tutorial/query-param-models/image01.png")
+
+ # ---------------------
+ context.close()
+ browser.close()
+
+
+process = subprocess.Popen(
+ ["fastapi", "run", "docs_src/query_param_models/tutorial001.py"]
+)
+try:
+ for _ in range(3):
+ try:
+ response = httpx.get("http://localhost:8000/docs")
+ except httpx.ConnectError:
+ time.sleep(1)
+ break
+ with sync_playwright() as playwright:
+ run(playwright)
+finally:
+ process.terminate()
diff --git a/tests/test_tutorial/test_cookie_param_models/__init__.py b/tests/test_tutorial/test_cookie_param_models/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/test_tutorial/test_cookie_param_models/test_tutorial001.py b/tests/test_tutorial/test_cookie_param_models/test_tutorial001.py
new file mode 100644
index 000000000..60643185a
--- /dev/null
+++ b/tests/test_tutorial/test_cookie_param_models/test_tutorial001.py
@@ -0,0 +1,205 @@
+import importlib
+
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+
+from tests.utils import needs_py39, needs_py310
+
+
+@pytest.fixture(
+ name="client",
+ params=[
+ "tutorial001",
+ pytest.param("tutorial001_py310", marks=needs_py310),
+ "tutorial001_an",
+ pytest.param("tutorial001_an_py39", marks=needs_py39),
+ pytest.param("tutorial001_an_py310", marks=needs_py310),
+ ],
+)
+def get_client(request: pytest.FixtureRequest):
+ mod = importlib.import_module(f"docs_src.cookie_param_models.{request.param}")
+
+ client = TestClient(mod.app)
+ return client
+
+
+def test_cookie_param_model(client: TestClient):
+ with client as c:
+ c.cookies.set("session_id", "123")
+ c.cookies.set("fatebook_tracker", "456")
+ c.cookies.set("googall_tracker", "789")
+ response = c.get("/items/")
+ assert response.status_code == 200
+ assert response.json() == {
+ "session_id": "123",
+ "fatebook_tracker": "456",
+ "googall_tracker": "789",
+ }
+
+
+def test_cookie_param_model_defaults(client: TestClient):
+ with client as c:
+ c.cookies.set("session_id", "123")
+ response = c.get("/items/")
+ assert response.status_code == 200
+ assert response.json() == {
+ "session_id": "123",
+ "fatebook_tracker": None,
+ "googall_tracker": None,
+ }
+
+
+def test_cookie_param_model_invalid(client: TestClient):
+ response = client.get("/items/")
+ assert response.status_code == 422
+ assert response.json() == snapshot(
+ IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["cookie", "session_id"],
+ "msg": "Field required",
+ "input": {},
+ }
+ ]
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["cookie", "session_id"],
+ "msg": "field required",
+ }
+ ]
+ }
+ )
+ )
+
+
+def test_cookie_param_model_extra(client: TestClient):
+ with client as c:
+ c.cookies.set("session_id", "123")
+ c.cookies.set("extra", "track-me-here-too")
+ response = c.get("/items/")
+ assert response.status_code == 200
+ assert response.json() == snapshot(
+ {"session_id": "123", "fatebook_tracker": None, "googall_tracker": None}
+ )
+
+
+def test_openapi_schema(client: TestClient):
+ response = client.get("/openapi.json")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {
+ "openapi": "3.1.0",
+ "info": {"title": "FastAPI", "version": "0.1.0"},
+ "paths": {
+ "/items/": {
+ "get": {
+ "summary": "Read Items",
+ "operationId": "read_items_items__get",
+ "parameters": [
+ {
+ "name": "session_id",
+ "in": "cookie",
+ "required": True,
+ "schema": {"type": "string", "title": "Session Id"},
+ },
+ {
+ "name": "fatebook_tracker",
+ "in": "cookie",
+ "required": False,
+ "schema": IsDict(
+ {
+ "anyOf": [{"type": "string"}, {"type": "null"}],
+ "title": "Fatebook Tracker",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "string",
+ "title": "Fatebook Tracker",
+ }
+ ),
+ },
+ {
+ "name": "googall_tracker",
+ "in": "cookie",
+ "required": False,
+ "schema": IsDict(
+ {
+ "anyOf": [{"type": "string"}, {"type": "null"}],
+ "title": "Googall Tracker",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "string",
+ "title": "Googall Tracker",
+ }
+ ),
+ },
+ ],
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "HTTPValidationError": {
+ "properties": {
+ "detail": {
+ "items": {
+ "$ref": "#/components/schemas/ValidationError"
+ },
+ "type": "array",
+ "title": "Detail",
+ }
+ },
+ "type": "object",
+ "title": "HTTPValidationError",
+ },
+ "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",
+ },
+ }
+ },
+ }
+ )
diff --git a/tests/test_tutorial/test_cookie_param_models/test_tutorial002.py b/tests/test_tutorial/test_cookie_param_models/test_tutorial002.py
new file mode 100644
index 000000000..30adadc8a
--- /dev/null
+++ b/tests/test_tutorial/test_cookie_param_models/test_tutorial002.py
@@ -0,0 +1,233 @@
+import importlib
+
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+
+from tests.utils import needs_py39, needs_py310, needs_pydanticv1, needs_pydanticv2
+
+
+@pytest.fixture(
+ name="client",
+ params=[
+ pytest.param("tutorial002", marks=needs_pydanticv2),
+ pytest.param("tutorial002_py310", marks=[needs_py310, needs_pydanticv2]),
+ pytest.param("tutorial002_an", marks=needs_pydanticv2),
+ pytest.param("tutorial002_an_py39", marks=[needs_py39, needs_pydanticv2]),
+ pytest.param("tutorial002_an_py310", marks=[needs_py310, needs_pydanticv2]),
+ pytest.param("tutorial002_pv1", marks=[needs_pydanticv1, needs_pydanticv1]),
+ pytest.param("tutorial002_pv1_py310", marks=[needs_py310, needs_pydanticv1]),
+ pytest.param("tutorial002_pv1_an", marks=[needs_pydanticv1]),
+ pytest.param("tutorial002_pv1_an_py39", marks=[needs_py39, needs_pydanticv1]),
+ pytest.param("tutorial002_pv1_an_py310", marks=[needs_py310, needs_pydanticv1]),
+ ],
+)
+def get_client(request: pytest.FixtureRequest):
+ mod = importlib.import_module(f"docs_src.cookie_param_models.{request.param}")
+
+ client = TestClient(mod.app)
+ return client
+
+
+def test_cookie_param_model(client: TestClient):
+ with client as c:
+ c.cookies.set("session_id", "123")
+ c.cookies.set("fatebook_tracker", "456")
+ c.cookies.set("googall_tracker", "789")
+ response = c.get("/items/")
+ assert response.status_code == 200
+ assert response.json() == {
+ "session_id": "123",
+ "fatebook_tracker": "456",
+ "googall_tracker": "789",
+ }
+
+
+def test_cookie_param_model_defaults(client: TestClient):
+ with client as c:
+ c.cookies.set("session_id", "123")
+ response = c.get("/items/")
+ assert response.status_code == 200
+ assert response.json() == {
+ "session_id": "123",
+ "fatebook_tracker": None,
+ "googall_tracker": None,
+ }
+
+
+def test_cookie_param_model_invalid(client: TestClient):
+ response = client.get("/items/")
+ assert response.status_code == 422
+ assert response.json() == snapshot(
+ IsDict(
+ {
+ "detail": [
+ {
+ "type": "missing",
+ "loc": ["cookie", "session_id"],
+ "msg": "Field required",
+ "input": {},
+ }
+ ]
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "type": "value_error.missing",
+ "loc": ["cookie", "session_id"],
+ "msg": "field required",
+ }
+ ]
+ }
+ )
+ )
+
+
+def test_cookie_param_model_extra(client: TestClient):
+ with client as c:
+ c.cookies.set("session_id", "123")
+ c.cookies.set("extra", "track-me-here-too")
+ response = c.get("/items/")
+ assert response.status_code == 422
+ assert response.json() == snapshot(
+ IsDict(
+ {
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["cookie", "extra"],
+ "msg": "Extra inputs are not permitted",
+ "input": "track-me-here-too",
+ }
+ ]
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "type": "value_error.extra",
+ "loc": ["cookie", "extra"],
+ "msg": "extra fields not permitted",
+ }
+ ]
+ }
+ )
+ )
+
+
+def test_openapi_schema(client: TestClient):
+ response = client.get("/openapi.json")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {
+ "openapi": "3.1.0",
+ "info": {"title": "FastAPI", "version": "0.1.0"},
+ "paths": {
+ "/items/": {
+ "get": {
+ "summary": "Read Items",
+ "operationId": "read_items_items__get",
+ "parameters": [
+ {
+ "name": "session_id",
+ "in": "cookie",
+ "required": True,
+ "schema": {"type": "string", "title": "Session Id"},
+ },
+ {
+ "name": "fatebook_tracker",
+ "in": "cookie",
+ "required": False,
+ "schema": IsDict(
+ {
+ "anyOf": [{"type": "string"}, {"type": "null"}],
+ "title": "Fatebook Tracker",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "string",
+ "title": "Fatebook Tracker",
+ }
+ ),
+ },
+ {
+ "name": "googall_tracker",
+ "in": "cookie",
+ "required": False,
+ "schema": IsDict(
+ {
+ "anyOf": [{"type": "string"}, {"type": "null"}],
+ "title": "Googall Tracker",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "string",
+ "title": "Googall Tracker",
+ }
+ ),
+ },
+ ],
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "HTTPValidationError": {
+ "properties": {
+ "detail": {
+ "items": {
+ "$ref": "#/components/schemas/ValidationError"
+ },
+ "type": "array",
+ "title": "Detail",
+ }
+ },
+ "type": "object",
+ "title": "HTTPValidationError",
+ },
+ "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",
+ },
+ }
+ },
+ }
+ )
diff --git a/tests/test_tutorial/test_header_param_models/__init__.py b/tests/test_tutorial/test_header_param_models/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/test_tutorial/test_header_param_models/test_tutorial001.py b/tests/test_tutorial/test_header_param_models/test_tutorial001.py
new file mode 100644
index 000000000..06b2404cf
--- /dev/null
+++ b/tests/test_tutorial/test_header_param_models/test_tutorial001.py
@@ -0,0 +1,238 @@
+import importlib
+
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+
+from tests.utils import needs_py39, needs_py310
+
+
+@pytest.fixture(
+ name="client",
+ params=[
+ "tutorial001",
+ pytest.param("tutorial001_py39", marks=needs_py39),
+ pytest.param("tutorial001_py310", marks=needs_py310),
+ "tutorial001_an",
+ pytest.param("tutorial001_an_py39", marks=needs_py39),
+ pytest.param("tutorial001_an_py310", marks=needs_py310),
+ ],
+)
+def get_client(request: pytest.FixtureRequest):
+ mod = importlib.import_module(f"docs_src.header_param_models.{request.param}")
+
+ client = TestClient(mod.app)
+ return client
+
+
+def test_header_param_model(client: TestClient):
+ response = client.get(
+ "/items/",
+ headers=[
+ ("save-data", "true"),
+ ("if-modified-since", "yesterday"),
+ ("traceparent", "123"),
+ ("x-tag", "one"),
+ ("x-tag", "two"),
+ ],
+ )
+ assert response.status_code == 200
+ assert response.json() == {
+ "host": "testserver",
+ "save_data": True,
+ "if_modified_since": "yesterday",
+ "traceparent": "123",
+ "x_tag": ["one", "two"],
+ }
+
+
+def test_header_param_model_defaults(client: TestClient):
+ response = client.get("/items/", headers=[("save-data", "true")])
+ assert response.status_code == 200
+ assert response.json() == {
+ "host": "testserver",
+ "save_data": True,
+ "if_modified_since": None,
+ "traceparent": None,
+ "x_tag": [],
+ }
+
+
+def test_header_param_model_invalid(client: TestClient):
+ response = client.get("/items/")
+ assert response.status_code == 422
+ assert response.json() == snapshot(
+ {
+ "detail": [
+ IsDict(
+ {
+ "type": "missing",
+ "loc": ["header", "save_data"],
+ "msg": "Field required",
+ "input": {
+ "x_tag": [],
+ "host": "testserver",
+ "accept": "*/*",
+ "accept-encoding": "gzip, deflate",
+ "connection": "keep-alive",
+ "user-agent": "testclient",
+ },
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "value_error.missing",
+ "loc": ["header", "save_data"],
+ "msg": "field required",
+ }
+ )
+ ]
+ }
+ )
+
+
+def test_header_param_model_extra(client: TestClient):
+ response = client.get(
+ "/items/", headers=[("save-data", "true"), ("tool", "plumbus")]
+ )
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {
+ "host": "testserver",
+ "save_data": True,
+ "if_modified_since": None,
+ "traceparent": None,
+ "x_tag": [],
+ }
+ )
+
+
+def test_openapi_schema(client: TestClient):
+ response = client.get("/openapi.json")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {
+ "openapi": "3.1.0",
+ "info": {"title": "FastAPI", "version": "0.1.0"},
+ "paths": {
+ "/items/": {
+ "get": {
+ "summary": "Read Items",
+ "operationId": "read_items_items__get",
+ "parameters": [
+ {
+ "name": "host",
+ "in": "header",
+ "required": True,
+ "schema": {"type": "string", "title": "Host"},
+ },
+ {
+ "name": "save_data",
+ "in": "header",
+ "required": True,
+ "schema": {"type": "boolean", "title": "Save Data"},
+ },
+ {
+ "name": "if_modified_since",
+ "in": "header",
+ "required": False,
+ "schema": IsDict(
+ {
+ "anyOf": [{"type": "string"}, {"type": "null"}],
+ "title": "If Modified Since",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "string",
+ "title": "If Modified Since",
+ }
+ ),
+ },
+ {
+ "name": "traceparent",
+ "in": "header",
+ "required": False,
+ "schema": IsDict(
+ {
+ "anyOf": [{"type": "string"}, {"type": "null"}],
+ "title": "Traceparent",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "string",
+ "title": "Traceparent",
+ }
+ ),
+ },
+ {
+ "name": "x_tag",
+ "in": "header",
+ "required": False,
+ "schema": {
+ "type": "array",
+ "items": {"type": "string"},
+ "default": [],
+ "title": "X Tag",
+ },
+ },
+ ],
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "HTTPValidationError": {
+ "properties": {
+ "detail": {
+ "items": {
+ "$ref": "#/components/schemas/ValidationError"
+ },
+ "type": "array",
+ "title": "Detail",
+ }
+ },
+ "type": "object",
+ "title": "HTTPValidationError",
+ },
+ "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",
+ },
+ }
+ },
+ }
+ )
diff --git a/tests/test_tutorial/test_header_param_models/test_tutorial002.py b/tests/test_tutorial/test_header_param_models/test_tutorial002.py
new file mode 100644
index 000000000..e07655a0c
--- /dev/null
+++ b/tests/test_tutorial/test_header_param_models/test_tutorial002.py
@@ -0,0 +1,249 @@
+import importlib
+
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+
+from tests.utils import needs_py39, needs_py310, needs_pydanticv1, needs_pydanticv2
+
+
+@pytest.fixture(
+ name="client",
+ params=[
+ pytest.param("tutorial002", marks=needs_pydanticv2),
+ pytest.param("tutorial002_py310", marks=[needs_py310, needs_pydanticv2]),
+ pytest.param("tutorial002_an", marks=needs_pydanticv2),
+ pytest.param("tutorial002_an_py39", marks=[needs_py39, needs_pydanticv2]),
+ pytest.param("tutorial002_an_py310", marks=[needs_py310, needs_pydanticv2]),
+ pytest.param("tutorial002_pv1", marks=[needs_pydanticv1, needs_pydanticv1]),
+ pytest.param("tutorial002_pv1_py310", marks=[needs_py310, needs_pydanticv1]),
+ pytest.param("tutorial002_pv1_an", marks=[needs_pydanticv1]),
+ pytest.param("tutorial002_pv1_an_py39", marks=[needs_py39, needs_pydanticv1]),
+ pytest.param("tutorial002_pv1_an_py310", marks=[needs_py310, needs_pydanticv1]),
+ ],
+)
+def get_client(request: pytest.FixtureRequest):
+ mod = importlib.import_module(f"docs_src.header_param_models.{request.param}")
+
+ client = TestClient(mod.app)
+ client.headers.clear()
+ return client
+
+
+def test_header_param_model(client: TestClient):
+ response = client.get(
+ "/items/",
+ headers=[
+ ("save-data", "true"),
+ ("if-modified-since", "yesterday"),
+ ("traceparent", "123"),
+ ("x-tag", "one"),
+ ("x-tag", "two"),
+ ],
+ )
+ assert response.status_code == 200, response.text
+ assert response.json() == {
+ "host": "testserver",
+ "save_data": True,
+ "if_modified_since": "yesterday",
+ "traceparent": "123",
+ "x_tag": ["one", "two"],
+ }
+
+
+def test_header_param_model_defaults(client: TestClient):
+ response = client.get("/items/", headers=[("save-data", "true")])
+ assert response.status_code == 200
+ assert response.json() == {
+ "host": "testserver",
+ "save_data": True,
+ "if_modified_since": None,
+ "traceparent": None,
+ "x_tag": [],
+ }
+
+
+def test_header_param_model_invalid(client: TestClient):
+ response = client.get("/items/")
+ assert response.status_code == 422
+ assert response.json() == snapshot(
+ {
+ "detail": [
+ IsDict(
+ {
+ "type": "missing",
+ "loc": ["header", "save_data"],
+ "msg": "Field required",
+ "input": {"x_tag": [], "host": "testserver"},
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "value_error.missing",
+ "loc": ["header", "save_data"],
+ "msg": "field required",
+ }
+ )
+ ]
+ }
+ )
+
+
+def test_header_param_model_extra(client: TestClient):
+ response = client.get(
+ "/items/", headers=[("save-data", "true"), ("tool", "plumbus")]
+ )
+ assert response.status_code == 422, response.text
+ assert response.json() == snapshot(
+ {
+ "detail": [
+ IsDict(
+ {
+ "type": "extra_forbidden",
+ "loc": ["header", "tool"],
+ "msg": "Extra inputs are not permitted",
+ "input": "plumbus",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "value_error.extra",
+ "loc": ["header", "tool"],
+ "msg": "extra fields not permitted",
+ }
+ )
+ ]
+ }
+ )
+
+
+def test_openapi_schema(client: TestClient):
+ response = client.get("/openapi.json")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {
+ "openapi": "3.1.0",
+ "info": {"title": "FastAPI", "version": "0.1.0"},
+ "paths": {
+ "/items/": {
+ "get": {
+ "summary": "Read Items",
+ "operationId": "read_items_items__get",
+ "parameters": [
+ {
+ "name": "host",
+ "in": "header",
+ "required": True,
+ "schema": {"type": "string", "title": "Host"},
+ },
+ {
+ "name": "save_data",
+ "in": "header",
+ "required": True,
+ "schema": {"type": "boolean", "title": "Save Data"},
+ },
+ {
+ "name": "if_modified_since",
+ "in": "header",
+ "required": False,
+ "schema": IsDict(
+ {
+ "anyOf": [{"type": "string"}, {"type": "null"}],
+ "title": "If Modified Since",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "string",
+ "title": "If Modified Since",
+ }
+ ),
+ },
+ {
+ "name": "traceparent",
+ "in": "header",
+ "required": False,
+ "schema": IsDict(
+ {
+ "anyOf": [{"type": "string"}, {"type": "null"}],
+ "title": "Traceparent",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "string",
+ "title": "Traceparent",
+ }
+ ),
+ },
+ {
+ "name": "x_tag",
+ "in": "header",
+ "required": False,
+ "schema": {
+ "type": "array",
+ "items": {"type": "string"},
+ "default": [],
+ "title": "X Tag",
+ },
+ },
+ ],
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "HTTPValidationError": {
+ "properties": {
+ "detail": {
+ "items": {
+ "$ref": "#/components/schemas/ValidationError"
+ },
+ "type": "array",
+ "title": "Detail",
+ }
+ },
+ "type": "object",
+ "title": "HTTPValidationError",
+ },
+ "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",
+ },
+ }
+ },
+ }
+ )
diff --git a/tests/test_tutorial/test_query_param_models/__init__.py b/tests/test_tutorial/test_query_param_models/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/test_tutorial/test_query_param_models/test_tutorial001.py b/tests/test_tutorial/test_query_param_models/test_tutorial001.py
new file mode 100644
index 000000000..5b7bc7b42
--- /dev/null
+++ b/tests/test_tutorial/test_query_param_models/test_tutorial001.py
@@ -0,0 +1,260 @@
+import importlib
+
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+
+from tests.utils import needs_py39, needs_py310
+
+
+@pytest.fixture(
+ name="client",
+ params=[
+ "tutorial001",
+ pytest.param("tutorial001_py39", marks=needs_py39),
+ pytest.param("tutorial001_py310", marks=needs_py310),
+ "tutorial001_an",
+ pytest.param("tutorial001_an_py39", marks=needs_py39),
+ pytest.param("tutorial001_an_py310", marks=needs_py310),
+ ],
+)
+def get_client(request: pytest.FixtureRequest):
+ mod = importlib.import_module(f"docs_src.query_param_models.{request.param}")
+
+ client = TestClient(mod.app)
+ return client
+
+
+def test_query_param_model(client: TestClient):
+ response = client.get(
+ "/items/",
+ params={
+ "limit": 10,
+ "offset": 5,
+ "order_by": "updated_at",
+ "tags": ["tag1", "tag2"],
+ },
+ )
+ assert response.status_code == 200
+ assert response.json() == {
+ "limit": 10,
+ "offset": 5,
+ "order_by": "updated_at",
+ "tags": ["tag1", "tag2"],
+ }
+
+
+def test_query_param_model_defaults(client: TestClient):
+ response = client.get("/items/")
+ assert response.status_code == 200
+ assert response.json() == {
+ "limit": 100,
+ "offset": 0,
+ "order_by": "created_at",
+ "tags": [],
+ }
+
+
+def test_query_param_model_invalid(client: TestClient):
+ response = client.get(
+ "/items/",
+ params={
+ "limit": 150,
+ "offset": -1,
+ "order_by": "invalid",
+ },
+ )
+ assert response.status_code == 422
+ assert response.json() == snapshot(
+ IsDict(
+ {
+ "detail": [
+ {
+ "type": "less_than_equal",
+ "loc": ["query", "limit"],
+ "msg": "Input should be less than or equal to 100",
+ "input": "150",
+ "ctx": {"le": 100},
+ },
+ {
+ "type": "greater_than_equal",
+ "loc": ["query", "offset"],
+ "msg": "Input should be greater than or equal to 0",
+ "input": "-1",
+ "ctx": {"ge": 0},
+ },
+ {
+ "type": "literal_error",
+ "loc": ["query", "order_by"],
+ "msg": "Input should be 'created_at' or 'updated_at'",
+ "input": "invalid",
+ "ctx": {"expected": "'created_at' or 'updated_at'"},
+ },
+ ]
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "type": "value_error.number.not_le",
+ "loc": ["query", "limit"],
+ "msg": "ensure this value is less than or equal to 100",
+ "ctx": {"limit_value": 100},
+ },
+ {
+ "type": "value_error.number.not_ge",
+ "loc": ["query", "offset"],
+ "msg": "ensure this value is greater than or equal to 0",
+ "ctx": {"limit_value": 0},
+ },
+ {
+ "type": "value_error.const",
+ "loc": ["query", "order_by"],
+ "msg": "unexpected value; permitted: 'created_at', 'updated_at'",
+ "ctx": {
+ "given": "invalid",
+ "permitted": ["created_at", "updated_at"],
+ },
+ },
+ ]
+ }
+ )
+ )
+
+
+def test_query_param_model_extra(client: TestClient):
+ response = client.get(
+ "/items/",
+ params={
+ "limit": 10,
+ "offset": 5,
+ "order_by": "updated_at",
+ "tags": ["tag1", "tag2"],
+ "tool": "plumbus",
+ },
+ )
+ assert response.status_code == 200
+ assert response.json() == {
+ "limit": 10,
+ "offset": 5,
+ "order_by": "updated_at",
+ "tags": ["tag1", "tag2"],
+ }
+
+
+def test_openapi_schema(client: TestClient):
+ response = client.get("/openapi.json")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {
+ "openapi": "3.1.0",
+ "info": {"title": "FastAPI", "version": "0.1.0"},
+ "paths": {
+ "/items/": {
+ "get": {
+ "summary": "Read Items",
+ "operationId": "read_items_items__get",
+ "parameters": [
+ {
+ "name": "limit",
+ "in": "query",
+ "required": False,
+ "schema": {
+ "type": "integer",
+ "maximum": 100,
+ "exclusiveMinimum": 0,
+ "default": 100,
+ "title": "Limit",
+ },
+ },
+ {
+ "name": "offset",
+ "in": "query",
+ "required": False,
+ "schema": {
+ "type": "integer",
+ "minimum": 0,
+ "default": 0,
+ "title": "Offset",
+ },
+ },
+ {
+ "name": "order_by",
+ "in": "query",
+ "required": False,
+ "schema": {
+ "enum": ["created_at", "updated_at"],
+ "type": "string",
+ "default": "created_at",
+ "title": "Order By",
+ },
+ },
+ {
+ "name": "tags",
+ "in": "query",
+ "required": False,
+ "schema": {
+ "type": "array",
+ "items": {"type": "string"},
+ "default": [],
+ "title": "Tags",
+ },
+ },
+ ],
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "HTTPValidationError": {
+ "properties": {
+ "detail": {
+ "items": {
+ "$ref": "#/components/schemas/ValidationError"
+ },
+ "type": "array",
+ "title": "Detail",
+ }
+ },
+ "type": "object",
+ "title": "HTTPValidationError",
+ },
+ "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",
+ },
+ }
+ },
+ }
+ )
diff --git a/tests/test_tutorial/test_query_param_models/test_tutorial002.py b/tests/test_tutorial/test_query_param_models/test_tutorial002.py
new file mode 100644
index 000000000..4432c9d8a
--- /dev/null
+++ b/tests/test_tutorial/test_query_param_models/test_tutorial002.py
@@ -0,0 +1,282 @@
+import importlib
+
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+
+from tests.utils import needs_py39, needs_py310, needs_pydanticv1, needs_pydanticv2
+
+
+@pytest.fixture(
+ name="client",
+ params=[
+ pytest.param("tutorial002", marks=needs_pydanticv2),
+ pytest.param("tutorial002_py39", marks=[needs_py39, needs_pydanticv2]),
+ pytest.param("tutorial002_py310", marks=[needs_py310, needs_pydanticv2]),
+ pytest.param("tutorial002_an", marks=needs_pydanticv2),
+ pytest.param("tutorial002_an_py39", marks=[needs_py39, needs_pydanticv2]),
+ pytest.param("tutorial002_an_py310", marks=[needs_py310, needs_pydanticv2]),
+ pytest.param("tutorial002_pv1", marks=[needs_pydanticv1, needs_pydanticv1]),
+ pytest.param("tutorial002_pv1_py39", marks=[needs_py39, needs_pydanticv1]),
+ pytest.param("tutorial002_pv1_py310", marks=[needs_py310, needs_pydanticv1]),
+ pytest.param("tutorial002_pv1_an", marks=[needs_pydanticv1]),
+ pytest.param("tutorial002_pv1_an_py39", marks=[needs_py39, needs_pydanticv1]),
+ pytest.param("tutorial002_pv1_an_py310", marks=[needs_py310, needs_pydanticv1]),
+ ],
+)
+def get_client(request: pytest.FixtureRequest):
+ mod = importlib.import_module(f"docs_src.query_param_models.{request.param}")
+
+ client = TestClient(mod.app)
+ return client
+
+
+def test_query_param_model(client: TestClient):
+ response = client.get(
+ "/items/",
+ params={
+ "limit": 10,
+ "offset": 5,
+ "order_by": "updated_at",
+ "tags": ["tag1", "tag2"],
+ },
+ )
+ assert response.status_code == 200
+ assert response.json() == {
+ "limit": 10,
+ "offset": 5,
+ "order_by": "updated_at",
+ "tags": ["tag1", "tag2"],
+ }
+
+
+def test_query_param_model_defaults(client: TestClient):
+ response = client.get("/items/")
+ assert response.status_code == 200
+ assert response.json() == {
+ "limit": 100,
+ "offset": 0,
+ "order_by": "created_at",
+ "tags": [],
+ }
+
+
+def test_query_param_model_invalid(client: TestClient):
+ response = client.get(
+ "/items/",
+ params={
+ "limit": 150,
+ "offset": -1,
+ "order_by": "invalid",
+ },
+ )
+ assert response.status_code == 422
+ assert response.json() == snapshot(
+ IsDict(
+ {
+ "detail": [
+ {
+ "type": "less_than_equal",
+ "loc": ["query", "limit"],
+ "msg": "Input should be less than or equal to 100",
+ "input": "150",
+ "ctx": {"le": 100},
+ },
+ {
+ "type": "greater_than_equal",
+ "loc": ["query", "offset"],
+ "msg": "Input should be greater than or equal to 0",
+ "input": "-1",
+ "ctx": {"ge": 0},
+ },
+ {
+ "type": "literal_error",
+ "loc": ["query", "order_by"],
+ "msg": "Input should be 'created_at' or 'updated_at'",
+ "input": "invalid",
+ "ctx": {"expected": "'created_at' or 'updated_at'"},
+ },
+ ]
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "detail": [
+ {
+ "type": "value_error.number.not_le",
+ "loc": ["query", "limit"],
+ "msg": "ensure this value is less than or equal to 100",
+ "ctx": {"limit_value": 100},
+ },
+ {
+ "type": "value_error.number.not_ge",
+ "loc": ["query", "offset"],
+ "msg": "ensure this value is greater than or equal to 0",
+ "ctx": {"limit_value": 0},
+ },
+ {
+ "type": "value_error.const",
+ "loc": ["query", "order_by"],
+ "msg": "unexpected value; permitted: 'created_at', 'updated_at'",
+ "ctx": {
+ "given": "invalid",
+ "permitted": ["created_at", "updated_at"],
+ },
+ },
+ ]
+ }
+ )
+ )
+
+
+def test_query_param_model_extra(client: TestClient):
+ response = client.get(
+ "/items/",
+ params={
+ "limit": 10,
+ "offset": 5,
+ "order_by": "updated_at",
+ "tags": ["tag1", "tag2"],
+ "tool": "plumbus",
+ },
+ )
+ assert response.status_code == 422
+ assert response.json() == snapshot(
+ {
+ "detail": [
+ IsDict(
+ {
+ "type": "extra_forbidden",
+ "loc": ["query", "tool"],
+ "msg": "Extra inputs are not permitted",
+ "input": "plumbus",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "value_error.extra",
+ "loc": ["query", "tool"],
+ "msg": "extra fields not permitted",
+ }
+ )
+ ]
+ }
+ )
+
+
+def test_openapi_schema(client: TestClient):
+ response = client.get("/openapi.json")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {
+ "openapi": "3.1.0",
+ "info": {"title": "FastAPI", "version": "0.1.0"},
+ "paths": {
+ "/items/": {
+ "get": {
+ "summary": "Read Items",
+ "operationId": "read_items_items__get",
+ "parameters": [
+ {
+ "name": "limit",
+ "in": "query",
+ "required": False,
+ "schema": {
+ "type": "integer",
+ "maximum": 100,
+ "exclusiveMinimum": 0,
+ "default": 100,
+ "title": "Limit",
+ },
+ },
+ {
+ "name": "offset",
+ "in": "query",
+ "required": False,
+ "schema": {
+ "type": "integer",
+ "minimum": 0,
+ "default": 0,
+ "title": "Offset",
+ },
+ },
+ {
+ "name": "order_by",
+ "in": "query",
+ "required": False,
+ "schema": {
+ "enum": ["created_at", "updated_at"],
+ "type": "string",
+ "default": "created_at",
+ "title": "Order By",
+ },
+ },
+ {
+ "name": "tags",
+ "in": "query",
+ "required": False,
+ "schema": {
+ "type": "array",
+ "items": {"type": "string"},
+ "default": [],
+ "title": "Tags",
+ },
+ },
+ ],
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "HTTPValidationError": {
+ "properties": {
+ "detail": {
+ "items": {
+ "$ref": "#/components/schemas/ValidationError"
+ },
+ "type": "array",
+ "title": "Detail",
+ }
+ },
+ "type": "object",
+ "title": "HTTPValidationError",
+ },
+ "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",
+ },
+ }
+ },
+ }
+ )
From 7eadeb69bdc579f7de92d0e7762a7825a5da192a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 17 Sep 2024 18:54:35 +0000
Subject: [PATCH 068/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d6d2a05b3..405d70c37 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Features
+
+* ✨ Add support for Pydantic models for parameters using `Query`, `Cookie`, `Header`. PR [#12199](https://github.com/fastapi/fastapi/pull/12199) by [@tiangolo](https://github.com/tiangolo).
+
### Translations
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/security/http-basic-auth.md`. PR [#12195](https://github.com/fastapi/fastapi/pull/12195) by [@ceb10n](https://github.com/ceb10n).
From b36047b54ae4f965d03426872dbc1fa1f32c746b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 17 Sep 2024 21:06:26 +0200
Subject: [PATCH 069/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 120 ++++++++++++++++++++++++++++++++++
1 file changed, 120 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 405d70c37..722bc5008 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,126 @@ hide:
## Latest Changes
+### Highlights
+
+Now you can declare `Query`, `Header`, and `Cookie` parameters with Pydantic models. 🎉
+
+#### `Query` Parameter Models
+
+Use Pydantic models for `Query` parameters:
+
+```python
+from typing import Annotated, Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+ return filter_query
+```
+
+Read the new docs: [Query Parameter Models](https://fastapi.tiangolo.com/tutorial/query-param-models/).
+
+#### `Header` Parameter Models
+
+Use Pydantic models for `Header` parameters:
+
+```python
+from typing import Annotated
+
+from fastapi import FastAPI, Header
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class CommonHeaders(BaseModel):
+ host: str
+ save_data: bool
+ if_modified_since: str | None = None
+ traceparent: str | None = None
+ x_tag: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(headers: Annotated[CommonHeaders, Header()]):
+ return headers
+```
+
+Read the new docs: [Header Parameter Models](https://fastapi.tiangolo.com/tutorial/header-param-models/).
+
+#### `Cookie` Parameter Models
+
+Use Pydantic models for `Cookie` parameters:
+
+```python
+from typing import Annotated
+
+from fastapi import Cookie, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Cookies(BaseModel):
+ session_id: str
+ fatebook_tracker: str | None = None
+ googall_tracker: str | None = None
+
+
+@app.get("/items/")
+async def read_items(cookies: Annotated[Cookies, Cookie()]):
+ return cookies
+```
+
+Read the new docs: [Cookie Parameter Models](https://fastapi.tiangolo.com/tutorial/cookie-param-models/).
+
+#### Forbid Extra Query (Cookie, Header) Parameters
+
+Use Pydantic models to restrict extra values for `Query` parameters (also applies to `Header` and `Cookie` parameters).
+
+To achieve it, use Pydantic's `model_config = {"extra": "forbid"}`:
+
+```python
+from typing import Annotated, Literal
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel, Field
+
+app = FastAPI()
+
+
+class FilterParams(BaseModel):
+ model_config = {"extra": "forbid"}
+
+ limit: int = Field(100, gt=0, le=100)
+ offset: int = Field(0, ge=0)
+ order_by: Literal["created_at", "updated_at"] = "created_at"
+ tags: list[str] = []
+
+
+@app.get("/items/")
+async def read_items(filter_query: Annotated[FilterParams, Query()]):
+ return filter_query
+```
+
+This applies to `Query`, `Header`, and `Cookie` parameters, read the new docs:
+
+* [Forbid Extra Query Parameters](https://fastapi.tiangolo.com/tutorial/query-param-models/#forbid-extra-query-parameters)
+* [Forbid Extra Headers](https://fastapi.tiangolo.com/tutorial/header-param-models/#forbid-extra-headers)
+* [Forbid Extra Cookies](https://fastapi.tiangolo.com/tutorial/cookie-param-models/#forbid-extra-cookies)
+
### Features
* ✨ Add support for Pydantic models for parameters using `Query`, `Cookie`, `Header`. PR [#12199](https://github.com/fastapi/fastapi/pull/12199) by [@tiangolo](https://github.com/tiangolo).
From 40e33e492dbf4af6172997f4e3238a32e56cbe26 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 17 Sep 2024 21:07:35 +0200
Subject: [PATCH 070/504] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
=?UTF-8?q?5.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 2 ++
fastapi/__init__.py | 2 +-
2 files changed, 3 insertions(+), 1 deletion(-)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 722bc5008..ea7ac9215 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
## Latest Changes
+## 0.115.0
+
### Highlights
Now you can declare `Query`, `Header`, and `Cookie` parameters with Pydantic models. 🎉
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 3925d3603..7dd74c28f 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
"""FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
-__version__ = "0.114.2"
+__version__ = "0.115.0"
from starlette import status as status
From 42e0e368bca7bf94f425c4bd2eca0b4ac4b5cab0 Mon Sep 17 00:00:00 2001
From: Sofie Van Landeghem <svlandeg@users.noreply.github.com>
Date: Wed, 18 Sep 2024 18:09:57 +0200
Subject: [PATCH 071/504] =?UTF-8?q?=F0=9F=93=9D=20Fix=20small=20typos=20in?=
=?UTF-8?q?=20the=20documentation=20(#12213)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/additional-responses.md | 2 +-
docs/en/docs/advanced/async-tests.md | 2 +-
docs/en/docs/advanced/behind-a-proxy.md | 2 +-
docs/en/docs/advanced/custom-response.md | 6 +++---
docs/en/docs/advanced/middleware.md | 4 ++--
.../docs/advanced/path-operation-advanced-configuration.md | 2 +-
docs/en/docs/advanced/response-directly.md | 2 +-
docs/en/docs/advanced/security/http-basic-auth.md | 2 +-
docs/en/docs/advanced/security/oauth2-scopes.md | 2 +-
docs/en/docs/advanced/settings.md | 2 +-
docs/en/docs/deployment/concepts.md | 2 +-
docs/en/docs/deployment/docker.md | 2 +-
docs/en/docs/deployment/server-workers.md | 2 +-
docs/en/docs/release-notes.md | 2 +-
14 files changed, 17 insertions(+), 17 deletions(-)
diff --git a/docs/en/docs/advanced/additional-responses.md b/docs/en/docs/advanced/additional-responses.md
index 674f0672c..4fec41213 100644
--- a/docs/en/docs/advanced/additional-responses.md
+++ b/docs/en/docs/advanced/additional-responses.md
@@ -18,7 +18,7 @@ But for those additional responses you have to make sure you return a `Response`
You can pass to your *path operation decorators* a parameter `responses`.
-It receives a `dict`, the keys are status codes for each response, like `200`, and the values are other `dict`s with the information for each of them.
+It receives a `dict`: the keys are status codes for each response (like `200`), and the values are other `dict`s with the information for each of them.
Each of those response `dict`s can have a key `model`, containing a Pydantic model, just like `response_model`.
diff --git a/docs/en/docs/advanced/async-tests.md b/docs/en/docs/advanced/async-tests.md
index 580d9142c..a528c80fe 100644
--- a/docs/en/docs/advanced/async-tests.md
+++ b/docs/en/docs/advanced/async-tests.md
@@ -102,6 +102,6 @@ As the testing function is now asynchronous, you can now also call (and `await`)
/// tip
-If you encounter a `RuntimeError: Task attached to a different loop` when integrating asynchronous function calls in your tests (e.g. when using <a href="https://stackoverflow.com/questions/41584243/runtimeerror-task-attached-to-a-different-loop" class="external-link" target="_blank">MongoDB's MotorClient</a>) Remember to instantiate objects that need an event loop only within async functions, e.g. an `'@app.on_event("startup")` callback.
+If you encounter a `RuntimeError: Task attached to a different loop` when integrating asynchronous function calls in your tests (e.g. when using <a href="https://stackoverflow.com/questions/41584243/runtimeerror-task-attached-to-a-different-loop" class="external-link" target="_blank">MongoDB's MotorClient</a>), remember to instantiate objects that need an event loop only within async functions, e.g. an `'@app.on_event("startup")` callback.
///
diff --git a/docs/en/docs/advanced/behind-a-proxy.md b/docs/en/docs/advanced/behind-a-proxy.md
index 5ff64016c..e642b1910 100644
--- a/docs/en/docs/advanced/behind-a-proxy.md
+++ b/docs/en/docs/advanced/behind-a-proxy.md
@@ -303,7 +303,7 @@ This is a more advanced use case. Feel free to skip it.
By default, **FastAPI** will create a `server` in the OpenAPI schema with the URL for the `root_path`.
-But you can also provide other alternative `servers`, for example if you want *the same* docs UI to interact with a staging and production environments.
+But you can also provide other alternative `servers`, for example if you want *the same* docs UI to interact with both a staging and a production environment.
If you pass a custom list of `servers` and there's a `root_path` (because your API lives behind a proxy), **FastAPI** will insert a "server" with this `root_path` at the beginning of the list.
diff --git a/docs/en/docs/advanced/custom-response.md b/docs/en/docs/advanced/custom-response.md
index 79f755815..1cefe979f 100644
--- a/docs/en/docs/advanced/custom-response.md
+++ b/docs/en/docs/advanced/custom-response.md
@@ -142,7 +142,7 @@ It accepts the following parameters:
* `headers` - A `dict` of strings.
* `media_type` - A `str` giving the media type. E.g. `"text/html"`.
-FastAPI (actually Starlette) will automatically include a Content-Length header. It will also include a Content-Type header, based on the media_type and appending a charset for text types.
+FastAPI (actually Starlette) will automatically include a Content-Length header. It will also include a Content-Type header, based on the `media_type` and appending a charset for text types.
```Python hl_lines="1 18"
{!../../../docs_src/response_directly/tutorial002.py!}
@@ -154,7 +154,7 @@ Takes some text or bytes and returns an HTML response, as you read above.
### `PlainTextResponse`
-Takes some text or bytes and returns an plain text response.
+Takes some text or bytes and returns a plain text response.
```Python hl_lines="2 7 9"
{!../../../docs_src/custom_response/tutorial005.py!}
@@ -273,7 +273,7 @@ Asynchronously streams a file as the response.
Takes a different set of arguments to instantiate than the other response types:
-* `path` - The filepath to the file to stream.
+* `path` - The file path to the file to stream.
* `headers` - Any custom headers to include, as a dictionary.
* `media_type` - A string giving the media type. If unset, the filename or path will be used to infer a media type.
* `filename` - If set, this will be included in the response `Content-Disposition`.
diff --git a/docs/en/docs/advanced/middleware.md b/docs/en/docs/advanced/middleware.md
index 70415adca..ab7778db0 100644
--- a/docs/en/docs/advanced/middleware.md
+++ b/docs/en/docs/advanced/middleware.md
@@ -24,7 +24,7 @@ app = SomeASGIApp()
new_app = UnicornMiddleware(app, some_config="rainbow")
```
-But FastAPI (actually Starlette) provides a simpler way to do it that makes sure that the internal middlewares to handle server errors and custom exception handlers work properly.
+But FastAPI (actually Starlette) provides a simpler way to do it that makes sure that the internal middlewares handle server errors and custom exception handlers work properly.
For that, you use `app.add_middleware()` (as in the example for CORS).
@@ -55,7 +55,7 @@ For the next examples, you could also use `from starlette.middleware.something i
Enforces that all incoming requests must either be `https` or `wss`.
-Any incoming requests to `http` or `ws` will be redirected to the secure scheme instead.
+Any incoming request to `http` or `ws` will be redirected to the secure scheme instead.
```Python hl_lines="2 6"
{!../../../docs_src/advanced_middleware/tutorial001.py!}
diff --git a/docs/en/docs/advanced/path-operation-advanced-configuration.md b/docs/en/docs/advanced/path-operation-advanced-configuration.md
index c8874bad9..d599006d2 100644
--- a/docs/en/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/en/docs/advanced/path-operation-advanced-configuration.md
@@ -149,7 +149,7 @@ For example, you could decide to read and validate the request with your own cod
You could do that with `openapi_extra`:
-```Python hl_lines="20-37 39-40"
+```Python hl_lines="19-36 39-40"
{!../../../docs_src/path_operation_advanced_configuration/tutorial006.py!}
```
diff --git a/docs/en/docs/advanced/response-directly.md b/docs/en/docs/advanced/response-directly.md
index 2251659c5..092aeceb1 100644
--- a/docs/en/docs/advanced/response-directly.md
+++ b/docs/en/docs/advanced/response-directly.md
@@ -28,7 +28,7 @@ This gives you a lot of flexibility. You can return any data type, override any
## Using the `jsonable_encoder` in a `Response`
-Because **FastAPI** doesn't do any change to a `Response` you return, you have to make sure its contents are ready for it.
+Because **FastAPI** doesn't make any changes to a `Response` you return, you have to make sure its contents are ready for it.
For example, you cannot put a Pydantic model in a `JSONResponse` without first converting it to a `dict` with all the data types (like `datetime`, `UUID`, etc) converted to JSON-compatible types.
diff --git a/docs/en/docs/advanced/security/http-basic-auth.md b/docs/en/docs/advanced/security/http-basic-auth.md
index c302bf8dc..e669d10d8 100644
--- a/docs/en/docs/advanced/security/http-basic-auth.md
+++ b/docs/en/docs/advanced/security/http-basic-auth.md
@@ -144,7 +144,7 @@ And then they can try again knowing that it's probably something more similar to
#### A "professional" attack
-Of course, the attackers would not try all this by hand, they would write a program to do it, possibly with thousands or millions of tests per second. And would get just one extra correct letter at a time.
+Of course, the attackers would not try all this by hand, they would write a program to do it, possibly with thousands or millions of tests per second. And they would get just one extra correct letter at a time.
But doing that, in some minutes or hours the attackers would have guessed the correct username and password, with the "help" of our application, just using the time taken to answer.
diff --git a/docs/en/docs/advanced/security/oauth2-scopes.md b/docs/en/docs/advanced/security/oauth2-scopes.md
index ff52d7bb8..fdd8db7b9 100644
--- a/docs/en/docs/advanced/security/oauth2-scopes.md
+++ b/docs/en/docs/advanced/security/oauth2-scopes.md
@@ -769,7 +769,7 @@ But if you are building an OAuth2 application that others would connect to (i.e.
The most common is the implicit flow.
-The most secure is the code flow, but is more complex to implement as it requires more steps. As it is more complex, many providers end up suggesting the implicit flow.
+The most secure is the code flow, but it's more complex to implement as it requires more steps. As it is more complex, many providers end up suggesting the implicit flow.
/// note
diff --git a/docs/en/docs/advanced/settings.md b/docs/en/docs/advanced/settings.md
index 22bf7de20..8c04d2507 100644
--- a/docs/en/docs/advanced/settings.md
+++ b/docs/en/docs/advanced/settings.md
@@ -374,7 +374,7 @@ Prefer to use the `Annotated` version if possible.
////
-Then for any subsequent calls of `get_settings()` in the dependencies for the next requests, instead of executing the internal code of `get_settings()` and creating a new `Settings` object, it will return the same object that was returned on the first call, again and again.
+Then for any subsequent call of `get_settings()` in the dependencies for the next requests, instead of executing the internal code of `get_settings()` and creating a new `Settings` object, it will return the same object that was returned on the first call, again and again.
#### `lru_cache` Technical Details
diff --git a/docs/en/docs/deployment/concepts.md b/docs/en/docs/deployment/concepts.md
index 69ee71a73..e71a7487a 100644
--- a/docs/en/docs/deployment/concepts.md
+++ b/docs/en/docs/deployment/concepts.md
@@ -257,7 +257,7 @@ But in most cases, you will want to perform these steps only **once**.
So, you will want to have a **single process** to perform those **previous steps**, before starting the application.
-And you will have to make sure that it's a single process running those previous steps *even* if afterwards, you start **multiple processes** (multiple workers) for the application itself. If those steps were run by **multiple processes**, they would **duplicate** the work by running it on **parallel**, and if the steps were something delicate like a database migration, they could cause conflicts with each other.
+And you will have to make sure that it's a single process running those previous steps *even* if afterwards, you start **multiple processes** (multiple workers) for the application itself. If those steps were run by **multiple processes**, they would **duplicate** the work by running it in **parallel**, and if the steps were something delicate like a database migration, they could cause conflicts with each other.
Of course, there are some cases where there's no problem in running the previous steps multiple times, in that case, it's a lot easier to handle.
diff --git a/docs/en/docs/deployment/docker.md b/docs/en/docs/deployment/docker.md
index 2d832a238..b106f7ac3 100644
--- a/docs/en/docs/deployment/docker.md
+++ b/docs/en/docs/deployment/docker.md
@@ -615,6 +615,6 @@ Using container systems (e.g. with **Docker** and **Kubernetes**) it becomes fai
* Memory
* Previous steps before starting
-In most cases, you probably won't want to use any base image, and instead **build a container image from scratch** one based on the official Python Docker image.
+In most cases, you probably won't want to use any base image, and instead **build a container image from scratch** based on the official Python Docker image.
Taking care of the **order** of instructions in the `Dockerfile` and the **Docker cache** you can **minimize build times**, to maximize your productivity (and avoid boredom). 😎
diff --git a/docs/en/docs/deployment/server-workers.md b/docs/en/docs/deployment/server-workers.md
index 5e369e071..622c10a30 100644
--- a/docs/en/docs/deployment/server-workers.md
+++ b/docs/en/docs/deployment/server-workers.md
@@ -139,7 +139,7 @@ From the list of deployment concepts from above, using workers would mainly help
## Containers and Docker
-In the next chapter about [FastAPI in Containers - Docker](docker.md){.internal-link target=_blank} I'll tell some strategies you could use to handle the other **deployment concepts**.
+In the next chapter about [FastAPI in Containers - Docker](docker.md){.internal-link target=_blank} I'll explain some strategies you could use to handle the other **deployment concepts**.
I'll show you how to **build your own image from scratch** to run a single Uvicorn process. It is a simple process and is probably what you would want to do when using a distributed container management system like **Kubernetes**.
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ea7ac9215..5e8815e65 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -494,7 +494,7 @@ Discussed here: [#11522](https://github.com/fastapi/fastapi/pull/11522) and here
### Upgrades
* ➖ Remove `orjson` and `ujson` from default dependencies. PR [#11842](https://github.com/tiangolo/fastapi/pull/11842) by [@tiangolo](https://github.com/tiangolo).
- * These dependencies are still installed when you install with `pip install "fastapi[all]"`. But they not included in `pip install fastapi`.
+ * These dependencies are still installed when you install with `pip install "fastapi[all]"`. But they are not included in `pip install fastapi`.
* 📝 Restored Swagger-UI links to use the latest version possible. PR [#11459](https://github.com/tiangolo/fastapi/pull/11459) by [@UltimateLobster](https://github.com/UltimateLobster).
### Docs
From 4d6cab3ec619ee1186b975f9520d1f396010f9a4 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 18 Sep 2024 16:10:21 +0000
Subject: [PATCH 072/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 5e8815e65..0411bbdda 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Docs
+
+* 📝 Fix small typos in the documentation. PR [#12213](https://github.com/fastapi/fastapi/pull/12213) by [@svlandeg](https://github.com/svlandeg).
+
## 0.115.0
### Highlights
From 6cc24416e22845ef8d188e94993a6285afaf255d Mon Sep 17 00:00:00 2001
From: Albert Villanova del Moral
<8515462+albertvillanova@users.noreply.github.com>
Date: Thu, 19 Sep 2024 11:47:28 +0200
Subject: [PATCH 073/504] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20docstring=20?=
=?UTF-8?q?typos=20in=20http=20security=20(#12223)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Fix docstring typos in http security
---
fastapi/security/http.py | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/fastapi/security/http.py b/fastapi/security/http.py
index a142b135d..e06f3d66d 100644
--- a/fastapi/security/http.py
+++ b/fastapi/security/http.py
@@ -277,7 +277,7 @@ class HTTPBearer(HTTPBase):
bool,
Doc(
"""
- By default, if the HTTP Bearer token not provided (in an
+ By default, if the HTTP Bearer token is not provided (in an
`Authorization` header), `HTTPBearer` will automatically cancel the
request and send the client an error.
@@ -380,7 +380,7 @@ class HTTPDigest(HTTPBase):
bool,
Doc(
"""
- By default, if the HTTP Digest not provided, `HTTPDigest` will
+ By default, if the HTTP Digest is not provided, `HTTPDigest` will
automatically cancel the request and send the client an error.
If `auto_error` is set to `False`, when the HTTP Digest is not
From 7c6f2f8fde68f488163376c9e92a59d46c491298 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 19 Sep 2024 09:47:54 +0000
Subject: [PATCH 074/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 0411bbdda..a8566ceaa 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -11,6 +11,10 @@ hide:
* 📝 Fix small typos in the documentation. PR [#12213](https://github.com/fastapi/fastapi/pull/12213) by [@svlandeg](https://github.com/svlandeg).
+### Internal
+
+* ✏️ Fix docstring typos in http security. PR [#12223](https://github.com/fastapi/fastapi/pull/12223) by [@albertvillanova](https://github.com/albertvillanova).
+
## 0.115.0
### Highlights
From 97ac2286aaa9be8289b43f23cf8e8ddd3356aadb Mon Sep 17 00:00:00 2001
From: marcelomarkus <marcelomarkus@gmail.com>
Date: Fri, 20 Sep 2024 08:00:08 -0300
Subject: [PATCH 075/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/how-to/configure-swagger-ui.md`=20?=
=?UTF-8?q?(#12222)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/how-to/configure-swagger-ui.md | 78 +++++++++++++++++++++
1 file changed, 78 insertions(+)
create mode 100644 docs/pt/docs/how-to/configure-swagger-ui.md
diff --git a/docs/pt/docs/how-to/configure-swagger-ui.md b/docs/pt/docs/how-to/configure-swagger-ui.md
new file mode 100644
index 000000000..b40dad695
--- /dev/null
+++ b/docs/pt/docs/how-to/configure-swagger-ui.md
@@ -0,0 +1,78 @@
+# Configurar Swagger UI
+
+Você pode configurar alguns <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">parâmetros extras da UI do Swagger</a>.
+
+Para configurá-los, passe o argumento `swagger_ui_parameters` ao criar o objeto de aplicativo `FastAPI()` ou para a função `get_swagger_ui_html()`.
+
+`swagger_ui_parameters` recebe um dicionário com as configurações passadas diretamente para o Swagger UI.
+
+O FastAPI converte as configurações para **JSON** para torná-las compatíveis com JavaScript, pois é disso que o Swagger UI precisa.
+
+## Desabilitar realce de sintaxe
+
+Por exemplo, você pode desabilitar o destaque de sintaxe na UI do Swagger.
+
+Sem alterar as configurações, o destaque de sintaxe é habilitado por padrão:
+
+<img src="/img/tutorial/extending-openapi/image02.png">
+
+Mas você pode desabilitá-lo definindo `syntaxHighlight` como `False`:
+
+```Python hl_lines="3"
+{!../../../docs_src/configure_swagger_ui/tutorial001.py!}
+```
+
+...e então o Swagger UI não mostrará mais o destaque de sintaxe:
+
+<img src="/img/tutorial/extending-openapi/image03.png">
+
+## Alterar o tema
+
+Da mesma forma que você pode definir o tema de destaque de sintaxe com a chave `"syntaxHighlight.theme"` (observe que há um ponto no meio):
+
+```Python hl_lines="3"
+{!../../../docs_src/configure_swagger_ui/tutorial002.py!}
+```
+
+Essa configuração alteraria o tema de cores de destaque de sintaxe:
+
+<img src="/img/tutorial/extending-openapi/image04.png">
+
+## Alterar parâmetros de UI padrão do Swagger
+
+O FastAPI inclui alguns parâmetros de configuração padrão apropriados para a maioria dos casos de uso.
+
+Inclui estas configurações padrão:
+
+```Python
+{!../../../fastapi/openapi/docs.py[ln:7-23]!}
+```
+
+Você pode substituir qualquer um deles definindo um valor diferente no argumento `swagger_ui_parameters`.
+
+Por exemplo, para desabilitar `deepLinking` você pode passar essas configurações para `swagger_ui_parameters`:
+
+```Python hl_lines="3"
+{!../../../docs_src/configure_swagger_ui/tutorial003.py!}
+```
+
+## Outros parâmetros da UI do Swagger
+
+Para ver todas as outras configurações possíveis que você pode usar, leia a <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">documentação oficial dos parâmetros da UI do Swagger</a>.
+
+## Configurações somente JavaScript
+
+A interface do usuário do Swagger também permite que outras configurações sejam objetos **somente JavaScript** (por exemplo, funções JavaScript).
+
+O FastAPI também inclui estas configurações de `predefinições` somente para JavaScript:
+
+```JavaScript
+presets: [
+ SwaggerUIBundle.presets.apis,
+ SwaggerUIBundle.SwaggerUIStandalonePreset
+]
+```
+
+Esses são objetos **JavaScript**, não strings, então você não pode passá-los diretamente do código Python.
+
+Se você precisar usar configurações somente JavaScript como essas, você pode usar um dos métodos acima. Sobrescreva todas as *operações de rotas* do Swagger UI e escreva manualmente qualquer JavaScript que você precisar.
From cf93157be74bc4a8d90846938b5ca2dab1ef60b2 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Sep 2024 11:00:31 +0000
Subject: [PATCH 076/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a8566ceaa..79fbdf1b8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -11,6 +11,10 @@ hide:
* 📝 Fix small typos in the documentation. PR [#12213](https://github.com/fastapi/fastapi/pull/12213) by [@svlandeg](https://github.com/svlandeg).
+### Translations
+
+* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/configure-swagger-ui.md`. PR [#12222](https://github.com/fastapi/fastapi/pull/12222) by [@marcelomarkus](https://github.com/marcelomarkus).
+
### Internal
* ✏️ Fix docstring typos in http security. PR [#12223](https://github.com/fastapi/fastapi/pull/12223) by [@albertvillanova](https://github.com/albertvillanova).
From 0b1da2d9101d1bceefb62f77be83debc450135ec Mon Sep 17 00:00:00 2001
From: marcelomarkus <marcelomarkus@gmail.com>
Date: Fri, 20 Sep 2024 08:01:03 -0300
Subject: [PATCH 077/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/deployment/server-workers.md`=20(#?=
=?UTF-8?q?12220)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/deployment/server-workers.md | 152 ++++++++++++++++++++++
1 file changed, 152 insertions(+)
create mode 100644 docs/pt/docs/deployment/server-workers.md
diff --git a/docs/pt/docs/deployment/server-workers.md b/docs/pt/docs/deployment/server-workers.md
new file mode 100644
index 000000000..0d6cd5b39
--- /dev/null
+++ b/docs/pt/docs/deployment/server-workers.md
@@ -0,0 +1,152 @@
+# Trabalhadores do Servidor - Uvicorn com Trabalhadores
+
+Vamos rever os conceitos de implantação anteriores:
+
+* Segurança - HTTPS
+* Executando na inicialização
+* Reinicializações
+* **Replicação (o número de processos em execução)**
+* Memória
+* Etapas anteriores antes de iniciar
+
+Até este ponto, com todos os tutoriais nos documentos, você provavelmente estava executando um **programa de servidor**, por exemplo, usando o comando `fastapi`, que executa o Uvicorn, executando um **único processo**.
+
+Ao implantar aplicativos, você provavelmente desejará ter alguma **replicação de processos** para aproveitar **vários núcleos** e poder lidar com mais solicitações.
+
+Como você viu no capítulo anterior sobre [Conceitos de implantação](concepts.md){.internal-link target=_blank}, há várias estratégias que você pode usar.
+
+Aqui mostrarei como usar o **Uvicorn** com **processos de trabalho** usando o comando `fastapi` ou o comando `uvicorn` diretamente.
+
+/// info | "Informação"
+
+Se você estiver usando contêineres, por exemplo com Docker ou Kubernetes, falarei mais sobre isso no próximo capítulo: [FastAPI em contêineres - Docker](docker.md){.internal-link target=_blank}.
+
+Em particular, ao executar no **Kubernetes** você provavelmente **não** vai querer usar vários trabalhadores e, em vez disso, executar **um único processo Uvicorn por contêiner**, mas falarei sobre isso mais adiante neste capítulo.
+
+///
+
+## Vários trabalhadores
+
+Você pode iniciar vários trabalhadores com a opção de linha de comando `--workers`:
+
+//// tab | `fastapi`
+
+Se você usar o comando `fastapi`:
+
+<div class="termy">
+
+```console
+$ <pre> <font color="#4E9A06">fastapi</font> run --workers 4 <u style="text-decoration-style:single">main.py</u>
+<font color="#3465A4">INFO </font> Using path <font color="#3465A4">main.py</font>
+<font color="#3465A4">INFO </font> Resolved absolute path <font color="#75507B">/home/user/code/awesomeapp/</font><font color="#AD7FA8">main.py</font>
+<font color="#3465A4">INFO </font> Searching for package file structure from directories with <font color="#3465A4">__init__.py</font> files
+<font color="#3465A4">INFO </font> Importing from <font color="#75507B">/home/user/code/</font><font color="#AD7FA8">awesomeapp</font>
+
+ ╭─ <font color="#8AE234"><b>Python module file</b></font> ─╮
+ │ │
+ │ 🐍 main.py │
+ │ │
+ ╰──────────────────────╯
+
+<font color="#3465A4">INFO </font> Importing module <font color="#4E9A06">main</font>
+<font color="#3465A4">INFO </font> Found importable FastAPI app
+
+ ╭─ <font color="#8AE234"><b>Importable FastAPI app</b></font> ─╮
+ │ │
+ │ <span style="background-color:#272822"><font color="#FF4689">from</font></span><span style="background-color:#272822"><font color="#F8F8F2"> main </font></span><span style="background-color:#272822"><font color="#FF4689">import</font></span><span style="background-color:#272822"><font color="#F8F8F2"> app</font></span><span style="background-color:#272822"> </span> │
+ │ │
+ ╰──────────────────────────╯
+
+<font color="#3465A4">INFO </font> Using import string <font color="#8AE234"><b>main:app</b></font>
+
+ <font color="#4E9A06">╭─────────── FastAPI CLI - Production mode ───────────╮</font>
+ <font color="#4E9A06">│ │</font>
+ <font color="#4E9A06">│ Serving at: http://0.0.0.0:8000 │</font>
+ <font color="#4E9A06">│ │</font>
+ <font color="#4E9A06">│ API docs: http://0.0.0.0:8000/docs │</font>
+ <font color="#4E9A06">│ │</font>
+ <font color="#4E9A06">│ Running in production mode, for development use: │</font>
+ <font color="#4E9A06">│ │</font>
+ <font color="#4E9A06">│ </font><font color="#8AE234"><b>fastapi dev</b></font><font color="#4E9A06"> │</font>
+ <font color="#4E9A06">│ │</font>
+ <font color="#4E9A06">╰─────────────────────────────────────────────────────╯</font>
+
+<font color="#4E9A06">INFO</font>: Uvicorn running on <b>http://0.0.0.0:8000</b> (Press CTRL+C to quit)
+<font color="#4E9A06">INFO</font>: Started parent process [<font color="#34E2E2"><b>27365</b></font>]
+<font color="#4E9A06">INFO</font>: Started server process [<font color="#06989A">27368</font>]
+<font color="#4E9A06">INFO</font>: Waiting for application startup.
+<font color="#4E9A06">INFO</font>: Application startup complete.
+<font color="#4E9A06">INFO</font>: Started server process [<font color="#06989A">27369</font>]
+<font color="#4E9A06">INFO</font>: Waiting for application startup.
+<font color="#4E9A06">INFO</font>: Application startup complete.
+<font color="#4E9A06">INFO</font>: Started server process [<font color="#06989A">27370</font>]
+<font color="#4E9A06">INFO</font>: Waiting for application startup.
+<font color="#4E9A06">INFO</font>: Application startup complete.
+<font color="#4E9A06">INFO</font>: Started server process [<font color="#06989A">27367</font>]
+<font color="#4E9A06">INFO</font>: Waiting for application startup.
+<font color="#4E9A06">INFO</font>: Application startup complete.
+</pre>
+```
+
+</div>
+
+////
+
+//// tab | `uvicorn`
+
+Se você preferir usar o comando `uvicorn` diretamente:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --host 0.0.0.0 --port 8080 --workers 4
+<font color="#A6E22E">INFO</font>: Uvicorn running on <b>http://0.0.0.0:8080</b> (Press CTRL+C to quit)
+<font color="#A6E22E">INFO</font>: Started parent process [<font color="#A1EFE4"><b>27365</b></font>]
+<font color="#A6E22E">INFO</font>: Started server process [<font color="#A1EFE4">27368</font>]
+<font color="#A6E22E">INFO</font>: Waiting for application startup.
+<font color="#A6E22E">INFO</font>: Application startup complete.
+<font color="#A6E22E">INFO</font>: Started server process [<font color="#A1EFE4">27369</font>]
+<font color="#A6E22E">INFO</font>: Waiting for application startup.
+<font color="#A6E22E">INFO</font>: Application startup complete.
+<font color="#A6E22E">INFO</font>: Started server process [<font color="#A1EFE4">27370</font>]
+<font color="#A6E22E">INFO</font>: Waiting for application startup.
+<font color="#A6E22E">INFO</font>: Application startup complete.
+<font color="#A6E22E">INFO</font>: Started server process [<font color="#A1EFE4">27367</font>]
+<font color="#A6E22E">INFO</font>: Waiting for application startup.
+<font color="#A6E22E">INFO</font>: Application startup complete.
+```
+
+</div>
+
+////
+
+A única opção nova aqui é `--workers` informando ao Uvicorn para iniciar 4 processos de trabalho.
+
+Você também pode ver que ele mostra o **PID** de cada processo, `27365` para o processo pai (este é o **gerenciador de processos**) e um para cada processo de trabalho: `27368`, `27369`, `27370` e `27367`.
+
+## Conceitos de Implantação
+
+Aqui você viu como usar vários **trabalhadores** para **paralelizar** a execução do aplicativo, aproveitar **vários núcleos** na CPU e conseguir atender **mais solicitações**.
+
+Da lista de conceitos de implantação acima, o uso de trabalhadores ajudaria principalmente com a parte da **replicação** e um pouco com as **reinicializações**, mas você ainda precisa cuidar dos outros:
+
+* **Segurança - HTTPS**
+* **Executando na inicialização**
+* ***Reinicializações***
+* Replicação (o número de processos em execução)
+* **Memória**
+* **Etapas anteriores antes de iniciar**
+
+## Contêineres e Docker
+
+No próximo capítulo sobre [FastAPI em contêineres - Docker](docker.md){.internal-link target=_blank}, explicarei algumas estratégias que você pode usar para lidar com os outros **conceitos de implantação**.
+
+Vou mostrar como **construir sua própria imagem do zero** para executar um único processo Uvicorn. É um processo simples e provavelmente é o que você gostaria de fazer ao usar um sistema de gerenciamento de contêineres distribuídos como o **Kubernetes**.
+
+## Recapitular
+
+Você pode usar vários processos de trabalho com a opção CLI `--workers` com os comandos `fastapi` ou `uvicorn` para aproveitar as vantagens de **CPUs multi-core** e executar **vários processos em paralelo**.
+
+Você pode usar essas ferramentas e ideias se estiver configurando **seu próprio sistema de implantação** enquanto cuida dos outros conceitos de implantação.
+
+Confira o próximo capítulo para aprender sobre **FastAPI** com contêineres (por exemplo, Docker e Kubernetes). Você verá que essas ferramentas têm maneiras simples de resolver os outros **conceitos de implantação** também. ✨
From 4e3db0b6890277149cf87553bf6967c992cdb392 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Sep 2024 11:03:12 +0000
Subject: [PATCH 078/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 79fbdf1b8..161eef6ae 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/server-workers.md`. PR [#12220](https://github.com/fastapi/fastapi/pull/12220) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/configure-swagger-ui.md`. PR [#12222](https://github.com/fastapi/fastapi/pull/12222) by [@marcelomarkus](https://github.com/marcelomarkus).
### Internal
From b1024e73bebcda280839989e4d0461f46de1096e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Gustavo=20Rogel=20de=20Oliveira?=
<joaogustavorogel@hotmail.com>
Date: Fri, 20 Sep 2024 08:10:02 -0300
Subject: [PATCH 079/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/deployment/manually.md`=20(#12210)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/deployment/manually.md | 169 ++++++++++++++++++++++++++++
1 file changed, 169 insertions(+)
create mode 100644 docs/pt/docs/deployment/manually.md
diff --git a/docs/pt/docs/deployment/manually.md b/docs/pt/docs/deployment/manually.md
new file mode 100644
index 000000000..9eff3daaa
--- /dev/null
+++ b/docs/pt/docs/deployment/manually.md
@@ -0,0 +1,169 @@
+# Execute um Servidor Manualmente
+
+## Utilize o comando `fastapi run`
+
+Em resumo, utilize o comando `fastapi run` para inicializar sua aplicação FastAPI:
+
+<div class="termy">
+
+```console
+$ <font color="#4E9A06">fastapi</font> run <u style="text-decoration-style:single">main.py</u>
+<font color="#3465A4">INFO </font> Using path <font color="#3465A4">main.py</font>
+<font color="#3465A4">INFO </font> Resolved absolute path <font color="#75507B">/home/user/code/awesomeapp/</font><font color="#AD7FA8">main.py</font>
+<font color="#3465A4">INFO </font> Searching for package file structure from directories with <font color="#3465A4">__init__.py</font> files
+<font color="#3465A4">INFO </font> Importing from <font color="#75507B">/home/user/code/</font><font color="#AD7FA8">awesomeapp</font>
+
+ ╭─ <font color="#8AE234"><b>Python module file</b></font> ─╮
+ │ │
+ │ 🐍 main.py │
+ │ │
+ ╰──────────────────────╯
+
+<font color="#3465A4">INFO </font> Importing module <font color="#4E9A06">main</font>
+<font color="#3465A4">INFO </font> Found importable FastAPI app
+
+ ╭─ <font color="#8AE234"><b>Importable FastAPI app</b></font> ─╮
+ │ │
+ │ <span style="background-color:#272822"><font color="#FF4689">from</font></span><span style="background-color:#272822"><font color="#F8F8F2"> main </font></span><span style="background-color:#272822"><font color="#FF4689">import</font></span><span style="background-color:#272822"><font color="#F8F8F2"> app</font></span><span style="background-color:#272822"> </span> │
+ │ │
+ ╰──────────────────────────╯
+
+<font color="#3465A4">INFO </font> Using import string <font color="#8AE234"><b>main:app</b></font>
+
+ <font color="#4E9A06">╭─────────── FastAPI CLI - Production mode ───────────╮</font>
+ <font color="#4E9A06">│ │</font>
+ <font color="#4E9A06">│ Serving at: http://0.0.0.0:8000 │</font>
+ <font color="#4E9A06">│ │</font>
+ <font color="#4E9A06">│ API docs: http://0.0.0.0:8000/docs │</font>
+ <font color="#4E9A06">│ │</font>
+ <font color="#4E9A06">│ Running in production mode, for development use: │</font>
+ <font color="#4E9A06">│ │</font>
+ <font color="#4E9A06">│ </font><font color="#8AE234"><b>fastapi dev</b></font><font color="#4E9A06"> │</font>
+ <font color="#4E9A06">│ │</font>
+ <font color="#4E9A06">╰─────────────────────────────────────────────────────╯</font>
+
+<font color="#4E9A06">INFO</font>: Started server process [<font color="#06989A">2306215</font>]
+<font color="#4E9A06">INFO</font>: Waiting for application startup.
+<font color="#4E9A06">INFO</font>: Application startup complete.
+<font color="#4E9A06">INFO</font>: Uvicorn running on <b>http://0.0.0.0:8000</b> (Press CTRL+C to quit)
+```
+
+</div>
+
+Isto deve funcionar para a maioria dos casos. 😎
+
+Você pode utilizar esse comando, por exemplo, para iniciar sua aplicação **FastAPI** em um contêiner, em um servidor, etc.
+
+## Servidores ASGI
+
+Vamos nos aprofundar um pouco mais em detalhes.
+
+FastAPI utiliza um padrão para construir frameworks e servidores web em Python chamado <abbr title="Asynchronous Server Gateway Interface">ASGI</abbr>. FastAPI é um framework web ASGI.
+
+A principal coisa que você precisa para executar uma aplicação **FastAPI** (ou qualquer outra aplicação ASGI) em uma máquina de servidor remoto é um programa de servidor ASGI como o **Uvicorn**, que é o que vem por padrão no comando `fastapi`.
+
+Existem diversas alternativas, incluindo:
+
+* <a href="https://www.uvicorn.org/" class="external-link" target="_blank">Uvicorn</a>: um servidor ASGI de alta performance.
+* <a href="https://hypercorn.readthedocs.io/" class="external-link" target="_blank">Hypercorn</a>: um servidor ASGI compátivel com HTTP/2, Trio e outros recursos.
+* <a href="https://github.com/django/daphne" class="external-link" target="_blank">Daphne</a>: servidor ASGI construído para Django Channels.
+* <a href="https://github.com/emmett-framework/granian" class="external-link" target="_blank">Granian</a>: um servidor HTTP Rust para aplicações Python.
+* <a href="https://unit.nginx.org/howto/fastapi/" class="external-link" target="_blank">NGINX Unit</a>: NGINX Unit é um runtime de aplicação web leve e versátil.
+
+## Máquina Servidora e Programa Servidor
+
+Existe um pequeno detalhe sobre estes nomes para se manter em mente. 💡
+
+A palavra "**servidor**" é comumente usada para se referir tanto ao computador remoto/nuvem (a máquina física ou virtual) quanto ao programa que está sendo executado nessa máquina (por exemplo, Uvicorn).
+
+Apenas tenha em mente que quando você ler "servidor" em geral, isso pode se referir a uma dessas duas coisas.
+
+Quando se refere à máquina remota, é comum chamá-la de **servidor**, mas também de **máquina**, **VM** (máquina virtual), **nó**. Todos esses termos se referem a algum tipo de máquina remota, normalmente executando Linux, onde você executa programas.
+
+## Instale o Programa Servidor
+
+Quando você instala o FastAPI, ele vem com um servidor de produção, o Uvicorn, e você pode iniciá-lo com o comando `fastapi run`.
+
+Mas você também pode instalar um servidor ASGI manualmente.
+
+Certifique-se de criar um [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, ativá-lo e, em seguida, você pode instalar a aplicação do servidor.
+
+Por exemplo, para instalar o Uvicorn:
+
+<div class="termy">
+
+```console
+$ pip install "uvicorn[standard]"
+
+---> 100%
+```
+
+</div>
+
+Um processo semelhante se aplicaria a qualquer outro programa de servidor ASGI.
+
+/// tip | "Dica"
+
+Adicionando o `standard`, o Uvicorn instalará e usará algumas dependências extras recomendadas.
+
+Isso inclui o `uvloop`, a substituição de alto desempenho para `asyncio`, que fornece um grande aumento de desempenho de concorrência.
+
+Quando você instala o FastAPI com algo como `pip install "fastapi[standard]"`, você já obtém `uvicorn[standard]` também.
+
+///
+
+## Execute o Programa Servidor
+
+Se você instalou um servidor ASGI manualmente, normalmente precisará passar uma string de importação em um formato especial para que ele importe sua aplicação FastAPI:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --host 0.0.0.0 --port 80
+
+<span style="color: green;">INFO</span>: Uvicorn running on http://0.0.0.0:80 (Press CTRL+C to quit)
+```
+
+</div>
+
+/// note | "Nota"
+
+O comando `uvicorn main:app` refere-se a:
+
+* `main`: o arquivo `main.py` (o "módulo" Python).
+* `app`: o objeto criado dentro de `main.py` com a linha `app = FastAPI()`.
+
+É equivalente a:
+
+```Python
+from main import app
+```
+
+///
+
+Cada programa de servidor ASGI alternativo teria um comando semelhante, você pode ler mais na documentação respectiva.
+
+/// warning | "Aviso"
+
+Uvicorn e outros servidores suportam a opção `--reload` que é útil durante o desenvolvimento.
+
+A opção `--reload` consome muito mais recursos, é mais instável, etc.
+
+Ela ajuda muito durante o **desenvolvimento**, mas você **não deve** usá-la em **produção**.
+
+///
+
+## Conceitos de Implantação
+
+Esses exemplos executam o programa do servidor (por exemplo, Uvicorn), iniciando **um único processo**, ouvindo em todos os IPs (`0.0.0.0`) em uma porta predefinida (por exemplo, `80`).
+
+Esta é a ideia básica. Mas você provavelmente vai querer cuidar de algumas coisas adicionais, como:
+
+* Segurança - HTTPS
+* Executando na inicialização
+* Reinicializações
+* Replicação (o número de processos em execução)
+* Memória
+* Passos anteriores antes de começar
+
+Vou te contar mais sobre cada um desses conceitos, como pensar sobre eles e alguns exemplos concretos com estratégias para lidar com eles nos próximos capítulos. 🚀
From 2459a009f43b96dc86e04e94d2a996983626ffce Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Sep 2024 11:11:21 +0000
Subject: [PATCH 080/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 161eef6ae..9e44bbf45 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/manually.md`. PR [#12210](https://github.com/fastapi/fastapi/pull/12210) by [@JoaoGustavoRogel](https://github.com/JoaoGustavoRogel).
* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/server-workers.md`. PR [#12220](https://github.com/fastapi/fastapi/pull/12220) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/configure-swagger-ui.md`. PR [#12222](https://github.com/fastapi/fastapi/pull/12222) by [@marcelomarkus](https://github.com/marcelomarkus).
From 6aefc316008fa920a93493b6f458b1fe3b5c1324 Mon Sep 17 00:00:00 2001
From: Max Scheijen <47034840+maxscheijen@users.noreply.github.com>
Date: Fri, 20 Sep 2024 13:13:32 +0200
Subject: [PATCH 081/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Dutch=20translatio?=
=?UTF-8?q?n=20for=20`docs/nl/docs/environment-variables.md`=20(#12200)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/nl/docs/environment-variables.md | 298 ++++++++++++++++++++++++++
1 file changed, 298 insertions(+)
create mode 100644 docs/nl/docs/environment-variables.md
diff --git a/docs/nl/docs/environment-variables.md b/docs/nl/docs/environment-variables.md
new file mode 100644
index 000000000..f6b3d285b
--- /dev/null
+++ b/docs/nl/docs/environment-variables.md
@@ -0,0 +1,298 @@
+# Omgevingsvariabelen
+
+/// tip
+
+Als je al weet wat "omgevingsvariabelen" zijn en hoe je ze kunt gebruiken, kun je deze stap gerust overslaan.
+
+///
+
+Een omgevingsvariabele (ook bekend als "**env var**") is een variabele die **buiten** de Python-code leeft, in het **besturingssysteem** en die door je Python-code (of door andere programma's) kan worden gelezen.
+
+Omgevingsvariabelen kunnen nuttig zijn voor het bijhouden van applicatie **instellingen**, als onderdeel van de **installatie** van Python, enz.
+
+## Omgevingsvariabelen maken en gebruiken
+
+Je kunt omgevingsvariabelen **maken** en gebruiken in de **shell (terminal)**, zonder dat je Python nodig hebt:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// Je zou een omgevingsvariabele MY_NAME kunnen maken met
+$ export MY_NAME="Wade Wilson"
+
+// Dan zou je deze met andere programma's kunnen gebruiken, zoals
+$ echo "Hello $MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// Maak een omgevingsvariabel MY_NAME
+$ $Env:MY_NAME = "Wade Wilson"
+
+// Gebruik het met andere programma's, zoals
+$ echo "Hello $Env:MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+## Omgevingsvariabelen uitlezen in Python
+
+Je kunt omgevingsvariabelen **buiten** Python aanmaken, in de terminal (of met een andere methode) en ze vervolgens **in Python uitlezen**.
+
+Je kunt bijvoorbeeld een bestand `main.py` hebben met:
+
+```Python hl_lines="3"
+import os
+
+name = os.getenv("MY_NAME", "World")
+print(f"Hello {name} from Python")
+```
+
+/// tip
+
+Het tweede argument van <a href="https://docs.python.org/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> is de standaardwaarde die wordt geretourneerd.
+
+Als je dit niet meegeeft, is de standaardwaarde `None`. In dit geval gebruiken we standaard `"World"`.
+
+///
+
+Dan zou je dat Python-programma kunnen aanroepen:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// Hier stellen we de omgevingsvariabelen nog niet in
+$ python main.py
+
+// Omdat we de omgevingsvariabelen niet hebben ingesteld, krijgen we de standaardwaarde
+
+Hello World from Python
+
+// Maar als we eerst een omgevingsvariabele aanmaken
+$ export MY_NAME="Wade Wilson"
+
+// en het programma dan opnieuw aanroepen
+$ python main.py
+
+// kan het de omgevingsvariabele nu wel uitlezen
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// Hier stellen we de omgevingsvariabelen nog niet in
+$ python main.py
+
+// Omdat we de omgevingsvariabelen niet hebben ingesteld, krijgen we de standaardwaarde
+
+Hello World from Python
+
+// Maar als we eerst een omgevingsvariabele aanmaken
+$ $Env:MY_NAME = "Wade Wilson"
+
+// en het programma dan opnieuw aanroepen
+$ python main.py
+
+// kan het de omgevingsvariabele nu wel uitlezen
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+Omdat omgevingsvariabelen buiten de code kunnen worden ingesteld, maar wel door de code kunnen worden gelezen en niet hoeven te worden opgeslagen (gecommit naar `git`) met de rest van de bestanden, worden ze vaak gebruikt voor configuraties of **instellingen**.
+
+Je kunt ook een omgevingsvariabele maken die alleen voor een **specifieke programma-aanroep** beschikbaar is, die alleen voor dat programma beschikbaar is en alleen voor de duur van dat programma.
+
+Om dat te doen, maak je het vlak voor het programma zelf aan, op dezelfde regel:
+
+<div class="termy">
+
+```console
+// Maak een omgevingsvariabele MY_NAME in de regel voor deze programma-aanroep
+$ MY_NAME="Wade Wilson" python main.py
+
+// Nu kan het de omgevingsvariabele lezen
+
+Hello Wade Wilson from Python
+
+// De omgevingsvariabelen bestaan daarna niet meer
+$ python main.py
+
+Hello World from Python
+```
+
+</div>
+
+/// tip
+
+Je kunt er meer over lezen op <a href="https://12factor.net/config" class="external-link" target="_blank">The Twelve-Factor App: Config</a>.
+
+///
+
+## Types en Validatie
+
+Deze omgevingsvariabelen kunnen alleen **tekstuele gegevens** verwerken, omdat ze extern zijn aan Python, compatibel moeten zijn met andere programma's en de rest van het systeem (zelfs met verschillende besturingssystemen, zoals Linux, Windows en macOS).
+
+Dat betekent dat **elke waarde** die in Python uit een omgevingsvariabele wordt gelezen **een `str` zal zijn** en dat elke conversie naar een ander type of elke validatie in de code moet worden uitgevoerd.
+
+Meer informatie over het gebruik van omgevingsvariabelen voor het verwerken van **applicatie instellingen** vind je in de [Geavanceerde gebruikershandleiding - Instellingen en Omgevingsvariabelen](./advanced/settings.md){.internal-link target=_blank}.
+
+## `PATH` Omgevingsvariabele
+
+Er is een **speciale** omgevingsvariabele met de naam **`PATH`**, die door de besturingssystemen (Linux, macOS, Windows) wordt gebruikt om programma's te vinden die uitgevoerd kunnen worden.
+
+De waarde van de variabele `PATH` is een lange string die bestaat uit mappen die gescheiden worden door een dubbele punt `:` op Linux en macOS en door een puntkomma `;` op Windows.
+
+De omgevingsvariabele `PATH` zou er bijvoorbeeld zo uit kunnen zien:
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+Dit betekent dat het systeem naar programma's zoekt in de mappen:
+
+* `/usr/local/bin`
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32
+```
+
+Dit betekent dat het systeem naar programma's zoekt in de mappen:
+
+* `C:\Program Files\Python312\Scripts`
+* `C:\Program Files\Python312`
+* `C:\Windows\System32`
+
+////
+
+Wanneer je een **opdracht** in de terminal typt, **zoekt** het besturingssysteem naar het programma in **elk van de mappen** die vermeld staan in de omgevingsvariabele `PATH`.
+
+Wanneer je bijvoorbeeld `python` in de terminal typt, zoekt het besturingssysteem naar een programma met de naam `python` in de **eerste map** in die lijst.
+
+Zodra het gevonden wordt, zal het dat programma **gebruiken**. Anders blijft het in de **andere mappen** zoeken.
+
+### Python installeren en `PATH` bijwerken
+
+Wanneer je Python installeert, word je mogelijk gevraagd of je de omgevingsvariabele `PATH` wilt bijwerken.
+
+//// tab | Linux, macOS
+
+Stel dat je Python installeert en het komt terecht in de map `/opt/custompython/bin`.
+
+Als je kiest om de `PATH` omgevingsvariabele bij te werken, zal het installatieprogramma `/opt/custompython/bin` toevoegen aan de `PATH` omgevingsvariabele.
+
+Dit zou er zo uit kunnen zien:
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin
+```
+
+Op deze manier zal het systeem, wanneer je `python` in de terminal typt, het Python-programma in `/opt/custompython/bin` (de laatste map) vinden en dat gebruiken.
+
+////
+
+//// tab | Windows
+
+Stel dat je Python installeert en het komt terecht in de map `C:\opt\custompython\bin`.
+
+Als je kiest om de `PATH` omgevingsvariabele bij te werken, zal het installatieprogramma `C:\opt\custompython\bin` toevoegen aan de `PATH` omgevingsvariabele.
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin
+```
+
+Op deze manier zal het systeem, wanneer je `python` in de terminal typt, het Python-programma in `C:\opt\custompython\bin` (de laatste map) vinden en dat gebruiken.
+
+////
+
+Dus als je typt:
+
+<div class="termy">
+
+```console
+$ python
+```
+
+</div>
+
+//// tab | Linux, macOS
+
+Zal het systeem het `python`-programma in `/opt/custompython/bin` **vinden** en uitvoeren.
+
+Het zou ongeveer hetzelfde zijn als het typen van:
+
+<div class="termy">
+
+```console
+$ /opt/custompython/bin/python
+```
+
+</div>
+
+////
+
+//// tab | Windows
+
+Zal het systeem het `python`-programma in `C:\opt\custompython\bin\python` **vinden** en uitvoeren.
+
+Het zou ongeveer hetzelfde zijn als het typen van:
+
+<div class="termy">
+
+```console
+$ C:\opt\custompython\bin\python
+```
+
+</div>
+
+////
+
+Deze informatie is handig wanneer je meer wilt weten over [virtuele omgevingen](virtual-environments.md){.internal-link target=_blank}.
+
+## Conclusion
+
+Hiermee heb je basiskennis van wat **omgevingsvariabelen** zijn en hoe je ze in Python kunt gebruiken.
+
+Je kunt er ook meer over lezen op de <a href="https://en.wikipedia.org/wiki/Environment_variable" class="external-link" target="_blank">Wikipedia over omgevingsvariabelen</a>.
+
+In veel gevallen is het niet direct duidelijk hoe omgevingsvariabelen nuttig zijn en hoe je ze moet toepassen. Maar ze blijven in veel verschillende scenario's opduiken als je aan het ontwikkelen bent, dus het is goed om er meer over te weten.
+
+Je hebt deze informatie bijvoorbeeld nodig in de volgende sectie, over [Virtuele Omgevingen](virtual-environments.md).
From 13e20228a92acadac0175ec61a7dd50c695708b0 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Sep 2024 11:15:35 +0000
Subject: [PATCH 082/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9e44bbf45..30d9280a3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Dutch translation for `docs/nl/docs/environment-variables.md`. PR [#12200](https://github.com/fastapi/fastapi/pull/12200) by [@maxscheijen](https://github.com/maxscheijen).
* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/manually.md`. PR [#12210](https://github.com/fastapi/fastapi/pull/12210) by [@JoaoGustavoRogel](https://github.com/JoaoGustavoRogel).
* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/server-workers.md`. PR [#12220](https://github.com/fastapi/fastapi/pull/12220) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/configure-swagger-ui.md`. PR [#12222](https://github.com/fastapi/fastapi/pull/12222) by [@marcelomarkus](https://github.com/marcelomarkus).
From 2cdf111e61a6ef8499be8722f2a036f3cd82b46a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Javier=20S=C3=A1nchez=20Castro?=
<72013291+JavierSanchezCastro@users.noreply.github.com>
Date: Fri, 20 Sep 2024 13:34:07 +0200
Subject: [PATCH 083/504] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typo=20in=20?=
=?UTF-8?q?`docs/es/docs/python-types.md`=20(#12235)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/es/docs/python-types.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/es/docs/python-types.md b/docs/es/docs/python-types.md
index 4015dbb05..c873385bc 100644
--- a/docs/es/docs/python-types.md
+++ b/docs/es/docs/python-types.md
@@ -46,7 +46,7 @@ La función hace lo siguiente:
Es un programa muy simple.
-Ahora, imagina que lo estás escribiendo desde ceros.
+Ahora, imagina que lo estás escribiendo desde cero.
En algún punto habrías comenzado con la definición de la función, tenías los parámetros listos...
From f6dfb832c59c1bdacbad6dc2ee7bb97d08381339 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Sep 2024 11:34:29 +0000
Subject: [PATCH 084/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 30d9280a3..3ca428393 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* ✏️ Fix typo in `docs/es/docs/python-types.md`. PR [#12235](https://github.com/fastapi/fastapi/pull/12235) by [@JavierSanchezCastro](https://github.com/JavierSanchezCastro).
* 🌐 Add Dutch translation for `docs/nl/docs/environment-variables.md`. PR [#12200](https://github.com/fastapi/fastapi/pull/12200) by [@maxscheijen](https://github.com/maxscheijen).
* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/manually.md`. PR [#12210](https://github.com/fastapi/fastapi/pull/12210) by [@JoaoGustavoRogel](https://github.com/JoaoGustavoRogel).
* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/server-workers.md`. PR [#12220](https://github.com/fastapi/fastapi/pull/12220) by [@marcelomarkus](https://github.com/marcelomarkus).
From 6a2ad7031cb8e073fc11b3349816a8f48fca1864 Mon Sep 17 00:00:00 2001
From: marcelomarkus <marcelomarkus@gmail.com>
Date: Sat, 21 Sep 2024 18:37:48 -0300
Subject: [PATCH 085/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/deployment/cloud.md`=20(#12217)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/deployment/cloud.md | 17 +++++++++++++++++
1 file changed, 17 insertions(+)
create mode 100644 docs/pt/docs/deployment/cloud.md
diff --git a/docs/pt/docs/deployment/cloud.md b/docs/pt/docs/deployment/cloud.md
new file mode 100644
index 000000000..e6522f50f
--- /dev/null
+++ b/docs/pt/docs/deployment/cloud.md
@@ -0,0 +1,17 @@
+# Implantar FastAPI em provedores de nuvem
+
+Você pode usar praticamente **qualquer provedor de nuvem** para implantar seu aplicativo FastAPI.
+
+Na maioria dos casos, os principais provedores de nuvem têm guias para implantar o FastAPI com eles.
+
+## Provedores de Nuvem - Patrocinadores
+
+Alguns provedores de nuvem ✨ [**patrocinam o FastAPI**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨, o que garante o **desenvolvimento** contínuo e saudável do FastAPI e seu **ecossistema**.
+
+E isso mostra seu verdadeiro comprometimento com o FastAPI e sua **comunidade** (você), pois eles não querem apenas fornecer a você um **bom serviço**, mas também querem ter certeza de que você tenha uma **estrutura boa e saudável**, o FastAPI. 🙇
+
+Talvez você queira experimentar os serviços deles e seguir os guias:
+
+* <a href="https://docs.platform.sh/languages/python.html?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" class="external-link" target="_blank">Platform.sh</a>
+* <a href="https://docs.porter.run/language-specific-guides/fastapi" class="external-link" target="_blank">Porter</a>
+* <a href="https://www.withcoherence.com/?utm_medium=advertising&utm_source=fastapi&utm_campaign=website" class="external-link" target="_blank">Coherence</a>
From 9606b916ef7c883f5ebeac1bf3db9adf5ae646a9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 21 Sep 2024 21:38:11 +0000
Subject: [PATCH 086/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3ca428393..c345b6045 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/cloud.md`. PR [#12217](https://github.com/fastapi/fastapi/pull/12217) by [@marcelomarkus](https://github.com/marcelomarkus).
* ✏️ Fix typo in `docs/es/docs/python-types.md`. PR [#12235](https://github.com/fastapi/fastapi/pull/12235) by [@JavierSanchezCastro](https://github.com/JavierSanchezCastro).
* 🌐 Add Dutch translation for `docs/nl/docs/environment-variables.md`. PR [#12200](https://github.com/fastapi/fastapi/pull/12200) by [@maxscheijen](https://github.com/maxscheijen).
* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/manually.md`. PR [#12210](https://github.com/fastapi/fastapi/pull/12210) by [@JoaoGustavoRogel](https://github.com/JoaoGustavoRogel).
From d9e989e274e9224c20f1847c2110896c2a4cc23d Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
<66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 24 Sep 2024 12:14:00 +0200
Subject: [PATCH 087/504] =?UTF-8?q?=E2=AC=86=20[pre-commit.ci]=20pre-commi?=
=?UTF-8?q?t=20autoupdate=20(#12253)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
updates:
- [github.com/astral-sh/ruff-pre-commit: v0.6.5 → v0.6.7](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.5...v0.6.7)
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
.pre-commit-config.yaml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 4b1b10a68..1502f0abd 100644
--- a/.pre-commit-config.yaml
+++ b/.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.6.5
+ rev: v0.6.7
hooks:
- id: ruff
args:
From 10f3cb5ab1d5e2848146b85256df056c1bcc9753 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 24 Sep 2024 10:14:28 +0000
Subject: [PATCH 088/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c345b6045..8a6f2d8be 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -22,6 +22,7 @@ hide:
### Internal
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12253](https://github.com/fastapi/fastapi/pull/12253) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* ✏️ Fix docstring typos in http security. PR [#12223](https://github.com/fastapi/fastapi/pull/12223) by [@albertvillanova](https://github.com/albertvillanova).
## 0.115.0
From bb018fc46cac48fd51675dfbbeb8d9b3b204fdc2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 26 Sep 2024 19:17:21 +0200
Subject: [PATCH 089/504] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20rem?=
=?UTF-8?q?ove=20Fine.dev=20(#12271)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
README.md | 1 -
docs/en/data/sponsors.yml | 3 ---
docs/en/overrides/main.html | 6 ------
3 files changed, 10 deletions(-)
diff --git a/README.md b/README.md
index 3b01b713a..f274265de 100644
--- a/README.md
+++ b/README.md
@@ -55,7 +55,6 @@ The key features are:
<a href="https://www.withcoherence.com/?utm_medium=advertising&utm_source=fastapi&utm_campaign=website" target="_blank" title="Coherence"><img src="https://fastapi.tiangolo.com/img/sponsors/coherence.png"></a>
<a href="https://www.mongodb.com/developer/languages/python/python-quickstart-fastapi/?utm_campaign=fastapi_framework&utm_source=fastapi_sponsorship&utm_medium=web_referral" target="_blank" title="Simplify Full Stack Development with FastAPI & MongoDB"><img src="https://fastapi.tiangolo.com/img/sponsors/mongodb.png"></a>
<a href="https://zuplo.link/fastapi-gh" target="_blank" title="Zuplo: Scale, Protect, Document, and Monetize your FastAPI"><img src="https://fastapi.tiangolo.com/img/sponsors/zuplo.png"></a>
-<a href="https://fine.dev?ref=fastapibadge" target="_blank" title="Fine's AI FastAPI Workflow: Effortlessly Deploy and Integrate FastAPI into Your Project"><img src="https://fastapi.tiangolo.com/img/sponsors/fine.png"></a>
<a href="https://liblab.com?utm_source=fastapi" target="_blank" title="liblab - Generate SDKs from FastAPI"><img src="https://fastapi.tiangolo.com/img/sponsors/liblab.png"></a>
<a href="https://github.com/deepset-ai/haystack/" target="_blank" title="Build powerful search from composable, open source building blocks"><img src="https://fastapi.tiangolo.com/img/sponsors/haystack-fastapi.svg"></a>
<a href="https://databento.com/" target="_blank" title="Pay as you go for market data"><img src="https://fastapi.tiangolo.com/img/sponsors/databento.svg"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index d96646fb3..6db9c509a 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -26,9 +26,6 @@ gold:
- url: https://zuplo.link/fastapi-gh
title: 'Zuplo: Scale, Protect, Document, and Monetize your FastAPI'
img: https://fastapi.tiangolo.com/img/sponsors/zuplo.png
- - url: https://fine.dev?ref=fastapibadge
- title: "Fine's AI FastAPI Workflow: Effortlessly Deploy and Integrate FastAPI into Your Project"
- img: https://fastapi.tiangolo.com/img/sponsors/fine.png
- url: https://liblab.com?utm_source=fastapi
title: liblab - Generate SDKs from FastAPI
img: https://fastapi.tiangolo.com/img/sponsors/liblab.png
diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index 463c5af3b..462907e7c 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -76,12 +76,6 @@
<img class="sponsor-image" src="/img/sponsors/zuplo-banner.png" />
</a>
</div>
- <div class="item">
- <a title="Fine's AI FastAPI Workflow: Effortlessly Deploy and Integrate FastAPI into Your Project" style="display: block; position: relative;" href="https://fine.dev?ref=fastapibanner" target="_blank">
- <span class="sponsor-badge">sponsor</span>
- <img class="sponsor-image" src="/img/sponsors/fine-banner.png" />
- </a>
- </div>
<div class="item">
<a title="liblab - Generate SDKs from FastAPI" style="display: block; position: relative;" href="https://liblab.com?utm_source=fastapi" target="_blank">
<span class="sponsor-badge">sponsor</span>
From 847296e885ed83bc333b6cc0a3000d6242083b87 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 26 Sep 2024 17:17:48 +0000
Subject: [PATCH 090/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8a6f2d8be..885112a6a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -22,6 +22,7 @@ hide:
### Internal
+* 🔧 Update sponsors, remove Fine.dev. PR [#12271](https://github.com/fastapi/fastapi/pull/12271) by [@tiangolo](https://github.com/tiangolo).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12253](https://github.com/fastapi/fastapi/pull/12253) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* ✏️ Fix docstring typos in http security. PR [#12223](https://github.com/fastapi/fastapi/pull/12223) by [@albertvillanova](https://github.com/albertvillanova).
From f0ebae6e9ec1fdbef7720968ee9eadf5d9ad8045 Mon Sep 17 00:00:00 2001
From: Anderson Rocha <anderson-rocha@outlook.com>
Date: Fri, 4 Oct 2024 11:55:49 +0100
Subject: [PATCH 091/504] =?UTF-8?q?=20=F0=9F=8C=90=20Update=20Portuguese?=
=?UTF-8?q?=20translation=20for=20`docs/pt/docs/advanced/security/http-bas?=
=?UTF-8?q?ic-auth.md`=20(#12275)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../docs/advanced/security/http-basic-auth.md | 18 +++++++++---------
1 file changed, 9 insertions(+), 9 deletions(-)
diff --git a/docs/pt/docs/advanced/security/http-basic-auth.md b/docs/pt/docs/advanced/security/http-basic-auth.md
index 12b8ab01c..103d622c7 100644
--- a/docs/pt/docs/advanced/security/http-basic-auth.md
+++ b/docs/pt/docs/advanced/security/http-basic-auth.md
@@ -62,7 +62,7 @@ Utilize uma dependência para verificar se o usuário e a senha estão corretos.
Para isso, utilize o módulo padrão do Python <a href="https://docs.python.org/3/library/secrets.html" class="external-link" target="_blank">`secrets`</a> para verificar o usuário e senha.
-O `secrets.compare_digest()` necessita receber `bytes` ou `str` que possuem apenas caracteres ASCII (os em Inglês). Isso significa que não funcionaria com caracteres como o `á`, como em `Sebastián`.
+O `secrets.compare_digest()` necessita receber `bytes` ou `str` que possuem apenas caracteres ASCII (os em inglês). Isso significa que não funcionaria com caracteres como o `á`, como em `Sebastián`.
Para lidar com isso, primeiramente nós convertemos o `username` e o `password` para `bytes`, codificando-os com UTF-8.
@@ -106,11 +106,11 @@ if not (credentials.username == "stanleyjobson") or not (credentials.password ==
...
```
-Porém ao utilizar o `secrets.compare_digest()`, isso estará seguro contra um tipo de ataque chamado "ataque de temporização (timing attacks)".
+Porém, ao utilizar o `secrets.compare_digest()`, isso estará seguro contra um tipo de ataque chamado "timing attacks" (ataques de temporização).
### Ataques de Temporização
-Mas o que é um "ataque de temporização"?
+Mas o que é um "timing attack" (ataque de temporização)?
Vamos imaginar que alguns invasores estão tentando adivinhar o usuário e a senha.
@@ -125,7 +125,7 @@ if "johndoe" == "stanleyjobson" and "love123" == "swordfish":
Mas no exato momento que o Python compara o primeiro `j` em `johndoe` contra o primeiro `s` em `stanleyjobson`, ele retornará `False`, porque ele já sabe que aquelas duas strings não são a mesma, pensando que "não existe a necessidade de desperdiçar mais poder computacional comparando o resto das letras". E a sua aplicação dirá "Usuário ou senha incorretos".
-Mas então os invasores vão tentar com o usuário `stanleyjobsox` e a senha `love123`.
+Então os invasores vão tentar com o usuário `stanleyjobsox` e a senha `love123`.
E a sua aplicação faz algo como:
@@ -134,11 +134,11 @@ if "stanleyjobsox" == "stanleyjobson" and "love123" == "swordfish":
...
```
-O Python terá que comparar todo o `stanleyjobso` tanto em `stanleyjobsox` como em `stanleyjobson` antes de perceber que as strings não são a mesma. Então isso levará alguns microsegundos a mais para retornar "Usuário ou senha incorretos".
+O Python terá que comparar todo o `stanleyjobso` tanto em `stanleyjobsox` como em `stanleyjobson` antes de perceber que as strings não são a mesma. Então isso levará alguns microssegundos a mais para retornar "Usuário ou senha incorretos".
#### O tempo para responder ajuda os invasores
-Neste ponto, ao perceber que o servidor demorou alguns microsegundos a mais para enviar o retorno "Usuário ou senha incorretos", os invasores irão saber que eles acertaram _alguma coisa_, algumas das letras iniciais estavam certas.
+Neste ponto, ao perceber que o servidor demorou alguns microssegundos a mais para enviar o retorno "Usuário ou senha incorretos", os invasores irão saber que eles acertaram _alguma coisa_, algumas das letras iniciais estavam certas.
E eles podem tentar de novo sabendo que provavelmente é algo mais parecido com `stanleyjobsox` do que com `johndoe`.
@@ -150,16 +150,16 @@ Mas fazendo isso, em alguns minutos ou horas os invasores teriam adivinhado o us
#### Corrija com o `secrets.compare_digest()`
-Mas em nosso código nós estamos utilizando o `secrets.compare_digest()`.
+Mas em nosso código já estamos utilizando o `secrets.compare_digest()`.
Resumindo, levará o mesmo tempo para comparar `stanleyjobsox` com `stanleyjobson` do que comparar `johndoe` com `stanleyjobson`. E o mesmo para a senha.
-Deste modo, ao utilizar `secrets.compare_digest()` no código de sua aplicação, ela esterá a salvo contra toda essa gama de ataques de segurança.
+Deste modo, ao utilizar `secrets.compare_digest()` no código de sua aplicação, ela estará a salvo contra toda essa gama de ataques de segurança.
### Retorne o erro
-Depois de detectar que as credenciais estão incorretas, retorne um `HTTPException` com o status 401 (o mesmo retornado quando nenhuma credencial foi informada) e adicione o cabeçalho `WWW-Authenticate` para fazer com que o navegador mostre o prompt de login novamente:
+Após detectar que as credenciais estão incorretas, retorne um `HTTPException` com o status 401 (o mesmo retornado quando nenhuma credencial foi informada) e adicione o cabeçalho `WWW-Authenticate` para fazer com que o navegador mostre o prompt de login novamente:
//// tab | Python 3.9+
From 919721ce8d08c04e5dbf657481502539a92ddad0 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 10:56:12 +0000
Subject: [PATCH 092/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 885112a6a..242981548 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Update Portuguese translation for `docs/pt/docs/advanced/security/http-basic-auth.md`. PR [#12275](https://github.com/fastapi/fastapi/pull/12275) by [@andersonrocha0](https://github.com/andersonrocha0).
* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/cloud.md`. PR [#12217](https://github.com/fastapi/fastapi/pull/12217) by [@marcelomarkus](https://github.com/marcelomarkus).
* ✏️ Fix typo in `docs/es/docs/python-types.md`. PR [#12235](https://github.com/fastapi/fastapi/pull/12235) by [@JavierSanchezCastro](https://github.com/JavierSanchezCastro).
* 🌐 Add Dutch translation for `docs/nl/docs/environment-variables.md`. PR [#12200](https://github.com/fastapi/fastapi/pull/12200) by [@maxscheijen](https://github.com/maxscheijen).
From 0030f1749e4e74a4cfd58f59d85f7c4c279d239d Mon Sep 17 00:00:00 2001
From: kkotipy <kkotipy@gmail.com>
Date: Fri, 4 Oct 2024 19:57:17 +0900
Subject: [PATCH 093/504] =?UTF-8?q?=F0=9F=8C=90=20Fix=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/tutorial/index.md`=20(#12278)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/tutorial/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/ko/docs/tutorial/index.md b/docs/ko/docs/tutorial/index.md
index d00a942f0..a148bc76e 100644
--- a/docs/ko/docs/tutorial/index.md
+++ b/docs/ko/docs/tutorial/index.md
@@ -30,7 +30,7 @@ $ uvicorn main:app --reload
코드를 작성하거나 복사, 편집할 때, 로컬 환경에서 실행하는 것을 **강력히 권장**합니다.
-로컬 편집기에서 사용한다면, 모든 타입 검사와 자동완성 등 작성해야 하는 코드가 얼마나 적은지 보면서 FastAPI의 비로소 경험할 수 있습니다.
+로컬 편집기에서 사용한다면, 모든 타입 검사와 자동완성 등 작성해야 하는 코드가 얼마나 적은지 보면서 FastAPI의 이점을 비로소 경험할 수 있습니다.
---
From ca68c99a6eebec8d665517a88e34a514255aa36b Mon Sep 17 00:00:00 2001
From: Rafael de Oliveira Marques <rafaelomarques@gmail.com>
Date: Fri, 4 Oct 2024 07:58:03 -0300
Subject: [PATCH 094/504] =?UTF-8?q?=F0=9F=8C=90=20Update=20Portuguese=20tr?=
=?UTF-8?q?anslation=20for=20`docs/pt/docs/tutorial/cookie-params.md`=20(#?=
=?UTF-8?q?12297)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/tutorial/cookie-params.md | 109 +++++++++++++++++++++++--
1 file changed, 103 insertions(+), 6 deletions(-)
diff --git a/docs/pt/docs/tutorial/cookie-params.md b/docs/pt/docs/tutorial/cookie-params.md
index caed17632..bb59dcd2c 100644
--- a/docs/pt/docs/tutorial/cookie-params.md
+++ b/docs/pt/docs/tutorial/cookie-params.md
@@ -6,21 +6,118 @@ Você pode definir parâmetros de Cookie da mesma maneira que define paramêtros
Primeiro importe `Cookie`:
+//// tab | Python 3.10+
+
+```Python hl_lines="3"
+{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
```Python hl_lines="3"
-{!../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="3"
+{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="1"
+{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="3"
+{!> ../../../docs_src/cookie_params/tutorial001.py!}
+```
+
+////
+
## Declare parâmetros de `Cookie`
Então declare os paramêtros de cookie usando a mesma estrutura que em `Path` e `Query`.
-O primeiro valor é o valor padrão, você pode passar todas as validações adicionais ou parâmetros de anotação:
+Você pode definir o valor padrão, assim como todas as validações extras ou parâmetros de anotação:
+
+
+//// tab | Python 3.10+
+
+```Python hl_lines="9"
+{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
```Python hl_lines="9"
-{!../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
-/// note | "Detalhes Técnicos"
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="10"
+{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="7"
+{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="9"
+{!> ../../../docs_src/cookie_params/tutorial001.py!}
+```
+
+////
+
+/// note | Detalhes Técnicos
`Cookie` é uma classe "irmã" de `Path` e `Query`. Ela também herda da mesma classe em comum `Param`.
@@ -28,9 +125,9 @@ Mas lembre-se que quando você importa `Query`, `Path`, `Cookie` e outras de `fa
///
-/// info | "Informação"
+/// info | Informação
-Para declarar cookies, você precisa usar `Cookie`, caso contrário, os parâmetros seriam interpretados como parâmetros de consulta.
+Para declarar cookies, você precisa usar `Cookie`, pois caso contrário, os parâmetros seriam interpretados como parâmetros de consulta.
///
From ed477ee8873219398289b0ef7e2a750151410a0b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 10:58:40 +0000
Subject: [PATCH 095/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 242981548..d7482cc46 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Fix Korean translation for `docs/ko/docs/tutorial/index.md`. PR [#12278](https://github.com/fastapi/fastapi/pull/12278) by [@kkotipy](https://github.com/kkotipy).
* 🌐 Update Portuguese translation for `docs/pt/docs/advanced/security/http-basic-auth.md`. PR [#12275](https://github.com/fastapi/fastapi/pull/12275) by [@andersonrocha0](https://github.com/andersonrocha0).
* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/cloud.md`. PR [#12217](https://github.com/fastapi/fastapi/pull/12217) by [@marcelomarkus](https://github.com/marcelomarkus).
* ✏️ Fix typo in `docs/es/docs/python-types.md`. PR [#12235](https://github.com/fastapi/fastapi/pull/12235) by [@JavierSanchezCastro](https://github.com/JavierSanchezCastro).
From 69921b463ef1669807cc2d793cc9f0193da403cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Pedro=20Pereira=20Holanda?=
<joaopedroph09@gmail.com>
Date: Fri, 4 Oct 2024 08:00:29 -0300
Subject: [PATCH 096/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/response-directly.md`=20(?=
=?UTF-8?q?#12266)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/advanced/response-directly.md | 70 ++++++++++++++++++++++
1 file changed, 70 insertions(+)
create mode 100644 docs/pt/docs/advanced/response-directly.md
diff --git a/docs/pt/docs/advanced/response-directly.md b/docs/pt/docs/advanced/response-directly.md
new file mode 100644
index 000000000..fc571d39b
--- /dev/null
+++ b/docs/pt/docs/advanced/response-directly.md
@@ -0,0 +1,70 @@
+# Retornando uma Resposta Diretamente
+
+Quando você cria uma *operação de rota* no **FastAPI** você pode retornar qualquer dado nela: um dicionário (`dict`), uma lista (`list`), um modelo do Pydantic ou do seu banco de dados, etc.
+
+Por padrão, o **FastAPI** irá converter automaticamente o valor do retorno para JSON utilizando o `jsonable_encoder` explicado em [JSON Compatible Encoder](../tutorial/encoder.md){.internal-link target=_blank}.
+
+Então, por baixo dos panos, ele incluiria esses dados compatíveis com JSON (e.g. um `dict`) dentro de uma `JSONResponse` que é utilizada para enviar uma resposta para o cliente.
+
+Mas você pode retornar a `JSONResponse` diretamente nas suas *operações de rota*.
+
+Pode ser útil para retornar cabeçalhos e cookies personalizados, por exemplo.
+
+## Retornando uma `Response`
+
+Na verdade, você pode retornar qualquer `Response` ou subclasse dela.
+
+/// tip | Dica
+
+A própria `JSONResponse` é uma subclasse de `Response`.
+
+///
+
+E quando você retorna uma `Response`, o **FastAPI** vai repassá-la diretamente.
+
+Ele não vai fazer conversões de dados com modelos do Pydantic, não irá converter a tipagem de nenhum conteúdo, etc.
+
+Isso te dá bastante flexibilidade. Você pode retornar qualquer tipo de dado, sobrescrever qualquer declaração e validação nos dados, etc.
+
+## Utilizando o `jsonable_encoder` em uma `Response`
+
+Como o **FastAPI** não realiza nenhuma mudança na `Response` que você retorna, você precisa garantir que o conteúdo dela está pronto para uso.
+
+Por exemplo, você não pode colocar um modelo do Pydantic em uma `JSONResponse` sem antes convertê-lo em um `dict` com todos os tipos de dados (como `datetime`, `UUID`, etc) convertidos para tipos compatíveis com JSON.
+
+Para esses casos, você pode usar o `jsonable_encoder` para converter seus dados antes de repassá-los para a resposta:
+
+```Python hl_lines="6-7 21-22"
+{!../../../docs_src/response_directly/tutorial001.py!}
+```
+
+/// note | Detalhes Técnicos
+
+Você também pode utilizar `from starlette.responses import JSONResponse`.
+
+**FastAPI** utiliza a mesma `starlette.responses` como `fastapi.responses` apenas como uma conveniência para você, desenvolvedor. Mas maior parte das respostas disponíveis vem diretamente do Starlette.
+
+///
+
+## Retornando uma `Response`
+
+O exemplo acima mostra todas as partes que você precisa, mas ainda não é muito útil, já que você poderia ter retornado o `item` diretamente, e o **FastAPI** colocaria em uma `JSONResponse` para você, convertendo em um `dict`, etc. Tudo isso por padrão.
+
+Agora, vamos ver como você pode usar isso para retornar uma resposta personalizada.
+
+Vamos dizer quer retornar uma resposta <a href="https://pt.wikipedia.org/wiki/XML" class="external-link" target="_blank">XML</a>.
+
+Você pode colocar o seu conteúdo XML em uma string, colocar em uma `Response`, e retorná-lo:
+
+```Python hl_lines="1 18"
+{!../../../docs_src/response_directly/tutorial002.py!}
+```
+
+## Notas
+
+Quando você retorna uma `Response` diretamente os dados não são validados, convertidos (serializados) ou documentados automaticamente.
+
+Mas você ainda pode documentar como descrito em [Retornos Adicionais no OpenAPI
+](additional-responses.md){.internal-link target=_blank}.
+
+Você pode ver nas próximas seções como usar/declarar essas `Responses` customizadas enquanto mantém a conversão e documentação automática dos dados.
From 98d190f780691fa3a8cc3abdc9805f05e6a1b751 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 11:01:25 +0000
Subject: [PATCH 097/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d7482cc46..f66e72753 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Update Portuguese translation for `docs/pt/docs/tutorial/cookie-params.md`. PR [#12297](https://github.com/fastapi/fastapi/pull/12297) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Fix Korean translation for `docs/ko/docs/tutorial/index.md`. PR [#12278](https://github.com/fastapi/fastapi/pull/12278) by [@kkotipy](https://github.com/kkotipy).
* 🌐 Update Portuguese translation for `docs/pt/docs/advanced/security/http-basic-auth.md`. PR [#12275](https://github.com/fastapi/fastapi/pull/12275) by [@andersonrocha0](https://github.com/andersonrocha0).
* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/cloud.md`. PR [#12217](https://github.com/fastapi/fastapi/pull/12217) by [@marcelomarkus](https://github.com/marcelomarkus).
From b1c03ba57e50c25c6e40501bb87ce4063a91e885 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 11:03:27 +0000
Subject: [PATCH 098/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f66e72753..c871e1c71 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/response-directly.md`. PR [#12266](https://github.com/fastapi/fastapi/pull/12266) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
* 🌐 Update Portuguese translation for `docs/pt/docs/tutorial/cookie-params.md`. PR [#12297](https://github.com/fastapi/fastapi/pull/12297) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Fix Korean translation for `docs/ko/docs/tutorial/index.md`. PR [#12278](https://github.com/fastapi/fastapi/pull/12278) by [@kkotipy](https://github.com/kkotipy).
* 🌐 Update Portuguese translation for `docs/pt/docs/advanced/security/http-basic-auth.md`. PR [#12275](https://github.com/fastapi/fastapi/pull/12275) by [@andersonrocha0](https://github.com/andersonrocha0).
From fa50b0c73cbf2bc298c596dda8f79e4789608341 Mon Sep 17 00:00:00 2001
From: marcelomarkus <marcelomarkus@gmail.com>
Date: Fri, 4 Oct 2024 08:03:46 -0300
Subject: [PATCH 099/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/how-to/conditional-openapi.md`=20(?=
=?UTF-8?q?#12221)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/how-to/conditional-openapi.md | 58 ++++++++++++++++++++++
1 file changed, 58 insertions(+)
create mode 100644 docs/pt/docs/how-to/conditional-openapi.md
diff --git a/docs/pt/docs/how-to/conditional-openapi.md b/docs/pt/docs/how-to/conditional-openapi.md
new file mode 100644
index 000000000..cfa652fa5
--- /dev/null
+++ b/docs/pt/docs/how-to/conditional-openapi.md
@@ -0,0 +1,58 @@
+# OpenAPI condicional
+
+Se necessário, você pode usar configurações e variáveis de ambiente para configurar o OpenAPI condicionalmente, dependendo do ambiente, e até mesmo desativá-lo completamente.
+
+## Sobre segurança, APIs e documentos
+
+Ocultar suas interfaces de usuário de documentação na produção *não deveria* ser a maneira de proteger sua API.
+
+Isso não adiciona nenhuma segurança extra à sua API; as *operações de rotas* ainda estarão disponíveis onde estão.
+
+Se houver uma falha de segurança no seu código, ela ainda existirá.
+
+Ocultar a documentação apenas torna mais difícil entender como interagir com sua API e pode dificultar sua depuração na produção. Pode ser considerado simplesmente uma forma de <a href="https://en.wikipedia.org/wiki/Security_through_obscurity" class="external-link" target="_blank">Segurança através da obscuridade</a>.
+
+Se você quiser proteger sua API, há várias coisas melhores que você pode fazer, por exemplo:
+
+* Certifique-se de ter modelos Pydantic bem definidos para seus corpos de solicitação e respostas.
+* Configure quaisquer permissões e funções necessárias usando dependências.
+* Nunca armazene senhas em texto simples, apenas hashes de senha.
+* Implemente e use ferramentas criptográficas bem conhecidas, como tokens JWT e Passlib, etc.
+* Adicione controles de permissão mais granulares com escopos OAuth2 quando necessário.
+* ...etc.
+
+No entanto, você pode ter um caso de uso muito específico em que realmente precisa desabilitar a documentação da API para algum ambiente (por exemplo, para produção) ou dependendo de configurações de variáveis de ambiente.
+
+## OpenAPI condicional com configurações e variáveis de ambiente
+
+Você pode usar facilmente as mesmas configurações do Pydantic para configurar sua OpenAPI gerada e as interfaces de usuário de documentos.
+
+Por exemplo:
+
+```Python hl_lines="6 11"
+{!../../../docs_src/conditional_openapi/tutorial001.py!}
+```
+
+Aqui declaramos a configuração `openapi_url` com o mesmo padrão de `"/openapi.json"`.
+
+E então o usamos ao criar o aplicativo `FastAPI`.
+
+Então você pode desabilitar o OpenAPI (incluindo os documentos da interface do usuário) definindo a variável de ambiente `OPENAPI_URL` como uma string vazia, como:
+
+<div class="termy">
+
+```console
+$ OPENAPI_URL= uvicorn main:app
+
+<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+</div>
+
+Então, se você acessar as URLs em `/openapi.json`, `/docs` ou `/redoc`, você receberá apenas um erro `404 Não Encontrado` como:
+
+```JSON
+{
+ "detail": "Not Found"
+}
+```
From 17e234452abc3dce895e2e2e93c48f856dd43da3 Mon Sep 17 00:00:00 2001
From: marcelomarkus <marcelomarkus@gmail.com>
Date: Fri, 4 Oct 2024 08:04:50 -0300
Subject: [PATCH 100/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/deployment/concepts.md`=20(#12219)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/deployment/concepts.md | 321 ++++++++++++++++++++++++++++
1 file changed, 321 insertions(+)
create mode 100644 docs/pt/docs/deployment/concepts.md
diff --git a/docs/pt/docs/deployment/concepts.md b/docs/pt/docs/deployment/concepts.md
new file mode 100644
index 000000000..20513c366
--- /dev/null
+++ b/docs/pt/docs/deployment/concepts.md
@@ -0,0 +1,321 @@
+# Conceitos de Implantações
+
+Ao implantar um aplicativo **FastAPI**, ou na verdade, qualquer tipo de API da web, há vários conceitos com os quais você provavelmente se importa e, usando-os, você pode encontrar a maneira **mais apropriada** de **implantar seu aplicativo**.
+
+Alguns dos conceitos importantes são:
+
+* Segurança - HTTPS
+* Executando na inicialização
+* Reinicializações
+* Replicação (o número de processos em execução)
+* Memória
+* Etapas anteriores antes de iniciar
+
+Veremos como eles afetariam as **implantações**.
+
+No final, o principal objetivo é ser capaz de **atender seus clientes de API** de uma forma **segura**, **evitar interrupções** e usar os **recursos de computação** (por exemplo, servidores remotos/máquinas virtuais) da forma mais eficiente possível. 🚀
+
+Vou lhe contar um pouco mais sobre esses **conceitos** aqui, e espero que isso lhe dê a **intuição** necessária para decidir como implantar sua API em ambientes muito diferentes, possivelmente até mesmo em **futuros** ambientes que ainda não existem.
+
+Ao considerar esses conceitos, você será capaz de **avaliar e projetar** a melhor maneira de implantar **suas próprias APIs**.
+
+Nos próximos capítulos, darei a você mais **receitas concretas** para implantar aplicativos FastAPI.
+
+Mas por enquanto, vamos verificar essas importantes **ideias conceituais**. Esses conceitos também se aplicam a qualquer outro tipo de API da web. 💡
+
+## Segurança - HTTPS
+
+No [capítulo anterior sobre HTTPS](https.md){.internal-link target=_blank} aprendemos como o HTTPS fornece criptografia para sua API.
+
+Também vimos que o HTTPS normalmente é fornecido por um componente **externo** ao seu servidor de aplicativos, um **Proxy de terminação TLS**.
+
+E tem que haver algo responsável por **renovar os certificados HTTPS**, pode ser o mesmo componente ou pode ser algo diferente.
+
+### Ferramentas de exemplo para HTTPS
+
+Algumas das ferramentas que você pode usar como um proxy de terminação TLS são:
+
+* Traefik
+ * Lida automaticamente com renovações de certificados ✨
+* Caddy
+ * Lida automaticamente com renovações de certificados ✨
+* Nginx
+ * Com um componente externo como o Certbot para renovações de certificados
+* HAProxy
+ * Com um componente externo como o Certbot para renovações de certificados
+* Kubernetes com um controlador Ingress como o Nginx
+ * Com um componente externo como cert-manager para renovações de certificados
+* Gerenciado internamente por um provedor de nuvem como parte de seus serviços (leia abaixo 👇)
+
+Outra opção é que você poderia usar um **serviço de nuvem** que faz mais do trabalho, incluindo a configuração de HTTPS. Ele pode ter algumas restrições ou cobrar mais, etc. Mas, nesse caso, você não teria que configurar um Proxy de terminação TLS sozinho.
+
+Mostrarei alguns exemplos concretos nos próximos capítulos.
+
+---
+
+Os próximos conceitos a serem considerados são todos sobre o programa que executa sua API real (por exemplo, Uvicorn).
+
+## Programa e Processo
+
+Falaremos muito sobre o "**processo**" em execução, então é útil ter clareza sobre o que ele significa e qual é a diferença com a palavra "**programa**".
+
+### O que é um Programa
+
+A palavra **programa** é comumente usada para descrever muitas coisas:
+
+* O **código** que você escreve, os **arquivos Python**.
+* O **arquivo** que pode ser **executado** pelo sistema operacional, por exemplo: `python`, `python.exe` ou `uvicorn`.
+* Um programa específico enquanto está **em execução** no sistema operacional, usando a CPU e armazenando coisas na memória. Isso também é chamado de **processo**.
+
+### O que é um Processo
+
+A palavra **processo** normalmente é usada de forma mais específica, referindo-se apenas ao que está sendo executado no sistema operacional (como no último ponto acima):
+
+* Um programa específico enquanto está **em execução** no sistema operacional.
+ * Isso não se refere ao arquivo, nem ao código, refere-se **especificamente** à coisa que está sendo **executada** e gerenciada pelo sistema operacional.
+* Qualquer programa, qualquer código, **só pode fazer coisas** quando está sendo **executado**. Então, quando há um **processo em execução**.
+* O processo pode ser **terminado** (ou "morto") por você, ou pelo sistema operacional. Nesse ponto, ele para de rodar/ser executado, e ele **não pode mais fazer coisas**.
+* Cada aplicativo que você tem em execução no seu computador tem algum processo por trás dele, cada programa em execução, cada janela, etc. E normalmente há muitos processos em execução **ao mesmo tempo** enquanto um computador está ligado.
+* Pode haver **vários processos** do **mesmo programa** em execução ao mesmo tempo.
+
+Se você verificar o "gerenciador de tarefas" ou o "monitor do sistema" (ou ferramentas semelhantes) no seu sistema operacional, poderá ver muitos desses processos em execução.
+
+E, por exemplo, você provavelmente verá que há vários processos executando o mesmo programa de navegador (Firefox, Chrome, Edge, etc.). Eles normalmente executam um processo por aba, além de alguns outros processos extras.
+
+<img class="shadow" src="/img/deployment/concepts/image01.png">
+
+---
+
+Agora que sabemos a diferença entre os termos **processo** e **programa**, vamos continuar falando sobre implantações.
+
+## Executando na inicialização
+
+Na maioria dos casos, quando você cria uma API web, você quer que ela esteja **sempre em execução**, ininterrupta, para que seus clientes possam sempre acessá-la. Isso é claro, a menos que você tenha um motivo específico para querer que ela seja executada somente em certas situações, mas na maioria das vezes você quer que ela esteja constantemente em execução e **disponível**.
+
+### Em um servidor remoto
+
+Ao configurar um servidor remoto (um servidor em nuvem, uma máquina virtual, etc.), a coisa mais simples que você pode fazer é usar `fastapi run` (que usa Uvicorn) ou algo semelhante, manualmente, da mesma forma que você faz ao desenvolver localmente.
+
+E funcionará e será útil **durante o desenvolvimento**.
+
+Mas se sua conexão com o servidor for perdida, o **processo em execução** provavelmente morrerá.
+
+E se o servidor for reiniciado (por exemplo, após atualizações ou migrações do provedor de nuvem), você provavelmente **não notará**. E por causa disso, você nem saberá que precisa reiniciar o processo manualmente. Então, sua API simplesmente permanecerá inativa. 😱
+
+### Executar automaticamente na inicialização
+
+Em geral, você provavelmente desejará que o programa do servidor (por exemplo, Uvicorn) seja iniciado automaticamente na inicialização do servidor e, sem precisar de nenhuma **intervenção humana**, tenha um processo sempre em execução com sua API (por exemplo, Uvicorn executando seu aplicativo FastAPI).
+
+### Programa separado
+
+Para conseguir isso, você normalmente terá um **programa separado** que garantiria que seu aplicativo fosse executado na inicialização. E em muitos casos, ele também garantiria que outros componentes ou aplicativos também fossem executados, por exemplo, um banco de dados.
+
+### Ferramentas de exemplo para executar na inicialização
+
+Alguns exemplos de ferramentas que podem fazer esse trabalho são:
+
+* Docker
+* Kubernetes
+* Docker Compose
+* Docker em Modo Swarm
+* Systemd
+* Supervisor
+* Gerenciado internamente por um provedor de nuvem como parte de seus serviços
+* Outros...
+
+Darei exemplos mais concretos nos próximos capítulos.
+
+## Reinicializações
+
+Semelhante a garantir que seu aplicativo seja executado na inicialização, você provavelmente também deseja garantir que ele seja **reiniciado** após falhas.
+
+### Nós cometemos erros
+
+Nós, como humanos, cometemos **erros** o tempo todo. O software quase *sempre* tem **bugs** escondidos em lugares diferentes. 🐛
+
+E nós, como desenvolvedores, continuamos aprimorando o código à medida que encontramos esses bugs e implementamos novos recursos (possivelmente adicionando novos bugs também 😅).
+
+### Pequenos erros são tratados automaticamente
+
+Ao criar APIs da web com FastAPI, se houver um erro em nosso código, o FastAPI normalmente o conterá na única solicitação que acionou o erro. 🛡
+
+O cliente receberá um **Erro Interno do Servidor 500** para essa solicitação, mas o aplicativo continuará funcionando para as próximas solicitações em vez de travar completamente.
+
+### Erros maiores - Travamentos
+
+No entanto, pode haver casos em que escrevemos algum código que **trava todo o aplicativo**, fazendo com que o Uvicorn e o Python travem. 💥
+
+E ainda assim, você provavelmente não gostaria que o aplicativo permanecesse inativo porque houve um erro em um lugar, você provavelmente quer que ele **continue em execução** pelo menos para as *operações de caminho* que não estão quebradas.
+
+### Reiniciar após falha
+
+Mas nos casos com erros realmente graves que travam o **processo** em execução, você vai querer um componente externo que seja responsável por **reiniciar** o processo, pelo menos algumas vezes...
+
+/// tip | "Dica"
+
+...Embora se o aplicativo inteiro estiver **travando imediatamente**, provavelmente não faça sentido reiniciá-lo para sempre. Mas nesses casos, você provavelmente notará isso durante o desenvolvimento, ou pelo menos logo após a implantação.
+
+Então, vamos nos concentrar nos casos principais, onde ele pode travar completamente em alguns casos específicos **no futuro**, e ainda faz sentido reiniciá-lo.
+
+///
+
+Você provavelmente gostaria de ter a coisa responsável por reiniciar seu aplicativo como um **componente externo**, porque a essa altura, o mesmo aplicativo com Uvicorn e Python já havia travado, então não há nada no mesmo código do mesmo aplicativo que possa fazer algo a respeito.
+
+### Ferramentas de exemplo para reiniciar automaticamente
+
+Na maioria dos casos, a mesma ferramenta usada para **executar o programa na inicialização** também é usada para lidar com **reinicializações** automáticas.
+
+Por exemplo, isso poderia ser resolvido por:
+
+* Docker
+* Kubernetes
+* Docker Compose
+* Docker no Modo Swarm
+* Systemd
+* Supervisor
+* Gerenciado internamente por um provedor de nuvem como parte de seus serviços
+* Outros...
+
+## Replicação - Processos e Memória
+
+Com um aplicativo FastAPI, usando um programa de servidor como o comando `fastapi` que executa o Uvicorn, executá-lo uma vez em **um processo** pode atender a vários clientes simultaneamente.
+
+Mas em muitos casos, você desejará executar vários processos de trabalho ao mesmo tempo.
+
+### Processos Múltiplos - Trabalhadores
+
+Se você tiver mais clientes do que um único processo pode manipular (por exemplo, se a máquina virtual não for muito grande) e tiver **vários núcleos** na CPU do servidor, você poderá ter **vários processos** em execução com o mesmo aplicativo ao mesmo tempo e distribuir todas as solicitações entre eles.
+
+Quando você executa **vários processos** do mesmo programa de API, eles são comumente chamados de **trabalhadores**.
+
+### Processos do Trabalhador e Portas
+
+Lembra da documentação [Sobre HTTPS](https.md){.internal-link target=_blank} que diz que apenas um processo pode escutar em uma combinação de porta e endereço IP em um servidor?
+
+Isso ainda é verdade.
+
+Então, para poder ter **vários processos** ao mesmo tempo, tem que haver um **único processo escutando em uma porta** que então transmite a comunicação para cada processo de trabalho de alguma forma.
+
+### Memória por Processo
+
+Agora, quando o programa carrega coisas na memória, por exemplo, um modelo de aprendizado de máquina em uma variável, ou o conteúdo de um arquivo grande em uma variável, tudo isso **consome um pouco da memória (RAM)** do servidor.
+
+E vários processos normalmente **não compartilham nenhuma memória**. Isso significa que cada processo em execução tem suas próprias coisas, variáveis e memória. E se você estiver consumindo uma grande quantidade de memória em seu código, **cada processo** consumirá uma quantidade equivalente de memória.
+
+### Memória do servidor
+
+Por exemplo, se seu código carrega um modelo de Machine Learning com **1 GB de tamanho**, quando você executa um processo com sua API, ele consumirá pelo menos 1 GB de RAM. E se você iniciar **4 processos** (4 trabalhadores), cada um consumirá 1 GB de RAM. Então, no total, sua API consumirá **4 GB de RAM**.
+
+E se o seu servidor remoto ou máquina virtual tiver apenas 3 GB de RAM, tentar carregar mais de 4 GB de RAM causará problemas. 🚨
+
+### Processos Múltiplos - Um Exemplo
+
+Neste exemplo, há um **Processo Gerenciador** que inicia e controla dois **Processos de Trabalhadores**.
+
+Este Processo de Gerenciador provavelmente seria o que escutaria na **porta** no IP. E ele transmitiria toda a comunicação para os processos de trabalho.
+
+Esses processos de trabalho seriam aqueles que executariam seu aplicativo, eles executariam os cálculos principais para receber uma **solicitação** e retornar uma **resposta**, e carregariam qualquer coisa que você colocasse em variáveis na RAM.
+
+<img src="/img/deployment/concepts/process-ram.svg">
+
+E, claro, a mesma máquina provavelmente teria **outros processos** em execução, além do seu aplicativo.
+
+Um detalhe interessante é que a porcentagem da **CPU usada** por cada processo pode **variar** muito ao longo do tempo, mas a **memória (RAM)** normalmente fica mais ou menos **estável**.
+
+Se você tiver uma API que faz uma quantidade comparável de cálculos todas as vezes e tiver muitos clientes, então a **utilização da CPU** provavelmente *também será estável* (em vez de ficar constantemente subindo e descendo rapidamente).
+
+### Exemplos de ferramentas e estratégias de replicação
+
+Pode haver várias abordagens para conseguir isso, e falarei mais sobre estratégias específicas nos próximos capítulos, por exemplo, ao falar sobre Docker e contêineres.
+
+A principal restrição a ser considerada é que tem que haver um **único** componente manipulando a **porta** no **IP público**. E então tem que ter uma maneira de **transmitir** a comunicação para os **processos/trabalhadores** replicados.
+
+Aqui estão algumas combinações e estratégias possíveis:
+
+* **Uvicorn** com `--workers`
+ * Um **gerenciador de processos** Uvicorn escutaria no **IP** e na **porta** e iniciaria **vários processos de trabalho Uvicorn**.
+* **Kubernetes** e outros **sistemas de contêineres** distribuídos
+ * Algo na camada **Kubernetes** escutaria no **IP** e na **porta**. A replicação seria por ter **vários contêineres**, cada um com **um processo Uvicorn** em execução.
+* **Serviços de nuvem** que cuidam disso para você
+ * O serviço de nuvem provavelmente **cuidará da replicação para você**. Ele possivelmente deixaria você definir **um processo para executar**, ou uma **imagem de contêiner** para usar, em qualquer caso, provavelmente seria **um único processo Uvicorn**, e o serviço de nuvem seria responsável por replicá-lo.
+
+/// tip | "Dica"
+
+Não se preocupe se alguns desses itens sobre **contêineres**, Docker ou Kubernetes ainda não fizerem muito sentido.
+
+Falarei mais sobre imagens de contêiner, Docker, Kubernetes, etc. em um capítulo futuro: [FastAPI em contêineres - Docker](docker.md){.internal-link target=_blank}.
+
+///
+
+## Etapas anteriores antes de começar
+
+Há muitos casos em que você deseja executar algumas etapas **antes de iniciar** sua aplicação.
+
+Por exemplo, você pode querer executar **migrações de banco de dados**.
+
+Mas na maioria dos casos, você precisará executar essas etapas apenas **uma vez**.
+
+Portanto, você vai querer ter um **processo único** para executar essas **etapas anteriores** antes de iniciar o aplicativo.
+
+E você terá que se certificar de que é um único processo executando essas etapas anteriores *mesmo* se depois, você iniciar **vários processos** (vários trabalhadores) para o próprio aplicativo. Se essas etapas fossem executadas por **vários processos**, eles **duplicariam** o trabalho executando-o em **paralelo**, e se as etapas fossem algo delicado como uma migração de banco de dados, elas poderiam causar conflitos entre si.
+
+Claro, há alguns casos em que não há problema em executar as etapas anteriores várias vezes; nesse caso, é muito mais fácil de lidar.
+
+/// tip | "Dica"
+
+Além disso, tenha em mente que, dependendo da sua configuração, em alguns casos você **pode nem precisar de nenhuma etapa anterior** antes de iniciar sua aplicação.
+
+Nesse caso, você não precisaria se preocupar com nada disso. 🤷
+
+///
+
+### Exemplos de estratégias de etapas anteriores
+
+Isso **dependerá muito** da maneira como você **implanta seu sistema** e provavelmente estará conectado à maneira como você inicia programas, lida com reinicializações, etc.
+
+Aqui estão algumas ideias possíveis:
+
+* Um "Init Container" no Kubernetes que roda antes do seu app container
+* Um script bash que roda os passos anteriores e então inicia seu aplicativo
+ * Você ainda precisaria de uma maneira de iniciar/reiniciar *aquele* script bash, detectar erros, etc.
+
+/// tip | "Dica"
+
+Darei exemplos mais concretos de como fazer isso com contêineres em um capítulo futuro: [FastAPI em contêineres - Docker](docker.md){.internal-link target=_blank}.
+
+///
+
+## Utilização de recursos
+
+Seu(s) servidor(es) é(são) um **recurso** que você pode consumir ou **utilizar**, com seus programas, o tempo de computação nas CPUs e a memória RAM disponível.
+
+Quanto dos recursos do sistema você quer consumir/utilizar? Pode ser fácil pensar "não muito", mas, na realidade, você provavelmente vai querer consumir **o máximo possível sem travar**.
+
+Se você está pagando por 3 servidores, mas está usando apenas um pouco de RAM e CPU, você provavelmente está **desperdiçando dinheiro** 💸, e provavelmente **desperdiçando energia elétrica do servidor** 🌎, etc.
+
+Nesse caso, seria melhor ter apenas 2 servidores e usar uma porcentagem maior de seus recursos (CPU, memória, disco, largura de banda de rede, etc).
+
+Por outro lado, se você tem 2 servidores e está usando **100% da CPU e RAM deles**, em algum momento um processo pedirá mais memória, e o servidor terá que usar o disco como "memória" (o que pode ser milhares de vezes mais lento), ou até mesmo **travar**. Ou um processo pode precisar fazer alguma computação e teria que esperar até que a CPU esteja livre novamente.
+
+Nesse caso, seria melhor obter **um servidor extra** e executar alguns processos nele para que todos tenham **RAM e tempo de CPU suficientes**.
+
+Também há a chance de que, por algum motivo, você tenha um **pico** de uso da sua API. Talvez ela tenha se tornado viral, ou talvez alguns outros serviços ou bots comecem a usá-la. E você pode querer ter recursos extras para estar seguro nesses casos.
+
+Você poderia colocar um **número arbitrário** para atingir, por exemplo, algo **entre 50% a 90%** da utilização de recursos. O ponto é que essas são provavelmente as principais coisas que você vai querer medir e usar para ajustar suas implantações.
+
+Você pode usar ferramentas simples como `htop` para ver a CPU e a RAM usadas no seu servidor ou a quantidade usada por cada processo. Ou você pode usar ferramentas de monitoramento mais complexas, que podem ser distribuídas entre servidores, etc.
+
+## Recapitular
+
+Você leu aqui alguns dos principais conceitos que provavelmente precisa ter em mente ao decidir como implantar seu aplicativo:
+
+* Segurança - HTTPS
+* Executando na inicialização
+* Reinicializações
+* Replicação (o número de processos em execução)
+* Memória
+* Etapas anteriores antes de iniciar
+
+Entender essas ideias e como aplicá-las deve lhe dar a intuição necessária para tomar qualquer decisão ao configurar e ajustar suas implantações. 🤓
+
+Nas próximas seções, darei exemplos mais concretos de possíveis estratégias que você pode seguir. 🚀
From 304f514ed95107a32e7b1f263003720b9475c580 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 11:08:00 +0000
Subject: [PATCH 101/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c871e1c71..ca8dcedb0 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/conditional-openapi.md`. PR [#12221](https://github.com/fastapi/fastapi/pull/12221) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/response-directly.md`. PR [#12266](https://github.com/fastapi/fastapi/pull/12266) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
* 🌐 Update Portuguese translation for `docs/pt/docs/tutorial/cookie-params.md`. PR [#12297](https://github.com/fastapi/fastapi/pull/12297) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Fix Korean translation for `docs/ko/docs/tutorial/index.md`. PR [#12278](https://github.com/fastapi/fastapi/pull/12278) by [@kkotipy](https://github.com/kkotipy).
From 5820d4261e2784cfabbe5358015142d71039555a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 11:10:09 +0000
Subject: [PATCH 102/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ca8dcedb0..7188a698f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/concepts.md`. PR [#12219](https://github.com/fastapi/fastapi/pull/12219) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/conditional-openapi.md`. PR [#12221](https://github.com/fastapi/fastapi/pull/12221) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/response-directly.md`. PR [#12266](https://github.com/fastapi/fastapi/pull/12266) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
* 🌐 Update Portuguese translation for `docs/pt/docs/tutorial/cookie-params.md`. PR [#12297](https://github.com/fastapi/fastapi/pull/12297) by [@ceb10n](https://github.com/ceb10n).
From 0e7806e3f97ad16a526e77488a72be62359890e1 Mon Sep 17 00:00:00 2001
From: Rafael de Oliveira Marques <rafaelomarques@gmail.com>
Date: Fri, 4 Oct 2024 08:11:41 -0300
Subject: [PATCH 103/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/security/oauth2-scopes.md?=
=?UTF-8?q?`=20(#12263)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../docs/advanced/security/oauth2-scopes.md | 786 ++++++++++++++++++
1 file changed, 786 insertions(+)
create mode 100644 docs/pt/docs/advanced/security/oauth2-scopes.md
diff --git a/docs/pt/docs/advanced/security/oauth2-scopes.md b/docs/pt/docs/advanced/security/oauth2-scopes.md
new file mode 100644
index 000000000..4ad7c807e
--- /dev/null
+++ b/docs/pt/docs/advanced/security/oauth2-scopes.md
@@ -0,0 +1,786 @@
+# Escopos OAuth2
+
+Você pode utilizar escopos do OAuth2 diretamente com o **FastAPI**, eles são integrados para funcionar perfeitamente.
+
+Isso permitiria que você tivesse um sistema de permissionamento mais refinado, seguindo o padrão do OAuth2 integrado na sua aplicação OpenAPI (e as documentações da API).
+
+OAuth2 com escopos é o mecanismo utilizado por muitos provedores de autenticação, como o Facebook, Google, GitHub, Microsoft, Twitter, etc. Eles utilizam isso para prover permissões específicas para os usuários e aplicações.
+
+Toda vez que você "se autentica com" Facebook, Google, GitHub, Microsoft, Twitter, aquela aplicação está utilizando o OAuth2 com escopos.
+
+Nesta seção, você verá como gerenciar a autenticação e autorização com os mesmos escopos do OAuth2 em sua aplicação **FastAPI**.
+
+/// warning | "Aviso"
+
+Isso é uma seção mais ou menos avançada. Se você está apenas começando, você pode pular.
+
+Você não necessariamente precisa de escopos do OAuth2, e você pode lidar com autenticação e autorização da maneira que você achar melhor.
+
+Mas o OAuth2 com escopos pode ser integrado de maneira fácil em sua API (com OpenAPI) e a sua documentação de API.
+
+No entando, você ainda aplica estes escopos, ou qualquer outro requisito de segurança/autorização, conforme necessário, em seu código.
+
+Em muitos casos, OAuth2 com escopos pode ser um exagero.
+
+Mas se você sabe que precisa, ou está curioso, continue lendo.
+
+///
+
+## Escopos OAuth2 e OpenAPI
+
+A especificação OAuth2 define "escopos" como uma lista de strings separadas por espaços.
+
+O conteúdo de cada uma dessas strings pode ter qualquer formato, mas não devem possuir espaços.
+
+Estes escopos representam "permissões".
+
+No OpenAPI (e.g. os documentos da API), você pode definir "esquemas de segurança".
+
+Quando um desses esquemas de segurança utiliza OAuth2, você pode também declarar e utilizar escopos.
+
+Cada "escopo" é apenas uma string (sem espaços).
+
+Eles são normalmente utilizados para declarar permissões de segurança específicas, como por exemplo:
+
+* `users:read` or `users:write` são exemplos comuns.
+* `instagram_basic` é utilizado pelo Facebook / Instagram.
+* `https://www.googleapis.com/auth/drive` é utilizado pelo Google.
+
+/// info | Informação
+
+No OAuth2, um "escopo" é apenas uma string que declara uma permissão específica necessária.
+
+Não importa se ela contém outros caracteres como `:` ou se ela é uma URL.
+
+Estes detalhes são específicos da implementação.
+
+Para o OAuth2, eles são apenas strings.
+
+///
+
+## Visão global
+
+Primeiro, vamos olhar rapidamente as partes que mudam dos exemplos do **Tutorial - Guia de Usuário** para [OAuth2 com Senha (e hash), Bearer com tokens JWT](../../tutorial/security/oauth2-jwt.md){.internal-link target=_blank}. Agora utilizando escopos OAuth2:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="5 9 13 47 65 106 108-116 122-125 129-135 140 156"
+{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="2 5 9 13 47 65 106 108-116 122-125 129-135 140 156"
+{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="2 5 9 13 48 66 107 109-117 123-126 130-136 141 157"
+{!> ../../../docs_src/security/tutorial005_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="4 8 12 46 64 105 107-115 121-124 128-134 139 155"
+{!> ../../../docs_src/security/tutorial005_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="2 5 9 13 47 65 106 108-116 122-125 129-135 140 156"
+{!> ../../../docs_src/security/tutorial005_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="2 5 9 13 47 65 106 108-116 122-125 129-135 140 156"
+{!> ../../../docs_src/security/tutorial005.py!}
+```
+
+////
+
+Agora vamos revisar essas mudanças passo a passo.
+
+## Esquema de segurança OAuth2
+
+A primeira mudança é que agora nós estamos declarando o esquema de segurança OAuth2 com dois escopos disponíveis, `me` e `items`.
+
+O parâmetro `scopes` recebe um `dict` contendo cada escopo como chave e a descrição como valor:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="63-66"
+{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="63-66"
+{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="64-67"
+{!> ../../../docs_src/security/tutorial005_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="62-65"
+{!> ../../../docs_src/security/tutorial005_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="63-66"
+{!> ../../../docs_src/security/tutorial005_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="63-66"
+{!> ../../../docs_src/security/tutorial005.py!}
+```
+
+////
+
+Pelo motivo de estarmos declarando estes escopos, eles aparecerão nos documentos da API quando você se autenticar/autorizar.
+
+E você poderá selecionar quais escopos você deseja dar acesso: `me` e `items`.
+
+Este é o mesmo mecanismo utilizado quando você adiciona permissões enquanto se autentica com o Facebook, Google, GitHub, etc:
+
+<img src="/img/tutorial/security/image11.png">
+
+## Token JWT com escopos
+
+Agora, modifique o *caminho de rota* para retornar os escopos solicitados.
+
+Nós ainda estamos utilizando o mesmo `OAuth2PasswordRequestForm`. Ele inclui a propriedade `scopes` com uma `list` de `str`, com cada escopo que ele recebeu na requisição.
+
+E nós retornamos os escopos como parte do token JWT.
+
+/// danger | Cuidado
+
+Para manter as coisas simples, aqui nós estamos apenas adicionando os escopos recebidos diretamente ao token.
+
+Porém em sua aplicação, por segurança, você deve garantir que você apenas adiciona os escopos que o usuário possui permissão de fato, ou aqueles que você predefiniu.
+
+///
+
+//// tab | Python 3.10+
+
+```Python hl_lines="156"
+{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="156"
+{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="157"
+{!> ../../../docs_src/security/tutorial005_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="155"
+{!> ../../../docs_src/security/tutorial005_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="156"
+{!> ../../../docs_src/security/tutorial005_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="156"
+{!> ../../../docs_src/security/tutorial005.py!}
+```
+
+////
+
+## Declare escopos em *operações de rota* e dependências
+
+Agora nós declaramos que a *operação de rota* para `/users/me/items/` exige o escopo `items`.
+
+Para isso, nós importamos e utilizamos `Security` de `fastapi`.
+
+Você pode utilizar `Security` para declarar dependências (assim como `Depends`), porém o `Security` também recebe o parâmetros `scopes` com uma lista de escopos (strings).
+
+Neste caso, nós passamos a função `get_current_active_user` como dependência para `Security` (da mesma forma que nós faríamos com `Depends`).
+
+Mas nós também passamos uma `list` de escopos, neste caso com apenas um escopo: `items` (poderia ter mais).
+
+E a função de dependência `get_current_active_user` também pode declarar subdependências, não apenas com `Depends`, mas também com `Security`. Ao declarar sua própria função de subdependência (`get_current_user`), e mais requisitos de escopo.
+
+Neste caso, ele requer o escopo `me` (poderia requerer mais de um escopo).
+
+/// note | "Nota"
+
+Você não necessariamente precisa adicionar diferentes escopos em diferentes lugares.
+
+Nós estamos fazendo isso aqui para demonstrar como o **FastAPI** lida com escopos declarados em diferentes níveis.
+
+///
+
+//// tab | Python 3.10+
+
+```Python hl_lines="5 140 171"
+{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="5 140 171"
+{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="5 141 172"
+{!> ../../../docs_src/security/tutorial005_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="4 139 168"
+{!> ../../../docs_src/security/tutorial005_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="5 140 169"
+{!> ../../../docs_src/security/tutorial005_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="5 140 169"
+{!> ../../../docs_src/security/tutorial005.py!}
+```
+
+////
+
+/// info | Informações Técnicas
+
+`Security` é na verdade uma subclasse de `Depends`, e ele possui apenas um parâmetro extra que veremos depois.
+
+Porém ao utilizar `Security` no lugar de `Depends`, o **FastAPI** saberá que ele pode declarar escopos de segurança, utilizá-los internamente, e documentar a API com o OpenAPI.
+
+Mas quando você importa `Query`, `Path`, `Depends`, `Security` entre outros de `fastapi`, eles são na verdade funções que retornam classes especiais.
+
+///
+
+## Utilize `SecurityScopes`
+
+Agora atualize a dependência `get_current_user`.
+
+Este é o usado pelas dependências acima.
+
+Aqui é onde estamos utilizando o mesmo esquema OAuth2 que nós declaramos antes, declarando-o como uma dependência: `oauth2_scheme`.
+
+Porque esta função de dependência não possui nenhum requerimento de escopo, nós podemos utilizar `Depends` com o `oauth2_scheme`. Nós não precisamos utilizar `Security` quando nós não precisamos especificar escopos de segurança.
+
+Nós também declaramos um parâmetro especial do tipo `SecurityScopes`, importado de `fastapi.security`.
+
+A classe `SecurityScopes` é semelhante à classe `Request` (`Request` foi utilizada para obter o objeto da requisição diretamente).
+
+//// tab | Python 3.10+
+
+```Python hl_lines="9 106"
+{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9 106"
+{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="9 107"
+{!> ../../../docs_src/security/tutorial005_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="8 105"
+{!> ../../../docs_src/security/tutorial005_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="9 106"
+{!> ../../../docs_src/security/tutorial005_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="9 106"
+{!> ../../../docs_src/security/tutorial005.py!}
+```
+
+////
+
+## Utilize os `scopes`
+
+O parâmetro `security_scopes` será do tipo `SecurityScopes`.
+
+Ele terá a propriedade `scopes` com uma lista contendo todos os escopos requeridos por ele e todas as dependências que utilizam ele como uma subdependência. Isso significa, todos os "dependentes"... pode soar meio confuso, e isso será explicado novamente mais adiante.
+
+O objeto `security_scopes` (da classe `SecurityScopes`) também oferece um atributo `scope_str` com uma única string, contendo os escopos separados por espaços (nós vamos utilizar isso).
+
+Nós criamos uma `HTTPException` que nós podemos reutilizar (`raise`) mais tarde em diversos lugares.
+
+Nesta exceção, nós incluímos os escopos necessários (se houver algum) como uma string separada por espaços (utilizando `scope_str`). Nós colocamos esta string contendo os escopos no cabeçalho `WWW-Authenticate` (isso é parte da especificação).
+
+//// tab | Python 3.10+
+
+```Python hl_lines="106 108-116"
+{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="106 108-116"
+{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="107 109-117"
+{!> ../../../docs_src/security/tutorial005_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="105 107-115"
+{!> ../../../docs_src/security/tutorial005_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="106 108-116"
+{!> ../../../docs_src/security/tutorial005_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="106 108-116"
+{!> ../../../docs_src/security/tutorial005.py!}
+```
+
+////
+
+## Verifique o `username` e o formato dos dados
+
+Nós verificamos que nós obtemos um `username`, e extraímos os escopos.
+
+E depois nós validamos esse dado com o modelo Pydantic (capturando a exceção `ValidationError`), e se nós obtemos um erro ao ler o token JWT ou validando os dados com o Pydantic, nós levantamos a exceção `HTTPException` que criamos anteriormente.
+
+Para isso, nós atualizamos o modelo Pydantic `TokenData` com a nova propriedade `scopes`.
+
+Ao validar os dados com o Pydantic nós podemos garantir que temos, por exemplo, exatamente uma `list` de `str` com os escopos e uma `str` com o `username`.
+
+No lugar de, por exemplo, um `dict`, ou alguma outra coisa, que poderia quebrar a aplicação em algum lugar mais tarde, tornando isso um risco de segurança.
+
+Nós também verificamos que nós temos um usuário com o "*username*", e caso contrário, nós levantamos a mesma exceção que criamos anteriormente.
+
+//// tab | Python 3.10+
+
+```Python hl_lines="47 117-128"
+{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="47 117-128"
+{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="48 118-129"
+{!> ../../../docs_src/security/tutorial005_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="46 116-127"
+{!> ../../../docs_src/security/tutorial005_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="47 117-128"
+{!> ../../../docs_src/security/tutorial005_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="47 117-128"
+{!> ../../../docs_src/security/tutorial005.py!}
+```
+
+////
+
+## Verifique os `scopes`
+
+Nós verificamos agora que todos os escopos necessários, por essa dependência e todos os dependentes (incluindo as *operações de rota*) estão incluídas nos escopos fornecidos pelo token recebido, caso contrário, levantamos uma `HTTPException`.
+
+Para isso, nós utilizamos `security_scopes.scopes`, que contém uma `list` com todos esses escopos como uma `str`.
+
+//// tab | Python 3.10+
+
+```Python hl_lines="129-135"
+{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="129-135"
+{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="130-136"
+{!> ../../../docs_src/security/tutorial005_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="128-134"
+{!> ../../../docs_src/security/tutorial005_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="129-135"
+{!> ../../../docs_src/security/tutorial005_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="129-135"
+{!> ../../../docs_src/security/tutorial005.py!}
+```
+
+////
+
+## Árvore de dependência e escopos
+
+Vamos rever novamente essa árvore de dependência e os escopos.
+
+Como a dependência `get_current_active_user` possui uma subdependência em `get_current_user`, o escopo `"me"` declarado em `get_current_active_user` será incluído na lista de escopos necessários em `security_scopes.scopes` passado para `get_current_user`.
+
+A própria *operação de rota* também declara o escopo, `"items"`, então ele também estará na lista de `security_scopes.scopes` passado para o `get_current_user`.
+
+Aqui está como a hierarquia de dependências e escopos parecem:
+
+* A *operação de rota* `read_own_items` possui:
+ * Escopos necessários `["items"]` com a dependência:
+ * `get_current_active_user`:
+ * A função de dependência `get_current_active_user` possui:
+ * Escopos necessários `["me"]` com a dependência:
+ * `get_current_user`:
+ * A função de dependência `get_current_user` possui:
+ * Nenhum escopo necessário.
+ * Uma dependência utilizando `oauth2_scheme`.
+ * Um parâmetro `security_scopes` do tipo `SecurityScopes`:
+ * Este parâmetro `security_scopes` possui uma propriedade `scopes` com uma `list` contendo todos estes escopos declarados acima, então:
+ * `security_scopes.scopes` terá `["me", "items"]` para a *operação de rota* `read_own_items`.
+ * `security_scopes.scopes` terá `["me"]` para a *operação de rota* `read_users_me`, porque ela declarou na dependência `get_current_active_user`.
+ * `security_scopes.scopes` terá `[]` (nada) para a *operação de rota* `read_system_status`, porque ele não declarou nenhum `Security` com `scopes`, e sua dependência, `get_current_user`, não declara nenhum `scopes` também.
+
+/// tip | Dica
+
+A coisa importante e "mágica" aqui é que `get_current_user` terá diferentes listas de `scopes` para validar para cada *operação de rota*.
+
+Tudo depende dos `scopes` declarados em cada *operação de rota* e cada dependência da árvore de dependências para aquela *operação de rota* específica.
+
+///
+
+## Mais detalhes sobre `SecurityScopes`
+
+Você pode utilizar `SecurityScopes` em qualquer lugar, e em diversos lugares. Ele não precisa estar na dependência "raiz".
+
+Ele sempre terá os escopos de segurança declarados nas dependências atuais de `Security` e todos os dependentes para **aquela** *operação de rota* **específica** e **aquela** árvore de dependência **específica**.
+
+Porque o `SecurityScopes` terá todos os escopos declarados por dependentes, você pode utilizá-lo para verificar se o token possui os escopos necessários em uma função de dependência central, e depois declarar diferentes requisitos de escopo em diferentes *operações de rota*.
+
+Todos eles serão validados independentemente para cada *operação de rota*.
+
+## Verifique
+
+Se você abrir os documentos da API, você pode antenticar e especificar quais escopos você quer autorizar.
+
+<img src="/img/tutorial/security/image11.png">
+
+Se você não selecionar nenhum escopo, você terá "autenticado", mas quando você tentar acessar `/users/me/` ou `/users/me/items/`, você vai obter um erro dizendo que você não possui as permissões necessárias. Você ainda poderá acessar `/status/`.
+
+E se você selecionar o escopo `me`, mas não o escopo `items`, você poderá acessar `/users/me/`, mas não `/users/me/items/`.
+
+Isso é o que aconteceria se uma aplicação terceira que tentou acessar uma dessas *operações de rota* com um token fornecido por um usuário, dependendo de quantas permissões o usuário forneceu para a aplicação.
+
+## Sobre integrações de terceiros
+
+Neste exemplos nós estamos utilizando o fluxo de senha do OAuth2.
+
+Isso é apropriado quando nós estamos autenticando em nossa própria aplicação, provavelmente com o nosso próprio "*frontend*".
+
+Porque nós podemos confiar nele para receber o `username` e o `password`, pois nós controlamos isso.
+
+Mas se nós estamos construindo uma aplicação OAuth2 que outros poderiam conectar (i.e., se você está construindo um provedor de autenticação equivalente ao Facebook, Google, GitHub, etc.) você deveria utilizar um dos outros fluxos.
+
+O mais comum é o fluxo implícito.
+
+O mais seguro é o fluxo de código, mas ele é mais complexo para implementar, pois ele necessita mais passos. Como ele é mais complexo, muitos provedores terminam sugerindo o fluxo implícito.
+
+/// note | "Nota"
+
+É comum que cada provedor de autenticação nomeie os seus fluxos de forma diferente, para torná-lo parte de sua marca.
+
+Mas no final, eles estão implementando o mesmo padrão OAuth2.
+
+///
+
+O **FastAPI** inclui utilitários para todos esses fluxos de autenticação OAuth2 em `fastapi.security.oauth2`.
+
+## `Security` em docoradores de `dependências`
+
+Da mesma forma que você pode definir uma `list` de `Depends` no parâmetro de `dependencias` do decorador (como explicado em [Dependências em decoradores de operações de rota](../../tutorial/dependencies/dependencies-in-path-operation-decorators.md){.internal-link target=_blank}), você também pode utilizar `Security` com escopos lá.
From e2217e24b9895adf5d6f8ef25c491fca4f1bdafb Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 11:14:33 +0000
Subject: [PATCH 104/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 7188a698f..e2b5808a4 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/security/oauth2-scopes.md`. PR [#12263](https://github.com/fastapi/fastapi/pull/12263) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/concepts.md`. PR [#12219](https://github.com/fastapi/fastapi/pull/12219) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/conditional-openapi.md`. PR [#12221](https://github.com/fastapi/fastapi/pull/12221) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/response-directly.md`. PR [#12266](https://github.com/fastapi/fastapi/pull/12266) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
From a681aeba6d7112b9351a11ca5a1756de4e27d370 Mon Sep 17 00:00:00 2001
From: AnandaCampelo <103457620+AnandaCampelo@users.noreply.github.com>
Date: Fri, 4 Oct 2024 08:15:21 -0300
Subject: [PATCH 105/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/how-to/graphql.md`=20(#12215)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/how-to/graphql.md | 62 ++++++++++++++++++++++++++++++++++
1 file changed, 62 insertions(+)
create mode 100644 docs/pt/docs/how-to/graphql.md
diff --git a/docs/pt/docs/how-to/graphql.md b/docs/pt/docs/how-to/graphql.md
new file mode 100644
index 000000000..0b711aa5e
--- /dev/null
+++ b/docs/pt/docs/how-to/graphql.md
@@ -0,0 +1,62 @@
+# GraphQL
+
+Como o **FastAPI** é baseado no padrão **ASGI**, é muito fácil integrar qualquer biblioteca **GraphQL** também compatível com ASGI.
+
+Você pode combinar *operações de rota* normais do FastAPI com GraphQL na mesma aplicação.
+
+/// tip | "Dica"
+
+**GraphQL** resolve alguns casos de uso muito específicos.
+
+Ele tem **vantagens** e **desvantagens** quando comparado a **web APIs** comuns.
+
+Certifique-se de avaliar se os **benefícios** para o seu caso de uso compensam as **desvantagens**. 🤓
+
+///
+
+## Bibliotecas GraphQL
+
+Aqui estão algumas das bibliotecas **GraphQL** que têm suporte **ASGI**. Você pode usá-las com **FastAPI**:
+
+* <a href="https://strawberry.rocks/" class="external-link" target="_blank">Strawberry</a> 🍓
+ * Com <a href="https://strawberry.rocks/docs/integrations/fastapi" class="external-link" target="_blank">docs para FastAPI</a>
+* <a href="https://ariadnegraphql.org/" class="external-link" target="_blank">Ariadne</a>
+ * Com <a href="https://ariadnegraphql.org/docs/fastapi-integration" class="external-link" target="_blank">docs para FastAPI</a>
+* <a href="https://tartiflette.io/" class="external-link" target="_blank">Tartiflette</a>
+ * Com <a href="https://tartiflette.github.io/tartiflette-asgi/" class="external-link" target="_blank">Tartiflette ASGI</a> para fornecer integração ASGI
+* <a href="https://graphene-python.org/" class="external-link" target="_blank">Graphene</a>
+ * Com <a href="https://github.com/ciscorn/starlette-graphene3" class="external-link" target="_blank">starlette-graphene3</a>
+
+## GraphQL com Strawberry
+
+Se você precisar ou quiser trabalhar com **GraphQL**, <a href="https://strawberry.rocks/" class="external-link" target="_blank">**Strawberry**</a> é a biblioteca **recomendada** pois tem o design mais próximo ao design do **FastAPI**, ela é toda baseada em **type annotations**.
+
+Dependendo do seu caso de uso, você pode preferir usar uma biblioteca diferente, mas se você me perguntasse, eu provavelmente sugeriria que você experimentasse o **Strawberry**.
+
+Aqui está uma pequena prévia de como você poderia integrar Strawberry com FastAPI:
+
+```Python hl_lines="3 22 25-26"
+{!../../../docs_src/graphql/tutorial001.py!}
+```
+
+Você pode aprender mais sobre Strawberry na <a href="https://strawberry.rocks/" class="external-link" target="_blank">documentação do Strawberry</a>.
+
+E também na documentação sobre <a href="https://strawberry.rocks/docs/integrations/fastapi" class="external-link" target="_blank">Strawberry com FastAPI</a>.
+
+## Antigo `GraphQLApp` do Starlette
+
+Versões anteriores do Starlette incluiam uma classe `GraphQLApp` para integrar com <a href="https://graphene-python.org/" class="external-link" target="_blank">Graphene</a>.
+
+Ela foi descontinuada do Starlette, mas se você tem código que a utilizava, você pode facilmente **migrar** para <a href="https://github.com/ciscorn/starlette-graphene3" class="external-link" target="_blank">starlette-graphene3</a>, que cobre o mesmo caso de uso e tem uma **interface quase idêntica**.
+
+/// tip | "Dica"
+
+Se você precisa de GraphQL, eu ainda recomendaria que você desse uma olhada no <a href="https://strawberry.rocks/" class="external-link" target="_blank">Strawberry</a>, pois ele é baseado em type annotations em vez de classes e tipos personalizados.
+
+///
+
+## Saiba Mais
+
+Você pode aprender mais sobre **GraphQL** na <a href="https://graphql.org/" class="external-link" target="_blank">documentação oficial do GraphQL</a>.
+
+Você também pode ler mais sobre cada uma das bibliotecas descritas acima em seus links.
From c93810e0975a1f488f9d9d0a5b7a845b4d447a96 Mon Sep 17 00:00:00 2001
From: Kayque Govetri <59173212+kayqueGovetri@users.noreply.github.com>
Date: Fri, 4 Oct 2024 08:16:34 -0300
Subject: [PATCH 106/504] =?UTF-8?q?=F0=9F=93=9D=20Adding=20links=20for=20P?=
=?UTF-8?q?laywright=20and=20Vite=20in=20`docs/project-generation.md`=20(#?=
=?UTF-8?q?12274)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/project-generation.md | 4 ++--
docs/es/docs/project-generation.md | 4 ++--
docs/ko/docs/project-generation.md | 4 ++--
docs/zh/docs/project-generation.md | 4 ++--
4 files changed, 8 insertions(+), 8 deletions(-)
diff --git a/docs/en/docs/project-generation.md b/docs/en/docs/project-generation.md
index 61459ba53..665bc54f9 100644
--- a/docs/en/docs/project-generation.md
+++ b/docs/en/docs/project-generation.md
@@ -13,10 +13,10 @@ GitHub Repository: <a href="https://github.com/tiangolo/full-stack-fastapi-templ
- 🔍 [Pydantic](https://docs.pydantic.dev), used by FastAPI, for the data validation and settings management.
- 💾 [PostgreSQL](https://www.postgresql.org) as the SQL database.
- 🚀 [React](https://react.dev) for the frontend.
- - 💃 Using TypeScript, hooks, Vite, and other parts of a modern frontend stack.
+ - 💃 Using TypeScript, hooks, [Vite](https://vitejs.dev), and other parts of a modern frontend stack.
- 🎨 [Chakra UI](https://chakra-ui.com) for the frontend components.
- 🤖 An automatically generated frontend client.
- - 🧪 Playwright for End-to-End testing.
+ - 🧪 [Playwright](https://playwright.dev) for End-to-End testing.
- 🦇 Dark mode support.
- 🐋 [Docker Compose](https://www.docker.com) for development and production.
- 🔒 Secure password hashing by default.
diff --git a/docs/es/docs/project-generation.md b/docs/es/docs/project-generation.md
index 63febf1ae..6aa570397 100644
--- a/docs/es/docs/project-generation.md
+++ b/docs/es/docs/project-generation.md
@@ -13,10 +13,10 @@ Repositorio en GitHub: [Full Stack FastAPI Template](https://github.com/tiangolo
- 🔍 [Pydantic](https://docs.pydantic.dev), utilizado por FastAPI, para la validación de datos y la gestión de configuraciones.
- 💾 [PostgreSQL](https://www.postgresql.org) como la base de datos SQL.
- 🚀 [React](https://react.dev) para el frontend.
- - 💃 Usando TypeScript, hooks, Vite y otras partes de un stack de frontend moderno.
+ - 💃 Usando TypeScript, hooks, [Vite](https://vitejs.dev) y otras partes de un stack de frontend moderno.
- 🎨 [Chakra UI](https://chakra-ui.com) para los componentes del frontend.
- 🤖 Un cliente frontend generado automáticamente.
- - 🧪 Playwright para pruebas End-to-End.
+ - 🧪 [Playwright](https://playwright.dev) para pruebas End-to-End.
- 🦇 Soporte para modo oscuro.
- 🐋 [Docker Compose](https://www.docker.com) para desarrollo y producción.
- 🔒 Hashing seguro de contraseñas por defecto.
diff --git a/docs/ko/docs/project-generation.md b/docs/ko/docs/project-generation.md
index 019919f77..dd11fca70 100644
--- a/docs/ko/docs/project-generation.md
+++ b/docs/ko/docs/project-generation.md
@@ -13,10 +13,10 @@ GitHub 저장소: <a href="https://github.com/tiangolo/full-stack-fastapi-templa
- 🔍 [Pydantic](https://docs.pydantic.dev): FastAPI에 의해 사용되는, 데이터 검증과 설정관리.
- 💾 [PostgreSQL](https://www.postgresql.org): SQL 데이터베이스.
- 🚀 [React](https://react.dev): 프론트엔드.
- - 💃 TypeScript, hooks, Vite 및 기타 현대적인 프론트엔드 스택을 사용.
+ - 💃 TypeScript, hooks, [Vite](https://vitejs.dev) 및 기타 현대적인 프론트엔드 스택을 사용.
- 🎨 [Chakra UI](https://chakra-ui.com): 프론트엔드 컴포넌트.
- 🤖 자동으로 생성된 프론트엔드 클라이언트.
- - 🧪 E2E 테스트를 위한 Playwright.
+ - 🧪 E2E 테스트를 위한 [Playwright](https://playwright.dev).
- 🦇 다크 모드 지원.
- 🐋 [Docker Compose](https://www.docker.com): 개발 환경과 프로덕션(운영).
- 🔒 기본으로 지원되는 안전한 비밀번호 해싱.
diff --git a/docs/zh/docs/project-generation.md b/docs/zh/docs/project-generation.md
index 9b3735539..48eb990df 100644
--- a/docs/zh/docs/project-generation.md
+++ b/docs/zh/docs/project-generation.md
@@ -13,10 +13,10 @@
- 🔍 [Pydantic](https://docs.pydantic.dev) FastAPI的依赖项之一，用于数据验证和配置管理。
- 💾 [PostgreSQL](https://www.postgresql.org) 作为SQL数据库。
- 🚀 [React](https://react.dev) 用于前端。
- - 💃 使用了TypeScript、hooks、Vite和其他一些现代化的前端技术栈。
+ - 💃 使用了TypeScript、hooks、[Vite](https://vitejs.dev)和其他一些现代化的前端技术栈。
- 🎨 [Chakra UI](https://chakra-ui.com) 用于前端组件。
- 🤖 一个自动化生成的前端客户端。
- - 🧪 Playwright用于端到端测试。
+ - 🧪 [Playwright](https://playwright.dev)用于端到端测试。
- 🦇 支持暗黑主题（Dark mode）。
- 🐋 [Docker Compose](https://www.docker.com) 用于开发环境和生产环境。
- 🔒 默认使用密码哈希来保证安全。
From c08b80d09f22cef68f38f9d4d0fda978313a2316 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 11:20:35 +0000
Subject: [PATCH 107/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e2b5808a4..d205d96ac 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/graphql.md`. PR [#12215](https://github.com/fastapi/fastapi/pull/12215) by [@AnandaCampelo](https://github.com/AnandaCampelo).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/security/oauth2-scopes.md`. PR [#12263](https://github.com/fastapi/fastapi/pull/12263) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/concepts.md`. PR [#12219](https://github.com/fastapi/fastapi/pull/12219) by [@marcelomarkus](https://github.com/marcelomarkus).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/conditional-openapi.md`. PR [#12221](https://github.com/fastapi/fastapi/pull/12221) by [@marcelomarkus](https://github.com/marcelomarkus).
From 3d2483327234182791cd6855b180aa61936eaf05 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 11:20:57 +0000
Subject: [PATCH 108/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d205d96ac..bbc8ac14e 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Adding links for Playwright and Vite in `docs/project-generation.md`. PR [#12274](https://github.com/fastapi/fastapi/pull/12274) by [@kayqueGovetri](https://github.com/kayqueGovetri).
* 📝 Fix small typos in the documentation. PR [#12213](https://github.com/fastapi/fastapi/pull/12213) by [@svlandeg](https://github.com/svlandeg).
### Translations
From a096615f79cb428b68b4478fe5d53e2cf43f6ca2 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
<66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Fri, 4 Oct 2024 13:21:41 +0200
Subject: [PATCH 109/504] =?UTF-8?q?=E2=AC=86=20[pre-commit.ci]=20pre-commi?=
=?UTF-8?q?t=20autoupdate=20(#12331)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
updates:
- [github.com/astral-sh/ruff-pre-commit: v0.6.7 → v0.6.8](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.7...v0.6.8)
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
.pre-commit-config.yaml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 1502f0abd..48a7d495c 100644
--- a/.pre-commit-config.yaml
+++ b/.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.6.7
+ rev: v0.6.8
hooks:
- id: ruff
args:
From f2fb0251cc22b1a7c7a2a65b3f6ee68750353af5 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 11:26:21 +0000
Subject: [PATCH 110/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index bbc8ac14e..82012b1af 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -31,6 +31,7 @@ hide:
### Internal
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12331](https://github.com/fastapi/fastapi/pull/12331) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* 🔧 Update sponsors, remove Fine.dev. PR [#12271](https://github.com/fastapi/fastapi/pull/12271) by [@tiangolo](https://github.com/tiangolo).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12253](https://github.com/fastapi/fastapi/pull/12253) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* ✏️ Fix docstring typos in http security. PR [#12223](https://github.com/fastapi/fastapi/pull/12223) by [@albertvillanova](https://github.com/albertvillanova).
From 3f3a3dd6640f0639f27202cf049fb9b24b6c53a6 Mon Sep 17 00:00:00 2001
From: Pavlo Pohorieltsev <49622129+makisukurisu@users.noreply.github.com>
Date: Fri, 4 Oct 2024 14:34:57 +0300
Subject: [PATCH 111/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20link=20to=20Swa?=
=?UTF-8?q?gger=20UI=20configuration=20docs=20(#12264)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/de/docs/how-to/configure-swagger-ui.md | 4 ++--
docs/en/docs/how-to/configure-swagger-ui.md | 4 ++--
docs/pt/docs/how-to/configure-swagger-ui.md | 4 ++--
docs/zh/docs/how-to/configure-swagger-ui.md | 4 ++--
4 files changed, 8 insertions(+), 8 deletions(-)
diff --git a/docs/de/docs/how-to/configure-swagger-ui.md b/docs/de/docs/how-to/configure-swagger-ui.md
index c18091efd..7d62a14d3 100644
--- a/docs/de/docs/how-to/configure-swagger-ui.md
+++ b/docs/de/docs/how-to/configure-swagger-ui.md
@@ -1,6 +1,6 @@
# Swagger-Oberfläche konfigurieren
-Sie können einige zusätzliche <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">Parameter der Swagger-Oberfläche</a> konfigurieren.
+Sie können einige zusätzliche <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/" class="external-link" target="_blank">Parameter der Swagger-Oberfläche</a> konfigurieren.
Um diese zu konfigurieren, übergeben Sie das Argument `swagger_ui_parameters` beim Erstellen des `FastAPI()`-App-Objekts oder an die Funktion `get_swagger_ui_html()`.
@@ -58,7 +58,7 @@ Um beispielsweise `deepLinking` zu deaktivieren, könnten Sie folgende Einstellu
## Andere Parameter der Swagger-Oberfläche
-Um alle anderen möglichen Konfigurationen zu sehen, die Sie verwenden können, lesen Sie die offizielle <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">Dokumentation für die Parameter der Swagger-Oberfläche</a>.
+Um alle anderen möglichen Konfigurationen zu sehen, die Sie verwenden können, lesen Sie die offizielle <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/" class="external-link" target="_blank">Dokumentation für die Parameter der Swagger-Oberfläche</a>.
## JavaScript-basierte Einstellungen
diff --git a/docs/en/docs/how-to/configure-swagger-ui.md b/docs/en/docs/how-to/configure-swagger-ui.md
index 108afb929..040c3926b 100644
--- a/docs/en/docs/how-to/configure-swagger-ui.md
+++ b/docs/en/docs/how-to/configure-swagger-ui.md
@@ -1,6 +1,6 @@
# Configure Swagger UI
-You can configure some extra <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">Swagger UI parameters</a>.
+You can configure some extra <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/" class="external-link" target="_blank">Swagger UI parameters</a>.
To configure them, pass the `swagger_ui_parameters` argument when creating the `FastAPI()` app object or to the `get_swagger_ui_html()` function.
@@ -58,7 +58,7 @@ For example, to disable `deepLinking` you could pass these settings to `swagger_
## Other Swagger UI Parameters
-To see all the other possible configurations you can use, read the official <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">docs for Swagger UI parameters</a>.
+To see all the other possible configurations you can use, read the official <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/" class="external-link" target="_blank">docs for Swagger UI parameters</a>.
## JavaScript-only settings
diff --git a/docs/pt/docs/how-to/configure-swagger-ui.md b/docs/pt/docs/how-to/configure-swagger-ui.md
index b40dad695..ceb8c634e 100644
--- a/docs/pt/docs/how-to/configure-swagger-ui.md
+++ b/docs/pt/docs/how-to/configure-swagger-ui.md
@@ -1,6 +1,6 @@
# Configurar Swagger UI
-Você pode configurar alguns <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">parâmetros extras da UI do Swagger</a>.
+Você pode configurar alguns <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/" class="external-link" target="_blank">parâmetros extras da UI do Swagger</a>.
Para configurá-los, passe o argumento `swagger_ui_parameters` ao criar o objeto de aplicativo `FastAPI()` ou para a função `get_swagger_ui_html()`.
@@ -58,7 +58,7 @@ Por exemplo, para desabilitar `deepLinking` você pode passar essas configuraç
## Outros parâmetros da UI do Swagger
-Para ver todas as outras configurações possíveis que você pode usar, leia a <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">documentação oficial dos parâmetros da UI do Swagger</a>.
+Para ver todas as outras configurações possíveis que você pode usar, leia a <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/" class="external-link" target="_blank">documentação oficial dos parâmetros da UI do Swagger</a>.
## Configurações somente JavaScript
diff --git a/docs/zh/docs/how-to/configure-swagger-ui.md b/docs/zh/docs/how-to/configure-swagger-ui.md
index c0d09f943..17f89b22f 100644
--- a/docs/zh/docs/how-to/configure-swagger-ui.md
+++ b/docs/zh/docs/how-to/configure-swagger-ui.md
@@ -1,6 +1,6 @@
# 配置 Swagger UI
-你可以配置一些额外的 <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">Swagger UI 参数</a>.
+你可以配置一些额外的 <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/" class="external-link" target="_blank">Swagger UI 参数</a>.
如果需要配置它们，可以在创建 `FastAPI()` 应用对象时或调用 `get_swagger_ui_html()` 函数时传递 `swagger_ui_parameters` 参数。
@@ -58,7 +58,7 @@ FastAPI 包含了一些默认配置参数，适用于大多数用例。
## 其他 Swagger UI 参数
-查看其他 Swagger UI 参数，请阅读 <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">docs for Swagger UI parameters</a>。
+查看其他 Swagger UI 参数，请阅读 <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/" class="external-link" target="_blank">docs for Swagger UI parameters</a>。
## JavaScript-only 配置
From d12db0b26c11d338bba3f0099a6236b5931224dd Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 11:36:26 +0000
Subject: [PATCH 112/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 82012b1af..744377757 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update link to Swagger UI configuration docs. PR [#12264](https://github.com/fastapi/fastapi/pull/12264) by [@makisukurisu](https://github.com/makisukurisu).
* 📝 Adding links for Playwright and Vite in `docs/project-generation.md`. PR [#12274](https://github.com/fastapi/fastapi/pull/12274) by [@kayqueGovetri](https://github.com/kayqueGovetri).
* 📝 Fix small typos in the documentation. PR [#12213](https://github.com/fastapi/fastapi/pull/12213) by [@svlandeg](https://github.com/svlandeg).
From 8953d9a3234968d3673eddbeb947e42f34d3536a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 4 Oct 2024 13:37:26 +0200
Subject: [PATCH 113/504] =?UTF-8?q?=E2=AC=86=20Bump=20griffe-typingdoc=20f?=
=?UTF-8?q?rom=200.2.6=20to=200.2.7=20(#12370)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Bumps [griffe-typingdoc](https://github.com/mkdocstrings/griffe-typingdoc) from 0.2.6 to 0.2.7.
- [Release notes](https://github.com/mkdocstrings/griffe-typingdoc/releases)
- [Changelog](https://github.com/mkdocstrings/griffe-typingdoc/blob/main/CHANGELOG.md)
- [Commits](https://github.com/mkdocstrings/griffe-typingdoc/compare/0.2.6...0.2.7)
---
updated-dependencies:
- dependency-name: griffe-typingdoc
dependency-type: direct:production
update-type: version-update:semver-patch
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
requirements-docs.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/requirements-docs.txt b/requirements-docs.txt
index 332fd1857..70dca9f2f 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -12,7 +12,7 @@ pillow==10.4.0
# For image processing by Material for MkDocs
cairosvg==2.7.1
mkdocstrings[python]==0.25.1
-griffe-typingdoc==0.2.6
+griffe-typingdoc==0.2.7
# For griffe, it formats with black
black==24.3.0
mkdocs-macros-plugin==1.0.5
From deec2e591e6fb506c4249340b1b96c0b2afd4b07 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 11:39:01 +0000
Subject: [PATCH 114/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 744377757..8fbb26bb0 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -32,6 +32,7 @@ hide:
### Internal
+* ⬆ Bump griffe-typingdoc from 0.2.6 to 0.2.7. PR [#12370](https://github.com/fastapi/fastapi/pull/12370) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12331](https://github.com/fastapi/fastapi/pull/12331) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* 🔧 Update sponsors, remove Fine.dev. PR [#12271](https://github.com/fastapi/fastapi/pull/12271) by [@tiangolo](https://github.com/tiangolo).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12253](https://github.com/fastapi/fastapi/pull/12253) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
From 757eaacd5950ab355807ebf4f9e80dd17bd56b20 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 4 Oct 2024 13:56:35 +0200
Subject: [PATCH 115/504] =?UTF-8?q?=E2=AC=86=20Bump=20mkdocstrings[python]?=
=?UTF-8?q?=20from=200.25.1=20to=200.26.1=20(#12371)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Bumps [mkdocstrings[python]](https://github.com/mkdocstrings/mkdocstrings) from 0.25.1 to 0.26.1.
- [Release notes](https://github.com/mkdocstrings/mkdocstrings/releases)
- [Changelog](https://github.com/mkdocstrings/mkdocstrings/blob/main/CHANGELOG.md)
- [Commits](https://github.com/mkdocstrings/mkdocstrings/compare/0.25.1...0.26.1)
---
updated-dependencies:
- dependency-name: mkdocstrings[python]
dependency-type: direct:production
update-type: version-update:semver-minor
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Alejandra <90076947+alejsdev@users.noreply.github.com>
---
requirements-docs.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/requirements-docs.txt b/requirements-docs.txt
index 70dca9f2f..16b2998b9 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -11,7 +11,7 @@ jieba==0.42.1
pillow==10.4.0
# For image processing by Material for MkDocs
cairosvg==2.7.1
-mkdocstrings[python]==0.25.1
+mkdocstrings[python]==0.26.1
griffe-typingdoc==0.2.7
# For griffe, it formats with black
black==24.3.0
From 82b95dcef8d032628217599ea8700260d1ecc670 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 11:56:57 +0000
Subject: [PATCH 116/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8fbb26bb0..77daba91c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -32,6 +32,7 @@ hide:
### Internal
+* ⬆ Bump mkdocstrings[python] from 0.25.1 to 0.26.1. PR [#12371](https://github.com/fastapi/fastapi/pull/12371) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump griffe-typingdoc from 0.2.6 to 0.2.7. PR [#12370](https://github.com/fastapi/fastapi/pull/12370) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12331](https://github.com/fastapi/fastapi/pull/12331) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* 🔧 Update sponsors, remove Fine.dev. PR [#12271](https://github.com/fastapi/fastapi/pull/12271) by [@tiangolo](https://github.com/tiangolo).
From caa298aefea0ddbd373368b87a740b3bd08e4e42 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 4 Oct 2024 13:57:23 +0200
Subject: [PATCH 117/504] =?UTF-8?q?=E2=AC=86=20Bump=20pypa/gh-action-pypi-?=
=?UTF-8?q?publish=20from=201.10.1=20to=201.10.3=20(#12386)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Bumps [pypa/gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish) from 1.10.1 to 1.10.3.
- [Release notes](https://github.com/pypa/gh-action-pypi-publish/releases)
- [Commits](https://github.com/pypa/gh-action-pypi-publish/compare/v1.10.1...v1.10.3)
---
updated-dependencies:
- dependency-name: pypa/gh-action-pypi-publish
dependency-type: direct:production
update-type: version-update:semver-patch
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
.github/workflows/publish.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 5004b94dd..c8ea4e18c 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -35,7 +35,7 @@ jobs:
TIANGOLO_BUILD_PACKAGE: ${{ matrix.package }}
run: python -m build
- name: Publish
- uses: pypa/gh-action-pypi-publish@v1.10.1
+ uses: pypa/gh-action-pypi-publish@v1.10.3
- name: Dump GitHub context
env:
GITHUB_CONTEXT: ${{ toJson(github) }}
From ea1265b78beb2a7a1991a6dd4e8f19852ffa3196 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Oct 2024 11:58:03 +0000
Subject: [PATCH 118/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 77daba91c..6660ea894 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -32,6 +32,7 @@ hide:
### Internal
+* ⬆ Bump pypa/gh-action-pypi-publish from 1.10.1 to 1.10.3. PR [#12386](https://github.com/fastapi/fastapi/pull/12386) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump mkdocstrings[python] from 0.25.1 to 0.26.1. PR [#12371](https://github.com/fastapi/fastapi/pull/12371) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump griffe-typingdoc from 0.2.6 to 0.2.7. PR [#12370](https://github.com/fastapi/fastapi/pull/12370) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12331](https://github.com/fastapi/fastapi/pull/12331) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
From 9d6ec4aa77f613a99c8f05d8f8a0d2088a2a2d00 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 5 Oct 2024 14:49:04 +0200
Subject: [PATCH 119/504] =?UTF-8?q?=F0=9F=91=B7=20Update=20Cloudflare=20Gi?=
=?UTF-8?q?tHub=20Action=20(#12387)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/workflows/deploy-docs.yml | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index d2953f284..c7827f132 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -55,14 +55,14 @@ jobs:
# hashFiles returns an empty string if there are no files
if: hashFiles('./site/*')
id: deploy
- uses: cloudflare/pages-action@v1
+ env:
+ PROJECT_NAME: fastapitiangolo
+ BRANCH: ${{ ( github.event.workflow_run.head_repository.full_name == github.repository && github.event.workflow_run.head_branch == 'master' && 'main' ) || ( github.event.workflow_run.head_sha ) }}
+ uses: cloudflare/wrangler-action@v3
with:
apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
- projectName: fastapitiangolo
- directory: './site'
- gitHubToken: ${{ secrets.GITHUB_TOKEN }}
- branch: ${{ ( github.event.workflow_run.head_repository.full_name == github.repository && github.event.workflow_run.head_branch == 'master' && 'main' ) || ( github.event.workflow_run.head_sha ) }}
+ command: pages deploy ./site --project-name=${{ env.PROJECT_NAME }} --branch=${{ env.BRANCH }}
- name: Comment Deploy
run: python ./scripts/deploy_docs_status.py
env:
From ad8b3ba3ec5e41f7ebf85791870cab40f0429517 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 5 Oct 2024 12:49:28 +0000
Subject: [PATCH 120/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6660ea894..ddbaee46b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -32,6 +32,7 @@ hide:
### Internal
+* 👷 Update Cloudflare GitHub Action. PR [#12387](https://github.com/fastapi/fastapi/pull/12387) by [@tiangolo](https://github.com/tiangolo).
* ⬆ Bump pypa/gh-action-pypi-publish from 1.10.1 to 1.10.3. PR [#12386](https://github.com/fastapi/fastapi/pull/12386) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump mkdocstrings[python] from 0.25.1 to 0.26.1. PR [#12371](https://github.com/fastapi/fastapi/pull/12371) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump griffe-typingdoc from 0.2.6 to 0.2.7. PR [#12370](https://github.com/fastapi/fastapi/pull/12370) by [@dependabot[bot]](https://github.com/apps/dependabot).
From 1705a8c37f047df61564e47dd8c050d6213def81 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 6 Oct 2024 22:14:05 +0200
Subject: [PATCH 121/504] =?UTF-8?q?=F0=9F=91=B7=20Update=20deploy-docs-not?=
=?UTF-8?q?ify=20URL=20(#12392)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/workflows/deploy-docs.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index c7827f132..22dc89dff 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -67,7 +67,7 @@ jobs:
run: python ./scripts/deploy_docs_status.py
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- DEPLOY_URL: ${{ steps.deploy.outputs.url }}
+ DEPLOY_URL: ${{ steps.deploy.outputs.deployment-url }}
COMMIT_SHA: ${{ github.event.workflow_run.head_sha }}
RUN_ID: ${{ github.run_id }}
IS_DONE: "true"
From c67b41546cd322cb61e25cc275e995902519ca68 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 6 Oct 2024 20:14:33 +0000
Subject: [PATCH 122/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ddbaee46b..2995aa8df 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -32,6 +32,7 @@ hide:
### Internal
+* 👷 Update worfkow deploy-docs-notify URL. PR [#12392](https://github.com/fastapi/fastapi/pull/12392) by [@tiangolo](https://github.com/tiangolo).
* 👷 Update Cloudflare GitHub Action. PR [#12387](https://github.com/fastapi/fastapi/pull/12387) by [@tiangolo](https://github.com/tiangolo).
* ⬆ Bump pypa/gh-action-pypi-publish from 1.10.1 to 1.10.3. PR [#12386](https://github.com/fastapi/fastapi/pull/12386) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump mkdocstrings[python] from 0.25.1 to 0.26.1. PR [#12371](https://github.com/fastapi/fastapi/pull/12371) by [@dependabot[bot]](https://github.com/apps/dependabot).
From 0f7d67e85c9b99c82821c9cfde51721dd98698a1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 6 Oct 2024 22:36:54 +0200
Subject: [PATCH 123/504] =?UTF-8?q?=F0=9F=94=A7=20Remove=20`base=5Fpath`?=
=?UTF-8?q?=20for=20`mdx=5Finclude`=20Markdown=20extension=20in=20MkDocs?=
=?UTF-8?q?=20(#12391)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/bn/docs/python-types.md | 56 +++----
docs/de/docs/advanced/additional-responses.md | 8 +-
.../docs/advanced/additional-status-codes.md | 10 +-
.../de/docs/advanced/advanced-dependencies.md | 24 +--
docs/de/docs/advanced/async-tests.md | 8 +-
docs/de/docs/advanced/behind-a-proxy.md | 10 +-
docs/de/docs/advanced/custom-response.md | 32 ++--
docs/de/docs/advanced/dataclasses.md | 6 +-
docs/de/docs/advanced/events.md | 12 +-
docs/de/docs/advanced/generate-clients.md | 16 +-
docs/de/docs/advanced/middleware.md | 6 +-
docs/de/docs/advanced/openapi-callbacks.md | 8 +-
docs/de/docs/advanced/openapi-webhooks.md | 2 +-
.../path-operation-advanced-configuration.md | 20 +--
.../advanced/response-change-status-code.md | 2 +-
docs/de/docs/advanced/response-cookies.md | 4 +-
docs/de/docs/advanced/response-directly.md | 4 +-
docs/de/docs/advanced/response-headers.md | 4 +-
.../docs/advanced/security/http-basic-auth.md | 18 +--
.../docs/advanced/security/oauth2-scopes.md | 96 ++++++------
docs/de/docs/advanced/settings.md | 36 ++---
docs/de/docs/advanced/sub-applications.md | 6 +-
docs/de/docs/advanced/templates.md | 8 +-
docs/de/docs/advanced/testing-dependencies.md | 10 +-
docs/de/docs/advanced/testing-events.md | 2 +-
docs/de/docs/advanced/testing-websockets.md | 2 +-
.../docs/advanced/using-request-directly.md | 2 +-
docs/de/docs/advanced/websockets.md | 20 +--
docs/de/docs/advanced/wsgi.md | 2 +-
docs/de/docs/how-to/conditional-openapi.md | 2 +-
docs/de/docs/how-to/configure-swagger-ui.md | 8 +-
docs/de/docs/how-to/custom-docs-ui-assets.md | 14 +-
.../docs/how-to/custom-request-and-route.md | 12 +-
docs/de/docs/how-to/extending-openapi.md | 10 +-
docs/de/docs/how-to/graphql.md | 2 +-
.../docs/how-to/separate-openapi-schemas.md | 36 ++---
docs/de/docs/python-types.md | 56 +++----
docs/de/docs/tutorial/background-tasks.md | 16 +-
docs/de/docs/tutorial/bigger-applications.md | 30 ++--
docs/de/docs/tutorial/body-fields.md | 20 +--
docs/de/docs/tutorial/body-multiple-params.md | 44 +++---
docs/de/docs/tutorial/body-nested-models.md | 56 +++----
docs/de/docs/tutorial/body-updates.md | 24 +--
docs/de/docs/tutorial/body.md | 24 +--
docs/de/docs/tutorial/cookie-params.md | 20 +--
.../dependencies/classes-as-dependencies.md | 70 ++++-----
...pendencies-in-path-operation-decorators.md | 24 +--
.../dependencies/dependencies-with-yield.md | 28 ++--
.../dependencies/global-dependencies.md | 6 +-
docs/de/docs/tutorial/dependencies/index.md | 36 ++---
.../tutorial/dependencies/sub-dependencies.md | 30 ++--
docs/de/docs/tutorial/encoder.md | 4 +-
docs/de/docs/tutorial/extra-data-types.md | 20 +--
docs/de/docs/tutorial/extra-models.md | 20 +--
docs/de/docs/tutorial/first-steps.md | 16 +-
docs/de/docs/tutorial/handling-errors.md | 16 +-
docs/de/docs/tutorial/header-params.md | 42 ++---
docs/de/docs/tutorial/metadata.md | 12 +-
docs/de/docs/tutorial/middleware.md | 4 +-
.../tutorial/path-operation-configuration.md | 34 ++--
.../path-params-numeric-validations.md | 50 +++---
docs/de/docs/tutorial/path-params.md | 20 +--
.../tutorial/query-params-str-validations.md | 142 ++++++++---------
docs/de/docs/tutorial/query-params.md | 20 +--
docs/de/docs/tutorial/request-files.md | 50 +++---
.../docs/tutorial/request-forms-and-files.md | 12 +-
docs/de/docs/tutorial/request-forms.md | 12 +-
docs/de/docs/tutorial/response-model.md | 68 ++++----
docs/de/docs/tutorial/response-status-code.md | 6 +-
docs/de/docs/tutorial/schema-extra-example.md | 42 ++---
docs/de/docs/tutorial/security/first-steps.md | 18 +--
.../tutorial/security/get-current-user.md | 56 +++----
docs/de/docs/tutorial/security/oauth2-jwt.md | 40 ++---
.../docs/tutorial/security/simple-oauth2.md | 50 +++---
docs/de/docs/tutorial/static-files.md | 2 +-
docs/de/docs/tutorial/testing.md | 18 +--
docs/em/docs/advanced/additional-responses.md | 8 +-
.../docs/advanced/additional-status-codes.md | 2 +-
.../em/docs/advanced/advanced-dependencies.md | 8 +-
docs/em/docs/advanced/async-tests.md | 8 +-
docs/em/docs/advanced/behind-a-proxy.md | 8 +-
docs/em/docs/advanced/custom-response.md | 32 ++--
docs/em/docs/advanced/dataclasses.md | 6 +-
docs/em/docs/advanced/events.md | 12 +-
docs/em/docs/advanced/generate-clients.md | 14 +-
docs/em/docs/advanced/middleware.md | 6 +-
docs/em/docs/advanced/openapi-callbacks.md | 8 +-
.../path-operation-advanced-configuration.md | 16 +-
.../advanced/response-change-status-code.md | 2 +-
docs/em/docs/advanced/response-cookies.md | 4 +-
docs/em/docs/advanced/response-directly.md | 4 +-
docs/em/docs/advanced/response-headers.md | 4 +-
.../docs/advanced/security/http-basic-auth.md | 6 +-
.../docs/advanced/security/oauth2-scopes.md | 16 +-
docs/em/docs/advanced/settings.md | 20 +--
docs/em/docs/advanced/sub-applications.md | 6 +-
docs/em/docs/advanced/templates.md | 8 +-
docs/em/docs/advanced/testing-database.md | 8 +-
docs/em/docs/advanced/testing-dependencies.md | 2 +-
docs/em/docs/advanced/testing-events.md | 2 +-
docs/em/docs/advanced/testing-websockets.md | 2 +-
.../docs/advanced/using-request-directly.md | 2 +-
docs/em/docs/advanced/websockets.md | 10 +-
docs/em/docs/advanced/wsgi.md | 2 +-
docs/em/docs/how-to/conditional-openapi.md | 2 +-
.../docs/how-to/custom-request-and-route.md | 12 +-
docs/em/docs/how-to/extending-openapi.md | 10 +-
docs/em/docs/how-to/graphql.md | 2 +-
docs/em/docs/how-to/sql-databases-peewee.md | 34 ++--
docs/em/docs/python-types.md | 52 +++----
docs/em/docs/tutorial/background-tasks.md | 10 +-
docs/em/docs/tutorial/bigger-applications.md | 26 ++--
docs/em/docs/tutorial/body-fields.md | 8 +-
docs/em/docs/tutorial/body-multiple-params.md | 20 +--
docs/em/docs/tutorial/body-nested-models.md | 56 +++----
docs/em/docs/tutorial/body-updates.md | 24 +--
docs/em/docs/tutorial/body.md | 24 +--
docs/em/docs/tutorial/cookie-params.md | 8 +-
docs/em/docs/tutorial/cors.md | 2 +-
docs/em/docs/tutorial/debugging.md | 2 +-
.../dependencies/classes-as-dependencies.md | 28 ++--
...pendencies-in-path-operation-decorators.md | 8 +-
.../dependencies/dependencies-with-yield.md | 14 +-
.../dependencies/global-dependencies.md | 2 +-
docs/em/docs/tutorial/dependencies/index.md | 12 +-
.../tutorial/dependencies/sub-dependencies.md | 12 +-
docs/em/docs/tutorial/encoder.md | 4 +-
docs/em/docs/tutorial/extra-data-types.md | 8 +-
docs/em/docs/tutorial/extra-models.md | 20 +--
docs/em/docs/tutorial/first-steps.md | 16 +-
docs/em/docs/tutorial/handling-errors.md | 16 +-
docs/em/docs/tutorial/header-params.md | 18 +--
docs/em/docs/tutorial/metadata.md | 10 +-
docs/em/docs/tutorial/middleware.md | 4 +-
.../tutorial/path-operation-configuration.md | 34 ++--
.../path-params-numeric-validations.md | 18 +--
docs/em/docs/tutorial/path-params.md | 20 +--
.../tutorial/query-params-str-validations.md | 64 ++++----
docs/em/docs/tutorial/query-params.md | 20 +--
docs/em/docs/tutorial/request-files.md | 20 +--
.../docs/tutorial/request-forms-and-files.md | 4 +-
docs/em/docs/tutorial/request-forms.md | 4 +-
docs/em/docs/tutorial/response-model.md | 68 ++++----
docs/em/docs/tutorial/response-status-code.md | 6 +-
docs/em/docs/tutorial/schema-extra-example.md | 16 +-
docs/em/docs/tutorial/security/first-steps.md | 6 +-
.../tutorial/security/get-current-user.md | 22 +--
docs/em/docs/tutorial/security/oauth2-jwt.md | 16 +-
.../docs/tutorial/security/simple-oauth2.md | 20 +--
docs/em/docs/tutorial/sql-databases.md | 74 ++++-----
docs/em/docs/tutorial/static-files.md | 2 +-
docs/em/docs/tutorial/testing.md | 12 +-
docs/en/docs/advanced/additional-responses.md | 8 +-
.../docs/advanced/additional-status-codes.md | 10 +-
.../en/docs/advanced/advanced-dependencies.md | 24 +--
docs/en/docs/advanced/async-tests.md | 8 +-
docs/en/docs/advanced/behind-a-proxy.md | 10 +-
docs/en/docs/advanced/custom-response.md | 32 ++--
docs/en/docs/advanced/dataclasses.md | 6 +-
docs/en/docs/advanced/events.md | 12 +-
docs/en/docs/advanced/generate-clients.md | 16 +-
docs/en/docs/advanced/middleware.md | 6 +-
docs/en/docs/advanced/openapi-callbacks.md | 8 +-
docs/en/docs/advanced/openapi-webhooks.md | 2 +-
.../path-operation-advanced-configuration.md | 20 +--
.../advanced/response-change-status-code.md | 2 +-
docs/en/docs/advanced/response-cookies.md | 4 +-
docs/en/docs/advanced/response-directly.md | 4 +-
docs/en/docs/advanced/response-headers.md | 4 +-
.../docs/advanced/security/http-basic-auth.md | 18 +--
.../docs/advanced/security/oauth2-scopes.md | 96 ++++++------
docs/en/docs/advanced/settings.md | 36 ++---
docs/en/docs/advanced/sub-applications.md | 6 +-
docs/en/docs/advanced/templates.md | 8 +-
docs/en/docs/advanced/testing-database.md | 8 +-
docs/en/docs/advanced/testing-dependencies.md | 10 +-
docs/en/docs/advanced/testing-events.md | 2 +-
docs/en/docs/advanced/testing-websockets.md | 2 +-
.../docs/advanced/using-request-directly.md | 2 +-
docs/en/docs/advanced/websockets.md | 20 +--
docs/en/docs/advanced/wsgi.md | 2 +-
.../docs/how-to/async-sql-encode-databases.md | 14 +-
docs/en/docs/how-to/conditional-openapi.md | 2 +-
docs/en/docs/how-to/configure-swagger-ui.md | 8 +-
docs/en/docs/how-to/custom-docs-ui-assets.md | 14 +-
.../docs/how-to/custom-request-and-route.md | 12 +-
docs/en/docs/how-to/extending-openapi.md | 10 +-
docs/en/docs/how-to/graphql.md | 2 +-
.../docs/how-to/nosql-databases-couchbase.md | 16 +-
.../docs/how-to/separate-openapi-schemas.md | 36 ++---
docs/en/docs/how-to/sql-databases-peewee.md | 34 ++--
docs/en/docs/python-types.md | 56 +++----
docs/en/docs/tutorial/background-tasks.md | 16 +-
docs/en/docs/tutorial/bigger-applications.md | 30 ++--
docs/en/docs/tutorial/body-fields.md | 20 +--
docs/en/docs/tutorial/body-multiple-params.md | 44 +++---
docs/en/docs/tutorial/body-nested-models.md | 56 +++----
docs/en/docs/tutorial/body-updates.md | 24 +--
docs/en/docs/tutorial/body.md | 24 +--
docs/en/docs/tutorial/cookie-param-models.md | 16 +-
docs/en/docs/tutorial/cookie-params.md | 20 +--
docs/en/docs/tutorial/cors.md | 2 +-
docs/en/docs/tutorial/debugging.md | 2 +-
.../dependencies/classes-as-dependencies.md | 70 ++++-----
...pendencies-in-path-operation-decorators.md | 24 +--
.../dependencies/dependencies-with-yield.md | 40 ++---
.../dependencies/global-dependencies.md | 6 +-
docs/en/docs/tutorial/dependencies/index.md | 36 ++---
.../tutorial/dependencies/sub-dependencies.md | 30 ++--
docs/en/docs/tutorial/encoder.md | 4 +-
docs/en/docs/tutorial/extra-data-types.md | 20 +--
docs/en/docs/tutorial/extra-models.md | 20 +--
docs/en/docs/tutorial/first-steps.md | 14 +-
docs/en/docs/tutorial/handling-errors.md | 16 +-
docs/en/docs/tutorial/header-param-models.md | 24 +--
docs/en/docs/tutorial/header-params.md | 42 ++---
docs/en/docs/tutorial/metadata.md | 12 +-
docs/en/docs/tutorial/middleware.md | 4 +-
.../tutorial/path-operation-configuration.md | 34 ++--
.../path-params-numeric-validations.md | 50 +++---
docs/en/docs/tutorial/path-params.md | 20 +--
docs/en/docs/tutorial/query-param-models.md | 24 +--
.../tutorial/query-params-str-validations.md | 142 ++++++++---------
docs/en/docs/tutorial/query-params.md | 20 +--
docs/en/docs/tutorial/request-files.md | 50 +++---
docs/en/docs/tutorial/request-form-models.md | 12 +-
.../docs/tutorial/request-forms-and-files.md | 12 +-
docs/en/docs/tutorial/request-forms.md | 12 +-
docs/en/docs/tutorial/response-model.md | 68 ++++----
docs/en/docs/tutorial/response-status-code.md | 6 +-
docs/en/docs/tutorial/schema-extra-example.md | 42 ++---
docs/en/docs/tutorial/security/first-steps.md | 18 +--
.../tutorial/security/get-current-user.md | 56 +++----
docs/en/docs/tutorial/security/oauth2-jwt.md | 40 ++---
.../docs/tutorial/security/simple-oauth2.md | 50 +++---
docs/en/docs/tutorial/sql-databases.md | 26 ++--
docs/en/docs/tutorial/static-files.md | 2 +-
docs/en/docs/tutorial/testing.md | 18 +--
docs/en/mkdocs.yml | 1 -
.../docs/advanced/additional-status-codes.md | 2 +-
.../path-operation-advanced-configuration.md | 8 +-
.../advanced/response-change-status-code.md | 2 +-
docs/es/docs/advanced/response-directly.md | 4 +-
docs/es/docs/advanced/response-headers.md | 4 +-
docs/es/docs/how-to/graphql.md | 2 +-
docs/es/docs/python-types.md | 26 ++--
docs/es/docs/tutorial/cookie-params.md | 20 +--
docs/es/docs/tutorial/first-steps.md | 16 +-
docs/es/docs/tutorial/path-params.md | 18 +--
docs/es/docs/tutorial/query-params.md | 12 +-
docs/fa/docs/advanced/sub-applications.md | 6 +-
docs/fa/docs/tutorial/middleware.md | 4 +-
docs/fr/docs/advanced/additional-responses.md | 8 +-
.../docs/advanced/additional-status-codes.md | 2 +-
.../path-operation-advanced-configuration.md | 16 +-
docs/fr/docs/advanced/response-directly.md | 4 +-
docs/fr/docs/python-types.md | 28 ++--
docs/fr/docs/tutorial/background-tasks.md | 8 +-
docs/fr/docs/tutorial/body-multiple-params.md | 44 +++---
docs/fr/docs/tutorial/body.md | 12 +-
docs/fr/docs/tutorial/debugging.md | 2 +-
docs/fr/docs/tutorial/first-steps.md | 16 +-
.../path-params-numeric-validations.md | 56 +++----
docs/fr/docs/tutorial/path-params.md | 18 +--
.../tutorial/query-params-str-validations.md | 28 ++--
docs/fr/docs/tutorial/query-params.md | 12 +-
.../docs/advanced/additional-status-codes.md | 2 +-
docs/ja/docs/advanced/custom-response.md | 24 +--
.../path-operation-advanced-configuration.md | 8 +-
docs/ja/docs/advanced/response-directly.md | 4 +-
docs/ja/docs/advanced/websockets.md | 10 +-
docs/ja/docs/how-to/conditional-openapi.md | 2 +-
docs/ja/docs/python-types.md | 28 ++--
docs/ja/docs/tutorial/background-tasks.md | 8 +-
docs/ja/docs/tutorial/body-fields.md | 4 +-
docs/ja/docs/tutorial/body-multiple-params.md | 10 +-
docs/ja/docs/tutorial/body-nested-models.md | 22 +--
docs/ja/docs/tutorial/body-updates.md | 8 +-
docs/ja/docs/tutorial/body.md | 12 +-
docs/ja/docs/tutorial/cookie-params.md | 4 +-
docs/ja/docs/tutorial/cors.md | 2 +-
docs/ja/docs/tutorial/debugging.md | 2 +-
.../dependencies/classes-as-dependencies.md | 14 +-
...pendencies-in-path-operation-decorators.md | 8 +-
.../dependencies/dependencies-with-yield.md | 14 +-
docs/ja/docs/tutorial/dependencies/index.md | 6 +-
.../tutorial/dependencies/sub-dependencies.md | 6 +-
docs/ja/docs/tutorial/encoder.md | 2 +-
docs/ja/docs/tutorial/extra-data-types.md | 4 +-
docs/ja/docs/tutorial/extra-models.md | 10 +-
docs/ja/docs/tutorial/first-steps.md | 16 +-
docs/ja/docs/tutorial/handling-errors.md | 16 +-
docs/ja/docs/tutorial/header-params.md | 8 +-
docs/ja/docs/tutorial/metadata.md | 10 +-
docs/ja/docs/tutorial/middleware.md | 4 +-
.../tutorial/path-operation-configuration.md | 12 +-
.../path-params-numeric-validations.md | 14 +-
docs/ja/docs/tutorial/path-params.md | 18 +--
.../tutorial/query-params-str-validations.md | 28 ++--
docs/ja/docs/tutorial/query-params.md | 12 +-
.../docs/tutorial/request-forms-and-files.md | 4 +-
docs/ja/docs/tutorial/request-forms.md | 4 +-
docs/ja/docs/tutorial/response-model.md | 20 +--
docs/ja/docs/tutorial/response-status-code.md | 6 +-
docs/ja/docs/tutorial/schema-extra-example.md | 6 +-
docs/ja/docs/tutorial/security/first-steps.md | 6 +-
.../tutorial/security/get-current-user.md | 12 +-
docs/ja/docs/tutorial/security/oauth2-jwt.md | 8 +-
docs/ja/docs/tutorial/static-files.md | 2 +-
docs/ja/docs/tutorial/testing.md | 12 +-
docs/ko/docs/advanced/events.md | 4 +-
docs/ko/docs/python-types.md | 28 ++--
docs/ko/docs/tutorial/background-tasks.md | 10 +-
docs/ko/docs/tutorial/body-fields.md | 20 +--
docs/ko/docs/tutorial/body-multiple-params.md | 10 +-
docs/ko/docs/tutorial/body-nested-models.md | 22 +--
docs/ko/docs/tutorial/body.md | 24 +--
docs/ko/docs/tutorial/cookie-params.md | 20 +--
docs/ko/docs/tutorial/cors.md | 2 +-
docs/ko/docs/tutorial/debugging.md | 2 +-
.../dependencies/classes-as-dependencies.md | 28 ++--
...pendencies-in-path-operation-decorators.md | 24 +--
.../dependencies/global-dependencies.md | 6 +-
docs/ko/docs/tutorial/dependencies/index.md | 36 ++---
docs/ko/docs/tutorial/encoder.md | 2 +-
docs/ko/docs/tutorial/extra-data-types.md | 20 +--
docs/ko/docs/tutorial/first-steps.md | 16 +-
docs/ko/docs/tutorial/header-params.md | 8 +-
docs/ko/docs/tutorial/middleware.md | 4 +-
.../tutorial/path-operation-configuration.md | 12 +-
.../path-params-numeric-validations.md | 14 +-
docs/ko/docs/tutorial/path-params.md | 18 +--
.../tutorial/query-params-str-validations.md | 28 ++--
docs/ko/docs/tutorial/query-params.md | 12 +-
docs/ko/docs/tutorial/request-files.md | 8 +-
.../docs/tutorial/request-forms-and-files.md | 4 +-
docs/ko/docs/tutorial/response-model.md | 20 +--
docs/ko/docs/tutorial/response-status-code.md | 6 +-
docs/ko/docs/tutorial/schema-extra-example.md | 42 ++---
.../tutorial/security/get-current-user.md | 22 +--
.../docs/tutorial/security/simple-oauth2.md | 20 +--
docs/ko/docs/tutorial/static-files.md | 2 +-
docs/nl/docs/python-types.md | 56 +++----
docs/pl/docs/tutorial/first-steps.md | 16 +-
docs/pt/docs/advanced/additional-responses.md | 8 +-
.../docs/advanced/additional-status-codes.md | 10 +-
.../pt/docs/advanced/advanced-dependencies.md | 24 +--
docs/pt/docs/advanced/async-tests.md | 8 +-
docs/pt/docs/advanced/behind-a-proxy.md | 10 +-
docs/pt/docs/advanced/events.md | 12 +-
docs/pt/docs/advanced/openapi-webhooks.md | 2 +-
.../advanced/response-change-status-code.md | 2 +-
docs/pt/docs/advanced/response-directly.md | 4 +-
.../docs/advanced/security/http-basic-auth.md | 18 +--
.../docs/advanced/security/oauth2-scopes.md | 96 ++++++------
docs/pt/docs/advanced/settings.md | 36 ++---
docs/pt/docs/advanced/sub-applications.md | 6 +-
docs/pt/docs/advanced/templates.md | 8 +-
docs/pt/docs/advanced/testing-dependencies.md | 10 +-
docs/pt/docs/advanced/testing-events.md | 2 +-
docs/pt/docs/advanced/testing-websockets.md | 2 +-
.../docs/advanced/using-request-directly.md | 2 +-
docs/pt/docs/advanced/wsgi.md | 2 +-
docs/pt/docs/how-to/conditional-openapi.md | 2 +-
docs/pt/docs/how-to/configure-swagger-ui.md | 8 +-
docs/pt/docs/how-to/graphql.md | 2 +-
docs/pt/docs/python-types.md | 28 ++--
docs/pt/docs/tutorial/background-tasks.md | 8 +-
docs/pt/docs/tutorial/bigger-applications.md | 30 ++--
docs/pt/docs/tutorial/body-fields.md | 4 +-
docs/pt/docs/tutorial/body-multiple-params.md | 20 +--
docs/pt/docs/tutorial/body-nested-models.md | 22 +--
docs/pt/docs/tutorial/body.md | 12 +-
docs/pt/docs/tutorial/cookie-params.md | 20 +--
docs/pt/docs/tutorial/cors.md | 2 +-
docs/pt/docs/tutorial/debugging.md | 2 +-
.../dependencies/classes-as-dependencies.md | 70 ++++-----
...pendencies-in-path-operation-decorators.md | 24 +--
.../dependencies/dependencies-with-yield.md | 40 ++---
.../dependencies/global-dependencies.md | 6 +-
docs/pt/docs/tutorial/dependencies/index.md | 36 ++---
.../tutorial/dependencies/sub-dependencies.md | 30 ++--
docs/pt/docs/tutorial/encoder.md | 4 +-
docs/pt/docs/tutorial/extra-data-types.md | 4 +-
docs/pt/docs/tutorial/extra-models.md | 20 +--
docs/pt/docs/tutorial/first-steps.md | 16 +-
docs/pt/docs/tutorial/handling-errors.md | 14 +-
docs/pt/docs/tutorial/header-params.md | 18 +--
docs/pt/docs/tutorial/middleware.md | 4 +-
.../tutorial/path-operation-configuration.md | 34 ++--
.../path-params-numeric-validations.md | 18 +--
docs/pt/docs/tutorial/path-params.md | 18 +--
.../tutorial/query-params-str-validations.md | 28 ++--
docs/pt/docs/tutorial/query-params.md | 20 +--
docs/pt/docs/tutorial/request-form-models.md | 12 +-
.../docs/tutorial/request-forms-and-files.md | 4 +-
docs/pt/docs/tutorial/request-forms.md | 4 +-
docs/pt/docs/tutorial/request_files.md | 50 +++---
docs/pt/docs/tutorial/response-status-code.md | 6 +-
docs/pt/docs/tutorial/schema-extra-example.md | 8 +-
docs/pt/docs/tutorial/security/first-steps.md | 6 +-
docs/pt/docs/tutorial/static-files.md | 2 +-
docs/pt/docs/tutorial/testing.md | 18 +--
docs/ru/docs/python-types.md | 28 ++--
docs/ru/docs/tutorial/background-tasks.md | 10 +-
docs/ru/docs/tutorial/body-fields.md | 8 +-
docs/ru/docs/tutorial/body-multiple-params.md | 44 +++---
docs/ru/docs/tutorial/body-nested-models.md | 56 +++----
docs/ru/docs/tutorial/body-updates.md | 24 +--
docs/ru/docs/tutorial/body.md | 12 +-
docs/ru/docs/tutorial/cookie-params.md | 8 +-
docs/ru/docs/tutorial/cors.md | 2 +-
docs/ru/docs/tutorial/debugging.md | 2 +-
.../dependencies/classes-as-dependencies.md | 70 ++++-----
...pendencies-in-path-operation-decorators.md | 24 +--
.../dependencies/dependencies-with-yield.md | 22 +--
.../dependencies/global-dependencies.md | 6 +-
docs/ru/docs/tutorial/dependencies/index.md | 36 ++---
.../tutorial/dependencies/sub-dependencies.md | 30 ++--
docs/ru/docs/tutorial/encoder.md | 4 +-
docs/ru/docs/tutorial/extra-data-types.md | 8 +-
docs/ru/docs/tutorial/extra-models.md | 20 +--
docs/ru/docs/tutorial/first-steps.md | 16 +-
docs/ru/docs/tutorial/handling-errors.md | 16 +-
docs/ru/docs/tutorial/header-params.md | 42 ++---
docs/ru/docs/tutorial/metadata.md | 10 +-
.../tutorial/path-operation-configuration.md | 34 ++--
.../path-params-numeric-validations.md | 50 +++---
docs/ru/docs/tutorial/path-params.md | 20 +--
.../tutorial/query-params-str-validations.md | 146 +++++++++---------
docs/ru/docs/tutorial/query-params.md | 20 +--
docs/ru/docs/tutorial/request-files.md | 50 +++---
.../docs/tutorial/request-forms-and-files.md | 12 +-
docs/ru/docs/tutorial/request-forms.md | 12 +-
docs/ru/docs/tutorial/response-model.md | 68 ++++----
docs/ru/docs/tutorial/response-status-code.md | 6 +-
docs/ru/docs/tutorial/schema-extra-example.md | 28 ++--
docs/ru/docs/tutorial/security/first-steps.md | 18 +--
docs/ru/docs/tutorial/static-files.md | 2 +-
docs/ru/docs/tutorial/testing.md | 18 +--
docs/tr/docs/advanced/testing-websockets.md | 2 +-
docs/tr/docs/advanced/wsgi.md | 2 +-
docs/tr/docs/python-types.md | 28 ++--
docs/tr/docs/tutorial/cookie-params.md | 20 +--
docs/tr/docs/tutorial/first-steps.md | 16 +-
docs/tr/docs/tutorial/path-params.md | 20 +--
docs/tr/docs/tutorial/query-params.md | 20 +--
docs/tr/docs/tutorial/request-forms.md | 12 +-
docs/tr/docs/tutorial/static-files.md | 2 +-
docs/uk/docs/python-types.md | 48 +++---
docs/uk/docs/tutorial/body-fields.md | 20 +--
docs/uk/docs/tutorial/body.md | 24 +--
docs/uk/docs/tutorial/cookie-params.md | 20 +--
docs/uk/docs/tutorial/encoder.md | 4 +-
docs/uk/docs/tutorial/extra-data-types.md | 20 +--
docs/uk/docs/tutorial/first-steps.md | 14 +-
docs/vi/docs/python-types.md | 56 +++----
docs/vi/docs/tutorial/first-steps.md | 16 +-
docs/zh/docs/advanced/additional-responses.md | 8 +-
.../docs/advanced/additional-status-codes.md | 2 +-
.../zh/docs/advanced/advanced-dependencies.md | 8 +-
docs/zh/docs/advanced/behind-a-proxy.md | 8 +-
docs/zh/docs/advanced/custom-response.md | 22 +--
docs/zh/docs/advanced/dataclasses.md | 6 +-
docs/zh/docs/advanced/events.md | 4 +-
docs/zh/docs/advanced/generate-clients.md | 14 +-
docs/zh/docs/advanced/middleware.md | 6 +-
docs/zh/docs/advanced/openapi-callbacks.md | 8 +-
.../path-operation-advanced-configuration.md | 8 +-
.../advanced/response-change-status-code.md | 2 +-
docs/zh/docs/advanced/response-cookies.md | 4 +-
docs/zh/docs/advanced/response-directly.md | 4 +-
docs/zh/docs/advanced/response-headers.md | 4 +-
.../docs/advanced/security/http-basic-auth.md | 18 +--
.../docs/advanced/security/oauth2-scopes.md | 16 +-
docs/zh/docs/advanced/settings.md | 32 ++--
docs/zh/docs/advanced/sub-applications.md | 6 +-
docs/zh/docs/advanced/templates.md | 8 +-
docs/zh/docs/advanced/testing-database.md | 8 +-
docs/zh/docs/advanced/testing-dependencies.md | 2 +-
docs/zh/docs/advanced/testing-events.md | 2 +-
docs/zh/docs/advanced/testing-websockets.md | 2 +-
.../docs/advanced/using-request-directly.md | 2 +-
docs/zh/docs/advanced/websockets.md | 20 +--
docs/zh/docs/advanced/wsgi.md | 2 +-
docs/zh/docs/how-to/configure-swagger-ui.md | 8 +-
docs/zh/docs/python-types.md | 26 ++--
docs/zh/docs/tutorial/background-tasks.md | 16 +-
docs/zh/docs/tutorial/bigger-applications.md | 26 ++--
docs/zh/docs/tutorial/body-fields.md | 20 +--
docs/zh/docs/tutorial/body-multiple-params.md | 44 +++---
docs/zh/docs/tutorial/body-nested-models.md | 56 +++----
docs/zh/docs/tutorial/body-updates.md | 8 +-
docs/zh/docs/tutorial/body.md | 24 +--
docs/zh/docs/tutorial/cookie-params.md | 20 +--
docs/zh/docs/tutorial/cors.md | 2 +-
docs/zh/docs/tutorial/debugging.md | 2 +-
.../dependencies/classes-as-dependencies.md | 28 ++--
...pendencies-in-path-operation-decorators.md | 8 +-
.../dependencies/dependencies-with-yield.md | 40 ++---
.../dependencies/global-dependencies.md | 2 +-
docs/zh/docs/tutorial/dependencies/index.md | 6 +-
.../tutorial/dependencies/sub-dependencies.md | 6 +-
docs/zh/docs/tutorial/encoder.md | 4 +-
docs/zh/docs/tutorial/extra-data-types.md | 20 +--
docs/zh/docs/tutorial/extra-models.md | 20 +--
docs/zh/docs/tutorial/first-steps.md | 16 +-
docs/zh/docs/tutorial/handling-errors.md | 16 +-
docs/zh/docs/tutorial/header-params.md | 42 ++---
docs/zh/docs/tutorial/metadata.md | 10 +-
docs/zh/docs/tutorial/middleware.md | 4 +-
.../tutorial/path-operation-configuration.md | 12 +-
.../path-params-numeric-validations.md | 30 ++--
docs/zh/docs/tutorial/path-params.md | 18 +--
.../tutorial/query-params-str-validations.md | 36 ++---
docs/zh/docs/tutorial/query-params.md | 20 +--
docs/zh/docs/tutorial/request-files.md | 20 +--
.../docs/tutorial/request-forms-and-files.md | 4 +-
docs/zh/docs/tutorial/request-forms.md | 4 +-
docs/zh/docs/tutorial/response-model.md | 30 ++--
docs/zh/docs/tutorial/response-status-code.md | 6 +-
docs/zh/docs/tutorial/schema-extra-example.md | 18 +--
docs/zh/docs/tutorial/security/first-steps.md | 10 +-
.../tutorial/security/get-current-user.md | 12 +-
docs/zh/docs/tutorial/security/oauth2-jwt.md | 32 ++--
.../docs/tutorial/security/simple-oauth2.md | 10 +-
docs/zh/docs/tutorial/sql-databases.md | 74 ++++-----
docs/zh/docs/tutorial/static-files.md | 2 +-
docs/zh/docs/tutorial/testing.md | 18 +--
529 files changed, 4747 insertions(+), 4748 deletions(-)
diff --git a/docs/bn/docs/python-types.md b/docs/bn/docs/python-types.md
index d5304a65e..4a602b679 100644
--- a/docs/bn/docs/python-types.md
+++ b/docs/bn/docs/python-types.md
@@ -23,7 +23,7 @@ Python-এ ঐচ্ছিক "টাইপ হিন্ট" (যা "টাই
চলুন একটি সাধারণ উদাহরণ দিয়ে শুরু করি:
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
এই প্রোগ্রামটি কল করলে আউটপুট হয়:
@@ -39,7 +39,7 @@ John Doe
* তাদেরকে মাঝখানে একটি স্পেস দিয়ে <abbr title="একটার পরে একটা একত্রিত করা">concatenate</abbr> করে।
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### এটি সম্পাদনা করুন
@@ -83,7 +83,7 @@ John Doe
এগুলিই "টাইপ হিন্ট":
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
এটি ডিফল্ট ভ্যালু ঘোষণা করার মত নয় যেমন:
@@ -113,7 +113,7 @@ John Doe
এই ফাংশনটি দেখুন, এটিতে ইতিমধ্যে টাইপ হিন্ট রয়েছে:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
এডিটর ভেরিয়েবলগুলির টাইপ জানার কারণে, আপনি শুধুমাত্র অটোকমপ্লিশনই পান না, আপনি এরর চেকও পান:
@@ -123,7 +123,7 @@ John Doe
এখন আপনি জানেন যে আপনাকে এটি ঠিক করতে হবে, `age`-কে একটি স্ট্রিং হিসেবে রূপান্তর করতে `str(age)` ব্যবহার করতে হবে:
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## টাইপ ঘোষণা
@@ -144,7 +144,7 @@ John Doe
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### টাইপ প্যারামিটার সহ জেনেরিক টাইপ
@@ -182,7 +182,7 @@ Python যত এগিয়ে যাচ্ছে, **নতুন সংস্
যেহেতু লিস্ট এমন একটি টাইপ যা অভ্যন্তরীণ টাইপগুলি ধারণ করে, আপনি তাদের স্কোয়ার ব্রাকেটের ভিতরে ব্যবহার করুন:
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006_py39.py!}
+{!> ../../docs_src/python_types/tutorial006_py39.py!}
```
////
@@ -192,7 +192,7 @@ Python যত এগিয়ে যাচ্ছে, **নতুন সংস্
`typing` থেকে `List` (বড় হাতের `L` দিয়ে) ইমপোর্ট করুন:
``` Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
ভেরিয়েবলটি ঘোষণা করুন, একই কোলন (`:`) সিনট্যাক্স ব্যবহার করে।
@@ -202,7 +202,7 @@ Python যত এগিয়ে যাচ্ছে, **নতুন সংস্
যেহেতু লিস্ট এমন একটি টাইপ যা অভ্যন্তরীণ টাইপগুলি ধারণ করে, আপনি তাদের স্কোয়ার ব্রাকেটের ভিতরে করুন:
```Python hl_lines="4"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
////
@@ -240,7 +240,7 @@ Python যত এগিয়ে যাচ্ছে, **নতুন সংস্
//// tab | Python 3.9+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial007_py39.py!}
+{!> ../../docs_src/python_types/tutorial007_py39.py!}
```
////
@@ -248,7 +248,7 @@ Python যত এগিয়ে যাচ্ছে, **নতুন সংস্
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial007.py!}
+{!> ../../docs_src/python_types/tutorial007.py!}
```
////
@@ -269,7 +269,7 @@ Python যত এগিয়ে যাচ্ছে, **নতুন সংস্
//// tab | Python 3.9+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008_py39.py!}
+{!> ../../docs_src/python_types/tutorial008_py39.py!}
```
////
@@ -277,7 +277,7 @@ Python যত এগিয়ে যাচ্ছে, **নতুন সংস্
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008.py!}
+{!> ../../docs_src/python_types/tutorial008.py!}
```
////
@@ -299,7 +299,7 @@ Python 3.10-এ একটি **নতুন সিনট্যাক্স** আ
//// tab | Python 3.10+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008b_py310.py!}
+{!> ../../docs_src/python_types/tutorial008b_py310.py!}
```
////
@@ -307,7 +307,7 @@ Python 3.10-এ একটি **নতুন সিনট্যাক্স** আ
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008b.py!}
+{!> ../../docs_src/python_types/tutorial008b.py!}
```
////
@@ -321,7 +321,7 @@ Python 3.10-এ একটি **নতুন সিনট্যাক্স** আ
Python 3.6 এবং তার উপরের সংস্করণগুলিতে (Python 3.10 অনতর্ভুক্ত) আপনি `typing` মডিউল থেকে `Optional` ইমপোর্ট করে এটি ঘোষণা এবং ব্যবহার করতে পারেন।
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
`Optional[str]` ব্যবহার করা মানে হল শুধু `str` নয়, এটি হতে পারে `None`-ও, যা আপনার এডিটরকে সেই ত্রুটিগুলি শনাক্ত করতে সাহায্য করবে যেখানে আপনি ধরে নিচ্ছেন যে একটি মান সবসময় `str` হবে, অথচ এটি `None`-ও হতে পারেও।
@@ -333,7 +333,7 @@ Python 3.6 এবং তার উপরের সংস্করণগুলি
//// tab | Python 3.10+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial009_py310.py!}
+{!> ../../docs_src/python_types/tutorial009_py310.py!}
```
////
@@ -341,7 +341,7 @@ Python 3.6 এবং তার উপরের সংস্করণগুলি
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009.py!}
+{!> ../../docs_src/python_types/tutorial009.py!}
```
////
@@ -349,7 +349,7 @@ Python 3.6 এবং তার উপরের সংস্করণগুলি
//// tab | Python 3.8+ বিকল্প
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009b.py!}
+{!> ../../docs_src/python_types/tutorial009b.py!}
```
////
@@ -370,7 +370,7 @@ Python 3.6 এবং তার উপরের সংস্করণগুলি
একটি উদাহরণ হিসেবে, এই ফাংশনটি নিন:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009c.py!}
+{!../../docs_src/python_types/tutorial009c.py!}
```
`name` প্যারামিটারটি `Optional[str]` হিসেবে সংজ্ঞায়িত হয়েছে, কিন্তু এটি **অপশনাল নয়**, আপনি প্যারামিটার ছাড়া ফাংশনটি কল করতে পারবেন না:
@@ -388,7 +388,7 @@ say_hi(name=None) # এটি কাজ করে, None বৈধ 🎉
সুখবর হল, একবার আপনি Python 3.10 ব্যবহার করা শুরু করলে, আপনাকে এগুলোর ব্যাপারে আর চিন্তা করতে হবে না, যেহুতু আপনি | ব্যবহার করেই ইউনিয়ন ঘোষণা করতে পারবেন:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009c_py310.py!}
+{!../../docs_src/python_types/tutorial009c_py310.py!}
```
এবং তারপর আপনাকে নামগুলি যেমন `Optional` এবং `Union` নিয়ে আর চিন্তা করতে হবে না। 😎
@@ -452,13 +452,13 @@ Python 3.10-এ, `Union` এবং `Optional` জেনেরিকস ব্য
ধরুন আপনার কাছে `Person` নামে একটি ক্লাস আছে, যার একটি নাম আছে:
```Python hl_lines="1-3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
তারপর আপনি একটি ভেরিয়েবলকে `Person` টাইপের হিসেবে ঘোষণা করতে পারেন:
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
এবং তারপর, আবার, আপনি এডিটর সাপোর্ট পেয়ে যাবেন:
@@ -486,7 +486,7 @@ Python 3.10-এ, `Union` এবং `Optional` জেনেরিকস ব্য
//// tab | Python 3.10+
```Python
-{!> ../../../docs_src/python_types/tutorial011_py310.py!}
+{!> ../../docs_src/python_types/tutorial011_py310.py!}
```
////
@@ -494,7 +494,7 @@ Python 3.10-এ, `Union` এবং `Optional` জেনেরিকস ব্য
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/python_types/tutorial011_py39.py!}
+{!> ../../docs_src/python_types/tutorial011_py39.py!}
```
////
@@ -502,7 +502,7 @@ Python 3.10-এ, `Union` এবং `Optional` জেনেরিকস ব্য
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/python_types/tutorial011.py!}
+{!> ../../docs_src/python_types/tutorial011.py!}
```
////
@@ -532,7 +532,7 @@ Python-এ এমন একটি ফিচার আছে যা `Annotated`
Python 3.9-এ, `Annotated` স্ট্যান্ডার্ড লাইব্রেরিতে অন্তর্ভুক্ত, তাই আপনি এটি `typing` থেকে ইমপোর্ট করতে পারেন।
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial013_py39.py!}
+{!> ../../docs_src/python_types/tutorial013_py39.py!}
```
////
@@ -544,7 +544,7 @@ Python 3.9-এর নীচের সংস্করণগুলিতে, আ
এটি **FastAPI** এর সাথে ইতিমদ্ধে ইনস্টল হয়ে থাকবে।
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial013.py!}
+{!> ../../docs_src/python_types/tutorial013.py!}
```
////
diff --git a/docs/de/docs/advanced/additional-responses.md b/docs/de/docs/advanced/additional-responses.md
index 6f2c4b2dd..a87c56491 100644
--- a/docs/de/docs/advanced/additional-responses.md
+++ b/docs/de/docs/advanced/additional-responses.md
@@ -27,7 +27,7 @@ Jedes dieser Response-`dict`s kann einen Schlüssel `model` haben, welcher ein P
Um beispielsweise eine weitere Response mit dem Statuscode `404` und einem Pydantic-Modell `Message` zu deklarieren, können Sie schreiben:
```Python hl_lines="18 22"
-{!../../../docs_src/additional_responses/tutorial001.py!}
+{!../../docs_src/additional_responses/tutorial001.py!}
```
/// note | "Hinweis"
@@ -178,7 +178,7 @@ Sie können denselben `responses`-Parameter verwenden, um verschiedene Medientyp
Sie können beispielsweise einen zusätzlichen Medientyp `image/png` hinzufügen und damit deklarieren, dass Ihre *Pfadoperation* ein JSON-Objekt (mit dem Medientyp `application/json`) oder ein PNG-Bild zurückgeben kann:
```Python hl_lines="19-24 28"
-{!../../../docs_src/additional_responses/tutorial002.py!}
+{!../../docs_src/additional_responses/tutorial002.py!}
```
/// note | "Hinweis"
@@ -208,7 +208,7 @@ Sie können beispielsweise eine Response mit dem Statuscode `404` deklarieren, d
Und eine Response mit dem Statuscode `200`, die Ihr `response_model` verwendet, aber ein benutzerdefiniertes Beispiel (`example`) enthält:
```Python hl_lines="20-31"
-{!../../../docs_src/additional_responses/tutorial003.py!}
+{!../../docs_src/additional_responses/tutorial003.py!}
```
Es wird alles kombiniert und in Ihre OpenAPI eingebunden und in der API-Dokumentation angezeigt:
@@ -244,7 +244,7 @@ Mit dieser Technik können Sie einige vordefinierte Responses in Ihren *Pfadoper
Zum Beispiel:
```Python hl_lines="13-17 26"
-{!../../../docs_src/additional_responses/tutorial004.py!}
+{!../../docs_src/additional_responses/tutorial004.py!}
```
## Weitere Informationen zu OpenAPI-Responses
diff --git a/docs/de/docs/advanced/additional-status-codes.md b/docs/de/docs/advanced/additional-status-codes.md
index 672efee51..fc8d09e4c 100644
--- a/docs/de/docs/advanced/additional-status-codes.md
+++ b/docs/de/docs/advanced/additional-status-codes.md
@@ -17,7 +17,7 @@ Um dies zu erreichen, importieren Sie `JSONResponse`, und geben Sie Ihren Inhalt
//// tab | Python 3.10+
```Python hl_lines="4 25"
-{!> ../../../docs_src/additional_status_codes/tutorial001_an_py310.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001_an_py310.py!}
```
////
@@ -25,7 +25,7 @@ Um dies zu erreichen, importieren Sie `JSONResponse`, und geben Sie Ihren Inhalt
//// tab | Python 3.9+
```Python hl_lines="4 25"
-{!> ../../../docs_src/additional_status_codes/tutorial001_an_py39.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001_an_py39.py!}
```
////
@@ -33,7 +33,7 @@ Um dies zu erreichen, importieren Sie `JSONResponse`, und geben Sie Ihren Inhalt
//// tab | Python 3.8+
```Python hl_lines="4 26"
-{!> ../../../docs_src/additional_status_codes/tutorial001_an.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001_an.py!}
```
////
@@ -47,7 +47,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="2 23"
-{!> ../../../docs_src/additional_status_codes/tutorial001_py310.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001_py310.py!}
```
////
@@ -61,7 +61,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="4 25"
-{!> ../../../docs_src/additional_status_codes/tutorial001.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001.py!}
```
////
diff --git a/docs/de/docs/advanced/advanced-dependencies.md b/docs/de/docs/advanced/advanced-dependencies.md
index f29970872..54351714e 100644
--- a/docs/de/docs/advanced/advanced-dependencies.md
+++ b/docs/de/docs/advanced/advanced-dependencies.md
@@ -21,7 +21,7 @@ Dazu deklarieren wir eine Methode `__call__`:
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
```
////
@@ -29,7 +29,7 @@ Dazu deklarieren wir eine Methode `__call__`:
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial011_an.py!}
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
```
////
@@ -43,7 +43,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial011.py!}
+{!> ../../docs_src/dependencies/tutorial011.py!}
```
////
@@ -57,7 +57,7 @@ Und jetzt können wir `__init__` verwenden, um die Parameter der Instanz zu dekl
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
```
////
@@ -65,7 +65,7 @@ Und jetzt können wir `__init__` verwenden, um die Parameter der Instanz zu dekl
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/dependencies/tutorial011_an.py!}
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
```
////
@@ -79,7 +79,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/dependencies/tutorial011.py!}
+{!> ../../docs_src/dependencies/tutorial011.py!}
```
////
@@ -93,7 +93,7 @@ Wir könnten eine Instanz dieser Klasse erstellen mit:
//// tab | Python 3.9+
```Python hl_lines="18"
-{!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
```
////
@@ -101,7 +101,7 @@ Wir könnten eine Instanz dieser Klasse erstellen mit:
//// tab | Python 3.8+
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial011_an.py!}
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
```
////
@@ -115,7 +115,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial011.py!}
+{!> ../../docs_src/dependencies/tutorial011.py!}
```
////
@@ -137,7 +137,7 @@ checker(q="somequery")
//// tab | Python 3.9+
```Python hl_lines="22"
-{!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
```
////
@@ -145,7 +145,7 @@ checker(q="somequery")
//// tab | Python 3.8+
```Python hl_lines="21"
-{!> ../../../docs_src/dependencies/tutorial011_an.py!}
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
```
////
@@ -159,7 +159,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial011.py!}
+{!> ../../docs_src/dependencies/tutorial011.py!}
```
////
diff --git a/docs/de/docs/advanced/async-tests.md b/docs/de/docs/advanced/async-tests.md
index e56841faa..93ff84b8a 100644
--- a/docs/de/docs/advanced/async-tests.md
+++ b/docs/de/docs/advanced/async-tests.md
@@ -33,13 +33,13 @@ Betrachten wir als einfaches Beispiel eine Dateistruktur ähnlich der in [Größ
Die Datei `main.py` hätte als Inhalt:
```Python
-{!../../../docs_src/async_tests/main.py!}
+{!../../docs_src/async_tests/main.py!}
```
Die Datei `test_main.py` hätte die Tests für `main.py`, das könnte jetzt so aussehen:
```Python
-{!../../../docs_src/async_tests/test_main.py!}
+{!../../docs_src/async_tests/test_main.py!}
```
## Es ausführen
@@ -61,7 +61,7 @@ $ pytest
Der Marker `@pytest.mark.anyio` teilt pytest mit, dass diese Testfunktion asynchron aufgerufen werden soll:
```Python hl_lines="7"
-{!../../../docs_src/async_tests/test_main.py!}
+{!../../docs_src/async_tests/test_main.py!}
```
/// tip | "Tipp"
@@ -73,7 +73,7 @@ Beachten Sie, dass die Testfunktion jetzt `async def` ist und nicht nur `def` wi
Dann können wir einen `AsyncClient` mit der App erstellen und mit `await` asynchrone Requests an ihn senden.
```Python hl_lines="9-12"
-{!../../../docs_src/async_tests/test_main.py!}
+{!../../docs_src/async_tests/test_main.py!}
```
Das ist das Äquivalent zu:
diff --git a/docs/de/docs/advanced/behind-a-proxy.md b/docs/de/docs/advanced/behind-a-proxy.md
index 18f90ebde..74b25308a 100644
--- a/docs/de/docs/advanced/behind-a-proxy.md
+++ b/docs/de/docs/advanced/behind-a-proxy.md
@@ -19,7 +19,7 @@ In diesem Fall würde der ursprüngliche Pfad `/app` tatsächlich unter `/api/v1
Auch wenn Ihr gesamter Code unter der Annahme geschrieben ist, dass es nur `/app` gibt.
```Python hl_lines="6"
-{!../../../docs_src/behind_a_proxy/tutorial001.py!}
+{!../../docs_src/behind_a_proxy/tutorial001.py!}
```
Und der Proxy würde das **Pfadpräfix** on-the-fly **"entfernen**", bevor er die Anfrage an Uvicorn übermittelt, dafür sorgend, dass Ihre Anwendung davon überzeugt ist, dass sie unter `/app` bereitgestellt wird, sodass Sie nicht Ihren gesamten Code dahingehend aktualisieren müssen, das Präfix `/api/v1` zu verwenden.
@@ -99,7 +99,7 @@ Sie können den aktuellen `root_path` abrufen, der von Ihrer Anwendung für jede
Hier fügen wir ihn, nur zu Demonstrationszwecken, in die Nachricht ein.
```Python hl_lines="8"
-{!../../../docs_src/behind_a_proxy/tutorial001.py!}
+{!../../docs_src/behind_a_proxy/tutorial001.py!}
```
Wenn Sie Uvicorn dann starten mit:
@@ -128,7 +128,7 @@ wäre die Response etwa:
Falls Sie keine Möglichkeit haben, eine Kommandozeilenoption wie `--root-path` oder ähnlich zu übergeben, können Sie als Alternative beim Erstellen Ihrer FastAPI-Anwendung den Parameter `root_path` setzen:
```Python hl_lines="3"
-{!../../../docs_src/behind_a_proxy/tutorial002.py!}
+{!../../docs_src/behind_a_proxy/tutorial002.py!}
```
Die Übergabe des `root_path` an `FastAPI` wäre das Äquivalent zur Übergabe der `--root-path`-Kommandozeilenoption an Uvicorn oder Hypercorn.
@@ -310,7 +310,7 @@ Wenn Sie eine benutzerdefinierte Liste von Servern (`servers`) übergeben und es
Zum Beispiel:
```Python hl_lines="4-7"
-{!../../../docs_src/behind_a_proxy/tutorial003.py!}
+{!../../docs_src/behind_a_proxy/tutorial003.py!}
```
Erzeugt ein OpenAPI-Schema, wie:
@@ -359,7 +359,7 @@ Die Dokumentationsoberfläche interagiert mit dem von Ihnen ausgewählten Server
Wenn Sie nicht möchten, dass **FastAPI** einen automatischen Server inkludiert, welcher `root_path` verwendet, können Sie den Parameter `root_path_in_servers=False` verwenden:
```Python hl_lines="9"
-{!../../../docs_src/behind_a_proxy/tutorial004.py!}
+{!../../docs_src/behind_a_proxy/tutorial004.py!}
```
Dann wird er nicht in das OpenAPI-Schema aufgenommen.
diff --git a/docs/de/docs/advanced/custom-response.md b/docs/de/docs/advanced/custom-response.md
index 20d6a039a..357d2c562 100644
--- a/docs/de/docs/advanced/custom-response.md
+++ b/docs/de/docs/advanced/custom-response.md
@@ -31,7 +31,7 @@ Das liegt daran, dass FastAPI standardmäßig jedes enthaltene Element überprü
Wenn Sie jedoch sicher sind, dass der von Ihnen zurückgegebene Inhalt **mit JSON serialisierbar** ist, können Sie ihn direkt an die Response-Klasse übergeben und die zusätzliche Arbeit vermeiden, die FastAPI hätte, indem es Ihren zurückgegebenen Inhalt durch den `jsonable_encoder` leitet, bevor es ihn an die Response-Klasse übergibt.
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial001b.py!}
+{!../../docs_src/custom_response/tutorial001b.py!}
```
/// info
@@ -58,7 +58,7 @@ Um eine Response mit HTML direkt von **FastAPI** zurückzugeben, verwenden Sie `
* Übergeben Sie `HTMLResponse` als den Parameter `response_class` Ihres *Pfadoperation-Dekorators*.
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial002.py!}
+{!../../docs_src/custom_response/tutorial002.py!}
```
/// info
@@ -78,7 +78,7 @@ Wie in [Eine Response direkt zurückgeben](response-directly.md){.internal-link
Das gleiche Beispiel von oben, das eine `HTMLResponse` zurückgibt, könnte so aussehen:
```Python hl_lines="2 7 19"
-{!../../../docs_src/custom_response/tutorial003.py!}
+{!../../docs_src/custom_response/tutorial003.py!}
```
/// warning | "Achtung"
@@ -104,7 +104,7 @@ Die `response_class` wird dann nur zur Dokumentation der OpenAPI-Pfadoperation*
Es könnte zum Beispiel so etwas sein:
```Python hl_lines="7 21 23"
-{!../../../docs_src/custom_response/tutorial004.py!}
+{!../../docs_src/custom_response/tutorial004.py!}
```
In diesem Beispiel generiert die Funktion `generate_html_response()` bereits eine `Response` und gibt sie zurück, anstatt das HTML in einem `str` zurückzugeben.
@@ -145,7 +145,7 @@ Sie akzeptiert die folgenden Parameter:
FastAPI (eigentlich Starlette) fügt automatisch einen Content-Length-Header ein. Außerdem wird es einen Content-Type-Header einfügen, der auf dem media_type basiert, und für Texttypen einen Zeichensatz (charset) anfügen.
```Python hl_lines="1 18"
-{!../../../docs_src/response_directly/tutorial002.py!}
+{!../../docs_src/response_directly/tutorial002.py!}
```
### `HTMLResponse`
@@ -157,7 +157,7 @@ Nimmt Text oder Bytes entgegen und gibt eine HTML-Response zurück, wie Sie oben
Nimmt Text oder Bytes entgegen und gibt eine Plain-Text-Response zurück.
```Python hl_lines="2 7 9"
-{!../../../docs_src/custom_response/tutorial005.py!}
+{!../../docs_src/custom_response/tutorial005.py!}
```
### `JSONResponse`
@@ -181,7 +181,7 @@ Eine alternative JSON-Response mit <a href="https://github.com/ultrajson/ultrajs
///
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial001.py!}
+{!../../docs_src/custom_response/tutorial001.py!}
```
/// tip | "Tipp"
@@ -197,7 +197,7 @@ Gibt eine HTTP-Weiterleitung (HTTP-Redirect) zurück. Verwendet standardmäßig
Sie können eine `RedirectResponse` direkt zurückgeben:
```Python hl_lines="2 9"
-{!../../../docs_src/custom_response/tutorial006.py!}
+{!../../docs_src/custom_response/tutorial006.py!}
```
---
@@ -206,7 +206,7 @@ Oder Sie können sie im Parameter `response_class` verwenden:
```Python hl_lines="2 7 9"
-{!../../../docs_src/custom_response/tutorial006b.py!}
+{!../../docs_src/custom_response/tutorial006b.py!}
```
Wenn Sie das tun, können Sie die URL direkt von Ihrer *Pfadoperation*-Funktion zurückgeben.
@@ -218,7 +218,7 @@ In diesem Fall ist der verwendete `status_code` der Standardcode für die `Redir
Sie können den Parameter `status_code` auch in Kombination mit dem Parameter `response_class` verwenden:
```Python hl_lines="2 7 9"
-{!../../../docs_src/custom_response/tutorial006c.py!}
+{!../../docs_src/custom_response/tutorial006c.py!}
```
### `StreamingResponse`
@@ -226,7 +226,7 @@ Sie können den Parameter `status_code` auch in Kombination mit dem Parameter `r
Nimmt einen asynchronen Generator oder einen normalen Generator/Iterator und streamt den Responsebody.
```Python hl_lines="2 14"
-{!../../../docs_src/custom_response/tutorial007.py!}
+{!../../docs_src/custom_response/tutorial007.py!}
```
#### Verwendung von `StreamingResponse` mit dateiähnlichen Objekten
@@ -238,7 +238,7 @@ Auf diese Weise müssen Sie nicht alles zuerst in den Arbeitsspeicher lesen und
Das umfasst viele Bibliotheken zur Interaktion mit Cloud-Speicher, Videoverarbeitung und anderen.
```{ .python .annotate hl_lines="2 10-12 14" }
-{!../../../docs_src/custom_response/tutorial008.py!}
+{!../../docs_src/custom_response/tutorial008.py!}
```
1. Das ist die Generatorfunktion. Es handelt sich um eine „Generatorfunktion“, da sie `yield`-Anweisungen enthält.
@@ -269,13 +269,13 @@ Nimmt zur Instanziierung einen anderen Satz von Argumenten entgegen als die ande
Datei-Responses enthalten die entsprechenden `Content-Length`-, `Last-Modified`- und `ETag`-Header.
```Python hl_lines="2 10"
-{!../../../docs_src/custom_response/tutorial009.py!}
+{!../../docs_src/custom_response/tutorial009.py!}
```
Sie können auch den Parameter `response_class` verwenden:
```Python hl_lines="2 8 10"
-{!../../../docs_src/custom_response/tutorial009b.py!}
+{!../../docs_src/custom_response/tutorial009b.py!}
```
In diesem Fall können Sie den Dateipfad direkt von Ihrer *Pfadoperation*-Funktion zurückgeben.
@@ -291,7 +291,7 @@ Sie möchten etwa, dass Ihre Response eingerücktes und formatiertes JSON zurüc
Sie könnten eine `CustomORJSONResponse` erstellen. Das Wichtigste, was Sie tun müssen, ist, eine `Response.render(content)`-Methode zu erstellen, die den Inhalt als `bytes` zurückgibt:
```Python hl_lines="9-14 17"
-{!../../../docs_src/custom_response/tutorial009c.py!}
+{!../../docs_src/custom_response/tutorial009c.py!}
```
Statt:
@@ -319,7 +319,7 @@ Der Parameter, der das definiert, ist `default_response_class`.
Im folgenden Beispiel verwendet **FastAPI** standardmäßig `ORJSONResponse` in allen *Pfadoperationen*, anstelle von `JSONResponse`.
```Python hl_lines="2 4"
-{!../../../docs_src/custom_response/tutorial010.py!}
+{!../../docs_src/custom_response/tutorial010.py!}
```
/// tip | "Tipp"
diff --git a/docs/de/docs/advanced/dataclasses.md b/docs/de/docs/advanced/dataclasses.md
index d5a663485..573f500e8 100644
--- a/docs/de/docs/advanced/dataclasses.md
+++ b/docs/de/docs/advanced/dataclasses.md
@@ -5,7 +5,7 @@ FastAPI basiert auf **Pydantic** und ich habe Ihnen gezeigt, wie Sie Pydantic-Mo
Aber FastAPI unterstützt auf die gleiche Weise auch die Verwendung von <a href="https://docs.python.org/3/library/dataclasses.html" class="external-link" target="_blank">`dataclasses`</a>:
```Python hl_lines="1 7-12 19-20"
-{!../../../docs_src/dataclasses/tutorial001.py!}
+{!../../docs_src/dataclasses/tutorial001.py!}
```
Das ist dank **Pydantic** ebenfalls möglich, da es <a href="https://pydantic-docs.helpmanual.io/usage/dataclasses/#use-of-stdlib-dataclasses-with-basemodel" class="external-link" target="_blank">`dataclasses` intern unterstützt</a>.
@@ -35,7 +35,7 @@ Wenn Sie jedoch eine Menge Datenklassen herumliegen haben, ist dies ein guter Tr
Sie können `dataclasses` auch im Parameter `response_model` verwenden:
```Python hl_lines="1 7-13 19"
-{!../../../docs_src/dataclasses/tutorial002.py!}
+{!../../docs_src/dataclasses/tutorial002.py!}
```
Die Datenklasse wird automatisch in eine Pydantic-Datenklasse konvertiert.
@@ -53,7 +53,7 @@ In einigen Fällen müssen Sie möglicherweise immer noch Pydantics Version von
In diesem Fall können Sie einfach die Standard-`dataclasses` durch `pydantic.dataclasses` ersetzen, was einen direkten Ersatz darstellt:
```{ .python .annotate hl_lines="1 5 8-11 14-17 23-25 28" }
-{!../../../docs_src/dataclasses/tutorial003.py!}
+{!../../docs_src/dataclasses/tutorial003.py!}
```
1. Wir importieren `field` weiterhin von Standard-`dataclasses`.
diff --git a/docs/de/docs/advanced/events.md b/docs/de/docs/advanced/events.md
index e898db49b..b0c4d3922 100644
--- a/docs/de/docs/advanced/events.md
+++ b/docs/de/docs/advanced/events.md
@@ -31,7 +31,7 @@ Beginnen wir mit einem Beispiel und sehen es uns dann im Detail an.
Wir erstellen eine asynchrone Funktion `lifespan()` mit `yield` wie folgt:
```Python hl_lines="16 19"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
Hier simulieren wir das langsame *Hochfahren*, das Laden des Modells, indem wir die (Fake-)Modellfunktion vor dem `yield` in das Dictionary mit Modellen für maschinelles Lernen einfügen. Dieser Code wird ausgeführt, **bevor** die Anwendung **beginnt, Requests entgegenzunehmen**, während des *Hochfahrens*.
@@ -51,7 +51,7 @@ Möglicherweise müssen Sie eine neue Version starten, oder Sie haben es einfach
Das Erste, was auffällt, ist, dass wir eine asynchrone Funktion mit `yield` definieren. Das ist sehr ähnlich zu Abhängigkeiten mit `yield`.
```Python hl_lines="14-19"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
Der erste Teil der Funktion, vor dem `yield`, wird ausgeführt **bevor** die Anwendung startet.
@@ -65,7 +65,7 @@ Wie Sie sehen, ist die Funktion mit einem `@asynccontextmanager` versehen.
Dadurch wird die Funktion in einen sogenannten „**asynchronen Kontextmanager**“ umgewandelt.
```Python hl_lines="1 13"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
Ein **Kontextmanager** in Python ist etwas, das Sie in einer `with`-Anweisung verwenden können, zum Beispiel kann `open()` als Kontextmanager verwendet werden:
@@ -89,7 +89,7 @@ In unserem obigen Codebeispiel verwenden wir ihn nicht direkt, sondern übergebe
Der Parameter `lifespan` der `FastAPI`-App benötigt einen **asynchronen Kontextmanager**, wir können ihm also unseren neuen asynchronen Kontextmanager `lifespan` übergeben.
```Python hl_lines="22"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
## Alternative Events (deprecated)
@@ -113,7 +113,7 @@ Diese Funktionen können mit `async def` oder normalem `def` deklariert werden.
Um eine Funktion hinzuzufügen, die vor dem Start der Anwendung ausgeführt werden soll, deklarieren Sie diese mit dem Event `startup`:
```Python hl_lines="8"
-{!../../../docs_src/events/tutorial001.py!}
+{!../../docs_src/events/tutorial001.py!}
```
In diesem Fall initialisiert die Eventhandler-Funktion `startup` die „Datenbank“ der Items (nur ein `dict`) mit einigen Werten.
@@ -127,7 +127,7 @@ Und Ihre Anwendung empfängt erst dann Anfragen, wenn alle `startup`-Eventhandle
Um eine Funktion hinzuzufügen, die beim Herunterfahren der Anwendung ausgeführt werden soll, deklarieren Sie sie mit dem Event `shutdown`:
```Python hl_lines="6"
-{!../../../docs_src/events/tutorial002.py!}
+{!../../docs_src/events/tutorial002.py!}
```
Hier schreibt die `shutdown`-Eventhandler-Funktion eine Textzeile `"Application shutdown"` in eine Datei `log.txt`.
diff --git a/docs/de/docs/advanced/generate-clients.md b/docs/de/docs/advanced/generate-clients.md
index b8d66fdd7..80c44b3f9 100644
--- a/docs/de/docs/advanced/generate-clients.md
+++ b/docs/de/docs/advanced/generate-clients.md
@@ -31,7 +31,7 @@ Beginnen wir mit einer einfachen FastAPI-Anwendung:
//// tab | Python 3.9+
```Python hl_lines="7-9 12-13 16-17 21"
-{!> ../../../docs_src/generate_clients/tutorial001_py39.py!}
+{!> ../../docs_src/generate_clients/tutorial001_py39.py!}
```
////
@@ -39,7 +39,7 @@ Beginnen wir mit einer einfachen FastAPI-Anwendung:
//// tab | Python 3.8+
```Python hl_lines="9-11 14-15 18 19 23"
-{!> ../../../docs_src/generate_clients/tutorial001.py!}
+{!> ../../docs_src/generate_clients/tutorial001.py!}
```
////
@@ -150,7 +150,7 @@ Beispielsweise könnten Sie einen Abschnitt für **Items (Artikel)** und einen w
//// tab | Python 3.9+
```Python hl_lines="21 26 34"
-{!> ../../../docs_src/generate_clients/tutorial002_py39.py!}
+{!> ../../docs_src/generate_clients/tutorial002_py39.py!}
```
////
@@ -158,7 +158,7 @@ Beispielsweise könnten Sie einen Abschnitt für **Items (Artikel)** und einen w
//// tab | Python 3.8+
```Python hl_lines="23 28 36"
-{!> ../../../docs_src/generate_clients/tutorial002.py!}
+{!> ../../docs_src/generate_clients/tutorial002.py!}
```
////
@@ -211,7 +211,7 @@ Anschließend können Sie diese benutzerdefinierte Funktion als Parameter `gener
//// tab | Python 3.9+
```Python hl_lines="6-7 10"
-{!> ../../../docs_src/generate_clients/tutorial003_py39.py!}
+{!> ../../docs_src/generate_clients/tutorial003_py39.py!}
```
////
@@ -219,7 +219,7 @@ Anschließend können Sie diese benutzerdefinierte Funktion als Parameter `gener
//// tab | Python 3.8+
```Python hl_lines="8-9 12"
-{!> ../../../docs_src/generate_clients/tutorial003.py!}
+{!> ../../docs_src/generate_clients/tutorial003.py!}
```
////
@@ -247,7 +247,7 @@ Wir könnten das OpenAPI-JSON in eine Datei `openapi.json` herunterladen und dan
//// tab | Python
```Python
-{!> ../../../docs_src/generate_clients/tutorial004.py!}
+{!> ../../docs_src/generate_clients/tutorial004.py!}
```
////
@@ -255,7 +255,7 @@ Wir könnten das OpenAPI-JSON in eine Datei `openapi.json` herunterladen und dan
//// tab | Node.js
```Javascript
-{!> ../../../docs_src/generate_clients/tutorial004.js!}
+{!> ../../docs_src/generate_clients/tutorial004.js!}
```
////
diff --git a/docs/de/docs/advanced/middleware.md b/docs/de/docs/advanced/middleware.md
index 8912225fb..b4001efda 100644
--- a/docs/de/docs/advanced/middleware.md
+++ b/docs/de/docs/advanced/middleware.md
@@ -58,7 +58,7 @@ Erzwingt, dass alle eingehenden Requests entweder `https` oder `wss` sein müsse
Alle eingehenden Requests an `http` oder `ws` werden stattdessen an das sichere Schema umgeleitet.
```Python hl_lines="2 6"
-{!../../../docs_src/advanced_middleware/tutorial001.py!}
+{!../../docs_src/advanced_middleware/tutorial001.py!}
```
## `TrustedHostMiddleware`
@@ -66,7 +66,7 @@ Alle eingehenden Requests an `http` oder `ws` werden stattdessen an das sichere
Erzwingt, dass alle eingehenden Requests einen korrekt gesetzten `Host`-Header haben, um sich vor HTTP-Host-Header-Angriffen zu schützen.
```Python hl_lines="2 6-8"
-{!../../../docs_src/advanced_middleware/tutorial002.py!}
+{!../../docs_src/advanced_middleware/tutorial002.py!}
```
Die folgenden Argumente werden unterstützt:
@@ -82,7 +82,7 @@ Verarbeitet GZip-Responses für alle Requests, die `"gzip"` im `Accept-Encoding`
Diese Middleware verarbeitet sowohl Standard- als auch Streaming-Responses.
```Python hl_lines="2 6"
-{!../../../docs_src/advanced_middleware/tutorial003.py!}
+{!../../docs_src/advanced_middleware/tutorial003.py!}
```
Die folgenden Argumente werden unterstützt:
diff --git a/docs/de/docs/advanced/openapi-callbacks.md b/docs/de/docs/advanced/openapi-callbacks.md
index d7b5bc885..f407d5450 100644
--- a/docs/de/docs/advanced/openapi-callbacks.md
+++ b/docs/de/docs/advanced/openapi-callbacks.md
@@ -32,7 +32,7 @@ Sie verfügt über eine *Pfadoperation*, die einen `Invoice`-Body empfängt, und
Dieser Teil ist ziemlich normal, der größte Teil des Codes ist Ihnen wahrscheinlich bereits bekannt:
```Python hl_lines="9-13 36-53"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
/// tip | "Tipp"
@@ -93,7 +93,7 @@ Wenn Sie diese Sichtweise (des *externen Entwicklers*) vorübergehend übernehme
Erstellen Sie zunächst einen neuen `APIRouter`, der einen oder mehrere Callbacks enthält.
```Python hl_lines="3 25"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
### Die Callback-*Pfadoperation* erstellen
@@ -106,7 +106,7 @@ Sie sollte wie eine normale FastAPI-*Pfadoperation* aussehen:
* Und sie könnte auch eine Deklaration der Response enthalten, die zurückgegeben werden soll, z. B. `response_model=InvoiceEventReceived`.
```Python hl_lines="16-18 21-22 28-32"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
Es gibt zwei Hauptunterschiede zu einer normalen *Pfadoperation*:
@@ -176,7 +176,7 @@ An diesem Punkt haben Sie die benötigte(n) *Callback-Pfadoperation(en)* (diejen
Verwenden Sie nun den Parameter `callbacks` im *Pfadoperation-Dekorator Ihrer API*, um das Attribut `.routes` (das ist eigentlich nur eine `list`e von Routen/*Pfadoperationen*) dieses Callback-Routers zu übergeben:
```Python hl_lines="35"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
/// tip | "Tipp"
diff --git a/docs/de/docs/advanced/openapi-webhooks.md b/docs/de/docs/advanced/openapi-webhooks.md
index fb0daa908..9f1bb6959 100644
--- a/docs/de/docs/advanced/openapi-webhooks.md
+++ b/docs/de/docs/advanced/openapi-webhooks.md
@@ -33,7 +33,7 @@ Webhooks sind in OpenAPI 3.1.0 und höher verfügbar und werden von FastAPI `0.9
Wenn Sie eine **FastAPI**-Anwendung erstellen, gibt es ein `webhooks`-Attribut, mit dem Sie *Webhooks* definieren können, genauso wie Sie *Pfadoperationen* definieren würden, zum Beispiel mit `@app.webhooks.post()`.
```Python hl_lines="9-13 36-53"
-{!../../../docs_src/openapi_webhooks/tutorial001.py!}
+{!../../docs_src/openapi_webhooks/tutorial001.py!}
```
Die von Ihnen definierten Webhooks landen im **OpenAPI**-Schema und der automatischen **Dokumentations-Oberfläche**.
diff --git a/docs/de/docs/advanced/path-operation-advanced-configuration.md b/docs/de/docs/advanced/path-operation-advanced-configuration.md
index c9cb82fe3..2d8b88be5 100644
--- a/docs/de/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/de/docs/advanced/path-operation-advanced-configuration.md
@@ -13,7 +13,7 @@ Mit dem Parameter `operation_id` können Sie die OpenAPI `operationId` festlegen
Sie müssten sicherstellen, dass sie für jede Operation eindeutig ist.
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
```
### Verwendung des Namens der *Pfadoperation-Funktion* als operationId
@@ -23,7 +23,7 @@ Wenn Sie die Funktionsnamen Ihrer API als `operationId`s verwenden möchten, kö
Sie sollten dies tun, nachdem Sie alle Ihre *Pfadoperationen* hinzugefügt haben.
```Python hl_lines="2 12-21 24"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
```
/// tip | "Tipp"
@@ -45,7 +45,7 @@ Auch wenn diese sich in unterschiedlichen Modulen (Python-Dateien) befinden.
Um eine *Pfadoperation* aus dem generierten OpenAPI-Schema (und damit aus den automatischen Dokumentationssystemen) auszuschließen, verwenden Sie den Parameter `include_in_schema` und setzen Sie ihn auf `False`:
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
```
## Fortgeschrittene Beschreibung mittels Docstring
@@ -57,7 +57,7 @@ Das Hinzufügen eines `\f` (ein maskiertes „Form Feed“-Zeichen) führt dazu,
Sie wird nicht in der Dokumentation angezeigt, aber andere Tools (z. B. Sphinx) können den Rest verwenden.
```Python hl_lines="19-29"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
```
## Zusätzliche Responses
@@ -101,7 +101,7 @@ Sie können das OpenAPI-Schema für eine *Pfadoperation* erweitern, indem Sie de
Dieses `openapi_extra` kann beispielsweise hilfreich sein, um <a href="https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#specificationExtensions" class="external-link" target="_blank">OpenAPI-Erweiterungen</a> zu deklarieren:
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial005.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial005.py!}
```
Wenn Sie die automatische API-Dokumentation öffnen, wird Ihre Erweiterung am Ende der spezifischen *Pfadoperation* angezeigt.
@@ -150,7 +150,7 @@ Sie könnten sich beispielsweise dafür entscheiden, den Request mit Ihrem eigen
Das könnte man mit `openapi_extra` machen:
```Python hl_lines="20-37 39-40"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial006.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial006.py!}
```
In diesem Beispiel haben wir kein Pydantic-Modell deklariert. Tatsächlich wird der Requestbody nicht einmal als JSON <abbr title="von einem einfachen Format, wie Bytes, in Python-Objekte konvertieren">geparst</abbr>, sondern direkt als `bytes` gelesen und die Funktion `magic_data_reader ()` wäre dafür verantwortlich, ihn in irgendeiner Weise zu parsen.
@@ -168,7 +168,7 @@ In der folgenden Anwendung verwenden wir beispielsweise weder die integrierte Fu
//// tab | Pydantic v2
```Python hl_lines="17-22 24"
-{!> ../../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
+{!> ../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
```
////
@@ -176,7 +176,7 @@ In der folgenden Anwendung verwenden wir beispielsweise weder die integrierte Fu
//// tab | Pydantic v1
```Python hl_lines="17-22 24"
-{!> ../../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py!}
+{!> ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py!}
```
////
@@ -196,7 +196,7 @@ Und dann parsen wir in unserem Code diesen YAML-Inhalt direkt und verwenden dann
//// tab | Pydantic v2
```Python hl_lines="26-33"
-{!> ../../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
+{!> ../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
```
////
@@ -204,7 +204,7 @@ Und dann parsen wir in unserem Code diesen YAML-Inhalt direkt und verwenden dann
//// tab | Pydantic v1
```Python hl_lines="26-33"
-{!> ../../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py!}
+{!> ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py!}
```
////
diff --git a/docs/de/docs/advanced/response-change-status-code.md b/docs/de/docs/advanced/response-change-status-code.md
index bba908a3e..202df0d87 100644
--- a/docs/de/docs/advanced/response-change-status-code.md
+++ b/docs/de/docs/advanced/response-change-status-code.md
@@ -21,7 +21,7 @@ Sie können einen Parameter vom Typ `Response` in Ihrer *Pfadoperation-Funktion*
Anschließend können Sie den `status_code` in diesem *vorübergehenden* Response-Objekt festlegen.
```Python hl_lines="1 9 12"
-{!../../../docs_src/response_change_status_code/tutorial001.py!}
+{!../../docs_src/response_change_status_code/tutorial001.py!}
```
Und dann können Sie wie gewohnt jedes benötigte Objekt zurückgeben (ein `dict`, ein Datenbankmodell usw.).
diff --git a/docs/de/docs/advanced/response-cookies.md b/docs/de/docs/advanced/response-cookies.md
index 3d2043565..ba100870d 100644
--- a/docs/de/docs/advanced/response-cookies.md
+++ b/docs/de/docs/advanced/response-cookies.md
@@ -7,7 +7,7 @@ Sie können einen Parameter vom Typ `Response` in Ihrer *Pfadoperation-Funktion*
Und dann können Sie Cookies in diesem *vorübergehenden* Response-Objekt setzen.
```Python hl_lines="1 8-9"
-{!../../../docs_src/response_cookies/tutorial002.py!}
+{!../../docs_src/response_cookies/tutorial002.py!}
```
Anschließend können Sie wie gewohnt jedes gewünschte Objekt zurückgeben (ein `dict`, ein Datenbankmodell, usw.).
@@ -27,7 +27,7 @@ Dazu können Sie eine Response erstellen, wie unter [Eine Response direkt zurüc
Setzen Sie dann Cookies darin und geben Sie sie dann zurück:
```Python hl_lines="10-12"
-{!../../../docs_src/response_cookies/tutorial001.py!}
+{!../../docs_src/response_cookies/tutorial001.py!}
```
/// tip | "Tipp"
diff --git a/docs/de/docs/advanced/response-directly.md b/docs/de/docs/advanced/response-directly.md
index 377490b56..70c045f57 100644
--- a/docs/de/docs/advanced/response-directly.md
+++ b/docs/de/docs/advanced/response-directly.md
@@ -35,7 +35,7 @@ Sie können beispielsweise kein Pydantic-Modell in eine `JSONResponse` einfügen
In diesen Fällen können Sie den `jsonable_encoder` verwenden, um Ihre Daten zu konvertieren, bevor Sie sie an eine Response übergeben:
```Python hl_lines="6-7 21-22"
-{!../../../docs_src/response_directly/tutorial001.py!}
+{!../../docs_src/response_directly/tutorial001.py!}
```
/// note | "Technische Details"
@@ -57,7 +57,7 @@ Nehmen wir an, Sie möchten eine <a href="https://en.wikipedia.org/wiki/XML" cla
Sie könnten Ihren XML-Inhalt als String in eine `Response` einfügen und sie zurückgeben:
```Python hl_lines="1 18"
-{!../../../docs_src/response_directly/tutorial002.py!}
+{!../../docs_src/response_directly/tutorial002.py!}
```
## Anmerkungen
diff --git a/docs/de/docs/advanced/response-headers.md b/docs/de/docs/advanced/response-headers.md
index 51a364f56..31c2c9c98 100644
--- a/docs/de/docs/advanced/response-headers.md
+++ b/docs/de/docs/advanced/response-headers.md
@@ -7,7 +7,7 @@ Sie können einen Parameter vom Typ `Response` in Ihrer *Pfadoperation-Funktion*
Und dann können Sie Header in diesem *vorübergehenden* Response-Objekt festlegen.
```Python hl_lines="1 7-8"
-{!../../../docs_src/response_headers/tutorial002.py!}
+{!../../docs_src/response_headers/tutorial002.py!}
```
Anschließend können Sie wie gewohnt jedes gewünschte Objekt zurückgeben (ein `dict`, ein Datenbankmodell, usw.).
@@ -25,7 +25,7 @@ Sie können auch Header hinzufügen, wenn Sie eine `Response` direkt zurückgebe
Erstellen Sie eine Response wie in [Eine Response direkt zurückgeben](response-directly.md){.internal-link target=_blank} beschrieben und übergeben Sie die Header als zusätzlichen Parameter:
```Python hl_lines="10-12"
-{!../../../docs_src/response_headers/tutorial001.py!}
+{!../../docs_src/response_headers/tutorial001.py!}
```
/// note | "Technische Details"
diff --git a/docs/de/docs/advanced/security/http-basic-auth.md b/docs/de/docs/advanced/security/http-basic-auth.md
index 3e7aeb8a0..4e607e6a1 100644
--- a/docs/de/docs/advanced/security/http-basic-auth.md
+++ b/docs/de/docs/advanced/security/http-basic-auth.md
@@ -23,7 +23,7 @@ Wenn Sie dann den Benutzernamen und das Passwort eingeben, sendet der Browser di
//// tab | Python 3.9+
```Python hl_lines="4 8 12"
-{!> ../../../docs_src/security/tutorial006_an_py39.py!}
+{!> ../../docs_src/security/tutorial006_an_py39.py!}
```
////
@@ -31,7 +31,7 @@ Wenn Sie dann den Benutzernamen und das Passwort eingeben, sendet der Browser di
//// tab | Python 3.8+
```Python hl_lines="2 7 11"
-{!> ../../../docs_src/security/tutorial006_an.py!}
+{!> ../../docs_src/security/tutorial006_an.py!}
```
////
@@ -45,7 +45,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="2 6 10"
-{!> ../../../docs_src/security/tutorial006.py!}
+{!> ../../docs_src/security/tutorial006.py!}
```
////
@@ -71,7 +71,7 @@ Dann können wir `secrets.compare_digest()` verwenden, um sicherzustellen, dass
//// tab | Python 3.9+
```Python hl_lines="1 12-24"
-{!> ../../../docs_src/security/tutorial007_an_py39.py!}
+{!> ../../docs_src/security/tutorial007_an_py39.py!}
```
////
@@ -79,7 +79,7 @@ Dann können wir `secrets.compare_digest()` verwenden, um sicherzustellen, dass
//// tab | Python 3.8+
```Python hl_lines="1 12-24"
-{!> ../../../docs_src/security/tutorial007_an.py!}
+{!> ../../docs_src/security/tutorial007_an.py!}
```
////
@@ -93,7 +93,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="1 11-21"
-{!> ../../../docs_src/security/tutorial007.py!}
+{!> ../../docs_src/security/tutorial007.py!}
```
////
@@ -163,7 +163,7 @@ Nachdem Sie festgestellt haben, dass die Anmeldeinformationen falsch sind, geben
//// tab | Python 3.9+
```Python hl_lines="26-30"
-{!> ../../../docs_src/security/tutorial007_an_py39.py!}
+{!> ../../docs_src/security/tutorial007_an_py39.py!}
```
////
@@ -171,7 +171,7 @@ Nachdem Sie festgestellt haben, dass die Anmeldeinformationen falsch sind, geben
//// tab | Python 3.8+
```Python hl_lines="26-30"
-{!> ../../../docs_src/security/tutorial007_an.py!}
+{!> ../../docs_src/security/tutorial007_an.py!}
```
////
@@ -185,7 +185,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="23-27"
-{!> ../../../docs_src/security/tutorial007.py!}
+{!> ../../docs_src/security/tutorial007.py!}
```
////
diff --git a/docs/de/docs/advanced/security/oauth2-scopes.md b/docs/de/docs/advanced/security/oauth2-scopes.md
index f02707698..c0af2560a 100644
--- a/docs/de/docs/advanced/security/oauth2-scopes.md
+++ b/docs/de/docs/advanced/security/oauth2-scopes.md
@@ -65,7 +65,7 @@ Sehen wir uns zunächst kurz die Teile an, die sich gegenüber den Beispielen im
//// tab | Python 3.10+
```Python hl_lines="4 8 12 46 64 105 107-115 121-124 128-134 139 155"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -73,7 +73,7 @@ Sehen wir uns zunächst kurz die Teile an, die sich gegenüber den Beispielen im
//// tab | Python 3.9+
```Python hl_lines="2 4 8 12 46 64 105 107-115 121-124 128-134 139 155"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -81,7 +81,7 @@ Sehen wir uns zunächst kurz die Teile an, die sich gegenüber den Beispielen im
//// tab | Python 3.8+
```Python hl_lines="2 4 8 12 47 65 106 108-116 122-125 129-135 140 156"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -95,7 +95,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="3 7 11 45 63 104 106-114 120-123 127-133 138 154"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -109,7 +109,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="2 4 8 12 46 64 105 107-115 121-124 128-134 139 155"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -123,7 +123,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="2 4 8 12 46 64 105 107-115 121-124 128-134 139 155"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -139,7 +139,7 @@ Der `scopes`-Parameter erhält ein `dict` mit jedem Scope als Schlüssel und des
//// tab | Python 3.10+
```Python hl_lines="62-65"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -147,7 +147,7 @@ Der `scopes`-Parameter erhält ein `dict` mit jedem Scope als Schlüssel und des
//// tab | Python 3.9+
```Python hl_lines="62-65"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -155,7 +155,7 @@ Der `scopes`-Parameter erhält ein `dict` mit jedem Scope als Schlüssel und des
//// tab | Python 3.8+
```Python hl_lines="63-66"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -169,7 +169,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="61-64"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -183,7 +183,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="62-65"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -197,7 +197,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="62-65"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -229,7 +229,7 @@ Aus Sicherheitsgründen sollten Sie jedoch sicherstellen, dass Sie in Ihrer Anwe
//// tab | Python 3.10+
```Python hl_lines="155"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -237,7 +237,7 @@ Aus Sicherheitsgründen sollten Sie jedoch sicherstellen, dass Sie in Ihrer Anwe
//// tab | Python 3.9+
```Python hl_lines="155"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -245,7 +245,7 @@ Aus Sicherheitsgründen sollten Sie jedoch sicherstellen, dass Sie in Ihrer Anwe
//// tab | Python 3.8+
```Python hl_lines="156"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -259,7 +259,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="154"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -273,7 +273,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="155"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -287,7 +287,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="155"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -319,7 +319,7 @@ Wir tun dies hier, um zu demonstrieren, wie **FastAPI** auf verschiedenen Ebenen
//// tab | Python 3.10+
```Python hl_lines="4 139 170"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -327,7 +327,7 @@ Wir tun dies hier, um zu demonstrieren, wie **FastAPI** auf verschiedenen Ebenen
//// tab | Python 3.9+
```Python hl_lines="4 139 170"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -335,7 +335,7 @@ Wir tun dies hier, um zu demonstrieren, wie **FastAPI** auf verschiedenen Ebenen
//// tab | Python 3.8+
```Python hl_lines="4 140 171"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -349,7 +349,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="3 138 167"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -363,7 +363,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="4 139 168"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -377,7 +377,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="4 139 168"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -409,7 +409,7 @@ Diese `SecurityScopes`-Klasse ähnelt `Request` (`Request` wurde verwendet, um d
//// tab | Python 3.10+
```Python hl_lines="8 105"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -417,7 +417,7 @@ Diese `SecurityScopes`-Klasse ähnelt `Request` (`Request` wurde verwendet, um d
//// tab | Python 3.9+
```Python hl_lines="8 105"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -425,7 +425,7 @@ Diese `SecurityScopes`-Klasse ähnelt `Request` (`Request` wurde verwendet, um d
//// tab | Python 3.8+
```Python hl_lines="8 106"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -439,7 +439,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7 104"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -453,7 +453,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="8 105"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -467,7 +467,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="8 105"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -487,7 +487,7 @@ In diese Exception fügen wir (falls vorhanden) die erforderlichen Scopes als du
//// tab | Python 3.10+
```Python hl_lines="105 107-115"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -495,7 +495,7 @@ In diese Exception fügen wir (falls vorhanden) die erforderlichen Scopes als du
//// tab | Python 3.9+
```Python hl_lines="105 107-115"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -503,7 +503,7 @@ In diese Exception fügen wir (falls vorhanden) die erforderlichen Scopes als du
//// tab | Python 3.8+
```Python hl_lines="106 108-116"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -517,7 +517,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="104 106-114"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -531,7 +531,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="105 107-115"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -545,7 +545,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="105 107-115"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -567,7 +567,7 @@ Wir verifizieren auch, dass wir einen Benutzer mit diesem Benutzernamen haben, u
//// tab | Python 3.10+
```Python hl_lines="46 116-127"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -575,7 +575,7 @@ Wir verifizieren auch, dass wir einen Benutzer mit diesem Benutzernamen haben, u
//// tab | Python 3.9+
```Python hl_lines="46 116-127"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -583,7 +583,7 @@ Wir verifizieren auch, dass wir einen Benutzer mit diesem Benutzernamen haben, u
//// tab | Python 3.8+
```Python hl_lines="47 117-128"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -597,7 +597,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="45 115-126"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -611,7 +611,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="46 116-127"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -625,7 +625,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="46 116-127"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -639,7 +639,7 @@ Hierzu verwenden wir `security_scopes.scopes`, das eine `list`e mit allen diesen
//// tab | Python 3.10+
```Python hl_lines="128-134"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -647,7 +647,7 @@ Hierzu verwenden wir `security_scopes.scopes`, das eine `list`e mit allen diesen
//// tab | Python 3.9+
```Python hl_lines="128-134"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -655,7 +655,7 @@ Hierzu verwenden wir `security_scopes.scopes`, das eine `list`e mit allen diesen
//// tab | Python 3.8+
```Python hl_lines="129-135"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -669,7 +669,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="127-133"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -683,7 +683,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="128-134"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -697,7 +697,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="128-134"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
diff --git a/docs/de/docs/advanced/settings.md b/docs/de/docs/advanced/settings.md
index 3cd4c6c7d..8b9ba2f48 100644
--- a/docs/de/docs/advanced/settings.md
+++ b/docs/de/docs/advanced/settings.md
@@ -181,7 +181,7 @@ Sie können dieselben Validierungs-Funktionen und -Tools verwenden, die Sie für
//// tab | Pydantic v2
```Python hl_lines="2 5-8 11"
-{!> ../../../docs_src/settings/tutorial001.py!}
+{!> ../../docs_src/settings/tutorial001.py!}
```
////
@@ -195,7 +195,7 @@ In Pydantic v1 würden Sie `BaseSettings` direkt von `pydantic` statt von `pydan
///
```Python hl_lines="2 5-8 11"
-{!> ../../../docs_src/settings/tutorial001_pv1.py!}
+{!> ../../docs_src/settings/tutorial001_pv1.py!}
```
////
@@ -215,7 +215,7 @@ Als Nächstes werden die Daten konvertiert und validiert. Wenn Sie also dieses `
Dann können Sie das neue `settings`-Objekt in Ihrer Anwendung verwenden:
```Python hl_lines="18-20"
-{!../../../docs_src/settings/tutorial001.py!}
+{!../../docs_src/settings/tutorial001.py!}
```
### Den Server ausführen
@@ -251,13 +251,13 @@ Sie könnten diese Einstellungen in eine andere Moduldatei einfügen, wie Sie in
Sie könnten beispielsweise eine Datei `config.py` haben mit:
```Python
-{!../../../docs_src/settings/app01/config.py!}
+{!../../docs_src/settings/app01/config.py!}
```
Und dann verwenden Sie diese in einer Datei `main.py`:
```Python hl_lines="3 11-13"
-{!../../../docs_src/settings/app01/main.py!}
+{!../../docs_src/settings/app01/main.py!}
```
/// tip | "Tipp"
@@ -277,7 +277,7 @@ Dies könnte besonders beim Testen nützlich sein, da es sehr einfach ist, eine
Ausgehend vom vorherigen Beispiel könnte Ihre Datei `config.py` so aussehen:
```Python hl_lines="10"
-{!../../../docs_src/settings/app02/config.py!}
+{!../../docs_src/settings/app02/config.py!}
```
Beachten Sie, dass wir jetzt keine Standardinstanz `settings = Settings()` erstellen.
@@ -289,7 +289,7 @@ Jetzt erstellen wir eine Abhängigkeit, die ein neues `config.Settings()` zurüc
//// tab | Python 3.9+
```Python hl_lines="6 12-13"
-{!> ../../../docs_src/settings/app02_an_py39/main.py!}
+{!> ../../docs_src/settings/app02_an_py39/main.py!}
```
////
@@ -297,7 +297,7 @@ Jetzt erstellen wir eine Abhängigkeit, die ein neues `config.Settings()` zurüc
//// tab | Python 3.8+
```Python hl_lines="6 12-13"
-{!> ../../../docs_src/settings/app02_an/main.py!}
+{!> ../../docs_src/settings/app02_an/main.py!}
```
////
@@ -311,7 +311,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="5 11-12"
-{!> ../../../docs_src/settings/app02/main.py!}
+{!> ../../docs_src/settings/app02/main.py!}
```
////
@@ -329,7 +329,7 @@ Und dann können wir das von der *Pfadoperation-Funktion* als Abhängigkeit einf
//// tab | Python 3.9+
```Python hl_lines="17 19-21"
-{!> ../../../docs_src/settings/app02_an_py39/main.py!}
+{!> ../../docs_src/settings/app02_an_py39/main.py!}
```
////
@@ -337,7 +337,7 @@ Und dann können wir das von der *Pfadoperation-Funktion* als Abhängigkeit einf
//// tab | Python 3.8+
```Python hl_lines="17 19-21"
-{!> ../../../docs_src/settings/app02_an/main.py!}
+{!> ../../docs_src/settings/app02_an/main.py!}
```
////
@@ -351,7 +351,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="16 18-20"
-{!> ../../../docs_src/settings/app02/main.py!}
+{!> ../../docs_src/settings/app02/main.py!}
```
////
@@ -361,7 +361,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
Dann wäre es sehr einfach, beim Testen ein anderes Einstellungsobjekt bereitzustellen, indem man eine Abhängigkeitsüberschreibung für `get_settings` erstellt:
```Python hl_lines="9-10 13 21"
-{!../../../docs_src/settings/app02/test_main.py!}
+{!../../docs_src/settings/app02/test_main.py!}
```
Bei der Abhängigkeitsüberschreibung legen wir einen neuen Wert für `admin_email` fest, wenn wir das neue `Settings`-Objekt erstellen, und geben dann dieses neue Objekt zurück.
@@ -406,7 +406,7 @@ Und dann aktualisieren Sie Ihre `config.py` mit:
//// tab | Pydantic v2
```Python hl_lines="9"
-{!> ../../../docs_src/settings/app03_an/config.py!}
+{!> ../../docs_src/settings/app03_an/config.py!}
```
/// tip | "Tipp"
@@ -420,7 +420,7 @@ Das Attribut `model_config` wird nur für die Pydantic-Konfiguration verwendet.
//// tab | Pydantic v1
```Python hl_lines="9-10"
-{!> ../../../docs_src/settings/app03_an/config_pv1.py!}
+{!> ../../docs_src/settings/app03_an/config_pv1.py!}
```
/// tip | "Tipp"
@@ -465,7 +465,7 @@ Da wir jedoch den `@lru_cache`-Dekorator oben verwenden, wird das `Settings`-Obj
//// tab | Python 3.9+
```Python hl_lines="1 11"
-{!> ../../../docs_src/settings/app03_an_py39/main.py!}
+{!> ../../docs_src/settings/app03_an_py39/main.py!}
```
////
@@ -473,7 +473,7 @@ Da wir jedoch den `@lru_cache`-Dekorator oben verwenden, wird das `Settings`-Obj
//// tab | Python 3.8+
```Python hl_lines="1 11"
-{!> ../../../docs_src/settings/app03_an/main.py!}
+{!> ../../docs_src/settings/app03_an/main.py!}
```
////
@@ -487,7 +487,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="1 10"
-{!> ../../../docs_src/settings/app03/main.py!}
+{!> ../../docs_src/settings/app03/main.py!}
```
////
diff --git a/docs/de/docs/advanced/sub-applications.md b/docs/de/docs/advanced/sub-applications.md
index 7dfaaa0cd..172b8d3c1 100644
--- a/docs/de/docs/advanced/sub-applications.md
+++ b/docs/de/docs/advanced/sub-applications.md
@@ -11,7 +11,7 @@ Wenn Sie zwei unabhängige FastAPI-Anwendungen mit deren eigenen unabhängigen O
Erstellen Sie zunächst die Hauptanwendung **FastAPI** und deren *Pfadoperationen*:
```Python hl_lines="3 6-8"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### Unteranwendung
@@ -21,7 +21,7 @@ Erstellen Sie dann Ihre Unteranwendung und deren *Pfadoperationen*.
Diese Unteranwendung ist nur eine weitere Standard-FastAPI-Anwendung, aber diese wird „gemountet“:
```Python hl_lines="11 14-16"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### Die Unteranwendung mounten
@@ -31,7 +31,7 @@ Mounten Sie in Ihrer Top-Level-Anwendung `app` die Unteranwendung `subapi`.
In diesem Fall wird sie im Pfad `/subapi` gemountet:
```Python hl_lines="11 19"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### Es in der automatischen API-Dokumentation betrachten
diff --git a/docs/de/docs/advanced/templates.md b/docs/de/docs/advanced/templates.md
index abc7624f1..6cb3fcf6c 100644
--- a/docs/de/docs/advanced/templates.md
+++ b/docs/de/docs/advanced/templates.md
@@ -28,7 +28,7 @@ $ pip install jinja2
* Verwenden Sie die von Ihnen erstellten `templates`, um eine `TemplateResponse` zu rendern und zurückzugeben, übergeben Sie den Namen des Templates, das Requestobjekt und ein „Kontext“-Dictionary mit Schlüssel-Wert-Paaren, die innerhalb des Jinja2-Templates verwendet werden sollen.
```Python hl_lines="4 11 15-18"
-{!../../../docs_src/templates/tutorial001.py!}
+{!../../docs_src/templates/tutorial001.py!}
```
/// note | "Hinweis"
@@ -58,7 +58,7 @@ Sie können auch `from starlette.templating import Jinja2Templates` verwenden.
Dann können Sie unter `templates/item.html` ein Template erstellen, mit z. B. folgendem Inhalt:
```jinja hl_lines="7"
-{!../../../docs_src/templates/templates/item.html!}
+{!../../docs_src/templates/templates/item.html!}
```
### Template-Kontextwerte
@@ -112,13 +112,13 @@ Mit beispielsweise der ID `42` würde dies Folgendes ergeben:
Sie können `url_for()` innerhalb des Templates auch beispielsweise mit den `StaticFiles` verwenden, die Sie mit `name="static"` gemountet haben.
```jinja hl_lines="4"
-{!../../../docs_src/templates/templates/item.html!}
+{!../../docs_src/templates/templates/item.html!}
```
In diesem Beispiel würde das zu einer CSS-Datei unter `static/styles.css` verlinken, mit folgendem Inhalt:
```CSS hl_lines="4"
-{!../../../docs_src/templates/static/styles.css!}
+{!../../docs_src/templates/static/styles.css!}
```
Und da Sie `StaticFiles` verwenden, wird diese CSS-Datei automatisch von Ihrer **FastAPI**-Anwendung unter der URL `/static/styles.css` bereitgestellt.
diff --git a/docs/de/docs/advanced/testing-dependencies.md b/docs/de/docs/advanced/testing-dependencies.md
index f131d27cd..c565b30f2 100644
--- a/docs/de/docs/advanced/testing-dependencies.md
+++ b/docs/de/docs/advanced/testing-dependencies.md
@@ -31,7 +31,7 @@ Und dann ruft **FastAPI** diese Überschreibung anstelle der ursprünglichen Abh
//// tab | Python 3.10+
```Python hl_lines="26-27 30"
-{!> ../../../docs_src/dependency_testing/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependency_testing/tutorial001_an_py310.py!}
```
////
@@ -39,7 +39,7 @@ Und dann ruft **FastAPI** diese Überschreibung anstelle der ursprünglichen Abh
//// tab | Python 3.9+
```Python hl_lines="28-29 32"
-{!> ../../../docs_src/dependency_testing/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependency_testing/tutorial001_an_py39.py!}
```
////
@@ -47,7 +47,7 @@ Und dann ruft **FastAPI** diese Überschreibung anstelle der ursprünglichen Abh
//// tab | Python 3.8+
```Python hl_lines="29-30 33"
-{!> ../../../docs_src/dependency_testing/tutorial001_an.py!}
+{!> ../../docs_src/dependency_testing/tutorial001_an.py!}
```
////
@@ -61,7 +61,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="24-25 28"
-{!> ../../../docs_src/dependency_testing/tutorial001_py310.py!}
+{!> ../../docs_src/dependency_testing/tutorial001_py310.py!}
```
////
@@ -75,7 +75,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="28-29 32"
-{!> ../../../docs_src/dependency_testing/tutorial001.py!}
+{!> ../../docs_src/dependency_testing/tutorial001.py!}
```
////
diff --git a/docs/de/docs/advanced/testing-events.md b/docs/de/docs/advanced/testing-events.md
index f50093548..3e63791c6 100644
--- a/docs/de/docs/advanced/testing-events.md
+++ b/docs/de/docs/advanced/testing-events.md
@@ -3,5 +3,5 @@
Wenn Sie in Ihren Tests Ihre Event-Handler (`startup` und `shutdown`) ausführen wollen, können Sie den `TestClient` mit einer `with`-Anweisung verwenden:
```Python hl_lines="9-12 20-24"
-{!../../../docs_src/app_testing/tutorial003.py!}
+{!../../docs_src/app_testing/tutorial003.py!}
```
diff --git a/docs/de/docs/advanced/testing-websockets.md b/docs/de/docs/advanced/testing-websockets.md
index 4cbc45c17..7ae7d92d6 100644
--- a/docs/de/docs/advanced/testing-websockets.md
+++ b/docs/de/docs/advanced/testing-websockets.md
@@ -5,7 +5,7 @@ Sie können den schon bekannten `TestClient` zum Testen von WebSockets verwenden
Dazu verwenden Sie den `TestClient` in einer `with`-Anweisung, eine Verbindung zum WebSocket herstellend:
```Python hl_lines="27-31"
-{!../../../docs_src/app_testing/tutorial002.py!}
+{!../../docs_src/app_testing/tutorial002.py!}
```
/// note | "Hinweis"
diff --git a/docs/de/docs/advanced/using-request-directly.md b/docs/de/docs/advanced/using-request-directly.md
index 1d575a7cb..6a0b96680 100644
--- a/docs/de/docs/advanced/using-request-directly.md
+++ b/docs/de/docs/advanced/using-request-directly.md
@@ -30,7 +30,7 @@ Angenommen, Sie möchten auf die IP-Adresse/den Host des Clients in Ihrer *Pfado
Dazu müssen Sie direkt auf den Request zugreifen.
```Python hl_lines="1 7-8"
-{!../../../docs_src/using_request_directly/tutorial001.py!}
+{!../../docs_src/using_request_directly/tutorial001.py!}
```
Durch die Deklaration eines *Pfadoperation-Funktionsparameters*, dessen Typ der `Request` ist, weiß **FastAPI**, dass es den `Request` diesem Parameter übergeben soll.
diff --git a/docs/de/docs/advanced/websockets.md b/docs/de/docs/advanced/websockets.md
index 6d772b6c9..cf13fa23c 100644
--- a/docs/de/docs/advanced/websockets.md
+++ b/docs/de/docs/advanced/websockets.md
@@ -39,7 +39,7 @@ In der Produktion hätten Sie eine der oben genannten Optionen.
Aber es ist die einfachste Möglichkeit, sich auf die Serverseite von WebSockets zu konzentrieren und ein funktionierendes Beispiel zu haben:
```Python hl_lines="2 6-38 41-43"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
## Einen `websocket` erstellen
@@ -47,7 +47,7 @@ Aber es ist die einfachste Möglichkeit, sich auf die Serverseite von WebSockets
Erstellen Sie in Ihrer **FastAPI**-Anwendung einen `websocket`:
```Python hl_lines="1 46-47"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
/// note | "Technische Details"
@@ -63,7 +63,7 @@ Sie können auch `from starlette.websockets import WebSocket` verwenden.
In Ihrer WebSocket-Route können Sie Nachrichten `await`en und Nachrichten senden.
```Python hl_lines="48-52"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
Sie können Binär-, Text- und JSON-Daten empfangen und senden.
@@ -118,7 +118,7 @@ Diese funktionieren auf die gleiche Weise wie für andere FastAPI-Endpunkte/*Pfa
//// tab | Python 3.10+
```Python hl_lines="68-69 82"
-{!> ../../../docs_src/websockets/tutorial002_an_py310.py!}
+{!> ../../docs_src/websockets/tutorial002_an_py310.py!}
```
////
@@ -126,7 +126,7 @@ Diese funktionieren auf die gleiche Weise wie für andere FastAPI-Endpunkte/*Pfa
//// tab | Python 3.9+
```Python hl_lines="68-69 82"
-{!> ../../../docs_src/websockets/tutorial002_an_py39.py!}
+{!> ../../docs_src/websockets/tutorial002_an_py39.py!}
```
////
@@ -134,7 +134,7 @@ Diese funktionieren auf die gleiche Weise wie für andere FastAPI-Endpunkte/*Pfa
//// tab | Python 3.8+
```Python hl_lines="69-70 83"
-{!> ../../../docs_src/websockets/tutorial002_an.py!}
+{!> ../../docs_src/websockets/tutorial002_an.py!}
```
////
@@ -148,7 +148,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="66-67 79"
-{!> ../../../docs_src/websockets/tutorial002_py310.py!}
+{!> ../../docs_src/websockets/tutorial002_py310.py!}
```
////
@@ -162,7 +162,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="68-69 81"
-{!> ../../../docs_src/websockets/tutorial002.py!}
+{!> ../../docs_src/websockets/tutorial002.py!}
```
////
@@ -213,7 +213,7 @@ Wenn eine WebSocket-Verbindung geschlossen wird, löst `await websocket.receive_
//// tab | Python 3.9+
```Python hl_lines="79-81"
-{!> ../../../docs_src/websockets/tutorial003_py39.py!}
+{!> ../../docs_src/websockets/tutorial003_py39.py!}
```
////
@@ -221,7 +221,7 @@ Wenn eine WebSocket-Verbindung geschlossen wird, löst `await websocket.receive_
//// tab | Python 3.8+
```Python hl_lines="81-83"
-{!> ../../../docs_src/websockets/tutorial003.py!}
+{!> ../../docs_src/websockets/tutorial003.py!}
```
////
diff --git a/docs/de/docs/advanced/wsgi.md b/docs/de/docs/advanced/wsgi.md
index 19ff90a90..50abc84d1 100644
--- a/docs/de/docs/advanced/wsgi.md
+++ b/docs/de/docs/advanced/wsgi.md
@@ -13,7 +13,7 @@ Wrappen Sie dann die WSGI-Anwendung (z. B. Flask) mit der Middleware.
Und dann mounten Sie das auf einem Pfad.
```Python hl_lines="2-3 23"
-{!../../../docs_src/wsgi/tutorial001.py!}
+{!../../docs_src/wsgi/tutorial001.py!}
```
## Es ansehen
diff --git a/docs/de/docs/how-to/conditional-openapi.md b/docs/de/docs/how-to/conditional-openapi.md
index 7f277bb88..a0a4983bb 100644
--- a/docs/de/docs/how-to/conditional-openapi.md
+++ b/docs/de/docs/how-to/conditional-openapi.md
@@ -30,7 +30,7 @@ Sie können problemlos dieselben Pydantic-Einstellungen verwenden, um Ihre gener
Zum Beispiel:
```Python hl_lines="6 11"
-{!../../../docs_src/conditional_openapi/tutorial001.py!}
+{!../../docs_src/conditional_openapi/tutorial001.py!}
```
Hier deklarieren wir die Einstellung `openapi_url` mit dem gleichen Defaultwert `"/openapi.json"`.
diff --git a/docs/de/docs/how-to/configure-swagger-ui.md b/docs/de/docs/how-to/configure-swagger-ui.md
index 7d62a14d3..31b9cd290 100644
--- a/docs/de/docs/how-to/configure-swagger-ui.md
+++ b/docs/de/docs/how-to/configure-swagger-ui.md
@@ -19,7 +19,7 @@ Ohne Änderung der Einstellungen ist die Syntaxhervorhebung standardmäßig akti
Sie können sie jedoch deaktivieren, indem Sie `syntaxHighlight` auf `False` setzen:
```Python hl_lines="3"
-{!../../../docs_src/configure_swagger_ui/tutorial001.py!}
+{!../../docs_src/configure_swagger_ui/tutorial001.py!}
```
... und dann zeigt die Swagger-Oberfläche die Syntaxhervorhebung nicht mehr an:
@@ -31,7 +31,7 @@ Sie können sie jedoch deaktivieren, indem Sie `syntaxHighlight` auf `False` set
Auf die gleiche Weise könnten Sie das Theme der Syntaxhervorhebung mit dem Schlüssel `syntaxHighlight.theme` festlegen (beachten Sie, dass er einen Punkt in der Mitte hat):
```Python hl_lines="3"
-{!../../../docs_src/configure_swagger_ui/tutorial002.py!}
+{!../../docs_src/configure_swagger_ui/tutorial002.py!}
```
Obige Konfiguration würde das Theme für die Farbe der Syntaxhervorhebung ändern:
@@ -45,7 +45,7 @@ FastAPI enthält einige Defaultkonfigurationsparameter, die für die meisten Anw
Es umfasst die folgenden Defaultkonfigurationen:
```Python
-{!../../../fastapi/openapi/docs.py[ln:7-23]!}
+{!../../fastapi/openapi/docs.py[ln:7-23]!}
```
Sie können jede davon überschreiben, indem Sie im Argument `swagger_ui_parameters` einen anderen Wert festlegen.
@@ -53,7 +53,7 @@ Sie können jede davon überschreiben, indem Sie im Argument `swagger_ui_paramet
Um beispielsweise `deepLinking` zu deaktivieren, könnten Sie folgende Einstellungen an `swagger_ui_parameters` übergeben:
```Python hl_lines="3"
-{!../../../docs_src/configure_swagger_ui/tutorial003.py!}
+{!../../docs_src/configure_swagger_ui/tutorial003.py!}
```
## Andere Parameter der Swagger-Oberfläche
diff --git a/docs/de/docs/how-to/custom-docs-ui-assets.md b/docs/de/docs/how-to/custom-docs-ui-assets.md
index e8750f7c2..e5fd20a10 100644
--- a/docs/de/docs/how-to/custom-docs-ui-assets.md
+++ b/docs/de/docs/how-to/custom-docs-ui-assets.md
@@ -19,7 +19,7 @@ Der erste Schritt besteht darin, die automatischen Dokumentationen zu deaktivier
Um diese zu deaktivieren, setzen Sie deren URLs beim Erstellen Ihrer `FastAPI`-App auf `None`:
```Python hl_lines="8"
-{!../../../docs_src/custom_docs_ui/tutorial001.py!}
+{!../../docs_src/custom_docs_ui/tutorial001.py!}
```
### Die benutzerdefinierten Dokumentationen hinzufügen
@@ -37,7 +37,7 @@ Sie können die internen Funktionen von FastAPI wiederverwenden, um die HTML-Sei
Und genau so für ReDoc ...
```Python hl_lines="2-6 11-19 22-24 27-33"
-{!../../../docs_src/custom_docs_ui/tutorial001.py!}
+{!../../docs_src/custom_docs_ui/tutorial001.py!}
```
/// tip | "Tipp"
@@ -55,7 +55,7 @@ Swagger UI erledigt das hinter den Kulissen für Sie, benötigt aber diesen „U
Um nun testen zu können, ob alles funktioniert, erstellen Sie eine *Pfadoperation*:
```Python hl_lines="36-38"
-{!../../../docs_src/custom_docs_ui/tutorial001.py!}
+{!../../docs_src/custom_docs_ui/tutorial001.py!}
```
### Es ausprobieren
@@ -125,7 +125,7 @@ Danach könnte Ihre Dateistruktur wie folgt aussehen:
* „Mounten“ Sie eine `StaticFiles()`-Instanz in einem bestimmten Pfad.
```Python hl_lines="7 11"
-{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+{!../../docs_src/custom_docs_ui/tutorial002.py!}
```
### Die statischen Dateien testen
@@ -159,7 +159,7 @@ Wie bei der Verwendung eines benutzerdefinierten CDN besteht der erste Schritt d
Um diese zu deaktivieren, setzen Sie deren URLs beim Erstellen Ihrer `FastAPI`-App auf `None`:
```Python hl_lines="9"
-{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+{!../../docs_src/custom_docs_ui/tutorial002.py!}
```
### Die benutzerdefinierten Dokumentationen, mit statischen Dateien, hinzufügen
@@ -177,7 +177,7 @@ Auch hier können Sie die internen Funktionen von FastAPI wiederverwenden, um di
Und genau so für ReDoc ...
```Python hl_lines="2-6 14-22 25-27 30-36"
-{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+{!../../docs_src/custom_docs_ui/tutorial002.py!}
```
/// tip | "Tipp"
@@ -195,7 +195,7 @@ Swagger UI erledigt das hinter den Kulissen für Sie, benötigt aber diesen „U
Um nun testen zu können, ob alles funktioniert, erstellen Sie eine *Pfadoperation*:
```Python hl_lines="39-41"
-{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+{!../../docs_src/custom_docs_ui/tutorial002.py!}
```
### Benutzeroberfläche, mit statischen Dateien, testen
diff --git a/docs/de/docs/how-to/custom-request-and-route.md b/docs/de/docs/how-to/custom-request-and-route.md
index a0c4a0e0c..f81fa1da3 100644
--- a/docs/de/docs/how-to/custom-request-and-route.md
+++ b/docs/de/docs/how-to/custom-request-and-route.md
@@ -43,7 +43,7 @@ Wenn der Header kein `gzip` enthält, wird nicht versucht, den Body zu dekomprim
Auf diese Weise kann dieselbe Routenklasse gzip-komprimierte oder unkomprimierte Requests verarbeiten.
```Python hl_lines="8-15"
-{!../../../docs_src/custom_request_and_route/tutorial001.py!}
+{!../../docs_src/custom_request_and_route/tutorial001.py!}
```
### Eine benutzerdefinierte `GzipRoute`-Klasse erstellen
@@ -57,7 +57,7 @@ Diese Methode gibt eine Funktion zurück. Und diese Funktion empfängt einen Req
Hier verwenden wir sie, um aus dem ursprünglichen Request einen `GzipRequest` zu erstellen.
```Python hl_lines="18-26"
-{!../../../docs_src/custom_request_and_route/tutorial001.py!}
+{!../../docs_src/custom_request_and_route/tutorial001.py!}
```
/// note | "Technische Details"
@@ -97,13 +97,13 @@ Wir können denselben Ansatz auch verwenden, um in einem Exceptionhandler auf de
Alles, was wir tun müssen, ist, den Request innerhalb eines `try`/`except`-Blocks zu handhaben:
```Python hl_lines="13 15"
-{!../../../docs_src/custom_request_and_route/tutorial002.py!}
+{!../../docs_src/custom_request_and_route/tutorial002.py!}
```
Wenn eine Exception auftritt, befindet sich die `Request`-Instanz weiterhin im Gültigkeitsbereich, sodass wir den Requestbody lesen und bei der Fehlerbehandlung verwenden können:
```Python hl_lines="16-18"
-{!../../../docs_src/custom_request_and_route/tutorial002.py!}
+{!../../docs_src/custom_request_and_route/tutorial002.py!}
```
## Benutzerdefinierte `APIRoute`-Klasse in einem Router
@@ -111,11 +111,11 @@ Wenn eine Exception auftritt, befindet sich die `Request`-Instanz weiterhin im G
Sie können auch den Parameter `route_class` eines `APIRouter` festlegen:
```Python hl_lines="26"
-{!../../../docs_src/custom_request_and_route/tutorial003.py!}
+{!../../docs_src/custom_request_and_route/tutorial003.py!}
```
In diesem Beispiel verwenden die *Pfadoperationen* unter dem `router` die benutzerdefinierte `TimedRoute`-Klasse und haben in der Response einen zusätzlichen `X-Response-Time`-Header mit der Zeit, die zum Generieren der Response benötigt wurde:
```Python hl_lines="13-20"
-{!../../../docs_src/custom_request_and_route/tutorial003.py!}
+{!../../docs_src/custom_request_and_route/tutorial003.py!}
```
diff --git a/docs/de/docs/how-to/extending-openapi.md b/docs/de/docs/how-to/extending-openapi.md
index 347c5bed3..c895fb860 100644
--- a/docs/de/docs/how-to/extending-openapi.md
+++ b/docs/de/docs/how-to/extending-openapi.md
@@ -44,7 +44,7 @@ Fügen wir beispielsweise <a href="https://github.com/Rebilly/ReDoc/blob/master/
Schreiben Sie zunächst wie gewohnt Ihre ganze **FastAPI**-Anwendung:
```Python hl_lines="1 4 7-9"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### Das OpenAPI-Schema generieren
@@ -52,7 +52,7 @@ Schreiben Sie zunächst wie gewohnt Ihre ganze **FastAPI**-Anwendung:
Verwenden Sie dann dieselbe Hilfsfunktion, um das OpenAPI-Schema innerhalb einer `custom_openapi()`-Funktion zu generieren:
```Python hl_lines="2 15-21"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### Das OpenAPI-Schema ändern
@@ -60,7 +60,7 @@ Verwenden Sie dann dieselbe Hilfsfunktion, um das OpenAPI-Schema innerhalb einer
Jetzt können Sie die ReDoc-Erweiterung hinzufügen und dem `info`-„Objekt“ im OpenAPI-Schema ein benutzerdefiniertes `x-logo` hinzufügen:
```Python hl_lines="22-24"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### Zwischenspeichern des OpenAPI-Schemas
@@ -72,7 +72,7 @@ Auf diese Weise muss Ihre Anwendung das Schema nicht jedes Mal generieren, wenn
Es wird nur einmal generiert und dann wird dasselbe zwischengespeicherte Schema für die nächsten Requests verwendet.
```Python hl_lines="13-14 25-26"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### Die Methode überschreiben
@@ -80,7 +80,7 @@ Es wird nur einmal generiert und dann wird dasselbe zwischengespeicherte Schema
Jetzt können Sie die Methode `.openapi()` durch Ihre neue Funktion ersetzen.
```Python hl_lines="29"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### Testen
diff --git a/docs/de/docs/how-to/graphql.md b/docs/de/docs/how-to/graphql.md
index 19af25bb3..cde56ffde 100644
--- a/docs/de/docs/how-to/graphql.md
+++ b/docs/de/docs/how-to/graphql.md
@@ -36,7 +36,7 @@ Abhängig von Ihrem Anwendungsfall bevorzugen Sie vielleicht eine andere Bibliot
Hier ist eine kleine Vorschau, wie Sie Strawberry mit FastAPI integrieren können:
```Python hl_lines="3 22 25-26"
-{!../../../docs_src/graphql/tutorial001.py!}
+{!../../docs_src/graphql/tutorial001.py!}
```
Weitere Informationen zu Strawberry finden Sie in der <a href="https://strawberry.rocks/" class="external-link" target="_blank">Strawberry-Dokumentation</a>.
diff --git a/docs/de/docs/how-to/separate-openapi-schemas.md b/docs/de/docs/how-to/separate-openapi-schemas.md
index eaecb27de..974341dd2 100644
--- a/docs/de/docs/how-to/separate-openapi-schemas.md
+++ b/docs/de/docs/how-to/separate-openapi-schemas.md
@@ -13,7 +13,7 @@ Nehmen wir an, Sie haben ein Pydantic-Modell mit Defaultwerten wie dieses:
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-7]!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-7]!}
# Code unterhalb weggelassen 👇
```
@@ -22,7 +22,7 @@ Nehmen wir an, Sie haben ein Pydantic-Modell mit Defaultwerten wie dieses:
<summary>👀 Vollständige Dateivorschau</summary>
```Python
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
```
</details>
@@ -32,7 +32,7 @@ Nehmen wir an, Sie haben ein Pydantic-Modell mit Defaultwerten wie dieses:
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-9]!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-9]!}
# Code unterhalb weggelassen 👇
```
@@ -41,7 +41,7 @@ Nehmen wir an, Sie haben ein Pydantic-Modell mit Defaultwerten wie dieses:
<summary>👀 Vollständige Dateivorschau</summary>
```Python
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
```
</details>
@@ -51,7 +51,7 @@ Nehmen wir an, Sie haben ein Pydantic-Modell mit Defaultwerten wie dieses:
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-9]!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-9]!}
# Code unterhalb weggelassen 👇
```
@@ -60,7 +60,7 @@ Nehmen wir an, Sie haben ein Pydantic-Modell mit Defaultwerten wie dieses:
<summary>👀 Vollständige Dateivorschau</summary>
```Python
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py!}
```
</details>
@@ -74,7 +74,7 @@ Wenn Sie dieses Modell wie hier als Eingabe verwenden:
//// tab | Python 3.10+
```Python hl_lines="14"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-15]!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-15]!}
# Code unterhalb weggelassen 👇
```
@@ -83,7 +83,7 @@ Wenn Sie dieses Modell wie hier als Eingabe verwenden:
<summary>👀 Vollständige Dateivorschau</summary>
```Python
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
```
</details>
@@ -93,7 +93,7 @@ Wenn Sie dieses Modell wie hier als Eingabe verwenden:
//// tab | Python 3.9+
```Python hl_lines="16"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-17]!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-17]!}
# Code unterhalb weggelassen 👇
```
@@ -102,7 +102,7 @@ Wenn Sie dieses Modell wie hier als Eingabe verwenden:
<summary>👀 Vollständige Dateivorschau</summary>
```Python
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
```
</details>
@@ -112,7 +112,7 @@ Wenn Sie dieses Modell wie hier als Eingabe verwenden:
//// tab | Python 3.8+
```Python hl_lines="16"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-17]!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-17]!}
# Code unterhalb weggelassen 👇
```
@@ -121,7 +121,7 @@ Wenn Sie dieses Modell wie hier als Eingabe verwenden:
<summary>👀 Vollständige Dateivorschau</summary>
```Python
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py!}
```
</details>
@@ -145,7 +145,7 @@ Wenn Sie jedoch dasselbe Modell als Ausgabe verwenden, wie hier:
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
```
////
@@ -153,7 +153,7 @@ Wenn Sie jedoch dasselbe Modell als Ausgabe verwenden, wie hier:
//// tab | Python 3.9+
```Python hl_lines="21"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
```
////
@@ -161,7 +161,7 @@ Wenn Sie jedoch dasselbe Modell als Ausgabe verwenden, wie hier:
//// tab | Python 3.8+
```Python hl_lines="21"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py!}
```
////
@@ -226,7 +226,7 @@ Unterstützung für `separate_input_output_schemas` wurde in FastAPI `0.102.0` h
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial002_py310.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial002_py310.py!}
```
////
@@ -234,7 +234,7 @@ Unterstützung für `separate_input_output_schemas` wurde in FastAPI `0.102.0` h
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial002_py39.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial002_py39.py!}
```
////
@@ -242,7 +242,7 @@ Unterstützung für `separate_input_output_schemas` wurde in FastAPI `0.102.0` h
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial002.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial002.py!}
```
////
diff --git a/docs/de/docs/python-types.md b/docs/de/docs/python-types.md
index 9bbff83d3..a43bf5ffe 100644
--- a/docs/de/docs/python-types.md
+++ b/docs/de/docs/python-types.md
@@ -23,7 +23,7 @@ Wenn Sie ein Python-Experte sind und bereits alles über Typhinweise wissen, üb
Fangen wir mit einem einfachen Beispiel an:
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
Dieses Programm gibt aus:
@@ -39,7 +39,7 @@ Die Funktion macht Folgendes:
* <abbr title="Füge zu einer Einheit zusammen, eins nach dem anderen.">Verkettet</abbr> sie mit einem Leerzeichen in der Mitte.
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### Bearbeiten Sie es
@@ -83,7 +83,7 @@ Das war's.
Das sind die „Typhinweise“:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
Das ist nicht das gleiche wie das Deklarieren von Defaultwerten, wie es hier der Fall ist:
@@ -113,7 +113,7 @@ Hier können Sie durch die Optionen blättern, bis Sie diejenige finden, bei der
Sehen Sie sich diese Funktion an, sie hat bereits Typhinweise:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
Da der Editor die Typen der Variablen kennt, erhalten Sie nicht nur Code-Vervollständigung, sondern auch eine Fehlerprüfung:
@@ -123,7 +123,7 @@ Da der Editor die Typen der Variablen kennt, erhalten Sie nicht nur Code-Vervoll
Jetzt, da Sie wissen, dass Sie das reparieren müssen, konvertieren Sie `age` mittels `str(age)` in einen String:
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## Deklarieren von Typen
@@ -144,7 +144,7 @@ Zum Beispiel diese:
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### Generische Typen mit Typ-Parametern
@@ -182,7 +182,7 @@ Als Typ nehmen Sie `list`.
Da die Liste ein Typ ist, welcher innere Typen enthält, werden diese von eckigen Klammern umfasst:
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006_py39.py!}
+{!> ../../docs_src/python_types/tutorial006_py39.py!}
```
////
@@ -192,7 +192,7 @@ Da die Liste ein Typ ist, welcher innere Typen enthält, werden diese von eckige
Von `typing` importieren Sie `List` (mit Großbuchstaben `L`):
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
Deklarieren Sie die Variable mit der gleichen Doppelpunkt-Syntax (`:`).
@@ -202,7 +202,7 @@ Als Typ nehmen Sie das `List`, das Sie von `typing` importiert haben.
Da die Liste ein Typ ist, welcher innere Typen enthält, werden diese von eckigen Klammern umfasst:
```Python hl_lines="4"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
////
@@ -240,7 +240,7 @@ Das Gleiche gilt für die Deklaration eines Tupels – `tuple` – und einer Men
//// tab | Python 3.9+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial007_py39.py!}
+{!> ../../docs_src/python_types/tutorial007_py39.py!}
```
////
@@ -248,7 +248,7 @@ Das Gleiche gilt für die Deklaration eines Tupels – `tuple` – und einer Men
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial007.py!}
+{!> ../../docs_src/python_types/tutorial007.py!}
```
////
@@ -269,7 +269,7 @@ Der zweite Typ-Parameter ist für die Werte des `dict`:
//// tab | Python 3.9+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008_py39.py!}
+{!> ../../docs_src/python_types/tutorial008_py39.py!}
```
////
@@ -277,7 +277,7 @@ Der zweite Typ-Parameter ist für die Werte des `dict`:
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008.py!}
+{!> ../../docs_src/python_types/tutorial008.py!}
```
////
@@ -299,7 +299,7 @@ In Python 3.10 gibt es zusätzlich eine **neue Syntax**, die es erlaubt, die mö
//// tab | Python 3.10+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008b_py310.py!}
+{!> ../../docs_src/python_types/tutorial008b_py310.py!}
```
////
@@ -307,7 +307,7 @@ In Python 3.10 gibt es zusätzlich eine **neue Syntax**, die es erlaubt, die mö
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008b.py!}
+{!> ../../docs_src/python_types/tutorial008b.py!}
```
////
@@ -321,7 +321,7 @@ Sie können deklarieren, dass ein Wert ein `str`, aber vielleicht auch `None` se
In Python 3.6 und darüber (inklusive Python 3.10) können Sie das deklarieren, indem Sie `Optional` vom `typing` Modul importieren und verwenden.
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
Wenn Sie `Optional[str]` anstelle von nur `str` verwenden, wird Ihr Editor Ihnen dabei helfen, Fehler zu erkennen, bei denen Sie annehmen könnten, dass ein Wert immer eine String (`str`) ist, obwohl er auch `None` sein könnte.
@@ -333,7 +333,7 @@ Das bedeutet auch, dass Sie in Python 3.10 `Something | None` verwenden können:
//// tab | Python 3.10+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial009_py310.py!}
+{!> ../../docs_src/python_types/tutorial009_py310.py!}
```
////
@@ -341,7 +341,7 @@ Das bedeutet auch, dass Sie in Python 3.10 `Something | None` verwenden können:
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009.py!}
+{!> ../../docs_src/python_types/tutorial009.py!}
```
////
@@ -349,7 +349,7 @@ Das bedeutet auch, dass Sie in Python 3.10 `Something | None` verwenden können:
//// tab | Python 3.8+ Alternative
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009b.py!}
+{!> ../../docs_src/python_types/tutorial009b.py!}
```
////
@@ -370,7 +370,7 @@ Es geht nur um Wörter und Namen. Aber diese Worte können beeinflussen, wie Sie
Nehmen wir zum Beispiel diese Funktion:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009c.py!}
+{!../../docs_src/python_types/tutorial009c.py!}
```
Der Parameter `name` ist definiert als `Optional[str]`, aber er ist **nicht optional**, Sie können die Funktion nicht ohne diesen Parameter aufrufen:
@@ -388,7 +388,7 @@ say_hi(name=None) # Das funktioniert, None is gültig 🎉
Die gute Nachricht ist, dass Sie sich darüber keine Sorgen mehr machen müssen, wenn Sie Python 3.10 verwenden, da Sie einfach `|` verwenden können, um Vereinigungen von Typen zu definieren:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009c_py310.py!}
+{!../../docs_src/python_types/tutorial009c_py310.py!}
```
Und dann müssen Sie sich nicht mehr um Namen wie `Optional` und `Union` kümmern. 😎
@@ -452,13 +452,13 @@ Sie können auch eine Klasse als Typ einer Variablen deklarieren.
Nehmen wir an, Sie haben eine Klasse `Person`, mit einem Namen:
```Python hl_lines="1-3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Dann können Sie eine Variable vom Typ `Person` deklarieren:
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Und wiederum bekommen Sie die volle Editor-Unterstützung:
@@ -486,7 +486,7 @@ Ein Beispiel aus der offiziellen Pydantic Dokumentation:
//// tab | Python 3.10+
```Python
-{!> ../../../docs_src/python_types/tutorial011_py310.py!}
+{!> ../../docs_src/python_types/tutorial011_py310.py!}
```
////
@@ -494,7 +494,7 @@ Ein Beispiel aus der offiziellen Pydantic Dokumentation:
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/python_types/tutorial011_py39.py!}
+{!> ../../docs_src/python_types/tutorial011_py39.py!}
```
////
@@ -502,7 +502,7 @@ Ein Beispiel aus der offiziellen Pydantic Dokumentation:
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/python_types/tutorial011.py!}
+{!> ../../docs_src/python_types/tutorial011.py!}
```
////
@@ -532,7 +532,7 @@ Python bietet auch die Möglichkeit, **zusätzliche Metadaten** in Typhinweisen
In Python 3.9 ist `Annotated` ein Teil der Standardbibliothek, Sie können es von `typing` importieren.
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial013_py39.py!}
+{!> ../../docs_src/python_types/tutorial013_py39.py!}
```
////
@@ -544,7 +544,7 @@ In Versionen niedriger als Python 3.9 importieren Sie `Annotated` von `typing_ex
Es wird bereits mit **FastAPI** installiert sein.
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial013.py!}
+{!> ../../docs_src/python_types/tutorial013.py!}
```
////
diff --git a/docs/de/docs/tutorial/background-tasks.md b/docs/de/docs/tutorial/background-tasks.md
index 0852288d5..cd857f5e7 100644
--- a/docs/de/docs/tutorial/background-tasks.md
+++ b/docs/de/docs/tutorial/background-tasks.md
@@ -16,7 +16,7 @@ Hierzu zählen beispielsweise:
Importieren Sie zunächst `BackgroundTasks` und definieren Sie einen Parameter in Ihrer *Pfadoperation-Funktion* mit der Typdeklaration `BackgroundTasks`:
```Python hl_lines="1 13"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
**FastAPI** erstellt für Sie das Objekt vom Typ `BackgroundTasks` und übergibt es als diesen Parameter.
@@ -34,7 +34,7 @@ In diesem Fall schreibt die Taskfunktion in eine Datei (den Versand einer E-Mail
Und da der Schreibvorgang nicht `async` und `await` verwendet, definieren wir die Funktion mit normalem `def`:
```Python hl_lines="6-9"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
## Den Hintergrundtask hinzufügen
@@ -42,7 +42,7 @@ Und da der Schreibvorgang nicht `async` und `await` verwendet, definieren wir di
Übergeben Sie innerhalb Ihrer *Pfadoperation-Funktion* Ihre Taskfunktion mit der Methode `.add_task()` an das *Hintergrundtasks*-Objekt:
```Python hl_lines="14"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
`.add_task()` erhält als Argumente:
@@ -60,7 +60,7 @@ Die Verwendung von `BackgroundTasks` funktioniert auch mit dem <abbr title="Einb
//// tab | Python 3.10+
```Python hl_lines="13 15 22 25"
-{!> ../../../docs_src/background_tasks/tutorial002_an_py310.py!}
+{!> ../../docs_src/background_tasks/tutorial002_an_py310.py!}
```
////
@@ -68,7 +68,7 @@ Die Verwendung von `BackgroundTasks` funktioniert auch mit dem <abbr title="Einb
//// tab | Python 3.9+
```Python hl_lines="13 15 22 25"
-{!> ../../../docs_src/background_tasks/tutorial002_an_py39.py!}
+{!> ../../docs_src/background_tasks/tutorial002_an_py39.py!}
```
////
@@ -76,7 +76,7 @@ Die Verwendung von `BackgroundTasks` funktioniert auch mit dem <abbr title="Einb
//// tab | Python 3.8+
```Python hl_lines="14 16 23 26"
-{!> ../../../docs_src/background_tasks/tutorial002_an.py!}
+{!> ../../docs_src/background_tasks/tutorial002_an.py!}
```
////
@@ -90,7 +90,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="11 13 20 23"
-{!> ../../../docs_src/background_tasks/tutorial002_py310.py!}
+{!> ../../docs_src/background_tasks/tutorial002_py310.py!}
```
////
@@ -104,7 +104,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="13 15 22 25"
-{!> ../../../docs_src/background_tasks/tutorial002.py!}
+{!> ../../docs_src/background_tasks/tutorial002.py!}
```
////
diff --git a/docs/de/docs/tutorial/bigger-applications.md b/docs/de/docs/tutorial/bigger-applications.md
index 986a99a38..000fa1f43 100644
--- a/docs/de/docs/tutorial/bigger-applications.md
+++ b/docs/de/docs/tutorial/bigger-applications.md
@@ -86,7 +86,7 @@ Sie können die *Pfadoperationen* für dieses Modul mit `APIRouter` erstellen.
Sie importieren ihn und erstellen eine „Instanz“ auf die gleiche Weise wie mit der Klasse `FastAPI`:
```Python hl_lines="1 3" title="app/routers/users.py"
-{!../../../docs_src/bigger_applications/app/routers/users.py!}
+{!../../docs_src/bigger_applications/app/routers/users.py!}
```
### *Pfadoperationen* mit `APIRouter`
@@ -96,7 +96,7 @@ Und dann verwenden Sie ihn, um Ihre *Pfadoperationen* zu deklarieren.
Verwenden Sie ihn auf die gleiche Weise wie die Klasse `FastAPI`:
```Python hl_lines="6 11 16" title="app/routers/users.py"
-{!../../../docs_src/bigger_applications/app/routers/users.py!}
+{!../../docs_src/bigger_applications/app/routers/users.py!}
```
Sie können sich `APIRouter` als eine „Mini-`FastAPI`“-Klasse vorstellen.
@@ -124,7 +124,7 @@ Wir werden nun eine einfache Abhängigkeit verwenden, um einen benutzerdefiniert
//// tab | Python 3.9+
```Python hl_lines="3 6-8" title="app/dependencies.py"
-{!> ../../../docs_src/bigger_applications/app_an_py39/dependencies.py!}
+{!> ../../docs_src/bigger_applications/app_an_py39/dependencies.py!}
```
////
@@ -132,7 +132,7 @@ Wir werden nun eine einfache Abhängigkeit verwenden, um einen benutzerdefiniert
//// tab | Python 3.8+
```Python hl_lines="1 5-7" title="app/dependencies.py"
-{!> ../../../docs_src/bigger_applications/app_an/dependencies.py!}
+{!> ../../docs_src/bigger_applications/app_an/dependencies.py!}
```
////
@@ -146,7 +146,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="1 4-6" title="app/dependencies.py"
-{!> ../../../docs_src/bigger_applications/app/dependencies.py!}
+{!> ../../docs_src/bigger_applications/app/dependencies.py!}
```
////
@@ -182,7 +182,7 @@ Wir wissen, dass alle *Pfadoperationen* in diesem Modul folgendes haben:
Anstatt also alles zu jeder *Pfadoperation* hinzuzufügen, können wir es dem `APIRouter` hinzufügen.
```Python hl_lines="5-10 16 21" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
Da der Pfad jeder *Pfadoperation* mit `/` beginnen muss, wie in:
@@ -243,7 +243,7 @@ Und wir müssen die Abhängigkeitsfunktion aus dem Modul `app.dependencies` impo
Daher verwenden wir einen relativen Import mit `..` für die Abhängigkeiten:
```Python hl_lines="3" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
#### Wie relative Importe funktionieren
@@ -316,7 +316,7 @@ Wir fügen weder das Präfix `/items` noch `tags=["items"]` zu jeder *Pfadoperat
Aber wir können immer noch _mehr_ `tags` hinzufügen, die auf eine bestimmte *Pfadoperation* angewendet werden, sowie einige zusätzliche `responses`, die speziell für diese *Pfadoperation* gelten:
```Python hl_lines="30-31" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
/// tip | "Tipp"
@@ -344,7 +344,7 @@ Sie importieren und erstellen wie gewohnt eine `FastAPI`-Klasse.
Und wir können sogar [globale Abhängigkeiten](dependencies/global-dependencies.md){.internal-link target=_blank} deklarieren, die mit den Abhängigkeiten für jeden `APIRouter` kombiniert werden:
```Python hl_lines="1 3 7" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
### Den `APIRouter` importieren
@@ -352,7 +352,7 @@ Und wir können sogar [globale Abhängigkeiten](dependencies/global-dependencies
Jetzt importieren wir die anderen Submodule, die `APIRouter` haben:
```Python hl_lines="4-5" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
Da es sich bei den Dateien `app/routers/users.py` und `app/routers/items.py` um Submodule handelt, die Teil desselben Python-Packages `app` sind, können wir einen einzelnen Punkt `.` verwenden, um sie mit „relativen Imports“ zu importieren.
@@ -417,7 +417,7 @@ würde der `router` von `users` den von `items` überschreiben und wir könnten
Um also beide in derselben Datei verwenden zu können, importieren wir die Submodule direkt:
```Python hl_lines="5" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
@@ -426,7 +426,7 @@ Um also beide in derselben Datei verwenden zu können, importieren wir die Submo
Inkludieren wir nun die `router` aus diesen Submodulen `users` und `items`:
```Python hl_lines="10-11" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
/// info
@@ -468,7 +468,7 @@ Sie enthält einen `APIRouter` mit einigen administrativen *Pfadoperationen*, di
In diesem Beispiel wird es ganz einfach sein. Nehmen wir jedoch an, dass wir, da sie mit anderen Projekten in der Organisation geteilt wird, sie nicht ändern und kein `prefix`, `dependencies`, `tags`, usw. direkt zum `APIRouter` hinzufügen können:
```Python hl_lines="3" title="app/internal/admin.py"
-{!../../../docs_src/bigger_applications/app/internal/admin.py!}
+{!../../docs_src/bigger_applications/app/internal/admin.py!}
```
Aber wir möchten immer noch ein benutzerdefiniertes `prefix` festlegen, wenn wir den `APIRouter` einbinden, sodass alle seine *Pfadoperationen* mit `/admin` beginnen, wir möchten es mit den `dependencies` sichern, die wir bereits für dieses Projekt haben, und wir möchten `tags` und `responses` hinzufügen.
@@ -476,7 +476,7 @@ Aber wir möchten immer noch ein benutzerdefiniertes `prefix` festlegen, wenn wi
Wir können das alles deklarieren, ohne den ursprünglichen `APIRouter` ändern zu müssen, indem wir diese Parameter an `app.include_router()` übergeben:
```Python hl_lines="14-17" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
Auf diese Weise bleibt der ursprüngliche `APIRouter` unverändert, sodass wir dieselbe `app/internal/admin.py`-Datei weiterhin mit anderen Projekten in der Organisation teilen können.
@@ -499,7 +499,7 @@ Wir können *Pfadoperationen* auch direkt zur `FastAPI`-App hinzufügen.
Hier machen wir es ... nur um zu zeigen, dass wir es können 🤷:
```Python hl_lines="21-23" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
und es wird korrekt funktionieren, zusammen mit allen anderen *Pfadoperationen*, die mit `app.include_router()` hinzugefügt wurden.
diff --git a/docs/de/docs/tutorial/body-fields.md b/docs/de/docs/tutorial/body-fields.md
index 33f7713ee..d22524c67 100644
--- a/docs/de/docs/tutorial/body-fields.md
+++ b/docs/de/docs/tutorial/body-fields.md
@@ -9,7 +9,7 @@ Importieren Sie es zuerst:
//// tab | Python 3.10+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ Importieren Sie es zuerst:
//// tab | Python 3.9+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ Importieren Sie es zuerst:
//// tab | Python 3.8+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an.py!}
+{!> ../../docs_src/body_fields/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="2"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
@@ -71,7 +71,7 @@ Dann können Sie `Field` mit Modellattributen deklarieren:
//// tab | Python 3.10+
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py310.py!}
```
////
@@ -79,7 +79,7 @@ Dann können Sie `Field` mit Modellattributen deklarieren:
//// tab | Python 3.9+
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py39.py!}
```
////
@@ -87,7 +87,7 @@ Dann können Sie `Field` mit Modellattributen deklarieren:
//// tab | Python 3.8+
```Python hl_lines="12-15"
-{!> ../../../docs_src/body_fields/tutorial001_an.py!}
+{!> ../../docs_src/body_fields/tutorial001_an.py!}
```
////
@@ -101,7 +101,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9-12"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
@@ -115,7 +115,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
diff --git a/docs/de/docs/tutorial/body-multiple-params.md b/docs/de/docs/tutorial/body-multiple-params.md
index 977e17671..26ae73ebc 100644
--- a/docs/de/docs/tutorial/body-multiple-params.md
+++ b/docs/de/docs/tutorial/body-multiple-params.md
@@ -11,7 +11,7 @@ Und Sie können auch Body-Parameter als optional kennzeichnen, indem Sie den Def
//// tab | Python 3.10+
```Python hl_lines="18-20"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
```
////
@@ -19,7 +19,7 @@ Und Sie können auch Body-Parameter als optional kennzeichnen, indem Sie den Def
//// tab | Python 3.9+
```Python hl_lines="18-20"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
```
////
@@ -27,7 +27,7 @@ Und Sie können auch Body-Parameter als optional kennzeichnen, indem Sie den Def
//// tab | Python 3.8+
```Python hl_lines="19-21"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an.py!}
```
////
@@ -41,7 +41,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="17-19"
-{!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_py310.py!}
```
////
@@ -55,7 +55,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="19-21"
-{!> ../../../docs_src/body_multiple_params/tutorial001.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001.py!}
```
////
@@ -84,7 +84,7 @@ Aber Sie können auch mehrere Body-Parameter deklarieren, z. B. `item` und `user
//// tab | Python 3.10+
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002_py310.py!}
```
////
@@ -92,7 +92,7 @@ Aber Sie können auch mehrere Body-Parameter deklarieren, z. B. `item` und `user
//// tab | Python 3.8+
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial002.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002.py!}
```
////
@@ -139,7 +139,7 @@ Aber Sie können **FastAPI** instruieren, ihn als weiteren Body-Schlüssel zu er
//// tab | Python 3.10+
```Python hl_lines="23"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
```
////
@@ -147,7 +147,7 @@ Aber Sie können **FastAPI** instruieren, ihn als weiteren Body-Schlüssel zu er
//// tab | Python 3.9+
```Python hl_lines="23"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
```
////
@@ -155,7 +155,7 @@ Aber Sie können **FastAPI** instruieren, ihn als weiteren Body-Schlüssel zu er
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an.py!}
```
////
@@ -169,7 +169,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_py310.py!}
```
////
@@ -183,7 +183,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial003.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003.py!}
```
////
@@ -229,7 +229,7 @@ Zum Beispiel:
//// tab | Python 3.10+
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
```
////
@@ -237,7 +237,7 @@ Zum Beispiel:
//// tab | Python 3.9+
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
```
////
@@ -245,7 +245,7 @@ Zum Beispiel:
//// tab | Python 3.8+
```Python hl_lines="28"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an.py!}
```
////
@@ -259,7 +259,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="25"
-{!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_py310.py!}
```
////
@@ -273,7 +273,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004.py!}
```
////
@@ -301,7 +301,7 @@ so wie in:
//// tab | Python 3.10+
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
```
////
@@ -309,7 +309,7 @@ so wie in:
//// tab | Python 3.9+
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
```
////
@@ -317,7 +317,7 @@ so wie in:
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an.py!}
```
////
@@ -331,7 +331,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="15"
-{!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_py310.py!}
```
////
@@ -345,7 +345,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005.py!}
```
////
diff --git a/docs/de/docs/tutorial/body-nested-models.md b/docs/de/docs/tutorial/body-nested-models.md
index 8aef965f4..13153aa68 100644
--- a/docs/de/docs/tutorial/body-nested-models.md
+++ b/docs/de/docs/tutorial/body-nested-models.md
@@ -9,7 +9,7 @@ Sie können ein Attribut als Kindtyp definieren, zum Beispiel eine Python-`list`
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial001_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial001_py310.py!}
```
////
@@ -17,7 +17,7 @@ Sie können ein Attribut als Kindtyp definieren, zum Beispiel eine Python-`list`
//// tab | Python 3.8+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial001.py!}
+{!> ../../docs_src/body_nested_models/tutorial001.py!}
```
////
@@ -35,7 +35,7 @@ In Python 3.9 oder darüber können Sie einfach `list` verwenden, um diese Typan
In Python-Versionen vor 3.9 (3.6 und darüber), müssen Sie zuerst `List` von Pythons Standardmodul `typing` importieren.
```Python hl_lines="1"
-{!> ../../../docs_src/body_nested_models/tutorial002.py!}
+{!> ../../docs_src/body_nested_models/tutorial002.py!}
```
### Eine `list`e mit einem Typ-Parameter deklarieren
@@ -68,7 +68,7 @@ In unserem Beispiel können wir also bewirken, dass `tags` spezifisch eine „Li
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial002_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial002_py310.py!}
```
////
@@ -76,7 +76,7 @@ In unserem Beispiel können wir also bewirken, dass `tags` spezifisch eine „Li
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial002_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial002_py39.py!}
```
////
@@ -84,7 +84,7 @@ In unserem Beispiel können wir also bewirken, dass `tags` spezifisch eine „Li
//// tab | Python 3.8+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial002.py!}
+{!> ../../docs_src/body_nested_models/tutorial002.py!}
```
////
@@ -100,7 +100,7 @@ Deklarieren wir also `tags` als Set von Strings.
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial003_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial003_py310.py!}
```
////
@@ -108,7 +108,7 @@ Deklarieren wir also `tags` als Set von Strings.
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial003_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial003_py39.py!}
```
////
@@ -116,7 +116,7 @@ Deklarieren wir also `tags` als Set von Strings.
//// tab | Python 3.8+
```Python hl_lines="1 14"
-{!> ../../../docs_src/body_nested_models/tutorial003.py!}
+{!> ../../docs_src/body_nested_models/tutorial003.py!}
```
////
@@ -144,7 +144,7 @@ Wir können zum Beispiel ein `Image`-Modell definieren.
//// tab | Python 3.10+
```Python hl_lines="7-9"
-{!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py310.py!}
```
////
@@ -152,7 +152,7 @@ Wir können zum Beispiel ein `Image`-Modell definieren.
//// tab | Python 3.9+
```Python hl_lines="9-11"
-{!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py39.py!}
```
////
@@ -160,7 +160,7 @@ Wir können zum Beispiel ein `Image`-Modell definieren.
//// tab | Python 3.8+
```Python hl_lines="9-11"
-{!> ../../../docs_src/body_nested_models/tutorial004.py!}
+{!> ../../docs_src/body_nested_models/tutorial004.py!}
```
////
@@ -172,7 +172,7 @@ Und dann können wir es als Typ eines Attributes verwenden.
//// tab | Python 3.10+
```Python hl_lines="18"
-{!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py310.py!}
```
////
@@ -180,7 +180,7 @@ Und dann können wir es als Typ eines Attributes verwenden.
//// tab | Python 3.9+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py39.py!}
```
////
@@ -188,7 +188,7 @@ Und dann können wir es als Typ eines Attributes verwenden.
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial004.py!}
+{!> ../../docs_src/body_nested_models/tutorial004.py!}
```
////
@@ -227,7 +227,7 @@ Da wir zum Beispiel im `Image`-Modell ein Feld `url` haben, können wir deklarie
//// tab | Python 3.10+
```Python hl_lines="2 8"
-{!> ../../../docs_src/body_nested_models/tutorial005_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial005_py310.py!}
```
////
@@ -235,7 +235,7 @@ Da wir zum Beispiel im `Image`-Modell ein Feld `url` haben, können wir deklarie
//// tab | Python 3.9+
```Python hl_lines="4 10"
-{!> ../../../docs_src/body_nested_models/tutorial005_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial005_py39.py!}
```
////
@@ -243,7 +243,7 @@ Da wir zum Beispiel im `Image`-Modell ein Feld `url` haben, können wir deklarie
//// tab | Python 3.8+
```Python hl_lines="4 10"
-{!> ../../../docs_src/body_nested_models/tutorial005.py!}
+{!> ../../docs_src/body_nested_models/tutorial005.py!}
```
////
@@ -257,7 +257,7 @@ Sie können Pydantic-Modelle auch als Typen innerhalb von `list`, `set`, usw. ve
//// tab | Python 3.10+
```Python hl_lines="18"
-{!> ../../../docs_src/body_nested_models/tutorial006_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial006_py310.py!}
```
////
@@ -265,7 +265,7 @@ Sie können Pydantic-Modelle auch als Typen innerhalb von `list`, `set`, usw. ve
//// tab | Python 3.9+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial006_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial006_py39.py!}
```
////
@@ -273,7 +273,7 @@ Sie können Pydantic-Modelle auch als Typen innerhalb von `list`, `set`, usw. ve
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial006.py!}
+{!> ../../docs_src/body_nested_models/tutorial006.py!}
```
////
@@ -317,7 +317,7 @@ Sie können beliebig tief verschachtelte Modelle definieren:
//// tab | Python 3.10+
```Python hl_lines="7 12 18 21 25"
-{!> ../../../docs_src/body_nested_models/tutorial007_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial007_py310.py!}
```
////
@@ -325,7 +325,7 @@ Sie können beliebig tief verschachtelte Modelle definieren:
//// tab | Python 3.9+
```Python hl_lines="9 14 20 23 27"
-{!> ../../../docs_src/body_nested_models/tutorial007_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial007_py39.py!}
```
////
@@ -333,7 +333,7 @@ Sie können beliebig tief verschachtelte Modelle definieren:
//// tab | Python 3.8+
```Python hl_lines="9 14 20 23 27"
-{!> ../../../docs_src/body_nested_models/tutorial007.py!}
+{!> ../../docs_src/body_nested_models/tutorial007.py!}
```
////
@@ -363,7 +363,7 @@ so wie in:
//// tab | Python 3.9+
```Python hl_lines="13"
-{!> ../../../docs_src/body_nested_models/tutorial008_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial008_py39.py!}
```
////
@@ -371,7 +371,7 @@ so wie in:
//// tab | Python 3.8+
```Python hl_lines="15"
-{!> ../../../docs_src/body_nested_models/tutorial008.py!}
+{!> ../../docs_src/body_nested_models/tutorial008.py!}
```
////
@@ -407,7 +407,7 @@ Im folgenden Beispiel akzeptieren Sie irgendein `dict`, solange es `int`-Schlüs
//// tab | Python 3.9+
```Python hl_lines="7"
-{!> ../../../docs_src/body_nested_models/tutorial009_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial009_py39.py!}
```
////
@@ -415,7 +415,7 @@ Im folgenden Beispiel akzeptieren Sie irgendein `dict`, solange es `int`-Schlüs
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/body_nested_models/tutorial009.py!}
+{!> ../../docs_src/body_nested_models/tutorial009.py!}
```
////
diff --git a/docs/de/docs/tutorial/body-updates.md b/docs/de/docs/tutorial/body-updates.md
index b83554914..ed5c1890f 100644
--- a/docs/de/docs/tutorial/body-updates.md
+++ b/docs/de/docs/tutorial/body-updates.md
@@ -9,7 +9,7 @@ Sie können den `jsonable_encoder` verwenden, um die empfangenen Daten in etwas
//// tab | Python 3.10+
```Python hl_lines="28-33"
-{!> ../../../docs_src/body_updates/tutorial001_py310.py!}
+{!> ../../docs_src/body_updates/tutorial001_py310.py!}
```
////
@@ -17,7 +17,7 @@ Sie können den `jsonable_encoder` verwenden, um die empfangenen Daten in etwas
//// tab | Python 3.9+
```Python hl_lines="30-35"
-{!> ../../../docs_src/body_updates/tutorial001_py39.py!}
+{!> ../../docs_src/body_updates/tutorial001_py39.py!}
```
////
@@ -25,7 +25,7 @@ Sie können den `jsonable_encoder` verwenden, um die empfangenen Daten in etwas
//// tab | Python 3.8+
```Python hl_lines="30-35"
-{!> ../../../docs_src/body_updates/tutorial001.py!}
+{!> ../../docs_src/body_updates/tutorial001.py!}
```
////
@@ -87,7 +87,7 @@ Sie können das verwenden, um ein `dict` zu erstellen, das nur die (im Request)
//// tab | Python 3.10+
```Python hl_lines="32"
-{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+{!> ../../docs_src/body_updates/tutorial002_py310.py!}
```
////
@@ -95,7 +95,7 @@ Sie können das verwenden, um ein `dict` zu erstellen, das nur die (im Request)
//// tab | Python 3.9+
```Python hl_lines="34"
-{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+{!> ../../docs_src/body_updates/tutorial002_py39.py!}
```
////
@@ -103,7 +103,7 @@ Sie können das verwenden, um ein `dict` zu erstellen, das nur die (im Request)
//// tab | Python 3.8+
```Python hl_lines="34"
-{!> ../../../docs_src/body_updates/tutorial002.py!}
+{!> ../../docs_src/body_updates/tutorial002.py!}
```
////
@@ -125,7 +125,7 @@ Wie in `stored_item_model.model_copy(update=update_data)`:
//// tab | Python 3.10+
```Python hl_lines="33"
-{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+{!> ../../docs_src/body_updates/tutorial002_py310.py!}
```
////
@@ -133,7 +133,7 @@ Wie in `stored_item_model.model_copy(update=update_data)`:
//// tab | Python 3.9+
```Python hl_lines="35"
-{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+{!> ../../docs_src/body_updates/tutorial002_py39.py!}
```
////
@@ -141,7 +141,7 @@ Wie in `stored_item_model.model_copy(update=update_data)`:
//// tab | Python 3.8+
```Python hl_lines="35"
-{!> ../../../docs_src/body_updates/tutorial002.py!}
+{!> ../../docs_src/body_updates/tutorial002.py!}
```
////
@@ -164,7 +164,7 @@ Zusammengefasst, um Teil-Ersetzungen vorzunehmen:
//// tab | Python 3.10+
```Python hl_lines="28-35"
-{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+{!> ../../docs_src/body_updates/tutorial002_py310.py!}
```
////
@@ -172,7 +172,7 @@ Zusammengefasst, um Teil-Ersetzungen vorzunehmen:
//// tab | Python 3.9+
```Python hl_lines="30-37"
-{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+{!> ../../docs_src/body_updates/tutorial002_py39.py!}
```
////
@@ -180,7 +180,7 @@ Zusammengefasst, um Teil-Ersetzungen vorzunehmen:
//// tab | Python 3.8+
```Python hl_lines="30-37"
-{!> ../../../docs_src/body_updates/tutorial002.py!}
+{!> ../../docs_src/body_updates/tutorial002.py!}
```
////
diff --git a/docs/de/docs/tutorial/body.md b/docs/de/docs/tutorial/body.md
index 3fdd4ade3..3a64e747e 100644
--- a/docs/de/docs/tutorial/body.md
+++ b/docs/de/docs/tutorial/body.md
@@ -25,7 +25,7 @@ Zuerst müssen Sie `BaseModel` von `pydantic` importieren:
//// tab | Python 3.10+
```Python hl_lines="2"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -33,7 +33,7 @@ Zuerst müssen Sie `BaseModel` von `pydantic` importieren:
//// tab | Python 3.8+
```Python hl_lines="4"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -47,7 +47,7 @@ Verwenden Sie Standard-Python-Typen für die Klassenattribute:
//// tab | Python 3.10+
```Python hl_lines="5-9"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -55,7 +55,7 @@ Verwenden Sie Standard-Python-Typen für die Klassenattribute:
//// tab | Python 3.8+
```Python hl_lines="7-11"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -89,7 +89,7 @@ Um es zu Ihrer *Pfadoperation* hinzuzufügen, deklarieren Sie es auf die gleiche
//// tab | Python 3.10+
```Python hl_lines="16"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -97,7 +97,7 @@ Um es zu Ihrer *Pfadoperation* hinzuzufügen, deklarieren Sie es auf die gleiche
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -170,7 +170,7 @@ Innerhalb der Funktion können Sie alle Attribute des Modells direkt verwenden:
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/body/tutorial002_py310.py!}
+{!> ../../docs_src/body/tutorial002_py310.py!}
```
////
@@ -178,7 +178,7 @@ Innerhalb der Funktion können Sie alle Attribute des Modells direkt verwenden:
//// tab | Python 3.8+
```Python hl_lines="21"
-{!> ../../../docs_src/body/tutorial002.py!}
+{!> ../../docs_src/body/tutorial002.py!}
```
////
@@ -192,7 +192,7 @@ Sie können Pfad- und Requestbody-Parameter gleichzeitig deklarieren.
//// tab | Python 3.10+
```Python hl_lines="15-16"
-{!> ../../../docs_src/body/tutorial003_py310.py!}
+{!> ../../docs_src/body/tutorial003_py310.py!}
```
////
@@ -200,7 +200,7 @@ Sie können Pfad- und Requestbody-Parameter gleichzeitig deklarieren.
//// tab | Python 3.8+
```Python hl_lines="17-18"
-{!> ../../../docs_src/body/tutorial003.py!}
+{!> ../../docs_src/body/tutorial003.py!}
```
////
@@ -214,7 +214,7 @@ Sie können auch zur gleichen Zeit **Body-**, **Pfad-** und **Query-Parameter**
//// tab | Python 3.10+
```Python hl_lines="16"
-{!> ../../../docs_src/body/tutorial004_py310.py!}
+{!> ../../docs_src/body/tutorial004_py310.py!}
```
////
@@ -222,7 +222,7 @@ Sie können auch zur gleichen Zeit **Body-**, **Pfad-** und **Query-Parameter**
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/body/tutorial004.py!}
+{!> ../../docs_src/body/tutorial004.py!}
```
////
diff --git a/docs/de/docs/tutorial/cookie-params.md b/docs/de/docs/tutorial/cookie-params.md
index 0060db8e8..4714a59ae 100644
--- a/docs/de/docs/tutorial/cookie-params.md
+++ b/docs/de/docs/tutorial/cookie-params.md
@@ -9,7 +9,7 @@ Importieren Sie zuerst `Cookie`:
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ Importieren Sie zuerst `Cookie`:
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ Importieren Sie zuerst `Cookie`:
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="1"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
@@ -67,7 +67,7 @@ Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra Validierungs
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -75,7 +75,7 @@ Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra Validierungs
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -83,7 +83,7 @@ Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra Validierungs
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -97,7 +97,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -111,7 +111,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
diff --git a/docs/de/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/de/docs/tutorial/dependencies/classes-as-dependencies.md
index 0a9f05bf9..a660ab337 100644
--- a/docs/de/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/de/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -9,7 +9,7 @@ Im vorherigen Beispiel haben wir ein `dict` von unserer Abhängigkeit („Depend
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ Im vorherigen Beispiel haben wir ein `dict` von unserer Abhängigkeit („Depend
//// tab | Python 3.9+
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ Im vorherigen Beispiel haben wir ein `dict` von unserer Abhängigkeit („Depend
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -122,7 +122,7 @@ Dann können wir das „Dependable“ `common_parameters` der Abhängigkeit von
//// tab | Python 3.10+
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py310.py!}
```
////
@@ -130,7 +130,7 @@ Dann können wir das „Dependable“ `common_parameters` der Abhängigkeit von
//// tab | Python 3.9+
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py39.py!}
```
////
@@ -138,7 +138,7 @@ Dann können wir das „Dependable“ `common_parameters` der Abhängigkeit von
//// tab | Python 3.8+
```Python hl_lines="12-16"
-{!> ../../../docs_src/dependencies/tutorial002_an.py!}
+{!> ../../docs_src/dependencies/tutorial002_an.py!}
```
////
@@ -152,7 +152,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9-13"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -166,7 +166,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -176,7 +176,7 @@ Achten Sie auf die Methode `__init__`, die zum Erstellen der Instanz der Klasse
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py310.py!}
```
////
@@ -184,7 +184,7 @@ Achten Sie auf die Methode `__init__`, die zum Erstellen der Instanz der Klasse
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py39.py!}
```
////
@@ -192,7 +192,7 @@ Achten Sie auf die Methode `__init__`, die zum Erstellen der Instanz der Klasse
//// tab | Python 3.8+
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial002_an.py!}
+{!> ../../docs_src/dependencies/tutorial002_an.py!}
```
////
@@ -206,7 +206,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -220,7 +220,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -230,7 +230,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -238,7 +238,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -246,7 +246,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -260,7 +260,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="6"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -274,7 +274,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -296,7 +296,7 @@ Jetzt können Sie Ihre Abhängigkeit mithilfe dieser Klasse deklarieren.
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py310.py!}
```
////
@@ -304,7 +304,7 @@ Jetzt können Sie Ihre Abhängigkeit mithilfe dieser Klasse deklarieren.
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py39.py!}
```
////
@@ -312,7 +312,7 @@ Jetzt können Sie Ihre Abhängigkeit mithilfe dieser Klasse deklarieren.
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial002_an.py!}
+{!> ../../docs_src/dependencies/tutorial002_an.py!}
```
////
@@ -326,7 +326,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -340,7 +340,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -440,7 +440,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial003_an_py310.py!}
```
////
@@ -448,7 +448,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial003_an_py39.py!}
```
////
@@ -456,7 +456,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial003_an.py!}
+{!> ../../docs_src/dependencies/tutorial003_an.py!}
```
////
@@ -470,7 +470,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial003_py310.py!}
+{!> ../../docs_src/dependencies/tutorial003_py310.py!}
```
////
@@ -484,7 +484,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003.py!}
+{!> ../../docs_src/dependencies/tutorial003.py!}
```
////
@@ -578,7 +578,7 @@ Dasselbe Beispiel würde dann so aussehen:
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial004_an_py310.py!}
```
////
@@ -586,7 +586,7 @@ Dasselbe Beispiel würde dann so aussehen:
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial004_an_py39.py!}
```
////
@@ -594,7 +594,7 @@ Dasselbe Beispiel würde dann so aussehen:
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial004_an.py!}
+{!> ../../docs_src/dependencies/tutorial004_an.py!}
```
////
@@ -608,7 +608,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial004_py310.py!}
+{!> ../../docs_src/dependencies/tutorial004_py310.py!}
```
////
@@ -622,7 +622,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004.py!}
+{!> ../../docs_src/dependencies/tutorial004.py!}
```
////
diff --git a/docs/de/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/de/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index 47d6453c2..3bb261e44 100644
--- a/docs/de/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/de/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -17,7 +17,7 @@ Es sollte eine `list`e von `Depends()` sein:
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ Es sollte eine `list`e von `Depends()` sein:
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -39,7 +39,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -75,7 +75,7 @@ Sie können Anforderungen für einen Request (wie Header) oder andere Unterabhä
//// tab | Python 3.9+
```Python hl_lines="8 13"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -83,7 +83,7 @@ Sie können Anforderungen für einen Request (wie Header) oder andere Unterabhä
//// tab | Python 3.8+
```Python hl_lines="7 12"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -97,7 +97,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="6 11"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -109,7 +109,7 @@ Die Abhängigkeiten können Exceptions `raise`n, genau wie normale Abhängigkeit
//// tab | Python 3.9+
```Python hl_lines="10 15"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -117,7 +117,7 @@ Die Abhängigkeiten können Exceptions `raise`n, genau wie normale Abhängigkeit
//// tab | Python 3.8+
```Python hl_lines="9 14"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -131,7 +131,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="8 13"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -145,7 +145,7 @@ Sie können also eine normale Abhängigkeit (die einen Wert zurückgibt), die Si
//// tab | Python 3.9+
```Python hl_lines="11 16"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -153,7 +153,7 @@ Sie können also eine normale Abhängigkeit (die einen Wert zurückgibt), die Si
//// tab | Python 3.8+
```Python hl_lines="10 15"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -167,7 +167,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9 14"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
diff --git a/docs/de/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/de/docs/tutorial/dependencies/dependencies-with-yield.md
index 9c2e6dd86..48b057e28 100644
--- a/docs/de/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/de/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -30,19 +30,19 @@ Sie könnten damit beispielsweise eine Datenbanksession erstellen und diese nach
Nur der Code vor und einschließlich der `yield`-Anweisung wird ausgeführt, bevor eine Response erzeugt wird:
```Python hl_lines="2-4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
Der ge`yield`ete Wert ist das, was in *Pfadoperationen* und andere Abhängigkeiten eingefügt wird:
```Python hl_lines="4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
Der auf die `yield`-Anweisung folgende Code wird ausgeführt, nachdem die Response gesendet wurde:
```Python hl_lines="5-6"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
/// tip | "Tipp"
@@ -64,7 +64,7 @@ Sie können also mit `except SomeException` diese bestimmte Exception innerhalb
Auf die gleiche Weise können Sie `finally` verwenden, um sicherzustellen, dass die Exit-Schritte ausgeführt werden, unabhängig davon, ob eine Exception geworfen wurde oder nicht.
```Python hl_lines="3 5"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
## Unterabhängigkeiten mit `yield`.
@@ -78,7 +78,7 @@ Beispielsweise kann `dependency_c` von `dependency_b` und `dependency_b` von `de
//// tab | Python 3.9+
```Python hl_lines="6 14 22"
-{!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008_an_py39.py!}
```
////
@@ -86,7 +86,7 @@ Beispielsweise kann `dependency_c` von `dependency_b` und `dependency_b` von `de
//// tab | Python 3.8+
```Python hl_lines="5 13 21"
-{!> ../../../docs_src/dependencies/tutorial008_an.py!}
+{!> ../../docs_src/dependencies/tutorial008_an.py!}
```
////
@@ -100,7 +100,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="4 12 20"
-{!> ../../../docs_src/dependencies/tutorial008.py!}
+{!> ../../docs_src/dependencies/tutorial008.py!}
```
////
@@ -114,7 +114,7 @@ Und wiederum benötigt `dependency_b` den Wert von `dependency_a` (hier `dep_a`
//// tab | Python 3.9+
```Python hl_lines="18-19 26-27"
-{!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008_an_py39.py!}
```
////
@@ -122,7 +122,7 @@ Und wiederum benötigt `dependency_b` den Wert von `dependency_a` (hier `dep_a`
//// tab | Python 3.8+
```Python hl_lines="17-18 25-26"
-{!> ../../../docs_src/dependencies/tutorial008_an.py!}
+{!> ../../docs_src/dependencies/tutorial008_an.py!}
```
////
@@ -136,7 +136,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="16-17 24-25"
-{!> ../../../docs_src/dependencies/tutorial008.py!}
+{!> ../../docs_src/dependencies/tutorial008.py!}
```
////
@@ -174,7 +174,7 @@ Aber es ist für Sie da, wenn Sie es brauchen. 🤓
//// tab | Python 3.9+
```Python hl_lines="18-22 31"
-{!> ../../../docs_src/dependencies/tutorial008b_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008b_an_py39.py!}
```
////
@@ -182,7 +182,7 @@ Aber es ist für Sie da, wenn Sie es brauchen. 🤓
//// tab | Python 3.8+
```Python hl_lines="17-21 30"
-{!> ../../../docs_src/dependencies/tutorial008b_an.py!}
+{!> ../../docs_src/dependencies/tutorial008b_an.py!}
```
////
@@ -196,7 +196,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="16-20 29"
-{!> ../../../docs_src/dependencies/tutorial008b.py!}
+{!> ../../docs_src/dependencies/tutorial008b.py!}
```
////
@@ -321,7 +321,7 @@ In Python können Sie Kontextmanager erstellen, indem Sie <a href="https://docs.
Sie können solche auch innerhalb von **FastAPI**-Abhängigkeiten mit `yield` verwenden, indem Sie `with`- oder `async with`-Anweisungen innerhalb der Abhängigkeits-Funktion verwenden:
```Python hl_lines="1-9 13"
-{!../../../docs_src/dependencies/tutorial010.py!}
+{!../../docs_src/dependencies/tutorial010.py!}
```
/// tip | "Tipp"
diff --git a/docs/de/docs/tutorial/dependencies/global-dependencies.md b/docs/de/docs/tutorial/dependencies/global-dependencies.md
index 26e631b1c..6b9e9e395 100644
--- a/docs/de/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/de/docs/tutorial/dependencies/global-dependencies.md
@@ -9,7 +9,7 @@ In diesem Fall werden sie auf alle *Pfadoperationen* in der Anwendung angewendet
//// tab | Python 3.9+
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial012_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial012_an_py39.py!}
```
////
@@ -17,7 +17,7 @@ In diesem Fall werden sie auf alle *Pfadoperationen* in der Anwendung angewendet
//// tab | Python 3.8+
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial012_an.py!}
+{!> ../../docs_src/dependencies/tutorial012_an.py!}
```
////
@@ -31,7 +31,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="15"
-{!> ../../../docs_src/dependencies/tutorial012.py!}
+{!> ../../docs_src/dependencies/tutorial012.py!}
```
////
diff --git a/docs/de/docs/tutorial/dependencies/index.md b/docs/de/docs/tutorial/dependencies/index.md
index f7d9ed510..494708d19 100644
--- a/docs/de/docs/tutorial/dependencies/index.md
+++ b/docs/de/docs/tutorial/dependencies/index.md
@@ -33,7 +33,7 @@ Es handelt sich einfach um eine Funktion, die die gleichen Parameter entgegennim
//// tab | Python 3.10+
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -41,7 +41,7 @@ Es handelt sich einfach um eine Funktion, die die gleichen Parameter entgegennim
//// tab | Python 3.9+
```Python hl_lines="8-11"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -49,7 +49,7 @@ Es handelt sich einfach um eine Funktion, die die gleichen Parameter entgegennim
//// tab | Python 3.8+
```Python hl_lines="9-12"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -63,7 +63,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="6-7"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -77,7 +77,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="8-11"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -115,7 +115,7 @@ Bitte [aktualisieren Sie FastAPI](../../deployment/versions.md#upgrade-der-fasta
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -123,7 +123,7 @@ Bitte [aktualisieren Sie FastAPI](../../deployment/versions.md#upgrade-der-fasta
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -131,7 +131,7 @@ Bitte [aktualisieren Sie FastAPI](../../deployment/versions.md#upgrade-der-fasta
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -145,7 +145,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="1"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -159,7 +159,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -171,7 +171,7 @@ So wie auch `Body`, `Query`, usw., verwenden Sie `Depends` mit den Parametern Ih
//// tab | Python 3.10+
```Python hl_lines="13 18"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -179,7 +179,7 @@ So wie auch `Body`, `Query`, usw., verwenden Sie `Depends` mit den Parametern Ih
//// tab | Python 3.9+
```Python hl_lines="15 20"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -187,7 +187,7 @@ So wie auch `Body`, `Query`, usw., verwenden Sie `Depends` mit den Parametern Ih
//// tab | Python 3.8+
```Python hl_lines="16 21"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -201,7 +201,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="11 16"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -215,7 +215,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="15 20"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -278,7 +278,7 @@ Da wir jedoch `Annotated` verwenden, können wir diesen `Annotated`-Wert in eine
//// tab | Python 3.10+
```Python hl_lines="12 16 21"
-{!> ../../../docs_src/dependencies/tutorial001_02_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an_py310.py!}
```
////
@@ -286,7 +286,7 @@ Da wir jedoch `Annotated` verwenden, können wir diesen `Annotated`-Wert in eine
//// tab | Python 3.9+
```Python hl_lines="14 18 23"
-{!> ../../../docs_src/dependencies/tutorial001_02_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an_py39.py!}
```
////
@@ -294,7 +294,7 @@ Da wir jedoch `Annotated` verwenden, können wir diesen `Annotated`-Wert in eine
//// tab | Python 3.8+
```Python hl_lines="15 19 24"
-{!> ../../../docs_src/dependencies/tutorial001_02_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an.py!}
```
////
diff --git a/docs/de/docs/tutorial/dependencies/sub-dependencies.md b/docs/de/docs/tutorial/dependencies/sub-dependencies.md
index 12664a8cd..a20aed63b 100644
--- a/docs/de/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/de/docs/tutorial/dependencies/sub-dependencies.md
@@ -13,7 +13,7 @@ Sie könnten eine erste Abhängigkeit („Dependable“) wie folgt erstellen:
//// tab | Python 3.10+
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial005_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
```
////
@@ -21,7 +21,7 @@ Sie könnten eine erste Abhängigkeit („Dependable“) wie folgt erstellen:
//// tab | Python 3.9+
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
```
////
@@ -29,7 +29,7 @@ Sie könnten eine erste Abhängigkeit („Dependable“) wie folgt erstellen:
//// tab | Python 3.8+
```Python hl_lines="9-10"
-{!> ../../../docs_src/dependencies/tutorial005_an.py!}
+{!> ../../docs_src/dependencies/tutorial005_an.py!}
```
////
@@ -43,7 +43,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="6-7"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -57,7 +57,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
@@ -73,7 +73,7 @@ Dann können Sie eine weitere Abhängigkeitsfunktion (ein „Dependable“) erst
//// tab | Python 3.10+
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial005_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
```
////
@@ -81,7 +81,7 @@ Dann können Sie eine weitere Abhängigkeitsfunktion (ein „Dependable“) erst
//// tab | Python 3.9+
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
```
////
@@ -89,7 +89,7 @@ Dann können Sie eine weitere Abhängigkeitsfunktion (ein „Dependable“) erst
//// tab | Python 3.8+
```Python hl_lines="14"
-{!> ../../../docs_src/dependencies/tutorial005_an.py!}
+{!> ../../docs_src/dependencies/tutorial005_an.py!}
```
////
@@ -103,7 +103,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -117,7 +117,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
@@ -136,7 +136,7 @@ Diese Abhängigkeit verwenden wir nun wie folgt:
//// tab | Python 3.10+
```Python hl_lines="23"
-{!> ../../../docs_src/dependencies/tutorial005_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
```
////
@@ -144,7 +144,7 @@ Diese Abhängigkeit verwenden wir nun wie folgt:
//// tab | Python 3.9+
```Python hl_lines="23"
-{!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
```
////
@@ -152,7 +152,7 @@ Diese Abhängigkeit verwenden wir nun wie folgt:
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/dependencies/tutorial005_an.py!}
+{!> ../../docs_src/dependencies/tutorial005_an.py!}
```
////
@@ -166,7 +166,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -180,7 +180,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="22"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
diff --git a/docs/de/docs/tutorial/encoder.md b/docs/de/docs/tutorial/encoder.md
index 38a881b4f..0ab72b8dd 100644
--- a/docs/de/docs/tutorial/encoder.md
+++ b/docs/de/docs/tutorial/encoder.md
@@ -23,7 +23,7 @@ Es nimmt ein Objekt entgegen, wie etwa ein Pydantic-Modell, und gibt eine JSON-k
//// tab | Python 3.10+
```Python hl_lines="4 21"
-{!> ../../../docs_src/encoder/tutorial001_py310.py!}
+{!> ../../docs_src/encoder/tutorial001_py310.py!}
```
////
@@ -31,7 +31,7 @@ Es nimmt ein Objekt entgegen, wie etwa ein Pydantic-Modell, und gibt eine JSON-k
//// tab | Python 3.8+
```Python hl_lines="5 22"
-{!> ../../../docs_src/encoder/tutorial001.py!}
+{!> ../../docs_src/encoder/tutorial001.py!}
```
////
diff --git a/docs/de/docs/tutorial/extra-data-types.md b/docs/de/docs/tutorial/extra-data-types.md
index 334a232a8..7581b4f87 100644
--- a/docs/de/docs/tutorial/extra-data-types.md
+++ b/docs/de/docs/tutorial/extra-data-types.md
@@ -58,7 +58,7 @@ Hier ist ein Beispiel für eine *Pfadoperation* mit Parametern, die einige der o
//// tab | Python 3.10+
```Python hl_lines="1 3 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py310.py!}
```
////
@@ -66,7 +66,7 @@ Hier ist ein Beispiel für eine *Pfadoperation* mit Parametern, die einige der o
//// tab | Python 3.9+
```Python hl_lines="1 3 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py39.py!}
```
////
@@ -74,7 +74,7 @@ Hier ist ein Beispiel für eine *Pfadoperation* mit Parametern, die einige der o
//// tab | Python 3.8+
```Python hl_lines="1 3 13-17"
-{!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an.py!}
```
////
@@ -88,7 +88,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="1 2 11-15"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
@@ -102,7 +102,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="1 2 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
@@ -112,7 +112,7 @@ Beachten Sie, dass die Parameter innerhalb der Funktion ihren natürlichen Daten
//// tab | Python 3.10+
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py310.py!}
```
////
@@ -120,7 +120,7 @@ Beachten Sie, dass die Parameter innerhalb der Funktion ihren natürlichen Daten
//// tab | Python 3.9+
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py39.py!}
```
////
@@ -128,7 +128,7 @@ Beachten Sie, dass die Parameter innerhalb der Funktion ihren natürlichen Daten
//// tab | Python 3.8+
```Python hl_lines="19-20"
-{!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an.py!}
```
////
@@ -142,7 +142,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="17-18"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
@@ -156,7 +156,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
diff --git a/docs/de/docs/tutorial/extra-models.md b/docs/de/docs/tutorial/extra-models.md
index cfd0230eb..14e842065 100644
--- a/docs/de/docs/tutorial/extra-models.md
+++ b/docs/de/docs/tutorial/extra-models.md
@@ -23,7 +23,7 @@ Hier der generelle Weg, wie die Modelle mit ihren Passwort-Feldern aussehen kön
//// tab | Python 3.10+
```Python hl_lines="7 9 14 20 22 27-28 31-33 38-39"
-{!> ../../../docs_src/extra_models/tutorial001_py310.py!}
+{!> ../../docs_src/extra_models/tutorial001_py310.py!}
```
////
@@ -31,7 +31,7 @@ Hier der generelle Weg, wie die Modelle mit ihren Passwort-Feldern aussehen kön
//// tab | Python 3.8+
```Python hl_lines="9 11 16 22 24 29-30 33-35 40-41"
-{!> ../../../docs_src/extra_models/tutorial001.py!}
+{!> ../../docs_src/extra_models/tutorial001.py!}
```
////
@@ -179,7 +179,7 @@ Auf diese Weise beschreiben wir nur noch die Unterschiede zwischen den Modellen
//// tab | Python 3.10+
```Python hl_lines="7 13-14 17-18 21-22"
-{!> ../../../docs_src/extra_models/tutorial002_py310.py!}
+{!> ../../docs_src/extra_models/tutorial002_py310.py!}
```
////
@@ -187,7 +187,7 @@ Auf diese Weise beschreiben wir nur noch die Unterschiede zwischen den Modellen
//// tab | Python 3.8+
```Python hl_lines="9 15-16 19-20 23-24"
-{!> ../../../docs_src/extra_models/tutorial002.py!}
+{!> ../../docs_src/extra_models/tutorial002.py!}
```
////
@@ -209,7 +209,7 @@ Listen Sie, wenn Sie eine <a href="https://pydantic-docs.helpmanual.io/usage/typ
//// tab | Python 3.10+
```Python hl_lines="1 14-15 18-20 33"
-{!> ../../../docs_src/extra_models/tutorial003_py310.py!}
+{!> ../../docs_src/extra_models/tutorial003_py310.py!}
```
////
@@ -217,7 +217,7 @@ Listen Sie, wenn Sie eine <a href="https://pydantic-docs.helpmanual.io/usage/typ
//// tab | Python 3.8+
```Python hl_lines="1 14-15 18-20 33"
-{!> ../../../docs_src/extra_models/tutorial003.py!}
+{!> ../../docs_src/extra_models/tutorial003.py!}
```
////
@@ -245,7 +245,7 @@ Verwenden Sie dafür Pythons Standard `typing.List` (oder nur `list` in Python 3
//// tab | Python 3.9+
```Python hl_lines="18"
-{!> ../../../docs_src/extra_models/tutorial004_py39.py!}
+{!> ../../docs_src/extra_models/tutorial004_py39.py!}
```
////
@@ -253,7 +253,7 @@ Verwenden Sie dafür Pythons Standard `typing.List` (oder nur `list` in Python 3
//// tab | Python 3.8+
```Python hl_lines="1 20"
-{!> ../../../docs_src/extra_models/tutorial004.py!}
+{!> ../../docs_src/extra_models/tutorial004.py!}
```
////
@@ -269,7 +269,7 @@ In diesem Fall können Sie `typing.Dict` verwenden (oder nur `dict` in Python 3.
//// tab | Python 3.9+
```Python hl_lines="6"
-{!> ../../../docs_src/extra_models/tutorial005_py39.py!}
+{!> ../../docs_src/extra_models/tutorial005_py39.py!}
```
////
@@ -277,7 +277,7 @@ In diesem Fall können Sie `typing.Dict` verwenden (oder nur `dict` in Python 3.
//// tab | Python 3.8+
```Python hl_lines="1 8"
-{!> ../../../docs_src/extra_models/tutorial005.py!}
+{!> ../../docs_src/extra_models/tutorial005.py!}
```
////
diff --git a/docs/de/docs/tutorial/first-steps.md b/docs/de/docs/tutorial/first-steps.md
index b9e38707c..fe3886b70 100644
--- a/docs/de/docs/tutorial/first-steps.md
+++ b/docs/de/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
Die einfachste FastAPI-Datei könnte wie folgt aussehen:
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Kopieren Sie dies in eine Datei `main.py`.
@@ -134,7 +134,7 @@ Ebenfalls können Sie es verwenden, um automatisch Code für Clients zu generier
### Schritt 1: Importieren von `FastAPI`
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI` ist eine Python-Klasse, die die gesamte Funktionalität für Ihre API bereitstellt.
@@ -150,7 +150,7 @@ Sie können alle <a href="https://www.starlette.io/" class="external-link" targe
### Schritt 2: Erzeugen einer `FastAPI`-„Instanz“
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
In diesem Beispiel ist die Variable `app` eine „Instanz“ der Klasse `FastAPI`.
@@ -172,7 +172,7 @@ $ uvicorn main:app --reload
Wenn Sie Ihre Anwendung wie folgt erstellen:
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial002.py!}
+{!../../docs_src/first_steps/tutorial002.py!}
```
Und in eine Datei `main.py` einfügen, dann würden Sie `uvicorn` wie folgt aufrufen:
@@ -251,7 +251,7 @@ Wir werden sie auch „**Operationen**“ nennen.
#### Definieren eines *Pfadoperation-Dekorators*
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Das `@app.get("/")` sagt **FastAPI**, dass die Funktion direkt darunter für die Bearbeitung von Anfragen zuständig ist, die an:
@@ -307,7 +307,7 @@ Das ist unsere „**Pfadoperation-Funktion**“:
* **Funktion**: ist die Funktion direkt unter dem „Dekorator“ (unter `@app.get("/")`).
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Dies ist eine Python-Funktion.
@@ -321,7 +321,7 @@ In diesem Fall handelt es sich um eine `async`-Funktion.
Sie könnten sie auch als normale Funktion anstelle von `async def` definieren:
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note | "Hinweis"
@@ -333,7 +333,7 @@ Wenn Sie den Unterschied nicht kennen, lesen Sie [Async: *„In Eile?“*](../as
### Schritt 5: den Inhalt zurückgeben
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Sie können ein `dict`, eine `list`, einzelne Werte wie `str`, `int`, usw. zurückgeben.
diff --git a/docs/de/docs/tutorial/handling-errors.md b/docs/de/docs/tutorial/handling-errors.md
index 6ee47948c..70dc0c523 100644
--- a/docs/de/docs/tutorial/handling-errors.md
+++ b/docs/de/docs/tutorial/handling-errors.md
@@ -26,7 +26,7 @@ Um HTTP-Responses mit Fehlern zum Client zurückzugeben, verwenden Sie `HTTPExce
### `HTTPException` importieren
```Python hl_lines="1"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
### Eine `HTTPException` in Ihrem Code auslösen
@@ -42,7 +42,7 @@ Der Vorteil, eine Exception auszulösen (`raise`), statt sie zurückzugeben (`re
Im folgenden Beispiel lösen wir, wenn der Client eine ID anfragt, die nicht existiert, eine Exception mit dem Statuscode `404` aus.
```Python hl_lines="11"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
### Die resultierende Response
@@ -82,7 +82,7 @@ Sie müssen das wahrscheinlich nicht direkt in ihrem Code verwenden.
Aber falls es in einem fortgeschrittenen Szenario notwendig ist, können Sie benutzerdefinierte Header wie folgt hinzufügen:
```Python hl_lines="14"
-{!../../../docs_src/handling_errors/tutorial002.py!}
+{!../../docs_src/handling_errors/tutorial002.py!}
```
## Benutzerdefinierte Exceptionhandler definieren
@@ -96,7 +96,7 @@ Und Sie möchten diese Exception global mit FastAPI handhaben.
Sie könnten einen benutzerdefinierten Exceptionhandler mittels `@app.exception_handler()` hinzufügen:
```Python hl_lines="5-7 13-18 24"
-{!../../../docs_src/handling_errors/tutorial003.py!}
+{!../../docs_src/handling_errors/tutorial003.py!}
```
Wenn Sie nun `/unicorns/yolo` anfragen, `raise`d die *Pfadoperation* eine `UnicornException`.
@@ -136,7 +136,7 @@ Um diesen zu überschreiben, importieren Sie den `RequestValidationError` und ve
Der Exceptionhandler wird einen `Request` und die Exception entgegennehmen.
```Python hl_lines="2 14-16"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
Wenn Sie nun `/items/foo` besuchen, erhalten Sie statt des Default-JSON-Errors:
@@ -189,7 +189,7 @@ Genauso können Sie den `HTTPException`-Handler überschreiben.
Zum Beispiel könnten Sie eine Klartext-Response statt JSON für diese Fehler zurückgeben wollen:
```Python hl_lines="3-4 9-11 22"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
/// note | "Technische Details"
@@ -207,7 +207,7 @@ Der `RequestValidationError` enthält den empfangenen `body` mit den ungültigen
Sie könnten diesen verwenden, während Sie Ihre Anwendung entwickeln, um den Body zu loggen und zu debuggen, ihn zum Benutzer zurückzugeben, usw.
```Python hl_lines="14"
-{!../../../docs_src/handling_errors/tutorial005.py!}
+{!../../docs_src/handling_errors/tutorial005.py!}
```
Jetzt versuchen Sie, einen ungültigen Artikel zu senden:
@@ -265,7 +265,7 @@ from starlette.exceptions import HTTPException as StarletteHTTPException
Wenn Sie die Exception zusammen mit denselben Default-Exceptionhandlern von **FastAPI** verwenden möchten, können Sie die Default-Exceptionhandler von `fastapi.Exception_handlers` importieren und wiederverwenden:
```Python hl_lines="2-5 15 21"
-{!../../../docs_src/handling_errors/tutorial006.py!}
+{!../../docs_src/handling_errors/tutorial006.py!}
```
In diesem Beispiel `print`en Sie nur den Fehler mit einer sehr ausdrucksstarken Nachricht, aber Sie sehen, worauf wir hinauswollen. Sie können mit der Exception etwas machen und dann einfach die Default-Exceptionhandler wiederverwenden.
diff --git a/docs/de/docs/tutorial/header-params.md b/docs/de/docs/tutorial/header-params.md
index c8c3a4c57..c4901c2ee 100644
--- a/docs/de/docs/tutorial/header-params.md
+++ b/docs/de/docs/tutorial/header-params.md
@@ -9,7 +9,7 @@ Importieren Sie zuerst `Header`:
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ Importieren Sie zuerst `Header`:
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ Importieren Sie zuerst `Header`:
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001_an.py!}
+{!> ../../docs_src/header_params/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="1"
-{!> ../../../docs_src/header_params/tutorial001_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001.py!}
+{!> ../../docs_src/header_params/tutorial001.py!}
```
////
@@ -67,7 +67,7 @@ Der erste Wert ist der Typ. Sie können `Header` die gehabten Extra Validierungs
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py310.py!}
```
////
@@ -75,7 +75,7 @@ Der erste Wert ist der Typ. Sie können `Header` die gehabten Extra Validierungs
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py39.py!}
```
////
@@ -83,7 +83,7 @@ Der erste Wert ist der Typ. Sie können `Header` die gehabten Extra Validierungs
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial001_an.py!}
+{!> ../../docs_src/header_params/tutorial001_an.py!}
```
////
@@ -97,7 +97,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/header_params/tutorial001_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_py310.py!}
```
////
@@ -111,7 +111,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001.py!}
+{!> ../../docs_src/header_params/tutorial001.py!}
```
////
@@ -149,7 +149,7 @@ Wenn Sie aus irgendeinem Grund das automatische Konvertieren von Unterstrichen z
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial002_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial002_an_py310.py!}
```
////
@@ -157,7 +157,7 @@ Wenn Sie aus irgendeinem Grund das automatische Konvertieren von Unterstrichen z
//// tab | Python 3.9+
```Python hl_lines="11"
-{!> ../../../docs_src/header_params/tutorial002_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial002_an_py39.py!}
```
////
@@ -165,7 +165,7 @@ Wenn Sie aus irgendeinem Grund das automatische Konvertieren von Unterstrichen z
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/header_params/tutorial002_an.py!}
+{!> ../../docs_src/header_params/tutorial002_an.py!}
```
////
@@ -179,7 +179,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="8"
-{!> ../../../docs_src/header_params/tutorial002_py310.py!}
+{!> ../../docs_src/header_params/tutorial002_py310.py!}
```
////
@@ -193,7 +193,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial002.py!}
+{!> ../../docs_src/header_params/tutorial002.py!}
```
////
@@ -217,7 +217,7 @@ Um zum Beispiel einen Header `X-Token` zu deklarieren, der mehrmals vorkommen ka
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial003_an_py310.py!}
```
////
@@ -225,7 +225,7 @@ Um zum Beispiel einen Header `X-Token` zu deklarieren, der mehrmals vorkommen ka
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial003_an_py39.py!}
```
////
@@ -233,7 +233,7 @@ Um zum Beispiel einen Header `X-Token` zu deklarieren, der mehrmals vorkommen ka
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial003_an.py!}
+{!> ../../docs_src/header_params/tutorial003_an.py!}
```
////
@@ -247,7 +247,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/header_params/tutorial003_py310.py!}
+{!> ../../docs_src/header_params/tutorial003_py310.py!}
```
////
@@ -261,7 +261,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_py39.py!}
+{!> ../../docs_src/header_params/tutorial003_py39.py!}
```
////
@@ -275,7 +275,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003.py!}
+{!> ../../docs_src/header_params/tutorial003.py!}
```
////
diff --git a/docs/de/docs/tutorial/metadata.md b/docs/de/docs/tutorial/metadata.md
index 3ab56ff3e..98724e1e8 100644
--- a/docs/de/docs/tutorial/metadata.md
+++ b/docs/de/docs/tutorial/metadata.md
@@ -19,7 +19,7 @@ Sie können die folgenden Felder festlegen, welche in der OpenAPI-Spezifikation
Sie können diese wie folgt setzen:
```Python hl_lines="3-16 19-32"
-{!../../../docs_src/metadata/tutorial001.py!}
+{!../../docs_src/metadata/tutorial001.py!}
```
/// tip | "Tipp"
@@ -39,7 +39,7 @@ Seit OpenAPI 3.1.0 und FastAPI 0.99.0 können Sie die `license_info` auch mit ei
Zum Beispiel:
```Python hl_lines="31"
-{!../../../docs_src/metadata/tutorial001_1.py!}
+{!../../docs_src/metadata/tutorial001_1.py!}
```
## Metadaten für Tags
@@ -63,7 +63,7 @@ Versuchen wir das an einem Beispiel mit Tags für `users` und `items`.
Erstellen Sie Metadaten für Ihre Tags und übergeben Sie sie an den Parameter `openapi_tags`:
```Python hl_lines="3-16 18"
-{!../../../docs_src/metadata/tutorial004.py!}
+{!../../docs_src/metadata/tutorial004.py!}
```
Beachten Sie, dass Sie Markdown in den Beschreibungen verwenden können. Beispielsweise wird „login“ in Fettschrift (**login**) und „fancy“ in Kursivschrift (_fancy_) angezeigt.
@@ -79,7 +79,7 @@ Sie müssen nicht für alle von Ihnen verwendeten Tags Metadaten hinzufügen.
Verwenden Sie den Parameter `tags` mit Ihren *Pfadoperationen* (und `APIRouter`n), um diese verschiedenen Tags zuzuweisen:
```Python hl_lines="21 26"
-{!../../../docs_src/metadata/tutorial004.py!}
+{!../../docs_src/metadata/tutorial004.py!}
```
/// info
@@ -109,7 +109,7 @@ Sie können das aber mit dem Parameter `openapi_url` konfigurieren.
Um beispielsweise festzulegen, dass es unter `/api/v1/openapi.json` bereitgestellt wird:
```Python hl_lines="3"
-{!../../../docs_src/metadata/tutorial002.py!}
+{!../../docs_src/metadata/tutorial002.py!}
```
Wenn Sie das OpenAPI-Schema vollständig deaktivieren möchten, können Sie `openapi_url=None` festlegen, wodurch auch die Dokumentationsbenutzeroberflächen deaktiviert werden, die es verwenden.
@@ -128,5 +128,5 @@ Sie können die beiden enthaltenen Dokumentationsbenutzeroberflächen konfigurie
Um beispielsweise Swagger UI so einzustellen, dass sie unter `/documentation` bereitgestellt wird, und ReDoc zu deaktivieren:
```Python hl_lines="3"
-{!../../../docs_src/metadata/tutorial003.py!}
+{!../../docs_src/metadata/tutorial003.py!}
```
diff --git a/docs/de/docs/tutorial/middleware.md b/docs/de/docs/tutorial/middleware.md
index 62a0d1613..410dc0247 100644
--- a/docs/de/docs/tutorial/middleware.md
+++ b/docs/de/docs/tutorial/middleware.md
@@ -32,7 +32,7 @@ Die Middleware-Funktion erhält:
* Sie können die `response` dann weiter modifizieren, bevor Sie sie zurückgeben.
```Python hl_lines="8-9 11 14"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
/// tip | "Tipp"
@@ -60,7 +60,7 @@ Und auch nachdem die `response` generiert wurde, bevor sie zurückgegeben wird.
Sie könnten beispielsweise einen benutzerdefinierten Header `X-Process-Time` hinzufügen, der die Zeit in Sekunden enthält, die benötigt wurde, um den Request zu verarbeiten und eine Response zu generieren:
```Python hl_lines="10 12-13"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
## Andere Middlewares
diff --git a/docs/de/docs/tutorial/path-operation-configuration.md b/docs/de/docs/tutorial/path-operation-configuration.md
index 03980b7dd..411916e9c 100644
--- a/docs/de/docs/tutorial/path-operation-configuration.md
+++ b/docs/de/docs/tutorial/path-operation-configuration.md
@@ -19,7 +19,7 @@ Aber falls Sie sich nicht mehr erinnern, wofür jede Nummer steht, können Sie d
//// tab | Python 3.10+
```Python hl_lines="1 15"
-{!> ../../../docs_src/path_operation_configuration/tutorial001_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001_py310.py!}
```
////
@@ -27,7 +27,7 @@ Aber falls Sie sich nicht mehr erinnern, wofür jede Nummer steht, können Sie d
//// tab | Python 3.9+
```Python hl_lines="3 17"
-{!> ../../../docs_src/path_operation_configuration/tutorial001_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001_py39.py!}
```
////
@@ -35,7 +35,7 @@ Aber falls Sie sich nicht mehr erinnern, wofür jede Nummer steht, können Sie d
//// tab | Python 3.8+
```Python hl_lines="3 17"
-{!> ../../../docs_src/path_operation_configuration/tutorial001.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001.py!}
```
////
@@ -57,7 +57,7 @@ Sie können Ihrer *Pfadoperation* Tags hinzufügen, mittels des Parameters `tags
//// tab | Python 3.10+
```Python hl_lines="15 20 25"
-{!> ../../../docs_src/path_operation_configuration/tutorial002_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002_py310.py!}
```
////
@@ -65,7 +65,7 @@ Sie können Ihrer *Pfadoperation* Tags hinzufügen, mittels des Parameters `tags
//// tab | Python 3.9+
```Python hl_lines="17 22 27"
-{!> ../../../docs_src/path_operation_configuration/tutorial002_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002_py39.py!}
```
////
@@ -73,7 +73,7 @@ Sie können Ihrer *Pfadoperation* Tags hinzufügen, mittels des Parameters `tags
//// tab | Python 3.8+
```Python hl_lines="17 22 27"
-{!> ../../../docs_src/path_operation_configuration/tutorial002.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002.py!}
```
////
@@ -91,7 +91,7 @@ In diesem Fall macht es Sinn, die Tags in einem `Enum` zu speichern.
**FastAPI** unterstützt diese genauso wie einfache Strings:
```Python hl_lines="1 8-10 13 18"
-{!../../../docs_src/path_operation_configuration/tutorial002b.py!}
+{!../../docs_src/path_operation_configuration/tutorial002b.py!}
```
## Zusammenfassung und Beschreibung
@@ -101,7 +101,7 @@ Sie können eine Zusammenfassung (`summary`) und eine Beschreibung (`description
//// tab | Python 3.10+
```Python hl_lines="18-19"
-{!> ../../../docs_src/path_operation_configuration/tutorial003_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003_py310.py!}
```
////
@@ -109,7 +109,7 @@ Sie können eine Zusammenfassung (`summary`) und eine Beschreibung (`description
//// tab | Python 3.9+
```Python hl_lines="20-21"
-{!> ../../../docs_src/path_operation_configuration/tutorial003_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003_py39.py!}
```
////
@@ -117,7 +117,7 @@ Sie können eine Zusammenfassung (`summary`) und eine Beschreibung (`description
//// tab | Python 3.8+
```Python hl_lines="20-21"
-{!> ../../../docs_src/path_operation_configuration/tutorial003.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003.py!}
```
////
@@ -131,7 +131,7 @@ Sie können im Docstring <a href="https://en.wikipedia.org/wiki/Markdown" class=
//// tab | Python 3.10+
```Python hl_lines="17-25"
-{!> ../../../docs_src/path_operation_configuration/tutorial004_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004_py310.py!}
```
////
@@ -139,7 +139,7 @@ Sie können im Docstring <a href="https://en.wikipedia.org/wiki/Markdown" class=
//// tab | Python 3.9+
```Python hl_lines="19-27"
-{!> ../../../docs_src/path_operation_configuration/tutorial004_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004_py39.py!}
```
////
@@ -147,7 +147,7 @@ Sie können im Docstring <a href="https://en.wikipedia.org/wiki/Markdown" class=
//// tab | Python 3.8+
```Python hl_lines="19-27"
-{!> ../../../docs_src/path_operation_configuration/tutorial004.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004.py!}
```
////
@@ -163,7 +163,7 @@ Die Response können Sie mit dem Parameter `response_description` beschreiben:
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/path_operation_configuration/tutorial005_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005_py310.py!}
```
////
@@ -171,7 +171,7 @@ Die Response können Sie mit dem Parameter `response_description` beschreiben:
//// tab | Python 3.9+
```Python hl_lines="21"
-{!> ../../../docs_src/path_operation_configuration/tutorial005_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005_py39.py!}
```
////
@@ -179,7 +179,7 @@ Die Response können Sie mit dem Parameter `response_description` beschreiben:
//// tab | Python 3.8+
```Python hl_lines="21"
-{!> ../../../docs_src/path_operation_configuration/tutorial005.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005.py!}
```
////
@@ -205,7 +205,7 @@ Daher, wenn Sie keine vergeben, wird **FastAPI** automatisch eine für „Erfolg
Wenn Sie eine *Pfadoperation* als <abbr title="deprecated – obsolet, veraltet: Es soll nicht mehr verwendet werden">deprecated</abbr> kennzeichnen möchten, ohne sie zu entfernen, fügen Sie den Parameter `deprecated` hinzu:
```Python hl_lines="16"
-{!../../../docs_src/path_operation_configuration/tutorial006.py!}
+{!../../docs_src/path_operation_configuration/tutorial006.py!}
```
Sie wird in der interaktiven Dokumentation gut sichtbar als deprecated markiert werden:
diff --git a/docs/de/docs/tutorial/path-params-numeric-validations.md b/docs/de/docs/tutorial/path-params-numeric-validations.md
index 3908a0b2d..fc2d5dff1 100644
--- a/docs/de/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/de/docs/tutorial/path-params-numeric-validations.md
@@ -9,7 +9,7 @@ Importieren Sie zuerst `Path` von `fastapi`, und importieren Sie `Annotated`.
//// tab | Python 3.10+
```Python hl_lines="1 3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ Importieren Sie zuerst `Path` von `fastapi`, und importieren Sie `Annotated`.
//// tab | Python 3.9+
```Python hl_lines="1 3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ Importieren Sie zuerst `Path` von `fastapi`, und importieren Sie `Annotated`.
//// tab | Python 3.8+
```Python hl_lines="3-4"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="1"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -77,7 +77,7 @@ Um zum Beispiel einen `title`-Metadaten-Wert für den Pfad-Parameter `item_id` z
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
```
////
@@ -85,7 +85,7 @@ Um zum Beispiel einen `title`-Metadaten-Wert für den Pfad-Parameter `item_id` z
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
```
////
@@ -93,7 +93,7 @@ Um zum Beispiel einen `title`-Metadaten-Wert für den Pfad-Parameter `item_id` z
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
```
////
@@ -107,7 +107,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="8"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -121,7 +121,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -167,7 +167,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial002.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial002.py!}
```
////
@@ -177,7 +177,7 @@ Aber bedenken Sie, dass Sie dieses Problem nicht haben, wenn Sie `Annotated` ver
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
```
////
@@ -185,7 +185,7 @@ Aber bedenken Sie, dass Sie dieses Problem nicht haben, wenn Sie `Annotated` ver
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
```
////
@@ -214,7 +214,7 @@ Wenn Sie eines der folgenden Dinge tun möchten:
Python macht nichts mit diesem `*`, aber es wird wissen, dass alle folgenden Parameter als <abbr title="Keyword-Argument – Schlüsselwort-Argument: Das Argument wird anhand seines Namens erkannt, nicht anhand seiner Reihenfolge in der Argumentliste">Keyword-Argumente</abbr> (Schlüssel-Wert-Paare), auch bekannt als <abbr title="Von: K-ey W-ord Arg-uments"><code>kwargs</code></abbr>, verwendet werden. Selbst wenn diese keinen Defaultwert haben.
```Python hl_lines="7"
-{!../../../docs_src/path_params_numeric_validations/tutorial003.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial003.py!}
```
### Besser mit `Annotated`
@@ -224,7 +224,7 @@ Bedenken Sie, dass Sie, wenn Sie `Annotated` verwenden, dieses Problem nicht hab
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
```
////
@@ -232,7 +232,7 @@ Bedenken Sie, dass Sie, wenn Sie `Annotated` verwenden, dieses Problem nicht hab
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
```
////
@@ -245,7 +245,7 @@ Hier, mit `ge=1`, wird festgelegt, dass `item_id` eine Ganzzahl benötigt, die g
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
```
////
@@ -253,7 +253,7 @@ Hier, mit `ge=1`, wird festgelegt, dass `item_id` eine Ganzzahl benötigt, die g
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
```
////
@@ -267,7 +267,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="8"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004.py!}
```
////
@@ -282,7 +282,7 @@ Das Gleiche trifft zu auf:
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
```
////
@@ -290,7 +290,7 @@ Das Gleiche trifft zu auf:
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
```
////
@@ -304,7 +304,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial005.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial005.py!}
```
////
@@ -322,7 +322,7 @@ Das gleiche gilt für <abbr title="less than – kleiner als"><code>lt</code></a
//// tab | Python 3.9+
```Python hl_lines="13"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
```
////
@@ -330,7 +330,7 @@ Das gleiche gilt für <abbr title="less than – kleiner als"><code>lt</code></a
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
```
////
@@ -344,7 +344,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="11"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial006.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial006.py!}
```
////
diff --git a/docs/de/docs/tutorial/path-params.md b/docs/de/docs/tutorial/path-params.md
index 2c1b691a8..9cb172c94 100644
--- a/docs/de/docs/tutorial/path-params.md
+++ b/docs/de/docs/tutorial/path-params.md
@@ -3,7 +3,7 @@
Sie können Pfad-„Parameter“ oder -„Variablen“ mit der gleichen Syntax deklarieren, welche in Python-<abbr title="Format-String – Formatierter String: Der String enthält Variablen, die mit geschweiften Klammern umschlossen sind. Solche Stellen werden durch den Wert der Variable ersetzt">Format-Strings</abbr> verwendet wird:
```Python hl_lines="6-7"
-{!../../../docs_src/path_params/tutorial001.py!}
+{!../../docs_src/path_params/tutorial001.py!}
```
Der Wert des Pfad-Parameters `item_id` wird Ihrer Funktion als das Argument `item_id` übergeben.
@@ -19,7 +19,7 @@ Wenn Sie dieses Beispiel ausführen und auf <a href="http://127.0.0.1:8000/items
Sie können den Typ eines Pfad-Parameters in der Argumentliste der Funktion deklarieren, mit Standard-Python-Typannotationen:
```Python hl_lines="7"
-{!../../../docs_src/path_params/tutorial002.py!}
+{!../../docs_src/path_params/tutorial002.py!}
```
In diesem Fall wird `item_id` als `int` deklariert, also als Ganzzahl.
@@ -124,7 +124,7 @@ Und Sie haben auch einen Pfad `/users/{user_id}`, um Daten über einen spezifisc
Weil *Pfadoperationen* in ihrer Reihenfolge ausgewertet werden, müssen Sie sicherstellen, dass der Pfad `/users/me` vor `/users/{user_id}` deklariert wurde:
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003.py!}
+{!../../docs_src/path_params/tutorial003.py!}
```
Ansonsten würde der Pfad für `/users/{user_id}` auch `/users/me` auswerten, und annehmen, dass ein Parameter `user_id` mit dem Wert `"me"` übergeben wurde.
@@ -132,7 +132,7 @@ Ansonsten würde der Pfad für `/users/{user_id}` auch `/users/me` auswerten, un
Sie können eine Pfadoperation auch nicht erneut definieren:
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003b.py!}
+{!../../docs_src/path_params/tutorial003b.py!}
```
Die erste Definition wird immer verwendet werden, da ihr Pfad zuerst übereinstimmt.
@@ -150,7 +150,7 @@ Indem Sie von `str` erben, weiß die API Dokumentation, dass die Werte des Enums
Erstellen Sie dann Klassen-Attribute mit festgelegten Werten, welches die erlaubten Werte sein werden:
```Python hl_lines="1 6-9"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// info
@@ -170,7 +170,7 @@ Falls Sie sich fragen, was „AlexNet“, „ResNet“ und „LeNet“ ist, das
Dann erstellen Sie einen *Pfad-Parameter*, der als Typ die gerade erstellte Enum-Klasse hat (`ModelName`):
```Python hl_lines="16"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
### Testen Sie es in der API-Dokumentation
@@ -188,7 +188,7 @@ Der *Pfad-Parameter* wird ein *<abbr title="Member – Mitglied: Einer der mögl
Sie können ihn mit einem Member Ihres Enums `ModelName` vergleichen:
```Python hl_lines="17"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
#### *Enum-Wert* erhalten
@@ -196,7 +196,7 @@ Sie können ihn mit einem Member Ihres Enums `ModelName` vergleichen:
Den tatsächlichen Wert (in diesem Fall ein `str`) erhalten Sie via `model_name.value`, oder generell, `ihr_enum_member.value`:
```Python hl_lines="20"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// tip | "Tipp"
@@ -212,7 +212,7 @@ Sie können *Enum-Member* in ihrer *Pfadoperation* zurückgeben, sogar verschach
Diese werden zu ihren entsprechenden Werten konvertiert (in diesem Fall Strings), bevor sie zum Client übertragen werden:
```Python hl_lines="18 21 23"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
In Ihrem Client erhalten Sie eine JSON-Response, wie etwa:
@@ -253,7 +253,7 @@ In diesem Fall ist der Name des Parameters `file_path`. Der letzte Teil, `:path`
Sie verwenden das also wie folgt:
```Python hl_lines="6"
-{!../../../docs_src/path_params/tutorial004.py!}
+{!../../docs_src/path_params/tutorial004.py!}
```
/// tip | "Tipp"
diff --git a/docs/de/docs/tutorial/query-params-str-validations.md b/docs/de/docs/tutorial/query-params-str-validations.md
index ab30fc6cf..a9f1e0f39 100644
--- a/docs/de/docs/tutorial/query-params-str-validations.md
+++ b/docs/de/docs/tutorial/query-params-str-validations.md
@@ -7,7 +7,7 @@ Nehmen wir als Beispiel die folgende Anwendung:
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial001_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial001_py310.py!}
```
////
@@ -15,7 +15,7 @@ Nehmen wir als Beispiel die folgende Anwendung:
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial001.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial001.py!}
```
////
@@ -46,7 +46,7 @@ Importieren Sie zuerst:
In Python 3.9 oder darüber, ist `Annotated` Teil der Standardbibliothek, also können Sie es von `typing` importieren.
```Python hl_lines="1 3"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
```
////
@@ -58,7 +58,7 @@ In Versionen unter Python 3.9 importieren Sie `Annotated` von `typing_extensions
Es wird bereits mit FastAPI installiert sein.
```Python hl_lines="3-4"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_an.py!}
```
////
@@ -126,7 +126,7 @@ Jetzt, da wir `Annotated` für unsere Metadaten deklariert haben, fügen Sie `Qu
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
```
////
@@ -134,7 +134,7 @@ Jetzt, da wir `Annotated` für unsere Metadaten deklariert haben, fügen Sie `Qu
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_an.py!}
```
////
@@ -164,7 +164,7 @@ So würden Sie `Query()` als Defaultwert Ihres Funktionsparameters verwenden, de
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_py310.py!}
```
////
@@ -172,7 +172,7 @@ So würden Sie `Query()` als Defaultwert Ihres Funktionsparameters verwenden, de
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002.py!}
```
////
@@ -278,7 +278,7 @@ Sie können auch einen Parameter `min_length` hinzufügen:
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial003_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003_an_py310.py!}
```
////
@@ -286,7 +286,7 @@ Sie können auch einen Parameter `min_length` hinzufügen:
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial003_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003_an_py39.py!}
```
////
@@ -294,7 +294,7 @@ Sie können auch einen Parameter `min_length` hinzufügen:
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial003_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003_an.py!}
```
////
@@ -308,7 +308,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial003_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003_py310.py!}
```
////
@@ -322,7 +322,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial003.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003.py!}
```
////
@@ -334,7 +334,7 @@ Sie können einen <abbr title="Ein regulärer Ausdruck, auch regex oder regexp g
//// tab | Python 3.10+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_an_py310.py!}
```
////
@@ -342,7 +342,7 @@ Sie können einen <abbr title="Ein regulärer Ausdruck, auch regex oder regexp g
//// tab | Python 3.9+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_an_py39.py!}
```
////
@@ -350,7 +350,7 @@ Sie können einen <abbr title="Ein regulärer Ausdruck, auch regex oder regexp g
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_an.py!}
```
////
@@ -364,7 +364,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_py310.py!}
```
////
@@ -378,7 +378,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial004.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004.py!}
```
////
@@ -402,7 +402,7 @@ Sie könnten immer noch Code sehen, der den alten Namen verwendet:
//// tab | Python 3.10+ Pydantic v1
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_an_py310_regex.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_an_py310_regex.py!}
```
////
@@ -418,7 +418,7 @@ Beispielsweise könnten Sie den `q` Query-Parameter so deklarieren, dass er eine
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial005_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial005_an_py39.py!}
```
////
@@ -426,7 +426,7 @@ Beispielsweise könnten Sie den `q` Query-Parameter so deklarieren, dass er eine
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial005_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial005_an.py!}
```
////
@@ -440,7 +440,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial005.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial005.py!}
```
////
@@ -488,7 +488,7 @@ Wenn Sie einen Parameter erforderlich machen wollen, während Sie `Query` verwen
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006_an_py39.py!}
```
////
@@ -496,7 +496,7 @@ Wenn Sie einen Parameter erforderlich machen wollen, während Sie `Query` verwen
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial006_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006_an.py!}
```
////
@@ -510,7 +510,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial006.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006.py!}
```
/// tip | "Tipp"
@@ -530,7 +530,7 @@ Es gibt eine Alternative, die explizit deklariert, dass ein Wert erforderlich is
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006b_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006b_an_py39.py!}
```
////
@@ -538,7 +538,7 @@ Es gibt eine Alternative, die explizit deklariert, dass ein Wert erforderlich is
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial006b_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006b_an.py!}
```
////
@@ -552,7 +552,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial006b.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006b.py!}
```
////
@@ -576,7 +576,7 @@ Um das zu machen, deklarieren Sie, dass `None` ein gültiger Typ ist, aber verwe
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c_an_py310.py!}
```
////
@@ -584,7 +584,7 @@ Um das zu machen, deklarieren Sie, dass `None` ein gültiger Typ ist, aber verwe
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c_an_py39.py!}
```
////
@@ -592,7 +592,7 @@ Um das zu machen, deklarieren Sie, dass `None` ein gültiger Typ ist, aber verwe
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c_an.py!}
```
////
@@ -606,7 +606,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c_py310.py!}
```
////
@@ -620,7 +620,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c.py!}
```
////
@@ -646,7 +646,7 @@ Um zum Beispiel einen Query-Parameter `q` zu deklarieren, der mehrere Male in de
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_an_py310.py!}
```
////
@@ -654,7 +654,7 @@ Um zum Beispiel einen Query-Parameter `q` zu deklarieren, der mehrere Male in de
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_an_py39.py!}
```
////
@@ -662,7 +662,7 @@ Um zum Beispiel einen Query-Parameter `q` zu deklarieren, der mehrere Male in de
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_an.py!}
```
////
@@ -676,7 +676,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_py310.py!}
```
////
@@ -690,7 +690,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_py39.py!}
```
////
@@ -704,7 +704,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011.py!}
```
////
@@ -745,7 +745,7 @@ Und Sie können auch eine Default-`list`e von Werten definieren, wenn keine übe
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial012_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012_an_py39.py!}
```
////
@@ -753,7 +753,7 @@ Und Sie können auch eine Default-`list`e von Werten definieren, wenn keine übe
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial012_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012_an.py!}
```
////
@@ -767,7 +767,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial012_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012_py39.py!}
```
////
@@ -781,7 +781,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial012.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012.py!}
```
////
@@ -810,7 +810,7 @@ Sie können auch `list` direkt verwenden, anstelle von `List[str]` (oder `list[s
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial013_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial013_an_py39.py!}
```
////
@@ -818,7 +818,7 @@ Sie können auch `list` direkt verwenden, anstelle von `List[str]` (oder `list[s
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial013_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial013_an.py!}
```
////
@@ -832,7 +832,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial013.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial013.py!}
```
////
@@ -864,7 +864,7 @@ Sie können einen Titel hinzufügen – `title`:
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial007_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007_an_py310.py!}
```
////
@@ -872,7 +872,7 @@ Sie können einen Titel hinzufügen – `title`:
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial007_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007_an_py39.py!}
```
////
@@ -880,7 +880,7 @@ Sie können einen Titel hinzufügen – `title`:
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial007_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007_an.py!}
```
////
@@ -894,7 +894,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial007_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007_py310.py!}
```
////
@@ -908,7 +908,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial007.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007.py!}
```
////
@@ -918,7 +918,7 @@ Und eine Beschreibung – `description`:
//// tab | Python 3.10+
```Python hl_lines="14"
-{!> ../../../docs_src/query_params_str_validations/tutorial008_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008_an_py310.py!}
```
////
@@ -926,7 +926,7 @@ Und eine Beschreibung – `description`:
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/query_params_str_validations/tutorial008_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008_an_py39.py!}
```
////
@@ -934,7 +934,7 @@ Und eine Beschreibung – `description`:
//// tab | Python 3.8+
```Python hl_lines="15"
-{!> ../../../docs_src/query_params_str_validations/tutorial008_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008_an.py!}
```
////
@@ -948,7 +948,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial008_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008_py310.py!}
```
////
@@ -962,7 +962,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="13"
-{!> ../../../docs_src/query_params_str_validations/tutorial008.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008.py!}
```
////
@@ -988,7 +988,7 @@ Dann können Sie einen `alias` deklarieren, und dieser Alias wird verwendet, um
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial009_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009_an_py310.py!}
```
////
@@ -996,7 +996,7 @@ Dann können Sie einen `alias` deklarieren, und dieser Alias wird verwendet, um
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial009_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009_an_py39.py!}
```
////
@@ -1004,7 +1004,7 @@ Dann können Sie einen `alias` deklarieren, und dieser Alias wird verwendet, um
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial009_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009_an.py!}
```
////
@@ -1018,7 +1018,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial009_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009_py310.py!}
```
////
@@ -1032,7 +1032,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial009.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009.py!}
```
////
@@ -1048,7 +1048,7 @@ In diesem Fall fügen Sie den Parameter `deprecated=True` zu `Query` hinzu.
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/query_params_str_validations/tutorial010_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010_an_py310.py!}
```
////
@@ -1056,7 +1056,7 @@ In diesem Fall fügen Sie den Parameter `deprecated=True` zu `Query` hinzu.
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/query_params_str_validations/tutorial010_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010_an_py39.py!}
```
////
@@ -1064,7 +1064,7 @@ In diesem Fall fügen Sie den Parameter `deprecated=True` zu `Query` hinzu.
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/query_params_str_validations/tutorial010_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010_an.py!}
```
////
@@ -1078,7 +1078,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="16"
-{!> ../../../docs_src/query_params_str_validations/tutorial010_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010_py310.py!}
```
////
@@ -1092,7 +1092,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="18"
-{!> ../../../docs_src/query_params_str_validations/tutorial010.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010.py!}
```
////
@@ -1108,7 +1108,7 @@ Um einen Query-Parameter vom generierten OpenAPI-Schema auszuschließen (und dah
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial014_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014_an_py310.py!}
```
////
@@ -1116,7 +1116,7 @@ Um einen Query-Parameter vom generierten OpenAPI-Schema auszuschließen (und dah
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial014_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014_an_py39.py!}
```
////
@@ -1124,7 +1124,7 @@ Um einen Query-Parameter vom generierten OpenAPI-Schema auszuschließen (und dah
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial014_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014_an.py!}
```
////
@@ -1138,7 +1138,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial014_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014_py310.py!}
```
////
@@ -1152,7 +1152,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial014.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014.py!}
```
////
diff --git a/docs/de/docs/tutorial/query-params.md b/docs/de/docs/tutorial/query-params.md
index 136852216..bb1dbdf9c 100644
--- a/docs/de/docs/tutorial/query-params.md
+++ b/docs/de/docs/tutorial/query-params.md
@@ -3,7 +3,7 @@
Wenn Sie in ihrer Funktion Parameter deklarieren, die nicht Teil der Pfad-Parameter sind, dann werden diese automatisch als „Query“-Parameter interpretiert.
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial001.py!}
+{!../../docs_src/query_params/tutorial001.py!}
```
Query-Parameter (Deutsch: Abfrage-Parameter) sind die Schlüssel-Wert-Paare, die nach dem `?` in einer URL aufgelistet sind, getrennt durch `&`-Zeichen.
@@ -66,7 +66,7 @@ Auf die gleiche Weise können Sie optionale Query-Parameter deklarieren, indem S
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial002_py310.py!}
+{!> ../../docs_src/query_params/tutorial002_py310.py!}
```
////
@@ -74,7 +74,7 @@ Auf die gleiche Weise können Sie optionale Query-Parameter deklarieren, indem S
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial002.py!}
+{!> ../../docs_src/query_params/tutorial002.py!}
```
////
@@ -94,7 +94,7 @@ Sie können auch `bool`-Typen deklarieren und sie werden konvertiert:
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial003_py310.py!}
+{!> ../../docs_src/query_params/tutorial003_py310.py!}
```
////
@@ -102,7 +102,7 @@ Sie können auch `bool`-Typen deklarieren und sie werden konvertiert:
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial003.py!}
+{!> ../../docs_src/query_params/tutorial003.py!}
```
////
@@ -150,7 +150,7 @@ Parameter werden anhand ihres Namens erkannt:
//// tab | Python 3.10+
```Python hl_lines="6 8"
-{!> ../../../docs_src/query_params/tutorial004_py310.py!}
+{!> ../../docs_src/query_params/tutorial004_py310.py!}
```
////
@@ -158,7 +158,7 @@ Parameter werden anhand ihres Namens erkannt:
//// tab | Python 3.8+
```Python hl_lines="8 10"
-{!> ../../../docs_src/query_params/tutorial004.py!}
+{!> ../../docs_src/query_params/tutorial004.py!}
```
////
@@ -172,7 +172,7 @@ Wenn Sie keinen spezifischen Wert haben wollen, sondern der Parameter einfach op
Aber wenn Sie wollen, dass ein Query-Parameter erforderlich ist, vergeben Sie einfach keinen Defaultwert:
```Python hl_lines="6-7"
-{!../../../docs_src/query_params/tutorial005.py!}
+{!../../docs_src/query_params/tutorial005.py!}
```
Hier ist `needy` ein erforderlicher Query-Parameter vom Typ `str`.
@@ -222,7 +222,7 @@ Und natürlich können Sie einige Parameter als erforderlich, einige mit Default
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params/tutorial006_py310.py!}
+{!> ../../docs_src/query_params/tutorial006_py310.py!}
```
////
@@ -230,7 +230,7 @@ Und natürlich können Sie einige Parameter als erforderlich, einige mit Default
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params/tutorial006.py!}
+{!> ../../docs_src/query_params/tutorial006.py!}
```
////
diff --git a/docs/de/docs/tutorial/request-files.md b/docs/de/docs/tutorial/request-files.md
index cf44df5f0..c0d0ef3f2 100644
--- a/docs/de/docs/tutorial/request-files.md
+++ b/docs/de/docs/tutorial/request-files.md
@@ -19,7 +19,7 @@ Importieren Sie `File` und `UploadFile` von `fastapi`:
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
```
////
@@ -27,7 +27,7 @@ Importieren Sie `File` und `UploadFile` von `fastapi`:
//// tab | Python 3.8+
```Python hl_lines="1"
-{!> ../../../docs_src/request_files/tutorial001_an.py!}
+{!> ../../docs_src/request_files/tutorial001_an.py!}
```
////
@@ -41,7 +41,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="1"
-{!> ../../../docs_src/request_files/tutorial001.py!}
+{!> ../../docs_src/request_files/tutorial001.py!}
```
////
@@ -53,7 +53,7 @@ Erstellen Sie Datei-Parameter, so wie Sie es auch mit `Body` und `Form` machen w
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
```
////
@@ -61,7 +61,7 @@ Erstellen Sie Datei-Parameter, so wie Sie es auch mit `Body` und `Form` machen w
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/request_files/tutorial001_an.py!}
+{!> ../../docs_src/request_files/tutorial001_an.py!}
```
////
@@ -75,7 +75,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/request_files/tutorial001.py!}
+{!> ../../docs_src/request_files/tutorial001.py!}
```
////
@@ -109,7 +109,7 @@ Definieren Sie einen Datei-Parameter mit dem Typ `UploadFile`:
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
```
////
@@ -117,7 +117,7 @@ Definieren Sie einen Datei-Parameter mit dem Typ `UploadFile`:
//// tab | Python 3.8+
```Python hl_lines="13"
-{!> ../../../docs_src/request_files/tutorial001_an.py!}
+{!> ../../docs_src/request_files/tutorial001_an.py!}
```
////
@@ -131,7 +131,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="12"
-{!> ../../../docs_src/request_files/tutorial001.py!}
+{!> ../../docs_src/request_files/tutorial001.py!}
```
////
@@ -220,7 +220,7 @@ Sie können eine Datei optional machen, indem Sie Standard-Typannotationen verwe
//// tab | Python 3.10+
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02_an_py310.py!}
+{!> ../../docs_src/request_files/tutorial001_02_an_py310.py!}
```
////
@@ -228,7 +228,7 @@ Sie können eine Datei optional machen, indem Sie Standard-Typannotationen verwe
//// tab | Python 3.9+
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_02_an_py39.py!}
```
////
@@ -236,7 +236,7 @@ Sie können eine Datei optional machen, indem Sie Standard-Typannotationen verwe
//// tab | Python 3.8+
```Python hl_lines="10 18"
-{!> ../../../docs_src/request_files/tutorial001_02_an.py!}
+{!> ../../docs_src/request_files/tutorial001_02_an.py!}
```
////
@@ -250,7 +250,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7 15"
-{!> ../../../docs_src/request_files/tutorial001_02_py310.py!}
+{!> ../../docs_src/request_files/tutorial001_02_py310.py!}
```
////
@@ -264,7 +264,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02.py!}
+{!> ../../docs_src/request_files/tutorial001_02.py!}
```
////
@@ -276,7 +276,7 @@ Sie können auch `File()` zusammen mit `UploadFile` verwenden, um zum Beispiel z
//// tab | Python 3.9+
```Python hl_lines="9 15"
-{!> ../../../docs_src/request_files/tutorial001_03_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_03_an_py39.py!}
```
////
@@ -284,7 +284,7 @@ Sie können auch `File()` zusammen mit `UploadFile` verwenden, um zum Beispiel z
//// tab | Python 3.8+
```Python hl_lines="8 14"
-{!> ../../../docs_src/request_files/tutorial001_03_an.py!}
+{!> ../../docs_src/request_files/tutorial001_03_an.py!}
```
////
@@ -298,7 +298,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7 13"
-{!> ../../../docs_src/request_files/tutorial001_03.py!}
+{!> ../../docs_src/request_files/tutorial001_03.py!}
```
////
@@ -314,7 +314,7 @@ Um das zu machen, deklarieren Sie eine Liste von `bytes` oder `UploadFile`s:
//// tab | Python 3.9+
```Python hl_lines="10 15"
-{!> ../../../docs_src/request_files/tutorial002_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial002_an_py39.py!}
```
////
@@ -322,7 +322,7 @@ Um das zu machen, deklarieren Sie eine Liste von `bytes` oder `UploadFile`s:
//// tab | Python 3.8+
```Python hl_lines="11 16"
-{!> ../../../docs_src/request_files/tutorial002_an.py!}
+{!> ../../docs_src/request_files/tutorial002_an.py!}
```
////
@@ -336,7 +336,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="8 13"
-{!> ../../../docs_src/request_files/tutorial002_py39.py!}
+{!> ../../docs_src/request_files/tutorial002_py39.py!}
```
////
@@ -350,7 +350,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="10 15"
-{!> ../../../docs_src/request_files/tutorial002.py!}
+{!> ../../docs_src/request_files/tutorial002.py!}
```
////
@@ -372,7 +372,7 @@ Und so wie zuvor können Sie `File()` verwenden, um zusätzliche Parameter zu se
//// tab | Python 3.9+
```Python hl_lines="11 18-20"
-{!> ../../../docs_src/request_files/tutorial003_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial003_an_py39.py!}
```
////
@@ -380,7 +380,7 @@ Und so wie zuvor können Sie `File()` verwenden, um zusätzliche Parameter zu se
//// tab | Python 3.8+
```Python hl_lines="12 19-21"
-{!> ../../../docs_src/request_files/tutorial003_an.py!}
+{!> ../../docs_src/request_files/tutorial003_an.py!}
```
////
@@ -394,7 +394,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="9 16"
-{!> ../../../docs_src/request_files/tutorial003_py39.py!}
+{!> ../../docs_src/request_files/tutorial003_py39.py!}
```
////
@@ -408,7 +408,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="11 18"
-{!> ../../../docs_src/request_files/tutorial003.py!}
+{!> ../../docs_src/request_files/tutorial003.py!}
```
////
diff --git a/docs/de/docs/tutorial/request-forms-and-files.md b/docs/de/docs/tutorial/request-forms-and-files.md
index e109595d1..2b89edbb4 100644
--- a/docs/de/docs/tutorial/request-forms-and-files.md
+++ b/docs/de/docs/tutorial/request-forms-and-files.md
@@ -15,7 +15,7 @@ Z. B. `pip install python-multipart`.
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
```
////
@@ -23,7 +23,7 @@ Z. B. `pip install python-multipart`.
//// tab | Python 3.8+
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms_and_files/tutorial001_an.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001_an.py!}
```
////
@@ -37,7 +37,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001.py!}
```
////
@@ -49,7 +49,7 @@ Erstellen Sie Datei- und Formularparameter, so wie Sie es auch mit `Body` und `Q
//// tab | Python 3.9+
```Python hl_lines="10-12"
-{!> ../../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
```
////
@@ -57,7 +57,7 @@ Erstellen Sie Datei- und Formularparameter, so wie Sie es auch mit `Body` und `Q
//// tab | Python 3.8+
```Python hl_lines="9-11"
-{!> ../../../docs_src/request_forms_and_files/tutorial001_an.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001_an.py!}
```
////
@@ -71,7 +71,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="8"
-{!> ../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001.py!}
```
////
diff --git a/docs/de/docs/tutorial/request-forms.md b/docs/de/docs/tutorial/request-forms.md
index 391788aff..0784aa8c0 100644
--- a/docs/de/docs/tutorial/request-forms.md
+++ b/docs/de/docs/tutorial/request-forms.md
@@ -17,7 +17,7 @@ Importieren Sie `Form` von `fastapi`:
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ Importieren Sie `Form` von `fastapi`:
//// tab | Python 3.8+
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms/tutorial001_an.py!}
+{!> ../../docs_src/request_forms/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms/tutorial001.py!}
+{!> ../../docs_src/request_forms/tutorial001.py!}
```
////
@@ -51,7 +51,7 @@ Erstellen Sie Formular-Parameter, so wie Sie es auch mit `Body` und `Query` mach
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms/tutorial001_an_py39.py!}
```
////
@@ -59,7 +59,7 @@ Erstellen Sie Formular-Parameter, so wie Sie es auch mit `Body` und `Query` mach
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/request_forms/tutorial001_an.py!}
+{!> ../../docs_src/request_forms/tutorial001_an.py!}
```
////
@@ -73,7 +73,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7"
-{!> ../../../docs_src/request_forms/tutorial001.py!}
+{!> ../../docs_src/request_forms/tutorial001.py!}
```
////
diff --git a/docs/de/docs/tutorial/response-model.md b/docs/de/docs/tutorial/response-model.md
index b480780bc..31ad73c77 100644
--- a/docs/de/docs/tutorial/response-model.md
+++ b/docs/de/docs/tutorial/response-model.md
@@ -7,7 +7,7 @@ Hierbei können Sie **Typannotationen** genauso verwenden, wie Sie es bei Werten
//// tab | Python 3.10+
```Python hl_lines="16 21"
-{!> ../../../docs_src/response_model/tutorial001_01_py310.py!}
+{!> ../../docs_src/response_model/tutorial001_01_py310.py!}
```
////
@@ -15,7 +15,7 @@ Hierbei können Sie **Typannotationen** genauso verwenden, wie Sie es bei Werten
//// tab | Python 3.9+
```Python hl_lines="18 23"
-{!> ../../../docs_src/response_model/tutorial001_01_py39.py!}
+{!> ../../docs_src/response_model/tutorial001_01_py39.py!}
```
////
@@ -23,7 +23,7 @@ Hierbei können Sie **Typannotationen** genauso verwenden, wie Sie es bei Werten
//// tab | Python 3.8+
```Python hl_lines="18 23"
-{!> ../../../docs_src/response_model/tutorial001_01.py!}
+{!> ../../docs_src/response_model/tutorial001_01.py!}
```
////
@@ -62,7 +62,7 @@ Sie können `response_model` in jeder möglichen *Pfadoperation* verwenden:
//// tab | Python 3.10+
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001_py310.py!}
+{!> ../../docs_src/response_model/tutorial001_py310.py!}
```
////
@@ -70,7 +70,7 @@ Sie können `response_model` in jeder möglichen *Pfadoperation* verwenden:
//// tab | Python 3.9+
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001_py39.py!}
+{!> ../../docs_src/response_model/tutorial001_py39.py!}
```
////
@@ -78,7 +78,7 @@ Sie können `response_model` in jeder möglichen *Pfadoperation* verwenden:
//// tab | Python 3.8+
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001.py!}
+{!> ../../docs_src/response_model/tutorial001.py!}
```
////
@@ -116,7 +116,7 @@ Im Folgenden deklarieren wir ein `UserIn`-Modell; es enthält ein Klartext-Passw
//// tab | Python 3.10+
```Python hl_lines="7 9"
-{!> ../../../docs_src/response_model/tutorial002_py310.py!}
+{!> ../../docs_src/response_model/tutorial002_py310.py!}
```
////
@@ -124,7 +124,7 @@ Im Folgenden deklarieren wir ein `UserIn`-Modell; es enthält ein Klartext-Passw
//// tab | Python 3.8+
```Python hl_lines="9 11"
-{!> ../../../docs_src/response_model/tutorial002.py!}
+{!> ../../docs_src/response_model/tutorial002.py!}
```
////
@@ -143,7 +143,7 @@ Wir verwenden dieses Modell, um sowohl unsere Eingabe- als auch Ausgabedaten zu
//// tab | Python 3.10+
```Python hl_lines="16"
-{!> ../../../docs_src/response_model/tutorial002_py310.py!}
+{!> ../../docs_src/response_model/tutorial002_py310.py!}
```
////
@@ -151,7 +151,7 @@ Wir verwenden dieses Modell, um sowohl unsere Eingabe- als auch Ausgabedaten zu
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/response_model/tutorial002.py!}
+{!> ../../docs_src/response_model/tutorial002.py!}
```
////
@@ -175,7 +175,7 @@ Wir können stattdessen ein Eingabemodell mit dem Klartext-Passwort, und ein Aus
//// tab | Python 3.10+
```Python hl_lines="9 11 16"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -183,7 +183,7 @@ Wir können stattdessen ein Eingabemodell mit dem Klartext-Passwort, und ein Aus
//// tab | Python 3.8+
```Python hl_lines="9 11 16"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -193,7 +193,7 @@ Obwohl unsere *Pfadoperation-Funktion* hier denselben `user` von der Eingabe zur
//// tab | Python 3.10+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -201,7 +201,7 @@ Obwohl unsere *Pfadoperation-Funktion* hier denselben `user` von der Eingabe zur
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -211,7 +211,7 @@ Obwohl unsere *Pfadoperation-Funktion* hier denselben `user` von der Eingabe zur
//// tab | Python 3.10+
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -219,7 +219,7 @@ Obwohl unsere *Pfadoperation-Funktion* hier denselben `user` von der Eingabe zur
//// tab | Python 3.8+
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -249,7 +249,7 @@ Und in solchen Fällen können wir Klassen und Vererbung verwenden, um Vorteil a
//// tab | Python 3.10+
```Python hl_lines="7-10 13-14 18"
-{!> ../../../docs_src/response_model/tutorial003_01_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_01_py310.py!}
```
////
@@ -257,7 +257,7 @@ Und in solchen Fällen können wir Klassen und Vererbung verwenden, um Vorteil a
//// tab | Python 3.8+
```Python hl_lines="9-13 15-16 20"
-{!> ../../../docs_src/response_model/tutorial003_01.py!}
+{!> ../../docs_src/response_model/tutorial003_01.py!}
```
////
@@ -303,7 +303,7 @@ Es kann Fälle geben, bei denen Sie etwas zurückgeben, das kein gültiges Pydan
Der häufigste Anwendungsfall ist, wenn Sie [eine Response direkt zurückgeben, wie es später im Handbuch für fortgeschrittene Benutzer erläutert wird](../advanced/response-directly.md){.internal-link target=_blank}.
```Python hl_lines="8 10-11"
-{!> ../../../docs_src/response_model/tutorial003_02.py!}
+{!> ../../docs_src/response_model/tutorial003_02.py!}
```
Dieser einfache Anwendungsfall wird automatisch von FastAPI gehandhabt, weil die Annotation des Rückgabetyps die Klasse (oder eine Unterklasse von) `Response` ist.
@@ -315,7 +315,7 @@ Und Tools werden auch glücklich sein, weil sowohl `RedirectResponse` als auch `
Sie können auch eine Unterklasse von `Response` in der Typannotation verwenden.
```Python hl_lines="8-9"
-{!> ../../../docs_src/response_model/tutorial003_03.py!}
+{!> ../../docs_src/response_model/tutorial003_03.py!}
```
Das wird ebenfalls funktionieren, weil `RedirectResponse` eine Unterklasse von `Response` ist, und FastAPI sich um diesen einfachen Anwendungsfall automatisch kümmert.
@@ -329,7 +329,7 @@ Das gleiche wird passieren, wenn Sie eine <abbr title='Eine Union mehrerer Typen
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/response_model/tutorial003_04_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_04_py310.py!}
```
////
@@ -337,7 +337,7 @@ Das gleiche wird passieren, wenn Sie eine <abbr title='Eine Union mehrerer Typen
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/response_model/tutorial003_04.py!}
+{!> ../../docs_src/response_model/tutorial003_04.py!}
```
////
@@ -355,7 +355,7 @@ In diesem Fall können Sie die Generierung des Responsemodells abschalten, indem
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/response_model/tutorial003_05_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_05_py310.py!}
```
////
@@ -363,7 +363,7 @@ In diesem Fall können Sie die Generierung des Responsemodells abschalten, indem
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/response_model/tutorial003_05.py!}
+{!> ../../docs_src/response_model/tutorial003_05.py!}
```
////
@@ -377,7 +377,7 @@ Ihr Responsemodell könnte Defaultwerte haben, wie:
//// tab | Python 3.10+
```Python hl_lines="9 11-12"
-{!> ../../../docs_src/response_model/tutorial004_py310.py!}
+{!> ../../docs_src/response_model/tutorial004_py310.py!}
```
////
@@ -385,7 +385,7 @@ Ihr Responsemodell könnte Defaultwerte haben, wie:
//// tab | Python 3.9+
```Python hl_lines="11 13-14"
-{!> ../../../docs_src/response_model/tutorial004_py39.py!}
+{!> ../../docs_src/response_model/tutorial004_py39.py!}
```
////
@@ -393,7 +393,7 @@ Ihr Responsemodell könnte Defaultwerte haben, wie:
//// tab | Python 3.8+
```Python hl_lines="11 13-14"
-{!> ../../../docs_src/response_model/tutorial004.py!}
+{!> ../../docs_src/response_model/tutorial004.py!}
```
////
@@ -413,7 +413,7 @@ Sie können den *Pfadoperation-Dekorator*-Parameter `response_model_exclude_unse
//// tab | Python 3.10+
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial004_py310.py!}
+{!> ../../docs_src/response_model/tutorial004_py310.py!}
```
////
@@ -421,7 +421,7 @@ Sie können den *Pfadoperation-Dekorator*-Parameter `response_model_exclude_unse
//// tab | Python 3.9+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial004_py39.py!}
+{!> ../../docs_src/response_model/tutorial004_py39.py!}
```
////
@@ -429,7 +429,7 @@ Sie können den *Pfadoperation-Dekorator*-Parameter `response_model_exclude_unse
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial004.py!}
+{!> ../../docs_src/response_model/tutorial004.py!}
```
////
@@ -532,7 +532,7 @@ Das trifft auch auf `response_model_by_alias` zu, welches ähnlich funktioniert.
//// tab | Python 3.10+
```Python hl_lines="29 35"
-{!> ../../../docs_src/response_model/tutorial005_py310.py!}
+{!> ../../docs_src/response_model/tutorial005_py310.py!}
```
////
@@ -540,7 +540,7 @@ Das trifft auch auf `response_model_by_alias` zu, welches ähnlich funktioniert.
//// tab | Python 3.8+
```Python hl_lines="31 37"
-{!> ../../../docs_src/response_model/tutorial005.py!}
+{!> ../../docs_src/response_model/tutorial005.py!}
```
////
@@ -560,7 +560,7 @@ Wenn Sie vergessen, ein `set` zu verwenden, und stattdessen eine `list`e oder ei
//// tab | Python 3.10+
```Python hl_lines="29 35"
-{!> ../../../docs_src/response_model/tutorial006_py310.py!}
+{!> ../../docs_src/response_model/tutorial006_py310.py!}
```
////
@@ -568,7 +568,7 @@ Wenn Sie vergessen, ein `set` zu verwenden, und stattdessen eine `list`e oder ei
//// tab | Python 3.8+
```Python hl_lines="31 37"
-{!> ../../../docs_src/response_model/tutorial006.py!}
+{!> ../../docs_src/response_model/tutorial006.py!}
```
////
diff --git a/docs/de/docs/tutorial/response-status-code.md b/docs/de/docs/tutorial/response-status-code.md
index 5f96b83e4..872007a12 100644
--- a/docs/de/docs/tutorial/response-status-code.md
+++ b/docs/de/docs/tutorial/response-status-code.md
@@ -9,7 +9,7 @@ So wie ein Responsemodell, können Sie auch einen HTTP-Statuscode für die Respo
* usw.
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
/// note | "Hinweis"
@@ -77,7 +77,7 @@ Um mehr über Statuscodes zu lernen, und welcher wofür verwendet wird, lesen Si
Schauen wir uns das vorherige Beispiel noch einmal an:
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
`201` ist der Statuscode für „Created“ („Erzeugt“).
@@ -87,7 +87,7 @@ Aber Sie müssen sich nicht daran erinnern, welcher dieser Codes was bedeutet.
Sie können die Hilfsvariablen von `fastapi.status` verwenden.
```Python hl_lines="1 6"
-{!../../../docs_src/response_status_code/tutorial002.py!}
+{!../../docs_src/response_status_code/tutorial002.py!}
```
Diese sind nur eine Annehmlichkeit und enthalten dieselbe Nummer, aber auf diese Weise können Sie die Autovervollständigung Ihres Editors verwenden, um sie zu finden:
diff --git a/docs/de/docs/tutorial/schema-extra-example.md b/docs/de/docs/tutorial/schema-extra-example.md
index 07b4bb759..0da1a4ea4 100644
--- a/docs/de/docs/tutorial/schema-extra-example.md
+++ b/docs/de/docs/tutorial/schema-extra-example.md
@@ -11,7 +11,7 @@ Sie können `examples` („Beispiele“) für ein Pydantic-Modell deklarieren, w
//// tab | Python 3.10+ Pydantic v2
```Python hl_lines="13-24"
-{!> ../../../docs_src/schema_extra_example/tutorial001_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001_py310.py!}
```
////
@@ -19,7 +19,7 @@ Sie können `examples` („Beispiele“) für ein Pydantic-Modell deklarieren, w
//// tab | Python 3.10+ Pydantic v1
```Python hl_lines="13-23"
-{!> ../../../docs_src/schema_extra_example/tutorial001_py310_pv1.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001_py310_pv1.py!}
```
////
@@ -27,7 +27,7 @@ Sie können `examples` („Beispiele“) für ein Pydantic-Modell deklarieren, w
//// tab | Python 3.8+ Pydantic v2
```Python hl_lines="15-26"
-{!> ../../../docs_src/schema_extra_example/tutorial001.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001.py!}
```
////
@@ -35,7 +35,7 @@ Sie können `examples` („Beispiele“) für ein Pydantic-Modell deklarieren, w
//// tab | Python 3.8+ Pydantic v1
```Python hl_lines="15-25"
-{!> ../../../docs_src/schema_extra_example/tutorial001_pv1.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001_pv1.py!}
```
////
@@ -83,7 +83,7 @@ Wenn Sie `Field()` mit Pydantic-Modellen verwenden, können Sie ebenfalls zusät
//// tab | Python 3.10+
```Python hl_lines="2 8-11"
-{!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial002_py310.py!}
```
////
@@ -91,7 +91,7 @@ Wenn Sie `Field()` mit Pydantic-Modellen verwenden, können Sie ebenfalls zusät
//// tab | Python 3.8+
```Python hl_lines="4 10-13"
-{!> ../../../docs_src/schema_extra_example/tutorial002.py!}
+{!> ../../docs_src/schema_extra_example/tutorial002.py!}
```
////
@@ -117,7 +117,7 @@ Hier übergeben wir `examples`, welches ein einzelnes Beispiel für die in `Body
//// tab | Python 3.10+
```Python hl_lines="22-29"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
```
////
@@ -125,7 +125,7 @@ Hier übergeben wir `examples`, welches ein einzelnes Beispiel für die in `Body
//// tab | Python 3.9+
```Python hl_lines="22-29"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
```
////
@@ -133,7 +133,7 @@ Hier übergeben wir `examples`, welches ein einzelnes Beispiel für die in `Body
//// tab | Python 3.8+
```Python hl_lines="23-30"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an.py!}
```
////
@@ -147,7 +147,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="18-25"
-{!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_py310.py!}
```
////
@@ -161,7 +161,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="20-27"
-{!> ../../../docs_src/schema_extra_example/tutorial003.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003.py!}
```
////
@@ -179,7 +179,7 @@ Sie können natürlich auch mehrere `examples` übergeben:
//// tab | Python 3.10+
```Python hl_lines="23-38"
-{!> ../../../docs_src/schema_extra_example/tutorial004_an_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_an_py310.py!}
```
////
@@ -187,7 +187,7 @@ Sie können natürlich auch mehrere `examples` übergeben:
//// tab | Python 3.9+
```Python hl_lines="23-38"
-{!> ../../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
```
////
@@ -195,7 +195,7 @@ Sie können natürlich auch mehrere `examples` übergeben:
//// tab | Python 3.8+
```Python hl_lines="24-39"
-{!> ../../../docs_src/schema_extra_example/tutorial004_an.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_an.py!}
```
////
@@ -209,7 +209,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="19-34"
-{!> ../../../docs_src/schema_extra_example/tutorial004_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_py310.py!}
```
////
@@ -223,7 +223,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="21-36"
-{!> ../../../docs_src/schema_extra_example/tutorial004.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004.py!}
```
////
@@ -270,7 +270,7 @@ Sie können es so verwenden:
//// tab | Python 3.10+
```Python hl_lines="23-49"
-{!> ../../../docs_src/schema_extra_example/tutorial005_an_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005_an_py310.py!}
```
////
@@ -278,7 +278,7 @@ Sie können es so verwenden:
//// tab | Python 3.9+
```Python hl_lines="23-49"
-{!> ../../../docs_src/schema_extra_example/tutorial005_an_py39.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005_an_py39.py!}
```
////
@@ -286,7 +286,7 @@ Sie können es so verwenden:
//// tab | Python 3.8+
```Python hl_lines="24-50"
-{!> ../../../docs_src/schema_extra_example/tutorial005_an.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005_an.py!}
```
////
@@ -300,7 +300,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="19-45"
-{!> ../../../docs_src/schema_extra_example/tutorial005_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005_py310.py!}
```
////
@@ -314,7 +314,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="21-47"
-{!> ../../../docs_src/schema_extra_example/tutorial005.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005.py!}
```
////
diff --git a/docs/de/docs/tutorial/security/first-steps.md b/docs/de/docs/tutorial/security/first-steps.md
index 6bc42cf6c..c552a681b 100644
--- a/docs/de/docs/tutorial/security/first-steps.md
+++ b/docs/de/docs/tutorial/security/first-steps.md
@@ -23,7 +23,7 @@ Kopieren Sie das Beispiel in eine Datei `main.py`:
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/security/tutorial001_an_py39.py!}
+{!> ../../docs_src/security/tutorial001_an_py39.py!}
```
////
@@ -31,7 +31,7 @@ Kopieren Sie das Beispiel in eine Datei `main.py`:
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/security/tutorial001_an.py!}
+{!> ../../docs_src/security/tutorial001_an.py!}
```
////
@@ -45,7 +45,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python
-{!> ../../../docs_src/security/tutorial001.py!}
+{!> ../../docs_src/security/tutorial001.py!}
```
////
@@ -157,7 +157,7 @@ Wenn wir eine Instanz der Klasse `OAuth2PasswordBearer` erstellen, übergeben wi
//// tab | Python 3.9+
```Python hl_lines="8"
-{!> ../../../docs_src/security/tutorial001_an_py39.py!}
+{!> ../../docs_src/security/tutorial001_an_py39.py!}
```
////
@@ -165,7 +165,7 @@ Wenn wir eine Instanz der Klasse `OAuth2PasswordBearer` erstellen, übergeben wi
//// tab | Python 3.8+
```Python hl_lines="7"
-{!> ../../../docs_src/security/tutorial001_an.py!}
+{!> ../../docs_src/security/tutorial001_an.py!}
```
////
@@ -179,7 +179,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="6"
-{!> ../../../docs_src/security/tutorial001.py!}
+{!> ../../docs_src/security/tutorial001.py!}
```
////
@@ -223,7 +223,7 @@ Jetzt können Sie dieses `oauth2_scheme` als Abhängigkeit `Depends` übergeben.
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/security/tutorial001_an_py39.py!}
+{!> ../../docs_src/security/tutorial001_an_py39.py!}
```
////
@@ -231,7 +231,7 @@ Jetzt können Sie dieses `oauth2_scheme` als Abhängigkeit `Depends` übergeben.
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/security/tutorial001_an.py!}
+{!> ../../docs_src/security/tutorial001_an.py!}
```
////
@@ -245,7 +245,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="10"
-{!> ../../../docs_src/security/tutorial001.py!}
+{!> ../../docs_src/security/tutorial001.py!}
```
////
diff --git a/docs/de/docs/tutorial/security/get-current-user.md b/docs/de/docs/tutorial/security/get-current-user.md
index 8a68deeef..a9478a36e 100644
--- a/docs/de/docs/tutorial/security/get-current-user.md
+++ b/docs/de/docs/tutorial/security/get-current-user.md
@@ -5,7 +5,7 @@ Im vorherigen Kapitel hat das Sicherheitssystem (das auf dem Dependency Injectio
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/security/tutorial001_an_py39.py!}
+{!> ../../docs_src/security/tutorial001_an_py39.py!}
```
////
@@ -13,7 +13,7 @@ Im vorherigen Kapitel hat das Sicherheitssystem (das auf dem Dependency Injectio
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/security/tutorial001_an.py!}
+{!> ../../docs_src/security/tutorial001_an.py!}
```
////
@@ -27,7 +27,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="10"
-{!> ../../../docs_src/security/tutorial001.py!}
+{!> ../../docs_src/security/tutorial001.py!}
```
////
@@ -45,7 +45,7 @@ So wie wir Pydantic zum Deklarieren von Bodys verwenden, können wir es auch üb
//// tab | Python 3.10+
```Python hl_lines="5 12-16"
-{!> ../../../docs_src/security/tutorial002_an_py310.py!}
+{!> ../../docs_src/security/tutorial002_an_py310.py!}
```
////
@@ -53,7 +53,7 @@ So wie wir Pydantic zum Deklarieren von Bodys verwenden, können wir es auch üb
//// tab | Python 3.9+
```Python hl_lines="5 12-16"
-{!> ../../../docs_src/security/tutorial002_an_py39.py!}
+{!> ../../docs_src/security/tutorial002_an_py39.py!}
```
////
@@ -61,7 +61,7 @@ So wie wir Pydantic zum Deklarieren von Bodys verwenden, können wir es auch üb
//// tab | Python 3.8+
```Python hl_lines="5 13-17"
-{!> ../../../docs_src/security/tutorial002_an.py!}
+{!> ../../docs_src/security/tutorial002_an.py!}
```
////
@@ -75,7 +75,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="3 10-14"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -89,7 +89,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="5 12-16"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -107,7 +107,7 @@ So wie wir es zuvor in der *Pfadoperation* direkt gemacht haben, erhält unsere
//// tab | Python 3.10+
```Python hl_lines="25"
-{!> ../../../docs_src/security/tutorial002_an_py310.py!}
+{!> ../../docs_src/security/tutorial002_an_py310.py!}
```
////
@@ -115,7 +115,7 @@ So wie wir es zuvor in der *Pfadoperation* direkt gemacht haben, erhält unsere
//// tab | Python 3.9+
```Python hl_lines="25"
-{!> ../../../docs_src/security/tutorial002_an_py39.py!}
+{!> ../../docs_src/security/tutorial002_an_py39.py!}
```
////
@@ -123,7 +123,7 @@ So wie wir es zuvor in der *Pfadoperation* direkt gemacht haben, erhält unsere
//// tab | Python 3.8+
```Python hl_lines="26"
-{!> ../../../docs_src/security/tutorial002_an.py!}
+{!> ../../docs_src/security/tutorial002_an.py!}
```
////
@@ -137,7 +137,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="23"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -151,7 +151,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="25"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -163,7 +163,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.10+
```Python hl_lines="19-22 26-27"
-{!> ../../../docs_src/security/tutorial002_an_py310.py!}
+{!> ../../docs_src/security/tutorial002_an_py310.py!}
```
////
@@ -171,7 +171,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.9+
```Python hl_lines="19-22 26-27"
-{!> ../../../docs_src/security/tutorial002_an_py39.py!}
+{!> ../../docs_src/security/tutorial002_an_py39.py!}
```
////
@@ -179,7 +179,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+
```Python hl_lines="20-23 27-28"
-{!> ../../../docs_src/security/tutorial002_an.py!}
+{!> ../../docs_src/security/tutorial002_an.py!}
```
////
@@ -193,7 +193,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="17-20 24-25"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -207,7 +207,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="19-22 26-27"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -219,7 +219,7 @@ Und jetzt können wir wiederum `Depends` mit unserem `get_current_user` in der *
//// tab | Python 3.10+
```Python hl_lines="31"
-{!> ../../../docs_src/security/tutorial002_an_py310.py!}
+{!> ../../docs_src/security/tutorial002_an_py310.py!}
```
////
@@ -227,7 +227,7 @@ Und jetzt können wir wiederum `Depends` mit unserem `get_current_user` in der *
//// tab | Python 3.9+
```Python hl_lines="31"
-{!> ../../../docs_src/security/tutorial002_an_py39.py!}
+{!> ../../docs_src/security/tutorial002_an_py39.py!}
```
////
@@ -235,7 +235,7 @@ Und jetzt können wir wiederum `Depends` mit unserem `get_current_user` in der *
//// tab | Python 3.8+
```Python hl_lines="32"
-{!> ../../../docs_src/security/tutorial002_an.py!}
+{!> ../../docs_src/security/tutorial002_an.py!}
```
////
@@ -249,7 +249,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="29"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -263,7 +263,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="31"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -323,7 +323,7 @@ Und alle diese Tausenden von *Pfadoperationen* können nur drei Zeilen lang sein
//// tab | Python 3.10+
```Python hl_lines="30-32"
-{!> ../../../docs_src/security/tutorial002_an_py310.py!}
+{!> ../../docs_src/security/tutorial002_an_py310.py!}
```
////
@@ -331,7 +331,7 @@ Und alle diese Tausenden von *Pfadoperationen* können nur drei Zeilen lang sein
//// tab | Python 3.9+
```Python hl_lines="30-32"
-{!> ../../../docs_src/security/tutorial002_an_py39.py!}
+{!> ../../docs_src/security/tutorial002_an_py39.py!}
```
////
@@ -339,7 +339,7 @@ Und alle diese Tausenden von *Pfadoperationen* können nur drei Zeilen lang sein
//// tab | Python 3.8+
```Python hl_lines="31-33"
-{!> ../../../docs_src/security/tutorial002_an.py!}
+{!> ../../docs_src/security/tutorial002_an.py!}
```
////
@@ -353,7 +353,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="28-30"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -367,7 +367,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="30-32"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
diff --git a/docs/de/docs/tutorial/security/oauth2-jwt.md b/docs/de/docs/tutorial/security/oauth2-jwt.md
index 88f0dbe42..79e817840 100644
--- a/docs/de/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/de/docs/tutorial/security/oauth2-jwt.md
@@ -121,7 +121,7 @@ Und noch eine, um einen Benutzer zu authentifizieren und zurückzugeben.
//// tab | Python 3.10+
```Python hl_lines="7 48 55-56 59-60 69-75"
-{!> ../../../docs_src/security/tutorial004_an_py310.py!}
+{!> ../../docs_src/security/tutorial004_an_py310.py!}
```
////
@@ -129,7 +129,7 @@ Und noch eine, um einen Benutzer zu authentifizieren und zurückzugeben.
//// tab | Python 3.9+
```Python hl_lines="7 48 55-56 59-60 69-75"
-{!> ../../../docs_src/security/tutorial004_an_py39.py!}
+{!> ../../docs_src/security/tutorial004_an_py39.py!}
```
////
@@ -137,7 +137,7 @@ Und noch eine, um einen Benutzer zu authentifizieren und zurückzugeben.
//// tab | Python 3.8+
```Python hl_lines="7 49 56-57 60-61 70-76"
-{!> ../../../docs_src/security/tutorial004_an.py!}
+{!> ../../docs_src/security/tutorial004_an.py!}
```
////
@@ -151,7 +151,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="6 47 54-55 58-59 68-74"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -165,7 +165,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="7 48 55-56 59-60 69-75"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
@@ -207,7 +207,7 @@ Erstellen Sie eine Hilfsfunktion, um einen neuen Zugriffstoken zu generieren.
//// tab | Python 3.10+
```Python hl_lines="6 12-14 28-30 78-86"
-{!> ../../../docs_src/security/tutorial004_an_py310.py!}
+{!> ../../docs_src/security/tutorial004_an_py310.py!}
```
////
@@ -215,7 +215,7 @@ Erstellen Sie eine Hilfsfunktion, um einen neuen Zugriffstoken zu generieren.
//// tab | Python 3.9+
```Python hl_lines="6 12-14 28-30 78-86"
-{!> ../../../docs_src/security/tutorial004_an_py39.py!}
+{!> ../../docs_src/security/tutorial004_an_py39.py!}
```
////
@@ -223,7 +223,7 @@ Erstellen Sie eine Hilfsfunktion, um einen neuen Zugriffstoken zu generieren.
//// tab | Python 3.8+
```Python hl_lines="6 13-15 29-31 79-87"
-{!> ../../../docs_src/security/tutorial004_an.py!}
+{!> ../../docs_src/security/tutorial004_an.py!}
```
////
@@ -237,7 +237,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="5 11-13 27-29 77-85"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -251,7 +251,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="6 12-14 28-30 78-86"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
@@ -267,7 +267,7 @@ Wenn der Token ungültig ist, geben Sie sofort einen HTTP-Fehler zurück.
//// tab | Python 3.10+
```Python hl_lines="89-106"
-{!> ../../../docs_src/security/tutorial004_an_py310.py!}
+{!> ../../docs_src/security/tutorial004_an_py310.py!}
```
////
@@ -275,7 +275,7 @@ Wenn der Token ungültig ist, geben Sie sofort einen HTTP-Fehler zurück.
//// tab | Python 3.9+
```Python hl_lines="89-106"
-{!> ../../../docs_src/security/tutorial004_an_py39.py!}
+{!> ../../docs_src/security/tutorial004_an_py39.py!}
```
////
@@ -283,7 +283,7 @@ Wenn der Token ungültig ist, geben Sie sofort einen HTTP-Fehler zurück.
//// tab | Python 3.8+
```Python hl_lines="90-107"
-{!> ../../../docs_src/security/tutorial004_an.py!}
+{!> ../../docs_src/security/tutorial004_an.py!}
```
////
@@ -297,7 +297,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="88-105"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -311,7 +311,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="89-106"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
@@ -325,7 +325,7 @@ Erstellen Sie einen echten JWT-Zugriffstoken und geben Sie ihn zurück.
//// tab | Python 3.10+
```Python hl_lines="117-132"
-{!> ../../../docs_src/security/tutorial004_an_py310.py!}
+{!> ../../docs_src/security/tutorial004_an_py310.py!}
```
////
@@ -333,7 +333,7 @@ Erstellen Sie einen echten JWT-Zugriffstoken und geben Sie ihn zurück.
//// tab | Python 3.9+
```Python hl_lines="117-132"
-{!> ../../../docs_src/security/tutorial004_an_py39.py!}
+{!> ../../docs_src/security/tutorial004_an_py39.py!}
```
////
@@ -341,7 +341,7 @@ Erstellen Sie einen echten JWT-Zugriffstoken und geben Sie ihn zurück.
//// tab | Python 3.8+
```Python hl_lines="118-133"
-{!> ../../../docs_src/security/tutorial004_an.py!}
+{!> ../../docs_src/security/tutorial004_an.py!}
```
////
@@ -355,7 +355,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="114-129"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -369,7 +369,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="115-130"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
diff --git a/docs/de/docs/tutorial/security/simple-oauth2.md b/docs/de/docs/tutorial/security/simple-oauth2.md
index 3b1c4ae28..4c20fae55 100644
--- a/docs/de/docs/tutorial/security/simple-oauth2.md
+++ b/docs/de/docs/tutorial/security/simple-oauth2.md
@@ -55,7 +55,7 @@ Importieren Sie zunächst `OAuth2PasswordRequestForm` und verwenden Sie es als A
//// tab | Python 3.10+
```Python hl_lines="4 78"
-{!> ../../../docs_src/security/tutorial003_an_py310.py!}
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
```
////
@@ -63,7 +63,7 @@ Importieren Sie zunächst `OAuth2PasswordRequestForm` und verwenden Sie es als A
//// tab | Python 3.9+
```Python hl_lines="4 78"
-{!> ../../../docs_src/security/tutorial003_an_py39.py!}
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
```
////
@@ -71,7 +71,7 @@ Importieren Sie zunächst `OAuth2PasswordRequestForm` und verwenden Sie es als A
//// tab | Python 3.8+
```Python hl_lines="4 79"
-{!> ../../../docs_src/security/tutorial003_an.py!}
+{!> ../../docs_src/security/tutorial003_an.py!}
```
////
@@ -85,7 +85,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="2 74"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -99,7 +99,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="4 76"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -153,7 +153,7 @@ Für den Fehler verwenden wir die Exception `HTTPException`:
//// tab | Python 3.10+
```Python hl_lines="3 79-81"
-{!> ../../../docs_src/security/tutorial003_an_py310.py!}
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
```
////
@@ -161,7 +161,7 @@ Für den Fehler verwenden wir die Exception `HTTPException`:
//// tab | Python 3.9+
```Python hl_lines="3 79-81"
-{!> ../../../docs_src/security/tutorial003_an_py39.py!}
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
```
////
@@ -169,7 +169,7 @@ Für den Fehler verwenden wir die Exception `HTTPException`:
//// tab | Python 3.8+
```Python hl_lines="3 80-82"
-{!> ../../../docs_src/security/tutorial003_an.py!}
+{!> ../../docs_src/security/tutorial003_an.py!}
```
////
@@ -183,7 +183,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="1 75-77"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -197,7 +197,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="3 77-79"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -229,7 +229,7 @@ Der Dieb kann also nicht versuchen, die gleichen Passwörter in einem anderen Sy
//// tab | Python 3.10+
```Python hl_lines="82-85"
-{!> ../../../docs_src/security/tutorial003_an_py310.py!}
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
```
////
@@ -237,7 +237,7 @@ Der Dieb kann also nicht versuchen, die gleichen Passwörter in einem anderen Sy
//// tab | Python 3.9+
```Python hl_lines="82-85"
-{!> ../../../docs_src/security/tutorial003_an_py39.py!}
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
```
////
@@ -245,7 +245,7 @@ Der Dieb kann also nicht versuchen, die gleichen Passwörter in einem anderen Sy
//// tab | Python 3.8+
```Python hl_lines="83-86"
-{!> ../../../docs_src/security/tutorial003_an.py!}
+{!> ../../docs_src/security/tutorial003_an.py!}
```
////
@@ -259,7 +259,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="78-81"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -273,7 +273,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="80-83"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -321,7 +321,7 @@ Aber konzentrieren wir uns zunächst auf die spezifischen Details, die wir benö
//// tab | Python 3.10+
```Python hl_lines="87"
-{!> ../../../docs_src/security/tutorial003_an_py310.py!}
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
```
////
@@ -329,7 +329,7 @@ Aber konzentrieren wir uns zunächst auf die spezifischen Details, die wir benö
//// tab | Python 3.9+
```Python hl_lines="87"
-{!> ../../../docs_src/security/tutorial003_an_py39.py!}
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
```
////
@@ -337,7 +337,7 @@ Aber konzentrieren wir uns zunächst auf die spezifischen Details, die wir benö
//// tab | Python 3.8+
```Python hl_lines="88"
-{!> ../../../docs_src/security/tutorial003_an.py!}
+{!> ../../docs_src/security/tutorial003_an.py!}
```
////
@@ -351,7 +351,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="83"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -365,7 +365,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="85"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -397,7 +397,7 @@ In unserem Endpunkt erhalten wir also nur dann einen Benutzer, wenn der Benutzer
//// tab | Python 3.10+
```Python hl_lines="58-66 69-74 94"
-{!> ../../../docs_src/security/tutorial003_an_py310.py!}
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
```
////
@@ -405,7 +405,7 @@ In unserem Endpunkt erhalten wir also nur dann einen Benutzer, wenn der Benutzer
//// tab | Python 3.9+
```Python hl_lines="58-66 69-74 94"
-{!> ../../../docs_src/security/tutorial003_an_py39.py!}
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
```
////
@@ -413,7 +413,7 @@ In unserem Endpunkt erhalten wir also nur dann einen Benutzer, wenn der Benutzer
//// tab | Python 3.8+
```Python hl_lines="59-67 70-75 95"
-{!> ../../../docs_src/security/tutorial003_an.py!}
+{!> ../../docs_src/security/tutorial003_an.py!}
```
////
@@ -427,7 +427,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="56-64 67-70 88"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -441,7 +441,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python hl_lines="58-66 69-72 90"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
diff --git a/docs/de/docs/tutorial/static-files.md b/docs/de/docs/tutorial/static-files.md
index cca8cd0ea..4afd251aa 100644
--- a/docs/de/docs/tutorial/static-files.md
+++ b/docs/de/docs/tutorial/static-files.md
@@ -8,7 +8,7 @@ Mit `StaticFiles` können Sie statische Dateien aus einem Verzeichnis automatisc
* „Mounten“ Sie eine `StaticFiles()`-Instanz in einem bestimmten Pfad.
```Python hl_lines="2 6"
-{!../../../docs_src/static_files/tutorial001.py!}
+{!../../docs_src/static_files/tutorial001.py!}
```
/// note | "Technische Details"
diff --git a/docs/de/docs/tutorial/testing.md b/docs/de/docs/tutorial/testing.md
index 43ced2aae..bda6d7d60 100644
--- a/docs/de/docs/tutorial/testing.md
+++ b/docs/de/docs/tutorial/testing.md
@@ -27,7 +27,7 @@ Verwenden Sie das `TestClient`-Objekt auf die gleiche Weise wie `httpx`.
Schreiben Sie einfache `assert`-Anweisungen mit den Standard-Python-Ausdrücken, die Sie überprüfen müssen (wiederum, Standard-`pytest`).
```Python hl_lines="2 12 15-18"
-{!../../../docs_src/app_testing/tutorial001.py!}
+{!../../docs_src/app_testing/tutorial001.py!}
```
/// tip | "Tipp"
@@ -75,7 +75,7 @@ In der Datei `main.py` haben Sie Ihre **FastAPI**-Anwendung:
```Python
-{!../../../docs_src/app_testing/main.py!}
+{!../../docs_src/app_testing/main.py!}
```
### Testdatei
@@ -93,7 +93,7 @@ Dann könnten Sie eine Datei `test_main.py` mit Ihren Tests haben. Sie könnte s
Da sich diese Datei im selben Package befindet, können Sie relative Importe verwenden, um das Objekt `app` aus dem `main`-Modul (`main.py`) zu importieren:
```Python hl_lines="3"
-{!../../../docs_src/app_testing/test_main.py!}
+{!../../docs_src/app_testing/test_main.py!}
```
... und haben den Code für die Tests wie zuvor.
@@ -125,7 +125,7 @@ Beide *Pfadoperationen* erfordern einen `X-Token`-Header.
//// tab | Python 3.10+
```Python
-{!> ../../../docs_src/app_testing/app_b_an_py310/main.py!}
+{!> ../../docs_src/app_testing/app_b_an_py310/main.py!}
```
////
@@ -133,7 +133,7 @@ Beide *Pfadoperationen* erfordern einen `X-Token`-Header.
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/app_testing/app_b_an_py39/main.py!}
+{!> ../../docs_src/app_testing/app_b_an_py39/main.py!}
```
////
@@ -141,7 +141,7 @@ Beide *Pfadoperationen* erfordern einen `X-Token`-Header.
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/app_testing/app_b_an/main.py!}
+{!> ../../docs_src/app_testing/app_b_an/main.py!}
```
////
@@ -155,7 +155,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python
-{!> ../../../docs_src/app_testing/app_b_py310/main.py!}
+{!> ../../docs_src/app_testing/app_b_py310/main.py!}
```
////
@@ -169,7 +169,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
///
```Python
-{!> ../../../docs_src/app_testing/app_b/main.py!}
+{!> ../../docs_src/app_testing/app_b/main.py!}
```
////
@@ -179,7 +179,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
Anschließend könnten Sie `test_main.py` mit den erweiterten Tests aktualisieren:
```Python
-{!> ../../../docs_src/app_testing/app_b/test_main.py!}
+{!> ../../docs_src/app_testing/app_b/test_main.py!}
```
Wenn Sie möchten, dass der Client Informationen im Request übergibt und Sie nicht wissen, wie das geht, können Sie suchen (googeln), wie es mit `httpx` gemacht wird, oder sogar, wie es mit `requests` gemacht wird, da das Design von HTTPX auf dem Design von Requests basiert.
diff --git a/docs/em/docs/advanced/additional-responses.md b/docs/em/docs/advanced/additional-responses.md
index 7a70718c5..e4442135e 100644
--- a/docs/em/docs/advanced/additional-responses.md
+++ b/docs/em/docs/advanced/additional-responses.md
@@ -27,7 +27,7 @@
🖼, 📣 ➕1️⃣ 📨 ⏮️ 👔 📟 `404` & Pydantic 🏷 `Message`, 👆 💪 ✍:
```Python hl_lines="18 22"
-{!../../../docs_src/additional_responses/tutorial001.py!}
+{!../../docs_src/additional_responses/tutorial001.py!}
```
/// note
@@ -178,7 +178,7 @@
🖼, 👆 💪 🚮 🌖 📻 🆎 `image/png`, 📣 👈 👆 *➡ 🛠️* 💪 📨 🎻 🎚 (⏮️ 📻 🆎 `application/json`) ⚖️ 🇩🇴 🖼:
```Python hl_lines="19-24 28"
-{!../../../docs_src/additional_responses/tutorial002.py!}
+{!../../docs_src/additional_responses/tutorial002.py!}
```
/// note
@@ -208,7 +208,7 @@
& 📨 ⏮️ 👔 📟 `200` 👈 ⚙️ 👆 `response_model`, ✋️ 🔌 🛃 `example`:
```Python hl_lines="20-31"
-{!../../../docs_src/additional_responses/tutorial003.py!}
+{!../../docs_src/additional_responses/tutorial003.py!}
```
⚫️ 🔜 🌐 🌀 & 🔌 👆 🗄, & 🎦 🛠️ 🩺:
@@ -244,7 +244,7 @@ new_dict = {**old_dict, "new key": "new value"}
🖼:
```Python hl_lines="13-17 26"
-{!../../../docs_src/additional_responses/tutorial004.py!}
+{!../../docs_src/additional_responses/tutorial004.py!}
```
## 🌖 ℹ 🔃 🗄 📨
diff --git a/docs/em/docs/advanced/additional-status-codes.md b/docs/em/docs/advanced/additional-status-codes.md
index 3f3b0aea4..7a50e1bca 100644
--- a/docs/em/docs/advanced/additional-status-codes.md
+++ b/docs/em/docs/advanced/additional-status-codes.md
@@ -15,7 +15,7 @@
🏆 👈, 🗄 `JSONResponse`, & 📨 👆 🎚 📤 🔗, ⚒ `status_code` 👈 👆 💚:
```Python hl_lines="4 25"
-{!../../../docs_src/additional_status_codes/tutorial001.py!}
+{!../../docs_src/additional_status_codes/tutorial001.py!}
```
/// warning
diff --git a/docs/em/docs/advanced/advanced-dependencies.md b/docs/em/docs/advanced/advanced-dependencies.md
index 22044c783..721428ce4 100644
--- a/docs/em/docs/advanced/advanced-dependencies.md
+++ b/docs/em/docs/advanced/advanced-dependencies.md
@@ -19,7 +19,7 @@
👈, 👥 📣 👩🔬 `__call__`:
```Python hl_lines="10"
-{!../../../docs_src/dependencies/tutorial011.py!}
+{!../../docs_src/dependencies/tutorial011.py!}
```
👉 💼, 👉 `__call__` ⚫️❔ **FastAPI** 🔜 ⚙️ ✅ 🌖 🔢 & 🎧-🔗, & 👉 ⚫️❔ 🔜 🤙 🚶♀️ 💲 🔢 👆 *➡ 🛠️ 🔢* ⏪.
@@ -29,7 +29,7 @@
& 🔜, 👥 💪 ⚙️ `__init__` 📣 🔢 👐 👈 👥 💪 ⚙️ "🔗" 🔗:
```Python hl_lines="7"
-{!../../../docs_src/dependencies/tutorial011.py!}
+{!../../docs_src/dependencies/tutorial011.py!}
```
👉 💼, **FastAPI** 🏆 🚫 ⏱ 👆 ⚖️ 💅 🔃 `__init__`, 👥 🔜 ⚙️ ⚫️ 🔗 👆 📟.
@@ -39,7 +39,7 @@
👥 💪 ✍ 👐 👉 🎓 ⏮️:
```Python hl_lines="16"
-{!../../../docs_src/dependencies/tutorial011.py!}
+{!../../docs_src/dependencies/tutorial011.py!}
```
& 👈 🌌 👥 💪 "🔗" 👆 🔗, 👈 🔜 ✔️ `"bar"` 🔘 ⚫️, 🔢 `checker.fixed_content`.
@@ -57,7 +57,7 @@ checker(q="somequery")
...& 🚶♀️ ⚫️❔ 👈 📨 💲 🔗 👆 *➡ 🛠️ 🔢* 🔢 `fixed_content_included`:
```Python hl_lines="20"
-{!../../../docs_src/dependencies/tutorial011.py!}
+{!../../docs_src/dependencies/tutorial011.py!}
```
/// tip
diff --git a/docs/em/docs/advanced/async-tests.md b/docs/em/docs/advanced/async-tests.md
index 11f885fe6..4d468acd4 100644
--- a/docs/em/docs/advanced/async-tests.md
+++ b/docs/em/docs/advanced/async-tests.md
@@ -33,13 +33,13 @@
📁 `main.py` 🔜 ✔️:
```Python
-{!../../../docs_src/async_tests/main.py!}
+{!../../docs_src/async_tests/main.py!}
```
📁 `test_main.py` 🔜 ✔️ 💯 `main.py`, ⚫️ 💪 👀 💖 👉 🔜:
```Python
-{!../../../docs_src/async_tests/test_main.py!}
+{!../../docs_src/async_tests/test_main.py!}
```
## 🏃 ⚫️
@@ -61,7 +61,7 @@ $ pytest
📑 `@pytest.mark.anyio` 💬 ✳ 👈 👉 💯 🔢 🔜 🤙 🔁:
```Python hl_lines="7"
-{!../../../docs_src/async_tests/test_main.py!}
+{!../../docs_src/async_tests/test_main.py!}
```
/// tip
@@ -73,7 +73,7 @@ $ pytest
⤴️ 👥 💪 ✍ `AsyncClient` ⏮️ 📱, & 📨 🔁 📨 ⚫️, ⚙️ `await`.
```Python hl_lines="9-12"
-{!../../../docs_src/async_tests/test_main.py!}
+{!../../docs_src/async_tests/test_main.py!}
```
👉 🌓:
diff --git a/docs/em/docs/advanced/behind-a-proxy.md b/docs/em/docs/advanced/behind-a-proxy.md
index bb65e1487..e66ddccf7 100644
--- a/docs/em/docs/advanced/behind-a-proxy.md
+++ b/docs/em/docs/advanced/behind-a-proxy.md
@@ -95,7 +95,7 @@ $ uvicorn main:app --root-path /api/v1
📥 👥 ✅ ⚫️ 📧 🎦 🎯.
```Python hl_lines="8"
-{!../../../docs_src/behind_a_proxy/tutorial001.py!}
+{!../../docs_src/behind_a_proxy/tutorial001.py!}
```
⤴️, 🚥 👆 ▶️ Uvicorn ⏮️:
@@ -124,7 +124,7 @@ $ uvicorn main:app --root-path /api/v1
👐, 🚥 👆 🚫 ✔️ 🌌 🚚 📋 ⏸ 🎛 💖 `--root-path` ⚖️ 🌓, 👆 💪 ⚒ `root_path` 🔢 🕐❔ 🏗 👆 FastAPI 📱:
```Python hl_lines="3"
-{!../../../docs_src/behind_a_proxy/tutorial002.py!}
+{!../../docs_src/behind_a_proxy/tutorial002.py!}
```
🚶♀️ `root_path` `FastAPI` 🔜 🌓 🚶♀️ `--root-path` 📋 ⏸ 🎛 Uvicorn ⚖️ Hypercorn.
@@ -306,7 +306,7 @@ $ uvicorn main:app --root-path /api/v1
🖼:
```Python hl_lines="4-7"
-{!../../../docs_src/behind_a_proxy/tutorial003.py!}
+{!../../docs_src/behind_a_proxy/tutorial003.py!}
```
🔜 🏗 🗄 🔗 💖:
@@ -355,7 +355,7 @@ $ uvicorn main:app --root-path /api/v1
🚥 👆 🚫 💚 **FastAPI** 🔌 🏧 💽 ⚙️ `root_path`, 👆 💪 ⚙️ 🔢 `root_path_in_servers=False`:
```Python hl_lines="9"
-{!../../../docs_src/behind_a_proxy/tutorial004.py!}
+{!../../docs_src/behind_a_proxy/tutorial004.py!}
```
& ⤴️ ⚫️ 🏆 🚫 🔌 ⚫️ 🗄 🔗.
diff --git a/docs/em/docs/advanced/custom-response.md b/docs/em/docs/advanced/custom-response.md
index eec87b91b..7147a4536 100644
--- a/docs/em/docs/advanced/custom-response.md
+++ b/docs/em/docs/advanced/custom-response.md
@@ -31,7 +31,7 @@
✋️ 🚥 👆 🎯 👈 🎚 👈 👆 🛬 **🎻 ⏮️ 🎻**, 👆 💪 🚶♀️ ⚫️ 🔗 📨 🎓 & ❎ ➕ 🌥 👈 FastAPI 🔜 ✔️ 🚶♀️ 👆 📨 🎚 🔘 `jsonable_encoder` ⏭ 🚶♀️ ⚫️ 📨 🎓.
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial001b.py!}
+{!../../docs_src/custom_response/tutorial001b.py!}
```
/// info
@@ -58,7 +58,7 @@
* 🚶♀️ `HTMLResponse` 🔢 `response_class` 👆 *➡ 🛠️ 👨🎨*.
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial002.py!}
+{!../../docs_src/custom_response/tutorial002.py!}
```
/// info
@@ -78,7 +78,7 @@
🎏 🖼 ⚪️➡️ 🔛, 🛬 `HTMLResponse`, 💪 👀 💖:
```Python hl_lines="2 7 19"
-{!../../../docs_src/custom_response/tutorial003.py!}
+{!../../docs_src/custom_response/tutorial003.py!}
```
/// warning
@@ -104,7 +104,7 @@
🖼, ⚫️ 💪 🕳 💖:
```Python hl_lines="7 21 23"
-{!../../../docs_src/custom_response/tutorial004.py!}
+{!../../docs_src/custom_response/tutorial004.py!}
```
👉 🖼, 🔢 `generate_html_response()` ⏪ 🏗 & 📨 `Response` ↩️ 🛬 🕸 `str`.
@@ -145,7 +145,7 @@
FastAPI (🤙 💃) 🔜 🔁 🔌 🎚-📐 🎚. ⚫️ 🔜 🔌 🎚-🆎 🎚, ⚓️ 🔛 = & 🔁 = ✍ 🆎.
```Python hl_lines="1 18"
-{!../../../docs_src/response_directly/tutorial002.py!}
+{!../../docs_src/response_directly/tutorial002.py!}
```
### `HTMLResponse`
@@ -157,7 +157,7 @@ FastAPI (🤙 💃) 🔜 🔁 🔌 🎚-📐 🎚. ⚫️ 🔜 🔌 🎚-🆎
✊ ✍ ⚖️ 🔢 & 📨 ✅ ✍ 📨.
```Python hl_lines="2 7 9"
-{!../../../docs_src/custom_response/tutorial005.py!}
+{!../../docs_src/custom_response/tutorial005.py!}
```
### `JSONResponse`
@@ -181,7 +181,7 @@ FastAPI (🤙 💃) 🔜 🔁 🔌 🎚-📐 🎚. ⚫️ 🔜 🔌 🎚-🆎
///
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial001.py!}
+{!../../docs_src/custom_response/tutorial001.py!}
```
/// tip
@@ -197,7 +197,7 @@ FastAPI (🤙 💃) 🔜 🔁 🔌 🎚-📐 🎚. ⚫️ 🔜 🔌 🎚-🆎
👆 💪 📨 `RedirectResponse` 🔗:
```Python hl_lines="2 9"
-{!../../../docs_src/custom_response/tutorial006.py!}
+{!../../docs_src/custom_response/tutorial006.py!}
```
---
@@ -206,7 +206,7 @@ FastAPI (🤙 💃) 🔜 🔁 🔌 🎚-📐 🎚. ⚫️ 🔜 🔌 🎚-🆎
```Python hl_lines="2 7 9"
-{!../../../docs_src/custom_response/tutorial006b.py!}
+{!../../docs_src/custom_response/tutorial006b.py!}
```
🚥 👆 👈, ⤴️ 👆 💪 📨 📛 🔗 ⚪️➡️ 👆 *➡ 🛠️* 🔢.
@@ -218,7 +218,7 @@ FastAPI (🤙 💃) 🔜 🔁 🔌 🎚-📐 🎚. ⚫️ 🔜 🔌 🎚-🆎
👆 💪 ⚙️ `status_code` 🔢 🌀 ⏮️ `response_class` 🔢:
```Python hl_lines="2 7 9"
-{!../../../docs_src/custom_response/tutorial006c.py!}
+{!../../docs_src/custom_response/tutorial006c.py!}
```
### `StreamingResponse`
@@ -226,7 +226,7 @@ FastAPI (🤙 💃) 🔜 🔁 🔌 🎚-📐 🎚. ⚫️ 🔜 🔌 🎚-🆎
✊ 🔁 🚂 ⚖️ 😐 🚂/🎻 & 🎏 📨 💪.
```Python hl_lines="2 14"
-{!../../../docs_src/custom_response/tutorial007.py!}
+{!../../docs_src/custom_response/tutorial007.py!}
```
#### ⚙️ `StreamingResponse` ⏮️ 📁-💖 🎚
@@ -238,7 +238,7 @@ FastAPI (🤙 💃) 🔜 🔁 🔌 🎚-📐 🎚. ⚫️ 🔜 🔌 🎚-🆎
👉 🔌 📚 🗃 🔗 ⏮️ ☁ 💾, 📹 🏭, & 🎏.
```{ .python .annotate hl_lines="2 10-12 14" }
-{!../../../docs_src/custom_response/tutorial008.py!}
+{!../../docs_src/custom_response/tutorial008.py!}
```
1️⃣. 👉 🚂 🔢. ⚫️ "🚂 🔢" ↩️ ⚫️ 🔌 `yield` 📄 🔘.
@@ -269,13 +269,13 @@ FastAPI (🤙 💃) 🔜 🔁 🔌 🎚-📐 🎚. ⚫️ 🔜 🔌 🎚-🆎
📁 📨 🔜 🔌 ☑ `Content-Length`, `Last-Modified` & `ETag` 🎚.
```Python hl_lines="2 10"
-{!../../../docs_src/custom_response/tutorial009.py!}
+{!../../docs_src/custom_response/tutorial009.py!}
```
👆 💪 ⚙️ `response_class` 🔢:
```Python hl_lines="2 8 10"
-{!../../../docs_src/custom_response/tutorial009b.py!}
+{!../../docs_src/custom_response/tutorial009b.py!}
```
👉 💼, 👆 💪 📨 📁 ➡ 🔗 ⚪️➡️ 👆 *➡ 🛠️* 🔢.
@@ -291,7 +291,7 @@ FastAPI (🤙 💃) 🔜 🔁 🔌 🎚-📐 🎚. ⚫️ 🔜 🔌 🎚-🆎
👆 💪 ✍ `CustomORJSONResponse`. 👑 👜 👆 ✔️ ✍ `Response.render(content)` 👩🔬 👈 📨 🎚 `bytes`:
```Python hl_lines="9-14 17"
-{!../../../docs_src/custom_response/tutorial009c.py!}
+{!../../docs_src/custom_response/tutorial009c.py!}
```
🔜 ↩️ 🛬:
@@ -319,7 +319,7 @@ FastAPI (🤙 💃) 🔜 🔁 🔌 🎚-📐 🎚. ⚫️ 🔜 🔌 🎚-🆎
🖼 🔛, **FastAPI** 🔜 ⚙️ `ORJSONResponse` 🔢, 🌐 *➡ 🛠️*, ↩️ `JSONResponse`.
```Python hl_lines="2 4"
-{!../../../docs_src/custom_response/tutorial010.py!}
+{!../../docs_src/custom_response/tutorial010.py!}
```
/// tip
diff --git a/docs/em/docs/advanced/dataclasses.md b/docs/em/docs/advanced/dataclasses.md
index 3f49ef07c..ab76e5083 100644
--- a/docs/em/docs/advanced/dataclasses.md
+++ b/docs/em/docs/advanced/dataclasses.md
@@ -5,7 +5,7 @@ FastAPI 🏗 🔛 🔝 **Pydantic**, & 👤 ✔️ 🌏 👆 ❔ ⚙️ Pyda
✋️ FastAPI 🐕🦺 ⚙️ <a href="https://docs.python.org/3/library/dataclasses.html" class="external-link" target="_blank">`dataclasses`</a> 🎏 🌌:
```Python hl_lines="1 7-12 19-20"
-{!../../../docs_src/dataclasses/tutorial001.py!}
+{!../../docs_src/dataclasses/tutorial001.py!}
```
👉 🐕🦺 👏 **Pydantic**, ⚫️ ✔️ <a href="https://docs.pydantic.dev/latest/concepts/dataclasses/#use-of-stdlib-dataclasses-with-basemodel" class="external-link" target="_blank">🔗 🐕🦺 `dataclasses`</a>.
@@ -35,7 +35,7 @@ FastAPI 🏗 🔛 🔝 **Pydantic**, & 👤 ✔️ 🌏 👆 ❔ ⚙️ Pyda
👆 💪 ⚙️ `dataclasses` `response_model` 🔢:
```Python hl_lines="1 7-13 19"
-{!../../../docs_src/dataclasses/tutorial002.py!}
+{!../../docs_src/dataclasses/tutorial002.py!}
```
🎻 🔜 🔁 🗜 Pydantic 🎻.
@@ -53,7 +53,7 @@ FastAPI 🏗 🔛 🔝 **Pydantic**, & 👤 ✔️ 🌏 👆 ❔ ⚙️ Pyda
👈 💼, 👆 💪 🎯 💱 🐩 `dataclasses` ⏮️ `pydantic.dataclasses`, ❔ 💧-♻:
```{ .python .annotate hl_lines="1 5 8-11 14-17 23-25 28" }
-{!../../../docs_src/dataclasses/tutorial003.py!}
+{!../../docs_src/dataclasses/tutorial003.py!}
```
1️⃣. 👥 🗄 `field` ⚪️➡️ 🐩 `dataclasses`.
diff --git a/docs/em/docs/advanced/events.md b/docs/em/docs/advanced/events.md
index 12c902c18..2eae2b366 100644
--- a/docs/em/docs/advanced/events.md
+++ b/docs/em/docs/advanced/events.md
@@ -31,7 +31,7 @@
👥 ✍ 🔁 🔢 `lifespan()` ⏮️ `yield` 💖 👉:
```Python hl_lines="16 19"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
📥 👥 ⚖ 😥 *🕴* 🛠️ 🚚 🏷 🚮 (❌) 🏷 🔢 📖 ⏮️ 🎰 🏫 🏷 ⏭ `yield`. 👉 📟 🔜 🛠️ **⏭** 🈸 **▶️ ✊ 📨**, ⏮️ *🕴*.
@@ -51,7 +51,7 @@
🥇 👜 👀, 👈 👥 ⚖ 🔁 🔢 ⏮️ `yield`. 👉 📶 🎏 🔗 ⏮️ `yield`.
```Python hl_lines="14-19"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
🥇 🍕 🔢, ⏭ `yield`, 🔜 🛠️ **⏭** 🈸 ▶️.
@@ -65,7 +65,7 @@
👈 🗜 🔢 🔘 🕳 🤙 "**🔁 🔑 👨💼**".
```Python hl_lines="1 13"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
**🔑 👨💼** 🐍 🕳 👈 👆 💪 ⚙️ `with` 📄, 🖼, `open()` 💪 ⚙️ 🔑 👨💼:
@@ -89,7 +89,7 @@ async with lifespan(app):
`lifespan` 🔢 `FastAPI` 📱 ✊ **🔁 🔑 👨💼**, 👥 💪 🚶♀️ 👆 🆕 `lifespan` 🔁 🔑 👨💼 ⚫️.
```Python hl_lines="22"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
## 🎛 🎉 (😢)
@@ -113,7 +113,7 @@ async with lifespan(app):
🚮 🔢 👈 🔜 🏃 ⏭ 🈸 ▶️, 📣 ⚫️ ⏮️ 🎉 `"startup"`:
```Python hl_lines="8"
-{!../../../docs_src/events/tutorial001.py!}
+{!../../docs_src/events/tutorial001.py!}
```
👉 💼, `startup` 🎉 🐕🦺 🔢 🔜 🔢 🏬 "💽" ( `dict`) ⏮️ 💲.
@@ -127,7 +127,7 @@ async with lifespan(app):
🚮 🔢 👈 🔜 🏃 🕐❔ 🈸 🤫 🔽, 📣 ⚫️ ⏮️ 🎉 `"shutdown"`:
```Python hl_lines="6"
-{!../../../docs_src/events/tutorial002.py!}
+{!../../docs_src/events/tutorial002.py!}
```
📥, `shutdown` 🎉 🐕🦺 🔢 🔜 ✍ ✍ ⏸ `"Application shutdown"` 📁 `log.txt`.
diff --git a/docs/em/docs/advanced/generate-clients.md b/docs/em/docs/advanced/generate-clients.md
index c8e044340..f09d75623 100644
--- a/docs/em/docs/advanced/generate-clients.md
+++ b/docs/em/docs/advanced/generate-clients.md
@@ -19,7 +19,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9-11 14-15 18 19 23"
-{!> ../../../docs_src/generate_clients/tutorial001.py!}
+{!> ../../docs_src/generate_clients/tutorial001.py!}
```
////
@@ -27,7 +27,7 @@
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="7-9 12-13 16-17 21"
-{!> ../../../docs_src/generate_clients/tutorial001_py39.py!}
+{!> ../../docs_src/generate_clients/tutorial001_py39.py!}
```
////
@@ -139,7 +139,7 @@ frontend-app@1.0.0 generate-client /home/user/code/frontend-app
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="23 28 36"
-{!> ../../../docs_src/generate_clients/tutorial002.py!}
+{!> ../../docs_src/generate_clients/tutorial002.py!}
```
////
@@ -147,7 +147,7 @@ frontend-app@1.0.0 generate-client /home/user/code/frontend-app
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="21 26 34"
-{!> ../../../docs_src/generate_clients/tutorial002_py39.py!}
+{!> ../../docs_src/generate_clients/tutorial002_py39.py!}
```
////
@@ -200,7 +200,7 @@ FastAPI ⚙️ **😍 🆔** 🔠 *➡ 🛠️*, ⚫️ ⚙️ **🛠️ 🆔**
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="8-9 12"
-{!> ../../../docs_src/generate_clients/tutorial003.py!}
+{!> ../../docs_src/generate_clients/tutorial003.py!}
```
////
@@ -208,7 +208,7 @@ FastAPI ⚙️ **😍 🆔** 🔠 *➡ 🛠️*, ⚫️ ⚙️ **🛠️ 🆔**
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="6-7 10"
-{!> ../../../docs_src/generate_clients/tutorial003_py39.py!}
+{!> ../../docs_src/generate_clients/tutorial003_py39.py!}
```
////
@@ -234,7 +234,7 @@ FastAPI ⚙️ **😍 🆔** 🔠 *➡ 🛠️*, ⚫️ ⚙️ **🛠️ 🆔**
👥 💪 ⏬ 🗄 🎻 📁 `openapi.json` & ⤴️ 👥 💪 **❎ 👈 🔡 🔖** ⏮️ ✍ 💖 👉:
```Python
-{!../../../docs_src/generate_clients/tutorial004.py!}
+{!../../docs_src/generate_clients/tutorial004.py!}
```
⏮️ 👈, 🛠️ 🆔 🔜 📁 ⚪️➡️ 👜 💖 `items-get_items` `get_items`, 👈 🌌 👩💻 🚂 💪 🏗 🙅 👩🔬 📛.
diff --git a/docs/em/docs/advanced/middleware.md b/docs/em/docs/advanced/middleware.md
index e3cc389c6..23d2918d7 100644
--- a/docs/em/docs/advanced/middleware.md
+++ b/docs/em/docs/advanced/middleware.md
@@ -58,7 +58,7 @@ app.add_middleware(UnicornMiddleware, some_config="rainbow")
🙆 📨 📨 `http` ⚖️ `ws` 🔜 ❎ 🔐 ⚖ ↩️.
```Python hl_lines="2 6"
-{!../../../docs_src/advanced_middleware/tutorial001.py!}
+{!../../docs_src/advanced_middleware/tutorial001.py!}
```
## `TrustedHostMiddleware`
@@ -66,7 +66,7 @@ app.add_middleware(UnicornMiddleware, some_config="rainbow")
🛠️ 👈 🌐 📨 📨 ✔️ ☑ ⚒ `Host` 🎚, ✔ 💂♂ 🛡 🇺🇸🔍 🦠 🎚 👊.
```Python hl_lines="2 6-8"
-{!../../../docs_src/advanced_middleware/tutorial002.py!}
+{!../../docs_src/advanced_middleware/tutorial002.py!}
```
📄 ❌ 🐕🦺:
@@ -82,7 +82,7 @@ app.add_middleware(UnicornMiddleware, some_config="rainbow")
🛠️ 🔜 🍵 👯♂️ 🐩 & 🎥 📨.
```Python hl_lines="2 6"
-{!../../../docs_src/advanced_middleware/tutorial003.py!}
+{!../../docs_src/advanced_middleware/tutorial003.py!}
```
📄 ❌ 🐕🦺:
diff --git a/docs/em/docs/advanced/openapi-callbacks.md b/docs/em/docs/advanced/openapi-callbacks.md
index 00d54ebec..f7b5e7ed9 100644
--- a/docs/em/docs/advanced/openapi-callbacks.md
+++ b/docs/em/docs/advanced/openapi-callbacks.md
@@ -32,7 +32,7 @@
👉 🍕 📶 😐, 🌅 📟 🎲 ⏪ 😰 👆:
```Python hl_lines="9-13 36-53"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
/// tip
@@ -93,7 +93,7 @@ httpx.post(callback_url, json={"description": "Invoice paid", "paid": True})
🥇 ✍ 🆕 `APIRouter` 👈 🔜 🔌 1️⃣ ⚖️ 🌅 ⏲.
```Python hl_lines="3 25"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
### ✍ ⏲ *➡ 🛠️*
@@ -106,7 +106,7 @@ httpx.post(callback_url, json={"description": "Invoice paid", "paid": True})
* & ⚫️ 💪 ✔️ 📄 📨 ⚫️ 🔜 📨, ✅ `response_model=InvoiceEventReceived`.
```Python hl_lines="16-18 21-22 28-32"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
📤 2️⃣ 👑 🔺 ⚪️➡️ 😐 *➡ 🛠️*:
@@ -176,7 +176,7 @@ https://www.external.org/events/invoices/2expen51ve
🔜 ⚙️ 🔢 `callbacks` *👆 🛠️ ➡ 🛠️ 👨🎨* 🚶♀️ 🔢 `.routes` (👈 🤙 `list` 🛣/*➡ 🛠️*) ⚪️➡️ 👈 ⏲ 📻:
```Python hl_lines="35"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
/// tip
diff --git a/docs/em/docs/advanced/path-operation-advanced-configuration.md b/docs/em/docs/advanced/path-operation-advanced-configuration.md
index b684df26f..805bfdf30 100644
--- a/docs/em/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/em/docs/advanced/path-operation-advanced-configuration.md
@@ -13,7 +13,7 @@
👆 🔜 ✔️ ⚒ 💭 👈 ⚫️ 😍 🔠 🛠️.
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
```
### ⚙️ *➡ 🛠️ 🔢* 📛 {
@@ -23,7 +23,7 @@
👆 🔜 ⚫️ ⏮️ ❎ 🌐 👆 *➡ 🛠️*.
```Python hl_lines="2 12-21 24"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
```
/// tip
@@ -45,7 +45,7 @@
🚫 *➡ 🛠️* ⚪️➡️ 🏗 🗄 🔗 (& ➡️, ⚪️➡️ 🏧 🧾 ⚙️), ⚙️ 🔢 `include_in_schema` & ⚒ ⚫️ `False`:
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
```
## 🏧 📛 ⚪️➡️ #️⃣
@@ -57,7 +57,7 @@
⚫️ 🏆 🚫 🎦 🆙 🧾, ✋️ 🎏 🧰 (✅ 🐉) 🔜 💪 ⚙️ 🎂.
```Python hl_lines="19-29"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
```
## 🌖 📨
@@ -101,7 +101,7 @@
👉 `openapi_extra` 💪 👍, 🖼, 📣 [🗄 ↔](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#specificationExtensions):
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial005.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial005.py!}
```
🚥 👆 📂 🏧 🛠️ 🩺, 👆 ↔ 🔜 🎦 🆙 🔝 🎯 *➡ 🛠️*.
@@ -150,7 +150,7 @@
👆 💪 👈 ⏮️ `openapi_extra`:
```Python hl_lines="20-37 39-40"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial006.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial006.py!}
```
👉 🖼, 👥 🚫 📣 🙆 Pydantic 🏷. 👐, 📨 💪 🚫 <abbr title="converted from some plain format, like bytes, into Python objects">🎻</abbr> 🎻, ⚫️ ✍ 🔗 `bytes`, & 🔢 `magic_data_reader()` 🔜 🈚 🎻 ⚫️ 🌌.
@@ -166,7 +166,7 @@
🖼, 👉 🈸 👥 🚫 ⚙️ FastAPI 🛠️ 🛠️ ⚗ 🎻 🔗 ⚪️➡️ Pydantic 🏷 🚫 🏧 🔬 🎻. 👐, 👥 📣 📨 🎚 🆎 📁, 🚫 🎻:
```Python hl_lines="17-22 24"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
```
👐, 👐 👥 🚫 ⚙️ 🔢 🛠️ 🛠️, 👥 ⚙️ Pydantic 🏷 ❎ 🏗 🎻 🔗 💽 👈 👥 💚 📨 📁.
@@ -176,7 +176,7 @@
& ⤴️ 👆 📟, 👥 🎻 👈 📁 🎚 🔗, & ⤴️ 👥 🔄 ⚙️ 🎏 Pydantic 🏷 ✔ 📁 🎚:
```Python hl_lines="26-33"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
```
/// tip
diff --git a/docs/em/docs/advanced/response-change-status-code.md b/docs/em/docs/advanced/response-change-status-code.md
index 156efcc16..7f2e8c157 100644
--- a/docs/em/docs/advanced/response-change-status-code.md
+++ b/docs/em/docs/advanced/response-change-status-code.md
@@ -21,7 +21,7 @@
& ⤴️ 👆 💪 ⚒ `status_code` 👈 *🔀* 📨 🎚.
```Python hl_lines="1 9 12"
-{!../../../docs_src/response_change_status_code/tutorial001.py!}
+{!../../docs_src/response_change_status_code/tutorial001.py!}
```
& ⤴️ 👆 💪 📨 🙆 🎚 👆 💪, 👆 🛎 🔜 ( `dict`, 💽 🏷, ♒️).
diff --git a/docs/em/docs/advanced/response-cookies.md b/docs/em/docs/advanced/response-cookies.md
index 717fb87ce..6b9e9a4d9 100644
--- a/docs/em/docs/advanced/response-cookies.md
+++ b/docs/em/docs/advanced/response-cookies.md
@@ -7,7 +7,7 @@
& ⤴️ 👆 💪 ⚒ 🍪 👈 *🔀* 📨 🎚.
```Python hl_lines="1 8-9"
-{!../../../docs_src/response_cookies/tutorial002.py!}
+{!../../docs_src/response_cookies/tutorial002.py!}
```
& ⤴️ 👆 💪 📨 🙆 🎚 👆 💪, 👆 🛎 🔜 ( `dict`, 💽 🏷, ♒️).
@@ -27,7 +27,7 @@
⤴️ ⚒ 🍪 ⚫️, & ⤴️ 📨 ⚫️:
```Python hl_lines="10-12"
-{!../../../docs_src/response_cookies/tutorial001.py!}
+{!../../docs_src/response_cookies/tutorial001.py!}
```
/// tip
diff --git a/docs/em/docs/advanced/response-directly.md b/docs/em/docs/advanced/response-directly.md
index 13ee081c2..dcffc56c6 100644
--- a/docs/em/docs/advanced/response-directly.md
+++ b/docs/em/docs/advanced/response-directly.md
@@ -35,7 +35,7 @@
📚 💼, 👆 💪 ⚙️ `jsonable_encoder` 🗜 👆 📊 ⏭ 🚶♀️ ⚫️ 📨:
```Python hl_lines="6-7 21-22"
-{!../../../docs_src/response_directly/tutorial001.py!}
+{!../../docs_src/response_directly/tutorial001.py!}
```
/// note | "📡 ℹ"
@@ -57,7 +57,7 @@
👆 💪 🚮 👆 📂 🎚 🎻, 🚮 ⚫️ `Response`, & 📨 ⚫️:
```Python hl_lines="1 18"
-{!../../../docs_src/response_directly/tutorial002.py!}
+{!../../docs_src/response_directly/tutorial002.py!}
```
## 🗒
diff --git a/docs/em/docs/advanced/response-headers.md b/docs/em/docs/advanced/response-headers.md
index 27e1cdbd5..cbbbae237 100644
--- a/docs/em/docs/advanced/response-headers.md
+++ b/docs/em/docs/advanced/response-headers.md
@@ -7,7 +7,7 @@
& ⤴️ 👆 💪 ⚒ 🎚 👈 *🔀* 📨 🎚.
```Python hl_lines="1 7-8"
-{!../../../docs_src/response_headers/tutorial002.py!}
+{!../../docs_src/response_headers/tutorial002.py!}
```
& ⤴️ 👆 💪 📨 🙆 🎚 👆 💪, 👆 🛎 🔜 ( `dict`, 💽 🏷, ♒️).
@@ -25,7 +25,7 @@
✍ 📨 🔬 [📨 📨 🔗](response-directly.md){.internal-link target=_blank} & 🚶♀️ 🎚 🌖 🔢:
```Python hl_lines="10-12"
-{!../../../docs_src/response_headers/tutorial001.py!}
+{!../../docs_src/response_headers/tutorial001.py!}
```
/// note | "📡 ℹ"
diff --git a/docs/em/docs/advanced/security/http-basic-auth.md b/docs/em/docs/advanced/security/http-basic-auth.md
index 33470a726..e6fe3e32c 100644
--- a/docs/em/docs/advanced/security/http-basic-auth.md
+++ b/docs/em/docs/advanced/security/http-basic-auth.md
@@ -21,7 +21,7 @@
* ⚫️ 🔌 `username` & `password` 📨.
```Python hl_lines="2 6 10"
-{!../../../docs_src/security/tutorial006.py!}
+{!../../docs_src/security/tutorial006.py!}
```
🕐❔ 👆 🔄 📂 📛 🥇 🕰 (⚖️ 🖊 "🛠️" 🔼 🩺) 🖥 🔜 💭 👆 👆 🆔 & 🔐:
@@ -43,7 +43,7 @@
⤴️ 👥 💪 ⚙️ `secrets.compare_digest()` 🚚 👈 `credentials.username` `"stanleyjobson"`, & 👈 `credentials.password` `"swordfish"`.
```Python hl_lines="1 11-21"
-{!../../../docs_src/security/tutorial007.py!}
+{!../../docs_src/security/tutorial007.py!}
```
👉 🔜 🎏:
@@ -109,5 +109,5 @@ if "stanleyjobsox" == "stanleyjobson" and "love123" == "swordfish":
⏮️ 🔍 👈 🎓 ❌, 📨 `HTTPException` ⏮️ 👔 📟 4️⃣0️⃣1️⃣ (🎏 📨 🕐❔ 🙅♂ 🎓 🚚) & 🚮 🎚 `WWW-Authenticate` ⚒ 🖥 🎦 💳 📋 🔄:
```Python hl_lines="23-27"
-{!../../../docs_src/security/tutorial007.py!}
+{!../../docs_src/security/tutorial007.py!}
```
diff --git a/docs/em/docs/advanced/security/oauth2-scopes.md b/docs/em/docs/advanced/security/oauth2-scopes.md
index 73b2ec540..661be034e 100644
--- a/docs/em/docs/advanced/security/oauth2-scopes.md
+++ b/docs/em/docs/advanced/security/oauth2-scopes.md
@@ -63,7 +63,7 @@ Oauth2️⃣ 👫 🎻.
🥇, ➡️ 🔜 👀 🍕 👈 🔀 ⚪️➡️ 🖼 👑 **🔰 - 👩💻 🦮** [Oauth2️⃣ ⏮️ 🔐 (& 🔁), 📨 ⏮️ 🥙 🤝](../../tutorial/security/oauth2-jwt.md){.internal-link target=_blank}. 🔜 ⚙️ Oauth2️⃣ ↔:
```Python hl_lines="2 4 8 12 46 64 105 107-115 121-124 128-134 139 155"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
🔜 ➡️ 📄 👈 🔀 🔁 🔁.
@@ -75,7 +75,7 @@ Oauth2️⃣ 👫 🎻.
`scopes` 🔢 📨 `dict` ⏮️ 🔠 ↔ 🔑 & 📛 💲:
```Python hl_lines="62-65"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
↩️ 👥 🔜 📣 📚 ↔, 👫 🔜 🎦 🆙 🛠️ 🩺 🕐❔ 👆 🕹-/✔.
@@ -103,7 +103,7 @@ Oauth2️⃣ 👫 🎻.
///
```Python hl_lines="155"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
## 📣 ↔ *➡ 🛠️* & 🔗
@@ -131,7 +131,7 @@ Oauth2️⃣ 👫 🎻.
///
```Python hl_lines="4 139 168"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
/// info | "📡 ℹ"
@@ -159,7 +159,7 @@ Oauth2️⃣ 👫 🎻.
👉 `SecurityScopes` 🎓 🎏 `Request` (`Request` ⚙️ 🤚 📨 🎚 🔗).
```Python hl_lines="8 105"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
## ⚙️ `scopes`
@@ -175,7 +175,7 @@ Oauth2️⃣ 👫 🎻.
👉 ⚠, 👥 🔌 ↔ 🚚 (🚥 🙆) 🎻 👽 🚀 (⚙️ `scope_str`). 👥 🚮 👈 🎻 ⚗ ↔ `WWW-Authenticate` 🎚 (👉 🍕 🔌).
```Python hl_lines="105 107-115"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
## ✔ `username` & 💽 💠
@@ -193,7 +193,7 @@ Oauth2️⃣ 👫 🎻.
👥 ✔ 👈 👥 ✔️ 👩💻 ⏮️ 👈 🆔, & 🚥 🚫, 👥 🤚 👈 🎏 ⚠ 👥 ✍ ⏭.
```Python hl_lines="46 116-127"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
## ✔ `scopes`
@@ -203,7 +203,7 @@ Oauth2️⃣ 👫 🎻.
👉, 👥 ⚙️ `security_scopes.scopes`, 👈 🔌 `list` ⏮️ 🌐 👫 ↔ `str`.
```Python hl_lines="128-134"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
## 🔗 🌲 & ↔
diff --git a/docs/em/docs/advanced/settings.md b/docs/em/docs/advanced/settings.md
index e84941b57..59fb71d73 100644
--- a/docs/em/docs/advanced/settings.md
+++ b/docs/em/docs/advanced/settings.md
@@ -149,7 +149,7 @@ Hello World from Python
👆 💪 ⚙️ 🌐 🎏 🔬 ⚒ & 🧰 👆 ⚙️ Pydantic 🏷, 💖 🎏 📊 🆎 & 🌖 🔬 ⏮️ `Field()`.
```Python hl_lines="2 5-8 11"
-{!../../../docs_src/settings/tutorial001.py!}
+{!../../docs_src/settings/tutorial001.py!}
```
/// tip
@@ -167,7 +167,7 @@ Hello World from Python
⤴️ 👆 💪 ⚙️ 🆕 `settings` 🎚 👆 🈸:
```Python hl_lines="18-20"
-{!../../../docs_src/settings/tutorial001.py!}
+{!../../docs_src/settings/tutorial001.py!}
```
### 🏃 💽
@@ -203,13 +203,13 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" uvicorn main:app
🖼, 👆 💪 ✔️ 📁 `config.py` ⏮️:
```Python
-{!../../../docs_src/settings/app01/config.py!}
+{!../../docs_src/settings/app01/config.py!}
```
& ⤴️ ⚙️ ⚫️ 📁 `main.py`:
```Python hl_lines="3 11-13"
-{!../../../docs_src/settings/app01/main.py!}
+{!../../docs_src/settings/app01/main.py!}
```
/// tip
@@ -229,7 +229,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" uvicorn main:app
👟 ⚪️➡️ ⏮️ 🖼, 👆 `config.py` 📁 💪 👀 💖:
```Python hl_lines="10"
-{!../../../docs_src/settings/app02/config.py!}
+{!../../docs_src/settings/app02/config.py!}
```
👀 👈 🔜 👥 🚫 ✍ 🔢 👐 `settings = Settings()`.
@@ -239,7 +239,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" uvicorn main:app
🔜 👥 ✍ 🔗 👈 📨 🆕 `config.Settings()`.
```Python hl_lines="5 11-12"
-{!../../../docs_src/settings/app02/main.py!}
+{!../../docs_src/settings/app02/main.py!}
```
/// tip
@@ -253,7 +253,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" uvicorn main:app
& ⤴️ 👥 💪 🚚 ⚫️ ⚪️➡️ *➡ 🛠️ 🔢* 🔗 & ⚙️ ⚫️ 🙆 👥 💪 ⚫️.
```Python hl_lines="16 18-20"
-{!../../../docs_src/settings/app02/main.py!}
+{!../../docs_src/settings/app02/main.py!}
```
### ⚒ & 🔬
@@ -261,7 +261,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" uvicorn main:app
⤴️ ⚫️ 🔜 📶 ⏩ 🚚 🎏 ⚒ 🎚 ⏮️ 🔬 🏗 🔗 🔐 `get_settings`:
```Python hl_lines="9-10 13 21"
-{!../../../docs_src/settings/app02/test_main.py!}
+{!../../docs_src/settings/app02/test_main.py!}
```
🔗 🔐 👥 ⚒ 🆕 💲 `admin_email` 🕐❔ 🏗 🆕 `Settings` 🎚, & ⤴️ 👥 📨 👈 🆕 🎚.
@@ -304,7 +304,7 @@ APP_NAME="ChimichangApp"
& ⤴️ ℹ 👆 `config.py` ⏮️:
```Python hl_lines="9-10"
-{!../../../docs_src/settings/app03/config.py!}
+{!../../docs_src/settings/app03/config.py!}
```
📥 👥 ✍ 🎓 `Config` 🔘 👆 Pydantic `Settings` 🎓, & ⚒ `env_file` 📁 ⏮️ 🇨🇻 📁 👥 💚 ⚙️.
@@ -339,7 +339,7 @@ def get_settings():
✋️ 👥 ⚙️ `@lru_cache` 👨🎨 🔛 🔝, `Settings` 🎚 🔜 ✍ 🕴 🕐, 🥇 🕰 ⚫️ 🤙. 👶 👶
```Python hl_lines="1 10"
-{!../../../docs_src/settings/app03/main.py!}
+{!../../docs_src/settings/app03/main.py!}
```
⤴️ 🙆 🏁 🤙 `get_settings()` 🔗 ⏭ 📨, ↩️ 🛠️ 🔗 📟 `get_settings()` & 🏗 🆕 `Settings` 🎚, ⚫️ 🔜 📨 🎏 🎚 👈 📨 🔛 🥇 🤙, 🔄 & 🔄.
diff --git a/docs/em/docs/advanced/sub-applications.md b/docs/em/docs/advanced/sub-applications.md
index 1e0931f95..e19f3f234 100644
--- a/docs/em/docs/advanced/sub-applications.md
+++ b/docs/em/docs/advanced/sub-applications.md
@@ -11,7 +11,7 @@
🥇, ✍ 👑, 🔝-🎚, **FastAPI** 🈸, & 🚮 *➡ 🛠️*:
```Python hl_lines="3 6-8"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### 🎧-🈸
@@ -21,7 +21,7 @@
👉 🎧-🈸 ➕1️⃣ 🐩 FastAPI 🈸, ✋️ 👉 1️⃣ 👈 🔜 "🗻":
```Python hl_lines="11 14-16"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### 🗻 🎧-🈸
@@ -31,7 +31,7 @@
👉 💼, ⚫️ 🔜 📌 ➡ `/subapi`:
```Python hl_lines="11 19"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### ✅ 🏧 🛠️ 🩺
diff --git a/docs/em/docs/advanced/templates.md b/docs/em/docs/advanced/templates.md
index c45ff47a1..66c7484a6 100644
--- a/docs/em/docs/advanced/templates.md
+++ b/docs/em/docs/advanced/templates.md
@@ -28,7 +28,7 @@ $ pip install jinja2
* ⚙️ `templates` 👆 ✍ ✍ & 📨 `TemplateResponse`, 🚶♀️ `request` 1️⃣ 🔑-💲 👫 Jinja2️⃣ "🔑".
```Python hl_lines="4 11 15-18"
-{!../../../docs_src/templates/tutorial001.py!}
+{!../../docs_src/templates/tutorial001.py!}
```
/// note
@@ -56,7 +56,7 @@ $ pip install jinja2
⤴️ 👆 💪 ✍ 📄 `templates/item.html` ⏮️:
```jinja hl_lines="7"
-{!../../../docs_src/templates/templates/item.html!}
+{!../../docs_src/templates/templates/item.html!}
```
⚫️ 🔜 🎦 `id` ✊ ⚪️➡️ "🔑" `dict` 👆 🚶♀️:
@@ -70,13 +70,13 @@ $ pip install jinja2
& 👆 💪 ⚙️ `url_for()` 🔘 📄, & ⚙️ ⚫️, 🖼, ⏮️ `StaticFiles` 👆 📌.
```jinja hl_lines="4"
-{!../../../docs_src/templates/templates/item.html!}
+{!../../docs_src/templates/templates/item.html!}
```
👉 🖼, ⚫️ 🔜 🔗 🎚 📁 `static/styles.css` ⏮️:
```CSS hl_lines="4"
-{!../../../docs_src/templates/static/styles.css!}
+{!../../docs_src/templates/static/styles.css!}
```
& ↩️ 👆 ⚙️ `StaticFiles`, 👈 🎚 📁 🔜 🍦 🔁 👆 **FastAPI** 🈸 📛 `/static/styles.css`.
diff --git a/docs/em/docs/advanced/testing-database.md b/docs/em/docs/advanced/testing-database.md
index 825d545a9..71b29f9b7 100644
--- a/docs/em/docs/advanced/testing-database.md
+++ b/docs/em/docs/advanced/testing-database.md
@@ -49,7 +49,7 @@
✋️ 🎂 🎉 📟 🌅 ⚖️ 🌘 🎏, 👥 📁 ⚫️.
```Python hl_lines="8-13"
-{!../../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
+{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
```
/// tip
@@ -73,7 +73,7 @@ Base.metadata.create_all(bind=engine)
👥 🚮 👈 ⏸ 📥, ⏮️ 🆕 📁.
```Python hl_lines="16"
-{!../../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
+{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
```
## 🔗 🔐
@@ -81,7 +81,7 @@ Base.metadata.create_all(bind=engine)
🔜 👥 ✍ 🔗 🔐 & 🚮 ⚫️ 🔐 👆 📱.
```Python hl_lines="19-24 27"
-{!../../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
+{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
```
/// tip
@@ -95,7 +95,7 @@ Base.metadata.create_all(bind=engine)
⤴️ 👥 💪 💯 📱 🛎.
```Python hl_lines="32-47"
-{!../../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
+{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
```
& 🌐 🛠️ 👥 ⚒ 💽 ⏮️ 💯 🔜 `test.db` 💽 ↩️ 👑 `sql_app.db`.
diff --git a/docs/em/docs/advanced/testing-dependencies.md b/docs/em/docs/advanced/testing-dependencies.md
index 8bcffcc29..027767df1 100644
--- a/docs/em/docs/advanced/testing-dependencies.md
+++ b/docs/em/docs/advanced/testing-dependencies.md
@@ -29,7 +29,7 @@
& ⤴️ **FastAPI** 🔜 🤙 👈 🔐 ↩️ ⏮️ 🔗.
```Python hl_lines="28-29 32"
-{!../../../docs_src/dependency_testing/tutorial001.py!}
+{!../../docs_src/dependency_testing/tutorial001.py!}
```
/// tip
diff --git a/docs/em/docs/advanced/testing-events.md b/docs/em/docs/advanced/testing-events.md
index d64436eb9..071d49c21 100644
--- a/docs/em/docs/advanced/testing-events.md
+++ b/docs/em/docs/advanced/testing-events.md
@@ -3,5 +3,5 @@
🕐❔ 👆 💪 👆 🎉 🐕🦺 (`startup` & `shutdown`) 🏃 👆 💯, 👆 💪 ⚙️ `TestClient` ⏮️ `with` 📄:
```Python hl_lines="9-12 20-24"
-{!../../../docs_src/app_testing/tutorial003.py!}
+{!../../docs_src/app_testing/tutorial003.py!}
```
diff --git a/docs/em/docs/advanced/testing-websockets.md b/docs/em/docs/advanced/testing-websockets.md
index 5fb1e9c34..62939c343 100644
--- a/docs/em/docs/advanced/testing-websockets.md
+++ b/docs/em/docs/advanced/testing-websockets.md
@@ -5,7 +5,7 @@
👉, 👆 ⚙️ `TestClient` `with` 📄, 🔗*️⃣:
```Python hl_lines="27-31"
-{!../../../docs_src/app_testing/tutorial002.py!}
+{!../../docs_src/app_testing/tutorial002.py!}
```
/// note
diff --git a/docs/em/docs/advanced/using-request-directly.md b/docs/em/docs/advanced/using-request-directly.md
index edc951d96..ae212364f 100644
--- a/docs/em/docs/advanced/using-request-directly.md
+++ b/docs/em/docs/advanced/using-request-directly.md
@@ -30,7 +30,7 @@
👈 👆 💪 🔐 📨 🔗.
```Python hl_lines="1 7-8"
-{!../../../docs_src/using_request_directly/tutorial001.py!}
+{!../../docs_src/using_request_directly/tutorial001.py!}
```
📣 *➡ 🛠️ 🔢* 🔢 ⏮️ 🆎 ➖ `Request` **FastAPI** 🔜 💭 🚶♀️ `Request` 👈 🔢.
diff --git a/docs/em/docs/advanced/websockets.md b/docs/em/docs/advanced/websockets.md
index 30dc3043e..7957eba1f 100644
--- a/docs/em/docs/advanced/websockets.md
+++ b/docs/em/docs/advanced/websockets.md
@@ -39,7 +39,7 @@ $ pip install websockets
✋️ ⚫️ 🙅 🌌 🎯 🔛 💽-🚄 *️⃣ & ✔️ 👷 🖼:
```Python hl_lines="2 6-38 41-43"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
## ✍ `websocket`
@@ -47,7 +47,7 @@ $ pip install websockets
👆 **FastAPI** 🈸, ✍ `websocket`:
```Python hl_lines="1 46-47"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
/// note | "📡 ℹ"
@@ -63,7 +63,7 @@ $ pip install websockets
👆 *️⃣ 🛣 👆 💪 `await` 📧 & 📨 📧.
```Python hl_lines="48-52"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
👆 💪 📨 & 📨 💱, ✍, & 🎻 💽.
@@ -116,7 +116,7 @@ $ uvicorn main:app --reload
👫 👷 🎏 🌌 🎏 FastAPI 🔗/*➡ 🛠️*:
```Python hl_lines="66-77 76-91"
-{!../../../docs_src/websockets/tutorial002.py!}
+{!../../docs_src/websockets/tutorial002.py!}
```
/// info
@@ -163,7 +163,7 @@ $ uvicorn main:app --reload
🕐❔ *️⃣ 🔗 📪, `await websocket.receive_text()` 🔜 🤚 `WebSocketDisconnect` ⚠, ❔ 👆 💪 ⤴️ ✊ & 🍵 💖 👉 🖼.
```Python hl_lines="81-83"
-{!../../../docs_src/websockets/tutorial003.py!}
+{!../../docs_src/websockets/tutorial003.py!}
```
🔄 ⚫️ 👅:
diff --git a/docs/em/docs/advanced/wsgi.md b/docs/em/docs/advanced/wsgi.md
index 6a4ed073c..8c0008c74 100644
--- a/docs/em/docs/advanced/wsgi.md
+++ b/docs/em/docs/advanced/wsgi.md
@@ -13,7 +13,7 @@
& ⤴️ 🗻 👈 🔽 ➡.
```Python hl_lines="2-3 22"
-{!../../../docs_src/wsgi/tutorial001.py!}
+{!../../docs_src/wsgi/tutorial001.py!}
```
## ✅ ⚫️
diff --git a/docs/em/docs/how-to/conditional-openapi.md b/docs/em/docs/how-to/conditional-openapi.md
index a17ba4eec..a5932933a 100644
--- a/docs/em/docs/how-to/conditional-openapi.md
+++ b/docs/em/docs/how-to/conditional-openapi.md
@@ -30,7 +30,7 @@
🖼:
```Python hl_lines="6 11"
-{!../../../docs_src/conditional_openapi/tutorial001.py!}
+{!../../docs_src/conditional_openapi/tutorial001.py!}
```
📥 👥 📣 ⚒ `openapi_url` ⏮️ 🎏 🔢 `"/openapi.json"`.
diff --git a/docs/em/docs/how-to/custom-request-and-route.md b/docs/em/docs/how-to/custom-request-and-route.md
index 1f66c6eda..0425e6267 100644
--- a/docs/em/docs/how-to/custom-request-and-route.md
+++ b/docs/em/docs/how-to/custom-request-and-route.md
@@ -43,7 +43,7 @@
👈 🌌, 🎏 🛣 🎓 💪 🍵 🗜 🗜 ⚖️ 🗜 📨.
```Python hl_lines="8-15"
-{!../../../docs_src/custom_request_and_route/tutorial001.py!}
+{!../../docs_src/custom_request_and_route/tutorial001.py!}
```
### ✍ 🛃 `GzipRoute` 🎓
@@ -57,7 +57,7 @@
📥 👥 ⚙️ ⚫️ ✍ `GzipRequest` ⚪️➡️ ⏮️ 📨.
```Python hl_lines="18-26"
-{!../../../docs_src/custom_request_and_route/tutorial001.py!}
+{!../../docs_src/custom_request_and_route/tutorial001.py!}
```
/// note | "📡 ℹ"
@@ -97,13 +97,13 @@
🌐 👥 💪 🍵 📨 🔘 `try`/`except` 🍫:
```Python hl_lines="13 15"
-{!../../../docs_src/custom_request_and_route/tutorial002.py!}
+{!../../docs_src/custom_request_and_route/tutorial002.py!}
```
🚥 ⚠ 📉, `Request` 👐 🔜 ↔, 👥 💪 ✍ & ⚒ ⚙️ 📨 💪 🕐❔ 🚚 ❌:
```Python hl_lines="16-18"
-{!../../../docs_src/custom_request_and_route/tutorial002.py!}
+{!../../docs_src/custom_request_and_route/tutorial002.py!}
```
## 🛃 `APIRoute` 🎓 📻
@@ -111,11 +111,11 @@
👆 💪 ⚒ `route_class` 🔢 `APIRouter`:
```Python hl_lines="26"
-{!../../../docs_src/custom_request_and_route/tutorial003.py!}
+{!../../docs_src/custom_request_and_route/tutorial003.py!}
```
👉 🖼, *➡ 🛠️* 🔽 `router` 🔜 ⚙️ 🛃 `TimedRoute` 🎓, & 🔜 ✔️ ➕ `X-Response-Time` 🎚 📨 ⏮️ 🕰 ⚫️ ✊ 🏗 📨:
```Python hl_lines="13-20"
-{!../../../docs_src/custom_request_and_route/tutorial003.py!}
+{!../../docs_src/custom_request_and_route/tutorial003.py!}
```
diff --git a/docs/em/docs/how-to/extending-openapi.md b/docs/em/docs/how-to/extending-openapi.md
index dc9adf80e..698c78ec1 100644
--- a/docs/em/docs/how-to/extending-openapi.md
+++ b/docs/em/docs/how-to/extending-openapi.md
@@ -47,7 +47,7 @@
🥇, ✍ 🌐 👆 **FastAPI** 🈸 🛎:
```Python hl_lines="1 4 7-9"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### 🏗 🗄 🔗
@@ -55,7 +55,7 @@
⤴️, ⚙️ 🎏 🚙 🔢 🏗 🗄 🔗, 🔘 `custom_openapi()` 🔢:
```Python hl_lines="2 15-20"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### 🔀 🗄 🔗
@@ -63,7 +63,7 @@
🔜 👆 💪 🚮 📄 ↔, ❎ 🛃 `x-logo` `info` "🎚" 🗄 🔗:
```Python hl_lines="21-23"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### 💾 🗄 🔗
@@ -75,7 +75,7 @@
⚫️ 🔜 🏗 🕴 🕐, & ⤴️ 🎏 💾 🔗 🔜 ⚙️ ⏭ 📨.
```Python hl_lines="13-14 24-25"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### 🔐 👩🔬
@@ -83,7 +83,7 @@
🔜 👆 💪 ❎ `.openapi()` 👩🔬 ⏮️ 👆 🆕 🔢.
```Python hl_lines="28"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### ✅ ⚫️
diff --git a/docs/em/docs/how-to/graphql.md b/docs/em/docs/how-to/graphql.md
index b8610b767..5d0d95567 100644
--- a/docs/em/docs/how-to/graphql.md
+++ b/docs/em/docs/how-to/graphql.md
@@ -36,7 +36,7 @@
📥 🤪 🎮 ❔ 👆 💪 🛠️ 🍓 ⏮️ FastAPI:
```Python hl_lines="3 22 25-26"
-{!../../../docs_src/graphql/tutorial001.py!}
+{!../../docs_src/graphql/tutorial001.py!}
```
👆 💪 💡 🌅 🔃 🍓 <a href="https://strawberry.rocks/" class="external-link" target="_blank">🍓 🧾</a>.
diff --git a/docs/em/docs/how-to/sql-databases-peewee.md b/docs/em/docs/how-to/sql-databases-peewee.md
index 88b827c24..d25b77894 100644
--- a/docs/em/docs/how-to/sql-databases-peewee.md
+++ b/docs/em/docs/how-to/sql-databases-peewee.md
@@ -71,7 +71,7 @@
➡️ 🥇 ✅ 🌐 😐 🏒 📟, ✍ 🏒 💽:
```Python hl_lines="3 5 22"
-{!../../../docs_src/sql_databases_peewee/sql_app/database.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
```
/// tip
@@ -131,7 +131,7 @@ connect_args={"check_same_thread": False}
👥 🔜 ✍ `PeeweeConnectionState`:
```Python hl_lines="10-19"
-{!../../../docs_src/sql_databases_peewee/sql_app/database.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
```
👉 🎓 😖 ⚪️➡️ 🎁 🔗 🎓 ⚙️ 🏒.
@@ -155,7 +155,7 @@ connect_args={"check_same_thread": False}
🔜, 📁 `._state` 🔗 🔢 🏒 💽 `db` 🎚 ⚙️ 🆕 `PeeweeConnectionState`:
```Python hl_lines="24"
-{!../../../docs_src/sql_databases_peewee/sql_app/database.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
```
/// tip
@@ -191,7 +191,7 @@ connect_args={"check_same_thread": False}
🗄 `db` ⚪️➡️ `database` (📁 `database.py` ⚪️➡️ 🔛) & ⚙️ ⚫️ 📥.
```Python hl_lines="3 6-12 15-21"
-{!../../../docs_src/sql_databases_peewee/sql_app/models.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/models.py!}
```
/// tip
@@ -225,7 +225,7 @@ connect_args={"check_same_thread": False}
✍ 🌐 🎏 Pydantic 🏷 🇸🇲 🔰:
```Python hl_lines="16-18 21-22 25-30 34-35 38-39 42-48"
-{!../../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
```
/// tip
@@ -253,7 +253,7 @@ connect_args={"check_same_thread": False}
👥 🔜 ✍ 🛃 `PeeweeGetterDict` 🎓 & ⚙️ ⚫️ 🌐 🎏 Pydantic *🏷* / 🔗 👈 ⚙️ `orm_mode`:
```Python hl_lines="3 8-13 31 49"
-{!../../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
```
📥 👥 ✅ 🚥 🔢 👈 ➖ 🔐 (✅ `.items` `some_user.items`) 👐 `peewee.ModelSelect`.
@@ -277,7 +277,7 @@ connect_args={"check_same_thread": False}
✍ 🌐 🎏 💩 🇨🇻 🇸🇲 🔰, 🌐 📟 📶 🎏:
```Python hl_lines="1 4-5 8-9 12-13 16-20 23-24 27-30"
-{!../../../docs_src/sql_databases_peewee/sql_app/crud.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/crud.py!}
```
📤 🔺 ⏮️ 📟 🇸🇲 🔰.
@@ -301,7 +301,7 @@ list(models.User.select())
📶 🙃 🌌 ✍ 💽 🏓:
```Python hl_lines="9-11"
-{!../../../docs_src/sql_databases_peewee/sql_app/main.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
```
### ✍ 🔗
@@ -309,7 +309,7 @@ list(models.User.select())
✍ 🔗 👈 🔜 🔗 💽 ▶️️ ▶️ 📨 & 🔌 ⚫️ 🔚:
```Python hl_lines="23-29"
-{!../../../docs_src/sql_databases_peewee/sql_app/main.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
```
📥 👥 ✔️ 🛁 `yield` ↩️ 👥 🤙 🚫 ⚙️ 💽 🎚 🔗.
@@ -323,7 +323,7 @@ list(models.User.select())
✋️ 👥 🚫 ⚙️ 💲 👐 👉 🔗 (⚫️ 🤙 🚫 🤝 🙆 💲, ⚫️ ✔️ 🛁 `yield`). , 👥 🚫 🚮 ⚫️ *➡ 🛠️ 🔢* ✋️ *➡ 🛠️ 👨🎨* `dependencies` 🔢:
```Python hl_lines="32 40 47 59 65 72"
-{!../../../docs_src/sql_databases_peewee/sql_app/main.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
```
### 🔑 🔢 🎧-🔗
@@ -333,7 +333,7 @@ list(models.User.select())
👈, 👥 💪 ✍ ➕1️⃣ `async` 🔗 `reset_db_state()` 👈 ⚙️ 🎧-🔗 `get_db()`. ⚫️ 🔜 ⚒ 💲 🔑 🔢 (⏮️ 🔢 `dict`) 👈 🔜 ⚙️ 💽 🇵🇸 🎂 📨. & ⤴️ 🔗 `get_db()` 🔜 🏪 ⚫️ 💽 🇵🇸 (🔗, 💵, ♒️).
```Python hl_lines="18-20"
-{!../../../docs_src/sql_databases_peewee/sql_app/main.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
```
**⏭ 📨**, 👥 🔜 ⏲ 👈 🔑 🔢 🔄 `async` 🔗 `reset_db_state()` & ⤴️ ✍ 🆕 🔗 `get_db()` 🔗, 👈 🆕 📨 🔜 ✔️ 🚮 👍 💽 🇵🇸 (🔗, 💵, ♒️).
@@ -365,7 +365,7 @@ async def reset_db_state():
🔜, 😒, 📥 🐩 **FastAPI** *➡ 🛠️* 📟.
```Python hl_lines="32-37 40-43 46-53 56-62 65-68 71-79"
-{!../../../docs_src/sql_databases_peewee/sql_app/main.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
```
### 🔃 `def` 🆚 `async def`
@@ -482,31 +482,31 @@ async def reset_db_state():
* `sql_app/database.py`:
```Python
-{!../../../docs_src/sql_databases_peewee/sql_app/database.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
```
* `sql_app/models.py`:
```Python
-{!../../../docs_src/sql_databases_peewee/sql_app/models.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/models.py!}
```
* `sql_app/schemas.py`:
```Python
-{!../../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
```
* `sql_app/crud.py`:
```Python
-{!../../../docs_src/sql_databases_peewee/sql_app/crud.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/crud.py!}
```
* `sql_app/main.py`:
```Python
-{!../../../docs_src/sql_databases_peewee/sql_app/main.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
```
## 📡 ℹ
diff --git a/docs/em/docs/python-types.md b/docs/em/docs/python-types.md
index 202c90f94..d2af23bb9 100644
--- a/docs/em/docs/python-types.md
+++ b/docs/em/docs/python-types.md
@@ -23,7 +23,7 @@
➡️ ▶️ ⏮️ 🙅 🖼:
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
🤙 👉 📋 🔢:
@@ -39,7 +39,7 @@ John Doe
* <abbr title="Puts them together, as one. With the contents of one after the other.">🔢</abbr> 👫 ⏮️ 🚀 🖕.
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### ✍ ⚫️
@@ -83,7 +83,7 @@ John Doe
👈 "🆎 🔑":
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
👈 🚫 🎏 📣 🔢 💲 💖 🔜 ⏮️:
@@ -113,7 +113,7 @@ John Doe
✅ 👉 🔢, ⚫️ ⏪ ✔️ 🆎 🔑:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
↩️ 👨🎨 💭 🆎 🔢, 👆 🚫 🕴 🤚 🛠️, 👆 🤚 ❌ ✅:
@@ -123,7 +123,7 @@ John Doe
🔜 👆 💭 👈 👆 ✔️ 🔧 ⚫️, 🗜 `age` 🎻 ⏮️ `str(age)`:
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## 📣 🆎
@@ -144,7 +144,7 @@ John Doe
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### 💊 🆎 ⏮️ 🆎 🔢
@@ -172,7 +172,7 @@ John Doe
⚪️➡️ `typing`, 🗄 `List` (⏮️ 🔠 `L`):
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
📣 🔢, ⏮️ 🎏 ❤ (`:`) ❕.
@@ -182,7 +182,7 @@ John Doe
📇 🆎 👈 🔌 🔗 🆎, 👆 🚮 👫 ⬜ 🗜:
```Python hl_lines="4"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
////
@@ -196,7 +196,7 @@ John Doe
📇 🆎 👈 🔌 🔗 🆎, 👆 🚮 👫 ⬜ 🗜:
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006_py39.py!}
+{!> ../../docs_src/python_types/tutorial006_py39.py!}
```
////
@@ -234,7 +234,7 @@ John Doe
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial007.py!}
+{!> ../../docs_src/python_types/tutorial007.py!}
```
////
@@ -242,7 +242,7 @@ John Doe
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial007_py39.py!}
+{!> ../../docs_src/python_types/tutorial007_py39.py!}
```
////
@@ -263,7 +263,7 @@ John Doe
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008.py!}
+{!> ../../docs_src/python_types/tutorial008.py!}
```
////
@@ -271,7 +271,7 @@ John Doe
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008_py39.py!}
+{!> ../../docs_src/python_types/tutorial008_py39.py!}
```
////
@@ -293,7 +293,7 @@ John Doe
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008b.py!}
+{!> ../../docs_src/python_types/tutorial008b.py!}
```
////
@@ -301,7 +301,7 @@ John Doe
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008b_py310.py!}
+{!> ../../docs_src/python_types/tutorial008b_py310.py!}
```
////
@@ -315,7 +315,7 @@ John Doe
🐍 3️⃣.6️⃣ & 🔛 (✅ 🐍 3️⃣.1️⃣0️⃣) 👆 💪 📣 ⚫️ 🏭 & ⚙️ `Optional` ⚪️➡️ `typing` 🕹.
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
⚙️ `Optional[str]` ↩️ `str` 🔜 ➡️ 👨🎨 ℹ 👆 🔍 ❌ 🌐❔ 👆 💪 🤔 👈 💲 🕧 `str`, 🕐❔ ⚫️ 💪 🤙 `None` 💁♂️.
@@ -327,7 +327,7 @@ John Doe
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009.py!}
+{!> ../../docs_src/python_types/tutorial009.py!}
```
////
@@ -335,7 +335,7 @@ John Doe
//// tab | 🐍 3️⃣.6️⃣ & 🔛 - 🎛
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009b.py!}
+{!> ../../docs_src/python_types/tutorial009b.py!}
```
////
@@ -343,7 +343,7 @@ John Doe
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial009_py310.py!}
+{!> ../../docs_src/python_types/tutorial009_py310.py!}
```
////
@@ -364,7 +364,7 @@ John Doe
🖼, ➡️ ✊ 👉 🔢:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009c.py!}
+{!../../docs_src/python_types/tutorial009c.py!}
```
🔢 `name` 🔬 `Optional[str]`, ✋️ ⚫️ **🚫 📦**, 👆 🚫🔜 🤙 🔢 🍵 🔢:
@@ -382,7 +382,7 @@ say_hi(name=None) # This works, None is valid 🎉
👍 📰, 🕐 👆 🔛 🐍 3️⃣.1️⃣0️⃣ 👆 🏆 🚫 ✔️ 😟 🔃 👈, 👆 🔜 💪 🎯 ⚙️ `|` 🔬 🇪🇺 🆎:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009c_py310.py!}
+{!../../docs_src/python_types/tutorial009c_py310.py!}
```
& ⤴️ 👆 🏆 🚫 ✔️ 😟 🔃 📛 💖 `Optional` & `Union`. 👶
@@ -446,13 +446,13 @@ say_hi(name=None) # This works, None is valid 🎉
➡️ 💬 👆 ✔️ 🎓 `Person`, ⏮️ 📛:
```Python hl_lines="1-3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
⤴️ 👆 💪 📣 🔢 🆎 `Person`:
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
& ⤴️, 🔄, 👆 🤚 🌐 👨🎨 🐕🦺:
@@ -476,7 +476,7 @@ say_hi(name=None) # This works, None is valid 🎉
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python
-{!> ../../../docs_src/python_types/tutorial011.py!}
+{!> ../../docs_src/python_types/tutorial011.py!}
```
////
@@ -484,7 +484,7 @@ say_hi(name=None) # This works, None is valid 🎉
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python
-{!> ../../../docs_src/python_types/tutorial011_py39.py!}
+{!> ../../docs_src/python_types/tutorial011_py39.py!}
```
////
@@ -492,7 +492,7 @@ say_hi(name=None) # This works, None is valid 🎉
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python
-{!> ../../../docs_src/python_types/tutorial011_py310.py!}
+{!> ../../docs_src/python_types/tutorial011_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/background-tasks.md b/docs/em/docs/tutorial/background-tasks.md
index 1d17a0e4e..0f4585ebe 100644
--- a/docs/em/docs/tutorial/background-tasks.md
+++ b/docs/em/docs/tutorial/background-tasks.md
@@ -16,7 +16,7 @@
🥇, 🗄 `BackgroundTasks` & 🔬 🔢 👆 *➡ 🛠️ 🔢* ⏮️ 🆎 📄 `BackgroundTasks`:
```Python hl_lines="1 13"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
**FastAPI** 🔜 ✍ 🎚 🆎 `BackgroundTasks` 👆 & 🚶♀️ ⚫️ 👈 🔢.
@@ -34,7 +34,7 @@
& ✍ 🛠️ 🚫 ⚙️ `async` & `await`, 👥 🔬 🔢 ⏮️ 😐 `def`:
```Python hl_lines="6-9"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
## 🚮 🖥 📋
@@ -42,7 +42,7 @@
🔘 👆 *➡ 🛠️ 🔢*, 🚶♀️ 👆 📋 🔢 *🖥 📋* 🎚 ⏮️ 👩🔬 `.add_task()`:
```Python hl_lines="14"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
`.add_task()` 📨 ❌:
@@ -60,7 +60,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="13 15 22 25"
-{!> ../../../docs_src/background_tasks/tutorial002.py!}
+{!> ../../docs_src/background_tasks/tutorial002.py!}
```
////
@@ -68,7 +68,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="11 13 20 23"
-{!> ../../../docs_src/background_tasks/tutorial002_py310.py!}
+{!> ../../docs_src/background_tasks/tutorial002_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/bigger-applications.md b/docs/em/docs/tutorial/bigger-applications.md
index 693a75d28..074ab302c 100644
--- a/docs/em/docs/tutorial/bigger-applications.md
+++ b/docs/em/docs/tutorial/bigger-applications.md
@@ -86,7 +86,7 @@ from app.routers import items
👆 🗄 ⚫️ & ✍ "👐" 🎏 🌌 👆 🔜 ⏮️ 🎓 `FastAPI`:
```Python hl_lines="1 3" title="app/routers/users.py"
-{!../../../docs_src/bigger_applications/app/routers/users.py!}
+{!../../docs_src/bigger_applications/app/routers/users.py!}
```
### *➡ 🛠️* ⏮️ `APIRouter`
@@ -96,7 +96,7 @@ from app.routers import items
⚙️ ⚫️ 🎏 🌌 👆 🔜 ⚙️ `FastAPI` 🎓:
```Python hl_lines="6 11 16" title="app/routers/users.py"
-{!../../../docs_src/bigger_applications/app/routers/users.py!}
+{!../../docs_src/bigger_applications/app/routers/users.py!}
```
👆 💪 💭 `APIRouter` "🐩 `FastAPI`" 🎓.
@@ -122,7 +122,7 @@ from app.routers import items
👥 🔜 🔜 ⚙️ 🙅 🔗 ✍ 🛃 `X-Token` 🎚:
```Python hl_lines="1 4-6" title="app/dependencies.py"
-{!../../../docs_src/bigger_applications/app/dependencies.py!}
+{!../../docs_src/bigger_applications/app/dependencies.py!}
```
/// tip
@@ -156,7 +156,7 @@ from app.routers import items
, ↩️ ❎ 🌐 👈 🔠 *➡ 🛠️*, 👥 💪 🚮 ⚫️ `APIRouter`.
```Python hl_lines="5-10 16 21" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
➡ 🔠 *➡ 🛠️* ✔️ ▶️ ⏮️ `/`, 💖:
@@ -217,7 +217,7 @@ async def read_item(item_id: str):
👥 ⚙️ ⚖ 🗄 ⏮️ `..` 🔗:
```Python hl_lines="3" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
#### ❔ ⚖ 🗄 👷
@@ -290,7 +290,7 @@ that 🔜 ⛓:
✋️ 👥 💪 🚮 _🌅_ `tags` 👈 🔜 ✔ 🎯 *➡ 🛠️*, & ➕ `responses` 🎯 👈 *➡ 🛠️*:
```Python hl_lines="30-31" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
/// tip
@@ -318,7 +318,7 @@ that 🔜 ⛓:
& 👥 💪 📣 [🌐 🔗](dependencies/global-dependencies.md){.internal-link target=_blank} 👈 🔜 🌀 ⏮️ 🔗 🔠 `APIRouter`:
```Python hl_lines="1 3 7" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
### 🗄 `APIRouter`
@@ -326,7 +326,7 @@ that 🔜 ⛓:
🔜 👥 🗄 🎏 🔁 👈 ✔️ `APIRouter`Ⓜ:
```Python hl_lines="5" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
📁 `app/routers/users.py` & `app/routers/items.py` 🔁 👈 🍕 🎏 🐍 📦 `app`, 👥 💪 ⚙️ 👁 ❣ `.` 🗄 👫 ⚙️ "⚖ 🗄".
@@ -391,7 +391,7 @@ from .routers.users import router
, 💪 ⚙️ 👯♂️ 👫 🎏 📁, 👥 🗄 🔁 🔗:
```Python hl_lines="5" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
### 🔌 `APIRouter`Ⓜ `users` & `items`
@@ -399,7 +399,7 @@ from .routers.users import router
🔜, ➡️ 🔌 `router`Ⓜ ⚪️➡️ 🔁 `users` & `items`:
```Python hl_lines="10-11" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
/// info
@@ -441,7 +441,7 @@ from .routers.users import router
👉 🖼 ⚫️ 🔜 💎 🙅. ✋️ ➡️ 💬 👈 ↩️ ⚫️ 💰 ⏮️ 🎏 🏗 🏢, 👥 🚫🔜 🔀 ⚫️ & 🚮 `prefix`, `dependencies`, `tags`, ♒️. 🔗 `APIRouter`:
```Python hl_lines="3" title="app/internal/admin.py"
-{!../../../docs_src/bigger_applications/app/internal/admin.py!}
+{!../../docs_src/bigger_applications/app/internal/admin.py!}
```
✋️ 👥 💚 ⚒ 🛃 `prefix` 🕐❔ ✅ `APIRouter` 👈 🌐 🚮 *➡ 🛠️* ▶️ ⏮️ `/admin`, 👥 💚 🔐 ⚫️ ⏮️ `dependencies` 👥 ⏪ ✔️ 👉 🏗, & 👥 💚 🔌 `tags` & `responses`.
@@ -449,7 +449,7 @@ from .routers.users import router
👥 💪 📣 🌐 👈 🍵 ✔️ 🔀 ⏮️ `APIRouter` 🚶♀️ 👈 🔢 `app.include_router()`:
```Python hl_lines="14-17" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
👈 🌌, ⏮️ `APIRouter` 🔜 🚧 ⚗, 👥 💪 💰 👈 🎏 `app/internal/admin.py` 📁 ⏮️ 🎏 🏗 🏢.
@@ -472,7 +472,7 @@ from .routers.users import router
📥 👥 ⚫️... 🎦 👈 👥 💪 🤷:
```Python hl_lines="21-23" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
& ⚫️ 🔜 👷 ☑, 👯♂️ ⏮️ 🌐 🎏 *➡ 🛠️* 🚮 ⏮️ `app.include_router()`.
diff --git a/docs/em/docs/tutorial/body-fields.md b/docs/em/docs/tutorial/body-fields.md
index c5a04daeb..eb3093de2 100644
--- a/docs/em/docs/tutorial/body-fields.md
+++ b/docs/em/docs/tutorial/body-fields.md
@@ -9,7 +9,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="2"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
@@ -35,7 +35,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
@@ -43,7 +43,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="9-12"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/body-multiple-params.md b/docs/em/docs/tutorial/body-multiple-params.md
index c2a9a224d..2e20c83f9 100644
--- a/docs/em/docs/tutorial/body-multiple-params.md
+++ b/docs/em/docs/tutorial/body-multiple-params.md
@@ -11,7 +11,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="19-21"
-{!> ../../../docs_src/body_multiple_params/tutorial001.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001.py!}
```
////
@@ -19,7 +19,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="17-19"
-{!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_py310.py!}
```
////
@@ -48,7 +48,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial002.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002.py!}
```
////
@@ -56,7 +56,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002_py310.py!}
```
////
@@ -103,7 +103,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial003.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003.py!}
```
////
@@ -111,7 +111,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_py310.py!}
```
////
@@ -157,7 +157,7 @@ q: str | None = None
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004.py!}
```
////
@@ -165,7 +165,7 @@ q: str | None = None
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="26"
-{!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_py310.py!}
```
////
@@ -193,7 +193,7 @@ item: Item = Body(embed=True)
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005.py!}
```
////
@@ -201,7 +201,7 @@ item: Item = Body(embed=True)
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="15"
-{!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/body-nested-models.md b/docs/em/docs/tutorial/body-nested-models.md
index 23114540a..3b56b7a07 100644
--- a/docs/em/docs/tutorial/body-nested-models.md
+++ b/docs/em/docs/tutorial/body-nested-models.md
@@ -9,7 +9,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial001.py!}
+{!> ../../docs_src/body_nested_models/tutorial001.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial001_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial001_py310.py!}
```
////
@@ -35,7 +35,7 @@
✋️ 🐍 ⏬ ⏭ 3️⃣.9️⃣ (3️⃣.6️⃣ & 🔛), 👆 🥇 💪 🗄 `List` ⚪️➡️ 🐩 🐍 `typing` 🕹:
```Python hl_lines="1"
-{!> ../../../docs_src/body_nested_models/tutorial002.py!}
+{!> ../../docs_src/body_nested_models/tutorial002.py!}
```
### 📣 `list` ⏮️ 🆎 🔢
@@ -68,7 +68,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial002.py!}
+{!> ../../docs_src/body_nested_models/tutorial002.py!}
```
////
@@ -76,7 +76,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial002_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial002_py39.py!}
```
////
@@ -84,7 +84,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial002_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial002_py310.py!}
```
////
@@ -100,7 +100,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="1 14"
-{!> ../../../docs_src/body_nested_models/tutorial003.py!}
+{!> ../../docs_src/body_nested_models/tutorial003.py!}
```
////
@@ -108,7 +108,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial003_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial003_py39.py!}
```
////
@@ -116,7 +116,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial003_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial003_py310.py!}
```
////
@@ -144,7 +144,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9-11"
-{!> ../../../docs_src/body_nested_models/tutorial004.py!}
+{!> ../../docs_src/body_nested_models/tutorial004.py!}
```
////
@@ -152,7 +152,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="9-11"
-{!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py39.py!}
```
////
@@ -160,7 +160,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7-9"
-{!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py310.py!}
```
////
@@ -172,7 +172,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial004.py!}
+{!> ../../docs_src/body_nested_models/tutorial004.py!}
```
////
@@ -180,7 +180,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py39.py!}
```
////
@@ -188,7 +188,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="18"
-{!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py310.py!}
```
////
@@ -227,7 +227,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="4 10"
-{!> ../../../docs_src/body_nested_models/tutorial005.py!}
+{!> ../../docs_src/body_nested_models/tutorial005.py!}
```
////
@@ -235,7 +235,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="4 10"
-{!> ../../../docs_src/body_nested_models/tutorial005_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial005_py39.py!}
```
////
@@ -243,7 +243,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="2 8"
-{!> ../../../docs_src/body_nested_models/tutorial005_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial005_py310.py!}
```
////
@@ -257,7 +257,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial006.py!}
+{!> ../../docs_src/body_nested_models/tutorial006.py!}
```
////
@@ -265,7 +265,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial006_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial006_py39.py!}
```
////
@@ -273,7 +273,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="18"
-{!> ../../../docs_src/body_nested_models/tutorial006_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial006_py310.py!}
```
////
@@ -317,7 +317,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9 14 20 23 27"
-{!> ../../../docs_src/body_nested_models/tutorial007.py!}
+{!> ../../docs_src/body_nested_models/tutorial007.py!}
```
////
@@ -325,7 +325,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="9 14 20 23 27"
-{!> ../../../docs_src/body_nested_models/tutorial007_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial007_py39.py!}
```
////
@@ -333,7 +333,7 @@ my_list: List[str]
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7 12 18 21 25"
-{!> ../../../docs_src/body_nested_models/tutorial007_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial007_py310.py!}
```
////
@@ -363,7 +363,7 @@ images: list[Image]
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="15"
-{!> ../../../docs_src/body_nested_models/tutorial008.py!}
+{!> ../../docs_src/body_nested_models/tutorial008.py!}
```
////
@@ -371,7 +371,7 @@ images: list[Image]
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="13"
-{!> ../../../docs_src/body_nested_models/tutorial008_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial008_py39.py!}
```
////
@@ -407,7 +407,7 @@ images: list[Image]
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/body_nested_models/tutorial009.py!}
+{!> ../../docs_src/body_nested_models/tutorial009.py!}
```
////
@@ -415,7 +415,7 @@ images: list[Image]
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/body_nested_models/tutorial009_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial009_py39.py!}
```
////
diff --git a/docs/em/docs/tutorial/body-updates.md b/docs/em/docs/tutorial/body-updates.md
index 97501eb6d..4a4b3b6b8 100644
--- a/docs/em/docs/tutorial/body-updates.md
+++ b/docs/em/docs/tutorial/body-updates.md
@@ -9,7 +9,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="30-35"
-{!> ../../../docs_src/body_updates/tutorial001.py!}
+{!> ../../docs_src/body_updates/tutorial001.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="30-35"
-{!> ../../../docs_src/body_updates/tutorial001_py39.py!}
+{!> ../../docs_src/body_updates/tutorial001_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="28-33"
-{!> ../../../docs_src/body_updates/tutorial001_py310.py!}
+{!> ../../docs_src/body_updates/tutorial001_py310.py!}
```
////
@@ -79,7 +79,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="34"
-{!> ../../../docs_src/body_updates/tutorial002.py!}
+{!> ../../docs_src/body_updates/tutorial002.py!}
```
////
@@ -87,7 +87,7 @@
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="34"
-{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+{!> ../../docs_src/body_updates/tutorial002_py39.py!}
```
////
@@ -95,7 +95,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="32"
-{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+{!> ../../docs_src/body_updates/tutorial002_py310.py!}
```
////
@@ -109,7 +109,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="35"
-{!> ../../../docs_src/body_updates/tutorial002.py!}
+{!> ../../docs_src/body_updates/tutorial002.py!}
```
////
@@ -117,7 +117,7 @@
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="35"
-{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+{!> ../../docs_src/body_updates/tutorial002_py39.py!}
```
////
@@ -125,7 +125,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="33"
-{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+{!> ../../docs_src/body_updates/tutorial002_py310.py!}
```
////
@@ -148,7 +148,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="30-37"
-{!> ../../../docs_src/body_updates/tutorial002.py!}
+{!> ../../docs_src/body_updates/tutorial002.py!}
```
////
@@ -156,7 +156,7 @@
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="30-37"
-{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+{!> ../../docs_src/body_updates/tutorial002_py39.py!}
```
////
@@ -164,7 +164,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="28-35"
-{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+{!> ../../docs_src/body_updates/tutorial002_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/body.md b/docs/em/docs/tutorial/body.md
index 79d8e716f..3468fc512 100644
--- a/docs/em/docs/tutorial/body.md
+++ b/docs/em/docs/tutorial/body.md
@@ -25,7 +25,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="4"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -33,7 +33,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="2"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -47,7 +47,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="7-11"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -55,7 +55,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="5-9"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -89,7 +89,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="18"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -97,7 +97,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="16"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -170,7 +170,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="21"
-{!> ../../../docs_src/body/tutorial002.py!}
+{!> ../../docs_src/body/tutorial002.py!}
```
////
@@ -178,7 +178,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="19"
-{!> ../../../docs_src/body/tutorial002_py310.py!}
+{!> ../../docs_src/body/tutorial002_py310.py!}
```
////
@@ -192,7 +192,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="17-18"
-{!> ../../../docs_src/body/tutorial003.py!}
+{!> ../../docs_src/body/tutorial003.py!}
```
////
@@ -200,7 +200,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="15-16"
-{!> ../../../docs_src/body/tutorial003_py310.py!}
+{!> ../../docs_src/body/tutorial003_py310.py!}
```
////
@@ -214,7 +214,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="18"
-{!> ../../../docs_src/body/tutorial004.py!}
+{!> ../../docs_src/body/tutorial004.py!}
```
////
@@ -222,7 +222,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="16"
-{!> ../../../docs_src/body/tutorial004_py310.py!}
+{!> ../../docs_src/body/tutorial004_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/cookie-params.md b/docs/em/docs/tutorial/cookie-params.md
index 891999028..f4956e76f 100644
--- a/docs/em/docs/tutorial/cookie-params.md
+++ b/docs/em/docs/tutorial/cookie-params.md
@@ -9,7 +9,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="1"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -31,7 +31,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
@@ -39,7 +39,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/cors.md b/docs/em/docs/tutorial/cors.md
index 690b8973a..5829319cb 100644
--- a/docs/em/docs/tutorial/cors.md
+++ b/docs/em/docs/tutorial/cors.md
@@ -47,7 +47,7 @@
* 🎯 🇺🇸🔍 🎚 ⚖️ 🌐 👫 ⏮️ 🃏 `"*"`.
```Python hl_lines="2 6-11 13-19"
-{!../../../docs_src/cors/tutorial001.py!}
+{!../../docs_src/cors/tutorial001.py!}
```
🔢 🔢 ⚙️ `CORSMiddleware` 🛠️ 🚫 🔢, 👆 🔜 💪 🎯 🛠️ 🎯 🇨🇳, 👩🔬, ⚖️ 🎚, ✔ 🖥 ✔ ⚙️ 👫 ✖️-🆔 🔑.
diff --git a/docs/em/docs/tutorial/debugging.md b/docs/em/docs/tutorial/debugging.md
index abef2a50c..9320370d6 100644
--- a/docs/em/docs/tutorial/debugging.md
+++ b/docs/em/docs/tutorial/debugging.md
@@ -7,7 +7,7 @@
👆 FastAPI 🈸, 🗄 & 🏃 `uvicorn` 🔗:
```Python hl_lines="1 15"
-{!../../../docs_src/debugging/tutorial001.py!}
+{!../../docs_src/debugging/tutorial001.py!}
```
### 🔃 `__name__ == "__main__"`
diff --git a/docs/em/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/em/docs/tutorial/dependencies/classes-as-dependencies.md
index f14239b0f..3e58d506c 100644
--- a/docs/em/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/em/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -9,7 +9,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -86,7 +86,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -94,7 +94,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="9-13"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -104,7 +104,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -112,7 +112,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -122,7 +122,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -130,7 +130,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="6"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -152,7 +152,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -160,7 +160,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -206,7 +206,7 @@ commons = Depends(CommonQueryParams)
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003.py!}
+{!> ../../docs_src/dependencies/tutorial003.py!}
```
////
@@ -214,7 +214,7 @@ commons = Depends(CommonQueryParams)
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial003_py310.py!}
+{!> ../../docs_src/dependencies/tutorial003_py310.py!}
```
////
@@ -254,7 +254,7 @@ commons: CommonQueryParams = Depends()
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004.py!}
+{!> ../../docs_src/dependencies/tutorial004.py!}
```
////
@@ -262,7 +262,7 @@ commons: CommonQueryParams = Depends()
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial004_py310.py!}
+{!> ../../docs_src/dependencies/tutorial004_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/em/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index bf267e056..cd36ad100 100644
--- a/docs/em/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/em/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -15,7 +15,7 @@
⚫️ 🔜 `list` `Depends()`:
```Python hl_lines="17"
-{!../../../docs_src/dependencies/tutorial006.py!}
+{!../../docs_src/dependencies/tutorial006.py!}
```
👉 🔗 🔜 🛠️/❎ 🎏 🌌 😐 🔗. ✋️ 👫 💲 (🚥 👫 📨 🙆) 🏆 🚫 🚶♀️ 👆 *➡ 🛠️ 🔢*.
@@ -47,7 +47,7 @@
👫 💪 📣 📨 📄 (💖 🎚) ⚖️ 🎏 🎧-🔗:
```Python hl_lines="6 11"
-{!../../../docs_src/dependencies/tutorial006.py!}
+{!../../docs_src/dependencies/tutorial006.py!}
```
### 🤚 ⚠
@@ -55,7 +55,7 @@
👫 🔗 💪 `raise` ⚠, 🎏 😐 🔗:
```Python hl_lines="8 13"
-{!../../../docs_src/dependencies/tutorial006.py!}
+{!../../docs_src/dependencies/tutorial006.py!}
```
### 📨 💲
@@ -65,7 +65,7 @@
, 👆 💪 🏤-⚙️ 😐 🔗 (👈 📨 💲) 👆 ⏪ ⚙️ 👱 🙆, & ✋️ 💲 🏆 🚫 ⚙️, 🔗 🔜 🛠️:
```Python hl_lines="9 14"
-{!../../../docs_src/dependencies/tutorial006.py!}
+{!../../docs_src/dependencies/tutorial006.py!}
```
## 🔗 👪 *➡ 🛠️*
diff --git a/docs/em/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/em/docs/tutorial/dependencies/dependencies-with-yield.md
index 5998d06df..e0d6dba24 100644
--- a/docs/em/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/em/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -30,19 +30,19 @@ FastAPI 🐕🦺 🔗 👈 <abbr title='sometimes also called "exit", "cleanu
🕴 📟 ⏭ & 🔌 `yield` 📄 🛠️ ⏭ 📨 📨:
```Python hl_lines="2-4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
🌾 💲 ⚫️❔ 💉 🔘 *➡ 🛠️* & 🎏 🔗:
```Python hl_lines="4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
📟 📄 `yield` 📄 🛠️ ⏮️ 📨 ✔️ 🚚:
```Python hl_lines="5-6"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
/// tip
@@ -64,7 +64,7 @@ FastAPI 🐕🦺 🔗 👈 <abbr title='sometimes also called "exit", "cleanu
🎏 🌌, 👆 💪 ⚙️ `finally` ⚒ 💭 🚪 📶 🛠️, 🙅♂ 🤔 🚥 📤 ⚠ ⚖️ 🚫.
```Python hl_lines="3 5"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
## 🎧-🔗 ⏮️ `yield`
@@ -76,7 +76,7 @@ FastAPI 🐕🦺 🔗 👈 <abbr title='sometimes also called "exit", "cleanu
🖼, `dependency_c` 💪 ✔️ 🔗 🔛 `dependency_b`, & `dependency_b` 🔛 `dependency_a`:
```Python hl_lines="4 12 20"
-{!../../../docs_src/dependencies/tutorial008.py!}
+{!../../docs_src/dependencies/tutorial008.py!}
```
& 🌐 👫 💪 ⚙️ `yield`.
@@ -86,7 +86,7 @@ FastAPI 🐕🦺 🔗 👈 <abbr title='sometimes also called "exit", "cleanu
& , 🔄, `dependency_b` 💪 💲 ⚪️➡️ `dependency_a` (📥 📛 `dep_a`) 💪 🚮 🚪 📟.
```Python hl_lines="16-17 24-25"
-{!../../../docs_src/dependencies/tutorial008.py!}
+{!../../docs_src/dependencies/tutorial008.py!}
```
🎏 🌌, 👆 💪 ✔️ 🔗 ⏮️ `yield` & `return` 🌀.
@@ -225,7 +225,7 @@ with open("./somefile.txt") as f:
`with` ⚖️ `async with` 📄 🔘 🔗 🔢:
```Python hl_lines="1-9 13"
-{!../../../docs_src/dependencies/tutorial010.py!}
+{!../../docs_src/dependencies/tutorial010.py!}
```
/// tip
diff --git a/docs/em/docs/tutorial/dependencies/global-dependencies.md b/docs/em/docs/tutorial/dependencies/global-dependencies.md
index 81759d0e8..bb69e78a8 100644
--- a/docs/em/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/em/docs/tutorial/dependencies/global-dependencies.md
@@ -7,7 +7,7 @@
👈 💼, 👫 🔜 ✔ 🌐 *➡ 🛠️* 🈸:
```Python hl_lines="15"
-{!../../../docs_src/dependencies/tutorial012.py!}
+{!../../docs_src/dependencies/tutorial012.py!}
```
& 🌐 💭 📄 🔃 [❎ `dependencies` *➡ 🛠️ 👨🎨*](dependencies-in-path-operation-decorators.md){.internal-link target=_blank} ✔, ✋️ 👉 💼, 🌐 *➡ 🛠️* 📱.
diff --git a/docs/em/docs/tutorial/dependencies/index.md b/docs/em/docs/tutorial/dependencies/index.md
index efb4ee672..b029b85b7 100644
--- a/docs/em/docs/tutorial/dependencies/index.md
+++ b/docs/em/docs/tutorial/dependencies/index.md
@@ -34,7 +34,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="8-11"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -42,7 +42,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="6-7"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -70,7 +70,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -78,7 +78,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="1"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -90,7 +90,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="15 20"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -98,7 +98,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="11 16"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/dependencies/sub-dependencies.md b/docs/em/docs/tutorial/dependencies/sub-dependencies.md
index 02b33ccd7..a1e7be134 100644
--- a/docs/em/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/em/docs/tutorial/dependencies/sub-dependencies.md
@@ -13,7 +13,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
@@ -21,7 +21,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="6-7"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -37,7 +37,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
@@ -45,7 +45,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -64,7 +64,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="22"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
@@ -72,7 +72,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/encoder.md b/docs/em/docs/tutorial/encoder.md
index 314f5b324..21419ef21 100644
--- a/docs/em/docs/tutorial/encoder.md
+++ b/docs/em/docs/tutorial/encoder.md
@@ -23,7 +23,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="5 22"
-{!> ../../../docs_src/encoder/tutorial001.py!}
+{!> ../../docs_src/encoder/tutorial001.py!}
```
////
@@ -31,7 +31,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="4 21"
-{!> ../../../docs_src/encoder/tutorial001_py310.py!}
+{!> ../../docs_src/encoder/tutorial001_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/extra-data-types.md b/docs/em/docs/tutorial/extra-data-types.md
index cbe111079..1d473bd93 100644
--- a/docs/em/docs/tutorial/extra-data-types.md
+++ b/docs/em/docs/tutorial/extra-data-types.md
@@ -58,7 +58,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="1 3 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
@@ -66,7 +66,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="1 2 11-15"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
@@ -76,7 +76,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
@@ -84,7 +84,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="17-18"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/extra-models.md b/docs/em/docs/tutorial/extra-models.md
index 4703c7123..4fdf196e8 100644
--- a/docs/em/docs/tutorial/extra-models.md
+++ b/docs/em/docs/tutorial/extra-models.md
@@ -23,7 +23,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9 11 16 22 24 29-30 33-35 40-41"
-{!> ../../../docs_src/extra_models/tutorial001.py!}
+{!> ../../docs_src/extra_models/tutorial001.py!}
```
////
@@ -31,7 +31,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7 9 14 20 22 27-28 31-33 38-39"
-{!> ../../../docs_src/extra_models/tutorial001_py310.py!}
+{!> ../../docs_src/extra_models/tutorial001_py310.py!}
```
////
@@ -171,7 +171,7 @@ UserInDB(
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9 15-16 19-20 23-24"
-{!> ../../../docs_src/extra_models/tutorial002.py!}
+{!> ../../docs_src/extra_models/tutorial002.py!}
```
////
@@ -179,7 +179,7 @@ UserInDB(
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7 13-14 17-18 21-22"
-{!> ../../../docs_src/extra_models/tutorial002_py310.py!}
+{!> ../../docs_src/extra_models/tutorial002_py310.py!}
```
////
@@ -201,7 +201,7 @@ UserInDB(
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="1 14-15 18-20 33"
-{!> ../../../docs_src/extra_models/tutorial003.py!}
+{!> ../../docs_src/extra_models/tutorial003.py!}
```
////
@@ -209,7 +209,7 @@ UserInDB(
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="1 14-15 18-20 33"
-{!> ../../../docs_src/extra_models/tutorial003_py310.py!}
+{!> ../../docs_src/extra_models/tutorial003_py310.py!}
```
////
@@ -237,7 +237,7 @@ some_variable: PlaneItem | CarItem
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="1 20"
-{!> ../../../docs_src/extra_models/tutorial004.py!}
+{!> ../../docs_src/extra_models/tutorial004.py!}
```
////
@@ -245,7 +245,7 @@ some_variable: PlaneItem | CarItem
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="18"
-{!> ../../../docs_src/extra_models/tutorial004_py39.py!}
+{!> ../../docs_src/extra_models/tutorial004_py39.py!}
```
////
@@ -261,7 +261,7 @@ some_variable: PlaneItem | CarItem
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="1 8"
-{!> ../../../docs_src/extra_models/tutorial005.py!}
+{!> ../../docs_src/extra_models/tutorial005.py!}
```
////
@@ -269,7 +269,7 @@ some_variable: PlaneItem | CarItem
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="6"
-{!> ../../../docs_src/extra_models/tutorial005_py39.py!}
+{!> ../../docs_src/extra_models/tutorial005_py39.py!}
```
////
diff --git a/docs/em/docs/tutorial/first-steps.md b/docs/em/docs/tutorial/first-steps.md
index 158189e6e..d8cc05c40 100644
--- a/docs/em/docs/tutorial/first-steps.md
+++ b/docs/em/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
🙅 FastAPI 📁 💪 👀 💖 👉:
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
📁 👈 📁 `main.py`.
@@ -134,7 +134,7 @@ INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
### 🔁 1️⃣: 🗄 `FastAPI`
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI` 🐍 🎓 👈 🚚 🌐 🛠️ 👆 🛠️.
@@ -150,7 +150,7 @@ INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
### 🔁 2️⃣: ✍ `FastAPI` "👐"
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
📥 `app` 🔢 🔜 "👐" 🎓 `FastAPI`.
@@ -172,7 +172,7 @@ $ uvicorn main:app --reload
🚥 👆 ✍ 👆 📱 💖:
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial002.py!}
+{!../../docs_src/first_steps/tutorial002.py!}
```
& 🚮 ⚫️ 📁 `main.py`, ⤴️ 👆 🔜 🤙 `uvicorn` 💖:
@@ -251,7 +251,7 @@ https://example.com/items/foo
#### 🔬 *➡ 🛠️ 👨🎨*
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`@app.get("/")` 💬 **FastAPI** 👈 🔢 ▶️️ 🔛 🈚 🚚 📨 👈 🚶:
@@ -307,7 +307,7 @@ https://example.com/items/foo
* **🔢**: 🔢 🔛 "👨🎨" (🔛 `@app.get("/")`).
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
👉 🐍 🔢.
@@ -321,7 +321,7 @@ https://example.com/items/foo
👆 💪 🔬 ⚫️ 😐 🔢 ↩️ `async def`:
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note
@@ -333,7 +333,7 @@ https://example.com/items/foo
### 🔁 5️⃣: 📨 🎚
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
👆 💪 📨 `dict`, `list`, ⭐ 💲 `str`, `int`, ♒️.
diff --git a/docs/em/docs/tutorial/handling-errors.md b/docs/em/docs/tutorial/handling-errors.md
index ed32ab53a..7f6a704eb 100644
--- a/docs/em/docs/tutorial/handling-errors.md
+++ b/docs/em/docs/tutorial/handling-errors.md
@@ -26,7 +26,7 @@
### 🗄 `HTTPException`
```Python hl_lines="1"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
### 🤚 `HTTPException` 👆 📟
@@ -42,7 +42,7 @@
👉 🖼, 🕐❔ 👩💻 📨 🏬 🆔 👈 🚫 🔀, 🤚 ⚠ ⏮️ 👔 📟 `404`:
```Python hl_lines="11"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
### 📉 📨
@@ -82,7 +82,7 @@
✋️ 💼 👆 💪 ⚫️ 🏧 😐, 👆 💪 🚮 🛃 🎚:
```Python hl_lines="14"
-{!../../../docs_src/handling_errors/tutorial002.py!}
+{!../../docs_src/handling_errors/tutorial002.py!}
```
## ❎ 🛃 ⚠ 🐕🦺
@@ -96,7 +96,7 @@
👆 💪 🚮 🛃 ⚠ 🐕🦺 ⏮️ `@app.exception_handler()`:
```Python hl_lines="5-7 13-18 24"
-{!../../../docs_src/handling_errors/tutorial003.py!}
+{!../../docs_src/handling_errors/tutorial003.py!}
```
📥, 🚥 👆 📨 `/unicorns/yolo`, *➡ 🛠️* 🔜 `raise` `UnicornException`.
@@ -136,7 +136,7 @@
⚠ 🐕🦺 🔜 📨 `Request` & ⚠.
```Python hl_lines="2 14-16"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
🔜, 🚥 👆 🚶 `/items/foo`, ↩️ 💆♂ 🔢 🎻 ❌ ⏮️:
@@ -189,7 +189,7 @@ path -> item_id
🖼, 👆 💪 💚 📨 ✅ ✍ 📨 ↩️ 🎻 👫 ❌:
```Python hl_lines="3-4 9-11 22"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
/// note | "📡 ℹ"
@@ -207,7 +207,7 @@ path -> item_id
👆 💪 ⚙️ ⚫️ ⏪ 🛠️ 👆 📱 🕹 💪 & ℹ ⚫️, 📨 ⚫️ 👩💻, ♒️.
```Python hl_lines="14"
-{!../../../docs_src/handling_errors/tutorial005.py!}
+{!../../docs_src/handling_errors/tutorial005.py!}
```
🔜 🔄 📨 ❌ 🏬 💖:
@@ -267,7 +267,7 @@ from starlette.exceptions import HTTPException as StarletteHTTPException
🚥 👆 💚 ⚙️ ⚠ ⤴️ ⏮️ 🎏 🔢 ⚠ 🐕🦺 ⚪️➡️ **FastAPI**, 👆 💪 🗄 & 🏤-⚙️ 🔢 ⚠ 🐕🦺 ⚪️➡️ `fastapi.exception_handlers`:
```Python hl_lines="2-5 15 21"
-{!../../../docs_src/handling_errors/tutorial006.py!}
+{!../../docs_src/handling_errors/tutorial006.py!}
```
👉 🖼 👆 `print`😅 ❌ ⏮️ 📶 🎨 📧, ✋️ 👆 🤚 💭. 👆 💪 ⚙️ ⚠ & ⤴️ 🏤-⚙️ 🔢 ⚠ 🐕🦺.
diff --git a/docs/em/docs/tutorial/header-params.md b/docs/em/docs/tutorial/header-params.md
index 82583c7c3..34abd3a4c 100644
--- a/docs/em/docs/tutorial/header-params.md
+++ b/docs/em/docs/tutorial/header-params.md
@@ -9,7 +9,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001.py!}
+{!> ../../docs_src/header_params/tutorial001.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="1"
-{!> ../../../docs_src/header_params/tutorial001_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_py310.py!}
```
////
@@ -31,7 +31,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001.py!}
+{!> ../../docs_src/header_params/tutorial001.py!}
```
////
@@ -39,7 +39,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/header_params/tutorial001_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_py310.py!}
```
////
@@ -77,7 +77,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial002.py!}
+{!> ../../docs_src/header_params/tutorial002.py!}
```
////
@@ -85,7 +85,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="8"
-{!> ../../../docs_src/header_params/tutorial002_py310.py!}
+{!> ../../docs_src/header_params/tutorial002_py310.py!}
```
////
@@ -109,7 +109,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003.py!}
+{!> ../../docs_src/header_params/tutorial003.py!}
```
////
@@ -117,7 +117,7 @@
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_py39.py!}
+{!> ../../docs_src/header_params/tutorial003_py39.py!}
```
////
@@ -125,7 +125,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/header_params/tutorial003_py310.py!}
+{!> ../../docs_src/header_params/tutorial003_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/metadata.md b/docs/em/docs/tutorial/metadata.md
index 6caeed4cd..a30db113d 100644
--- a/docs/em/docs/tutorial/metadata.md
+++ b/docs/em/docs/tutorial/metadata.md
@@ -18,7 +18,7 @@
👆 💪 ⚒ 👫 ⏩:
```Python hl_lines="3-16 19-31"
-{!../../../docs_src/metadata/tutorial001.py!}
+{!../../docs_src/metadata/tutorial001.py!}
```
/// tip
@@ -52,7 +52,7 @@
✍ 🗃 👆 🔖 & 🚶♀️ ⚫️ `openapi_tags` 🔢:
```Python hl_lines="3-16 18"
-{!../../../docs_src/metadata/tutorial004.py!}
+{!../../docs_src/metadata/tutorial004.py!}
```
👀 👈 👆 💪 ⚙️ ✍ 🔘 📛, 🖼 "💳" 🔜 🎦 🦁 (**💳**) & "🎀" 🔜 🎦 ❕ (_🎀_).
@@ -68,7 +68,7 @@
⚙️ `tags` 🔢 ⏮️ 👆 *➡ 🛠️* (& `APIRouter`Ⓜ) 🛠️ 👫 🎏 🔖:
```Python hl_lines="21 26"
-{!../../../docs_src/metadata/tutorial004.py!}
+{!../../docs_src/metadata/tutorial004.py!}
```
/// info
@@ -98,7 +98,7 @@
🖼, ⚒ ⚫️ 🍦 `/api/v1/openapi.json`:
```Python hl_lines="3"
-{!../../../docs_src/metadata/tutorial002.py!}
+{!../../docs_src/metadata/tutorial002.py!}
```
🚥 👆 💚 ❎ 🗄 🔗 🍕 👆 💪 ⚒ `openapi_url=None`, 👈 🔜 ❎ 🧾 👩💻 🔢 👈 ⚙️ ⚫️.
@@ -117,5 +117,5 @@
🖼, ⚒ 🦁 🎚 🍦 `/documentation` & ❎ 📄:
```Python hl_lines="3"
-{!../../../docs_src/metadata/tutorial003.py!}
+{!../../docs_src/metadata/tutorial003.py!}
```
diff --git a/docs/em/docs/tutorial/middleware.md b/docs/em/docs/tutorial/middleware.md
index b9bb12e00..cd0777ebb 100644
--- a/docs/em/docs/tutorial/middleware.md
+++ b/docs/em/docs/tutorial/middleware.md
@@ -32,7 +32,7 @@
* 👆 💪 ⤴️ 🔀 🌅 `response` ⏭ 🛬 ⚫️.
```Python hl_lines="8-9 11 14"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
/// tip
@@ -60,7 +60,7 @@
🖼, 👆 💪 🚮 🛃 🎚 `X-Process-Time` ⚗ 🕰 🥈 👈 ⚫️ ✊ 🛠️ 📨 & 🏗 📨:
```Python hl_lines="10 12-13"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
## 🎏 🛠️
diff --git a/docs/em/docs/tutorial/path-operation-configuration.md b/docs/em/docs/tutorial/path-operation-configuration.md
index 1979bed2b..9529928fb 100644
--- a/docs/em/docs/tutorial/path-operation-configuration.md
+++ b/docs/em/docs/tutorial/path-operation-configuration.md
@@ -19,7 +19,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="3 17"
-{!> ../../../docs_src/path_operation_configuration/tutorial001.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001.py!}
```
////
@@ -27,7 +27,7 @@
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="3 17"
-{!> ../../../docs_src/path_operation_configuration/tutorial001_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001_py39.py!}
```
////
@@ -35,7 +35,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="1 15"
-{!> ../../../docs_src/path_operation_configuration/tutorial001_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001_py310.py!}
```
////
@@ -57,7 +57,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="17 22 27"
-{!> ../../../docs_src/path_operation_configuration/tutorial002.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002.py!}
```
////
@@ -65,7 +65,7 @@
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="17 22 27"
-{!> ../../../docs_src/path_operation_configuration/tutorial002_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002_py39.py!}
```
////
@@ -73,7 +73,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="15 20 25"
-{!> ../../../docs_src/path_operation_configuration/tutorial002_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002_py310.py!}
```
////
@@ -91,7 +91,7 @@
**FastAPI** 🐕🦺 👈 🎏 🌌 ⏮️ ✅ 🎻:
```Python hl_lines="1 8-10 13 18"
-{!../../../docs_src/path_operation_configuration/tutorial002b.py!}
+{!../../docs_src/path_operation_configuration/tutorial002b.py!}
```
## 📄 & 📛
@@ -101,7 +101,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="20-21"
-{!> ../../../docs_src/path_operation_configuration/tutorial003.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003.py!}
```
////
@@ -109,7 +109,7 @@
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="20-21"
-{!> ../../../docs_src/path_operation_configuration/tutorial003_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003_py39.py!}
```
////
@@ -117,7 +117,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="18-19"
-{!> ../../../docs_src/path_operation_configuration/tutorial003_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003_py310.py!}
```
////
@@ -131,7 +131,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="19-27"
-{!> ../../../docs_src/path_operation_configuration/tutorial004.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004.py!}
```
////
@@ -139,7 +139,7 @@
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="19-27"
-{!> ../../../docs_src/path_operation_configuration/tutorial004_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004_py39.py!}
```
////
@@ -147,7 +147,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="17-25"
-{!> ../../../docs_src/path_operation_configuration/tutorial004_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004_py310.py!}
```
////
@@ -163,7 +163,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="21"
-{!> ../../../docs_src/path_operation_configuration/tutorial005.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005.py!}
```
////
@@ -171,7 +171,7 @@
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="21"
-{!> ../../../docs_src/path_operation_configuration/tutorial005_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005_py39.py!}
```
////
@@ -179,7 +179,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="19"
-{!> ../../../docs_src/path_operation_configuration/tutorial005_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005_py310.py!}
```
////
@@ -205,7 +205,7 @@
🚥 👆 💪 ™ *➡ 🛠️* <abbr title="obsolete, recommended not to use it">😢</abbr>, ✋️ 🍵 ❎ ⚫️, 🚶♀️ 🔢 `deprecated`:
```Python hl_lines="16"
-{!../../../docs_src/path_operation_configuration/tutorial006.py!}
+{!../../docs_src/path_operation_configuration/tutorial006.py!}
```
⚫️ 🔜 🎯 ™ 😢 🎓 🩺:
diff --git a/docs/em/docs/tutorial/path-params-numeric-validations.md b/docs/em/docs/tutorial/path-params-numeric-validations.md
index a7952984c..c25f0323e 100644
--- a/docs/em/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/em/docs/tutorial/path-params-numeric-validations.md
@@ -9,7 +9,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="1"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -31,7 +31,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -39,7 +39,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="8"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -71,7 +71,7 @@
, 👆 💪 📣 👆 🔢:
```Python hl_lines="7"
-{!../../../docs_src/path_params_numeric_validations/tutorial002.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial002.py!}
```
## ✔ 🔢 👆 💪, 🎱
@@ -83,7 +83,7 @@
🐍 🏆 🚫 🕳 ⏮️ 👈 `*`, ✋️ ⚫️ 🔜 💭 👈 🌐 📄 🔢 🔜 🤙 🇨🇻 ❌ (🔑-💲 👫), 💭 <abbr title="From: K-ey W-ord Arg-uments"><code>kwargs</code></abbr>. 🚥 👫 🚫 ✔️ 🔢 💲.
```Python hl_lines="7"
-{!../../../docs_src/path_params_numeric_validations/tutorial003.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial003.py!}
```
## 🔢 🔬: 👑 🌘 ⚖️ 🌓
@@ -93,7 +93,7 @@
📥, ⏮️ `ge=1`, `item_id` 🔜 💪 🔢 🔢 "`g`🅾 🌘 ⚖️ `e`🅾" `1`.
```Python hl_lines="8"
-{!../../../docs_src/path_params_numeric_validations/tutorial004.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial004.py!}
```
## 🔢 🔬: 🌘 🌘 & 🌘 🌘 ⚖️ 🌓
@@ -104,7 +104,7 @@
* `le`: `l`👭 🌘 ⚖️ `e`🅾
```Python hl_lines="9"
-{!../../../docs_src/path_params_numeric_validations/tutorial005.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial005.py!}
```
## 🔢 🔬: 🎈, 🌘 🌘 & 🌘 🌘
@@ -118,7 +118,7 @@
& 🎏 <abbr title="less than"><code>lt</code></abbr>.
```Python hl_lines="11"
-{!../../../docs_src/path_params_numeric_validations/tutorial006.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial006.py!}
```
## 🌃
diff --git a/docs/em/docs/tutorial/path-params.md b/docs/em/docs/tutorial/path-params.md
index e0d51a1df..daf5417eb 100644
--- a/docs/em/docs/tutorial/path-params.md
+++ b/docs/em/docs/tutorial/path-params.md
@@ -3,7 +3,7 @@
👆 💪 📣 ➡ "🔢" ⚖️ "🔢" ⏮️ 🎏 ❕ ⚙️ 🐍 📁 🎻:
```Python hl_lines="6-7"
-{!../../../docs_src/path_params/tutorial001.py!}
+{!../../docs_src/path_params/tutorial001.py!}
```
💲 ➡ 🔢 `item_id` 🔜 🚶♀️ 👆 🔢 ❌ `item_id`.
@@ -19,7 +19,7 @@
👆 💪 📣 🆎 ➡ 🔢 🔢, ⚙️ 🐩 🐍 🆎 ✍:
```Python hl_lines="7"
-{!../../../docs_src/path_params/tutorial002.py!}
+{!../../docs_src/path_params/tutorial002.py!}
```
👉 💼, `item_id` 📣 `int`.
@@ -122,7 +122,7 @@
↩️ *➡ 🛠️* 🔬 ✔, 👆 💪 ⚒ 💭 👈 ➡ `/users/me` 📣 ⏭ 1️⃣ `/users/{user_id}`:
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003.py!}
+{!../../docs_src/path_params/tutorial003.py!}
```
⏪, ➡ `/users/{user_id}` 🔜 🏏 `/users/me`, "💭" 👈 ⚫️ 📨 🔢 `user_id` ⏮️ 💲 `"me"`.
@@ -130,7 +130,7 @@
➡, 👆 🚫🔜 ↔ ➡ 🛠️:
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003b.py!}
+{!../../docs_src/path_params/tutorial003b.py!}
```
🥇 🕐 🔜 🕧 ⚙️ ↩️ ➡ 🏏 🥇.
@@ -148,7 +148,7 @@
⤴️ ✍ 🎓 🔢 ⏮️ 🔧 💲, ❔ 🔜 💪 ☑ 💲:
```Python hl_lines="1 6-9"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// info
@@ -168,7 +168,7 @@
⤴️ ✍ *➡ 🔢* ⏮️ 🆎 ✍ ⚙️ 🔢 🎓 👆 ✍ (`ModelName`):
```Python hl_lines="16"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
### ✅ 🩺
@@ -186,7 +186,7 @@
👆 💪 🔬 ⚫️ ⏮️ *🔢 👨🎓* 👆 ✍ 🔢 `ModelName`:
```Python hl_lines="17"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
#### 🤚 *🔢 💲*
@@ -194,7 +194,7 @@
👆 💪 🤚 ☑ 💲 ( `str` 👉 💼) ⚙️ `model_name.value`, ⚖️ 🏢, `your_enum_member.value`:
```Python hl_lines="20"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// tip
@@ -210,7 +210,7 @@
👫 🔜 🗜 👫 🔗 💲 (🎻 👉 💼) ⏭ 🛬 👫 👩💻:
```Python hl_lines="18 21 23"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
👆 👩💻 👆 🔜 🤚 🎻 📨 💖:
@@ -251,7 +251,7 @@
, 👆 💪 ⚙️ ⚫️ ⏮️:
```Python hl_lines="6"
-{!../../../docs_src/path_params/tutorial004.py!}
+{!../../docs_src/path_params/tutorial004.py!}
```
/// tip
diff --git a/docs/em/docs/tutorial/query-params-str-validations.md b/docs/em/docs/tutorial/query-params-str-validations.md
index 23873155e..f75c0a26f 100644
--- a/docs/em/docs/tutorial/query-params-str-validations.md
+++ b/docs/em/docs/tutorial/query-params-str-validations.md
@@ -7,7 +7,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial001.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial001.py!}
```
////
@@ -15,7 +15,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial001_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial001_py310.py!}
```
////
@@ -41,7 +41,7 @@ FastAPI 🔜 💭 👈 💲 `q` 🚫 ✔ ↩️ 🔢 💲 `= None`.
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="3"
-{!> ../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002.py!}
```
////
@@ -49,7 +49,7 @@ FastAPI 🔜 💭 👈 💲 `q` 🚫 ✔ ↩️ 🔢 💲 `= None`.
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="1"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_py310.py!}
```
////
@@ -61,7 +61,7 @@ FastAPI 🔜 💭 👈 💲 `q` 🚫 ✔ ↩️ 🔢 💲 `= None`.
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002.py!}
```
////
@@ -69,7 +69,7 @@ FastAPI 🔜 💭 👈 💲 `q` 🚫 ✔ ↩️ 🔢 💲 `= None`.
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_py310.py!}
```
////
@@ -137,7 +137,7 @@ q: Union[str, None] = Query(default=None, max_length=50)
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial003.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003.py!}
```
////
@@ -145,7 +145,7 @@ q: Union[str, None] = Query(default=None, max_length=50)
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial003_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003_py310.py!}
```
////
@@ -157,7 +157,7 @@ q: Union[str, None] = Query(default=None, max_length=50)
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial004.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004.py!}
```
////
@@ -165,7 +165,7 @@ q: Union[str, None] = Query(default=None, max_length=50)
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_py310.py!}
```
////
@@ -187,7 +187,7 @@ q: Union[str, None] = Query(default=None, max_length=50)
➡️ 💬 👈 👆 💚 📣 `q` 🔢 🔢 ✔️ `min_length` `3`, & ✔️ 🔢 💲 `"fixedquery"`:
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial005.py!}
+{!../../docs_src/query_params_str_validations/tutorial005.py!}
```
/// note
@@ -219,7 +219,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
, 🕐❔ 👆 💪 📣 💲 ✔ ⏪ ⚙️ `Query`, 👆 💪 🎯 🚫 📣 🔢 💲:
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial006.py!}
+{!../../docs_src/query_params_str_validations/tutorial006.py!}
```
### ✔ ⏮️ ❕ (`...`)
@@ -227,7 +227,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
📤 🎛 🌌 🎯 📣 👈 💲 ✔. 👆 💪 ⚒ `default` 🔢 🔑 💲 `...`:
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial006b.py!}
+{!../../docs_src/query_params_str_validations/tutorial006b.py!}
```
/// info
@@ -249,7 +249,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c.py!}
```
////
@@ -257,7 +257,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c_py310.py!}
```
////
@@ -273,7 +273,7 @@ Pydantic, ❔ ⚫️❔ 🏋️ 🌐 💽 🔬 & 🛠️ FastAPI, ✔️
🚥 👆 💭 😬 ⚙️ `...`, 👆 💪 🗄 & ⚙️ `Required` ⚪️➡️ Pydantic:
```Python hl_lines="2 8"
-{!../../../docs_src/query_params_str_validations/tutorial006d.py!}
+{!../../docs_src/query_params_str_validations/tutorial006d.py!}
```
/// tip
@@ -291,7 +291,7 @@ Pydantic, ❔ ⚫️❔ 🏋️ 🌐 💽 🔬 & 🛠️ FastAPI, ✔️
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011.py!}
```
////
@@ -299,7 +299,7 @@ Pydantic, ❔ ⚫️❔ 🏋️ 🌐 💽 🔬 & 🛠️ FastAPI, ✔️
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_py39.py!}
```
////
@@ -307,7 +307,7 @@ Pydantic, ❔ ⚫️❔ 🏋️ 🌐 💽 🔬 & 🛠️ FastAPI, ✔️
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_py310.py!}
```
////
@@ -348,7 +348,7 @@ http://localhost:8000/items/?q=foo&q=bar
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial012.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012.py!}
```
////
@@ -356,7 +356,7 @@ http://localhost:8000/items/?q=foo&q=bar
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial012_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012_py39.py!}
```
////
@@ -383,7 +383,7 @@ http://localhost:8000/items/
👆 💪 ⚙️ `list` 🔗 ↩️ `List[str]` (⚖️ `list[str]` 🐍 3️⃣.9️⃣ ➕):
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial013.py!}
+{!../../docs_src/query_params_str_validations/tutorial013.py!}
```
/// note
@@ -413,7 +413,7 @@ http://localhost:8000/items/
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial007.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007.py!}
```
////
@@ -421,7 +421,7 @@ http://localhost:8000/items/
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial007_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007_py310.py!}
```
////
@@ -431,7 +431,7 @@ http://localhost:8000/items/
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="13"
-{!> ../../../docs_src/query_params_str_validations/tutorial008.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008.py!}
```
////
@@ -439,7 +439,7 @@ http://localhost:8000/items/
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial008_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008_py310.py!}
```
////
@@ -465,7 +465,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial009.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009.py!}
```
////
@@ -473,7 +473,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial009_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009_py310.py!}
```
////
@@ -489,7 +489,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="18"
-{!> ../../../docs_src/query_params_str_validations/tutorial010.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010.py!}
```
////
@@ -497,7 +497,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="16"
-{!> ../../../docs_src/query_params_str_validations/tutorial010_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010_py310.py!}
```
////
@@ -513,7 +513,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial014.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014.py!}
```
////
@@ -521,7 +521,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial014_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/query-params.md b/docs/em/docs/tutorial/query-params.md
index 9bdab9e3c..c8432f182 100644
--- a/docs/em/docs/tutorial/query-params.md
+++ b/docs/em/docs/tutorial/query-params.md
@@ -3,7 +3,7 @@
🕐❔ 👆 📣 🎏 🔢 🔢 👈 🚫 🍕 ➡ 🔢, 👫 🔁 🔬 "🔢" 🔢.
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial001.py!}
+{!../../docs_src/query_params/tutorial001.py!}
```
🔢 ⚒ 🔑-💲 👫 👈 🚶 ⏮️ `?` 📛, 🎏 `&` 🦹.
@@ -66,7 +66,7 @@ http://127.0.0.1:8000/items/?skip=20
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial002.py!}
+{!> ../../docs_src/query_params/tutorial002.py!}
```
////
@@ -74,7 +74,7 @@ http://127.0.0.1:8000/items/?skip=20
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial002_py310.py!}
+{!> ../../docs_src/query_params/tutorial002_py310.py!}
```
////
@@ -94,7 +94,7 @@ http://127.0.0.1:8000/items/?skip=20
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial003.py!}
+{!> ../../docs_src/query_params/tutorial003.py!}
```
////
@@ -102,7 +102,7 @@ http://127.0.0.1:8000/items/?skip=20
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial003_py310.py!}
+{!> ../../docs_src/query_params/tutorial003_py310.py!}
```
////
@@ -151,7 +151,7 @@ http://127.0.0.1:8000/items/foo?short=yes
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="8 10"
-{!> ../../../docs_src/query_params/tutorial004.py!}
+{!> ../../docs_src/query_params/tutorial004.py!}
```
////
@@ -159,7 +159,7 @@ http://127.0.0.1:8000/items/foo?short=yes
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="6 8"
-{!> ../../../docs_src/query_params/tutorial004_py310.py!}
+{!> ../../docs_src/query_params/tutorial004_py310.py!}
```
////
@@ -173,7 +173,7 @@ http://127.0.0.1:8000/items/foo?short=yes
✋️ 🕐❔ 👆 💚 ⚒ 🔢 🔢 ✔, 👆 💪 🚫 📣 🙆 🔢 💲:
```Python hl_lines="6-7"
-{!../../../docs_src/query_params/tutorial005.py!}
+{!../../docs_src/query_params/tutorial005.py!}
```
📥 🔢 🔢 `needy` ✔ 🔢 🔢 🆎 `str`.
@@ -221,7 +221,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="10"
-{!> ../../../docs_src/query_params/tutorial006.py!}
+{!> ../../docs_src/query_params/tutorial006.py!}
```
////
@@ -229,7 +229,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="8"
-{!> ../../../docs_src/query_params/tutorial006_py310.py!}
+{!> ../../docs_src/query_params/tutorial006_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/request-files.md b/docs/em/docs/tutorial/request-files.md
index 010aa76bf..102690f4b 100644
--- a/docs/em/docs/tutorial/request-files.md
+++ b/docs/em/docs/tutorial/request-files.md
@@ -17,7 +17,7 @@
🗄 `File` & `UploadFile` ⚪️➡️ `fastapi`:
```Python hl_lines="1"
-{!../../../docs_src/request_files/tutorial001.py!}
+{!../../docs_src/request_files/tutorial001.py!}
```
## 🔬 `File` 🔢
@@ -25,7 +25,7 @@
✍ 📁 🔢 🎏 🌌 👆 🔜 `Body` ⚖️ `Form`:
```Python hl_lines="7"
-{!../../../docs_src/request_files/tutorial001.py!}
+{!../../docs_src/request_files/tutorial001.py!}
```
/// info
@@ -55,7 +55,7 @@
🔬 📁 🔢 ⏮️ 🆎 `UploadFile`:
```Python hl_lines="12"
-{!../../../docs_src/request_files/tutorial001.py!}
+{!../../docs_src/request_files/tutorial001.py!}
```
⚙️ `UploadFile` ✔️ 📚 📈 🤭 `bytes`:
@@ -142,7 +142,7 @@ contents = myfile.file.read()
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02.py!}
+{!> ../../docs_src/request_files/tutorial001_02.py!}
```
////
@@ -150,7 +150,7 @@ contents = myfile.file.read()
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7 14"
-{!> ../../../docs_src/request_files/tutorial001_02_py310.py!}
+{!> ../../docs_src/request_files/tutorial001_02_py310.py!}
```
////
@@ -160,7 +160,7 @@ contents = myfile.file.read()
👆 💪 ⚙️ `File()` ⏮️ `UploadFile`, 🖼, ⚒ 🌖 🗃:
```Python hl_lines="13"
-{!../../../docs_src/request_files/tutorial001_03.py!}
+{!../../docs_src/request_files/tutorial001_03.py!}
```
## 💗 📁 📂
@@ -174,7 +174,7 @@ contents = myfile.file.read()
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="10 15"
-{!> ../../../docs_src/request_files/tutorial002.py!}
+{!> ../../docs_src/request_files/tutorial002.py!}
```
////
@@ -182,7 +182,7 @@ contents = myfile.file.read()
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="8 13"
-{!> ../../../docs_src/request_files/tutorial002_py39.py!}
+{!> ../../docs_src/request_files/tutorial002_py39.py!}
```
////
@@ -204,7 +204,7 @@ contents = myfile.file.read()
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="18"
-{!> ../../../docs_src/request_files/tutorial003.py!}
+{!> ../../docs_src/request_files/tutorial003.py!}
```
////
@@ -212,7 +212,7 @@ contents = myfile.file.read()
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="16"
-{!> ../../../docs_src/request_files/tutorial003_py39.py!}
+{!> ../../docs_src/request_files/tutorial003_py39.py!}
```
////
diff --git a/docs/em/docs/tutorial/request-forms-and-files.md b/docs/em/docs/tutorial/request-forms-and-files.md
index ab39d1b94..80793dae4 100644
--- a/docs/em/docs/tutorial/request-forms-and-files.md
+++ b/docs/em/docs/tutorial/request-forms-and-files.md
@@ -13,7 +13,7 @@
## 🗄 `File` & `Form`
```Python hl_lines="1"
-{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!../../docs_src/request_forms_and_files/tutorial001.py!}
```
## 🔬 `File` & `Form` 🔢
@@ -21,7 +21,7 @@
✍ 📁 & 📨 🔢 🎏 🌌 👆 🔜 `Body` ⚖️ `Query`:
```Python hl_lines="8"
-{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!../../docs_src/request_forms_and_files/tutorial001.py!}
```
📁 & 📨 🏑 🔜 📂 📨 📊 & 👆 🔜 📨 📁 & 📨 🏑.
diff --git a/docs/em/docs/tutorial/request-forms.md b/docs/em/docs/tutorial/request-forms.md
index 74117c47d..cbe4e2862 100644
--- a/docs/em/docs/tutorial/request-forms.md
+++ b/docs/em/docs/tutorial/request-forms.md
@@ -15,7 +15,7 @@
🗄 `Form` ⚪️➡️ `fastapi`:
```Python hl_lines="1"
-{!../../../docs_src/request_forms/tutorial001.py!}
+{!../../docs_src/request_forms/tutorial001.py!}
```
## 🔬 `Form` 🔢
@@ -23,7 +23,7 @@
✍ 📨 🔢 🎏 🌌 👆 🔜 `Body` ⚖️ `Query`:
```Python hl_lines="7"
-{!../../../docs_src/request_forms/tutorial001.py!}
+{!../../docs_src/request_forms/tutorial001.py!}
```
🖼, 1️⃣ 🌌 Oauth2️⃣ 🔧 💪 ⚙️ (🤙 "🔐 💧") ⚫️ ✔ 📨 `username` & `password` 📨 🏑.
diff --git a/docs/em/docs/tutorial/response-model.md b/docs/em/docs/tutorial/response-model.md
index 9483508aa..fb5c17dd6 100644
--- a/docs/em/docs/tutorial/response-model.md
+++ b/docs/em/docs/tutorial/response-model.md
@@ -7,7 +7,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="18 23"
-{!> ../../../docs_src/response_model/tutorial001_01.py!}
+{!> ../../docs_src/response_model/tutorial001_01.py!}
```
////
@@ -15,7 +15,7 @@
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="18 23"
-{!> ../../../docs_src/response_model/tutorial001_01_py39.py!}
+{!> ../../docs_src/response_model/tutorial001_01_py39.py!}
```
////
@@ -23,7 +23,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="16 21"
-{!> ../../../docs_src/response_model/tutorial001_01_py310.py!}
+{!> ../../docs_src/response_model/tutorial001_01_py310.py!}
```
////
@@ -62,7 +62,7 @@ FastAPI 🔜 ⚙️ 👉 📨 🆎:
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001.py!}
+{!> ../../docs_src/response_model/tutorial001.py!}
```
////
@@ -70,7 +70,7 @@ FastAPI 🔜 ⚙️ 👉 📨 🆎:
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001_py39.py!}
+{!> ../../docs_src/response_model/tutorial001_py39.py!}
```
////
@@ -78,7 +78,7 @@ FastAPI 🔜 ⚙️ 👉 📨 🆎:
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001_py310.py!}
+{!> ../../docs_src/response_model/tutorial001_py310.py!}
```
////
@@ -116,7 +116,7 @@ FastAPI 🔜 ⚙️ 👉 `response_model` 🌐 💽 🧾, 🔬, ♒️. & **
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9 11"
-{!> ../../../docs_src/response_model/tutorial002.py!}
+{!> ../../docs_src/response_model/tutorial002.py!}
```
////
@@ -124,7 +124,7 @@ FastAPI 🔜 ⚙️ 👉 `response_model` 🌐 💽 🧾, 🔬, ♒️. & **
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7 9"
-{!> ../../../docs_src/response_model/tutorial002_py310.py!}
+{!> ../../docs_src/response_model/tutorial002_py310.py!}
```
////
@@ -143,7 +143,7 @@ FastAPI 🔜 ⚙️ 👉 `response_model` 🌐 💽 🧾, 🔬, ♒️. & **
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="18"
-{!> ../../../docs_src/response_model/tutorial002.py!}
+{!> ../../docs_src/response_model/tutorial002.py!}
```
////
@@ -151,7 +151,7 @@ FastAPI 🔜 ⚙️ 👉 `response_model` 🌐 💽 🧾, 🔬, ♒️. & **
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="16"
-{!> ../../../docs_src/response_model/tutorial002_py310.py!}
+{!> ../../docs_src/response_model/tutorial002_py310.py!}
```
////
@@ -175,7 +175,7 @@ FastAPI 🔜 ⚙️ 👉 `response_model` 🌐 💽 🧾, 🔬, ♒️. & **
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9 11 16"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -183,7 +183,7 @@ FastAPI 🔜 ⚙️ 👉 `response_model` 🌐 💽 🧾, 🔬, ♒️. & **
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="9 11 16"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -193,7 +193,7 @@ FastAPI 🔜 ⚙️ 👉 `response_model` 🌐 💽 🧾, 🔬, ♒️. & **
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -201,7 +201,7 @@ FastAPI 🔜 ⚙️ 👉 `response_model` 🌐 💽 🧾, 🔬, ♒️. & **
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -211,7 +211,7 @@ FastAPI 🔜 ⚙️ 👉 `response_model` 🌐 💽 🧾, 🔬, ♒️. & **
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -219,7 +219,7 @@ FastAPI 🔜 ⚙️ 👉 `response_model` 🌐 💽 🧾, 🔬, ♒️. & **
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -249,7 +249,7 @@ FastAPI 🔜 ⚙️ 👉 `response_model` 🌐 💽 🧾, 🔬, ♒️. & **
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9-13 15-16 20"
-{!> ../../../docs_src/response_model/tutorial003_01.py!}
+{!> ../../docs_src/response_model/tutorial003_01.py!}
```
////
@@ -257,7 +257,7 @@ FastAPI 🔜 ⚙️ 👉 `response_model` 🌐 💽 🧾, 🔬, ♒️. & **
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7-10 13-14 18"
-{!> ../../../docs_src/response_model/tutorial003_01_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_01_py310.py!}
```
////
@@ -303,7 +303,7 @@ FastAPI 🔨 📚 👜 🔘 ⏮️ Pydantic ⚒ 💭 👈 📚 🎏 🚫 🎓
🏆 ⚠ 💼 🔜 [🛬 📨 🔗 🔬 ⏪ 🏧 🩺](../advanced/response-directly.md){.internal-link target=_blank}.
```Python hl_lines="8 10-11"
-{!> ../../../docs_src/response_model/tutorial003_02.py!}
+{!> ../../docs_src/response_model/tutorial003_02.py!}
```
👉 🙅 💼 🍵 🔁 FastAPI ↩️ 📨 🆎 ✍ 🎓 (⚖️ 🏿) `Response`.
@@ -315,7 +315,7 @@ FastAPI 🔨 📚 👜 🔘 ⏮️ Pydantic ⚒ 💭 👈 📚 🎏 🚫 🎓
👆 💪 ⚙️ 🏿 `Response` 🆎 ✍:
```Python hl_lines="8-9"
-{!> ../../../docs_src/response_model/tutorial003_03.py!}
+{!> ../../docs_src/response_model/tutorial003_03.py!}
```
👉 🔜 👷 ↩️ `RedirectResponse` 🏿 `Response`, & FastAPI 🔜 🔁 🍵 👉 🙅 💼.
@@ -329,7 +329,7 @@ FastAPI 🔨 📚 👜 🔘 ⏮️ Pydantic ⚒ 💭 👈 📚 🎏 🚫 🎓
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="10"
-{!> ../../../docs_src/response_model/tutorial003_04.py!}
+{!> ../../docs_src/response_model/tutorial003_04.py!}
```
////
@@ -337,7 +337,7 @@ FastAPI 🔨 📚 👜 🔘 ⏮️ Pydantic ⚒ 💭 👈 📚 🎏 🚫 🎓
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="8"
-{!> ../../../docs_src/response_model/tutorial003_04_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_04_py310.py!}
```
////
@@ -355,7 +355,7 @@ FastAPI 🔨 📚 👜 🔘 ⏮️ Pydantic ⚒ 💭 👈 📚 🎏 🚫 🎓
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/response_model/tutorial003_05.py!}
+{!> ../../docs_src/response_model/tutorial003_05.py!}
```
////
@@ -363,7 +363,7 @@ FastAPI 🔨 📚 👜 🔘 ⏮️ Pydantic ⚒ 💭 👈 📚 🎏 🚫 🎓
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/response_model/tutorial003_05_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_05_py310.py!}
```
////
@@ -377,7 +377,7 @@ FastAPI 🔨 📚 👜 🔘 ⏮️ Pydantic ⚒ 💭 👈 📚 🎏 🚫 🎓
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="11 13-14"
-{!> ../../../docs_src/response_model/tutorial004.py!}
+{!> ../../docs_src/response_model/tutorial004.py!}
```
////
@@ -385,7 +385,7 @@ FastAPI 🔨 📚 👜 🔘 ⏮️ Pydantic ⚒ 💭 👈 📚 🎏 🚫 🎓
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="11 13-14"
-{!> ../../../docs_src/response_model/tutorial004_py39.py!}
+{!> ../../docs_src/response_model/tutorial004_py39.py!}
```
////
@@ -393,7 +393,7 @@ FastAPI 🔨 📚 👜 🔘 ⏮️ Pydantic ⚒ 💭 👈 📚 🎏 🚫 🎓
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="9 11-12"
-{!> ../../../docs_src/response_model/tutorial004_py310.py!}
+{!> ../../docs_src/response_model/tutorial004_py310.py!}
```
////
@@ -413,7 +413,7 @@ FastAPI 🔨 📚 👜 🔘 ⏮️ Pydantic ⚒ 💭 👈 📚 🎏 🚫 🎓
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial004.py!}
+{!> ../../docs_src/response_model/tutorial004.py!}
```
////
@@ -421,7 +421,7 @@ FastAPI 🔨 📚 👜 🔘 ⏮️ Pydantic ⚒ 💭 👈 📚 🎏 🚫 🎓
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial004_py39.py!}
+{!> ../../docs_src/response_model/tutorial004_py39.py!}
```
////
@@ -429,7 +429,7 @@ FastAPI 🔨 📚 👜 🔘 ⏮️ Pydantic ⚒ 💭 👈 📚 🎏 🚫 🎓
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial004_py310.py!}
+{!> ../../docs_src/response_model/tutorial004_py310.py!}
```
////
@@ -524,7 +524,7 @@ FastAPI 🙃 🥃 (🤙, Pydantic 🙃 🥃) 🤔 👈, ✋️ `description`, `t
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="31 37"
-{!> ../../../docs_src/response_model/tutorial005.py!}
+{!> ../../docs_src/response_model/tutorial005.py!}
```
////
@@ -532,7 +532,7 @@ FastAPI 🙃 🥃 (🤙, Pydantic 🙃 🥃) 🤔 👈, ✋️ `description`, `t
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="29 35"
-{!> ../../../docs_src/response_model/tutorial005_py310.py!}
+{!> ../../docs_src/response_model/tutorial005_py310.py!}
```
////
@@ -552,7 +552,7 @@ FastAPI 🙃 🥃 (🤙, Pydantic 🙃 🥃) 🤔 👈, ✋️ `description`, `t
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="31 37"
-{!> ../../../docs_src/response_model/tutorial006.py!}
+{!> ../../docs_src/response_model/tutorial006.py!}
```
////
@@ -560,7 +560,7 @@ FastAPI 🙃 🥃 (🤙, Pydantic 🙃 🥃) 🤔 👈, ✋️ `description`, `t
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="29 35"
-{!> ../../../docs_src/response_model/tutorial006_py310.py!}
+{!> ../../docs_src/response_model/tutorial006_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/response-status-code.md b/docs/em/docs/tutorial/response-status-code.md
index 57c44777a..cefff708f 100644
--- a/docs/em/docs/tutorial/response-status-code.md
+++ b/docs/em/docs/tutorial/response-status-code.md
@@ -9,7 +9,7 @@
* ♒️.
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
/// note
@@ -77,7 +77,7 @@ FastAPI 💭 👉, & 🔜 🏭 🗄 🩺 👈 🇵🇸 📤 🙅♂ 📨
➡️ 👀 ⏮️ 🖼 🔄:
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
`201` 👔 📟 "✍".
@@ -87,7 +87,7 @@ FastAPI 💭 👉, & 🔜 🏭 🗄 🩺 👈 🇵🇸 📤 🙅♂ 📨
👆 💪 ⚙️ 🏪 🔢 ⚪️➡️ `fastapi.status`.
```Python hl_lines="1 6"
-{!../../../docs_src/response_status_code/tutorial002.py!}
+{!../../docs_src/response_status_code/tutorial002.py!}
```
👫 🏪, 👫 🧑🤝🧑 🎏 🔢, ✋️ 👈 🌌 👆 💪 ⚙️ 👨🎨 📋 🔎 👫:
diff --git a/docs/em/docs/tutorial/schema-extra-example.md b/docs/em/docs/tutorial/schema-extra-example.md
index 8562de09c..e4f877a8e 100644
--- a/docs/em/docs/tutorial/schema-extra-example.md
+++ b/docs/em/docs/tutorial/schema-extra-example.md
@@ -11,7 +11,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="15-23"
-{!> ../../../docs_src/schema_extra_example/tutorial001.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001.py!}
```
////
@@ -19,7 +19,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="13-21"
-{!> ../../../docs_src/schema_extra_example/tutorial001_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001_py310.py!}
```
////
@@ -43,7 +43,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="4 10-13"
-{!> ../../../docs_src/schema_extra_example/tutorial002.py!}
+{!> ../../docs_src/schema_extra_example/tutorial002.py!}
```
////
@@ -51,7 +51,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="2 8-11"
-{!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial002_py310.py!}
```
////
@@ -83,7 +83,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="20-25"
-{!> ../../../docs_src/schema_extra_example/tutorial003.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003.py!}
```
////
@@ -91,7 +91,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="18-23"
-{!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_py310.py!}
```
////
@@ -118,7 +118,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="21-47"
-{!> ../../../docs_src/schema_extra_example/tutorial004.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004.py!}
```
////
@@ -126,7 +126,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="19-45"
-{!> ../../../docs_src/schema_extra_example/tutorial004_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/security/first-steps.md b/docs/em/docs/tutorial/security/first-steps.md
index 538ea7b0a..6245f52ab 100644
--- a/docs/em/docs/tutorial/security/first-steps.md
+++ b/docs/em/docs/tutorial/security/first-steps.md
@@ -21,7 +21,7 @@
📁 🖼 📁 `main.py`:
```Python
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
## 🏃 ⚫️
@@ -129,7 +129,7 @@ Oauth2️⃣ 🔧 👈 👩💻 ⚖️ 🛠️ 💪 🔬 💽 👈 🔓 👩
🕐❔ 👥 ✍ 👐 `OAuth2PasswordBearer` 🎓 👥 🚶♀️ `tokenUrl` 🔢. 👉 🔢 🔌 📛 👈 👩💻 (🕸 🏃 👩💻 🖥) 🔜 ⚙️ 📨 `username` & `password` ✔ 🤚 🤝.
```Python hl_lines="6"
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
/// tip
@@ -169,7 +169,7 @@ oauth2_scheme(some, parameters)
🔜 👆 💪 🚶♀️ 👈 `oauth2_scheme` 🔗 ⏮️ `Depends`.
```Python hl_lines="10"
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
👉 🔗 🔜 🚚 `str` 👈 🛠️ 🔢 `token` *➡ 🛠️ 🔢*.
diff --git a/docs/em/docs/tutorial/security/get-current-user.md b/docs/em/docs/tutorial/security/get-current-user.md
index 15545f427..4e5b4ebfc 100644
--- a/docs/em/docs/tutorial/security/get-current-user.md
+++ b/docs/em/docs/tutorial/security/get-current-user.md
@@ -3,7 +3,7 @@
⏮️ 📃 💂♂ ⚙️ (❔ 🧢 🔛 🔗 💉 ⚙️) 🤝 *➡ 🛠️ 🔢* `token` `str`:
```Python hl_lines="10"
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
✋️ 👈 🚫 👈 ⚠.
@@ -19,7 +19,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="5 12-16"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -27,7 +27,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="3 10-14"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -45,7 +45,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="25"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -53,7 +53,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="23"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -65,7 +65,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="19-22 26-27"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -73,7 +73,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="17-20 24-25"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -85,7 +85,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="31"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -93,7 +93,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="29"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -153,7 +153,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="30-32"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -161,7 +161,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="28-30"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/security/oauth2-jwt.md b/docs/em/docs/tutorial/security/oauth2-jwt.md
index 3ab8cc986..95fa58f71 100644
--- a/docs/em/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/em/docs/tutorial/security/oauth2-jwt.md
@@ -121,7 +121,7 @@ $ pip install "passlib[bcrypt]"
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="7 48 55-56 59-60 69-75"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
@@ -129,7 +129,7 @@ $ pip install "passlib[bcrypt]"
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="6 47 54-55 58-59 68-74"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -171,7 +171,7 @@ $ openssl rand -hex 32
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="6 12-14 28-30 78-86"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
@@ -179,7 +179,7 @@ $ openssl rand -hex 32
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="5 11-13 27-29 77-85"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -195,7 +195,7 @@ $ openssl rand -hex 32
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="89-106"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
@@ -203,7 +203,7 @@ $ openssl rand -hex 32
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="88-105"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -217,7 +217,7 @@ $ openssl rand -hex 32
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="115-130"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
@@ -225,7 +225,7 @@ $ openssl rand -hex 32
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="114-129"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/security/simple-oauth2.md b/docs/em/docs/tutorial/security/simple-oauth2.md
index 937546be8..43d928ce7 100644
--- a/docs/em/docs/tutorial/security/simple-oauth2.md
+++ b/docs/em/docs/tutorial/security/simple-oauth2.md
@@ -55,7 +55,7 @@ Oauth2️⃣ 👫 🎻.
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="4 76"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -63,7 +63,7 @@ Oauth2️⃣ 👫 🎻.
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="2 74"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -117,7 +117,7 @@ Oauth2️⃣ 🔌 🤙 *🚚* 🏑 `grant_type` ⏮️ 🔧 💲 `password`, ✋
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="3 77-79"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -125,7 +125,7 @@ Oauth2️⃣ 🔌 🤙 *🚚* 🏑 `grant_type` ⏮️ 🔧 💲 `password`, ✋
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="1 75-77"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -157,7 +157,7 @@ Oauth2️⃣ 🔌 🤙 *🚚* 🏑 `grant_type` ⏮️ 🔧 💲 `password`, ✋
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="80-83"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -165,7 +165,7 @@ Oauth2️⃣ 🔌 🤙 *🚚* 🏑 `grant_type` ⏮️ 🔧 💲 `password`, ✋
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="78-81"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -213,7 +213,7 @@ UserInDB(
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="85"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -221,7 +221,7 @@ UserInDB(
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="83"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -253,7 +253,7 @@ UserInDB(
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="58-66 69-72 90"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -261,7 +261,7 @@ UserInDB(
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="55-64 67-70 88"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
diff --git a/docs/em/docs/tutorial/sql-databases.md b/docs/em/docs/tutorial/sql-databases.md
index 2492c8708..c59d8c131 100644
--- a/docs/em/docs/tutorial/sql-databases.md
+++ b/docs/em/docs/tutorial/sql-databases.md
@@ -110,13 +110,13 @@ $ pip install sqlalchemy
### 🗄 🇸🇲 🍕
```Python hl_lines="1-3"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
### ✍ 💽 📛 🇸🇲
```Python hl_lines="5-6"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
👉 🖼, 👥 "🔗" 🗄 💽 (📂 📁 ⏮️ 🗄 💽).
@@ -146,7 +146,7 @@ SQLALCHEMY_DATABASE_URL = "postgresql://user:password@postgresserver/db"
👥 🔜 ⏪ ⚙️ 👉 `engine` 🎏 🥉.
```Python hl_lines="8-10"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
#### 🗒
@@ -184,7 +184,7 @@ connect_args={"check_same_thread": False}
✍ `SessionLocal` 🎓, ⚙️ 🔢 `sessionmaker`:
```Python hl_lines="11"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
### ✍ `Base` 🎓
@@ -194,7 +194,7 @@ connect_args={"check_same_thread": False}
⏪ 👥 🔜 😖 ⚪️➡️ 👉 🎓 ✍ 🔠 💽 🏷 ⚖️ 🎓 (🐜 🏷):
```Python hl_lines="13"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
## ✍ 💽 🏷
@@ -220,7 +220,7 @@ connect_args={"check_same_thread": False}
👫 🎓 🇸🇲 🏷.
```Python hl_lines="4 7-8 18-19"
-{!../../../docs_src/sql_databases/sql_app/models.py!}
+{!../../docs_src/sql_databases/sql_app/models.py!}
```
`__tablename__` 🔢 💬 🇸🇲 📛 🏓 ⚙️ 💽 🔠 👫 🏷.
@@ -236,7 +236,7 @@ connect_args={"check_same_thread": False}
& 👥 🚶♀️ 🇸🇲 🎓 "🆎", `Integer`, `String`, & `Boolean`, 👈 🔬 🆎 💽, ❌.
```Python hl_lines="1 10-13 21-24"
-{!../../../docs_src/sql_databases/sql_app/models.py!}
+{!../../docs_src/sql_databases/sql_app/models.py!}
```
### ✍ 💛
@@ -248,7 +248,7 @@ connect_args={"check_same_thread": False}
👉 🔜 ▶️️, 🌅 ⚖️ 🌘, "🎱" 🔢 👈 🔜 🔌 💲 ⚪️➡️ 🎏 🏓 🔗 👉 1️⃣.
```Python hl_lines="2 15 26"
-{!../../../docs_src/sql_databases/sql_app/models.py!}
+{!../../docs_src/sql_databases/sql_app/models.py!}
```
🕐❔ 🔐 🔢 `items` `User`, `my_user.items`, ⚫️ 🔜 ✔️ 📇 `Item` 🇸🇲 🏷 (⚪️➡️ `items` 🏓) 👈 ✔️ 💱 🔑 ☝ 👉 ⏺ `users` 🏓.
@@ -284,7 +284,7 @@ connect_args={"check_same_thread": False}
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="3 6-8 11-12 23-24 27-28"
-{!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
```
////
@@ -292,7 +292,7 @@ connect_args={"check_same_thread": False}
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="3 6-8 11-12 23-24 27-28"
-{!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
```
////
@@ -300,7 +300,7 @@ connect_args={"check_same_thread": False}
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="1 4-6 9-10 21-22 25-26"
-{!> ../../../docs_src/sql_databases/sql_app_py310/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
```
////
@@ -334,7 +334,7 @@ name: str
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="15-17 31-34"
-{!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
```
////
@@ -342,7 +342,7 @@ name: str
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="15-17 31-34"
-{!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
```
////
@@ -350,7 +350,7 @@ name: str
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="13-15 29-32"
-{!> ../../../docs_src/sql_databases/sql_app_py310/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
```
////
@@ -372,7 +372,7 @@ name: str
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="15 19-20 31 36-37"
-{!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
```
////
@@ -380,7 +380,7 @@ name: str
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="15 19-20 31 36-37"
-{!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
```
////
@@ -388,7 +388,7 @@ name: str
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python hl_lines="13 17-18 29 34-35"
-{!> ../../../docs_src/sql_databases/sql_app_py310/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
```
////
@@ -466,7 +466,7 @@ current_user.items
* ✍ 💗 🏬.
```Python hl_lines="1 3 6-7 10-11 14-15 27-28"
-{!../../../docs_src/sql_databases/sql_app/crud.py!}
+{!../../docs_src/sql_databases/sql_app/crud.py!}
```
/// tip
@@ -487,7 +487,7 @@ current_user.items
* `refresh` 👆 👐 (👈 ⚫️ 🔌 🙆 🆕 📊 ⚪️➡️ 💽, 💖 🏗 🆔).
```Python hl_lines="18-24 31-36"
-{!../../../docs_src/sql_databases/sql_app/crud.py!}
+{!../../docs_src/sql_databases/sql_app/crud.py!}
```
/// tip
@@ -539,7 +539,7 @@ current_user.items
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="9"
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -547,7 +547,7 @@ current_user.items
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="7"
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -577,7 +577,7 @@ current_user.items
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="15-20"
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -585,7 +585,7 @@ current_user.items
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="13-18"
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -609,7 +609,7 @@ current_user.items
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="24 32 38 47 53"
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -617,7 +617,7 @@ current_user.items
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="22 30 36 45 51"
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -637,7 +637,7 @@ current_user.items
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="23-28 31-34 37-42 45-49 52-55"
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -645,7 +645,7 @@ current_user.items
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="21-26 29-32 35-40 43-47 50-53"
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -732,13 +732,13 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
* `sql_app/database.py`:
```Python
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
* `sql_app/models.py`:
```Python
-{!../../../docs_src/sql_databases/sql_app/models.py!}
+{!../../docs_src/sql_databases/sql_app/models.py!}
```
* `sql_app/schemas.py`:
@@ -746,7 +746,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python
-{!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
```
////
@@ -754,7 +754,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python
-{!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
```
////
@@ -762,7 +762,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python
-{!> ../../../docs_src/sql_databases/sql_app_py310/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
```
////
@@ -770,7 +770,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
* `sql_app/crud.py`:
```Python
-{!../../../docs_src/sql_databases/sql_app/crud.py!}
+{!../../docs_src/sql_databases/sql_app/crud.py!}
```
* `sql_app/main.py`:
@@ -778,7 +778,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -786,7 +786,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -843,7 +843,7 @@ $ uvicorn sql_app.main:app --reload
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python hl_lines="14-22"
-{!> ../../../docs_src/sql_databases/sql_app/alt_main.py!}
+{!> ../../docs_src/sql_databases/sql_app/alt_main.py!}
```
////
@@ -851,7 +851,7 @@ $ uvicorn sql_app.main:app --reload
//// tab | 🐍 3️⃣.9️⃣ & 🔛
```Python hl_lines="12-20"
-{!> ../../../docs_src/sql_databases/sql_app_py39/alt_main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/alt_main.py!}
```
////
diff --git a/docs/em/docs/tutorial/static-files.md b/docs/em/docs/tutorial/static-files.md
index 3305746c2..0627031b3 100644
--- a/docs/em/docs/tutorial/static-files.md
+++ b/docs/em/docs/tutorial/static-files.md
@@ -8,7 +8,7 @@
* "🗻" `StaticFiles()` 👐 🎯 ➡.
```Python hl_lines="2 6"
-{!../../../docs_src/static_files/tutorial001.py!}
+{!../../docs_src/static_files/tutorial001.py!}
```
/// note | "📡 ℹ"
diff --git a/docs/em/docs/tutorial/testing.md b/docs/em/docs/tutorial/testing.md
index 75dd2d295..5f3d5e736 100644
--- a/docs/em/docs/tutorial/testing.md
+++ b/docs/em/docs/tutorial/testing.md
@@ -27,7 +27,7 @@
✍ 🙅 `assert` 📄 ⏮️ 🐩 🐍 🧬 👈 👆 💪 ✅ (🔄, 🐩 `pytest`).
```Python hl_lines="2 12 15-18"
-{!../../../docs_src/app_testing/tutorial001.py!}
+{!../../docs_src/app_testing/tutorial001.py!}
```
/// tip
@@ -75,7 +75,7 @@
```Python
-{!../../../docs_src/app_testing/main.py!}
+{!../../docs_src/app_testing/main.py!}
```
### 🔬 📁
@@ -93,7 +93,7 @@
↩️ 👉 📁 🎏 📦, 👆 💪 ⚙️ ⚖ 🗄 🗄 🎚 `app` ⚪️➡️ `main` 🕹 (`main.py`):
```Python hl_lines="3"
-{!../../../docs_src/app_testing/test_main.py!}
+{!../../docs_src/app_testing/test_main.py!}
```
...& ✔️ 📟 💯 💖 ⏭.
@@ -125,7 +125,7 @@
//// tab | 🐍 3️⃣.6️⃣ & 🔛
```Python
-{!> ../../../docs_src/app_testing/app_b/main.py!}
+{!> ../../docs_src/app_testing/app_b/main.py!}
```
////
@@ -133,7 +133,7 @@
//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
```Python
-{!> ../../../docs_src/app_testing/app_b_py310/main.py!}
+{!> ../../docs_src/app_testing/app_b_py310/main.py!}
```
////
@@ -143,7 +143,7 @@
👆 💪 ⤴️ ℹ `test_main.py` ⏮️ ↔ 💯:
```Python
-{!> ../../../docs_src/app_testing/app_b/test_main.py!}
+{!> ../../docs_src/app_testing/app_b/test_main.py!}
```
🕐❔ 👆 💪 👩💻 🚶♀️ ℹ 📨 & 👆 🚫 💭 ❔, 👆 💪 🔎 (🇺🇸🔍) ❔ ⚫️ `httpx`, ⚖️ ❔ ⚫️ ⏮️ `requests`, 🇸🇲 🔧 ⚓️ 🔛 📨' 🔧.
diff --git a/docs/en/docs/advanced/additional-responses.md b/docs/en/docs/advanced/additional-responses.md
index 4fec41213..c038096f9 100644
--- a/docs/en/docs/advanced/additional-responses.md
+++ b/docs/en/docs/advanced/additional-responses.md
@@ -27,7 +27,7 @@ Each of those response `dict`s can have a key `model`, containing a Pydantic mod
For example, to declare another response with a status code `404` and a Pydantic model `Message`, you can write:
```Python hl_lines="18 22"
-{!../../../docs_src/additional_responses/tutorial001.py!}
+{!../../docs_src/additional_responses/tutorial001.py!}
```
/// note
@@ -178,7 +178,7 @@ You can use this same `responses` parameter to add different media types for the
For example, you can add an additional media type of `image/png`, declaring that your *path operation* can return a JSON object (with media type `application/json`) or a PNG image:
```Python hl_lines="19-24 28"
-{!../../../docs_src/additional_responses/tutorial002.py!}
+{!../../docs_src/additional_responses/tutorial002.py!}
```
/// note
@@ -208,7 +208,7 @@ For example, you can declare a response with a status code `404` that uses a Pyd
And a response with a status code `200` that uses your `response_model`, but includes a custom `example`:
```Python hl_lines="20-31"
-{!../../../docs_src/additional_responses/tutorial003.py!}
+{!../../docs_src/additional_responses/tutorial003.py!}
```
It will all be combined and included in your OpenAPI, and shown in the API docs:
@@ -244,7 +244,7 @@ You can use that technique to reuse some predefined responses in your *path oper
For example:
```Python hl_lines="13-17 26"
-{!../../../docs_src/additional_responses/tutorial004.py!}
+{!../../docs_src/additional_responses/tutorial004.py!}
```
## More information about OpenAPI responses
diff --git a/docs/en/docs/advanced/additional-status-codes.md b/docs/en/docs/advanced/additional-status-codes.md
index 99ad72b53..6105a301c 100644
--- a/docs/en/docs/advanced/additional-status-codes.md
+++ b/docs/en/docs/advanced/additional-status-codes.md
@@ -17,7 +17,7 @@ To achieve that, import `JSONResponse`, and return your content there directly,
//// tab | Python 3.10+
```Python hl_lines="4 25"
-{!> ../../../docs_src/additional_status_codes/tutorial001_an_py310.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001_an_py310.py!}
```
////
@@ -25,7 +25,7 @@ To achieve that, import `JSONResponse`, and return your content there directly,
//// tab | Python 3.9+
```Python hl_lines="4 25"
-{!> ../../../docs_src/additional_status_codes/tutorial001_an_py39.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001_an_py39.py!}
```
////
@@ -33,7 +33,7 @@ To achieve that, import `JSONResponse`, and return your content there directly,
//// tab | Python 3.8+
```Python hl_lines="4 26"
-{!> ../../../docs_src/additional_status_codes/tutorial001_an.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001_an.py!}
```
////
@@ -47,7 +47,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="2 23"
-{!> ../../../docs_src/additional_status_codes/tutorial001_py310.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001_py310.py!}
```
////
@@ -61,7 +61,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="4 25"
-{!> ../../../docs_src/additional_status_codes/tutorial001.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001.py!}
```
////
diff --git a/docs/en/docs/advanced/advanced-dependencies.md b/docs/en/docs/advanced/advanced-dependencies.md
index f65e1b180..b15a4fe3d 100644
--- a/docs/en/docs/advanced/advanced-dependencies.md
+++ b/docs/en/docs/advanced/advanced-dependencies.md
@@ -21,7 +21,7 @@ To do that, we declare a method `__call__`:
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
```
////
@@ -29,7 +29,7 @@ To do that, we declare a method `__call__`:
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial011_an.py!}
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
```
////
@@ -43,7 +43,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial011.py!}
+{!> ../../docs_src/dependencies/tutorial011.py!}
```
////
@@ -57,7 +57,7 @@ And now, we can use `__init__` to declare the parameters of the instance that we
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
```
////
@@ -65,7 +65,7 @@ And now, we can use `__init__` to declare the parameters of the instance that we
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/dependencies/tutorial011_an.py!}
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
```
////
@@ -79,7 +79,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/dependencies/tutorial011.py!}
+{!> ../../docs_src/dependencies/tutorial011.py!}
```
////
@@ -93,7 +93,7 @@ We could create an instance of this class with:
//// tab | Python 3.9+
```Python hl_lines="18"
-{!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
```
////
@@ -101,7 +101,7 @@ We could create an instance of this class with:
//// tab | Python 3.8+
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial011_an.py!}
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
```
////
@@ -115,7 +115,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial011.py!}
+{!> ../../docs_src/dependencies/tutorial011.py!}
```
////
@@ -137,7 +137,7 @@ checker(q="somequery")
//// tab | Python 3.9+
```Python hl_lines="22"
-{!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
```
////
@@ -145,7 +145,7 @@ checker(q="somequery")
//// tab | Python 3.8+
```Python hl_lines="21"
-{!> ../../../docs_src/dependencies/tutorial011_an.py!}
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
```
////
@@ -159,7 +159,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial011.py!}
+{!> ../../docs_src/dependencies/tutorial011.py!}
```
////
diff --git a/docs/en/docs/advanced/async-tests.md b/docs/en/docs/advanced/async-tests.md
index a528c80fe..232cd6e57 100644
--- a/docs/en/docs/advanced/async-tests.md
+++ b/docs/en/docs/advanced/async-tests.md
@@ -33,13 +33,13 @@ For a simple example, let's consider a file structure similar to the one describ
The file `main.py` would have:
```Python
-{!../../../docs_src/async_tests/main.py!}
+{!../../docs_src/async_tests/main.py!}
```
The file `test_main.py` would have the tests for `main.py`, it could look like this now:
```Python
-{!../../../docs_src/async_tests/test_main.py!}
+{!../../docs_src/async_tests/test_main.py!}
```
## Run it
@@ -61,7 +61,7 @@ $ pytest
The marker `@pytest.mark.anyio` tells pytest that this test function should be called asynchronously:
```Python hl_lines="7"
-{!../../../docs_src/async_tests/test_main.py!}
+{!../../docs_src/async_tests/test_main.py!}
```
/// tip
@@ -73,7 +73,7 @@ Note that the test function is now `async def` instead of just `def` as before w
Then we can create an `AsyncClient` with the app, and send async requests to it, using `await`.
```Python hl_lines="9-12"
-{!../../../docs_src/async_tests/test_main.py!}
+{!../../docs_src/async_tests/test_main.py!}
```
This is the equivalent to:
diff --git a/docs/en/docs/advanced/behind-a-proxy.md b/docs/en/docs/advanced/behind-a-proxy.md
index e642b1910..67718a27b 100644
--- a/docs/en/docs/advanced/behind-a-proxy.md
+++ b/docs/en/docs/advanced/behind-a-proxy.md
@@ -19,7 +19,7 @@ In this case, the original path `/app` would actually be served at `/api/v1/app`
Even though all your code is written assuming there's just `/app`.
```Python hl_lines="6"
-{!../../../docs_src/behind_a_proxy/tutorial001.py!}
+{!../../docs_src/behind_a_proxy/tutorial001.py!}
```
And the proxy would be **"stripping"** the **path prefix** on the fly before transmitting the request to the app server (probably Uvicorn via FastAPI CLI), keeping your application convinced that it is being served at `/app`, so that you don't have to update all your code to include the prefix `/api/v1`.
@@ -99,7 +99,7 @@ You can get the current `root_path` used by your application for each request, i
Here we are including it in the message just for demonstration purposes.
```Python hl_lines="8"
-{!../../../docs_src/behind_a_proxy/tutorial001.py!}
+{!../../docs_src/behind_a_proxy/tutorial001.py!}
```
Then, if you start Uvicorn with:
@@ -128,7 +128,7 @@ The response would be something like:
Alternatively, if you don't have a way to provide a command line option like `--root-path` or equivalent, you can set the `root_path` parameter when creating your FastAPI app:
```Python hl_lines="3"
-{!../../../docs_src/behind_a_proxy/tutorial002.py!}
+{!../../docs_src/behind_a_proxy/tutorial002.py!}
```
Passing the `root_path` to `FastAPI` would be the equivalent of passing the `--root-path` command line option to Uvicorn or Hypercorn.
@@ -310,7 +310,7 @@ If you pass a custom list of `servers` and there's a `root_path` (because your A
For example:
```Python hl_lines="4-7"
-{!../../../docs_src/behind_a_proxy/tutorial003.py!}
+{!../../docs_src/behind_a_proxy/tutorial003.py!}
```
Will generate an OpenAPI schema like:
@@ -359,7 +359,7 @@ The docs UI will interact with the server that you select.
If you don't want **FastAPI** to include an automatic server using the `root_path`, you can use the parameter `root_path_in_servers=False`:
```Python hl_lines="9"
-{!../../../docs_src/behind_a_proxy/tutorial004.py!}
+{!../../docs_src/behind_a_proxy/tutorial004.py!}
```
and then it won't include it in the OpenAPI schema.
diff --git a/docs/en/docs/advanced/custom-response.md b/docs/en/docs/advanced/custom-response.md
index 1cefe979f..1d6dc3f6d 100644
--- a/docs/en/docs/advanced/custom-response.md
+++ b/docs/en/docs/advanced/custom-response.md
@@ -31,7 +31,7 @@ This is because by default, FastAPI will inspect every item inside and make sure
But if you are certain that the content that you are returning is **serializable with JSON**, you can pass it directly to the response class and avoid the extra overhead that FastAPI would have by passing your return content through the `jsonable_encoder` before passing it to the response class.
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial001b.py!}
+{!../../docs_src/custom_response/tutorial001b.py!}
```
/// info
@@ -58,7 +58,7 @@ To return a response with HTML directly from **FastAPI**, use `HTMLResponse`.
* Pass `HTMLResponse` as the parameter `response_class` of your *path operation decorator*.
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial002.py!}
+{!../../docs_src/custom_response/tutorial002.py!}
```
/// info
@@ -78,7 +78,7 @@ As seen in [Return a Response directly](response-directly.md){.internal-link tar
The same example from above, returning an `HTMLResponse`, could look like:
```Python hl_lines="2 7 19"
-{!../../../docs_src/custom_response/tutorial003.py!}
+{!../../docs_src/custom_response/tutorial003.py!}
```
/// warning
@@ -104,7 +104,7 @@ The `response_class` will then be used only to document the OpenAPI *path operat
For example, it could be something like:
```Python hl_lines="7 21 23"
-{!../../../docs_src/custom_response/tutorial004.py!}
+{!../../docs_src/custom_response/tutorial004.py!}
```
In this example, the function `generate_html_response()` already generates and returns a `Response` instead of returning the HTML in a `str`.
@@ -145,7 +145,7 @@ It accepts the following parameters:
FastAPI (actually Starlette) will automatically include a Content-Length header. It will also include a Content-Type header, based on the `media_type` and appending a charset for text types.
```Python hl_lines="1 18"
-{!../../../docs_src/response_directly/tutorial002.py!}
+{!../../docs_src/response_directly/tutorial002.py!}
```
### `HTMLResponse`
@@ -157,7 +157,7 @@ Takes some text or bytes and returns an HTML response, as you read above.
Takes some text or bytes and returns a plain text response.
```Python hl_lines="2 7 9"
-{!../../../docs_src/custom_response/tutorial005.py!}
+{!../../docs_src/custom_response/tutorial005.py!}
```
### `JSONResponse`
@@ -193,7 +193,7 @@ This requires installing `ujson` for example with `pip install ujson`.
///
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial001.py!}
+{!../../docs_src/custom_response/tutorial001.py!}
```
/// tip
@@ -209,7 +209,7 @@ Returns an HTTP redirect. Uses a 307 status code (Temporary Redirect) by default
You can return a `RedirectResponse` directly:
```Python hl_lines="2 9"
-{!../../../docs_src/custom_response/tutorial006.py!}
+{!../../docs_src/custom_response/tutorial006.py!}
```
---
@@ -218,7 +218,7 @@ Or you can use it in the `response_class` parameter:
```Python hl_lines="2 7 9"
-{!../../../docs_src/custom_response/tutorial006b.py!}
+{!../../docs_src/custom_response/tutorial006b.py!}
```
If you do that, then you can return the URL directly from your *path operation* function.
@@ -230,7 +230,7 @@ In this case, the `status_code` used will be the default one for the `RedirectRe
You can also use the `status_code` parameter combined with the `response_class` parameter:
```Python hl_lines="2 7 9"
-{!../../../docs_src/custom_response/tutorial006c.py!}
+{!../../docs_src/custom_response/tutorial006c.py!}
```
### `StreamingResponse`
@@ -238,7 +238,7 @@ You can also use the `status_code` parameter combined with the `response_class`
Takes an async generator or a normal generator/iterator and streams the response body.
```Python hl_lines="2 14"
-{!../../../docs_src/custom_response/tutorial007.py!}
+{!../../docs_src/custom_response/tutorial007.py!}
```
#### Using `StreamingResponse` with file-like objects
@@ -250,7 +250,7 @@ That way, you don't have to read it all first in memory, and you can pass that g
This includes many libraries to interact with cloud storage, video processing, and others.
```{ .python .annotate hl_lines="2 10-12 14" }
-{!../../../docs_src/custom_response/tutorial008.py!}
+{!../../docs_src/custom_response/tutorial008.py!}
```
1. This is the generator function. It's a "generator function" because it contains `yield` statements inside.
@@ -281,13 +281,13 @@ Takes a different set of arguments to instantiate than the other response types:
File responses will include appropriate `Content-Length`, `Last-Modified` and `ETag` headers.
```Python hl_lines="2 10"
-{!../../../docs_src/custom_response/tutorial009.py!}
+{!../../docs_src/custom_response/tutorial009.py!}
```
You can also use the `response_class` parameter:
```Python hl_lines="2 8 10"
-{!../../../docs_src/custom_response/tutorial009b.py!}
+{!../../docs_src/custom_response/tutorial009b.py!}
```
In this case, you can return the file path directly from your *path operation* function.
@@ -303,7 +303,7 @@ Let's say you want it to return indented and formatted JSON, so you want to use
You could create a `CustomORJSONResponse`. The main thing you have to do is create a `Response.render(content)` method that returns the content as `bytes`:
```Python hl_lines="9-14 17"
-{!../../../docs_src/custom_response/tutorial009c.py!}
+{!../../docs_src/custom_response/tutorial009c.py!}
```
Now instead of returning:
@@ -331,7 +331,7 @@ The parameter that defines this is `default_response_class`.
In the example below, **FastAPI** will use `ORJSONResponse` by default, in all *path operations*, instead of `JSONResponse`.
```Python hl_lines="2 4"
-{!../../../docs_src/custom_response/tutorial010.py!}
+{!../../docs_src/custom_response/tutorial010.py!}
```
/// tip
diff --git a/docs/en/docs/advanced/dataclasses.md b/docs/en/docs/advanced/dataclasses.md
index 252ab6fa5..efc07eab2 100644
--- a/docs/en/docs/advanced/dataclasses.md
+++ b/docs/en/docs/advanced/dataclasses.md
@@ -5,7 +5,7 @@ FastAPI is built on top of **Pydantic**, and I have been showing you how to use
But FastAPI also supports using <a href="https://docs.python.org/3/library/dataclasses.html" class="external-link" target="_blank">`dataclasses`</a> the same way:
```Python hl_lines="1 7-12 19-20"
-{!../../../docs_src/dataclasses/tutorial001.py!}
+{!../../docs_src/dataclasses/tutorial001.py!}
```
This is still supported thanks to **Pydantic**, as it has <a href="https://docs.pydantic.dev/latest/concepts/dataclasses/#use-of-stdlib-dataclasses-with-basemodel" class="external-link" target="_blank">internal support for `dataclasses`</a>.
@@ -35,7 +35,7 @@ But if you have a bunch of dataclasses laying around, this is a nice trick to us
You can also use `dataclasses` in the `response_model` parameter:
```Python hl_lines="1 7-13 19"
-{!../../../docs_src/dataclasses/tutorial002.py!}
+{!../../docs_src/dataclasses/tutorial002.py!}
```
The dataclass will be automatically converted to a Pydantic dataclass.
@@ -53,7 +53,7 @@ In some cases, you might still have to use Pydantic's version of `dataclasses`.
In that case, you can simply swap the standard `dataclasses` with `pydantic.dataclasses`, which is a drop-in replacement:
```{ .python .annotate hl_lines="1 5 8-11 14-17 23-25 28" }
-{!../../../docs_src/dataclasses/tutorial003.py!}
+{!../../docs_src/dataclasses/tutorial003.py!}
```
1. We still import `field` from standard `dataclasses`.
diff --git a/docs/en/docs/advanced/events.md b/docs/en/docs/advanced/events.md
index 7fd934344..efce492f4 100644
--- a/docs/en/docs/advanced/events.md
+++ b/docs/en/docs/advanced/events.md
@@ -31,7 +31,7 @@ Let's start with an example and then see it in detail.
We create an async function `lifespan()` with `yield` like this:
```Python hl_lines="16 19"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
Here we are simulating the expensive *startup* operation of loading the model by putting the (fake) model function in the dictionary with machine learning models before the `yield`. This code will be executed **before** the application **starts taking requests**, during the *startup*.
@@ -51,7 +51,7 @@ Maybe you need to start a new version, or you just got tired of running it. 🤷
The first thing to notice, is that we are defining an async function with `yield`. This is very similar to Dependencies with `yield`.
```Python hl_lines="14-19"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
The first part of the function, before the `yield`, will be executed **before** the application starts.
@@ -65,7 +65,7 @@ If you check, the function is decorated with an `@asynccontextmanager`.
That converts the function into something called an "**async context manager**".
```Python hl_lines="1 13"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
A **context manager** in Python is something that you can use in a `with` statement, for example, `open()` can be used as a context manager:
@@ -89,7 +89,7 @@ In our code example above, we don't use it directly, but we pass it to FastAPI f
The `lifespan` parameter of the `FastAPI` app takes an **async context manager**, so we can pass our new `lifespan` async context manager to it.
```Python hl_lines="22"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
## Alternative Events (deprecated)
@@ -113,7 +113,7 @@ These functions can be declared with `async def` or normal `def`.
To add a function that should be run before the application starts, declare it with the event `"startup"`:
```Python hl_lines="8"
-{!../../../docs_src/events/tutorial001.py!}
+{!../../docs_src/events/tutorial001.py!}
```
In this case, the `startup` event handler function will initialize the items "database" (just a `dict`) with some values.
@@ -127,7 +127,7 @@ And your application won't start receiving requests until all the `startup` even
To add a function that should be run when the application is shutting down, declare it with the event `"shutdown"`:
```Python hl_lines="6"
-{!../../../docs_src/events/tutorial002.py!}
+{!../../docs_src/events/tutorial002.py!}
```
Here, the `shutdown` event handler function will write a text line `"Application shutdown"` to a file `log.txt`.
diff --git a/docs/en/docs/advanced/generate-clients.md b/docs/en/docs/advanced/generate-clients.md
index faa7c323f..7872103c3 100644
--- a/docs/en/docs/advanced/generate-clients.md
+++ b/docs/en/docs/advanced/generate-clients.md
@@ -35,7 +35,7 @@ Let's start with a simple FastAPI application:
//// tab | Python 3.9+
```Python hl_lines="7-9 12-13 16-17 21"
-{!> ../../../docs_src/generate_clients/tutorial001_py39.py!}
+{!> ../../docs_src/generate_clients/tutorial001_py39.py!}
```
////
@@ -43,7 +43,7 @@ Let's start with a simple FastAPI application:
//// tab | Python 3.8+
```Python hl_lines="9-11 14-15 18 19 23"
-{!> ../../../docs_src/generate_clients/tutorial001.py!}
+{!> ../../docs_src/generate_clients/tutorial001.py!}
```
////
@@ -154,7 +154,7 @@ For example, you could have a section for **items** and another section for **us
//// tab | Python 3.9+
```Python hl_lines="21 26 34"
-{!> ../../../docs_src/generate_clients/tutorial002_py39.py!}
+{!> ../../docs_src/generate_clients/tutorial002_py39.py!}
```
////
@@ -162,7 +162,7 @@ For example, you could have a section for **items** and another section for **us
//// tab | Python 3.8+
```Python hl_lines="23 28 36"
-{!> ../../../docs_src/generate_clients/tutorial002.py!}
+{!> ../../docs_src/generate_clients/tutorial002.py!}
```
////
@@ -215,7 +215,7 @@ You can then pass that custom function to **FastAPI** as the `generate_unique_id
//// tab | Python 3.9+
```Python hl_lines="6-7 10"
-{!> ../../../docs_src/generate_clients/tutorial003_py39.py!}
+{!> ../../docs_src/generate_clients/tutorial003_py39.py!}
```
////
@@ -223,7 +223,7 @@ You can then pass that custom function to **FastAPI** as the `generate_unique_id
//// tab | Python 3.8+
```Python hl_lines="8-9 12"
-{!> ../../../docs_src/generate_clients/tutorial003.py!}
+{!> ../../docs_src/generate_clients/tutorial003.py!}
```
////
@@ -251,7 +251,7 @@ We could download the OpenAPI JSON to a file `openapi.json` and then we could **
//// tab | Python
```Python
-{!> ../../../docs_src/generate_clients/tutorial004.py!}
+{!> ../../docs_src/generate_clients/tutorial004.py!}
```
////
@@ -259,7 +259,7 @@ We could download the OpenAPI JSON to a file `openapi.json` and then we could **
//// tab | Node.js
```Javascript
-{!> ../../../docs_src/generate_clients/tutorial004.js!}
+{!> ../../docs_src/generate_clients/tutorial004.js!}
```
////
diff --git a/docs/en/docs/advanced/middleware.md b/docs/en/docs/advanced/middleware.md
index ab7778db0..07deac716 100644
--- a/docs/en/docs/advanced/middleware.md
+++ b/docs/en/docs/advanced/middleware.md
@@ -58,7 +58,7 @@ Enforces that all incoming requests must either be `https` or `wss`.
Any incoming request to `http` or `ws` will be redirected to the secure scheme instead.
```Python hl_lines="2 6"
-{!../../../docs_src/advanced_middleware/tutorial001.py!}
+{!../../docs_src/advanced_middleware/tutorial001.py!}
```
## `TrustedHostMiddleware`
@@ -66,7 +66,7 @@ Any incoming request to `http` or `ws` will be redirected to the secure scheme i
Enforces that all incoming requests have a correctly set `Host` header, in order to guard against HTTP Host Header attacks.
```Python hl_lines="2 6-8"
-{!../../../docs_src/advanced_middleware/tutorial002.py!}
+{!../../docs_src/advanced_middleware/tutorial002.py!}
```
The following arguments are supported:
@@ -82,7 +82,7 @@ Handles GZip responses for any request that includes `"gzip"` in the `Accept-Enc
The middleware will handle both standard and streaming responses.
```Python hl_lines="2 6"
-{!../../../docs_src/advanced_middleware/tutorial003.py!}
+{!../../docs_src/advanced_middleware/tutorial003.py!}
```
The following arguments are supported:
diff --git a/docs/en/docs/advanced/openapi-callbacks.md b/docs/en/docs/advanced/openapi-callbacks.md
index 7fead2ed9..82069a950 100644
--- a/docs/en/docs/advanced/openapi-callbacks.md
+++ b/docs/en/docs/advanced/openapi-callbacks.md
@@ -32,7 +32,7 @@ It will have a *path operation* that will receive an `Invoice` body, and a query
This part is pretty normal, most of the code is probably already familiar to you:
```Python hl_lines="9-13 36-53"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
/// tip
@@ -93,7 +93,7 @@ Temporarily adopting this point of view (of the *external developer*) can help y
First create a new `APIRouter` that will contain one or more callbacks.
```Python hl_lines="3 25"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
### Create the callback *path operation*
@@ -106,7 +106,7 @@ It should look just like a normal FastAPI *path operation*:
* And it could also have a declaration of the response it should return, e.g. `response_model=InvoiceEventReceived`.
```Python hl_lines="16-18 21-22 28-32"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
There are 2 main differences from a normal *path operation*:
@@ -176,7 +176,7 @@ At this point you have the *callback path operation(s)* needed (the one(s) that
Now use the parameter `callbacks` in *your API's path operation decorator* to pass the attribute `.routes` (that's actually just a `list` of routes/*path operations*) from that callback router:
```Python hl_lines="35"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
/// tip
diff --git a/docs/en/docs/advanced/openapi-webhooks.md b/docs/en/docs/advanced/openapi-webhooks.md
index 5ee321e2a..eaaa48a37 100644
--- a/docs/en/docs/advanced/openapi-webhooks.md
+++ b/docs/en/docs/advanced/openapi-webhooks.md
@@ -33,7 +33,7 @@ Webhooks are available in OpenAPI 3.1.0 and above, supported by FastAPI `0.99.0`
When you create a **FastAPI** application, there is a `webhooks` attribute that you can use to define *webhooks*, the same way you would define *path operations*, for example with `@app.webhooks.post()`.
```Python hl_lines="9-13 36-53"
-{!../../../docs_src/openapi_webhooks/tutorial001.py!}
+{!../../docs_src/openapi_webhooks/tutorial001.py!}
```
The webhooks that you define will end up in the **OpenAPI** schema and the automatic **docs UI**.
diff --git a/docs/en/docs/advanced/path-operation-advanced-configuration.md b/docs/en/docs/advanced/path-operation-advanced-configuration.md
index d599006d2..a61e3f19b 100644
--- a/docs/en/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/en/docs/advanced/path-operation-advanced-configuration.md
@@ -13,7 +13,7 @@ You can set the OpenAPI `operationId` to be used in your *path operation* with t
You would have to make sure that it is unique for each operation.
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
```
### Using the *path operation function* name as the operationId
@@ -23,7 +23,7 @@ If you want to use your APIs' function names as `operationId`s, you can iterate
You should do it after adding all your *path operations*.
```Python hl_lines="2 12-21 24"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
```
/// tip
@@ -45,7 +45,7 @@ Even if they are in different modules (Python files).
To exclude a *path operation* from the generated OpenAPI schema (and thus, from the automatic documentation systems), use the parameter `include_in_schema` and set it to `False`:
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
```
## Advanced description from docstring
@@ -57,7 +57,7 @@ Adding an `\f` (an escaped "form feed" character) causes **FastAPI** to truncate
It won't show up in the documentation, but other tools (such as Sphinx) will be able to use the rest.
```Python hl_lines="19-29"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
```
## Additional Responses
@@ -101,7 +101,7 @@ You can extend the OpenAPI schema for a *path operation* using the parameter `op
This `openapi_extra` can be helpful, for example, to declare [OpenAPI Extensions](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#specificationExtensions):
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial005.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial005.py!}
```
If you open the automatic API docs, your extension will show up at the bottom of the specific *path operation*.
@@ -150,7 +150,7 @@ For example, you could decide to read and validate the request with your own cod
You could do that with `openapi_extra`:
```Python hl_lines="19-36 39-40"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial006.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial006.py!}
```
In this example, we didn't declare any Pydantic model. In fact, the request body is not even <abbr title="converted from some plain format, like bytes, into Python objects">parsed</abbr> as JSON, it is read directly as `bytes`, and the function `magic_data_reader()` would be in charge of parsing it in some way.
@@ -168,7 +168,7 @@ For example, in this application we don't use FastAPI's integrated functionality
//// tab | Pydantic v2
```Python hl_lines="17-22 24"
-{!> ../../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
+{!> ../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
```
////
@@ -176,7 +176,7 @@ For example, in this application we don't use FastAPI's integrated functionality
//// tab | Pydantic v1
```Python hl_lines="17-22 24"
-{!> ../../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py!}
+{!> ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py!}
```
////
@@ -196,7 +196,7 @@ And then in our code, we parse that YAML content directly, and then we are again
//// tab | Pydantic v2
```Python hl_lines="26-33"
-{!> ../../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
+{!> ../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
```
////
@@ -204,7 +204,7 @@ And then in our code, we parse that YAML content directly, and then we are again
//// tab | Pydantic v1
```Python hl_lines="26-33"
-{!> ../../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py!}
+{!> ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py!}
```
////
diff --git a/docs/en/docs/advanced/response-change-status-code.md b/docs/en/docs/advanced/response-change-status-code.md
index b88d74a8a..fc041f7de 100644
--- a/docs/en/docs/advanced/response-change-status-code.md
+++ b/docs/en/docs/advanced/response-change-status-code.md
@@ -21,7 +21,7 @@ You can declare a parameter of type `Response` in your *path operation function*
And then you can set the `status_code` in that *temporal* response object.
```Python hl_lines="1 9 12"
-{!../../../docs_src/response_change_status_code/tutorial001.py!}
+{!../../docs_src/response_change_status_code/tutorial001.py!}
```
And then you can return any object you need, as you normally would (a `dict`, a database model, etc).
diff --git a/docs/en/docs/advanced/response-cookies.md b/docs/en/docs/advanced/response-cookies.md
index 85e423f42..4467779ba 100644
--- a/docs/en/docs/advanced/response-cookies.md
+++ b/docs/en/docs/advanced/response-cookies.md
@@ -7,7 +7,7 @@ You can declare a parameter of type `Response` in your *path operation function*
And then you can set cookies in that *temporal* response object.
```Python hl_lines="1 8-9"
-{!../../../docs_src/response_cookies/tutorial002.py!}
+{!../../docs_src/response_cookies/tutorial002.py!}
```
And then you can return any object you need, as you normally would (a `dict`, a database model, etc).
@@ -27,7 +27,7 @@ To do that, you can create a response as described in [Return a Response Directl
Then set Cookies in it, and then return it:
```Python hl_lines="10-12"
-{!../../../docs_src/response_cookies/tutorial001.py!}
+{!../../docs_src/response_cookies/tutorial001.py!}
```
/// tip
diff --git a/docs/en/docs/advanced/response-directly.md b/docs/en/docs/advanced/response-directly.md
index 092aeceb1..8246b9674 100644
--- a/docs/en/docs/advanced/response-directly.md
+++ b/docs/en/docs/advanced/response-directly.md
@@ -35,7 +35,7 @@ For example, you cannot put a Pydantic model in a `JSONResponse` without first c
For those cases, you can use the `jsonable_encoder` to convert your data before passing it to a response:
```Python hl_lines="6-7 21-22"
-{!../../../docs_src/response_directly/tutorial001.py!}
+{!../../docs_src/response_directly/tutorial001.py!}
```
/// note | "Technical Details"
@@ -57,7 +57,7 @@ Let's say that you want to return an <a href="https://en.wikipedia.org/wiki/XML"
You could put your XML content in a string, put that in a `Response`, and return it:
```Python hl_lines="1 18"
-{!../../../docs_src/response_directly/tutorial002.py!}
+{!../../docs_src/response_directly/tutorial002.py!}
```
## Notes
diff --git a/docs/en/docs/advanced/response-headers.md b/docs/en/docs/advanced/response-headers.md
index acbb6d7e5..80c100826 100644
--- a/docs/en/docs/advanced/response-headers.md
+++ b/docs/en/docs/advanced/response-headers.md
@@ -7,7 +7,7 @@ You can declare a parameter of type `Response` in your *path operation function*
And then you can set headers in that *temporal* response object.
```Python hl_lines="1 7-8"
-{!../../../docs_src/response_headers/tutorial002.py!}
+{!../../docs_src/response_headers/tutorial002.py!}
```
And then you can return any object you need, as you normally would (a `dict`, a database model, etc).
@@ -25,7 +25,7 @@ You can also add headers when you return a `Response` directly.
Create a response as described in [Return a Response Directly](response-directly.md){.internal-link target=_blank} and pass the headers as an additional parameter:
```Python hl_lines="10-12"
-{!../../../docs_src/response_headers/tutorial001.py!}
+{!../../docs_src/response_headers/tutorial001.py!}
```
/// note | "Technical Details"
diff --git a/docs/en/docs/advanced/security/http-basic-auth.md b/docs/en/docs/advanced/security/http-basic-auth.md
index e669d10d8..fa652c52b 100644
--- a/docs/en/docs/advanced/security/http-basic-auth.md
+++ b/docs/en/docs/advanced/security/http-basic-auth.md
@@ -23,7 +23,7 @@ Then, when you type that username and password, the browser sends them in the he
//// tab | Python 3.9+
```Python hl_lines="4 8 12"
-{!> ../../../docs_src/security/tutorial006_an_py39.py!}
+{!> ../../docs_src/security/tutorial006_an_py39.py!}
```
////
@@ -31,7 +31,7 @@ Then, when you type that username and password, the browser sends them in the he
//// tab | Python 3.8+
```Python hl_lines="2 7 11"
-{!> ../../../docs_src/security/tutorial006_an.py!}
+{!> ../../docs_src/security/tutorial006_an.py!}
```
////
@@ -45,7 +45,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="2 6 10"
-{!> ../../../docs_src/security/tutorial006.py!}
+{!> ../../docs_src/security/tutorial006.py!}
```
////
@@ -71,7 +71,7 @@ Then we can use `secrets.compare_digest()` to ensure that `credentials.username`
//// tab | Python 3.9+
```Python hl_lines="1 12-24"
-{!> ../../../docs_src/security/tutorial007_an_py39.py!}
+{!> ../../docs_src/security/tutorial007_an_py39.py!}
```
////
@@ -79,7 +79,7 @@ Then we can use `secrets.compare_digest()` to ensure that `credentials.username`
//// tab | Python 3.8+
```Python hl_lines="1 12-24"
-{!> ../../../docs_src/security/tutorial007_an.py!}
+{!> ../../docs_src/security/tutorial007_an.py!}
```
////
@@ -93,7 +93,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1 11-21"
-{!> ../../../docs_src/security/tutorial007.py!}
+{!> ../../docs_src/security/tutorial007.py!}
```
////
@@ -163,7 +163,7 @@ After detecting that the credentials are incorrect, return an `HTTPException` wi
//// tab | Python 3.9+
```Python hl_lines="26-30"
-{!> ../../../docs_src/security/tutorial007_an_py39.py!}
+{!> ../../docs_src/security/tutorial007_an_py39.py!}
```
////
@@ -171,7 +171,7 @@ After detecting that the credentials are incorrect, return an `HTTPException` wi
//// tab | Python 3.8+
```Python hl_lines="26-30"
-{!> ../../../docs_src/security/tutorial007_an.py!}
+{!> ../../docs_src/security/tutorial007_an.py!}
```
////
@@ -185,7 +185,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="23-27"
-{!> ../../../docs_src/security/tutorial007.py!}
+{!> ../../docs_src/security/tutorial007.py!}
```
////
diff --git a/docs/en/docs/advanced/security/oauth2-scopes.md b/docs/en/docs/advanced/security/oauth2-scopes.md
index fdd8db7b9..3db284d02 100644
--- a/docs/en/docs/advanced/security/oauth2-scopes.md
+++ b/docs/en/docs/advanced/security/oauth2-scopes.md
@@ -65,7 +65,7 @@ First, let's quickly see the parts that change from the examples in the main **T
//// tab | Python 3.10+
```Python hl_lines="5 9 13 47 65 106 108-116 122-125 129-135 140 156"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -73,7 +73,7 @@ First, let's quickly see the parts that change from the examples in the main **T
//// tab | Python 3.9+
```Python hl_lines="2 5 9 13 47 65 106 108-116 122-125 129-135 140 156"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -81,7 +81,7 @@ First, let's quickly see the parts that change from the examples in the main **T
//// tab | Python 3.8+
```Python hl_lines="2 5 9 13 48 66 107 109-117 123-126 130-136 141 157"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -95,7 +95,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="4 8 12 46 64 105 107-115 121-124 128-134 139 155"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -109,7 +109,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="2 5 9 13 47 65 106 108-116 122-125 129-135 140 156"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -123,7 +123,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="2 5 9 13 47 65 106 108-116 122-125 129-135 140 156"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -139,7 +139,7 @@ The `scopes` parameter receives a `dict` with each scope as a key and the descri
//// tab | Python 3.10+
```Python hl_lines="63-66"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -147,7 +147,7 @@ The `scopes` parameter receives a `dict` with each scope as a key and the descri
//// tab | Python 3.9+
```Python hl_lines="63-66"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -155,7 +155,7 @@ The `scopes` parameter receives a `dict` with each scope as a key and the descri
//// tab | Python 3.8+
```Python hl_lines="64-67"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -169,7 +169,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="62-65"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -183,7 +183,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="63-66"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -197,7 +197,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="63-66"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -229,7 +229,7 @@ But in your application, for security, you should make sure you only add the sco
//// tab | Python 3.10+
```Python hl_lines="156"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -237,7 +237,7 @@ But in your application, for security, you should make sure you only add the sco
//// tab | Python 3.9+
```Python hl_lines="156"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -245,7 +245,7 @@ But in your application, for security, you should make sure you only add the sco
//// tab | Python 3.8+
```Python hl_lines="157"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -259,7 +259,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="155"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -273,7 +273,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="156"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -287,7 +287,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="156"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -319,7 +319,7 @@ We are doing it here to demonstrate how **FastAPI** handles scopes declared at d
//// tab | Python 3.10+
```Python hl_lines="5 140 171"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -327,7 +327,7 @@ We are doing it here to demonstrate how **FastAPI** handles scopes declared at d
//// tab | Python 3.9+
```Python hl_lines="5 140 171"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -335,7 +335,7 @@ We are doing it here to demonstrate how **FastAPI** handles scopes declared at d
//// tab | Python 3.8+
```Python hl_lines="5 141 172"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -349,7 +349,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="4 139 168"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -363,7 +363,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="5 140 169"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -377,7 +377,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="5 140 169"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -409,7 +409,7 @@ This `SecurityScopes` class is similar to `Request` (`Request` was used to get t
//// tab | Python 3.10+
```Python hl_lines="9 106"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -417,7 +417,7 @@ This `SecurityScopes` class is similar to `Request` (`Request` was used to get t
//// tab | Python 3.9+
```Python hl_lines="9 106"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -425,7 +425,7 @@ This `SecurityScopes` class is similar to `Request` (`Request` was used to get t
//// tab | Python 3.8+
```Python hl_lines="9 107"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -439,7 +439,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8 105"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -453,7 +453,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9 106"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -467,7 +467,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9 106"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -487,7 +487,7 @@ In this exception, we include the scopes required (if any) as a string separated
//// tab | Python 3.10+
```Python hl_lines="106 108-116"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -495,7 +495,7 @@ In this exception, we include the scopes required (if any) as a string separated
//// tab | Python 3.9+
```Python hl_lines="106 108-116"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -503,7 +503,7 @@ In this exception, we include the scopes required (if any) as a string separated
//// tab | Python 3.8+
```Python hl_lines="107 109-117"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -517,7 +517,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="105 107-115"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -531,7 +531,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="106 108-116"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -545,7 +545,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="106 108-116"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -567,7 +567,7 @@ We also verify that we have a user with that username, and if not, we raise that
//// tab | Python 3.10+
```Python hl_lines="47 117-128"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -575,7 +575,7 @@ We also verify that we have a user with that username, and if not, we raise that
//// tab | Python 3.9+
```Python hl_lines="47 117-128"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -583,7 +583,7 @@ We also verify that we have a user with that username, and if not, we raise that
//// tab | Python 3.8+
```Python hl_lines="48 118-129"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -597,7 +597,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="46 116-127"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -611,7 +611,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="47 117-128"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -625,7 +625,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="47 117-128"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -639,7 +639,7 @@ For this, we use `security_scopes.scopes`, that contains a `list` with all these
//// tab | Python 3.10+
```Python hl_lines="129-135"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -647,7 +647,7 @@ For this, we use `security_scopes.scopes`, that contains a `list` with all these
//// tab | Python 3.9+
```Python hl_lines="129-135"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -655,7 +655,7 @@ For this, we use `security_scopes.scopes`, that contains a `list` with all these
//// tab | Python 3.8+
```Python hl_lines="130-136"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -669,7 +669,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="128-134"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -683,7 +683,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="129-135"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -697,7 +697,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="129-135"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
diff --git a/docs/en/docs/advanced/settings.md b/docs/en/docs/advanced/settings.md
index 8c04d2507..01810c438 100644
--- a/docs/en/docs/advanced/settings.md
+++ b/docs/en/docs/advanced/settings.md
@@ -63,7 +63,7 @@ You can use all the same validation features and tools you use for Pydantic mode
//// tab | Pydantic v2
```Python hl_lines="2 5-8 11"
-{!> ../../../docs_src/settings/tutorial001.py!}
+{!> ../../docs_src/settings/tutorial001.py!}
```
////
@@ -77,7 +77,7 @@ In Pydantic v1 you would import `BaseSettings` directly from `pydantic` instead
///
```Python hl_lines="2 5-8 11"
-{!> ../../../docs_src/settings/tutorial001_pv1.py!}
+{!> ../../docs_src/settings/tutorial001_pv1.py!}
```
////
@@ -97,7 +97,7 @@ Next it will convert and validate the data. So, when you use that `settings` obj
Then you can use the new `settings` object in your application:
```Python hl_lines="18-20"
-{!../../../docs_src/settings/tutorial001.py!}
+{!../../docs_src/settings/tutorial001.py!}
```
### Run the server
@@ -133,13 +133,13 @@ You could put those settings in another module file as you saw in [Bigger Applic
For example, you could have a file `config.py` with:
```Python
-{!../../../docs_src/settings/app01/config.py!}
+{!../../docs_src/settings/app01/config.py!}
```
And then use it in a file `main.py`:
```Python hl_lines="3 11-13"
-{!../../../docs_src/settings/app01/main.py!}
+{!../../docs_src/settings/app01/main.py!}
```
/// tip
@@ -159,7 +159,7 @@ This could be especially useful during testing, as it's very easy to override a
Coming from the previous example, your `config.py` file could look like:
```Python hl_lines="10"
-{!../../../docs_src/settings/app02/config.py!}
+{!../../docs_src/settings/app02/config.py!}
```
Notice that now we don't create a default instance `settings = Settings()`.
@@ -171,7 +171,7 @@ Now we create a dependency that returns a new `config.Settings()`.
//// tab | Python 3.9+
```Python hl_lines="6 12-13"
-{!> ../../../docs_src/settings/app02_an_py39/main.py!}
+{!> ../../docs_src/settings/app02_an_py39/main.py!}
```
////
@@ -179,7 +179,7 @@ Now we create a dependency that returns a new `config.Settings()`.
//// tab | Python 3.8+
```Python hl_lines="6 12-13"
-{!> ../../../docs_src/settings/app02_an/main.py!}
+{!> ../../docs_src/settings/app02_an/main.py!}
```
////
@@ -193,7 +193,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="5 11-12"
-{!> ../../../docs_src/settings/app02/main.py!}
+{!> ../../docs_src/settings/app02/main.py!}
```
////
@@ -211,7 +211,7 @@ And then we can require it from the *path operation function* as a dependency an
//// tab | Python 3.9+
```Python hl_lines="17 19-21"
-{!> ../../../docs_src/settings/app02_an_py39/main.py!}
+{!> ../../docs_src/settings/app02_an_py39/main.py!}
```
////
@@ -219,7 +219,7 @@ And then we can require it from the *path operation function* as a dependency an
//// tab | Python 3.8+
```Python hl_lines="17 19-21"
-{!> ../../../docs_src/settings/app02_an/main.py!}
+{!> ../../docs_src/settings/app02_an/main.py!}
```
////
@@ -233,7 +233,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="16 18-20"
-{!> ../../../docs_src/settings/app02/main.py!}
+{!> ../../docs_src/settings/app02/main.py!}
```
////
@@ -243,7 +243,7 @@ Prefer to use the `Annotated` version if possible.
Then it would be very easy to provide a different settings object during testing by creating a dependency override for `get_settings`:
```Python hl_lines="9-10 13 21"
-{!../../../docs_src/settings/app02/test_main.py!}
+{!../../docs_src/settings/app02/test_main.py!}
```
In the dependency override we set a new value for the `admin_email` when creating the new `Settings` object, and then we return that new object.
@@ -288,7 +288,7 @@ And then update your `config.py` with:
//// tab | Pydantic v2
```Python hl_lines="9"
-{!> ../../../docs_src/settings/app03_an/config.py!}
+{!> ../../docs_src/settings/app03_an/config.py!}
```
/// tip
@@ -302,7 +302,7 @@ The `model_config` attribute is used just for Pydantic configuration. You can re
//// tab | Pydantic v1
```Python hl_lines="9-10"
-{!> ../../../docs_src/settings/app03_an/config_pv1.py!}
+{!> ../../docs_src/settings/app03_an/config_pv1.py!}
```
/// tip
@@ -347,7 +347,7 @@ But as we are using the `@lru_cache` decorator on top, the `Settings` object wil
//// tab | Python 3.9+
```Python hl_lines="1 11"
-{!> ../../../docs_src/settings/app03_an_py39/main.py!}
+{!> ../../docs_src/settings/app03_an_py39/main.py!}
```
////
@@ -355,7 +355,7 @@ But as we are using the `@lru_cache` decorator on top, the `Settings` object wil
//// tab | Python 3.8+
```Python hl_lines="1 11"
-{!> ../../../docs_src/settings/app03_an/main.py!}
+{!> ../../docs_src/settings/app03_an/main.py!}
```
////
@@ -369,7 +369,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1 10"
-{!> ../../../docs_src/settings/app03/main.py!}
+{!> ../../docs_src/settings/app03/main.py!}
```
////
diff --git a/docs/en/docs/advanced/sub-applications.md b/docs/en/docs/advanced/sub-applications.md
index 568a9deca..befa9908a 100644
--- a/docs/en/docs/advanced/sub-applications.md
+++ b/docs/en/docs/advanced/sub-applications.md
@@ -11,7 +11,7 @@ If you need to have two independent FastAPI applications, with their own indepen
First, create the main, top-level, **FastAPI** application, and its *path operations*:
```Python hl_lines="3 6-8"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### Sub-application
@@ -21,7 +21,7 @@ Then, create your sub-application, and its *path operations*.
This sub-application is just another standard FastAPI application, but this is the one that will be "mounted":
```Python hl_lines="11 14-16"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### Mount the sub-application
@@ -31,7 +31,7 @@ In your top-level application, `app`, mount the sub-application, `subapi`.
In this case, it will be mounted at the path `/subapi`:
```Python hl_lines="11 19"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### Check the automatic API docs
diff --git a/docs/en/docs/advanced/templates.md b/docs/en/docs/advanced/templates.md
index 416540ba4..d688c5cb7 100644
--- a/docs/en/docs/advanced/templates.md
+++ b/docs/en/docs/advanced/templates.md
@@ -28,7 +28,7 @@ $ pip install jinja2
* Use the `templates` you created to render and return a `TemplateResponse`, pass the name of the template, the request object, and a "context" dictionary with key-value pairs to be used inside of the Jinja2 template.
```Python hl_lines="4 11 15-18"
-{!../../../docs_src/templates/tutorial001.py!}
+{!../../docs_src/templates/tutorial001.py!}
```
/// note
@@ -58,7 +58,7 @@ You could also use `from starlette.templating import Jinja2Templates`.
Then you can write a template at `templates/item.html` with, for example:
```jinja hl_lines="7"
-{!../../../docs_src/templates/templates/item.html!}
+{!../../docs_src/templates/templates/item.html!}
```
### Template Context Values
@@ -112,13 +112,13 @@ For example, with an ID of `42`, this would render:
You can also use `url_for()` inside of the template, and use it, for example, with the `StaticFiles` you mounted with the `name="static"`.
```jinja hl_lines="4"
-{!../../../docs_src/templates/templates/item.html!}
+{!../../docs_src/templates/templates/item.html!}
```
In this example, it would link to a CSS file at `static/styles.css` with:
```CSS hl_lines="4"
-{!../../../docs_src/templates/static/styles.css!}
+{!../../docs_src/templates/static/styles.css!}
```
And because you are using `StaticFiles`, that CSS file would be served automatically by your **FastAPI** application at the URL `/static/styles.css`.
diff --git a/docs/en/docs/advanced/testing-database.md b/docs/en/docs/advanced/testing-database.md
index 974cf4caa..2b704f229 100644
--- a/docs/en/docs/advanced/testing-database.md
+++ b/docs/en/docs/advanced/testing-database.md
@@ -59,7 +59,7 @@ We'll use an in-memory database that persists during the tests instead of the lo
But the rest of the session code is more or less the same, we just copy it.
```Python hl_lines="8-13"
-{!../../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
+{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
```
/// tip
@@ -83,7 +83,7 @@ That is normally called in `main.py`, but the line in `main.py` uses the databas
So we add that line here, with the new file.
```Python hl_lines="16"
-{!../../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
+{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
```
## Dependency override
@@ -91,7 +91,7 @@ So we add that line here, with the new file.
Now we create the dependency override and add it to the overrides for our app.
```Python hl_lines="19-24 27"
-{!../../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
+{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
```
/// tip
@@ -105,7 +105,7 @@ The code for `override_get_db()` is almost exactly the same as for `get_db()`, b
Then we can just test the app as normally.
```Python hl_lines="32-47"
-{!../../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
+{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
```
And all the modifications we made in the database during the tests will be in the `test.db` database instead of the main `sql_app.db`.
diff --git a/docs/en/docs/advanced/testing-dependencies.md b/docs/en/docs/advanced/testing-dependencies.md
index 92e25f88d..1cc4313a1 100644
--- a/docs/en/docs/advanced/testing-dependencies.md
+++ b/docs/en/docs/advanced/testing-dependencies.md
@@ -31,7 +31,7 @@ And then **FastAPI** will call that override instead of the original dependency.
//// tab | Python 3.10+
```Python hl_lines="26-27 30"
-{!> ../../../docs_src/dependency_testing/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependency_testing/tutorial001_an_py310.py!}
```
////
@@ -39,7 +39,7 @@ And then **FastAPI** will call that override instead of the original dependency.
//// tab | Python 3.9+
```Python hl_lines="28-29 32"
-{!> ../../../docs_src/dependency_testing/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependency_testing/tutorial001_an_py39.py!}
```
////
@@ -47,7 +47,7 @@ And then **FastAPI** will call that override instead of the original dependency.
//// tab | Python 3.8+
```Python hl_lines="29-30 33"
-{!> ../../../docs_src/dependency_testing/tutorial001_an.py!}
+{!> ../../docs_src/dependency_testing/tutorial001_an.py!}
```
////
@@ -61,7 +61,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="24-25 28"
-{!> ../../../docs_src/dependency_testing/tutorial001_py310.py!}
+{!> ../../docs_src/dependency_testing/tutorial001_py310.py!}
```
////
@@ -75,7 +75,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="28-29 32"
-{!> ../../../docs_src/dependency_testing/tutorial001.py!}
+{!> ../../docs_src/dependency_testing/tutorial001.py!}
```
////
diff --git a/docs/en/docs/advanced/testing-events.md b/docs/en/docs/advanced/testing-events.md
index b24a2ccfe..f48907c7c 100644
--- a/docs/en/docs/advanced/testing-events.md
+++ b/docs/en/docs/advanced/testing-events.md
@@ -3,5 +3,5 @@
When you need your event handlers (`startup` and `shutdown`) to run in your tests, you can use the `TestClient` with a `with` statement:
```Python hl_lines="9-12 20-24"
-{!../../../docs_src/app_testing/tutorial003.py!}
+{!../../docs_src/app_testing/tutorial003.py!}
```
diff --git a/docs/en/docs/advanced/testing-websockets.md b/docs/en/docs/advanced/testing-websockets.md
index 6c071bc19..ab08c90fe 100644
--- a/docs/en/docs/advanced/testing-websockets.md
+++ b/docs/en/docs/advanced/testing-websockets.md
@@ -5,7 +5,7 @@ You can use the same `TestClient` to test WebSockets.
For this, you use the `TestClient` in a `with` statement, connecting to the WebSocket:
```Python hl_lines="27-31"
-{!../../../docs_src/app_testing/tutorial002.py!}
+{!../../docs_src/app_testing/tutorial002.py!}
```
/// note
diff --git a/docs/en/docs/advanced/using-request-directly.md b/docs/en/docs/advanced/using-request-directly.md
index 5473db5cb..917d77a95 100644
--- a/docs/en/docs/advanced/using-request-directly.md
+++ b/docs/en/docs/advanced/using-request-directly.md
@@ -30,7 +30,7 @@ Let's imagine you want to get the client's IP address/host inside of your *path
For that you need to access the request directly.
```Python hl_lines="1 7-8"
-{!../../../docs_src/using_request_directly/tutorial001.py!}
+{!../../docs_src/using_request_directly/tutorial001.py!}
```
By declaring a *path operation function* parameter with the type being the `Request` **FastAPI** will know to pass the `Request` in that parameter.
diff --git a/docs/en/docs/advanced/websockets.md b/docs/en/docs/advanced/websockets.md
index 44c6c7428..8947f32e7 100644
--- a/docs/en/docs/advanced/websockets.md
+++ b/docs/en/docs/advanced/websockets.md
@@ -39,7 +39,7 @@ In production you would have one of the options above.
But it's the simplest way to focus on the server-side of WebSockets and have a working example:
```Python hl_lines="2 6-38 41-43"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
## Create a `websocket`
@@ -47,7 +47,7 @@ But it's the simplest way to focus on the server-side of WebSockets and have a w
In your **FastAPI** application, create a `websocket`:
```Python hl_lines="1 46-47"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
/// note | "Technical Details"
@@ -63,7 +63,7 @@ You could also use `from starlette.websockets import WebSocket`.
In your WebSocket route you can `await` for messages and send messages.
```Python hl_lines="48-52"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
You can receive and send binary, text, and JSON data.
@@ -118,7 +118,7 @@ They work the same way as for other FastAPI endpoints/*path operations*:
//// tab | Python 3.10+
```Python hl_lines="68-69 82"
-{!> ../../../docs_src/websockets/tutorial002_an_py310.py!}
+{!> ../../docs_src/websockets/tutorial002_an_py310.py!}
```
////
@@ -126,7 +126,7 @@ They work the same way as for other FastAPI endpoints/*path operations*:
//// tab | Python 3.9+
```Python hl_lines="68-69 82"
-{!> ../../../docs_src/websockets/tutorial002_an_py39.py!}
+{!> ../../docs_src/websockets/tutorial002_an_py39.py!}
```
////
@@ -134,7 +134,7 @@ They work the same way as for other FastAPI endpoints/*path operations*:
//// tab | Python 3.8+
```Python hl_lines="69-70 83"
-{!> ../../../docs_src/websockets/tutorial002_an.py!}
+{!> ../../docs_src/websockets/tutorial002_an.py!}
```
////
@@ -148,7 +148,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="66-67 79"
-{!> ../../../docs_src/websockets/tutorial002_py310.py!}
+{!> ../../docs_src/websockets/tutorial002_py310.py!}
```
////
@@ -162,7 +162,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="68-69 81"
-{!> ../../../docs_src/websockets/tutorial002.py!}
+{!> ../../docs_src/websockets/tutorial002.py!}
```
////
@@ -213,7 +213,7 @@ When a WebSocket connection is closed, the `await websocket.receive_text()` will
//// tab | Python 3.9+
```Python hl_lines="79-81"
-{!> ../../../docs_src/websockets/tutorial003_py39.py!}
+{!> ../../docs_src/websockets/tutorial003_py39.py!}
```
////
@@ -221,7 +221,7 @@ When a WebSocket connection is closed, the `await websocket.receive_text()` will
//// tab | Python 3.8+
```Python hl_lines="81-83"
-{!> ../../../docs_src/websockets/tutorial003.py!}
+{!> ../../docs_src/websockets/tutorial003.py!}
```
////
diff --git a/docs/en/docs/advanced/wsgi.md b/docs/en/docs/advanced/wsgi.md
index f07609ed6..3974d491c 100644
--- a/docs/en/docs/advanced/wsgi.md
+++ b/docs/en/docs/advanced/wsgi.md
@@ -13,7 +13,7 @@ Then wrap the WSGI (e.g. Flask) app with the middleware.
And then mount that under a path.
```Python hl_lines="2-3 23"
-{!../../../docs_src/wsgi/tutorial001.py!}
+{!../../docs_src/wsgi/tutorial001.py!}
```
## Check it
diff --git a/docs/en/docs/how-to/async-sql-encode-databases.md b/docs/en/docs/how-to/async-sql-encode-databases.md
index a75f8ef58..a72316c4d 100644
--- a/docs/en/docs/how-to/async-sql-encode-databases.md
+++ b/docs/en/docs/how-to/async-sql-encode-databases.md
@@ -43,7 +43,7 @@ This section doesn't apply those ideas, to be equivalent to the counterpart in <
* Create a table `notes` using the `metadata` object.
```Python hl_lines="4 14 16-22"
-{!../../../docs_src/async_sql_databases/tutorial001.py!}
+{!../../docs_src/async_sql_databases/tutorial001.py!}
```
/// tip
@@ -61,7 +61,7 @@ Notice that all this code is pure SQLAlchemy Core.
* Create a `database` object.
```Python hl_lines="3 9 12"
-{!../../../docs_src/async_sql_databases/tutorial001.py!}
+{!../../docs_src/async_sql_databases/tutorial001.py!}
```
/// tip
@@ -80,7 +80,7 @@ Here, this section would run directly, right before starting your **FastAPI** ap
* Create all the tables from the `metadata` object.
```Python hl_lines="25-28"
-{!../../../docs_src/async_sql_databases/tutorial001.py!}
+{!../../docs_src/async_sql_databases/tutorial001.py!}
```
## Create models
@@ -91,7 +91,7 @@ Create Pydantic models for:
* Notes to be returned (`Note`).
```Python hl_lines="31-33 36-39"
-{!../../../docs_src/async_sql_databases/tutorial001.py!}
+{!../../docs_src/async_sql_databases/tutorial001.py!}
```
By creating these Pydantic models, the input data will be validated, serialized (converted), and annotated (documented).
@@ -104,7 +104,7 @@ So, you will be able to see it all in the interactive API docs.
* Create event handlers to connect and disconnect from the database.
```Python hl_lines="42 45-47 50-52"
-{!../../../docs_src/async_sql_databases/tutorial001.py!}
+{!../../docs_src/async_sql_databases/tutorial001.py!}
```
## Read notes
@@ -112,7 +112,7 @@ So, you will be able to see it all in the interactive API docs.
Create the *path operation function* to read notes:
```Python hl_lines="55-58"
-{!../../../docs_src/async_sql_databases/tutorial001.py!}
+{!../../docs_src/async_sql_databases/tutorial001.py!}
```
/// note
@@ -132,7 +132,7 @@ That documents (and validates, serializes, filters) the output data, as a `list`
Create the *path operation function* to create notes:
```Python hl_lines="61-65"
-{!../../../docs_src/async_sql_databases/tutorial001.py!}
+{!../../docs_src/async_sql_databases/tutorial001.py!}
```
/// info
diff --git a/docs/en/docs/how-to/conditional-openapi.md b/docs/en/docs/how-to/conditional-openapi.md
index add16fbec..6cd0385a2 100644
--- a/docs/en/docs/how-to/conditional-openapi.md
+++ b/docs/en/docs/how-to/conditional-openapi.md
@@ -30,7 +30,7 @@ You can easily use the same Pydantic settings to configure your generated OpenAP
For example:
```Python hl_lines="6 11"
-{!../../../docs_src/conditional_openapi/tutorial001.py!}
+{!../../docs_src/conditional_openapi/tutorial001.py!}
```
Here we declare the setting `openapi_url` with the same default of `"/openapi.json"`.
diff --git a/docs/en/docs/how-to/configure-swagger-ui.md b/docs/en/docs/how-to/configure-swagger-ui.md
index 040c3926b..2c649c152 100644
--- a/docs/en/docs/how-to/configure-swagger-ui.md
+++ b/docs/en/docs/how-to/configure-swagger-ui.md
@@ -19,7 +19,7 @@ Without changing the settings, syntax highlighting is enabled by default:
But you can disable it by setting `syntaxHighlight` to `False`:
```Python hl_lines="3"
-{!../../../docs_src/configure_swagger_ui/tutorial001.py!}
+{!../../docs_src/configure_swagger_ui/tutorial001.py!}
```
...and then Swagger UI won't show the syntax highlighting anymore:
@@ -31,7 +31,7 @@ But you can disable it by setting `syntaxHighlight` to `False`:
The same way you could set the syntax highlighting theme with the key `"syntaxHighlight.theme"` (notice that it has a dot in the middle):
```Python hl_lines="3"
-{!../../../docs_src/configure_swagger_ui/tutorial002.py!}
+{!../../docs_src/configure_swagger_ui/tutorial002.py!}
```
That configuration would change the syntax highlighting color theme:
@@ -45,7 +45,7 @@ FastAPI includes some default configuration parameters appropriate for most of t
It includes these default configurations:
```Python
-{!../../../fastapi/openapi/docs.py[ln:7-23]!}
+{!../../fastapi/openapi/docs.py[ln:7-23]!}
```
You can override any of them by setting a different value in the argument `swagger_ui_parameters`.
@@ -53,7 +53,7 @@ You can override any of them by setting a different value in the argument `swagg
For example, to disable `deepLinking` you could pass these settings to `swagger_ui_parameters`:
```Python hl_lines="3"
-{!../../../docs_src/configure_swagger_ui/tutorial003.py!}
+{!../../docs_src/configure_swagger_ui/tutorial003.py!}
```
## Other Swagger UI Parameters
diff --git a/docs/en/docs/how-to/custom-docs-ui-assets.md b/docs/en/docs/how-to/custom-docs-ui-assets.md
index 0c766d3e4..16c873d11 100644
--- a/docs/en/docs/how-to/custom-docs-ui-assets.md
+++ b/docs/en/docs/how-to/custom-docs-ui-assets.md
@@ -19,7 +19,7 @@ The first step is to disable the automatic docs, as by default, those use the de
To disable them, set their URLs to `None` when creating your `FastAPI` app:
```Python hl_lines="8"
-{!../../../docs_src/custom_docs_ui/tutorial001.py!}
+{!../../docs_src/custom_docs_ui/tutorial001.py!}
```
### Include the custom docs
@@ -37,7 +37,7 @@ You can reuse FastAPI's internal functions to create the HTML pages for the docs
And similarly for ReDoc...
```Python hl_lines="2-6 11-19 22-24 27-33"
-{!../../../docs_src/custom_docs_ui/tutorial001.py!}
+{!../../docs_src/custom_docs_ui/tutorial001.py!}
```
/// tip
@@ -55,7 +55,7 @@ Swagger UI will handle it behind the scenes for you, but it needs this "redirect
Now, to be able to test that everything works, create a *path operation*:
```Python hl_lines="36-38"
-{!../../../docs_src/custom_docs_ui/tutorial001.py!}
+{!../../docs_src/custom_docs_ui/tutorial001.py!}
```
### Test it
@@ -125,7 +125,7 @@ After that, your file structure could look like:
* "Mount" a `StaticFiles()` instance in a specific path.
```Python hl_lines="7 11"
-{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+{!../../docs_src/custom_docs_ui/tutorial002.py!}
```
### Test the static files
@@ -159,7 +159,7 @@ The same as when using a custom CDN, the first step is to disable the automatic
To disable them, set their URLs to `None` when creating your `FastAPI` app:
```Python hl_lines="9"
-{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+{!../../docs_src/custom_docs_ui/tutorial002.py!}
```
### Include the custom docs for static files
@@ -177,7 +177,7 @@ Again, you can reuse FastAPI's internal functions to create the HTML pages for t
And similarly for ReDoc...
```Python hl_lines="2-6 14-22 25-27 30-36"
-{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+{!../../docs_src/custom_docs_ui/tutorial002.py!}
```
/// tip
@@ -195,7 +195,7 @@ Swagger UI will handle it behind the scenes for you, but it needs this "redirect
Now, to be able to test that everything works, create a *path operation*:
```Python hl_lines="39-41"
-{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+{!../../docs_src/custom_docs_ui/tutorial002.py!}
```
### Test Static Files UI
diff --git a/docs/en/docs/how-to/custom-request-and-route.md b/docs/en/docs/how-to/custom-request-and-route.md
index 20e1904f1..a62ebf1d5 100644
--- a/docs/en/docs/how-to/custom-request-and-route.md
+++ b/docs/en/docs/how-to/custom-request-and-route.md
@@ -43,7 +43,7 @@ If there's no `gzip` in the header, it will not try to decompress the body.
That way, the same route class can handle gzip compressed or uncompressed requests.
```Python hl_lines="8-15"
-{!../../../docs_src/custom_request_and_route/tutorial001.py!}
+{!../../docs_src/custom_request_and_route/tutorial001.py!}
```
### Create a custom `GzipRoute` class
@@ -57,7 +57,7 @@ This method returns a function. And that function is what will receive a request
Here we use it to create a `GzipRequest` from the original request.
```Python hl_lines="18-26"
-{!../../../docs_src/custom_request_and_route/tutorial001.py!}
+{!../../docs_src/custom_request_and_route/tutorial001.py!}
```
/// note | "Technical Details"
@@ -97,13 +97,13 @@ We can also use this same approach to access the request body in an exception ha
All we need to do is handle the request inside a `try`/`except` block:
```Python hl_lines="13 15"
-{!../../../docs_src/custom_request_and_route/tutorial002.py!}
+{!../../docs_src/custom_request_and_route/tutorial002.py!}
```
If an exception occurs, the`Request` instance will still be in scope, so we can read and make use of the request body when handling the error:
```Python hl_lines="16-18"
-{!../../../docs_src/custom_request_and_route/tutorial002.py!}
+{!../../docs_src/custom_request_and_route/tutorial002.py!}
```
## Custom `APIRoute` class in a router
@@ -111,11 +111,11 @@ If an exception occurs, the`Request` instance will still be in scope, so we can
You can also set the `route_class` parameter of an `APIRouter`:
```Python hl_lines="26"
-{!../../../docs_src/custom_request_and_route/tutorial003.py!}
+{!../../docs_src/custom_request_and_route/tutorial003.py!}
```
In this example, the *path operations* under the `router` will use the custom `TimedRoute` class, and will have an extra `X-Response-Time` header in the response with the time it took to generate the response:
```Python hl_lines="13-20"
-{!../../../docs_src/custom_request_and_route/tutorial003.py!}
+{!../../docs_src/custom_request_and_route/tutorial003.py!}
```
diff --git a/docs/en/docs/how-to/extending-openapi.md b/docs/en/docs/how-to/extending-openapi.md
index 9909f778c..2b0367952 100644
--- a/docs/en/docs/how-to/extending-openapi.md
+++ b/docs/en/docs/how-to/extending-openapi.md
@@ -44,7 +44,7 @@ For example, let's add <a href="https://github.com/Rebilly/ReDoc/blob/master/doc
First, write all your **FastAPI** application as normally:
```Python hl_lines="1 4 7-9"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### Generate the OpenAPI schema
@@ -52,7 +52,7 @@ First, write all your **FastAPI** application as normally:
Then, use the same utility function to generate the OpenAPI schema, inside a `custom_openapi()` function:
```Python hl_lines="2 15-21"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### Modify the OpenAPI schema
@@ -60,7 +60,7 @@ Then, use the same utility function to generate the OpenAPI schema, inside a `cu
Now you can add the ReDoc extension, adding a custom `x-logo` to the `info` "object" in the OpenAPI schema:
```Python hl_lines="22-24"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### Cache the OpenAPI schema
@@ -72,7 +72,7 @@ That way, your application won't have to generate the schema every time a user o
It will be generated only once, and then the same cached schema will be used for the next requests.
```Python hl_lines="13-14 25-26"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### Override the method
@@ -80,7 +80,7 @@ It will be generated only once, and then the same cached schema will be used for
Now you can replace the `.openapi()` method with your new function.
```Python hl_lines="29"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
+{!../../docs_src/extending_openapi/tutorial001.py!}
```
### Check it
diff --git a/docs/en/docs/how-to/graphql.md b/docs/en/docs/how-to/graphql.md
index d4b7cfdaa..2a4377d16 100644
--- a/docs/en/docs/how-to/graphql.md
+++ b/docs/en/docs/how-to/graphql.md
@@ -36,7 +36,7 @@ Depending on your use case, you might prefer to use a different library, but if
Here's a small preview of how you could integrate Strawberry with FastAPI:
```Python hl_lines="3 22 25-26"
-{!../../../docs_src/graphql/tutorial001.py!}
+{!../../docs_src/graphql/tutorial001.py!}
```
You can learn more about Strawberry in the <a href="https://strawberry.rocks/" class="external-link" target="_blank">Strawberry documentation</a>.
diff --git a/docs/en/docs/how-to/nosql-databases-couchbase.md b/docs/en/docs/how-to/nosql-databases-couchbase.md
index a0abfe21d..feb4025dd 100644
--- a/docs/en/docs/how-to/nosql-databases-couchbase.md
+++ b/docs/en/docs/how-to/nosql-databases-couchbase.md
@@ -39,7 +39,7 @@ There is an official project generator with **FastAPI** and **Couchbase**, all b
For now, don't pay attention to the rest, only the imports:
```Python hl_lines="3-5"
-{!../../../docs_src/nosql_databases/tutorial001.py!}
+{!../../docs_src/nosql_databases/tutorial001.py!}
```
## Define a constant to use as a "document type"
@@ -49,7 +49,7 @@ We will use it later as a fixed field `type` in our documents.
This is not required by Couchbase, but is a good practice that will help you afterwards.
```Python hl_lines="9"
-{!../../../docs_src/nosql_databases/tutorial001.py!}
+{!../../docs_src/nosql_databases/tutorial001.py!}
```
## Add a function to get a `Bucket`
@@ -74,7 +74,7 @@ This utility function will:
* Return it.
```Python hl_lines="12-21"
-{!../../../docs_src/nosql_databases/tutorial001.py!}
+{!../../docs_src/nosql_databases/tutorial001.py!}
```
## Create Pydantic models
@@ -86,7 +86,7 @@ As **Couchbase** "documents" are actually just "JSON objects", we can model them
First, let's create a `User` model:
```Python hl_lines="24-28"
-{!../../../docs_src/nosql_databases/tutorial001.py!}
+{!../../docs_src/nosql_databases/tutorial001.py!}
```
We will use this model in our *path operation function*, so, we don't include in it the `hashed_password`.
@@ -100,7 +100,7 @@ This will have the data that is actually stored in the database.
We don't create it as a subclass of Pydantic's `BaseModel` but as a subclass of our own `User`, because it will have all the attributes in `User` plus a couple more:
```Python hl_lines="31-33"
-{!../../../docs_src/nosql_databases/tutorial001.py!}
+{!../../docs_src/nosql_databases/tutorial001.py!}
```
/// note
@@ -123,7 +123,7 @@ Now create a function that will:
By creating a function that is only dedicated to getting your user from a `username` (or any other parameter) independent of your *path operation function*, you can more easily reuse it in multiple parts and also add <abbr title="Automated test, written in code, that checks if another piece of code is working correctly.">unit tests</abbr> for it:
```Python hl_lines="36-42"
-{!../../../docs_src/nosql_databases/tutorial001.py!}
+{!../../docs_src/nosql_databases/tutorial001.py!}
```
### f-strings
@@ -158,7 +158,7 @@ UserInDB(username="johndoe", hashed_password="some_hash")
### Create the `FastAPI` app
```Python hl_lines="46"
-{!../../../docs_src/nosql_databases/tutorial001.py!}
+{!../../docs_src/nosql_databases/tutorial001.py!}
```
### Create the *path operation function*
@@ -168,7 +168,7 @@ As our code is calling Couchbase and we are not using the <a href="https://docs.
Also, Couchbase recommends not using a single `Bucket` object in multiple "<abbr title="A sequence of code being executed by the program, while at the same time, or at intervals, there can be others being executed too.">thread</abbr>s", so, we can just get the bucket directly and pass it to our utility functions:
```Python hl_lines="49-53"
-{!../../../docs_src/nosql_databases/tutorial001.py!}
+{!../../docs_src/nosql_databases/tutorial001.py!}
```
## Recap
diff --git a/docs/en/docs/how-to/separate-openapi-schemas.md b/docs/en/docs/how-to/separate-openapi-schemas.md
index 0ab5b1337..75fd3f9b6 100644
--- a/docs/en/docs/how-to/separate-openapi-schemas.md
+++ b/docs/en/docs/how-to/separate-openapi-schemas.md
@@ -13,7 +13,7 @@ Let's say you have a Pydantic model with default values, like this one:
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-7]!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-7]!}
# Code below omitted 👇
```
@@ -22,7 +22,7 @@ Let's say you have a Pydantic model with default values, like this one:
<summary>👀 Full file preview</summary>
```Python
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
```
</details>
@@ -32,7 +32,7 @@ Let's say you have a Pydantic model with default values, like this one:
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-9]!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-9]!}
# Code below omitted 👇
```
@@ -41,7 +41,7 @@ Let's say you have a Pydantic model with default values, like this one:
<summary>👀 Full file preview</summary>
```Python
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
```
</details>
@@ -51,7 +51,7 @@ Let's say you have a Pydantic model with default values, like this one:
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-9]!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-9]!}
# Code below omitted 👇
```
@@ -60,7 +60,7 @@ Let's say you have a Pydantic model with default values, like this one:
<summary>👀 Full file preview</summary>
```Python
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py!}
```
</details>
@@ -74,7 +74,7 @@ If you use this model as an input like here:
//// tab | Python 3.10+
```Python hl_lines="14"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-15]!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-15]!}
# Code below omitted 👇
```
@@ -83,7 +83,7 @@ If you use this model as an input like here:
<summary>👀 Full file preview</summary>
```Python
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
```
</details>
@@ -93,7 +93,7 @@ If you use this model as an input like here:
//// tab | Python 3.9+
```Python hl_lines="16"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-17]!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-17]!}
# Code below omitted 👇
```
@@ -102,7 +102,7 @@ If you use this model as an input like here:
<summary>👀 Full file preview</summary>
```Python
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
```
</details>
@@ -112,7 +112,7 @@ If you use this model as an input like here:
//// tab | Python 3.8+
```Python hl_lines="16"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-17]!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-17]!}
# Code below omitted 👇
```
@@ -121,7 +121,7 @@ If you use this model as an input like here:
<summary>👀 Full file preview</summary>
```Python
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py!}
```
</details>
@@ -145,7 +145,7 @@ But if you use the same model as an output, like here:
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
```
////
@@ -153,7 +153,7 @@ But if you use the same model as an output, like here:
//// tab | Python 3.9+
```Python hl_lines="21"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
```
////
@@ -161,7 +161,7 @@ But if you use the same model as an output, like here:
//// tab | Python 3.8+
```Python hl_lines="21"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial001.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py!}
```
////
@@ -226,7 +226,7 @@ Support for `separate_input_output_schemas` was added in FastAPI `0.102.0`. 🤓
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial002_py310.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial002_py310.py!}
```
////
@@ -234,7 +234,7 @@ Support for `separate_input_output_schemas` was added in FastAPI `0.102.0`. 🤓
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial002_py39.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial002_py39.py!}
```
////
@@ -242,7 +242,7 @@ Support for `separate_input_output_schemas` was added in FastAPI `0.102.0`. 🤓
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/separate_openapi_schemas/tutorial002.py!}
+{!> ../../docs_src/separate_openapi_schemas/tutorial002.py!}
```
////
diff --git a/docs/en/docs/how-to/sql-databases-peewee.md b/docs/en/docs/how-to/sql-databases-peewee.md
index e411c200c..e73ca369b 100644
--- a/docs/en/docs/how-to/sql-databases-peewee.md
+++ b/docs/en/docs/how-to/sql-databases-peewee.md
@@ -89,7 +89,7 @@ Let's refer to the file `sql_app/database.py`.
Let's first check all the normal Peewee code, create a Peewee database:
```Python hl_lines="3 5 22"
-{!../../../docs_src/sql_databases_peewee/sql_app/database.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
```
/// tip
@@ -149,7 +149,7 @@ This might seem a bit complex (and it actually is), you don't really need to com
We will create a `PeeweeConnectionState`:
```Python hl_lines="10-19"
-{!../../../docs_src/sql_databases_peewee/sql_app/database.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
```
This class inherits from a special internal class used by Peewee.
@@ -173,7 +173,7 @@ But it doesn't give Peewee async super-powers. You should still use normal `def`
Now, overwrite the `._state` internal attribute in the Peewee database `db` object using the new `PeeweeConnectionState`:
```Python hl_lines="24"
-{!../../../docs_src/sql_databases_peewee/sql_app/database.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
```
/// tip
@@ -209,7 +209,7 @@ But Pydantic also uses the term "**model**" to refer to something different, the
Import `db` from `database` (the file `database.py` from above) and use it here.
```Python hl_lines="3 6-12 15-21"
-{!../../../docs_src/sql_databases_peewee/sql_app/models.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/models.py!}
```
/// tip
@@ -243,7 +243,7 @@ So this will help us avoiding confusion while using both.
Create all the same Pydantic models as in the SQLAlchemy tutorial:
```Python hl_lines="16-18 21-22 25-30 34-35 38-39 42-48"
-{!../../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
```
/// tip
@@ -271,7 +271,7 @@ But recent versions of Pydantic allow providing a custom class that inherits fro
We are going to create a custom `PeeweeGetterDict` class and use it in all the same Pydantic *models* / schemas that use `orm_mode`:
```Python hl_lines="3 8-13 31 49"
-{!../../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
```
Here we are checking if the attribute that is being accessed (e.g. `.items` in `some_user.items`) is an instance of `peewee.ModelSelect`.
@@ -295,7 +295,7 @@ Now let's see the file `sql_app/crud.py`.
Create all the same CRUD utils as in the SQLAlchemy tutorial, all the code is very similar:
```Python hl_lines="1 4-5 8-9 12-13 16-20 23-24 27-30"
-{!../../../docs_src/sql_databases_peewee/sql_app/crud.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/crud.py!}
```
There are some differences with the code for the SQLAlchemy tutorial.
@@ -319,7 +319,7 @@ And now in the file `sql_app/main.py` let's integrate and use all the other part
In a very simplistic way create the database tables:
```Python hl_lines="9-11"
-{!../../../docs_src/sql_databases_peewee/sql_app/main.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
```
### Create a dependency
@@ -327,7 +327,7 @@ In a very simplistic way create the database tables:
Create a dependency that will connect the database right at the beginning of a request and disconnect it at the end:
```Python hl_lines="23-29"
-{!../../../docs_src/sql_databases_peewee/sql_app/main.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
```
Here we have an empty `yield` because we are actually not using the database object directly.
@@ -341,7 +341,7 @@ And then, in each *path operation function* that needs to access the database we
But we are not using the value given by this dependency (it actually doesn't give any value, as it has an empty `yield`). So, we don't add it to the *path operation function* but to the *path operation decorator* in the `dependencies` parameter:
```Python hl_lines="32 40 47 59 65 72"
-{!../../../docs_src/sql_databases_peewee/sql_app/main.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
```
### Context variable sub-dependency
@@ -351,7 +351,7 @@ For all the `contextvars` parts to work, we need to make sure we have an indepen
For that, we need to create another `async` dependency `reset_db_state()` that is used as a sub-dependency in `get_db()`. It will set the value for the context variable (with just a default `dict`) that will be used as the database state for the whole request. And then the dependency `get_db()` will store in it the database state (connection, transactions, etc).
```Python hl_lines="18-20"
-{!../../../docs_src/sql_databases_peewee/sql_app/main.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
```
For the **next request**, as we will reset that context variable again in the `async` dependency `reset_db_state()` and then create a new connection in the `get_db()` dependency, that new request will have its own database state (connection, transactions, etc).
@@ -383,7 +383,7 @@ async def reset_db_state():
Now, finally, here's the standard **FastAPI** *path operations* code.
```Python hl_lines="32-37 40-43 46-53 56-62 65-68 71-79"
-{!../../../docs_src/sql_databases_peewee/sql_app/main.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
```
### About `def` vs `async def`
@@ -500,31 +500,31 @@ Repeat the same process with the 10 tabs. This time all of them will wait and yo
* `sql_app/database.py`:
```Python
-{!../../../docs_src/sql_databases_peewee/sql_app/database.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
```
* `sql_app/models.py`:
```Python
-{!../../../docs_src/sql_databases_peewee/sql_app/models.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/models.py!}
```
* `sql_app/schemas.py`:
```Python
-{!../../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
```
* `sql_app/crud.py`:
```Python
-{!../../../docs_src/sql_databases_peewee/sql_app/crud.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/crud.py!}
```
* `sql_app/main.py`:
```Python
-{!../../../docs_src/sql_databases_peewee/sql_app/main.py!}
+{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
```
## Technical Details
diff --git a/docs/en/docs/python-types.md b/docs/en/docs/python-types.md
index 6994adb5f..ee192d8cb 100644
--- a/docs/en/docs/python-types.md
+++ b/docs/en/docs/python-types.md
@@ -23,7 +23,7 @@ If you are a Python expert, and you already know everything about type hints, sk
Let's start with a simple example:
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
Calling this program outputs:
@@ -39,7 +39,7 @@ The function does the following:
* <abbr title="Puts them together, as one. With the contents of one after the other.">Concatenates</abbr> them with a space in the middle.
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### Edit it
@@ -83,7 +83,7 @@ That's it.
Those are the "type hints":
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
That is not the same as declaring default values like would be with:
@@ -113,7 +113,7 @@ With that, you can scroll, seeing the options, until you find the one that "ring
Check this function, it already has type hints:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
Because the editor knows the types of the variables, you don't only get completion, you also get error checks:
@@ -123,7 +123,7 @@ Because the editor knows the types of the variables, you don't only get completi
Now you know that you have to fix it, convert `age` to a string with `str(age)`:
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## Declaring types
@@ -144,7 +144,7 @@ You can use, for example:
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### Generic types with type parameters
@@ -182,7 +182,7 @@ As the type, put `list`.
As the list is a type that contains some internal types, you put them in square brackets:
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006_py39.py!}
+{!> ../../docs_src/python_types/tutorial006_py39.py!}
```
////
@@ -192,7 +192,7 @@ As the list is a type that contains some internal types, you put them in square
From `typing`, import `List` (with a capital `L`):
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
Declare the variable, with the same colon (`:`) syntax.
@@ -202,7 +202,7 @@ As the type, put the `List` that you imported from `typing`.
As the list is a type that contains some internal types, you put them in square brackets:
```Python hl_lines="4"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
////
@@ -240,7 +240,7 @@ You would do the same to declare `tuple`s and `set`s:
//// tab | Python 3.9+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial007_py39.py!}
+{!> ../../docs_src/python_types/tutorial007_py39.py!}
```
////
@@ -248,7 +248,7 @@ You would do the same to declare `tuple`s and `set`s:
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial007.py!}
+{!> ../../docs_src/python_types/tutorial007.py!}
```
////
@@ -269,7 +269,7 @@ The second type parameter is for the values of the `dict`:
//// tab | Python 3.9+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008_py39.py!}
+{!> ../../docs_src/python_types/tutorial008_py39.py!}
```
////
@@ -277,7 +277,7 @@ The second type parameter is for the values of the `dict`:
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008.py!}
+{!> ../../docs_src/python_types/tutorial008.py!}
```
////
@@ -299,7 +299,7 @@ In Python 3.10 there's also a **new syntax** where you can put the possible type
//// tab | Python 3.10+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008b_py310.py!}
+{!> ../../docs_src/python_types/tutorial008b_py310.py!}
```
////
@@ -307,7 +307,7 @@ In Python 3.10 there's also a **new syntax** where you can put the possible type
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008b.py!}
+{!> ../../docs_src/python_types/tutorial008b.py!}
```
////
@@ -321,7 +321,7 @@ You can declare that a value could have a type, like `str`, but that it could al
In Python 3.6 and above (including Python 3.10) you can declare it by importing and using `Optional` from the `typing` module.
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
Using `Optional[str]` instead of just `str` will let the editor help you detect errors where you could be assuming that a value is always a `str`, when it could actually be `None` too.
@@ -333,7 +333,7 @@ This also means that in Python 3.10, you can use `Something | None`:
//// tab | Python 3.10+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial009_py310.py!}
+{!> ../../docs_src/python_types/tutorial009_py310.py!}
```
////
@@ -341,7 +341,7 @@ This also means that in Python 3.10, you can use `Something | None`:
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009.py!}
+{!> ../../docs_src/python_types/tutorial009.py!}
```
////
@@ -349,7 +349,7 @@ This also means that in Python 3.10, you can use `Something | None`:
//// tab | Python 3.8+ alternative
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009b.py!}
+{!> ../../docs_src/python_types/tutorial009b.py!}
```
////
@@ -370,7 +370,7 @@ It's just about the words and names. But those words can affect how you and your
As an example, let's take this function:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009c.py!}
+{!../../docs_src/python_types/tutorial009c.py!}
```
The parameter `name` is defined as `Optional[str]`, but it is **not optional**, you cannot call the function without the parameter:
@@ -388,7 +388,7 @@ say_hi(name=None) # This works, None is valid 🎉
The good news is, once you are on Python 3.10 you won't have to worry about that, as you will be able to simply use `|` to define unions of types:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009c_py310.py!}
+{!../../docs_src/python_types/tutorial009c_py310.py!}
```
And then you won't have to worry about names like `Optional` and `Union`. 😎
@@ -452,13 +452,13 @@ You can also declare a class as the type of a variable.
Let's say you have a class `Person`, with a name:
```Python hl_lines="1-3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Then you can declare a variable to be of type `Person`:
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
And then, again, you get all the editor support:
@@ -486,7 +486,7 @@ An example from the official Pydantic docs:
//// tab | Python 3.10+
```Python
-{!> ../../../docs_src/python_types/tutorial011_py310.py!}
+{!> ../../docs_src/python_types/tutorial011_py310.py!}
```
////
@@ -494,7 +494,7 @@ An example from the official Pydantic docs:
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/python_types/tutorial011_py39.py!}
+{!> ../../docs_src/python_types/tutorial011_py39.py!}
```
////
@@ -502,7 +502,7 @@ An example from the official Pydantic docs:
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/python_types/tutorial011.py!}
+{!> ../../docs_src/python_types/tutorial011.py!}
```
////
@@ -532,7 +532,7 @@ Python also has a feature that allows putting **additional <abbr title="Data abo
In Python 3.9, `Annotated` is part of the standard library, so you can import it from `typing`.
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial013_py39.py!}
+{!> ../../docs_src/python_types/tutorial013_py39.py!}
```
////
@@ -544,7 +544,7 @@ In versions below Python 3.9, you import `Annotated` from `typing_extensions`.
It will already be installed with **FastAPI**.
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial013.py!}
+{!> ../../docs_src/python_types/tutorial013.py!}
```
////
diff --git a/docs/en/docs/tutorial/background-tasks.md b/docs/en/docs/tutorial/background-tasks.md
index 8b4476e41..1cd460b07 100644
--- a/docs/en/docs/tutorial/background-tasks.md
+++ b/docs/en/docs/tutorial/background-tasks.md
@@ -16,7 +16,7 @@ This includes, for example:
First, import `BackgroundTasks` and define a parameter in your *path operation function* with a type declaration of `BackgroundTasks`:
```Python hl_lines="1 13"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
**FastAPI** will create the object of type `BackgroundTasks` for you and pass it as that parameter.
@@ -34,7 +34,7 @@ In this case, the task function will write to a file (simulating sending an emai
And as the write operation doesn't use `async` and `await`, we define the function with normal `def`:
```Python hl_lines="6-9"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
## Add the background task
@@ -42,7 +42,7 @@ And as the write operation doesn't use `async` and `await`, we define the functi
Inside of your *path operation function*, pass your task function to the *background tasks* object with the method `.add_task()`:
```Python hl_lines="14"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
`.add_task()` receives as arguments:
@@ -60,7 +60,7 @@ Using `BackgroundTasks` also works with the dependency injection system, you can
//// tab | Python 3.10+
```Python hl_lines="13 15 22 25"
-{!> ../../../docs_src/background_tasks/tutorial002_an_py310.py!}
+{!> ../../docs_src/background_tasks/tutorial002_an_py310.py!}
```
////
@@ -68,7 +68,7 @@ Using `BackgroundTasks` also works with the dependency injection system, you can
//// tab | Python 3.9+
```Python hl_lines="13 15 22 25"
-{!> ../../../docs_src/background_tasks/tutorial002_an_py39.py!}
+{!> ../../docs_src/background_tasks/tutorial002_an_py39.py!}
```
////
@@ -76,7 +76,7 @@ Using `BackgroundTasks` also works with the dependency injection system, you can
//// tab | Python 3.8+
```Python hl_lines="14 16 23 26"
-{!> ../../../docs_src/background_tasks/tutorial002_an.py!}
+{!> ../../docs_src/background_tasks/tutorial002_an.py!}
```
////
@@ -90,7 +90,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="11 13 20 23"
-{!> ../../../docs_src/background_tasks/tutorial002_py310.py!}
+{!> ../../docs_src/background_tasks/tutorial002_py310.py!}
```
////
@@ -104,7 +104,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="13 15 22 25"
-{!> ../../../docs_src/background_tasks/tutorial002.py!}
+{!> ../../docs_src/background_tasks/tutorial002.py!}
```
////
diff --git a/docs/en/docs/tutorial/bigger-applications.md b/docs/en/docs/tutorial/bigger-applications.md
index 1c33fd051..4ec9b15bd 100644
--- a/docs/en/docs/tutorial/bigger-applications.md
+++ b/docs/en/docs/tutorial/bigger-applications.md
@@ -86,7 +86,7 @@ You can create the *path operations* for that module using `APIRouter`.
You import it and create an "instance" the same way you would with the class `FastAPI`:
```Python hl_lines="1 3" title="app/routers/users.py"
-{!../../../docs_src/bigger_applications/app/routers/users.py!}
+{!../../docs_src/bigger_applications/app/routers/users.py!}
```
### *Path operations* with `APIRouter`
@@ -96,7 +96,7 @@ And then you use it to declare your *path operations*.
Use it the same way you would use the `FastAPI` class:
```Python hl_lines="6 11 16" title="app/routers/users.py"
-{!../../../docs_src/bigger_applications/app/routers/users.py!}
+{!../../docs_src/bigger_applications/app/routers/users.py!}
```
You can think of `APIRouter` as a "mini `FastAPI`" class.
@@ -124,7 +124,7 @@ We will now use a simple dependency to read a custom `X-Token` header:
//// tab | Python 3.9+
```Python hl_lines="3 6-8" title="app/dependencies.py"
-{!> ../../../docs_src/bigger_applications/app_an_py39/dependencies.py!}
+{!> ../../docs_src/bigger_applications/app_an_py39/dependencies.py!}
```
////
@@ -132,7 +132,7 @@ We will now use a simple dependency to read a custom `X-Token` header:
//// tab | Python 3.8+
```Python hl_lines="1 5-7" title="app/dependencies.py"
-{!> ../../../docs_src/bigger_applications/app_an/dependencies.py!}
+{!> ../../docs_src/bigger_applications/app_an/dependencies.py!}
```
////
@@ -146,7 +146,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1 4-6" title="app/dependencies.py"
-{!> ../../../docs_src/bigger_applications/app/dependencies.py!}
+{!> ../../docs_src/bigger_applications/app/dependencies.py!}
```
////
@@ -182,7 +182,7 @@ We know all the *path operations* in this module have the same:
So, instead of adding all that to each *path operation*, we can add it to the `APIRouter`.
```Python hl_lines="5-10 16 21" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
As the path of each *path operation* has to start with `/`, like in:
@@ -243,7 +243,7 @@ And we need to get the dependency function from the module `app.dependencies`, t
So we use a relative import with `..` for the dependencies:
```Python hl_lines="3" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
#### How relative imports work
@@ -316,7 +316,7 @@ We are not adding the prefix `/items` nor the `tags=["items"]` to each *path ope
But we can still add _more_ `tags` that will be applied to a specific *path operation*, and also some extra `responses` specific to that *path operation*:
```Python hl_lines="30-31" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
/// tip
@@ -344,7 +344,7 @@ You import and create a `FastAPI` class as normally.
And we can even declare [global dependencies](dependencies/global-dependencies.md){.internal-link target=_blank} that will be combined with the dependencies for each `APIRouter`:
```Python hl_lines="1 3 7" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
### Import the `APIRouter`
@@ -352,7 +352,7 @@ And we can even declare [global dependencies](dependencies/global-dependencies.m
Now we import the other submodules that have `APIRouter`s:
```Python hl_lines="4-5" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
As the files `app/routers/users.py` and `app/routers/items.py` are submodules that are part of the same Python package `app`, we can use a single dot `.` to import them using "relative imports".
@@ -417,7 +417,7 @@ the `router` from `users` would overwrite the one from `items` and we wouldn't b
So, to be able to use both of them in the same file, we import the submodules directly:
```Python hl_lines="5" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
### Include the `APIRouter`s for `users` and `items`
@@ -425,7 +425,7 @@ So, to be able to use both of them in the same file, we import the submodules di
Now, let's include the `router`s from the submodules `users` and `items`:
```Python hl_lines="10-11" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
/// info
@@ -467,7 +467,7 @@ It contains an `APIRouter` with some admin *path operations* that your organizat
For this example it will be super simple. But let's say that because it is shared with other projects in the organization, we cannot modify it and add a `prefix`, `dependencies`, `tags`, etc. directly to the `APIRouter`:
```Python hl_lines="3" title="app/internal/admin.py"
-{!../../../docs_src/bigger_applications/app/internal/admin.py!}
+{!../../docs_src/bigger_applications/app/internal/admin.py!}
```
But we still want to set a custom `prefix` when including the `APIRouter` so that all its *path operations* start with `/admin`, we want to secure it with the `dependencies` we already have for this project, and we want to include `tags` and `responses`.
@@ -475,7 +475,7 @@ But we still want to set a custom `prefix` when including the `APIRouter` so tha
We can declare all that without having to modify the original `APIRouter` by passing those parameters to `app.include_router()`:
```Python hl_lines="14-17" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
That way, the original `APIRouter` will stay unmodified, so we can still share that same `app/internal/admin.py` file with other projects in the organization.
@@ -498,7 +498,7 @@ We can also add *path operations* directly to the `FastAPI` app.
Here we do it... just to show that we can 🤷:
```Python hl_lines="21-23" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
and it will work correctly, together with all the other *path operations* added with `app.include_router()`.
diff --git a/docs/en/docs/tutorial/body-fields.md b/docs/en/docs/tutorial/body-fields.md
index 466df29f1..30a5c623f 100644
--- a/docs/en/docs/tutorial/body-fields.md
+++ b/docs/en/docs/tutorial/body-fields.md
@@ -9,7 +9,7 @@ First, you have to import it:
//// tab | Python 3.10+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ First, you have to import it:
//// tab | Python 3.9+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ First, you have to import it:
//// tab | Python 3.8+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an.py!}
+{!> ../../docs_src/body_fields/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="2"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
@@ -71,7 +71,7 @@ You can then use `Field` with model attributes:
//// tab | Python 3.10+
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py310.py!}
```
////
@@ -79,7 +79,7 @@ You can then use `Field` with model attributes:
//// tab | Python 3.9+
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py39.py!}
```
////
@@ -87,7 +87,7 @@ You can then use `Field` with model attributes:
//// tab | Python 3.8+
```Python hl_lines="12-15"
-{!> ../../../docs_src/body_fields/tutorial001_an.py!}
+{!> ../../docs_src/body_fields/tutorial001_an.py!}
```
////
@@ -101,7 +101,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9-12"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
@@ -115,7 +115,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
diff --git a/docs/en/docs/tutorial/body-multiple-params.md b/docs/en/docs/tutorial/body-multiple-params.md
index d63cd2529..eebbb3fe4 100644
--- a/docs/en/docs/tutorial/body-multiple-params.md
+++ b/docs/en/docs/tutorial/body-multiple-params.md
@@ -11,7 +11,7 @@ And you can also declare body parameters as optional, by setting the default to
//// tab | Python 3.10+
```Python hl_lines="18-20"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
```
////
@@ -19,7 +19,7 @@ And you can also declare body parameters as optional, by setting the default to
//// tab | Python 3.9+
```Python hl_lines="18-20"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
```
////
@@ -27,7 +27,7 @@ And you can also declare body parameters as optional, by setting the default to
//// tab | Python 3.8+
```Python hl_lines="19-21"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an.py!}
```
////
@@ -41,7 +41,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="17-19"
-{!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_py310.py!}
```
////
@@ -55,7 +55,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="19-21"
-{!> ../../../docs_src/body_multiple_params/tutorial001.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001.py!}
```
////
@@ -84,7 +84,7 @@ But you can also declare multiple body parameters, e.g. `item` and `user`:
//// tab | Python 3.10+
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002_py310.py!}
```
////
@@ -92,7 +92,7 @@ But you can also declare multiple body parameters, e.g. `item` and `user`:
//// tab | Python 3.8+
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial002.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002.py!}
```
////
@@ -139,7 +139,7 @@ But you can instruct **FastAPI** to treat it as another body key using `Body`:
//// tab | Python 3.10+
```Python hl_lines="23"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
```
////
@@ -147,7 +147,7 @@ But you can instruct **FastAPI** to treat it as another body key using `Body`:
//// tab | Python 3.9+
```Python hl_lines="23"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
```
////
@@ -155,7 +155,7 @@ But you can instruct **FastAPI** to treat it as another body key using `Body`:
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an.py!}
```
////
@@ -169,7 +169,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_py310.py!}
```
////
@@ -183,7 +183,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial003.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003.py!}
```
////
@@ -229,7 +229,7 @@ For example:
//// tab | Python 3.10+
```Python hl_lines="28"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
```
////
@@ -237,7 +237,7 @@ For example:
//// tab | Python 3.9+
```Python hl_lines="28"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
```
////
@@ -245,7 +245,7 @@ For example:
//// tab | Python 3.8+
```Python hl_lines="29"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an.py!}
```
////
@@ -259,7 +259,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="26"
-{!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_py310.py!}
```
////
@@ -273,7 +273,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="28"
-{!> ../../../docs_src/body_multiple_params/tutorial004.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004.py!}
```
////
@@ -301,7 +301,7 @@ as in:
//// tab | Python 3.10+
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
```
////
@@ -309,7 +309,7 @@ as in:
//// tab | Python 3.9+
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
```
////
@@ -317,7 +317,7 @@ as in:
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an.py!}
```
////
@@ -331,7 +331,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="15"
-{!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_py310.py!}
```
////
@@ -345,7 +345,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005.py!}
```
////
diff --git a/docs/en/docs/tutorial/body-nested-models.md b/docs/en/docs/tutorial/body-nested-models.md
index d2bda5979..38f3eb136 100644
--- a/docs/en/docs/tutorial/body-nested-models.md
+++ b/docs/en/docs/tutorial/body-nested-models.md
@@ -9,7 +9,7 @@ You can define an attribute to be a subtype. For example, a Python `list`:
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial001_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial001_py310.py!}
```
////
@@ -17,7 +17,7 @@ You can define an attribute to be a subtype. For example, a Python `list`:
//// tab | Python 3.8+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial001.py!}
+{!> ../../docs_src/body_nested_models/tutorial001.py!}
```
////
@@ -35,7 +35,7 @@ In Python 3.9 and above you can use the standard `list` to declare these type an
But in Python versions before 3.9 (3.6 and above), you first need to import `List` from standard Python's `typing` module:
```Python hl_lines="1"
-{!> ../../../docs_src/body_nested_models/tutorial002.py!}
+{!> ../../docs_src/body_nested_models/tutorial002.py!}
```
### Declare a `list` with a type parameter
@@ -68,7 +68,7 @@ So, in our example, we can make `tags` be specifically a "list of strings":
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial002_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial002_py310.py!}
```
////
@@ -76,7 +76,7 @@ So, in our example, we can make `tags` be specifically a "list of strings":
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial002_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial002_py39.py!}
```
////
@@ -84,7 +84,7 @@ So, in our example, we can make `tags` be specifically a "list of strings":
//// tab | Python 3.8+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial002.py!}
+{!> ../../docs_src/body_nested_models/tutorial002.py!}
```
////
@@ -100,7 +100,7 @@ Then we can declare `tags` as a set of strings:
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial003_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial003_py310.py!}
```
////
@@ -108,7 +108,7 @@ Then we can declare `tags` as a set of strings:
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial003_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial003_py39.py!}
```
////
@@ -116,7 +116,7 @@ Then we can declare `tags` as a set of strings:
//// tab | Python 3.8+
```Python hl_lines="1 14"
-{!> ../../../docs_src/body_nested_models/tutorial003.py!}
+{!> ../../docs_src/body_nested_models/tutorial003.py!}
```
////
@@ -144,7 +144,7 @@ For example, we can define an `Image` model:
//// tab | Python 3.10+
```Python hl_lines="7-9"
-{!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py310.py!}
```
////
@@ -152,7 +152,7 @@ For example, we can define an `Image` model:
//// tab | Python 3.9+
```Python hl_lines="9-11"
-{!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py39.py!}
```
////
@@ -160,7 +160,7 @@ For example, we can define an `Image` model:
//// tab | Python 3.8+
```Python hl_lines="9-11"
-{!> ../../../docs_src/body_nested_models/tutorial004.py!}
+{!> ../../docs_src/body_nested_models/tutorial004.py!}
```
////
@@ -172,7 +172,7 @@ And then we can use it as the type of an attribute:
//// tab | Python 3.10+
```Python hl_lines="18"
-{!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py310.py!}
```
////
@@ -180,7 +180,7 @@ And then we can use it as the type of an attribute:
//// tab | Python 3.9+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py39.py!}
```
////
@@ -188,7 +188,7 @@ And then we can use it as the type of an attribute:
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial004.py!}
+{!> ../../docs_src/body_nested_models/tutorial004.py!}
```
////
@@ -227,7 +227,7 @@ For example, as in the `Image` model we have a `url` field, we can declare it to
//// tab | Python 3.10+
```Python hl_lines="2 8"
-{!> ../../../docs_src/body_nested_models/tutorial005_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial005_py310.py!}
```
////
@@ -235,7 +235,7 @@ For example, as in the `Image` model we have a `url` field, we can declare it to
//// tab | Python 3.9+
```Python hl_lines="4 10"
-{!> ../../../docs_src/body_nested_models/tutorial005_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial005_py39.py!}
```
////
@@ -243,7 +243,7 @@ For example, as in the `Image` model we have a `url` field, we can declare it to
//// tab | Python 3.8+
```Python hl_lines="4 10"
-{!> ../../../docs_src/body_nested_models/tutorial005.py!}
+{!> ../../docs_src/body_nested_models/tutorial005.py!}
```
////
@@ -257,7 +257,7 @@ You can also use Pydantic models as subtypes of `list`, `set`, etc.:
//// tab | Python 3.10+
```Python hl_lines="18"
-{!> ../../../docs_src/body_nested_models/tutorial006_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial006_py310.py!}
```
////
@@ -265,7 +265,7 @@ You can also use Pydantic models as subtypes of `list`, `set`, etc.:
//// tab | Python 3.9+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial006_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial006_py39.py!}
```
////
@@ -273,7 +273,7 @@ You can also use Pydantic models as subtypes of `list`, `set`, etc.:
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial006.py!}
+{!> ../../docs_src/body_nested_models/tutorial006.py!}
```
////
@@ -317,7 +317,7 @@ You can define arbitrarily deeply nested models:
//// tab | Python 3.10+
```Python hl_lines="7 12 18 21 25"
-{!> ../../../docs_src/body_nested_models/tutorial007_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial007_py310.py!}
```
////
@@ -325,7 +325,7 @@ You can define arbitrarily deeply nested models:
//// tab | Python 3.9+
```Python hl_lines="9 14 20 23 27"
-{!> ../../../docs_src/body_nested_models/tutorial007_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial007_py39.py!}
```
////
@@ -333,7 +333,7 @@ You can define arbitrarily deeply nested models:
//// tab | Python 3.8+
```Python hl_lines="9 14 20 23 27"
-{!> ../../../docs_src/body_nested_models/tutorial007.py!}
+{!> ../../docs_src/body_nested_models/tutorial007.py!}
```
////
@@ -363,7 +363,7 @@ as in:
//// tab | Python 3.9+
```Python hl_lines="13"
-{!> ../../../docs_src/body_nested_models/tutorial008_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial008_py39.py!}
```
////
@@ -371,7 +371,7 @@ as in:
//// tab | Python 3.8+
```Python hl_lines="15"
-{!> ../../../docs_src/body_nested_models/tutorial008.py!}
+{!> ../../docs_src/body_nested_models/tutorial008.py!}
```
////
@@ -407,7 +407,7 @@ In this case, you would accept any `dict` as long as it has `int` keys with `flo
//// tab | Python 3.9+
```Python hl_lines="7"
-{!> ../../../docs_src/body_nested_models/tutorial009_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial009_py39.py!}
```
////
@@ -415,7 +415,7 @@ In this case, you would accept any `dict` as long as it has `int` keys with `flo
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/body_nested_models/tutorial009.py!}
+{!> ../../docs_src/body_nested_models/tutorial009.py!}
```
////
diff --git a/docs/en/docs/tutorial/body-updates.md b/docs/en/docs/tutorial/body-updates.md
index 3257f9a08..3ac2e3914 100644
--- a/docs/en/docs/tutorial/body-updates.md
+++ b/docs/en/docs/tutorial/body-updates.md
@@ -9,7 +9,7 @@ You can use the `jsonable_encoder` to convert the input data to data that can be
//// tab | Python 3.10+
```Python hl_lines="28-33"
-{!> ../../../docs_src/body_updates/tutorial001_py310.py!}
+{!> ../../docs_src/body_updates/tutorial001_py310.py!}
```
////
@@ -17,7 +17,7 @@ You can use the `jsonable_encoder` to convert the input data to data that can be
//// tab | Python 3.9+
```Python hl_lines="30-35"
-{!> ../../../docs_src/body_updates/tutorial001_py39.py!}
+{!> ../../docs_src/body_updates/tutorial001_py39.py!}
```
////
@@ -25,7 +25,7 @@ You can use the `jsonable_encoder` to convert the input data to data that can be
//// tab | Python 3.8+
```Python hl_lines="30-35"
-{!> ../../../docs_src/body_updates/tutorial001.py!}
+{!> ../../docs_src/body_updates/tutorial001.py!}
```
////
@@ -87,7 +87,7 @@ Then you can use this to generate a `dict` with only the data that was set (sent
//// tab | Python 3.10+
```Python hl_lines="32"
-{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+{!> ../../docs_src/body_updates/tutorial002_py310.py!}
```
////
@@ -95,7 +95,7 @@ Then you can use this to generate a `dict` with only the data that was set (sent
//// tab | Python 3.9+
```Python hl_lines="34"
-{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+{!> ../../docs_src/body_updates/tutorial002_py39.py!}
```
////
@@ -103,7 +103,7 @@ Then you can use this to generate a `dict` with only the data that was set (sent
//// tab | Python 3.8+
```Python hl_lines="34"
-{!> ../../../docs_src/body_updates/tutorial002.py!}
+{!> ../../docs_src/body_updates/tutorial002.py!}
```
////
@@ -125,7 +125,7 @@ Like `stored_item_model.model_copy(update=update_data)`:
//// tab | Python 3.10+
```Python hl_lines="33"
-{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+{!> ../../docs_src/body_updates/tutorial002_py310.py!}
```
////
@@ -133,7 +133,7 @@ Like `stored_item_model.model_copy(update=update_data)`:
//// tab | Python 3.9+
```Python hl_lines="35"
-{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+{!> ../../docs_src/body_updates/tutorial002_py39.py!}
```
////
@@ -141,7 +141,7 @@ Like `stored_item_model.model_copy(update=update_data)`:
//// tab | Python 3.8+
```Python hl_lines="35"
-{!> ../../../docs_src/body_updates/tutorial002.py!}
+{!> ../../docs_src/body_updates/tutorial002.py!}
```
////
@@ -164,7 +164,7 @@ In summary, to apply partial updates you would:
//// tab | Python 3.10+
```Python hl_lines="28-35"
-{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+{!> ../../docs_src/body_updates/tutorial002_py310.py!}
```
////
@@ -172,7 +172,7 @@ In summary, to apply partial updates you would:
//// tab | Python 3.9+
```Python hl_lines="30-37"
-{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+{!> ../../docs_src/body_updates/tutorial002_py39.py!}
```
////
@@ -180,7 +180,7 @@ In summary, to apply partial updates you would:
//// tab | Python 3.8+
```Python hl_lines="30-37"
-{!> ../../../docs_src/body_updates/tutorial002.py!}
+{!> ../../docs_src/body_updates/tutorial002.py!}
```
////
diff --git a/docs/en/docs/tutorial/body.md b/docs/en/docs/tutorial/body.md
index 83f08ce84..14d621418 100644
--- a/docs/en/docs/tutorial/body.md
+++ b/docs/en/docs/tutorial/body.md
@@ -25,7 +25,7 @@ First, you need to import `BaseModel` from `pydantic`:
//// tab | Python 3.10+
```Python hl_lines="2"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -33,7 +33,7 @@ First, you need to import `BaseModel` from `pydantic`:
//// tab | Python 3.8+
```Python hl_lines="4"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -47,7 +47,7 @@ Use standard Python types for all the attributes:
//// tab | Python 3.10+
```Python hl_lines="5-9"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -55,7 +55,7 @@ Use standard Python types for all the attributes:
//// tab | Python 3.8+
```Python hl_lines="7-11"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -89,7 +89,7 @@ To add it to your *path operation*, declare it the same way you declared path an
//// tab | Python 3.10+
```Python hl_lines="16"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -97,7 +97,7 @@ To add it to your *path operation*, declare it the same way you declared path an
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -170,7 +170,7 @@ Inside of the function, you can access all the attributes of the model object di
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/body/tutorial002_py310.py!}
+{!> ../../docs_src/body/tutorial002_py310.py!}
```
////
@@ -178,7 +178,7 @@ Inside of the function, you can access all the attributes of the model object di
//// tab | Python 3.8+
```Python hl_lines="21"
-{!> ../../../docs_src/body/tutorial002.py!}
+{!> ../../docs_src/body/tutorial002.py!}
```
////
@@ -192,7 +192,7 @@ You can declare path parameters and request body at the same time.
//// tab | Python 3.10+
```Python hl_lines="15-16"
-{!> ../../../docs_src/body/tutorial003_py310.py!}
+{!> ../../docs_src/body/tutorial003_py310.py!}
```
////
@@ -200,7 +200,7 @@ You can declare path parameters and request body at the same time.
//// tab | Python 3.8+
```Python hl_lines="17-18"
-{!> ../../../docs_src/body/tutorial003.py!}
+{!> ../../docs_src/body/tutorial003.py!}
```
////
@@ -214,7 +214,7 @@ You can also declare **body**, **path** and **query** parameters, all at the sam
//// tab | Python 3.10+
```Python hl_lines="16"
-{!> ../../../docs_src/body/tutorial004_py310.py!}
+{!> ../../docs_src/body/tutorial004_py310.py!}
```
////
@@ -222,7 +222,7 @@ You can also declare **body**, **path** and **query** parameters, all at the sam
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/body/tutorial004.py!}
+{!> ../../docs_src/body/tutorial004.py!}
```
////
diff --git a/docs/en/docs/tutorial/cookie-param-models.md b/docs/en/docs/tutorial/cookie-param-models.md
index 2aa3a1f59..62cafbb23 100644
--- a/docs/en/docs/tutorial/cookie-param-models.md
+++ b/docs/en/docs/tutorial/cookie-param-models.md
@@ -23,7 +23,7 @@ Declare the **cookie** parameters that you need in a **Pydantic model**, and the
//// tab | Python 3.10+
```Python hl_lines="9-12 16"
-{!> ../../../docs_src/cookie_param_models/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_param_models/tutorial001_an_py310.py!}
```
////
@@ -31,7 +31,7 @@ Declare the **cookie** parameters that you need in a **Pydantic model**, and the
//// tab | Python 3.9+
```Python hl_lines="9-12 16"
-{!> ../../../docs_src/cookie_param_models/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_param_models/tutorial001_an_py39.py!}
```
////
@@ -39,7 +39,7 @@ Declare the **cookie** parameters that you need in a **Pydantic model**, and the
//// tab | Python 3.8+
```Python hl_lines="10-13 17"
-{!> ../../../docs_src/cookie_param_models/tutorial001_an.py!}
+{!> ../../docs_src/cookie_param_models/tutorial001_an.py!}
```
////
@@ -53,7 +53,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7-10 14"
-{!> ../../../docs_src/cookie_param_models/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_param_models/tutorial001_py310.py!}
```
////
@@ -67,7 +67,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9-12 16"
-{!> ../../../docs_src/cookie_param_models/tutorial001.py!}
+{!> ../../docs_src/cookie_param_models/tutorial001.py!}
```
////
@@ -103,7 +103,7 @@ You can use Pydantic's model configuration to `forbid` any `extra` fields:
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/cookie_param_models/tutorial002_an_py39.py!}
+{!> ../../docs_src/cookie_param_models/tutorial002_an_py39.py!}
```
////
@@ -111,7 +111,7 @@ You can use Pydantic's model configuration to `forbid` any `extra` fields:
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/cookie_param_models/tutorial002_an.py!}
+{!> ../../docs_src/cookie_param_models/tutorial002_an.py!}
```
////
@@ -125,7 +125,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/cookie_param_models/tutorial002.py!}
+{!> ../../docs_src/cookie_param_models/tutorial002.py!}
```
////
diff --git a/docs/en/docs/tutorial/cookie-params.md b/docs/en/docs/tutorial/cookie-params.md
index 0214a9c38..8804f854f 100644
--- a/docs/en/docs/tutorial/cookie-params.md
+++ b/docs/en/docs/tutorial/cookie-params.md
@@ -9,7 +9,7 @@ First import `Cookie`:
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ First import `Cookie`:
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ First import `Cookie`:
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
@@ -67,7 +67,7 @@ You can define the default value as well as all the extra validation or annotati
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -75,7 +75,7 @@ You can define the default value as well as all the extra validation or annotati
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -83,7 +83,7 @@ You can define the default value as well as all the extra validation or annotati
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -97,7 +97,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -111,7 +111,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
diff --git a/docs/en/docs/tutorial/cors.md b/docs/en/docs/tutorial/cors.md
index 7dd0a5df5..8dfc9bad9 100644
--- a/docs/en/docs/tutorial/cors.md
+++ b/docs/en/docs/tutorial/cors.md
@@ -47,7 +47,7 @@ You can also specify whether your backend allows:
* Specific HTTP headers or all of them with the wildcard `"*"`.
```Python hl_lines="2 6-11 13-19"
-{!../../../docs_src/cors/tutorial001.py!}
+{!../../docs_src/cors/tutorial001.py!}
```
The default parameters used by the `CORSMiddleware` implementation are restrictive by default, so you'll need to explicitly enable particular origins, methods, or headers, in order for browsers to be permitted to use them in a Cross-Domain context.
diff --git a/docs/en/docs/tutorial/debugging.md b/docs/en/docs/tutorial/debugging.md
index c520a631d..6c0177853 100644
--- a/docs/en/docs/tutorial/debugging.md
+++ b/docs/en/docs/tutorial/debugging.md
@@ -7,7 +7,7 @@ You can connect the debugger in your editor, for example with Visual Studio Code
In your FastAPI application, import and run `uvicorn` directly:
```Python hl_lines="1 15"
-{!../../../docs_src/debugging/tutorial001.py!}
+{!../../docs_src/debugging/tutorial001.py!}
```
### About `__name__ == "__main__"`
diff --git a/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md
index b3394f14e..defd61a0d 100644
--- a/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -9,7 +9,7 @@ In the previous example, we were returning a `dict` from our dependency ("depend
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ In the previous example, we were returning a `dict` from our dependency ("depend
//// tab | Python 3.9+
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ In the previous example, we were returning a `dict` from our dependency ("depend
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -122,7 +122,7 @@ Then, we can change the dependency "dependable" `common_parameters` from above t
//// tab | Python 3.10+
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py310.py!}
```
////
@@ -130,7 +130,7 @@ Then, we can change the dependency "dependable" `common_parameters` from above t
//// tab | Python 3.9+
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py39.py!}
```
////
@@ -138,7 +138,7 @@ Then, we can change the dependency "dependable" `common_parameters` from above t
//// tab | Python 3.8+
```Python hl_lines="12-16"
-{!> ../../../docs_src/dependencies/tutorial002_an.py!}
+{!> ../../docs_src/dependencies/tutorial002_an.py!}
```
////
@@ -152,7 +152,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9-13"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -166,7 +166,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -176,7 +176,7 @@ Pay attention to the `__init__` method used to create the instance of the class:
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py310.py!}
```
////
@@ -184,7 +184,7 @@ Pay attention to the `__init__` method used to create the instance of the class:
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py39.py!}
```
////
@@ -192,7 +192,7 @@ Pay attention to the `__init__` method used to create the instance of the class:
//// tab | Python 3.8+
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial002_an.py!}
+{!> ../../docs_src/dependencies/tutorial002_an.py!}
```
////
@@ -206,7 +206,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -220,7 +220,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -230,7 +230,7 @@ Prefer to use the `Annotated` version if possible.
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -238,7 +238,7 @@ Prefer to use the `Annotated` version if possible.
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -246,7 +246,7 @@ Prefer to use the `Annotated` version if possible.
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -260,7 +260,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="6"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -274,7 +274,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -296,7 +296,7 @@ Now you can declare your dependency using this class.
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py310.py!}
```
////
@@ -304,7 +304,7 @@ Now you can declare your dependency using this class.
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py39.py!}
```
////
@@ -312,7 +312,7 @@ Now you can declare your dependency using this class.
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial002_an.py!}
+{!> ../../docs_src/dependencies/tutorial002_an.py!}
```
////
@@ -326,7 +326,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -340,7 +340,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -440,7 +440,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial003_an_py310.py!}
```
////
@@ -448,7 +448,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial003_an_py39.py!}
```
////
@@ -456,7 +456,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial003_an.py!}
+{!> ../../docs_src/dependencies/tutorial003_an.py!}
```
////
@@ -470,7 +470,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial003_py310.py!}
+{!> ../../docs_src/dependencies/tutorial003_py310.py!}
```
////
@@ -484,7 +484,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003.py!}
+{!> ../../docs_src/dependencies/tutorial003.py!}
```
////
@@ -578,7 +578,7 @@ The same example would then look like:
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial004_an_py310.py!}
```
////
@@ -586,7 +586,7 @@ The same example would then look like:
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial004_an_py39.py!}
```
////
@@ -594,7 +594,7 @@ The same example would then look like:
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial004_an.py!}
+{!> ../../docs_src/dependencies/tutorial004_an.py!}
```
////
@@ -608,7 +608,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial004_py310.py!}
+{!> ../../docs_src/dependencies/tutorial004_py310.py!}
```
////
@@ -622,7 +622,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004.py!}
+{!> ../../docs_src/dependencies/tutorial004.py!}
```
////
diff --git a/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index 7c3ac7922..e89d520be 100644
--- a/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -17,7 +17,7 @@ It should be a `list` of `Depends()`:
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ It should be a `list` of `Depends()`:
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -39,7 +39,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -75,7 +75,7 @@ They can declare request requirements (like headers) or other sub-dependencies:
//// tab | Python 3.9+
```Python hl_lines="8 13"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -83,7 +83,7 @@ They can declare request requirements (like headers) or other sub-dependencies:
//// tab | Python 3.8+
```Python hl_lines="7 12"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -97,7 +97,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="6 11"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -109,7 +109,7 @@ These dependencies can `raise` exceptions, the same as normal dependencies:
//// tab | Python 3.9+
```Python hl_lines="10 15"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -117,7 +117,7 @@ These dependencies can `raise` exceptions, the same as normal dependencies:
//// tab | Python 3.8+
```Python hl_lines="9 14"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -131,7 +131,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8 13"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -145,7 +145,7 @@ So, you can reuse a normal dependency (that returns a value) you already use som
//// tab | Python 3.9+
```Python hl_lines="11 16"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -153,7 +153,7 @@ So, you can reuse a normal dependency (that returns a value) you already use som
//// tab | Python 3.8+
```Python hl_lines="10 15"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -167,7 +167,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9 14"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
diff --git a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
index 2a3ac2237..97da668aa 100644
--- a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -30,19 +30,19 @@ For example, you could use this to create a database session and close it after
Only the code prior to and including the `yield` statement is executed before creating a response:
```Python hl_lines="2-4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
The yielded value is what is injected into *path operations* and other dependencies:
```Python hl_lines="4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
The code following the `yield` statement is executed after the response has been delivered:
```Python hl_lines="5-6"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
/// tip
@@ -64,7 +64,7 @@ So, you can look for that specific exception inside the dependency with `except
In the same way, you can use `finally` to make sure the exit steps are executed, no matter if there was an exception or not.
```Python hl_lines="3 5"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
## Sub-dependencies with `yield`
@@ -78,7 +78,7 @@ For example, `dependency_c` can have a dependency on `dependency_b`, and `depend
//// tab | Python 3.9+
```Python hl_lines="6 14 22"
-{!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008_an_py39.py!}
```
////
@@ -86,7 +86,7 @@ For example, `dependency_c` can have a dependency on `dependency_b`, and `depend
//// tab | Python 3.8+
```Python hl_lines="5 13 21"
-{!> ../../../docs_src/dependencies/tutorial008_an.py!}
+{!> ../../docs_src/dependencies/tutorial008_an.py!}
```
////
@@ -100,7 +100,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="4 12 20"
-{!> ../../../docs_src/dependencies/tutorial008.py!}
+{!> ../../docs_src/dependencies/tutorial008.py!}
```
////
@@ -114,7 +114,7 @@ And, in turn, `dependency_b` needs the value from `dependency_a` (here named `de
//// tab | Python 3.9+
```Python hl_lines="18-19 26-27"
-{!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008_an_py39.py!}
```
////
@@ -122,7 +122,7 @@ And, in turn, `dependency_b` needs the value from `dependency_a` (here named `de
//// tab | Python 3.8+
```Python hl_lines="17-18 25-26"
-{!> ../../../docs_src/dependencies/tutorial008_an.py!}
+{!> ../../docs_src/dependencies/tutorial008_an.py!}
```
////
@@ -136,7 +136,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="16-17 24-25"
-{!> ../../../docs_src/dependencies/tutorial008.py!}
+{!> ../../docs_src/dependencies/tutorial008.py!}
```
////
@@ -174,7 +174,7 @@ But it's there for you if you need it. 🤓
//// tab | Python 3.9+
```Python hl_lines="18-22 31"
-{!> ../../../docs_src/dependencies/tutorial008b_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008b_an_py39.py!}
```
////
@@ -182,7 +182,7 @@ But it's there for you if you need it. 🤓
//// tab | Python 3.8+
```Python hl_lines="17-21 30"
-{!> ../../../docs_src/dependencies/tutorial008b_an.py!}
+{!> ../../docs_src/dependencies/tutorial008b_an.py!}
```
////
@@ -196,7 +196,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="16-20 29"
-{!> ../../../docs_src/dependencies/tutorial008b.py!}
+{!> ../../docs_src/dependencies/tutorial008b.py!}
```
////
@@ -210,7 +210,7 @@ If you catch an exception using `except` in a dependency with `yield` and you do
//// tab | Python 3.9+
```Python hl_lines="15-16"
-{!> ../../../docs_src/dependencies/tutorial008c_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008c_an_py39.py!}
```
////
@@ -218,7 +218,7 @@ If you catch an exception using `except` in a dependency with `yield` and you do
//// tab | Python 3.8+
```Python hl_lines="14-15"
-{!> ../../../docs_src/dependencies/tutorial008c_an.py!}
+{!> ../../docs_src/dependencies/tutorial008c_an.py!}
```
////
@@ -232,7 +232,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="13-14"
-{!> ../../../docs_src/dependencies/tutorial008c.py!}
+{!> ../../docs_src/dependencies/tutorial008c.py!}
```
////
@@ -248,7 +248,7 @@ You can re-raise the same exception using `raise`:
//// tab | Python 3.9+
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial008d_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008d_an_py39.py!}
```
////
@@ -256,7 +256,7 @@ You can re-raise the same exception using `raise`:
//// tab | Python 3.8+
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial008d_an.py!}
+{!> ../../docs_src/dependencies/tutorial008d_an.py!}
```
////
@@ -270,7 +270,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="15"
-{!> ../../../docs_src/dependencies/tutorial008d.py!}
+{!> ../../docs_src/dependencies/tutorial008d.py!}
```
////
@@ -404,7 +404,7 @@ You can also use them inside of **FastAPI** dependencies with `yield` by using
`with` or `async with` statements inside of the dependency function:
```Python hl_lines="1-9 13"
-{!../../../docs_src/dependencies/tutorial010.py!}
+{!../../docs_src/dependencies/tutorial010.py!}
```
/// tip
diff --git a/docs/en/docs/tutorial/dependencies/global-dependencies.md b/docs/en/docs/tutorial/dependencies/global-dependencies.md
index 03a9a42f0..21a8cb6be 100644
--- a/docs/en/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/en/docs/tutorial/dependencies/global-dependencies.md
@@ -9,7 +9,7 @@ In that case, they will be applied to all the *path operations* in the applicati
//// tab | Python 3.9+
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial012_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial012_an_py39.py!}
```
////
@@ -17,7 +17,7 @@ In that case, they will be applied to all the *path operations* in the applicati
//// tab | Python 3.8+
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial012_an.py!}
+{!> ../../docs_src/dependencies/tutorial012_an.py!}
```
////
@@ -31,7 +31,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="15"
-{!> ../../../docs_src/dependencies/tutorial012.py!}
+{!> ../../docs_src/dependencies/tutorial012.py!}
```
////
diff --git a/docs/en/docs/tutorial/dependencies/index.md b/docs/en/docs/tutorial/dependencies/index.md
index a608222f2..b50edb98e 100644
--- a/docs/en/docs/tutorial/dependencies/index.md
+++ b/docs/en/docs/tutorial/dependencies/index.md
@@ -34,7 +34,7 @@ It is just a function that can take all the same parameters that a *path operati
//// tab | Python 3.10+
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -42,7 +42,7 @@ It is just a function that can take all the same parameters that a *path operati
//// tab | Python 3.9+
```Python hl_lines="8-11"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -50,7 +50,7 @@ It is just a function that can take all the same parameters that a *path operati
//// tab | Python 3.8+
```Python hl_lines="9-12"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -64,7 +64,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="6-7"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -78,7 +78,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8-11"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -116,7 +116,7 @@ Make sure you [Upgrade the FastAPI version](../../deployment/versions.md#upgradi
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -124,7 +124,7 @@ Make sure you [Upgrade the FastAPI version](../../deployment/versions.md#upgradi
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -132,7 +132,7 @@ Make sure you [Upgrade the FastAPI version](../../deployment/versions.md#upgradi
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -146,7 +146,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -160,7 +160,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -172,7 +172,7 @@ The same way you use `Body`, `Query`, etc. with your *path operation function* p
//// tab | Python 3.10+
```Python hl_lines="13 18"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -180,7 +180,7 @@ The same way you use `Body`, `Query`, etc. with your *path operation function* p
//// tab | Python 3.9+
```Python hl_lines="15 20"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -188,7 +188,7 @@ The same way you use `Body`, `Query`, etc. with your *path operation function* p
//// tab | Python 3.8+
```Python hl_lines="16 21"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -202,7 +202,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="11 16"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -216,7 +216,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="15 20"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -279,7 +279,7 @@ But because we are using `Annotated`, we can store that `Annotated` value in a v
//// tab | Python 3.10+
```Python hl_lines="12 16 21"
-{!> ../../../docs_src/dependencies/tutorial001_02_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an_py310.py!}
```
////
@@ -287,7 +287,7 @@ But because we are using `Annotated`, we can store that `Annotated` value in a v
//// tab | Python 3.9+
```Python hl_lines="14 18 23"
-{!> ../../../docs_src/dependencies/tutorial001_02_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an_py39.py!}
```
////
@@ -295,7 +295,7 @@ But because we are using `Annotated`, we can store that `Annotated` value in a v
//// tab | Python 3.8+
```Python hl_lines="15 19 24"
-{!> ../../../docs_src/dependencies/tutorial001_02_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an.py!}
```
////
diff --git a/docs/en/docs/tutorial/dependencies/sub-dependencies.md b/docs/en/docs/tutorial/dependencies/sub-dependencies.md
index 85b252e13..2b098d159 100644
--- a/docs/en/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/en/docs/tutorial/dependencies/sub-dependencies.md
@@ -13,7 +13,7 @@ You could create a first dependency ("dependable") like:
//// tab | Python 3.10+
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial005_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
```
////
@@ -21,7 +21,7 @@ You could create a first dependency ("dependable") like:
//// tab | Python 3.9+
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
```
////
@@ -29,7 +29,7 @@ You could create a first dependency ("dependable") like:
//// tab | Python 3.8+
```Python hl_lines="9-10"
-{!> ../../../docs_src/dependencies/tutorial005_an.py!}
+{!> ../../docs_src/dependencies/tutorial005_an.py!}
```
////
@@ -43,7 +43,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="6-7"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -57,7 +57,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
@@ -73,7 +73,7 @@ Then you can create another dependency function (a "dependable") that at the sam
//// tab | Python 3.10+
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial005_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
```
////
@@ -81,7 +81,7 @@ Then you can create another dependency function (a "dependable") that at the sam
//// tab | Python 3.9+
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
```
////
@@ -89,7 +89,7 @@ Then you can create another dependency function (a "dependable") that at the sam
//// tab | Python 3.8+
```Python hl_lines="14"
-{!> ../../../docs_src/dependencies/tutorial005_an.py!}
+{!> ../../docs_src/dependencies/tutorial005_an.py!}
```
////
@@ -103,7 +103,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -117,7 +117,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
@@ -136,7 +136,7 @@ Then we can use the dependency with:
//// tab | Python 3.10+
```Python hl_lines="23"
-{!> ../../../docs_src/dependencies/tutorial005_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
```
////
@@ -144,7 +144,7 @@ Then we can use the dependency with:
//// tab | Python 3.9+
```Python hl_lines="23"
-{!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
```
////
@@ -152,7 +152,7 @@ Then we can use the dependency with:
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/dependencies/tutorial005_an.py!}
+{!> ../../docs_src/dependencies/tutorial005_an.py!}
```
////
@@ -166,7 +166,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -180,7 +180,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="22"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
diff --git a/docs/en/docs/tutorial/encoder.md b/docs/en/docs/tutorial/encoder.md
index c110a2ac5..039ac6714 100644
--- a/docs/en/docs/tutorial/encoder.md
+++ b/docs/en/docs/tutorial/encoder.md
@@ -23,7 +23,7 @@ It receives an object, like a Pydantic model, and returns a JSON compatible vers
//// tab | Python 3.10+
```Python hl_lines="4 21"
-{!> ../../../docs_src/encoder/tutorial001_py310.py!}
+{!> ../../docs_src/encoder/tutorial001_py310.py!}
```
////
@@ -31,7 +31,7 @@ It receives an object, like a Pydantic model, and returns a JSON compatible vers
//// tab | Python 3.8+
```Python hl_lines="5 22"
-{!> ../../../docs_src/encoder/tutorial001.py!}
+{!> ../../docs_src/encoder/tutorial001.py!}
```
////
diff --git a/docs/en/docs/tutorial/extra-data-types.md b/docs/en/docs/tutorial/extra-data-types.md
index 3009acaf3..65f9f1085 100644
--- a/docs/en/docs/tutorial/extra-data-types.md
+++ b/docs/en/docs/tutorial/extra-data-types.md
@@ -58,7 +58,7 @@ Here's an example *path operation* with parameters using some of the above types
//// tab | Python 3.10+
```Python hl_lines="1 3 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py310.py!}
```
////
@@ -66,7 +66,7 @@ Here's an example *path operation* with parameters using some of the above types
//// tab | Python 3.9+
```Python hl_lines="1 3 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py39.py!}
```
////
@@ -74,7 +74,7 @@ Here's an example *path operation* with parameters using some of the above types
//// tab | Python 3.8+
```Python hl_lines="1 3 13-17"
-{!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an.py!}
```
////
@@ -88,7 +88,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1 2 11-15"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
@@ -102,7 +102,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1 2 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
@@ -112,7 +112,7 @@ Note that the parameters inside the function have their natural data type, and y
//// tab | Python 3.10+
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py310.py!}
```
////
@@ -120,7 +120,7 @@ Note that the parameters inside the function have their natural data type, and y
//// tab | Python 3.9+
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py39.py!}
```
////
@@ -128,7 +128,7 @@ Note that the parameters inside the function have their natural data type, and y
//// tab | Python 3.8+
```Python hl_lines="19-20"
-{!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an.py!}
```
////
@@ -142,7 +142,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="17-18"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
@@ -156,7 +156,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
diff --git a/docs/en/docs/tutorial/extra-models.md b/docs/en/docs/tutorial/extra-models.md
index 1c87e76ce..4e6f69f31 100644
--- a/docs/en/docs/tutorial/extra-models.md
+++ b/docs/en/docs/tutorial/extra-models.md
@@ -23,7 +23,7 @@ Here's a general idea of how the models could look like with their password fiel
//// tab | Python 3.10+
```Python hl_lines="7 9 14 20 22 27-28 31-33 38-39"
-{!> ../../../docs_src/extra_models/tutorial001_py310.py!}
+{!> ../../docs_src/extra_models/tutorial001_py310.py!}
```
////
@@ -31,7 +31,7 @@ Here's a general idea of how the models could look like with their password fiel
//// tab | Python 3.8+
```Python hl_lines="9 11 16 22 24 29-30 33-35 40-41"
-{!> ../../../docs_src/extra_models/tutorial001.py!}
+{!> ../../docs_src/extra_models/tutorial001.py!}
```
////
@@ -179,7 +179,7 @@ That way, we can declare just the differences between the models (with plaintext
//// tab | Python 3.10+
```Python hl_lines="7 13-14 17-18 21-22"
-{!> ../../../docs_src/extra_models/tutorial002_py310.py!}
+{!> ../../docs_src/extra_models/tutorial002_py310.py!}
```
////
@@ -187,7 +187,7 @@ That way, we can declare just the differences between the models (with plaintext
//// tab | Python 3.8+
```Python hl_lines="9 15-16 19-20 23-24"
-{!> ../../../docs_src/extra_models/tutorial002.py!}
+{!> ../../docs_src/extra_models/tutorial002.py!}
```
////
@@ -209,7 +209,7 @@ When defining a <a href="https://docs.pydantic.dev/latest/concepts/types/#unions
//// tab | Python 3.10+
```Python hl_lines="1 14-15 18-20 33"
-{!> ../../../docs_src/extra_models/tutorial003_py310.py!}
+{!> ../../docs_src/extra_models/tutorial003_py310.py!}
```
////
@@ -217,7 +217,7 @@ When defining a <a href="https://docs.pydantic.dev/latest/concepts/types/#unions
//// tab | Python 3.8+
```Python hl_lines="1 14-15 18-20 33"
-{!> ../../../docs_src/extra_models/tutorial003.py!}
+{!> ../../docs_src/extra_models/tutorial003.py!}
```
////
@@ -245,7 +245,7 @@ For that, use the standard Python `typing.List` (or just `list` in Python 3.9 an
//// tab | Python 3.9+
```Python hl_lines="18"
-{!> ../../../docs_src/extra_models/tutorial004_py39.py!}
+{!> ../../docs_src/extra_models/tutorial004_py39.py!}
```
////
@@ -253,7 +253,7 @@ For that, use the standard Python `typing.List` (or just `list` in Python 3.9 an
//// tab | Python 3.8+
```Python hl_lines="1 20"
-{!> ../../../docs_src/extra_models/tutorial004.py!}
+{!> ../../docs_src/extra_models/tutorial004.py!}
```
////
@@ -269,7 +269,7 @@ In this case, you can use `typing.Dict` (or just `dict` in Python 3.9 and above)
//// tab | Python 3.9+
```Python hl_lines="6"
-{!> ../../../docs_src/extra_models/tutorial005_py39.py!}
+{!> ../../docs_src/extra_models/tutorial005_py39.py!}
```
////
@@ -277,7 +277,7 @@ In this case, you can use `typing.Dict` (or just `dict` in Python 3.9 and above)
//// tab | Python 3.8+
```Python hl_lines="1 8"
-{!> ../../../docs_src/extra_models/tutorial005.py!}
+{!> ../../docs_src/extra_models/tutorial005.py!}
```
////
diff --git a/docs/en/docs/tutorial/first-steps.md b/docs/en/docs/tutorial/first-steps.md
index b48a0ee38..77728cebe 100644
--- a/docs/en/docs/tutorial/first-steps.md
+++ b/docs/en/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
The simplest FastAPI file could look like this:
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Copy that to a file `main.py`.
@@ -158,7 +158,7 @@ You could also use it to generate code automatically, for clients that communica
### Step 1: import `FastAPI`
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI` is a Python class that provides all the functionality for your API.
@@ -174,7 +174,7 @@ You can use all the <a href="https://www.starlette.io/" class="external-link" ta
### Step 2: create a `FastAPI` "instance"
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Here the `app` variable will be an "instance" of the class `FastAPI`.
@@ -245,7 +245,7 @@ We are going to call them "**operations**" too.
#### Define a *path operation decorator*
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
The `@app.get("/")` tells **FastAPI** that the function right below is in charge of handling requests that go to:
@@ -301,7 +301,7 @@ This is our "**path operation function**":
* **function**: is the function below the "decorator" (below `@app.get("/")`).
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
This is a Python function.
@@ -315,7 +315,7 @@ In this case, it is an `async` function.
You could also define it as a normal function instead of `async def`:
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note
@@ -327,7 +327,7 @@ If you don't know the difference, check the [Async: *"In a hurry?"*](../async.md
### Step 5: return the content
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
You can return a `dict`, `list`, singular values as `str`, `int`, etc.
diff --git a/docs/en/docs/tutorial/handling-errors.md b/docs/en/docs/tutorial/handling-errors.md
index 14a3cf998..38c15761b 100644
--- a/docs/en/docs/tutorial/handling-errors.md
+++ b/docs/en/docs/tutorial/handling-errors.md
@@ -26,7 +26,7 @@ To return HTTP responses with errors to the client you use `HTTPException`.
### Import `HTTPException`
```Python hl_lines="1"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
### Raise an `HTTPException` in your code
@@ -42,7 +42,7 @@ The benefit of raising an exception over `return`ing a value will be more eviden
In this example, when the client requests an item by an ID that doesn't exist, raise an exception with a status code of `404`:
```Python hl_lines="11"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
### The resulting response
@@ -82,7 +82,7 @@ You probably won't need to use it directly in your code.
But in case you needed it for an advanced scenario, you can add custom headers:
```Python hl_lines="14"
-{!../../../docs_src/handling_errors/tutorial002.py!}
+{!../../docs_src/handling_errors/tutorial002.py!}
```
## Install custom exception handlers
@@ -96,7 +96,7 @@ And you want to handle this exception globally with FastAPI.
You could add a custom exception handler with `@app.exception_handler()`:
```Python hl_lines="5-7 13-18 24"
-{!../../../docs_src/handling_errors/tutorial003.py!}
+{!../../docs_src/handling_errors/tutorial003.py!}
```
Here, if you request `/unicorns/yolo`, the *path operation* will `raise` a `UnicornException`.
@@ -136,7 +136,7 @@ To override it, import the `RequestValidationError` and use it with `@app.except
The exception handler will receive a `Request` and the exception.
```Python hl_lines="2 14-16"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
Now, if you go to `/items/foo`, instead of getting the default JSON error with:
@@ -189,7 +189,7 @@ The same way, you can override the `HTTPException` handler.
For example, you could want to return a plain text response instead of JSON for these errors:
```Python hl_lines="3-4 9-11 22"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
/// note | "Technical Details"
@@ -207,7 +207,7 @@ The `RequestValidationError` contains the `body` it received with invalid data.
You could use it while developing your app to log the body and debug it, return it to the user, etc.
```Python hl_lines="14"
-{!../../../docs_src/handling_errors/tutorial005.py!}
+{!../../docs_src/handling_errors/tutorial005.py!}
```
Now try sending an invalid item like:
@@ -265,7 +265,7 @@ from starlette.exceptions import HTTPException as StarletteHTTPException
If you want to use the exception along with the same default exception handlers from **FastAPI**, you can import and reuse the default exception handlers from `fastapi.exception_handlers`:
```Python hl_lines="2-5 15 21"
-{!../../../docs_src/handling_errors/tutorial006.py!}
+{!../../docs_src/handling_errors/tutorial006.py!}
```
In this example you are just `print`ing the error with a very expressive message, but you get the idea. You can use the exception and then just reuse the default exception handlers.
diff --git a/docs/en/docs/tutorial/header-param-models.md b/docs/en/docs/tutorial/header-param-models.md
index 8deb0a455..78517e498 100644
--- a/docs/en/docs/tutorial/header-param-models.md
+++ b/docs/en/docs/tutorial/header-param-models.md
@@ -17,7 +17,7 @@ Declare the **header parameters** that you need in a **Pydantic model**, and the
//// tab | Python 3.10+
```Python hl_lines="9-14 18"
-{!> ../../../docs_src/header_param_models/tutorial001_an_py310.py!}
+{!> ../../docs_src/header_param_models/tutorial001_an_py310.py!}
```
////
@@ -25,7 +25,7 @@ Declare the **header parameters** that you need in a **Pydantic model**, and the
//// tab | Python 3.9+
```Python hl_lines="9-14 18"
-{!> ../../../docs_src/header_param_models/tutorial001_an_py39.py!}
+{!> ../../docs_src/header_param_models/tutorial001_an_py39.py!}
```
////
@@ -33,7 +33,7 @@ Declare the **header parameters** that you need in a **Pydantic model**, and the
//// tab | Python 3.8+
```Python hl_lines="10-15 19"
-{!> ../../../docs_src/header_param_models/tutorial001_an.py!}
+{!> ../../docs_src/header_param_models/tutorial001_an.py!}
```
////
@@ -47,7 +47,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7-12 16"
-{!> ../../../docs_src/header_param_models/tutorial001_py310.py!}
+{!> ../../docs_src/header_param_models/tutorial001_py310.py!}
```
////
@@ -61,7 +61,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9-14 18"
-{!> ../../../docs_src/header_param_models/tutorial001_py39.py!}
+{!> ../../docs_src/header_param_models/tutorial001_py39.py!}
```
////
@@ -75,7 +75,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7-12 16"
-{!> ../../../docs_src/header_param_models/tutorial001_py310.py!}
+{!> ../../docs_src/header_param_models/tutorial001_py310.py!}
```
////
@@ -99,7 +99,7 @@ You can use Pydantic's model configuration to `forbid` any `extra` fields:
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/header_param_models/tutorial002_an_py310.py!}
+{!> ../../docs_src/header_param_models/tutorial002_an_py310.py!}
```
////
@@ -107,7 +107,7 @@ You can use Pydantic's model configuration to `forbid` any `extra` fields:
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/header_param_models/tutorial002_an_py39.py!}
+{!> ../../docs_src/header_param_models/tutorial002_an_py39.py!}
```
////
@@ -115,7 +115,7 @@ You can use Pydantic's model configuration to `forbid` any `extra` fields:
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/header_param_models/tutorial002_an.py!}
+{!> ../../docs_src/header_param_models/tutorial002_an.py!}
```
////
@@ -129,7 +129,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8"
-{!> ../../../docs_src/header_param_models/tutorial002_py310.py!}
+{!> ../../docs_src/header_param_models/tutorial002_py310.py!}
```
////
@@ -143,7 +143,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/header_param_models/tutorial002_py39.py!}
+{!> ../../docs_src/header_param_models/tutorial002_py39.py!}
```
////
@@ -157,7 +157,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/header_param_models/tutorial002.py!}
+{!> ../../docs_src/header_param_models/tutorial002.py!}
```
////
diff --git a/docs/en/docs/tutorial/header-params.md b/docs/en/docs/tutorial/header-params.md
index 2e07fe0e6..293de897f 100644
--- a/docs/en/docs/tutorial/header-params.md
+++ b/docs/en/docs/tutorial/header-params.md
@@ -9,7 +9,7 @@ First import `Header`:
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ First import `Header`:
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ First import `Header`:
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001_an.py!}
+{!> ../../docs_src/header_params/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1"
-{!> ../../../docs_src/header_params/tutorial001_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001.py!}
+{!> ../../docs_src/header_params/tutorial001.py!}
```
////
@@ -67,7 +67,7 @@ You can define the default value as well as all the extra validation or annotati
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py310.py!}
```
////
@@ -75,7 +75,7 @@ You can define the default value as well as all the extra validation or annotati
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py39.py!}
```
////
@@ -83,7 +83,7 @@ You can define the default value as well as all the extra validation or annotati
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial001_an.py!}
+{!> ../../docs_src/header_params/tutorial001_an.py!}
```
////
@@ -97,7 +97,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/header_params/tutorial001_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_py310.py!}
```
////
@@ -111,7 +111,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001.py!}
+{!> ../../docs_src/header_params/tutorial001.py!}
```
////
@@ -149,7 +149,7 @@ If for some reason you need to disable automatic conversion of underscores to hy
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial002_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial002_an_py310.py!}
```
////
@@ -157,7 +157,7 @@ If for some reason you need to disable automatic conversion of underscores to hy
//// tab | Python 3.9+
```Python hl_lines="11"
-{!> ../../../docs_src/header_params/tutorial002_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial002_an_py39.py!}
```
////
@@ -165,7 +165,7 @@ If for some reason you need to disable automatic conversion of underscores to hy
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/header_params/tutorial002_an.py!}
+{!> ../../docs_src/header_params/tutorial002_an.py!}
```
////
@@ -179,7 +179,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8"
-{!> ../../../docs_src/header_params/tutorial002_py310.py!}
+{!> ../../docs_src/header_params/tutorial002_py310.py!}
```
////
@@ -193,7 +193,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial002.py!}
+{!> ../../docs_src/header_params/tutorial002.py!}
```
////
@@ -217,7 +217,7 @@ For example, to declare a header of `X-Token` that can appear more than once, yo
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial003_an_py310.py!}
```
////
@@ -225,7 +225,7 @@ For example, to declare a header of `X-Token` that can appear more than once, yo
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial003_an_py39.py!}
```
////
@@ -233,7 +233,7 @@ For example, to declare a header of `X-Token` that can appear more than once, yo
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial003_an.py!}
+{!> ../../docs_src/header_params/tutorial003_an.py!}
```
////
@@ -247,7 +247,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/header_params/tutorial003_py310.py!}
+{!> ../../docs_src/header_params/tutorial003_py310.py!}
```
////
@@ -261,7 +261,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_py39.py!}
+{!> ../../docs_src/header_params/tutorial003_py39.py!}
```
////
@@ -275,7 +275,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003.py!}
+{!> ../../docs_src/header_params/tutorial003.py!}
```
////
diff --git a/docs/en/docs/tutorial/metadata.md b/docs/en/docs/tutorial/metadata.md
index c62509b8b..715bb999a 100644
--- a/docs/en/docs/tutorial/metadata.md
+++ b/docs/en/docs/tutorial/metadata.md
@@ -19,7 +19,7 @@ You can set the following fields that are used in the OpenAPI specification and
You can set them as follows:
```Python hl_lines="3-16 19-32"
-{!../../../docs_src/metadata/tutorial001.py!}
+{!../../docs_src/metadata/tutorial001.py!}
```
/// tip
@@ -39,7 +39,7 @@ Since OpenAPI 3.1.0 and FastAPI 0.99.0, you can also set the `license_info` with
For example:
```Python hl_lines="31"
-{!../../../docs_src/metadata/tutorial001_1.py!}
+{!../../docs_src/metadata/tutorial001_1.py!}
```
## Metadata for tags
@@ -63,7 +63,7 @@ Let's try that in an example with tags for `users` and `items`.
Create metadata for your tags and pass it to the `openapi_tags` parameter:
```Python hl_lines="3-16 18"
-{!../../../docs_src/metadata/tutorial004.py!}
+{!../../docs_src/metadata/tutorial004.py!}
```
Notice that you can use Markdown inside of the descriptions, for example "login" will be shown in bold (**login**) and "fancy" will be shown in italics (_fancy_).
@@ -79,7 +79,7 @@ You don't have to add metadata for all the tags that you use.
Use the `tags` parameter with your *path operations* (and `APIRouter`s) to assign them to different tags:
```Python hl_lines="21 26"
-{!../../../docs_src/metadata/tutorial004.py!}
+{!../../docs_src/metadata/tutorial004.py!}
```
/// info
@@ -109,7 +109,7 @@ But you can configure it with the parameter `openapi_url`.
For example, to set it to be served at `/api/v1/openapi.json`:
```Python hl_lines="3"
-{!../../../docs_src/metadata/tutorial002.py!}
+{!../../docs_src/metadata/tutorial002.py!}
```
If you want to disable the OpenAPI schema completely you can set `openapi_url=None`, that will also disable the documentation user interfaces that use it.
@@ -128,5 +128,5 @@ You can configure the two documentation user interfaces included:
For example, to set Swagger UI to be served at `/documentation` and disable ReDoc:
```Python hl_lines="3"
-{!../../../docs_src/metadata/tutorial003.py!}
+{!../../docs_src/metadata/tutorial003.py!}
```
diff --git a/docs/en/docs/tutorial/middleware.md b/docs/en/docs/tutorial/middleware.md
index 199b593d3..7c4954c7b 100644
--- a/docs/en/docs/tutorial/middleware.md
+++ b/docs/en/docs/tutorial/middleware.md
@@ -32,7 +32,7 @@ The middleware function receives:
* You can then further modify the `response` before returning it.
```Python hl_lines="8-9 11 14"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
/// tip
@@ -60,7 +60,7 @@ And also after the `response` is generated, before returning it.
For example, you could add a custom header `X-Process-Time` containing the time in seconds that it took to process the request and generate a response:
```Python hl_lines="10 12-13"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
/// tip
diff --git a/docs/en/docs/tutorial/path-operation-configuration.md b/docs/en/docs/tutorial/path-operation-configuration.md
index a1a4953a6..4ca6ebf13 100644
--- a/docs/en/docs/tutorial/path-operation-configuration.md
+++ b/docs/en/docs/tutorial/path-operation-configuration.md
@@ -19,7 +19,7 @@ But if you don't remember what each number code is for, you can use the shortcut
//// tab | Python 3.10+
```Python hl_lines="1 15"
-{!> ../../../docs_src/path_operation_configuration/tutorial001_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001_py310.py!}
```
////
@@ -27,7 +27,7 @@ But if you don't remember what each number code is for, you can use the shortcut
//// tab | Python 3.9+
```Python hl_lines="3 17"
-{!> ../../../docs_src/path_operation_configuration/tutorial001_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001_py39.py!}
```
////
@@ -35,7 +35,7 @@ But if you don't remember what each number code is for, you can use the shortcut
//// tab | Python 3.8+
```Python hl_lines="3 17"
-{!> ../../../docs_src/path_operation_configuration/tutorial001.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001.py!}
```
////
@@ -57,7 +57,7 @@ You can add tags to your *path operation*, pass the parameter `tags` with a `lis
//// tab | Python 3.10+
```Python hl_lines="15 20 25"
-{!> ../../../docs_src/path_operation_configuration/tutorial002_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002_py310.py!}
```
////
@@ -65,7 +65,7 @@ You can add tags to your *path operation*, pass the parameter `tags` with a `lis
//// tab | Python 3.9+
```Python hl_lines="17 22 27"
-{!> ../../../docs_src/path_operation_configuration/tutorial002_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002_py39.py!}
```
////
@@ -73,7 +73,7 @@ You can add tags to your *path operation*, pass the parameter `tags` with a `lis
//// tab | Python 3.8+
```Python hl_lines="17 22 27"
-{!> ../../../docs_src/path_operation_configuration/tutorial002.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002.py!}
```
////
@@ -91,7 +91,7 @@ In these cases, it could make sense to store the tags in an `Enum`.
**FastAPI** supports that the same way as with plain strings:
```Python hl_lines="1 8-10 13 18"
-{!../../../docs_src/path_operation_configuration/tutorial002b.py!}
+{!../../docs_src/path_operation_configuration/tutorial002b.py!}
```
## Summary and description
@@ -101,7 +101,7 @@ You can add a `summary` and `description`:
//// tab | Python 3.10+
```Python hl_lines="18-19"
-{!> ../../../docs_src/path_operation_configuration/tutorial003_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003_py310.py!}
```
////
@@ -109,7 +109,7 @@ You can add a `summary` and `description`:
//// tab | Python 3.9+
```Python hl_lines="20-21"
-{!> ../../../docs_src/path_operation_configuration/tutorial003_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003_py39.py!}
```
////
@@ -117,7 +117,7 @@ You can add a `summary` and `description`:
//// tab | Python 3.8+
```Python hl_lines="20-21"
-{!> ../../../docs_src/path_operation_configuration/tutorial003.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003.py!}
```
////
@@ -131,7 +131,7 @@ You can write <a href="https://en.wikipedia.org/wiki/Markdown" class="external-l
//// tab | Python 3.10+
```Python hl_lines="17-25"
-{!> ../../../docs_src/path_operation_configuration/tutorial004_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004_py310.py!}
```
////
@@ -139,7 +139,7 @@ You can write <a href="https://en.wikipedia.org/wiki/Markdown" class="external-l
//// tab | Python 3.9+
```Python hl_lines="19-27"
-{!> ../../../docs_src/path_operation_configuration/tutorial004_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004_py39.py!}
```
////
@@ -147,7 +147,7 @@ You can write <a href="https://en.wikipedia.org/wiki/Markdown" class="external-l
//// tab | Python 3.8+
```Python hl_lines="19-27"
-{!> ../../../docs_src/path_operation_configuration/tutorial004.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004.py!}
```
////
@@ -163,7 +163,7 @@ You can specify the response description with the parameter `response_descriptio
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/path_operation_configuration/tutorial005_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005_py310.py!}
```
////
@@ -171,7 +171,7 @@ You can specify the response description with the parameter `response_descriptio
//// tab | Python 3.9+
```Python hl_lines="21"
-{!> ../../../docs_src/path_operation_configuration/tutorial005_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005_py39.py!}
```
////
@@ -179,7 +179,7 @@ You can specify the response description with the parameter `response_descriptio
//// tab | Python 3.8+
```Python hl_lines="21"
-{!> ../../../docs_src/path_operation_configuration/tutorial005.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005.py!}
```
////
@@ -205,7 +205,7 @@ So, if you don't provide one, **FastAPI** will automatically generate one of "Su
If you need to mark a *path operation* as <abbr title="obsolete, recommended not to use it">deprecated</abbr>, but without removing it, pass the parameter `deprecated`:
```Python hl_lines="16"
-{!../../../docs_src/path_operation_configuration/tutorial006.py!}
+{!../../docs_src/path_operation_configuration/tutorial006.py!}
```
It will be clearly marked as deprecated in the interactive docs:
diff --git a/docs/en/docs/tutorial/path-params-numeric-validations.md b/docs/en/docs/tutorial/path-params-numeric-validations.md
index bd835d0d4..9ddf49ea9 100644
--- a/docs/en/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/en/docs/tutorial/path-params-numeric-validations.md
@@ -9,7 +9,7 @@ First, import `Path` from `fastapi`, and import `Annotated`:
//// tab | Python 3.10+
```Python hl_lines="1 3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ First, import `Path` from `fastapi`, and import `Annotated`:
//// tab | Python 3.9+
```Python hl_lines="1 3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ First, import `Path` from `fastapi`, and import `Annotated`:
//// tab | Python 3.8+
```Python hl_lines="3-4"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -77,7 +77,7 @@ For example, to declare a `title` metadata value for the path parameter `item_id
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
```
////
@@ -85,7 +85,7 @@ For example, to declare a `title` metadata value for the path parameter `item_id
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
```
////
@@ -93,7 +93,7 @@ For example, to declare a `title` metadata value for the path parameter `item_id
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
```
////
@@ -107,7 +107,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -121,7 +121,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -163,7 +163,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial002.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial002.py!}
```
////
@@ -173,7 +173,7 @@ But keep in mind that if you use `Annotated`, you won't have this problem, it wo
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
```
////
@@ -181,7 +181,7 @@ But keep in mind that if you use `Annotated`, you won't have this problem, it wo
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
```
////
@@ -210,7 +210,7 @@ Pass `*`, as the first parameter of the function.
Python won't do anything with that `*`, but it will know that all the following parameters should be called as keyword arguments (key-value pairs), also known as <abbr title="From: K-ey W-ord Arg-uments"><code>kwargs</code></abbr>. Even if they don't have a default value.
```Python hl_lines="7"
-{!../../../docs_src/path_params_numeric_validations/tutorial003.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial003.py!}
```
### Better with `Annotated`
@@ -220,7 +220,7 @@ Keep in mind that if you use `Annotated`, as you are not using function paramete
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
```
////
@@ -228,7 +228,7 @@ Keep in mind that if you use `Annotated`, as you are not using function paramete
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
```
////
@@ -242,7 +242,7 @@ Here, with `ge=1`, `item_id` will need to be an integer number "`g`reater than o
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
```
////
@@ -250,7 +250,7 @@ Here, with `ge=1`, `item_id` will need to be an integer number "`g`reater than o
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
```
////
@@ -264,7 +264,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004.py!}
```
////
@@ -279,7 +279,7 @@ The same applies for:
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
```
////
@@ -287,7 +287,7 @@ The same applies for:
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
```
////
@@ -301,7 +301,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial005.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial005.py!}
```
////
@@ -319,7 +319,7 @@ And the same for <abbr title="less than"><code>lt</code></abbr>.
//// tab | Python 3.9+
```Python hl_lines="13"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
```
////
@@ -327,7 +327,7 @@ And the same for <abbr title="less than"><code>lt</code></abbr>.
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
```
////
@@ -341,7 +341,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="11"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial006.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial006.py!}
```
////
diff --git a/docs/en/docs/tutorial/path-params.md b/docs/en/docs/tutorial/path-params.md
index a87a29e08..fd9e74585 100644
--- a/docs/en/docs/tutorial/path-params.md
+++ b/docs/en/docs/tutorial/path-params.md
@@ -3,7 +3,7 @@
You can declare path "parameters" or "variables" with the same syntax used by Python format strings:
```Python hl_lines="6-7"
-{!../../../docs_src/path_params/tutorial001.py!}
+{!../../docs_src/path_params/tutorial001.py!}
```
The value of the path parameter `item_id` will be passed to your function as the argument `item_id`.
@@ -19,7 +19,7 @@ So, if you run this example and go to <a href="http://127.0.0.1:8000/items/foo"
You can declare the type of a path parameter in the function, using standard Python type annotations:
```Python hl_lines="7"
-{!../../../docs_src/path_params/tutorial002.py!}
+{!../../docs_src/path_params/tutorial002.py!}
```
In this case, `item_id` is declared to be an `int`.
@@ -124,7 +124,7 @@ And then you can also have a path `/users/{user_id}` to get data about a specifi
Because *path operations* are evaluated in order, you need to make sure that the path for `/users/me` is declared before the one for `/users/{user_id}`:
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003.py!}
+{!../../docs_src/path_params/tutorial003.py!}
```
Otherwise, the path for `/users/{user_id}` would match also for `/users/me`, "thinking" that it's receiving a parameter `user_id` with a value of `"me"`.
@@ -132,7 +132,7 @@ Otherwise, the path for `/users/{user_id}` would match also for `/users/me`, "th
Similarly, you cannot redefine a path operation:
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003b.py!}
+{!../../docs_src/path_params/tutorial003b.py!}
```
The first one will always be used since the path matches first.
@@ -150,7 +150,7 @@ By inheriting from `str` the API docs will be able to know that the values must
Then create class attributes with fixed values, which will be the available valid values:
```Python hl_lines="1 6-9"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// info
@@ -170,7 +170,7 @@ If you are wondering, "AlexNet", "ResNet", and "LeNet" are just names of Machine
Then create a *path parameter* with a type annotation using the enum class you created (`ModelName`):
```Python hl_lines="16"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
### Check the docs
@@ -188,7 +188,7 @@ The value of the *path parameter* will be an *enumeration member*.
You can compare it with the *enumeration member* in your created enum `ModelName`:
```Python hl_lines="17"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
#### Get the *enumeration value*
@@ -196,7 +196,7 @@ You can compare it with the *enumeration member* in your created enum `ModelName
You can get the actual value (a `str` in this case) using `model_name.value`, or in general, `your_enum_member.value`:
```Python hl_lines="20"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// tip
@@ -212,7 +212,7 @@ You can return *enum members* from your *path operation*, even nested in a JSON
They will be converted to their corresponding values (strings in this case) before returning them to the client:
```Python hl_lines="18 21 23"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
In your client you will get a JSON response like:
@@ -253,7 +253,7 @@ In this case, the name of the parameter is `file_path`, and the last part, `:pat
So, you can use it with:
```Python hl_lines="6"
-{!../../../docs_src/path_params/tutorial004.py!}
+{!../../docs_src/path_params/tutorial004.py!}
```
/// tip
diff --git a/docs/en/docs/tutorial/query-param-models.md b/docs/en/docs/tutorial/query-param-models.md
index 02e36dc0f..f7ce345b2 100644
--- a/docs/en/docs/tutorial/query-param-models.md
+++ b/docs/en/docs/tutorial/query-param-models.md
@@ -17,7 +17,7 @@ Declare the **query parameters** that you need in a **Pydantic model**, and then
//// tab | Python 3.10+
```Python hl_lines="9-13 17"
-{!> ../../../docs_src/query_param_models/tutorial001_an_py310.py!}
+{!> ../../docs_src/query_param_models/tutorial001_an_py310.py!}
```
////
@@ -25,7 +25,7 @@ Declare the **query parameters** that you need in a **Pydantic model**, and then
//// tab | Python 3.9+
```Python hl_lines="8-12 16"
-{!> ../../../docs_src/query_param_models/tutorial001_an_py39.py!}
+{!> ../../docs_src/query_param_models/tutorial001_an_py39.py!}
```
////
@@ -33,7 +33,7 @@ Declare the **query parameters** that you need in a **Pydantic model**, and then
//// tab | Python 3.8+
```Python hl_lines="10-14 18"
-{!> ../../../docs_src/query_param_models/tutorial001_an.py!}
+{!> ../../docs_src/query_param_models/tutorial001_an.py!}
```
////
@@ -47,7 +47,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9-13 17"
-{!> ../../../docs_src/query_param_models/tutorial001_py310.py!}
+{!> ../../docs_src/query_param_models/tutorial001_py310.py!}
```
////
@@ -61,7 +61,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8-12 16"
-{!> ../../../docs_src/query_param_models/tutorial001_py39.py!}
+{!> ../../docs_src/query_param_models/tutorial001_py39.py!}
```
////
@@ -75,7 +75,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9-13 17"
-{!> ../../../docs_src/query_param_models/tutorial001_py310.py!}
+{!> ../../docs_src/query_param_models/tutorial001_py310.py!}
```
////
@@ -99,7 +99,7 @@ You can use Pydantic's model configuration to `forbid` any `extra` fields:
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/query_param_models/tutorial002_an_py310.py!}
+{!> ../../docs_src/query_param_models/tutorial002_an_py310.py!}
```
////
@@ -107,7 +107,7 @@ You can use Pydantic's model configuration to `forbid` any `extra` fields:
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_param_models/tutorial002_an_py39.py!}
+{!> ../../docs_src/query_param_models/tutorial002_an_py39.py!}
```
////
@@ -115,7 +115,7 @@ You can use Pydantic's model configuration to `forbid` any `extra` fields:
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/query_param_models/tutorial002_an.py!}
+{!> ../../docs_src/query_param_models/tutorial002_an.py!}
```
////
@@ -129,7 +129,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/query_param_models/tutorial002_py310.py!}
+{!> ../../docs_src/query_param_models/tutorial002_py310.py!}
```
////
@@ -143,7 +143,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_param_models/tutorial002_py39.py!}
+{!> ../../docs_src/query_param_models/tutorial002_py39.py!}
```
////
@@ -157,7 +157,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="11"
-{!> ../../../docs_src/query_param_models/tutorial002.py!}
+{!> ../../docs_src/query_param_models/tutorial002.py!}
```
////
diff --git a/docs/en/docs/tutorial/query-params-str-validations.md b/docs/en/docs/tutorial/query-params-str-validations.md
index dd101a2a6..12778d7fe 100644
--- a/docs/en/docs/tutorial/query-params-str-validations.md
+++ b/docs/en/docs/tutorial/query-params-str-validations.md
@@ -7,7 +7,7 @@ Let's take this application as example:
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial001_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial001_py310.py!}
```
////
@@ -15,7 +15,7 @@ Let's take this application as example:
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial001.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial001.py!}
```
////
@@ -46,7 +46,7 @@ To achieve that, first import:
In Python 3.9 or above, `Annotated` is part of the standard library, so you can import it from `typing`.
```Python hl_lines="1 3"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
```
////
@@ -58,7 +58,7 @@ In versions of Python below Python 3.9 you import `Annotated` from `typing_exten
It will already be installed with FastAPI.
```Python hl_lines="3-4"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_an.py!}
```
////
@@ -126,7 +126,7 @@ Now that we have this `Annotated` where we can put more information (in this cas
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
```
////
@@ -134,7 +134,7 @@ Now that we have this `Annotated` where we can put more information (in this cas
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_an.py!}
```
////
@@ -170,7 +170,7 @@ This is how you would use `Query()` as the default value of your function parame
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_py310.py!}
```
////
@@ -178,7 +178,7 @@ This is how you would use `Query()` as the default value of your function parame
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002.py!}
```
////
@@ -284,7 +284,7 @@ You can also add a parameter `min_length`:
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial003_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003_an_py310.py!}
```
////
@@ -292,7 +292,7 @@ You can also add a parameter `min_length`:
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial003_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003_an_py39.py!}
```
////
@@ -300,7 +300,7 @@ You can also add a parameter `min_length`:
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial003_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003_an.py!}
```
////
@@ -314,7 +314,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial003_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003_py310.py!}
```
////
@@ -328,7 +328,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial003.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003.py!}
```
////
@@ -340,7 +340,7 @@ You can define a <abbr title="A regular expression, regex or regexp is a sequenc
//// tab | Python 3.10+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_an_py310.py!}
```
////
@@ -348,7 +348,7 @@ You can define a <abbr title="A regular expression, regex or regexp is a sequenc
//// tab | Python 3.9+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_an_py39.py!}
```
////
@@ -356,7 +356,7 @@ You can define a <abbr title="A regular expression, regex or regexp is a sequenc
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_an.py!}
```
////
@@ -370,7 +370,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_py310.py!}
```
////
@@ -384,7 +384,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial004.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004.py!}
```
////
@@ -408,7 +408,7 @@ You could still see some code using it:
//// tab | Python 3.10+ Pydantic v1
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_an_py310_regex.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_an_py310_regex.py!}
```
////
@@ -424,7 +424,7 @@ Let's say that you want to declare the `q` query parameter to have a `min_length
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial005_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial005_an_py39.py!}
```
////
@@ -432,7 +432,7 @@ Let's say that you want to declare the `q` query parameter to have a `min_length
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial005_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial005_an.py!}
```
////
@@ -446,7 +446,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial005.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial005.py!}
```
////
@@ -494,7 +494,7 @@ So, when you need to declare a value as required while using `Query`, you can si
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006_an_py39.py!}
```
////
@@ -502,7 +502,7 @@ So, when you need to declare a value as required while using `Query`, you can si
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial006_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006_an.py!}
```
////
@@ -516,7 +516,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial006.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006.py!}
```
/// tip
@@ -536,7 +536,7 @@ There's an alternative way to explicitly declare that a value is required. You c
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006b_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006b_an_py39.py!}
```
////
@@ -544,7 +544,7 @@ There's an alternative way to explicitly declare that a value is required. You c
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial006b_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006b_an.py!}
```
////
@@ -558,7 +558,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial006b.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006b.py!}
```
////
@@ -582,7 +582,7 @@ To do that, you can declare that `None` is a valid type but still use `...` as t
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c_an_py310.py!}
```
////
@@ -590,7 +590,7 @@ To do that, you can declare that `None` is a valid type but still use `...` as t
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c_an_py39.py!}
```
////
@@ -598,7 +598,7 @@ To do that, you can declare that `None` is a valid type but still use `...` as t
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c_an.py!}
```
////
@@ -612,7 +612,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c_py310.py!}
```
////
@@ -626,7 +626,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c.py!}
```
////
@@ -652,7 +652,7 @@ For example, to declare a query parameter `q` that can appear multiple times in
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_an_py310.py!}
```
////
@@ -660,7 +660,7 @@ For example, to declare a query parameter `q` that can appear multiple times in
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_an_py39.py!}
```
////
@@ -668,7 +668,7 @@ For example, to declare a query parameter `q` that can appear multiple times in
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_an.py!}
```
////
@@ -682,7 +682,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_py310.py!}
```
////
@@ -696,7 +696,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_py39.py!}
```
////
@@ -710,7 +710,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011.py!}
```
////
@@ -751,7 +751,7 @@ And you can also define a default `list` of values if none are provided:
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial012_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012_an_py39.py!}
```
////
@@ -759,7 +759,7 @@ And you can also define a default `list` of values if none are provided:
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial012_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012_an.py!}
```
////
@@ -773,7 +773,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial012_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012_py39.py!}
```
////
@@ -787,7 +787,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial012.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012.py!}
```
////
@@ -816,7 +816,7 @@ You can also use `list` directly instead of `List[str]` (or `list[str]` in Pytho
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial013_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial013_an_py39.py!}
```
////
@@ -824,7 +824,7 @@ You can also use `list` directly instead of `List[str]` (or `list[str]` in Pytho
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial013_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial013_an.py!}
```
////
@@ -838,7 +838,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial013.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial013.py!}
```
////
@@ -870,7 +870,7 @@ You can add a `title`:
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial007_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007_an_py310.py!}
```
////
@@ -878,7 +878,7 @@ You can add a `title`:
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial007_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007_an_py39.py!}
```
////
@@ -886,7 +886,7 @@ You can add a `title`:
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial007_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007_an.py!}
```
////
@@ -900,7 +900,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial007_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007_py310.py!}
```
////
@@ -914,7 +914,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial007.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007.py!}
```
////
@@ -924,7 +924,7 @@ And a `description`:
//// tab | Python 3.10+
```Python hl_lines="14"
-{!> ../../../docs_src/query_params_str_validations/tutorial008_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008_an_py310.py!}
```
////
@@ -932,7 +932,7 @@ And a `description`:
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/query_params_str_validations/tutorial008_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008_an_py39.py!}
```
////
@@ -940,7 +940,7 @@ And a `description`:
//// tab | Python 3.8+
```Python hl_lines="15"
-{!> ../../../docs_src/query_params_str_validations/tutorial008_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008_an.py!}
```
////
@@ -954,7 +954,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial008_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008_py310.py!}
```
////
@@ -968,7 +968,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="13"
-{!> ../../../docs_src/query_params_str_validations/tutorial008.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008.py!}
```
////
@@ -994,7 +994,7 @@ Then you can declare an `alias`, and that alias is what will be used to find the
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial009_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009_an_py310.py!}
```
////
@@ -1002,7 +1002,7 @@ Then you can declare an `alias`, and that alias is what will be used to find the
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial009_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009_an_py39.py!}
```
////
@@ -1010,7 +1010,7 @@ Then you can declare an `alias`, and that alias is what will be used to find the
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial009_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009_an.py!}
```
////
@@ -1024,7 +1024,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial009_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009_py310.py!}
```
////
@@ -1038,7 +1038,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial009.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009.py!}
```
////
@@ -1054,7 +1054,7 @@ Then pass the parameter `deprecated=True` to `Query`:
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/query_params_str_validations/tutorial010_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010_an_py310.py!}
```
////
@@ -1062,7 +1062,7 @@ Then pass the parameter `deprecated=True` to `Query`:
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/query_params_str_validations/tutorial010_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010_an_py39.py!}
```
////
@@ -1070,7 +1070,7 @@ Then pass the parameter `deprecated=True` to `Query`:
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/query_params_str_validations/tutorial010_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010_an.py!}
```
////
@@ -1084,7 +1084,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="16"
-{!> ../../../docs_src/query_params_str_validations/tutorial010_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010_py310.py!}
```
////
@@ -1098,7 +1098,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="18"
-{!> ../../../docs_src/query_params_str_validations/tutorial010.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010.py!}
```
////
@@ -1114,7 +1114,7 @@ To exclude a query parameter from the generated OpenAPI schema (and thus, from t
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial014_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014_an_py310.py!}
```
////
@@ -1122,7 +1122,7 @@ To exclude a query parameter from the generated OpenAPI schema (and thus, from t
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial014_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014_an_py39.py!}
```
////
@@ -1130,7 +1130,7 @@ To exclude a query parameter from the generated OpenAPI schema (and thus, from t
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial014_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014_an.py!}
```
////
@@ -1144,7 +1144,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial014_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014_py310.py!}
```
////
@@ -1158,7 +1158,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial014.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014.py!}
```
////
diff --git a/docs/en/docs/tutorial/query-params.md b/docs/en/docs/tutorial/query-params.md
index a98ac9b28..0d31d453d 100644
--- a/docs/en/docs/tutorial/query-params.md
+++ b/docs/en/docs/tutorial/query-params.md
@@ -3,7 +3,7 @@
When you declare other function parameters that are not part of the path parameters, they are automatically interpreted as "query" parameters.
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial001.py!}
+{!../../docs_src/query_params/tutorial001.py!}
```
The query is the set of key-value pairs that go after the `?` in a URL, separated by `&` characters.
@@ -66,7 +66,7 @@ The same way, you can declare optional query parameters, by setting their defaul
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial002_py310.py!}
+{!> ../../docs_src/query_params/tutorial002_py310.py!}
```
////
@@ -74,7 +74,7 @@ The same way, you can declare optional query parameters, by setting their defaul
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial002.py!}
+{!> ../../docs_src/query_params/tutorial002.py!}
```
////
@@ -94,7 +94,7 @@ You can also declare `bool` types, and they will be converted:
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial003_py310.py!}
+{!> ../../docs_src/query_params/tutorial003_py310.py!}
```
////
@@ -102,7 +102,7 @@ You can also declare `bool` types, and they will be converted:
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial003.py!}
+{!> ../../docs_src/query_params/tutorial003.py!}
```
////
@@ -151,7 +151,7 @@ They will be detected by name:
//// tab | Python 3.10+
```Python hl_lines="6 8"
-{!> ../../../docs_src/query_params/tutorial004_py310.py!}
+{!> ../../docs_src/query_params/tutorial004_py310.py!}
```
////
@@ -159,7 +159,7 @@ They will be detected by name:
//// tab | Python 3.8+
```Python hl_lines="8 10"
-{!> ../../../docs_src/query_params/tutorial004.py!}
+{!> ../../docs_src/query_params/tutorial004.py!}
```
////
@@ -173,7 +173,7 @@ If you don't want to add a specific value but just make it optional, set the def
But when you want to make a query parameter required, you can just not declare any default value:
```Python hl_lines="6-7"
-{!../../../docs_src/query_params/tutorial005.py!}
+{!../../docs_src/query_params/tutorial005.py!}
```
Here the query parameter `needy` is a required query parameter of type `str`.
@@ -223,7 +223,7 @@ And of course, you can define some parameters as required, some as having a defa
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params/tutorial006_py310.py!}
+{!> ../../docs_src/query_params/tutorial006_py310.py!}
```
////
@@ -231,7 +231,7 @@ And of course, you can define some parameters as required, some as having a defa
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params/tutorial006.py!}
+{!> ../../docs_src/query_params/tutorial006.py!}
```
////
diff --git a/docs/en/docs/tutorial/request-files.md b/docs/en/docs/tutorial/request-files.md
index 9f19596a8..f3f1eb103 100644
--- a/docs/en/docs/tutorial/request-files.md
+++ b/docs/en/docs/tutorial/request-files.md
@@ -23,7 +23,7 @@ Import `File` and `UploadFile` from `fastapi`:
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
```
////
@@ -31,7 +31,7 @@ Import `File` and `UploadFile` from `fastapi`:
//// tab | Python 3.8+
```Python hl_lines="1"
-{!> ../../../docs_src/request_files/tutorial001_an.py!}
+{!> ../../docs_src/request_files/tutorial001_an.py!}
```
////
@@ -45,7 +45,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1"
-{!> ../../../docs_src/request_files/tutorial001.py!}
+{!> ../../docs_src/request_files/tutorial001.py!}
```
////
@@ -57,7 +57,7 @@ Create file parameters the same way you would for `Body` or `Form`:
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
```
////
@@ -65,7 +65,7 @@ Create file parameters the same way you would for `Body` or `Form`:
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/request_files/tutorial001_an.py!}
+{!> ../../docs_src/request_files/tutorial001_an.py!}
```
////
@@ -79,7 +79,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/request_files/tutorial001.py!}
+{!> ../../docs_src/request_files/tutorial001.py!}
```
////
@@ -113,7 +113,7 @@ Define a file parameter with a type of `UploadFile`:
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
```
////
@@ -121,7 +121,7 @@ Define a file parameter with a type of `UploadFile`:
//// tab | Python 3.8+
```Python hl_lines="13"
-{!> ../../../docs_src/request_files/tutorial001_an.py!}
+{!> ../../docs_src/request_files/tutorial001_an.py!}
```
////
@@ -135,7 +135,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="12"
-{!> ../../../docs_src/request_files/tutorial001.py!}
+{!> ../../docs_src/request_files/tutorial001.py!}
```
////
@@ -224,7 +224,7 @@ You can make a file optional by using standard type annotations and setting a de
//// tab | Python 3.10+
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02_an_py310.py!}
+{!> ../../docs_src/request_files/tutorial001_02_an_py310.py!}
```
////
@@ -232,7 +232,7 @@ You can make a file optional by using standard type annotations and setting a de
//// tab | Python 3.9+
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_02_an_py39.py!}
```
////
@@ -240,7 +240,7 @@ You can make a file optional by using standard type annotations and setting a de
//// tab | Python 3.8+
```Python hl_lines="10 18"
-{!> ../../../docs_src/request_files/tutorial001_02_an.py!}
+{!> ../../docs_src/request_files/tutorial001_02_an.py!}
```
////
@@ -254,7 +254,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7 15"
-{!> ../../../docs_src/request_files/tutorial001_02_py310.py!}
+{!> ../../docs_src/request_files/tutorial001_02_py310.py!}
```
////
@@ -268,7 +268,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02.py!}
+{!> ../../docs_src/request_files/tutorial001_02.py!}
```
////
@@ -280,7 +280,7 @@ You can also use `File()` with `UploadFile`, for example, to set additional meta
//// tab | Python 3.9+
```Python hl_lines="9 15"
-{!> ../../../docs_src/request_files/tutorial001_03_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_03_an_py39.py!}
```
////
@@ -288,7 +288,7 @@ You can also use `File()` with `UploadFile`, for example, to set additional meta
//// tab | Python 3.8+
```Python hl_lines="8 14"
-{!> ../../../docs_src/request_files/tutorial001_03_an.py!}
+{!> ../../docs_src/request_files/tutorial001_03_an.py!}
```
////
@@ -302,7 +302,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7 13"
-{!> ../../../docs_src/request_files/tutorial001_03.py!}
+{!> ../../docs_src/request_files/tutorial001_03.py!}
```
////
@@ -318,7 +318,7 @@ To use that, declare a list of `bytes` or `UploadFile`:
//// tab | Python 3.9+
```Python hl_lines="10 15"
-{!> ../../../docs_src/request_files/tutorial002_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial002_an_py39.py!}
```
////
@@ -326,7 +326,7 @@ To use that, declare a list of `bytes` or `UploadFile`:
//// tab | Python 3.8+
```Python hl_lines="11 16"
-{!> ../../../docs_src/request_files/tutorial002_an.py!}
+{!> ../../docs_src/request_files/tutorial002_an.py!}
```
////
@@ -340,7 +340,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8 13"
-{!> ../../../docs_src/request_files/tutorial002_py39.py!}
+{!> ../../docs_src/request_files/tutorial002_py39.py!}
```
////
@@ -354,7 +354,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10 15"
-{!> ../../../docs_src/request_files/tutorial002.py!}
+{!> ../../docs_src/request_files/tutorial002.py!}
```
////
@@ -376,7 +376,7 @@ And the same way as before, you can use `File()` to set additional parameters, e
//// tab | Python 3.9+
```Python hl_lines="11 18-20"
-{!> ../../../docs_src/request_files/tutorial003_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial003_an_py39.py!}
```
////
@@ -384,7 +384,7 @@ And the same way as before, you can use `File()` to set additional parameters, e
//// tab | Python 3.8+
```Python hl_lines="12 19-21"
-{!> ../../../docs_src/request_files/tutorial003_an.py!}
+{!> ../../docs_src/request_files/tutorial003_an.py!}
```
////
@@ -398,7 +398,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9 16"
-{!> ../../../docs_src/request_files/tutorial003_py39.py!}
+{!> ../../docs_src/request_files/tutorial003_py39.py!}
```
////
@@ -412,7 +412,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="11 18"
-{!> ../../../docs_src/request_files/tutorial003.py!}
+{!> ../../docs_src/request_files/tutorial003.py!}
```
////
diff --git a/docs/en/docs/tutorial/request-form-models.md b/docs/en/docs/tutorial/request-form-models.md
index 1440d17b8..f1142877a 100644
--- a/docs/en/docs/tutorial/request-form-models.md
+++ b/docs/en/docs/tutorial/request-form-models.md
@@ -27,7 +27,7 @@ You just need to declare a **Pydantic model** with the fields you want to receiv
//// tab | Python 3.9+
```Python hl_lines="9-11 15"
-{!> ../../../docs_src/request_form_models/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_form_models/tutorial001_an_py39.py!}
```
////
@@ -35,7 +35,7 @@ You just need to declare a **Pydantic model** with the fields you want to receiv
//// tab | Python 3.8+
```Python hl_lines="8-10 14"
-{!> ../../../docs_src/request_form_models/tutorial001_an.py!}
+{!> ../../docs_src/request_form_models/tutorial001_an.py!}
```
////
@@ -49,7 +49,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7-9 13"
-{!> ../../../docs_src/request_form_models/tutorial001.py!}
+{!> ../../docs_src/request_form_models/tutorial001.py!}
```
////
@@ -79,7 +79,7 @@ You can use Pydantic's model configuration to `forbid` any `extra` fields:
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/request_form_models/tutorial002_an_py39.py!}
+{!> ../../docs_src/request_form_models/tutorial002_an_py39.py!}
```
////
@@ -87,7 +87,7 @@ You can use Pydantic's model configuration to `forbid` any `extra` fields:
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/request_form_models/tutorial002_an.py!}
+{!> ../../docs_src/request_form_models/tutorial002_an.py!}
```
////
@@ -101,7 +101,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/request_form_models/tutorial002.py!}
+{!> ../../docs_src/request_form_models/tutorial002.py!}
```
////
diff --git a/docs/en/docs/tutorial/request-forms-and-files.md b/docs/en/docs/tutorial/request-forms-and-files.md
index 7830a2ba4..d60fc4c00 100644
--- a/docs/en/docs/tutorial/request-forms-and-files.md
+++ b/docs/en/docs/tutorial/request-forms-and-files.md
@@ -19,7 +19,7 @@ $ pip install python-multipart
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
```
////
@@ -27,7 +27,7 @@ $ pip install python-multipart
//// tab | Python 3.8+
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms_and_files/tutorial001_an.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001_an.py!}
```
////
@@ -41,7 +41,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001.py!}
```
////
@@ -53,7 +53,7 @@ Create file and form parameters the same way you would for `Body` or `Query`:
//// tab | Python 3.9+
```Python hl_lines="10-12"
-{!> ../../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
```
////
@@ -61,7 +61,7 @@ Create file and form parameters the same way you would for `Body` or `Query`:
//// tab | Python 3.8+
```Python hl_lines="9-11"
-{!> ../../../docs_src/request_forms_and_files/tutorial001_an.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001_an.py!}
```
////
@@ -75,7 +75,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8"
-{!> ../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001.py!}
```
////
diff --git a/docs/en/docs/tutorial/request-forms.md b/docs/en/docs/tutorial/request-forms.md
index 87cfdefbc..2ccc6886e 100644
--- a/docs/en/docs/tutorial/request-forms.md
+++ b/docs/en/docs/tutorial/request-forms.md
@@ -21,7 +21,7 @@ Import `Form` from `fastapi`:
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms/tutorial001_an_py39.py!}
```
////
@@ -29,7 +29,7 @@ Import `Form` from `fastapi`:
//// tab | Python 3.8+
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms/tutorial001_an.py!}
+{!> ../../docs_src/request_forms/tutorial001_an.py!}
```
////
@@ -43,7 +43,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms/tutorial001.py!}
+{!> ../../docs_src/request_forms/tutorial001.py!}
```
////
@@ -55,7 +55,7 @@ Create form parameters the same way you would for `Body` or `Query`:
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms/tutorial001_an_py39.py!}
```
////
@@ -63,7 +63,7 @@ Create form parameters the same way you would for `Body` or `Query`:
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/request_forms/tutorial001_an.py!}
+{!> ../../docs_src/request_forms/tutorial001_an.py!}
```
////
@@ -77,7 +77,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/request_forms/tutorial001.py!}
+{!> ../../docs_src/request_forms/tutorial001.py!}
```
////
diff --git a/docs/en/docs/tutorial/response-model.md b/docs/en/docs/tutorial/response-model.md
index 6a2093e6d..36ccfc4ce 100644
--- a/docs/en/docs/tutorial/response-model.md
+++ b/docs/en/docs/tutorial/response-model.md
@@ -7,7 +7,7 @@ You can use **type annotations** the same way you would for input data in functi
//// tab | Python 3.10+
```Python hl_lines="16 21"
-{!> ../../../docs_src/response_model/tutorial001_01_py310.py!}
+{!> ../../docs_src/response_model/tutorial001_01_py310.py!}
```
////
@@ -15,7 +15,7 @@ You can use **type annotations** the same way you would for input data in functi
//// tab | Python 3.9+
```Python hl_lines="18 23"
-{!> ../../../docs_src/response_model/tutorial001_01_py39.py!}
+{!> ../../docs_src/response_model/tutorial001_01_py39.py!}
```
////
@@ -23,7 +23,7 @@ You can use **type annotations** the same way you would for input data in functi
//// tab | Python 3.8+
```Python hl_lines="18 23"
-{!> ../../../docs_src/response_model/tutorial001_01.py!}
+{!> ../../docs_src/response_model/tutorial001_01.py!}
```
////
@@ -62,7 +62,7 @@ You can use the `response_model` parameter in any of the *path operations*:
//// tab | Python 3.10+
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001_py310.py!}
+{!> ../../docs_src/response_model/tutorial001_py310.py!}
```
////
@@ -70,7 +70,7 @@ You can use the `response_model` parameter in any of the *path operations*:
//// tab | Python 3.9+
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001_py39.py!}
+{!> ../../docs_src/response_model/tutorial001_py39.py!}
```
////
@@ -78,7 +78,7 @@ You can use the `response_model` parameter in any of the *path operations*:
//// tab | Python 3.8+
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001.py!}
+{!> ../../docs_src/response_model/tutorial001.py!}
```
////
@@ -116,7 +116,7 @@ Here we are declaring a `UserIn` model, it will contain a plaintext password:
//// tab | Python 3.10+
```Python hl_lines="7 9"
-{!> ../../../docs_src/response_model/tutorial002_py310.py!}
+{!> ../../docs_src/response_model/tutorial002_py310.py!}
```
////
@@ -124,7 +124,7 @@ Here we are declaring a `UserIn` model, it will contain a plaintext password:
//// tab | Python 3.8+
```Python hl_lines="9 11"
-{!> ../../../docs_src/response_model/tutorial002.py!}
+{!> ../../docs_src/response_model/tutorial002.py!}
```
////
@@ -152,7 +152,7 @@ And we are using this model to declare our input and the same model to declare o
//// tab | Python 3.10+
```Python hl_lines="16"
-{!> ../../../docs_src/response_model/tutorial002_py310.py!}
+{!> ../../docs_src/response_model/tutorial002_py310.py!}
```
////
@@ -160,7 +160,7 @@ And we are using this model to declare our input and the same model to declare o
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/response_model/tutorial002.py!}
+{!> ../../docs_src/response_model/tutorial002.py!}
```
////
@@ -184,7 +184,7 @@ We can instead create an input model with the plaintext password and an output m
//// tab | Python 3.10+
```Python hl_lines="9 11 16"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -192,7 +192,7 @@ We can instead create an input model with the plaintext password and an output m
//// tab | Python 3.8+
```Python hl_lines="9 11 16"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -202,7 +202,7 @@ Here, even though our *path operation function* is returning the same input user
//// tab | Python 3.10+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -210,7 +210,7 @@ Here, even though our *path operation function* is returning the same input user
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -220,7 +220,7 @@ Here, even though our *path operation function* is returning the same input user
//// tab | Python 3.10+
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -228,7 +228,7 @@ Here, even though our *path operation function* is returning the same input user
//// tab | Python 3.8+
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -258,7 +258,7 @@ And in those cases, we can use classes and inheritance to take advantage of func
//// tab | Python 3.10+
```Python hl_lines="7-10 13-14 18"
-{!> ../../../docs_src/response_model/tutorial003_01_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_01_py310.py!}
```
////
@@ -266,7 +266,7 @@ And in those cases, we can use classes and inheritance to take advantage of func
//// tab | Python 3.8+
```Python hl_lines="9-13 15-16 20"
-{!> ../../../docs_src/response_model/tutorial003_01.py!}
+{!> ../../docs_src/response_model/tutorial003_01.py!}
```
////
@@ -312,7 +312,7 @@ There might be cases where you return something that is not a valid Pydantic fie
The most common case would be [returning a Response directly as explained later in the advanced docs](../advanced/response-directly.md){.internal-link target=_blank}.
```Python hl_lines="8 10-11"
-{!> ../../../docs_src/response_model/tutorial003_02.py!}
+{!> ../../docs_src/response_model/tutorial003_02.py!}
```
This simple case is handled automatically by FastAPI because the return type annotation is the class (or a subclass of) `Response`.
@@ -324,7 +324,7 @@ And tools will also be happy because both `RedirectResponse` and `JSONResponse`
You can also use a subclass of `Response` in the type annotation:
```Python hl_lines="8-9"
-{!> ../../../docs_src/response_model/tutorial003_03.py!}
+{!> ../../docs_src/response_model/tutorial003_03.py!}
```
This will also work because `RedirectResponse` is a subclass of `Response`, and FastAPI will automatically handle this simple case.
@@ -338,7 +338,7 @@ The same would happen if you had something like a <abbr title='A union between m
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/response_model/tutorial003_04_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_04_py310.py!}
```
////
@@ -346,7 +346,7 @@ The same would happen if you had something like a <abbr title='A union between m
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/response_model/tutorial003_04.py!}
+{!> ../../docs_src/response_model/tutorial003_04.py!}
```
////
@@ -364,7 +364,7 @@ In this case, you can disable the response model generation by setting `response
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/response_model/tutorial003_05_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_05_py310.py!}
```
////
@@ -372,7 +372,7 @@ In this case, you can disable the response model generation by setting `response
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/response_model/tutorial003_05.py!}
+{!> ../../docs_src/response_model/tutorial003_05.py!}
```
////
@@ -386,7 +386,7 @@ Your response model could have default values, like:
//// tab | Python 3.10+
```Python hl_lines="9 11-12"
-{!> ../../../docs_src/response_model/tutorial004_py310.py!}
+{!> ../../docs_src/response_model/tutorial004_py310.py!}
```
////
@@ -394,7 +394,7 @@ Your response model could have default values, like:
//// tab | Python 3.9+
```Python hl_lines="11 13-14"
-{!> ../../../docs_src/response_model/tutorial004_py39.py!}
+{!> ../../docs_src/response_model/tutorial004_py39.py!}
```
////
@@ -402,7 +402,7 @@ Your response model could have default values, like:
//// tab | Python 3.8+
```Python hl_lines="11 13-14"
-{!> ../../../docs_src/response_model/tutorial004.py!}
+{!> ../../docs_src/response_model/tutorial004.py!}
```
////
@@ -422,7 +422,7 @@ You can set the *path operation decorator* parameter `response_model_exclude_uns
//// tab | Python 3.10+
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial004_py310.py!}
+{!> ../../docs_src/response_model/tutorial004_py310.py!}
```
////
@@ -430,7 +430,7 @@ You can set the *path operation decorator* parameter `response_model_exclude_uns
//// tab | Python 3.9+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial004_py39.py!}
+{!> ../../docs_src/response_model/tutorial004_py39.py!}
```
////
@@ -438,7 +438,7 @@ You can set the *path operation decorator* parameter `response_model_exclude_uns
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial004.py!}
+{!> ../../docs_src/response_model/tutorial004.py!}
```
////
@@ -541,7 +541,7 @@ This also applies to `response_model_by_alias` that works similarly.
//// tab | Python 3.10+
```Python hl_lines="29 35"
-{!> ../../../docs_src/response_model/tutorial005_py310.py!}
+{!> ../../docs_src/response_model/tutorial005_py310.py!}
```
////
@@ -549,7 +549,7 @@ This also applies to `response_model_by_alias` that works similarly.
//// tab | Python 3.8+
```Python hl_lines="31 37"
-{!> ../../../docs_src/response_model/tutorial005.py!}
+{!> ../../docs_src/response_model/tutorial005.py!}
```
////
@@ -569,7 +569,7 @@ If you forget to use a `set` and use a `list` or `tuple` instead, FastAPI will s
//// tab | Python 3.10+
```Python hl_lines="29 35"
-{!> ../../../docs_src/response_model/tutorial006_py310.py!}
+{!> ../../docs_src/response_model/tutorial006_py310.py!}
```
////
@@ -577,7 +577,7 @@ If you forget to use a `set` and use a `list` or `tuple` instead, FastAPI will s
//// tab | Python 3.8+
```Python hl_lines="31 37"
-{!> ../../../docs_src/response_model/tutorial006.py!}
+{!> ../../docs_src/response_model/tutorial006.py!}
```
////
diff --git a/docs/en/docs/tutorial/response-status-code.md b/docs/en/docs/tutorial/response-status-code.md
index 2613bf73d..73af62aed 100644
--- a/docs/en/docs/tutorial/response-status-code.md
+++ b/docs/en/docs/tutorial/response-status-code.md
@@ -9,7 +9,7 @@ The same way you can specify a response model, you can also declare the HTTP sta
* etc.
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
/// note
@@ -77,7 +77,7 @@ To know more about each status code and which code is for what, check the <a hre
Let's see the previous example again:
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
`201` is the status code for "Created".
@@ -87,7 +87,7 @@ But you don't have to memorize what each of these codes mean.
You can use the convenience variables from `fastapi.status`.
```Python hl_lines="1 6"
-{!../../../docs_src/response_status_code/tutorial002.py!}
+{!../../docs_src/response_status_code/tutorial002.py!}
```
They are just a convenience, they hold the same number, but that way you can use the editor's autocomplete to find them:
diff --git a/docs/en/docs/tutorial/schema-extra-example.md b/docs/en/docs/tutorial/schema-extra-example.md
index 20dee3a4f..5896b54d9 100644
--- a/docs/en/docs/tutorial/schema-extra-example.md
+++ b/docs/en/docs/tutorial/schema-extra-example.md
@@ -11,7 +11,7 @@ You can declare `examples` for a Pydantic model that will be added to the genera
//// tab | Python 3.10+ Pydantic v2
```Python hl_lines="13-24"
-{!> ../../../docs_src/schema_extra_example/tutorial001_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001_py310.py!}
```
////
@@ -19,7 +19,7 @@ You can declare `examples` for a Pydantic model that will be added to the genera
//// tab | Python 3.10+ Pydantic v1
```Python hl_lines="13-23"
-{!> ../../../docs_src/schema_extra_example/tutorial001_py310_pv1.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001_py310_pv1.py!}
```
////
@@ -27,7 +27,7 @@ You can declare `examples` for a Pydantic model that will be added to the genera
//// tab | Python 3.8+ Pydantic v2
```Python hl_lines="15-26"
-{!> ../../../docs_src/schema_extra_example/tutorial001.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001.py!}
```
////
@@ -35,7 +35,7 @@ You can declare `examples` for a Pydantic model that will be added to the genera
//// tab | Python 3.8+ Pydantic v1
```Python hl_lines="15-25"
-{!> ../../../docs_src/schema_extra_example/tutorial001_pv1.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001_pv1.py!}
```
////
@@ -83,7 +83,7 @@ When using `Field()` with Pydantic models, you can also declare additional `exam
//// tab | Python 3.10+
```Python hl_lines="2 8-11"
-{!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial002_py310.py!}
```
////
@@ -91,7 +91,7 @@ When using `Field()` with Pydantic models, you can also declare additional `exam
//// tab | Python 3.8+
```Python hl_lines="4 10-13"
-{!> ../../../docs_src/schema_extra_example/tutorial002.py!}
+{!> ../../docs_src/schema_extra_example/tutorial002.py!}
```
////
@@ -117,7 +117,7 @@ Here we pass `examples` containing one example of the data expected in `Body()`:
//// tab | Python 3.10+
```Python hl_lines="22-29"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
```
////
@@ -125,7 +125,7 @@ Here we pass `examples` containing one example of the data expected in `Body()`:
//// tab | Python 3.9+
```Python hl_lines="22-29"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
```
////
@@ -133,7 +133,7 @@ Here we pass `examples` containing one example of the data expected in `Body()`:
//// tab | Python 3.8+
```Python hl_lines="23-30"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an.py!}
```
////
@@ -147,7 +147,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="18-25"
-{!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_py310.py!}
```
////
@@ -161,7 +161,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="20-27"
-{!> ../../../docs_src/schema_extra_example/tutorial003.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003.py!}
```
////
@@ -179,7 +179,7 @@ You can of course also pass multiple `examples`:
//// tab | Python 3.10+
```Python hl_lines="23-38"
-{!> ../../../docs_src/schema_extra_example/tutorial004_an_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_an_py310.py!}
```
////
@@ -187,7 +187,7 @@ You can of course also pass multiple `examples`:
//// tab | Python 3.9+
```Python hl_lines="23-38"
-{!> ../../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
```
////
@@ -195,7 +195,7 @@ You can of course also pass multiple `examples`:
//// tab | Python 3.8+
```Python hl_lines="24-39"
-{!> ../../../docs_src/schema_extra_example/tutorial004_an.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_an.py!}
```
////
@@ -209,7 +209,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="19-34"
-{!> ../../../docs_src/schema_extra_example/tutorial004_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_py310.py!}
```
////
@@ -223,7 +223,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="21-36"
-{!> ../../../docs_src/schema_extra_example/tutorial004.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004.py!}
```
////
@@ -270,7 +270,7 @@ You can use it like this:
//// tab | Python 3.10+
```Python hl_lines="23-49"
-{!> ../../../docs_src/schema_extra_example/tutorial005_an_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005_an_py310.py!}
```
////
@@ -278,7 +278,7 @@ You can use it like this:
//// tab | Python 3.9+
```Python hl_lines="23-49"
-{!> ../../../docs_src/schema_extra_example/tutorial005_an_py39.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005_an_py39.py!}
```
////
@@ -286,7 +286,7 @@ You can use it like this:
//// tab | Python 3.8+
```Python hl_lines="24-50"
-{!> ../../../docs_src/schema_extra_example/tutorial005_an.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005_an.py!}
```
////
@@ -300,7 +300,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="19-45"
-{!> ../../../docs_src/schema_extra_example/tutorial005_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005_py310.py!}
```
////
@@ -314,7 +314,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="21-47"
-{!> ../../../docs_src/schema_extra_example/tutorial005.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005.py!}
```
////
diff --git a/docs/en/docs/tutorial/security/first-steps.md b/docs/en/docs/tutorial/security/first-steps.md
index d1fe0163e..ead2aa799 100644
--- a/docs/en/docs/tutorial/security/first-steps.md
+++ b/docs/en/docs/tutorial/security/first-steps.md
@@ -23,7 +23,7 @@ Copy the example in a file `main.py`:
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/security/tutorial001_an_py39.py!}
+{!> ../../docs_src/security/tutorial001_an_py39.py!}
```
////
@@ -31,7 +31,7 @@ Copy the example in a file `main.py`:
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/security/tutorial001_an.py!}
+{!> ../../docs_src/security/tutorial001_an.py!}
```
////
@@ -45,7 +45,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python
-{!> ../../../docs_src/security/tutorial001.py!}
+{!> ../../docs_src/security/tutorial001.py!}
```
////
@@ -163,7 +163,7 @@ When we create an instance of the `OAuth2PasswordBearer` class we pass in the `t
//// tab | Python 3.9+
```Python hl_lines="8"
-{!> ../../../docs_src/security/tutorial001_an_py39.py!}
+{!> ../../docs_src/security/tutorial001_an_py39.py!}
```
////
@@ -171,7 +171,7 @@ When we create an instance of the `OAuth2PasswordBearer` class we pass in the `t
//// tab | Python 3.8+
```Python hl_lines="7"
-{!> ../../../docs_src/security/tutorial001_an.py!}
+{!> ../../docs_src/security/tutorial001_an.py!}
```
////
@@ -185,7 +185,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="6"
-{!> ../../../docs_src/security/tutorial001.py!}
+{!> ../../docs_src/security/tutorial001.py!}
```
////
@@ -229,7 +229,7 @@ Now you can pass that `oauth2_scheme` in a dependency with `Depends`.
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/security/tutorial001_an_py39.py!}
+{!> ../../docs_src/security/tutorial001_an_py39.py!}
```
////
@@ -237,7 +237,7 @@ Now you can pass that `oauth2_scheme` in a dependency with `Depends`.
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/security/tutorial001_an.py!}
+{!> ../../docs_src/security/tutorial001_an.py!}
```
////
@@ -251,7 +251,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/security/tutorial001.py!}
+{!> ../../docs_src/security/tutorial001.py!}
```
////
diff --git a/docs/en/docs/tutorial/security/get-current-user.md b/docs/en/docs/tutorial/security/get-current-user.md
index 7faaa3e13..069806621 100644
--- a/docs/en/docs/tutorial/security/get-current-user.md
+++ b/docs/en/docs/tutorial/security/get-current-user.md
@@ -5,7 +5,7 @@ In the previous chapter the security system (which is based on the dependency in
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/security/tutorial001_an_py39.py!}
+{!> ../../docs_src/security/tutorial001_an_py39.py!}
```
////
@@ -13,7 +13,7 @@ In the previous chapter the security system (which is based on the dependency in
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/security/tutorial001_an.py!}
+{!> ../../docs_src/security/tutorial001_an.py!}
```
////
@@ -27,7 +27,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/security/tutorial001.py!}
+{!> ../../docs_src/security/tutorial001.py!}
```
////
@@ -45,7 +45,7 @@ The same way we use Pydantic to declare bodies, we can use it anywhere else:
//// tab | Python 3.10+
```Python hl_lines="5 12-16"
-{!> ../../../docs_src/security/tutorial002_an_py310.py!}
+{!> ../../docs_src/security/tutorial002_an_py310.py!}
```
////
@@ -53,7 +53,7 @@ The same way we use Pydantic to declare bodies, we can use it anywhere else:
//// tab | Python 3.9+
```Python hl_lines="5 12-16"
-{!> ../../../docs_src/security/tutorial002_an_py39.py!}
+{!> ../../docs_src/security/tutorial002_an_py39.py!}
```
////
@@ -61,7 +61,7 @@ The same way we use Pydantic to declare bodies, we can use it anywhere else:
//// tab | Python 3.8+
```Python hl_lines="5 13-17"
-{!> ../../../docs_src/security/tutorial002_an.py!}
+{!> ../../docs_src/security/tutorial002_an.py!}
```
////
@@ -75,7 +75,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="3 10-14"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -89,7 +89,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="5 12-16"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -107,7 +107,7 @@ The same as we were doing before in the *path operation* directly, our new depen
//// tab | Python 3.10+
```Python hl_lines="25"
-{!> ../../../docs_src/security/tutorial002_an_py310.py!}
+{!> ../../docs_src/security/tutorial002_an_py310.py!}
```
////
@@ -115,7 +115,7 @@ The same as we were doing before in the *path operation* directly, our new depen
//// tab | Python 3.9+
```Python hl_lines="25"
-{!> ../../../docs_src/security/tutorial002_an_py39.py!}
+{!> ../../docs_src/security/tutorial002_an_py39.py!}
```
////
@@ -123,7 +123,7 @@ The same as we were doing before in the *path operation* directly, our new depen
//// tab | Python 3.8+
```Python hl_lines="26"
-{!> ../../../docs_src/security/tutorial002_an.py!}
+{!> ../../docs_src/security/tutorial002_an.py!}
```
////
@@ -137,7 +137,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="23"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -151,7 +151,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="25"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -163,7 +163,7 @@ Prefer to use the `Annotated` version if possible.
//// tab | Python 3.10+
```Python hl_lines="19-22 26-27"
-{!> ../../../docs_src/security/tutorial002_an_py310.py!}
+{!> ../../docs_src/security/tutorial002_an_py310.py!}
```
////
@@ -171,7 +171,7 @@ Prefer to use the `Annotated` version if possible.
//// tab | Python 3.9+
```Python hl_lines="19-22 26-27"
-{!> ../../../docs_src/security/tutorial002_an_py39.py!}
+{!> ../../docs_src/security/tutorial002_an_py39.py!}
```
////
@@ -179,7 +179,7 @@ Prefer to use the `Annotated` version if possible.
//// tab | Python 3.8+
```Python hl_lines="20-23 27-28"
-{!> ../../../docs_src/security/tutorial002_an.py!}
+{!> ../../docs_src/security/tutorial002_an.py!}
```
////
@@ -193,7 +193,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="17-20 24-25"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -207,7 +207,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="19-22 26-27"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -219,7 +219,7 @@ So now we can use the same `Depends` with our `get_current_user` in the *path op
//// tab | Python 3.10+
```Python hl_lines="31"
-{!> ../../../docs_src/security/tutorial002_an_py310.py!}
+{!> ../../docs_src/security/tutorial002_an_py310.py!}
```
////
@@ -227,7 +227,7 @@ So now we can use the same `Depends` with our `get_current_user` in the *path op
//// tab | Python 3.9+
```Python hl_lines="31"
-{!> ../../../docs_src/security/tutorial002_an_py39.py!}
+{!> ../../docs_src/security/tutorial002_an_py39.py!}
```
////
@@ -235,7 +235,7 @@ So now we can use the same `Depends` with our `get_current_user` in the *path op
//// tab | Python 3.8+
```Python hl_lines="32"
-{!> ../../../docs_src/security/tutorial002_an.py!}
+{!> ../../docs_src/security/tutorial002_an.py!}
```
////
@@ -249,7 +249,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="29"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -263,7 +263,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="31"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -323,7 +323,7 @@ And all these thousands of *path operations* can be as small as 3 lines:
//// tab | Python 3.10+
```Python hl_lines="30-32"
-{!> ../../../docs_src/security/tutorial002_an_py310.py!}
+{!> ../../docs_src/security/tutorial002_an_py310.py!}
```
////
@@ -331,7 +331,7 @@ And all these thousands of *path operations* can be as small as 3 lines:
//// tab | Python 3.9+
```Python hl_lines="30-32"
-{!> ../../../docs_src/security/tutorial002_an_py39.py!}
+{!> ../../docs_src/security/tutorial002_an_py39.py!}
```
////
@@ -339,7 +339,7 @@ And all these thousands of *path operations* can be as small as 3 lines:
//// tab | Python 3.8+
```Python hl_lines="31-33"
-{!> ../../../docs_src/security/tutorial002_an.py!}
+{!> ../../docs_src/security/tutorial002_an.py!}
```
////
@@ -353,7 +353,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="28-30"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -367,7 +367,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="30-32"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
diff --git a/docs/en/docs/tutorial/security/oauth2-jwt.md b/docs/en/docs/tutorial/security/oauth2-jwt.md
index ba2bfef29..f454a8b28 100644
--- a/docs/en/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/en/docs/tutorial/security/oauth2-jwt.md
@@ -119,7 +119,7 @@ And another one to authenticate and return a user.
//// tab | Python 3.10+
```Python hl_lines="8 49 56-57 60-61 70-76"
-{!> ../../../docs_src/security/tutorial004_an_py310.py!}
+{!> ../../docs_src/security/tutorial004_an_py310.py!}
```
////
@@ -127,7 +127,7 @@ And another one to authenticate and return a user.
//// tab | Python 3.9+
```Python hl_lines="8 49 56-57 60-61 70-76"
-{!> ../../../docs_src/security/tutorial004_an_py39.py!}
+{!> ../../docs_src/security/tutorial004_an_py39.py!}
```
////
@@ -135,7 +135,7 @@ And another one to authenticate and return a user.
//// tab | Python 3.8+
```Python hl_lines="8 50 57-58 61-62 71-77"
-{!> ../../../docs_src/security/tutorial004_an.py!}
+{!> ../../docs_src/security/tutorial004_an.py!}
```
////
@@ -149,7 +149,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7 48 55-56 59-60 69-75"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -163,7 +163,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8 49 56-57 60-61 70-76"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
@@ -205,7 +205,7 @@ Create a utility function to generate a new access token.
//// tab | Python 3.10+
```Python hl_lines="4 7 13-15 29-31 79-87"
-{!> ../../../docs_src/security/tutorial004_an_py310.py!}
+{!> ../../docs_src/security/tutorial004_an_py310.py!}
```
////
@@ -213,7 +213,7 @@ Create a utility function to generate a new access token.
//// tab | Python 3.9+
```Python hl_lines="4 7 13-15 29-31 79-87"
-{!> ../../../docs_src/security/tutorial004_an_py39.py!}
+{!> ../../docs_src/security/tutorial004_an_py39.py!}
```
////
@@ -221,7 +221,7 @@ Create a utility function to generate a new access token.
//// tab | Python 3.8+
```Python hl_lines="4 7 14-16 30-32 80-88"
-{!> ../../../docs_src/security/tutorial004_an.py!}
+{!> ../../docs_src/security/tutorial004_an.py!}
```
////
@@ -235,7 +235,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="3 6 12-14 28-30 78-86"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -249,7 +249,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="4 7 13-15 29-31 79-87"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
@@ -265,7 +265,7 @@ If the token is invalid, return an HTTP error right away.
//// tab | Python 3.10+
```Python hl_lines="90-107"
-{!> ../../../docs_src/security/tutorial004_an_py310.py!}
+{!> ../../docs_src/security/tutorial004_an_py310.py!}
```
////
@@ -273,7 +273,7 @@ If the token is invalid, return an HTTP error right away.
//// tab | Python 3.9+
```Python hl_lines="90-107"
-{!> ../../../docs_src/security/tutorial004_an_py39.py!}
+{!> ../../docs_src/security/tutorial004_an_py39.py!}
```
////
@@ -281,7 +281,7 @@ If the token is invalid, return an HTTP error right away.
//// tab | Python 3.8+
```Python hl_lines="91-108"
-{!> ../../../docs_src/security/tutorial004_an.py!}
+{!> ../../docs_src/security/tutorial004_an.py!}
```
////
@@ -295,7 +295,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="89-106"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -309,7 +309,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="90-107"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
@@ -323,7 +323,7 @@ Create a real JWT access token and return it.
//// tab | Python 3.10+
```Python hl_lines="118-133"
-{!> ../../../docs_src/security/tutorial004_an_py310.py!}
+{!> ../../docs_src/security/tutorial004_an_py310.py!}
```
////
@@ -331,7 +331,7 @@ Create a real JWT access token and return it.
//// tab | Python 3.9+
```Python hl_lines="118-133"
-{!> ../../../docs_src/security/tutorial004_an_py39.py!}
+{!> ../../docs_src/security/tutorial004_an_py39.py!}
```
////
@@ -339,7 +339,7 @@ Create a real JWT access token and return it.
//// tab | Python 3.8+
```Python hl_lines="119-134"
-{!> ../../../docs_src/security/tutorial004_an.py!}
+{!> ../../docs_src/security/tutorial004_an.py!}
```
////
@@ -353,7 +353,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="115-130"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -367,7 +367,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="116-131"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
diff --git a/docs/en/docs/tutorial/security/simple-oauth2.md b/docs/en/docs/tutorial/security/simple-oauth2.md
index c9f6a1382..dc15bef20 100644
--- a/docs/en/docs/tutorial/security/simple-oauth2.md
+++ b/docs/en/docs/tutorial/security/simple-oauth2.md
@@ -55,7 +55,7 @@ First, import `OAuth2PasswordRequestForm`, and use it as a dependency with `Depe
//// tab | Python 3.10+
```Python hl_lines="4 78"
-{!> ../../../docs_src/security/tutorial003_an_py310.py!}
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
```
////
@@ -63,7 +63,7 @@ First, import `OAuth2PasswordRequestForm`, and use it as a dependency with `Depe
//// tab | Python 3.9+
```Python hl_lines="4 78"
-{!> ../../../docs_src/security/tutorial003_an_py39.py!}
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
```
////
@@ -71,7 +71,7 @@ First, import `OAuth2PasswordRequestForm`, and use it as a dependency with `Depe
//// tab | Python 3.8+
```Python hl_lines="4 79"
-{!> ../../../docs_src/security/tutorial003_an.py!}
+{!> ../../docs_src/security/tutorial003_an.py!}
```
////
@@ -85,7 +85,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="2 74"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -99,7 +99,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="4 76"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -153,7 +153,7 @@ For the error, we use the exception `HTTPException`:
//// tab | Python 3.10+
```Python hl_lines="3 79-81"
-{!> ../../../docs_src/security/tutorial003_an_py310.py!}
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
```
////
@@ -161,7 +161,7 @@ For the error, we use the exception `HTTPException`:
//// tab | Python 3.9+
```Python hl_lines="3 79-81"
-{!> ../../../docs_src/security/tutorial003_an_py39.py!}
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
```
////
@@ -169,7 +169,7 @@ For the error, we use the exception `HTTPException`:
//// tab | Python 3.8+
```Python hl_lines="3 80-82"
-{!> ../../../docs_src/security/tutorial003_an.py!}
+{!> ../../docs_src/security/tutorial003_an.py!}
```
////
@@ -183,7 +183,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1 75-77"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -197,7 +197,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="3 77-79"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -229,7 +229,7 @@ So, the thief won't be able to try to use those same passwords in another system
//// tab | Python 3.10+
```Python hl_lines="82-85"
-{!> ../../../docs_src/security/tutorial003_an_py310.py!}
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
```
////
@@ -237,7 +237,7 @@ So, the thief won't be able to try to use those same passwords in another system
//// tab | Python 3.9+
```Python hl_lines="82-85"
-{!> ../../../docs_src/security/tutorial003_an_py39.py!}
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
```
////
@@ -245,7 +245,7 @@ So, the thief won't be able to try to use those same passwords in another system
//// tab | Python 3.8+
```Python hl_lines="83-86"
-{!> ../../../docs_src/security/tutorial003_an.py!}
+{!> ../../docs_src/security/tutorial003_an.py!}
```
////
@@ -259,7 +259,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="78-81"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -273,7 +273,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="80-83"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -321,7 +321,7 @@ But for now, let's focus on the specific details we need.
//// tab | Python 3.10+
```Python hl_lines="87"
-{!> ../../../docs_src/security/tutorial003_an_py310.py!}
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
```
////
@@ -329,7 +329,7 @@ But for now, let's focus on the specific details we need.
//// tab | Python 3.9+
```Python hl_lines="87"
-{!> ../../../docs_src/security/tutorial003_an_py39.py!}
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
```
////
@@ -337,7 +337,7 @@ But for now, let's focus on the specific details we need.
//// tab | Python 3.8+
```Python hl_lines="88"
-{!> ../../../docs_src/security/tutorial003_an.py!}
+{!> ../../docs_src/security/tutorial003_an.py!}
```
////
@@ -351,7 +351,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="83"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -365,7 +365,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="85"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -397,7 +397,7 @@ So, in our endpoint, we will only get a user if the user exists, was correctly a
//// tab | Python 3.10+
```Python hl_lines="58-66 69-74 94"
-{!> ../../../docs_src/security/tutorial003_an_py310.py!}
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
```
////
@@ -405,7 +405,7 @@ So, in our endpoint, we will only get a user if the user exists, was correctly a
//// tab | Python 3.9+
```Python hl_lines="58-66 69-74 94"
-{!> ../../../docs_src/security/tutorial003_an_py39.py!}
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
```
////
@@ -413,7 +413,7 @@ So, in our endpoint, we will only get a user if the user exists, was correctly a
//// tab | Python 3.8+
```Python hl_lines="59-67 70-75 95"
-{!> ../../../docs_src/security/tutorial003_an.py!}
+{!> ../../docs_src/security/tutorial003_an.py!}
```
////
@@ -427,7 +427,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="56-64 67-70 88"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -441,7 +441,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="58-66 69-72 90"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
diff --git a/docs/en/docs/tutorial/sql-databases.md b/docs/en/docs/tutorial/sql-databases.md
index 56971bf9d..f65fa773c 100644
--- a/docs/en/docs/tutorial/sql-databases.md
+++ b/docs/en/docs/tutorial/sql-databases.md
@@ -122,13 +122,13 @@ Let's refer to the file `sql_app/database.py`.
### Import the SQLAlchemy parts
```Python hl_lines="1-3"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
### Create a database URL for SQLAlchemy
```Python hl_lines="5-6"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
In this example, we are "connecting" to a SQLite database (opening a file with the SQLite database).
@@ -158,7 +158,7 @@ The first step is to create a SQLAlchemy "engine".
We will later use this `engine` in other places.
```Python hl_lines="8-10"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
#### Note
@@ -196,7 +196,7 @@ We will use `Session` (the one imported from SQLAlchemy) later.
To create the `SessionLocal` class, use the function `sessionmaker`:
```Python hl_lines="11"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
### Create a `Base` class
@@ -206,7 +206,7 @@ Now we will use the function `declarative_base()` that returns a class.
Later we will inherit from this class to create each of the database models or classes (the ORM models):
```Python hl_lines="13"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
## Create the database models
@@ -232,7 +232,7 @@ Create classes that inherit from it.
These classes are the SQLAlchemy models.
```Python hl_lines="4 7-8 18-19"
-{!../../../docs_src/sql_databases/sql_app/models.py!}
+{!../../docs_src/sql_databases/sql_app/models.py!}
```
The `__tablename__` attribute tells SQLAlchemy the name of the table to use in the database for each of these models.
@@ -248,7 +248,7 @@ We use `Column` from SQLAlchemy as the default value.
And we pass a SQLAlchemy class "type", as `Integer`, `String`, and `Boolean`, that defines the type in the database, as an argument.
```Python hl_lines="1 10-13 21-24"
-{!../../../docs_src/sql_databases/sql_app/models.py!}
+{!../../docs_src/sql_databases/sql_app/models.py!}
```
### Create the relationships
@@ -260,7 +260,7 @@ For this, we use `relationship` provided by SQLAlchemy ORM.
This will become, more or less, a "magic" attribute that will contain the values from other tables related to this one.
```Python hl_lines="2 15 26"
-{!../../../docs_src/sql_databases/sql_app/models.py!}
+{!../../docs_src/sql_databases/sql_app/models.py!}
```
When accessing the attribute `items` in a `User`, as in `my_user.items`, it will have a list of `Item` SQLAlchemy models (from the `items` table) that have a foreign key pointing to this record in the `users` table.
@@ -478,7 +478,7 @@ Create utility functions to:
* Read multiple items.
```Python hl_lines="1 3 6-7 10-11 14-15 27-28"
-{!../../../docs_src/sql_databases/sql_app/crud.py!}
+{!../../docs_src/sql_databases/sql_app/crud.py!}
```
/// tip
@@ -499,7 +499,7 @@ The steps are:
* `refresh` your instance (so that it contains any new data from the database, like the generated ID).
```Python hl_lines="18-24 31-36"
-{!../../../docs_src/sql_databases/sql_app/crud.py!}
+{!../../docs_src/sql_databases/sql_app/crud.py!}
```
/// info
@@ -752,13 +752,13 @@ For example, in a background task worker with <a href="https://docs.celeryq.dev"
* `sql_app/database.py`:
```Python
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
* `sql_app/models.py`:
```Python
-{!../../../docs_src/sql_databases/sql_app/models.py!}
+{!../../docs_src/sql_databases/sql_app/models.py!}
```
* `sql_app/schemas.py`:
@@ -790,7 +790,7 @@ For example, in a background task worker with <a href="https://docs.celeryq.dev"
* `sql_app/crud.py`:
```Python
-{!../../../docs_src/sql_databases/sql_app/crud.py!}
+{!../../docs_src/sql_databases/sql_app/crud.py!}
```
* `sql_app/main.py`:
diff --git a/docs/en/docs/tutorial/static-files.md b/docs/en/docs/tutorial/static-files.md
index b8ce3b551..2e93bd60b 100644
--- a/docs/en/docs/tutorial/static-files.md
+++ b/docs/en/docs/tutorial/static-files.md
@@ -8,7 +8,7 @@ You can serve static files automatically from a directory using `StaticFiles`.
* "Mount" a `StaticFiles()` instance in a specific path.
```Python hl_lines="2 6"
-{!../../../docs_src/static_files/tutorial001.py!}
+{!../../docs_src/static_files/tutorial001.py!}
```
/// note | "Technical Details"
diff --git a/docs/en/docs/tutorial/testing.md b/docs/en/docs/tutorial/testing.md
index 06a87e92e..7f609a595 100644
--- a/docs/en/docs/tutorial/testing.md
+++ b/docs/en/docs/tutorial/testing.md
@@ -31,7 +31,7 @@ Use the `TestClient` object the same way as you do with `httpx`.
Write simple `assert` statements with the standard Python expressions that you need to check (again, standard `pytest`).
```Python hl_lines="2 12 15-18"
-{!../../../docs_src/app_testing/tutorial001.py!}
+{!../../docs_src/app_testing/tutorial001.py!}
```
/// tip
@@ -79,7 +79,7 @@ In the file `main.py` you have your **FastAPI** app:
```Python
-{!../../../docs_src/app_testing/main.py!}
+{!../../docs_src/app_testing/main.py!}
```
### Testing file
@@ -97,7 +97,7 @@ Then you could have a file `test_main.py` with your tests. It could live on the
Because this file is in the same package, you can use relative imports to import the object `app` from the `main` module (`main.py`):
```Python hl_lines="3"
-{!../../../docs_src/app_testing/test_main.py!}
+{!../../docs_src/app_testing/test_main.py!}
```
...and have the code for the tests just like before.
@@ -129,7 +129,7 @@ Both *path operations* require an `X-Token` header.
//// tab | Python 3.10+
```Python
-{!> ../../../docs_src/app_testing/app_b_an_py310/main.py!}
+{!> ../../docs_src/app_testing/app_b_an_py310/main.py!}
```
////
@@ -137,7 +137,7 @@ Both *path operations* require an `X-Token` header.
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/app_testing/app_b_an_py39/main.py!}
+{!> ../../docs_src/app_testing/app_b_an_py39/main.py!}
```
////
@@ -145,7 +145,7 @@ Both *path operations* require an `X-Token` header.
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/app_testing/app_b_an/main.py!}
+{!> ../../docs_src/app_testing/app_b_an/main.py!}
```
////
@@ -159,7 +159,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python
-{!> ../../../docs_src/app_testing/app_b_py310/main.py!}
+{!> ../../docs_src/app_testing/app_b_py310/main.py!}
```
////
@@ -173,7 +173,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python
-{!> ../../../docs_src/app_testing/app_b/main.py!}
+{!> ../../docs_src/app_testing/app_b/main.py!}
```
////
@@ -183,7 +183,7 @@ Prefer to use the `Annotated` version if possible.
You could then update `test_main.py` with the extended tests:
```Python
-{!> ../../../docs_src/app_testing/app_b/test_main.py!}
+{!> ../../docs_src/app_testing/app_b/test_main.py!}
```
Whenever you need the client to pass information in the request and you don't know how to, you can search (Google) how to do it in `httpx`, or even how to do it with `requests`, as HTTPX's design is based on Requests' design.
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 5161b891b..a18af2022 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -305,7 +305,6 @@ markdown_extensions:
# Other extensions
mdx_include:
- base_path: docs
extra:
analytics:
diff --git a/docs/es/docs/advanced/additional-status-codes.md b/docs/es/docs/advanced/additional-status-codes.md
index 664604c59..4a0625c25 100644
--- a/docs/es/docs/advanced/additional-status-codes.md
+++ b/docs/es/docs/advanced/additional-status-codes.md
@@ -15,7 +15,7 @@ Pero también quieres que acepte nuevos ítems. Cuando los ítems no existan ant
Para conseguir esto importa `JSONResponse` y devuelve ahí directamente tu contenido, asignando el `status_code` que quieras:
```Python hl_lines="4 25"
-{!../../../docs_src/additional_status_codes/tutorial001.py!}
+{!../../docs_src/additional_status_codes/tutorial001.py!}
```
/// warning | Advertencia
diff --git a/docs/es/docs/advanced/path-operation-advanced-configuration.md b/docs/es/docs/advanced/path-operation-advanced-configuration.md
index 18f96213f..f6813f0ff 100644
--- a/docs/es/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/es/docs/advanced/path-operation-advanced-configuration.md
@@ -13,7 +13,7 @@ Puedes asignar el `operationId` de OpenAPI para ser usado en tu *operación de p
En este caso tendrías que asegurarte de que sea único para cada operación.
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
```
### Usando el nombre de la *función de la operación de path* en el operationId
@@ -23,7 +23,7 @@ Si quieres usar tus nombres de funciones de API como `operationId`s, puedes iter
Deberías hacerlo después de adicionar todas tus *operaciones de path*.
```Python hl_lines="2 12 13 14 15 16 17 18 19 20 21 24"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
```
/// tip | Consejo
@@ -45,7 +45,7 @@ Incluso si están en diferentes módulos (archivos Python).
Para excluir una *operación de path* del esquema OpenAPI generado (y por tanto del la documentación generada automáticamente), usa el parámetro `include_in_schema` y asigna el valor como `False`;
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
```
## Descripción avanzada desde el docstring
@@ -57,5 +57,5 @@ Agregar un `\f` (un carácter de "form feed" escapado) hace que **FastAPI** trun
No será mostrado en la documentación, pero otras herramientas (como Sphinx) serán capaces de usar el resto.
```Python hl_lines="19 20 21 22 23 24 25 26 27 28 29"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
```
diff --git a/docs/es/docs/advanced/response-change-status-code.md b/docs/es/docs/advanced/response-change-status-code.md
index ecd9fad41..ddfd05a77 100644
--- a/docs/es/docs/advanced/response-change-status-code.md
+++ b/docs/es/docs/advanced/response-change-status-code.md
@@ -21,7 +21,7 @@ Puedes declarar un parámetro de tipo `Response` en tu *función de la operació
Y luego puedes establecer el `status_code` en ese objeto de respuesta *temporal*.
```Python hl_lines="1 9 12"
-{!../../../docs_src/response_change_status_code/tutorial001.py!}
+{!../../docs_src/response_change_status_code/tutorial001.py!}
```
Y luego puedes retornar cualquier objeto que necesites, como normalmente lo harías (un `dict`, un modelo de base de datos, etc).
diff --git a/docs/es/docs/advanced/response-directly.md b/docs/es/docs/advanced/response-directly.md
index 4eeab3fd0..8800d2510 100644
--- a/docs/es/docs/advanced/response-directly.md
+++ b/docs/es/docs/advanced/response-directly.md
@@ -35,7 +35,7 @@ Por ejemplo, no puedes poner un modelo Pydantic en una `JSONResponse` sin primer
Para esos casos, puedes usar el `jsonable_encoder` para convertir tus datos antes de pasarlos a la respuesta:
```Python hl_lines="4 6 20 21"
-{!../../../docs_src/response_directly/tutorial001.py!}
+{!../../docs_src/response_directly/tutorial001.py!}
```
/// note | Detalles Técnicos
@@ -57,7 +57,7 @@ Digamos que quieres devolver una respuesta <a href="https://en.wikipedia.org/wik
Podrías poner tu contenido XML en un string, ponerlo en una `Response` y devolverlo:
```Python hl_lines="1 18"
-{!../../../docs_src/response_directly/tutorial002.py!}
+{!../../docs_src/response_directly/tutorial002.py!}
```
## Notas
diff --git a/docs/es/docs/advanced/response-headers.md b/docs/es/docs/advanced/response-headers.md
index c3aa20993..01d4fbc08 100644
--- a/docs/es/docs/advanced/response-headers.md
+++ b/docs/es/docs/advanced/response-headers.md
@@ -7,7 +7,7 @@ Puedes declarar un parámetro de tipo `Response` en tu *función de operación d
Y entonces, podrás configurar las cookies en ese objeto de response *temporal*.
```Python hl_lines="1 7-8"
-{!../../../docs_src/response_headers/tutorial002.py!}
+{!../../docs_src/response_headers/tutorial002.py!}
```
Posteriormente, puedes devolver cualquier objeto que necesites, como normalmente harías (un `dict`, un modelo de base de datos, etc).
@@ -26,7 +26,7 @@ Adicionalmente, puedes añadir headers cuando se retorne una `Response` directam
Crea un response tal como se describe en [Retornar una respuesta directamente](response-directly.md){.internal-link target=_blank} y pasa los headers como un parámetro adicional:
```Python hl_lines="10-12"
-{!../../../docs_src/response_headers/tutorial001.py!}
+{!../../docs_src/response_headers/tutorial001.py!}
```
/// note | Detalles Técnicos
diff --git a/docs/es/docs/how-to/graphql.md b/docs/es/docs/how-to/graphql.md
index 590c2e828..9e5f3c9d5 100644
--- a/docs/es/docs/how-to/graphql.md
+++ b/docs/es/docs/how-to/graphql.md
@@ -36,7 +36,7 @@ Dependiendo de tus casos de uso, podrías preferir usar una library diferente, p
Aquí hay una pequeña muestra de cómo podrías integrar Strawberry con FastAPI:
```Python hl_lines="3 22 25-26"
-{!../../../docs_src/graphql/tutorial001.py!}
+{!../../docs_src/graphql/tutorial001.py!}
```
Puedes aprender más sobre Strawberry en la <a href="https://strawberry.rocks/" class="external-link" target="_blank">documentación de Strawberry</a>.
diff --git a/docs/es/docs/python-types.md b/docs/es/docs/python-types.md
index c873385bc..156907ad1 100644
--- a/docs/es/docs/python-types.md
+++ b/docs/es/docs/python-types.md
@@ -23,7 +23,7 @@ Si eres un experto en Python y ya lo sabes todo sobre los type hints, salta al s
Comencemos con un ejemplo simple:
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
Llamar este programa nos muestra el siguiente <abbr title="en español: salida">output</abbr>:
@@ -39,7 +39,7 @@ La función hace lo siguiente:
* Las <abbr title="las junta como si fuesen una. Con el contenido de una después de la otra. En inglés: concatenate.">concatena</abbr> con un espacio en la mitad.
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### Edítalo
@@ -83,7 +83,7 @@ Eso es todo.
Esos son los "type hints":
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
No es lo mismo a declarar valores por defecto, como sería con:
@@ -113,7 +113,7 @@ Con esto puedes moverte hacia abajo viendo las opciones hasta que encuentras una
Mira esta función que ya tiene type hints:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
Como el editor conoce el tipo de las variables no solo obtienes auto-completado, si no que también obtienes chequeo de errores:
@@ -123,7 +123,7 @@ Como el editor conoce el tipo de las variables no solo obtienes auto-completado,
Ahora que sabes que tienes que arreglarlo convierte `age` a un string con `str(age)`:
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## Declarando tipos
@@ -144,7 +144,7 @@ Por ejemplo, puedes usar:
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### Tipos con sub-tipos
@@ -162,7 +162,7 @@ Por ejemplo, vamos a definir una variable para que sea una `list` compuesta de `
De `typing`, importa `List` (con una `L` mayúscula):
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
Declara la variable con la misma sintaxis de los dos puntos (`:`).
@@ -172,7 +172,7 @@ Pon `List` como el tipo.
Como la lista es un tipo que permite tener un "sub-tipo" pones el sub-tipo en corchetes `[]`:
```Python hl_lines="4"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
Esto significa: la variable `items` es una `list` y cada uno de los ítems en esta lista es un `str`.
@@ -192,7 +192,7 @@ El editor aún sabe que es un `str` y provee soporte para ello.
Harías lo mismo para declarar `tuple`s y `set`s:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial007.py!}
+{!../../docs_src/python_types/tutorial007.py!}
```
Esto significa:
@@ -209,7 +209,7 @@ El primer sub-tipo es para los keys del `dict`.
El segundo sub-tipo es para los valores del `dict`:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial008.py!}
+{!../../docs_src/python_types/tutorial008.py!}
```
Esto significa:
@@ -225,13 +225,13 @@ También puedes declarar una clase como el tipo de una variable.
Digamos que tienes una clase `Person`con un nombre:
```Python hl_lines="1-3"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
Entonces puedes declarar una variable que sea de tipo `Person`:
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
Una vez más tendrás todo el soporte del editor:
@@ -253,7 +253,7 @@ Y obtienes todo el soporte del editor con el objeto resultante.
Tomado de la documentación oficial de Pydantic:
```Python
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
/// info | Información
diff --git a/docs/es/docs/tutorial/cookie-params.md b/docs/es/docs/tutorial/cookie-params.md
index 3eaea31f9..e858e34e8 100644
--- a/docs/es/docs/tutorial/cookie-params.md
+++ b/docs/es/docs/tutorial/cookie-params.md
@@ -9,7 +9,7 @@ Primero importa `Cookie`:
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ Primero importa `Cookie`:
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ Primero importa `Cookie`:
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Es preferible utilizar la versión `Annotated` si es posible.
///
```Python hl_lines="1"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Es preferible utilizar la versión `Annotated` si es posible.
///
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
@@ -67,7 +67,7 @@ El primer valor es el valor por defecto, puedes pasar todos los parámetros adic
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -75,7 +75,7 @@ El primer valor es el valor por defecto, puedes pasar todos los parámetros adic
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -83,7 +83,7 @@ El primer valor es el valor por defecto, puedes pasar todos los parámetros adic
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -97,7 +97,7 @@ Es preferible utilizar la versión `Annotated` si es posible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -111,7 +111,7 @@ Es preferible utilizar la versión `Annotated` si es posible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
diff --git a/docs/es/docs/tutorial/first-steps.md b/docs/es/docs/tutorial/first-steps.md
index 8d8909b97..68df00e64 100644
--- a/docs/es/docs/tutorial/first-steps.md
+++ b/docs/es/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
Un archivo muy simple de FastAPI podría verse así:
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Copia eso a un archivo `main.py`.
@@ -134,7 +134,7 @@ También podrías usarlo para generar código automáticamente, para los cliente
### Paso 1: importa `FastAPI`
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI` es una clase de Python que provee toda la funcionalidad para tu API.
@@ -150,7 +150,7 @@ También puedes usar toda la funcionalidad de <a href="https://www.starlette.io/
### Paso 2: crea un "instance" de `FastAPI`
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Aquí la variable `app` será un instance de la clase `FastAPI`.
@@ -172,7 +172,7 @@ $ uvicorn main:app --reload
Si creas un app como:
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial002.py!}
+{!../../docs_src/first_steps/tutorial002.py!}
```
y lo guardas en un archivo `main.py`, entonces ejecutarías `uvicorn` así:
@@ -251,7 +251,7 @@ Nosotros también los llamaremos "**operación**".
#### Define un *decorador de operaciones de path*
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
El `@app.get("/")` le dice a **FastAPI** que la función que tiene justo debajo está a cargo de manejar los requests que van a:
@@ -307,7 +307,7 @@ Esta es nuestra "**función de la operación de path**":
* **función**: es la función debajo del "decorador" (debajo de `@app.get("/")`).
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Esto es una función de Python.
@@ -321,7 +321,7 @@ En este caso es una función `async`.
También podrías definirla como una función estándar en lugar de `async def`:
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note | Nota
@@ -333,7 +333,7 @@ Si no sabes la diferencia, revisa el [Async: *"¿Tienes prisa?"*](../async.md#ti
### Paso 5: devuelve el contenido
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Puedes devolver `dict`, `list`, valores singulares como un `str`, `int`, etc.
diff --git a/docs/es/docs/tutorial/path-params.md b/docs/es/docs/tutorial/path-params.md
index e09e0381f..167c88659 100644
--- a/docs/es/docs/tutorial/path-params.md
+++ b/docs/es/docs/tutorial/path-params.md
@@ -3,7 +3,7 @@
Puedes declarar los "parámetros" o "variables" con la misma sintaxis que usan los format strings de Python:
```Python hl_lines="6-7"
-{!../../../docs_src/path_params/tutorial001.py!}
+{!../../docs_src/path_params/tutorial001.py!}
```
El valor del parámetro de path `item_id` será pasado a tu función como el argumento `item_id`.
@@ -19,7 +19,7 @@ Entonces, si corres este ejemplo y vas a <a href="http://127.0.0.1:8000/items/fo
Puedes declarar el tipo de un parámetro de path en la función usando las anotaciones de tipos estándar de Python:
```Python hl_lines="7"
-{!../../../docs_src/path_params/tutorial002.py!}
+{!../../docs_src/path_params/tutorial002.py!}
```
En este caso, `item_id` es declarado como un `int`.
@@ -122,7 +122,7 @@ Digamos algo como `/users/me` que sea para obtener datos del usuario actual.
Porque las *operaciones de path* son evaluadas en orden, tienes que asegurarte de que el path para `/users/me` sea declarado antes que el path para `/users/{user_id}`:
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003.py!}
+{!../../docs_src/path_params/tutorial003.py!}
```
De otra manera el path para `/users/{user_id}` coincidiría también con `/users/me` "pensando" que está recibiendo el parámetro `user_id` con el valor `"me"`.
@@ -140,7 +140,7 @@ Al heredar desde `str` la documentación de la API podrá saber que los valores
Luego crea atributos de clase con valores fijos, que serán los valores disponibles válidos:
```Python hl_lines="1 6-9"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// info | Información
@@ -160,7 +160,7 @@ Si lo estás dudando, "AlexNet", "ResNet", y "LeNet" son solo nombres de <abbr t
Luego, crea un *parámetro de path* con anotaciones de tipos usando la clase enum que creaste (`ModelName`):
```Python hl_lines="16"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
### Revisa la documentación
@@ -178,7 +178,7 @@ El valor del *parámetro de path* será un *enumeration member*.
Puedes compararlo con el *enumeration member* en el enum (`ModelName`) que creaste:
```Python hl_lines="17"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
#### Obtén el *enumeration value*
@@ -186,7 +186,7 @@ Puedes compararlo con el *enumeration member* en el enum (`ModelName`) que creas
Puedes obtener el valor exacto (un `str` en este caso) usando `model_name.value`, o en general, `your_enum_member.value`:
```Python hl_lines="20"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// tip | Consejo
@@ -202,7 +202,7 @@ Puedes devolver *enum members* desde tu *operación de path* inclusive en un bod
Ellos serán convertidos a sus valores correspondientes (strings en este caso) antes de devolverlos al cliente:
```Python hl_lines="18 21 23"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
En tu cliente obtendrás una respuesta en JSON como:
@@ -243,7 +243,7 @@ En este caso el nombre del parámetro es `file_path` y la última parte, `:path`
Entonces lo puedes usar con:
```Python hl_lines="6"
-{!../../../docs_src/path_params/tutorial004.py!}
+{!../../docs_src/path_params/tutorial004.py!}
```
/// tip | Consejo
diff --git a/docs/es/docs/tutorial/query-params.md b/docs/es/docs/tutorial/query-params.md
index 6f88fd617..f9b5cf69d 100644
--- a/docs/es/docs/tutorial/query-params.md
+++ b/docs/es/docs/tutorial/query-params.md
@@ -3,7 +3,7 @@
Cuando declaras otros parámetros de la función que no hacen parte de los parámetros de path estos se interpretan automáticamente como parámetros de "query".
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial001.py!}
+{!../../docs_src/query_params/tutorial001.py!}
```
El query es el conjunto de pares de key-value que van después del `?` en la URL, separados por caracteres `&`.
@@ -64,7 +64,7 @@ Los valores de los parámetros en tu función serán:
Del mismo modo puedes declarar parámetros de query opcionales definiendo el valor por defecto como `None`:
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial002.py!}
+{!../../docs_src/query_params/tutorial002.py!}
```
En este caso el parámetro de la función `q` será opcional y será `None` por defecto.
@@ -88,7 +88,7 @@ El `Union` en `Union[str, None]` no es usado por FastAPI (FastAPI solo usará la
También puedes declarar tipos `bool` y serán convertidos:
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial003.py!}
+{!../../docs_src/query_params/tutorial003.py!}
```
En este caso, si vas a:
@@ -132,7 +132,7 @@ No los tienes que declarar en un orden específico.
Serán detectados por nombre:
```Python hl_lines="8 10"
-{!../../../docs_src/query_params/tutorial004.py!}
+{!../../docs_src/query_params/tutorial004.py!}
```
## Parámetros de query requeridos
@@ -144,7 +144,7 @@ Si no quieres añadir un valor específico sino solo hacerlo opcional, pon el va
Pero cuando quieres hacer que un parámetro de query sea requerido, puedes simplemente no declararle un valor por defecto:
```Python hl_lines="6-7"
-{!../../../docs_src/query_params/tutorial005.py!}
+{!../../docs_src/query_params/tutorial005.py!}
```
Aquí el parámetro de query `needy` es un parámetro de query requerido, del tipo `str`.
@@ -190,7 +190,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
Por supuesto que también puedes definir algunos parámetros como requeridos, con un valor por defecto y otros completamente opcionales:
```Python hl_lines="10"
-{!../../../docs_src/query_params/tutorial006.py!}
+{!../../docs_src/query_params/tutorial006.py!}
```
En este caso hay 3 parámetros de query:
diff --git a/docs/fa/docs/advanced/sub-applications.md b/docs/fa/docs/advanced/sub-applications.md
index 6f2359b94..5e4326776 100644
--- a/docs/fa/docs/advanced/sub-applications.md
+++ b/docs/fa/docs/advanced/sub-applications.md
@@ -13,7 +13,7 @@
```Python hl_lines="3 6-8"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### زیر برنامه
@@ -23,7 +23,7 @@
این زیر برنامه فقط یکی دیگر از برنامه های استاندارد FastAPI است، اما این برنامه ای است که متصل می شود:
```Python hl_lines="11 14-16"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### اتصال زیر برنامه
@@ -31,7 +31,7 @@
در برنامه سطح بالا `app` اتصال زیر برنامه `subapi` در این نمونه `/subapi` در مسیر قرار میدهد و میشود:
```Python hl_lines="11 19"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### اسناد API خودکار را بررسی کنید
diff --git a/docs/fa/docs/tutorial/middleware.md b/docs/fa/docs/tutorial/middleware.md
index e3ee5fcbc..ca631d507 100644
--- a/docs/fa/docs/tutorial/middleware.md
+++ b/docs/fa/docs/tutorial/middleware.md
@@ -31,7 +31,7 @@
* شما میتوانید سپس `پاسخ` را تغییر داده و پس از آن را برگردانید.
```Python hl_lines="8-9 11 14"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
/// نکته | به خاطر داشته باشید که هدرهای اختصاصی سفارشی را می توان با استفاده از پیشوند "X-" اضافه کرد.
@@ -57,7 +57,7 @@
به عنوان مثال، میتوانید یک هدر سفارشی به نام `X-Process-Time` که شامل زمان پردازش درخواست و تولید پاسخ به صورت ثانیه است، اضافه کنید.
```Python hl_lines="10 12-13"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
## سایر میان افزار
diff --git a/docs/fr/docs/advanced/additional-responses.md b/docs/fr/docs/advanced/additional-responses.md
index 44bbf50f8..52a0a0792 100644
--- a/docs/fr/docs/advanced/additional-responses.md
+++ b/docs/fr/docs/advanced/additional-responses.md
@@ -27,7 +27,7 @@ Chacun de ces `dict` de réponse peut avoir une clé `model`, contenant un modè
Par exemple, pour déclarer une autre réponse avec un code HTTP `404` et un modèle Pydantic `Message`, vous pouvez écrire :
```Python hl_lines="18 22"
-{!../../../docs_src/additional_responses/tutorial001.py!}
+{!../../docs_src/additional_responses/tutorial001.py!}
```
/// note | "Remarque"
@@ -178,7 +178,7 @@ Vous pouvez utiliser ce même paramètre `responses` pour ajouter différents ty
Par exemple, vous pouvez ajouter un type de média supplémentaire `image/png`, en déclarant que votre *opération de chemin* peut renvoyer un objet JSON (avec le type de média `application/json`) ou une image PNG :
```Python hl_lines="19-24 28"
-{!../../../docs_src/additional_responses/tutorial002.py!}
+{!../../docs_src/additional_responses/tutorial002.py!}
```
/// note | "Remarque"
@@ -208,7 +208,7 @@ Par exemple, vous pouvez déclarer une réponse avec un code HTTP `404` qui util
Et une réponse avec un code HTTP `200` qui utilise votre `response_model`, mais inclut un `example` personnalisé :
```Python hl_lines="20-31"
-{!../../../docs_src/additional_responses/tutorial003.py!}
+{!../../docs_src/additional_responses/tutorial003.py!}
```
Tout sera combiné et inclus dans votre OpenAPI, et affiché dans la documentation de l'API :
@@ -244,7 +244,7 @@ Vous pouvez utiliser cette technique pour réutiliser certaines réponses préd
Par exemple:
```Python hl_lines="13-17 26"
-{!../../../docs_src/additional_responses/tutorial004.py!}
+{!../../docs_src/additional_responses/tutorial004.py!}
```
## Plus d'informations sur les réponses OpenAPI
diff --git a/docs/fr/docs/advanced/additional-status-codes.md b/docs/fr/docs/advanced/additional-status-codes.md
index 46db2e0b6..06a8043ea 100644
--- a/docs/fr/docs/advanced/additional-status-codes.md
+++ b/docs/fr/docs/advanced/additional-status-codes.md
@@ -15,7 +15,7 @@ Mais vous voulez aussi qu'il accepte de nouveaux éléments. Et lorsque les él
Pour y parvenir, importez `JSONResponse` et renvoyez-y directement votre contenu, en définissant le `status_code` que vous souhaitez :
```Python hl_lines="4 25"
-{!../../../docs_src/additional_status_codes/tutorial001.py!}
+{!../../docs_src/additional_status_codes/tutorial001.py!}
```
/// warning | "Attention"
diff --git a/docs/fr/docs/advanced/path-operation-advanced-configuration.md b/docs/fr/docs/advanced/path-operation-advanced-configuration.md
index 4727020ae..94b20b0f3 100644
--- a/docs/fr/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/fr/docs/advanced/path-operation-advanced-configuration.md
@@ -13,7 +13,7 @@ Dans OpenAPI, les chemins sont des ressources, tels que /users/ ou /items/, expo
Vous devez vous assurer qu'il est unique pour chaque opération.
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
```
### Utilisation du nom *path operation function* comme operationId
@@ -23,7 +23,7 @@ Si vous souhaitez utiliser les noms de fonction de vos API comme `operationId`,
Vous devriez le faire après avoir ajouté toutes vos *paramètres de chemin*.
```Python hl_lines="2 12-21 24"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
```
/// tip | "Astuce"
@@ -45,7 +45,7 @@ Même s'ils se trouvent dans des modules différents (fichiers Python).
Pour exclure un *chemin* du schéma OpenAPI généré (et donc des systèmes de documentation automatiques), utilisez le paramètre `include_in_schema` et assignez-lui la valeur `False` :
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
```
## Description avancée de docstring
@@ -57,7 +57,7 @@ L'ajout d'un `\f` (un caractère d'échappement "form feed") va permettre à **F
Il n'apparaîtra pas dans la documentation, mais d'autres outils (tel que Sphinx) pourront utiliser le reste.
```Python hl_lines="19-29"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
```
## Réponses supplémentaires
@@ -99,7 +99,7 @@ Vous pouvez étendre le schéma OpenAPI pour une *opération de chemin* en utili
Cet `openapi_extra` peut être utile, par exemple, pour déclarer [OpenAPI Extensions](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#specificationExtensions) :
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial005.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial005.py!}
```
Si vous ouvrez la documentation automatique de l'API, votre extension apparaîtra au bas du *chemin* spécifique.
@@ -148,7 +148,7 @@ Par exemple, vous pouvez décider de lire et de valider la requête avec votre p
Vous pouvez le faire avec `openapi_extra` :
```Python hl_lines="20-37 39-40"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial006.py !}
+{!../../docs_src/path_operation_advanced_configuration/tutorial006.py !}
```
Dans cet exemple, nous n'avons déclaré aucun modèle Pydantic. En fait, le corps de la requête n'est même pas <abbr title="converti d'un format simple, comme des octets, en objets Python">parsé</abbr> en tant que JSON, il est lu directement en tant que `bytes`, et la fonction `magic_data_reader()` serait chargé de l'analyser d'une manière ou d'une autre.
@@ -164,7 +164,7 @@ Et vous pouvez le faire même si le type de données dans la requête n'est pas
Dans cet exemple, nous n'utilisons pas les fonctionnalités de FastAPI pour extraire le schéma JSON des modèles Pydantic ni la validation automatique pour JSON. En fait, nous déclarons le type de contenu de la requête en tant que YAML, et non JSON :
```Python hl_lines="17-22 24"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
```
Néanmoins, bien que nous n'utilisions pas la fonctionnalité par défaut, nous utilisons toujours un modèle Pydantic pour générer manuellement le schéma JSON pour les données que nous souhaitons recevoir en YAML.
@@ -174,7 +174,7 @@ Ensuite, nous utilisons directement la requête et extrayons son contenu en tant
Et nous analysons directement ce contenu YAML, puis nous utilisons à nouveau le même modèle Pydantic pour valider le contenu YAML :
```Python hl_lines="26-33"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
```
/// tip | "Astuce"
diff --git a/docs/fr/docs/advanced/response-directly.md b/docs/fr/docs/advanced/response-directly.md
index 49ca32230..80876bc18 100644
--- a/docs/fr/docs/advanced/response-directly.md
+++ b/docs/fr/docs/advanced/response-directly.md
@@ -35,7 +35,7 @@ Par exemple, vous ne pouvez pas mettre un modèle Pydantic dans une `JSONRespons
Pour ces cas, vous pouvez spécifier un appel à `jsonable_encoder` pour convertir vos données avant de les passer à une réponse :
```Python hl_lines="6-7 21-22"
-{!../../../docs_src/response_directly/tutorial001.py!}
+{!../../docs_src/response_directly/tutorial001.py!}
```
/// note | "Détails techniques"
@@ -57,7 +57,7 @@ Disons que vous voulez retourner une réponse <a href="https://en.wikipedia.org/
Vous pouvez mettre votre contenu XML dans une chaîne de caractères, la placer dans une `Response`, et la retourner :
```Python hl_lines="1 18"
-{!../../../docs_src/response_directly/tutorial002.py!}
+{!../../docs_src/response_directly/tutorial002.py!}
```
## Notes
diff --git a/docs/fr/docs/python-types.md b/docs/fr/docs/python-types.md
index e3c99e0a9..2992347be 100644
--- a/docs/fr/docs/python-types.md
+++ b/docs/fr/docs/python-types.md
@@ -24,7 +24,7 @@ Si vous êtes un expert Python, et que vous savez déjà **tout** sur les annota
Prenons un exemple simple :
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
Exécuter ce programe affiche :
@@ -40,7 +40,7 @@ La fonction :
* Concatène les résultats avec un espace entre les deux.
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### Limitations
@@ -85,7 +85,7 @@ C'est tout.
Ce sont des annotations de types :
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
À ne pas confondre avec la déclaration de valeurs par défaut comme ici :
@@ -115,7 +115,7 @@ Vous pouvez donc dérouler les options jusqu'à trouver la méthode à laquelle
Cette fonction possède déjà des annotations de type :
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
Comme l'éditeur connaît le type des variables, vous n'avez pas seulement l'auto-complétion, mais aussi de la détection d'erreurs :
@@ -125,7 +125,7 @@ Comme l'éditeur connaît le type des variables, vous n'avez pas seulement l'aut
Maintenant que vous avez connaissance du problème, convertissez `age` en <abbr title="string">chaîne de caractères</abbr> grâce à `str(age)` :
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## Déclarer des types
@@ -146,7 +146,7 @@ Comme par exemple :
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### Types génériques avec des paramètres de types
@@ -164,7 +164,7 @@ Par exemple, définissons une variable comme `list` de `str`.
Importez `List` (avec un `L` majuscule) depuis `typing`.
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
Déclarez la variable, en utilisant la syntaxe des deux-points (`:`).
@@ -174,7 +174,7 @@ Et comme type, mettez `List`.
Les listes étant un type contenant des types internes, mettez ces derniers entre crochets (`[`, `]`) :
```Python hl_lines="4"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
/// tip | "Astuce"
@@ -202,7 +202,7 @@ Et pourtant, l'éditeur sait qu'elle est de type `str` et pourra donc vous aider
C'est le même fonctionnement pour déclarer un `tuple` ou un `set` :
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial007.py!}
+{!../../docs_src/python_types/tutorial007.py!}
```
Dans cet exemple :
@@ -217,7 +217,7 @@ Pour définir un `dict`, il faut lui passer 2 paramètres, séparés par une vir
Le premier paramètre de type est pour les clés et le second pour les valeurs du dictionnaire (`dict`).
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial008.py!}
+{!../../docs_src/python_types/tutorial008.py!}
```
Dans cet exemple :
@@ -231,7 +231,7 @@ Dans cet exemple :
Vous pouvez aussi utiliser `Optional` pour déclarer qu'une variable a un type, comme `str` mais qu'il est "optionnel" signifiant qu'il pourrait aussi être `None`.
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
Utiliser `Optional[str]` plutôt que `str` permettra à l'éditeur de vous aider à détecter les erreurs où vous supposeriez qu'une valeur est toujours de type `str`, alors qu'elle pourrait aussi être `None`.
@@ -256,13 +256,13 @@ Vous pouvez aussi déclarer une classe comme type d'une variable.
Disons que vous avez une classe `Person`, avec une variable `name` :
```Python hl_lines="1-3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Vous pouvez ensuite déclarer une variable de type `Person` :
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Et vous aurez accès, encore une fois, au support complet offert par l'éditeur :
@@ -284,7 +284,7 @@ Ainsi, votre éditeur vous offrira un support adapté pour l'objet résultant.
Extrait de la documentation officielle de **Pydantic** :
```Python
-{!../../../docs_src/python_types/tutorial011.py!}
+{!../../docs_src/python_types/tutorial011.py!}
```
/// info
diff --git a/docs/fr/docs/tutorial/background-tasks.md b/docs/fr/docs/tutorial/background-tasks.md
index f7cf1a6cc..d971d293d 100644
--- a/docs/fr/docs/tutorial/background-tasks.md
+++ b/docs/fr/docs/tutorial/background-tasks.md
@@ -17,7 +17,7 @@ Cela comprend, par exemple :
Pour commencer, importez `BackgroundTasks` et définissez un paramètre dans votre *fonction de chemin* avec `BackgroundTasks` comme type déclaré.
```Python hl_lines="1 13"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
**FastAPI** créera l'objet de type `BackgroundTasks` pour vous et le passera comme paramètre.
@@ -33,7 +33,7 @@ Dans cet exemple, la fonction de tâche écrira dans un fichier (afin de simuler
L'opération d'écriture n'utilisant ni `async` ni `await`, on définit la fonction avec un `def` normal.
```Python hl_lines="6-9"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
## Ajouter une tâche d'arrière-plan
@@ -42,7 +42,7 @@ Dans votre *fonction de chemin*, passez votre fonction de tâche à l'objet de t
```Python hl_lines="14"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
`.add_task()` reçoit comme arguments :
@@ -58,7 +58,7 @@ Utiliser `BackgroundTasks` fonctionne aussi avec le système d'injection de dép
**FastAPI** sait quoi faire dans chaque cas et comment réutiliser le même objet, afin que tous les paramètres de type `BackgroundTasks` soient fusionnés et que les tâches soient exécutées en arrière-plan :
```Python hl_lines="13 15 22 25"
-{!../../../docs_src/background_tasks/tutorial002.py!}
+{!../../docs_src/background_tasks/tutorial002.py!}
```
Dans cet exemple, les messages seront écrits dans le fichier `log.txt` après que la réponse soit envoyée.
diff --git a/docs/fr/docs/tutorial/body-multiple-params.md b/docs/fr/docs/tutorial/body-multiple-params.md
index fd8e5d688..dafd869e3 100644
--- a/docs/fr/docs/tutorial/body-multiple-params.md
+++ b/docs/fr/docs/tutorial/body-multiple-params.md
@@ -11,7 +11,7 @@ Vous pouvez également déclarer des paramètres body comme étant optionnels, e
//// tab | Python 3.10+
```Python hl_lines="18-20"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
```
////
@@ -19,7 +19,7 @@ Vous pouvez également déclarer des paramètres body comme étant optionnels, e
//// tab | Python 3.9+
```Python hl_lines="18-20"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
```
////
@@ -27,7 +27,7 @@ Vous pouvez également déclarer des paramètres body comme étant optionnels, e
//// tab | Python 3.8+
```Python hl_lines="19-21"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an.py!}
```
////
@@ -41,7 +41,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="17-19"
-{!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_py310.py!}
```
////
@@ -55,7 +55,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="19-21"
-{!> ../../../docs_src/body_multiple_params/tutorial001.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001.py!}
```
////
@@ -84,7 +84,7 @@ Mais vous pouvez également déclarer plusieurs paramètres provenant de body, p
//// tab | Python 3.10+
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002_py310.py!}
```
////
@@ -92,7 +92,7 @@ Mais vous pouvez également déclarer plusieurs paramètres provenant de body, p
//// tab | Python 3.8+
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial002.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002.py!}
```
////
@@ -138,7 +138,7 @@ Mais vous pouvez indiquer à **FastAPI** de la traiter comme une variable de bod
//// tab | Python 3.10+
```Python hl_lines="23"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
```
////
@@ -146,7 +146,7 @@ Mais vous pouvez indiquer à **FastAPI** de la traiter comme une variable de bod
//// tab | Python 3.9+
```Python hl_lines="23"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
```
////
@@ -154,7 +154,7 @@ Mais vous pouvez indiquer à **FastAPI** de la traiter comme une variable de bod
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an.py!}
```
////
@@ -168,7 +168,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_py310.py!}
```
////
@@ -182,7 +182,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial003.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003.py!}
```
////
@@ -228,7 +228,7 @@ Par exemple :
//// tab | Python 3.10+
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
```
////
@@ -236,7 +236,7 @@ Par exemple :
//// tab | Python 3.9+
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
```
////
@@ -244,7 +244,7 @@ Par exemple :
//// tab | Python 3.8+
```Python hl_lines="28"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an.py!}
```
////
@@ -258,7 +258,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="25"
-{!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_py310.py!}
```
////
@@ -272,7 +272,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004.py!}
```
////
@@ -300,7 +300,7 @@ Voici un exemple complet :
//// tab | Python 3.10+
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
```
////
@@ -308,7 +308,7 @@ Voici un exemple complet :
//// tab | Python 3.9+
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
```
////
@@ -316,7 +316,7 @@ Voici un exemple complet :
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an.py!}
```
////
@@ -330,7 +330,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="15"
-{!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_py310.py!}
```
////
@@ -344,7 +344,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005.py!}
```
////
diff --git a/docs/fr/docs/tutorial/body.md b/docs/fr/docs/tutorial/body.md
index 9a5121f10..96fff2ca6 100644
--- a/docs/fr/docs/tutorial/body.md
+++ b/docs/fr/docs/tutorial/body.md
@@ -23,7 +23,7 @@ Ceci étant découragé, la documentation interactive générée par Swagger UI
Commencez par importer la classe `BaseModel` du module `pydantic` :
```Python hl_lines="4"
-{!../../../docs_src/body/tutorial001.py!}
+{!../../docs_src/body/tutorial001.py!}
```
## Créez votre modèle de données
@@ -33,7 +33,7 @@ Déclarez ensuite votre modèle de données en tant que classe qui hérite de `B
Utilisez les types Python standard pour tous les attributs :
```Python hl_lines="7-11"
-{!../../../docs_src/body/tutorial001.py!}
+{!../../docs_src/body/tutorial001.py!}
```
Tout comme pour la déclaration de paramètres de requête, quand un attribut de modèle a une valeur par défaut, il n'est pas nécessaire. Sinon, cet attribut doit être renseigné dans le corps de la requête. Pour rendre ce champ optionnel simplement, utilisez `None` comme valeur par défaut.
@@ -63,7 +63,7 @@ Par exemple, le modèle ci-dessus déclare un "objet" JSON (ou `dict` Python) te
Pour l'ajouter à votre *opération de chemin*, déclarez-le comme vous déclareriez des paramètres de chemin ou de requête :
```Python hl_lines="18"
-{!../../../docs_src/body/tutorial001.py!}
+{!../../docs_src/body/tutorial001.py!}
```
...et déclarez que son type est le modèle que vous avez créé : `Item`.
@@ -132,7 +132,7 @@ Ce qui améliore le support pour les modèles Pydantic avec :
Dans la fonction, vous pouvez accéder à tous les attributs de l'objet du modèle directement :
```Python hl_lines="21"
-{!../../../docs_src/body/tutorial002.py!}
+{!../../docs_src/body/tutorial002.py!}
```
## Corps de la requête + paramètres de chemin
@@ -142,7 +142,7 @@ Vous pouvez déclarer des paramètres de chemin et un corps de requête pour la
**FastAPI** est capable de reconnaître que les paramètres de la fonction qui correspondent aux paramètres de chemin doivent être **récupérés depuis le chemin**, et que les paramètres de fonctions déclarés comme modèles Pydantic devraient être **récupérés depuis le corps de la requête**.
```Python hl_lines="17-18"
-{!../../../docs_src/body/tutorial003.py!}
+{!../../docs_src/body/tutorial003.py!}
```
## Corps de la requête + paramètres de chemin et de requête
@@ -152,7 +152,7 @@ Vous pouvez aussi déclarer un **corps**, et des paramètres de **chemin** et de
**FastAPI** saura reconnaître chacun d'entre eux et récupérer la bonne donnée au bon endroit.
```Python hl_lines="18"
-{!../../../docs_src/body/tutorial004.py!}
+{!../../docs_src/body/tutorial004.py!}
```
Les paramètres de la fonction seront reconnus comme tel :
diff --git a/docs/fr/docs/tutorial/debugging.md b/docs/fr/docs/tutorial/debugging.md
index bcd780a82..914277699 100644
--- a/docs/fr/docs/tutorial/debugging.md
+++ b/docs/fr/docs/tutorial/debugging.md
@@ -7,7 +7,7 @@ Vous pouvez connecter le <abbr title="En anglais: debugger">débogueur</abbr> da
Dans votre application FastAPI, importez et exécutez directement `uvicorn` :
```Python hl_lines="1 15"
-{!../../../docs_src/debugging/tutorial001.py!}
+{!../../docs_src/debugging/tutorial001.py!}
```
### À propos de `__name__ == "__main__"`
diff --git a/docs/fr/docs/tutorial/first-steps.md b/docs/fr/docs/tutorial/first-steps.md
index bf476d990..e9511b029 100644
--- a/docs/fr/docs/tutorial/first-steps.md
+++ b/docs/fr/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
Le fichier **FastAPI** le plus simple possible pourrait ressembler à cela :
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Copiez ce code dans un fichier nommé `main.py`.
@@ -135,7 +135,7 @@ Vous pourriez aussi l'utiliser pour générer du code automatiquement, pour les
### Étape 1 : import `FastAPI`
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI` est une classe Python qui fournit toutes les fonctionnalités nécessaires au lancement de votre API.
@@ -151,7 +151,7 @@ Vous pouvez donc aussi utiliser toutes les fonctionnalités de <a href="https://
### Étape 2 : créer une "instance" `FastAPI`
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Ici la variable `app` sera une "instance" de la classe `FastAPI`.
@@ -173,7 +173,7 @@ $ uvicorn main:app --reload
Si vous créez votre app avec :
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial002.py!}
+{!../../docs_src/first_steps/tutorial002.py!}
```
Et la mettez dans un fichier `main.py`, alors vous appelleriez `uvicorn` avec :
@@ -251,7 +251,7 @@ Nous allons donc aussi appeler ces dernières des "**opérations**".
#### Définir un *décorateur d'opération de chemin*
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Le `@app.get("/")` dit à **FastAPI** que la fonction en dessous est chargée de gérer les requêtes qui vont sur :
@@ -307,7 +307,7 @@ Voici notre "**fonction de chemin**" (ou fonction d'opération de chemin) :
* **fonction** : la fonction sous le "décorateur" (sous `@app.get("/")`).
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
C'est une fonction Python.
@@ -321,7 +321,7 @@ Ici, c'est une fonction asynchrone (définie avec `async def`).
Vous pourriez aussi la définir comme une fonction classique plutôt qu'avec `async def` :
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note
@@ -333,7 +333,7 @@ Si vous ne connaissez pas la différence, allez voir la section [Concurrence : *
### Étape 5 : retourner le contenu
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Vous pouvez retourner un dictionnaire (`dict`), une liste (`list`), des valeurs seules comme des chaines de caractères (`str`) et des entiers (`int`), etc.
diff --git a/docs/fr/docs/tutorial/path-params-numeric-validations.md b/docs/fr/docs/tutorial/path-params-numeric-validations.md
index eedd59f91..82e317ff7 100644
--- a/docs/fr/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/fr/docs/tutorial/path-params-numeric-validations.md
@@ -9,7 +9,7 @@ Tout d'abord, importez `Path` de `fastapi`, et importez `Annotated` :
//// tab | Python 3.10+
```Python hl_lines="1 3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ Tout d'abord, importez `Path` de `fastapi`, et importez `Annotated` :
//// tab | Python 3.9+
```Python hl_lines="1 3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ Tout d'abord, importez `Path` de `fastapi`, et importez `Annotated` :
//// tab | Python 3.8+
```Python hl_lines="3-4"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="1"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -77,7 +77,7 @@ Par exemple, pour déclarer une valeur de métadonnée `title` pour le paramètr
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
```
////
@@ -85,7 +85,7 @@ Par exemple, pour déclarer une valeur de métadonnée `title` pour le paramètr
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
```
////
@@ -93,7 +93,7 @@ Par exemple, pour déclarer une valeur de métadonnée `title` pour le paramètr
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
```
////
@@ -107,7 +107,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="8"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -121,7 +121,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -163,7 +163,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial002.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial002.py!}
```
////
@@ -173,7 +173,7 @@ Mais gardez à l'esprit que si vous utilisez `Annotated`, vous n'aurez pas ce pr
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
```
////
@@ -181,7 +181,7 @@ Mais gardez à l'esprit que si vous utilisez `Annotated`, vous n'aurez pas ce pr
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
```
////
@@ -210,7 +210,7 @@ Passez `*`, comme premier paramètre de la fonction.
Python ne fera rien avec ce `*`, mais il saura que tous les paramètres suivants doivent être appelés comme arguments "mots-clés" (paires clé-valeur), également connus sous le nom de <abbr title="De : K-ey W-ord Arg-uments"><code>kwargs</code></abbr>. Même s'ils n'ont pas de valeur par défaut.
```Python hl_lines="7"
-{!../../../docs_src/path_params_numeric_validations/tutorial003.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial003.py!}
```
# Avec `Annotated`
@@ -220,7 +220,7 @@ Gardez à l'esprit que si vous utilisez `Annotated`, comme vous n'utilisez pas l
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
```
////
@@ -228,7 +228,7 @@ Gardez à l'esprit que si vous utilisez `Annotated`, comme vous n'utilisez pas l
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
```
////
@@ -242,7 +242,7 @@ Ici, avec `ge=1`, `item_id` devra être un nombre entier "`g`reater than or `e`q
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
```
////
@@ -250,7 +250,7 @@ Ici, avec `ge=1`, `item_id` devra être un nombre entier "`g`reater than or `e`q
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
```
////
@@ -264,7 +264,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004.py!}
```
////
@@ -279,7 +279,7 @@ La même chose s'applique pour :
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
```
////
@@ -287,7 +287,7 @@ La même chose s'applique pour :
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
```
////
@@ -301,7 +301,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="8"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004.py!}
```
////
@@ -316,7 +316,7 @@ La même chose s'applique pour :
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
```
////
@@ -324,7 +324,7 @@ La même chose s'applique pour :
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
```
////
@@ -338,7 +338,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial005.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial005.py!}
```
////
@@ -356,7 +356,7 @@ Et la même chose pour <abbr title="less than"><code>lt</code></abbr>.
//// tab | Python 3.9+
```Python hl_lines="13"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
```
////
@@ -364,7 +364,7 @@ Et la même chose pour <abbr title="less than"><code>lt</code></abbr>.
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
```
////
@@ -378,7 +378,7 @@ Préférez utiliser la version `Annotated` si possible.
///
```Python hl_lines="11"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial006.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial006.py!}
```
////
diff --git a/docs/fr/docs/tutorial/path-params.md b/docs/fr/docs/tutorial/path-params.md
index 94c36a20d..34012c278 100644
--- a/docs/fr/docs/tutorial/path-params.md
+++ b/docs/fr/docs/tutorial/path-params.md
@@ -5,7 +5,7 @@ Vous pouvez déclarer des "paramètres" ou "variables" de chemin avec la même s
```Python hl_lines="6-7"
-{!../../../docs_src/path_params/tutorial001.py!}
+{!../../docs_src/path_params/tutorial001.py!}
```
La valeur du paramètre `item_id` sera transmise à la fonction dans l'argument `item_id`.
@@ -23,7 +23,7 @@ Vous pouvez déclarer le type d'un paramètre de chemin dans la fonction, en uti
```Python hl_lines="7"
-{!../../../docs_src/path_params/tutorial002.py!}
+{!../../docs_src/path_params/tutorial002.py!}
```
Ici, `item_id` est déclaré comme `int`.
@@ -132,7 +132,7 @@ Et vous avez un second chemin : `/users/{user_id}` pour récupérer de la donné
Les *fonctions de chemin* étant évaluées dans l'ordre, il faut s'assurer que la fonction correspondant à `/users/me` est déclarée avant celle de `/users/{user_id}` :
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003.py!}
+{!../../docs_src/path_params/tutorial003.py!}
```
Sinon, le chemin `/users/{user_id}` correspondrait aussi à `/users/me`, la fonction "croyant" qu'elle a reçu un paramètre `user_id` avec pour valeur `"me"`.
@@ -150,7 +150,7 @@ En héritant de `str` la documentation sera capable de savoir que les valeurs do
Créez ensuite des attributs de classe avec des valeurs fixes, qui seront les valeurs autorisées pour cette énumération.
```Python hl_lines="1 6-9"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// info
@@ -170,7 +170,7 @@ Pour ceux qui se demandent, "AlexNet", "ResNet", et "LeNet" sont juste des noms
Créez ensuite un *paramètre de chemin* avec une annotation de type désignant l'énumération créée précédemment (`ModelName`) :
```Python hl_lines="16"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
### Documentation
@@ -188,7 +188,7 @@ La valeur du *paramètre de chemin* sera un des "membres" de l'énumération.
Vous pouvez comparer ce paramètre avec les membres de votre énumération `ModelName` :
```Python hl_lines="17"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
#### Récupérer la *valeur de l'énumération*
@@ -196,7 +196,7 @@ Vous pouvez comparer ce paramètre avec les membres de votre énumération `Mode
Vous pouvez obtenir la valeur réel d'un membre (une chaîne de caractères ici), avec `model_name.value`, ou en général, `votre_membre_d'enum.value` :
```Python hl_lines="20"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// tip | "Astuce"
@@ -212,7 +212,7 @@ Vous pouvez retourner des *membres d'énumération* dans vos *fonctions de chemi
Ils seront convertis vers leurs valeurs correspondantes (chaînes de caractères ici) avant d'être transmis au client :
```Python hl_lines="18 21 23"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
Le client recevra une réponse JSON comme celle-ci :
@@ -253,7 +253,7 @@ Dans ce cas, le nom du paramètre est `file_path`, et la dernière partie, `:pat
Vous pouvez donc l'utilisez comme tel :
```Python hl_lines="6"
-{!../../../docs_src/path_params/tutorial004.py!}
+{!../../docs_src/path_params/tutorial004.py!}
```
/// tip | "Astuce"
diff --git a/docs/fr/docs/tutorial/query-params-str-validations.md b/docs/fr/docs/tutorial/query-params-str-validations.md
index 63578ec40..b71d1548a 100644
--- a/docs/fr/docs/tutorial/query-params-str-validations.md
+++ b/docs/fr/docs/tutorial/query-params-str-validations.md
@@ -5,7 +5,7 @@
Commençons avec cette application pour exemple :
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial001.py!}
+{!../../docs_src/query_params_str_validations/tutorial001.py!}
```
Le paramètre de requête `q` a pour type `Union[str, None]` (ou `str | None` en Python 3.10), signifiant qu'il est de type `str` mais pourrait aussi être égal à `None`, et bien sûr, la valeur par défaut est `None`, donc **FastAPI** saura qu'il n'est pas requis.
@@ -27,7 +27,7 @@ Nous allons imposer que bien que `q` soit un paramètre optionnel, dès qu'il es
Pour cela, importez d'abord `Query` depuis `fastapi` :
```Python hl_lines="3"
-{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!../../docs_src/query_params_str_validations/tutorial002.py!}
```
## Utiliser `Query` comme valeur par défaut
@@ -35,7 +35,7 @@ Pour cela, importez d'abord `Query` depuis `fastapi` :
Construisez ensuite la valeur par défaut de votre paramètre avec `Query`, en choisissant 50 comme `max_length` :
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!../../docs_src/query_params_str_validations/tutorial002.py!}
```
Comme nous devons remplacer la valeur par défaut `None` dans la fonction par `Query()`, nous pouvons maintenant définir la valeur par défaut avec le paramètre `Query(default=None)`, il sert le même objectif qui est de définir cette valeur par défaut.
@@ -87,7 +87,7 @@ Cela va valider les données, montrer une erreur claire si ces dernières ne son
Vous pouvez aussi rajouter un second paramètre `min_length` :
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial003.py!}
+{!../../docs_src/query_params_str_validations/tutorial003.py!}
```
## Ajouter des validations par expressions régulières
@@ -95,7 +95,7 @@ Vous pouvez aussi rajouter un second paramètre `min_length` :
On peut définir une <abbr title="Une expression régulière, regex ou regexp est une suite de caractères qui définit un pattern de correspondance pour les chaînes de caractères.">expression régulière</abbr> à laquelle le paramètre doit correspondre :
```Python hl_lines="10"
-{!../../../docs_src/query_params_str_validations/tutorial004.py!}
+{!../../docs_src/query_params_str_validations/tutorial004.py!}
```
Cette expression régulière vérifie que la valeur passée comme paramètre :
@@ -115,7 +115,7 @@ De la même façon que vous pouvez passer `None` comme premier argument pour l'u
Disons que vous déclarez le paramètre `q` comme ayant une longueur minimale de `3`, et une valeur par défaut étant `"fixedquery"` :
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial005.py!}
+{!../../docs_src/query_params_str_validations/tutorial005.py!}
```
/// note | "Rappel"
@@ -147,7 +147,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
Donc pour déclarer une valeur comme requise tout en utilisant `Query`, il faut utiliser `...` comme premier argument :
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial006.py!}
+{!../../docs_src/query_params_str_validations/tutorial006.py!}
```
/// info
@@ -165,7 +165,7 @@ Quand on définit un paramètre de requête explicitement avec `Query` on peut a
Par exemple, pour déclarer un paramètre de requête `q` qui peut apparaître plusieurs fois dans une URL, on écrit :
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial011.py!}
+{!../../docs_src/query_params_str_validations/tutorial011.py!}
```
Ce qui fait qu'avec une URL comme :
@@ -202,7 +202,7 @@ La documentation sera donc mise à jour automatiquement pour autoriser plusieurs
Et l'on peut aussi définir une liste de valeurs par défaut si aucune n'est fournie :
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial012.py!}
+{!../../docs_src/query_params_str_validations/tutorial012.py!}
```
Si vous allez à :
@@ -229,7 +229,7 @@ et la réponse sera :
Il est aussi possible d'utiliser directement `list` plutôt que `List[str]` :
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial013.py!}
+{!../../docs_src/query_params_str_validations/tutorial013.py!}
```
/// note
@@ -257,13 +257,13 @@ Il se peut donc que certains d'entre eux n'utilisent pas toutes les métadonnée
Vous pouvez ajouter un `title` :
```Python hl_lines="10"
-{!../../../docs_src/query_params_str_validations/tutorial007.py!}
+{!../../docs_src/query_params_str_validations/tutorial007.py!}
```
Et une `description` :
```Python hl_lines="13"
-{!../../../docs_src/query_params_str_validations/tutorial008.py!}
+{!../../docs_src/query_params_str_validations/tutorial008.py!}
```
## Alias de paramètres
@@ -285,7 +285,7 @@ Mais vous avez vraiment envie que ce soit exactement `item-query`...
Pour cela vous pouvez déclarer un `alias`, et cet alias est ce qui sera utilisé pour trouver la valeur du paramètre :
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial009.py!}
+{!../../docs_src/query_params_str_validations/tutorial009.py!}
```
## Déprécier des paramètres
@@ -297,7 +297,7 @@ Il faut qu'il continue à exister pendant un certain temps car vos clients l'uti
On utilise alors l'argument `deprecated=True` de `Query` :
```Python hl_lines="18"
-{!../../../docs_src/query_params_str_validations/tutorial010.py!}
+{!../../docs_src/query_params_str_validations/tutorial010.py!}
```
La documentation le présentera comme il suit :
diff --git a/docs/fr/docs/tutorial/query-params.md b/docs/fr/docs/tutorial/query-params.md
index b9f1540c9..c847a8f5b 100644
--- a/docs/fr/docs/tutorial/query-params.md
+++ b/docs/fr/docs/tutorial/query-params.md
@@ -3,7 +3,7 @@
Quand vous déclarez des paramètres dans votre fonction de chemin qui ne font pas partie des paramètres indiqués dans le chemin associé, ces paramètres sont automatiquement considérés comme des paramètres de "requête".
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial001.py!}
+{!../../docs_src/query_params/tutorial001.py!}
```
La partie appelée requête (ou **query**) dans une URL est l'ensemble des paires clés-valeurs placées après le `?` , séparées par des `&`.
@@ -64,7 +64,7 @@ Les valeurs des paramètres de votre fonction seront :
De la même façon, vous pouvez définir des paramètres de requête comme optionnels, en leur donnant comme valeur par défaut `None` :
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial002.py!}
+{!../../docs_src/query_params/tutorial002.py!}
```
Ici, le paramètre `q` sera optionnel, et aura `None` comme valeur par défaut.
@@ -88,7 +88,7 @@ Le `Optional` dans `Optional[str]` n'est pas utilisé par **FastAPI** (**FastAPI
Vous pouvez aussi déclarer des paramètres de requête comme booléens (`bool`), **FastAPI** les convertira :
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial003.py!}
+{!../../docs_src/query_params/tutorial003.py!}
```
Avec ce code, en allant sur :
@@ -132,7 +132,7 @@ Et vous n'avez pas besoin de les déclarer dans un ordre spécifique.
Ils seront détectés par leurs noms :
```Python hl_lines="8 10"
-{!../../../docs_src/query_params/tutorial004.py!}
+{!../../docs_src/query_params/tutorial004.py!}
```
## Paramètres de requête requis
@@ -144,7 +144,7 @@ Si vous ne voulez pas leur donner de valeur par défaut mais juste les rendre op
Mais si vous voulez rendre un paramètre de requête obligatoire, vous pouvez juste ne pas y affecter de valeur par défaut :
```Python hl_lines="6-7"
-{!../../../docs_src/query_params/tutorial005.py!}
+{!../../docs_src/query_params/tutorial005.py!}
```
Ici le paramètre `needy` est un paramètre requis (ou obligatoire) de type `str`.
@@ -190,7 +190,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
Et bien sur, vous pouvez définir certains paramètres comme requis, certains avec des valeurs par défaut et certains entièrement optionnels :
```Python hl_lines="10"
-{!../../../docs_src/query_params/tutorial006.py!}
+{!../../docs_src/query_params/tutorial006.py!}
```
Ici, on a donc 3 paramètres de requête :
diff --git a/docs/ja/docs/advanced/additional-status-codes.md b/docs/ja/docs/advanced/additional-status-codes.md
index 622affa6e..904d539e7 100644
--- a/docs/ja/docs/advanced/additional-status-codes.md
+++ b/docs/ja/docs/advanced/additional-status-codes.md
@@ -15,7 +15,7 @@
これを達成するには、 `JSONResponse` をインポートし、 `status_code` を設定して直接内容を返します。
```Python hl_lines="4 25"
-{!../../../docs_src/additional_status_codes/tutorial001.py!}
+{!../../docs_src/additional_status_codes/tutorial001.py!}
```
/// warning | "注意"
diff --git a/docs/ja/docs/advanced/custom-response.md b/docs/ja/docs/advanced/custom-response.md
index a7ce6b54d..88269700e 100644
--- a/docs/ja/docs/advanced/custom-response.md
+++ b/docs/ja/docs/advanced/custom-response.md
@@ -25,7 +25,7 @@
使いたい `Response` クラス (サブクラス) をインポートし、 *path operationデコレータ* に宣言します。
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial001b.py!}
+{!../../docs_src/custom_response/tutorial001b.py!}
```
/// info | "情報"
@@ -52,7 +52,7 @@
* *path operation* のパラメータ `content_type` に `HTMLResponse` を渡す。
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial002.py!}
+{!../../docs_src/custom_response/tutorial002.py!}
```
/// info | "情報"
@@ -72,7 +72,7 @@
上記と同じ例において、 `HTMLResponse` を返すと、このようになります:
```Python hl_lines="2 7 19"
-{!../../../docs_src/custom_response/tutorial003.py!}
+{!../../docs_src/custom_response/tutorial003.py!}
```
/// warning | "注意"
@@ -98,7 +98,7 @@
例えば、このようになります:
```Python hl_lines="7 21 23"
-{!../../../docs_src/custom_response/tutorial004.py!}
+{!../../docs_src/custom_response/tutorial004.py!}
```
この例では、関数 `generate_html_response()` は、`str` のHTMLを返すのではなく `Response` を生成して返しています。
@@ -139,7 +139,7 @@
FastAPI (実際にはStarlette) は自動的にContent-Lengthヘッダーを含みます。また、media_typeに基づいたContent-Typeヘッダーを含み、テキストタイプのためにcharsetを追加します。
```Python hl_lines="1 18"
-{!../../../docs_src/response_directly/tutorial002.py!}
+{!../../docs_src/response_directly/tutorial002.py!}
```
### `HTMLResponse`
@@ -151,7 +151,7 @@ FastAPI (実際にはStarlette) は自動的にContent-Lengthヘッダーを含
テキストやバイトを受け取り、プレーンテキストのレスポンスを返します。
```Python hl_lines="2 7 9"
-{!../../../docs_src/custom_response/tutorial005.py!}
+{!../../docs_src/custom_response/tutorial005.py!}
```
### `JSONResponse`
@@ -175,7 +175,7 @@ FastAPI (実際にはStarlette) は自動的にContent-Lengthヘッダーを含
///
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial001.py!}
+{!../../docs_src/custom_response/tutorial001.py!}
```
/// tip | "豆知識"
@@ -189,7 +189,7 @@ FastAPI (実際にはStarlette) は自動的にContent-Lengthヘッダーを含
HTTPリダイレクトを返します。デフォルトでは307ステータスコード (Temporary Redirect) となります。
```Python hl_lines="2 9"
-{!../../../docs_src/custom_response/tutorial006.py!}
+{!../../docs_src/custom_response/tutorial006.py!}
```
### `StreamingResponse`
@@ -197,7 +197,7 @@ HTTPリダイレクトを返します。デフォルトでは307ステータス
非同期なジェネレータか通常のジェネレータ・イテレータを受け取り、レスポンスボディをストリームします。
```Python hl_lines="2 14"
-{!../../../docs_src/custom_response/tutorial007.py!}
+{!../../docs_src/custom_response/tutorial007.py!}
```
#### `StreamingResponse` をファイルライクなオブジェクトとともに使う
@@ -207,7 +207,7 @@ HTTPリダイレクトを返します。デフォルトでは307ステータス
これにはクラウドストレージとの連携や映像処理など、多くのライブラリが含まれています。
```Python hl_lines="2 10-12 14"
-{!../../../docs_src/custom_response/tutorial008.py!}
+{!../../docs_src/custom_response/tutorial008.py!}
```
/// tip | "豆知識"
@@ -230,7 +230,7 @@ HTTPリダイレクトを返します。デフォルトでは307ステータス
ファイルレスポンスには、適切な `Content-Length` 、 `Last-Modified` 、 `ETag` ヘッダーが含まれます。
```Python hl_lines="2 10"
-{!../../../docs_src/custom_response/tutorial009.py!}
+{!../../docs_src/custom_response/tutorial009.py!}
```
## デフォルトレスポンスクラス
@@ -242,7 +242,7 @@ HTTPリダイレクトを返します。デフォルトでは307ステータス
以下の例では、 **FastAPI** は、全ての *path operation* で `JSONResponse` の代わりに `ORJSONResponse` をデフォルトとして利用します。
```Python hl_lines="2 4"
-{!../../../docs_src/custom_response/tutorial010.py!}
+{!../../docs_src/custom_response/tutorial010.py!}
```
/// tip | "豆知識"
diff --git a/docs/ja/docs/advanced/path-operation-advanced-configuration.md b/docs/ja/docs/advanced/path-operation-advanced-configuration.md
index ae60126cb..2dab4aec1 100644
--- a/docs/ja/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/ja/docs/advanced/path-operation-advanced-configuration.md
@@ -13,7 +13,7 @@
`operation_id` は各オペレーションで一意にする必要があります。
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
```
### *path operation関数* の名前をoperationIdとして使用する
@@ -23,7 +23,7 @@ APIの関数名を `operationId` として利用したい場合、すべてのAP
そうする場合は、すべての *path operation* を追加した後に行う必要があります。
```Python hl_lines="2 12-21 24"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
```
/// tip | "豆知識"
@@ -45,7 +45,7 @@ APIの関数名を `operationId` として利用したい場合、すべてのAP
生成されるOpenAPIスキーマ (つまり、自動ドキュメント生成の仕組み) から *path operation* を除外するには、 `include_in_schema` パラメータを `False` にします。
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
```
## docstringによる説明の高度な設定
@@ -57,5 +57,5 @@ APIの関数名を `operationId` として利用したい場合、すべてのAP
ドキュメントには表示されませんが、他のツール (例えばSphinx) では残りの部分を利用できるでしょう。
```Python hl_lines="19-29"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
```
diff --git a/docs/ja/docs/advanced/response-directly.md b/docs/ja/docs/advanced/response-directly.md
index 5c25471b1..167d15589 100644
--- a/docs/ja/docs/advanced/response-directly.md
+++ b/docs/ja/docs/advanced/response-directly.md
@@ -35,7 +35,7 @@
このようなケースでは、レスポンスにデータを含める前に `jsonable_encoder` を使ってデータを変換できます。
```Python hl_lines="6-7 21-22"
-{!../../../docs_src/response_directly/tutorial001.py!}
+{!../../docs_src/response_directly/tutorial001.py!}
```
/// note | "技術詳細"
@@ -57,7 +57,7 @@
XMLを文字列にし、`Response` に含め、それを返します。
```Python hl_lines="1 18"
-{!../../../docs_src/response_directly/tutorial002.py!}
+{!../../docs_src/response_directly/tutorial002.py!}
```
## 備考
diff --git a/docs/ja/docs/advanced/websockets.md b/docs/ja/docs/advanced/websockets.md
index 615f9d17c..f7bcb6af3 100644
--- a/docs/ja/docs/advanced/websockets.md
+++ b/docs/ja/docs/advanced/websockets.md
@@ -39,7 +39,7 @@ $ pip install websockets
しかし、これはWebSocketのサーバーサイドに焦点を当て、実用的な例を示す最も簡単な方法です。
```Python hl_lines="2 6-38 41-43"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
## `websocket` を作成する
@@ -47,7 +47,7 @@ $ pip install websockets
**FastAPI** アプリケーションで、`websocket` を作成します。
```Python hl_lines="1 46-47"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
/// note | "技術詳細"
@@ -63,7 +63,7 @@ $ pip install websockets
WebSocketルートでは、 `await` を使ってメッセージの送受信ができます。
```Python hl_lines="48-52"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
バイナリやテキストデータ、JSONデータを送受信できます。
@@ -116,7 +116,7 @@ WebSocketエンドポイントでは、`fastapi` から以下をインポート
これらは、他のFastAPI エンドポイント/*path operation* の場合と同じように機能します。
```Python hl_lines="58-65 68-83"
-{!../../../docs_src/websockets/tutorial002.py!}
+{!../../docs_src/websockets/tutorial002.py!}
```
/// info | "情報"
@@ -165,7 +165,7 @@ $ uvicorn main:app --reload
WebSocket接続が閉じられると、 `await websocket.receive_text()` は例外 `WebSocketDisconnect` を発生させ、この例のようにキャッチして処理することができます。
```Python hl_lines="81-83"
-{!../../../docs_src/websockets/tutorial003.py!}
+{!../../docs_src/websockets/tutorial003.py!}
```
試してみるには、
diff --git a/docs/ja/docs/how-to/conditional-openapi.md b/docs/ja/docs/how-to/conditional-openapi.md
index b892ed6c6..053d481f7 100644
--- a/docs/ja/docs/how-to/conditional-openapi.md
+++ b/docs/ja/docs/how-to/conditional-openapi.md
@@ -30,7 +30,7 @@
例えば、
```Python hl_lines="6 11"
-{!../../../docs_src/conditional_openapi/tutorial001.py!}
+{!../../docs_src/conditional_openapi/tutorial001.py!}
```
ここでは `openapi_url` の設定を、デフォルトの `"/openapi.json"` のまま宣言しています。
diff --git a/docs/ja/docs/python-types.md b/docs/ja/docs/python-types.md
index 730a209ab..7af6ce0c0 100644
--- a/docs/ja/docs/python-types.md
+++ b/docs/ja/docs/python-types.md
@@ -23,7 +23,7 @@
簡単な例から始めてみましょう:
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
このプログラムを実行すると以下が出力されます:
@@ -39,7 +39,7 @@ John Doe
* 真ん中にスペースを入れて<abbr title="次から次へと中身を入れて一つにまとめる">連結</abbr>します。
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### 編集
@@ -83,7 +83,7 @@ John Doe
それが「型ヒント」です:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
これは、以下のようにデフォルト値を宣言するのと同じではありません:
@@ -113,7 +113,7 @@ John Doe
この関数を見てください。すでに型ヒントを持っています:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
エディタは変数の型を知っているので、補完だけでなく、エラーチェックをすることもできます。
@@ -123,7 +123,7 @@ John Doe
これで`age`を`str(age)`で文字列に変換して修正する必要があることがわかります:
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## 型の宣言
@@ -144,7 +144,7 @@ John Doe
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### 型パラメータを持つジェネリック型
@@ -162,7 +162,7 @@ John Doe
`typing`から`List`をインポートします（大文字の`L`を含む）:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
同じようにコロン（`:`）の構文で変数を宣言します。
@@ -172,7 +172,7 @@ John Doe
リストはいくつかの内部の型を含む型なので、それらを角括弧で囲んでいます。
```Python hl_lines="4"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
/// tip | "豆知識"
@@ -200,7 +200,7 @@ John Doe
`tuple`と`set`の宣言も同様です:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial007.py!}
+{!../../docs_src/python_types/tutorial007.py!}
```
つまり:
@@ -218,7 +218,7 @@ John Doe
２番目の型パラメータは`dict`の値です。
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial008.py!}
+{!../../docs_src/python_types/tutorial008.py!}
```
つまり:
@@ -232,7 +232,7 @@ John Doe
また、`Optional`を使用して、変数が`str`のような型を持つことを宣言することもできますが、それは「オプション」であり、`None`にすることもできます。
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
ただの`str`の代わりに`Optional[str]`を使用することで、エディタは値が常に`str`であると仮定している場合に実際には`None`である可能性があるエラーを検出するのに役立ちます。
@@ -257,13 +257,13 @@ John Doe
例えば、`Person`クラスという名前のクラスがあるとしましょう:
```Python hl_lines="1 2 3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
変数の型を`Person`として宣言することができます:
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
そして、再び、すべてのエディタのサポートを得ることができます:
@@ -285,7 +285,7 @@ John Doe
Pydanticの公式ドキュメントから引用:
```Python
-{!../../../docs_src/python_types/tutorial011.py!}
+{!../../docs_src/python_types/tutorial011.py!}
```
/// info | "情報"
diff --git a/docs/ja/docs/tutorial/background-tasks.md b/docs/ja/docs/tutorial/background-tasks.md
index 6094c370f..6f9340817 100644
--- a/docs/ja/docs/tutorial/background-tasks.md
+++ b/docs/ja/docs/tutorial/background-tasks.md
@@ -16,7 +16,7 @@
まず初めに、`BackgroundTasks` をインポートし、` BackgroundTasks` の型宣言と共に、*path operation 関数* のパラメーターを定義します:
```Python hl_lines="1 13"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
**FastAPI** は、`BackgroundTasks` 型のオブジェクトを作成し、そのパラメーターに渡します。
@@ -34,7 +34,7 @@
また、書き込み操作では `async` と `await` を使用しないため、通常の `def` で関数を定義します。
```Python hl_lines="6-9"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
## バックグラウンドタスクの追加
@@ -42,7 +42,7 @@
*path operations 関数* 内で、`.add_task()` メソッドを使用してタスク関数を *background tasks* オブジェクトに渡します。
```Python hl_lines="14"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
`.add_task()` は以下の引数を受け取ります:
@@ -58,7 +58,7 @@
**FastAPI** は、それぞれの場合の処理方法と同じオブジェクトの再利用方法を知っているため、すべてのバックグラウンドタスクがマージされ、バックグラウンドで後で実行されます。
```Python hl_lines="13 15 22 25"
-{!../../../docs_src/background_tasks/tutorial002.py!}
+{!../../docs_src/background_tasks/tutorial002.py!}
```
この例では、レスポンスが送信された *後* にメッセージが `log.txt` ファイルに書き込まれます。
diff --git a/docs/ja/docs/tutorial/body-fields.md b/docs/ja/docs/tutorial/body-fields.md
index b9f6d694b..1d386040a 100644
--- a/docs/ja/docs/tutorial/body-fields.md
+++ b/docs/ja/docs/tutorial/body-fields.md
@@ -7,7 +7,7 @@
まず、以下のようにインポートします:
```Python hl_lines="4"
-{!../../../docs_src/body_fields/tutorial001.py!}
+{!../../docs_src/body_fields/tutorial001.py!}
```
/// warning | "注意"
@@ -21,7 +21,7 @@
以下のように`Field`をモデルの属性として使用することができます:
```Python hl_lines="11 12 13 14"
-{!../../../docs_src/body_fields/tutorial001.py!}
+{!../../docs_src/body_fields/tutorial001.py!}
```
`Field`は`Query`や`Path`、`Body`と同じように動作し、全く同様のパラメータなどを持ちます。
diff --git a/docs/ja/docs/tutorial/body-multiple-params.md b/docs/ja/docs/tutorial/body-multiple-params.md
index c051fde24..647143ee5 100644
--- a/docs/ja/docs/tutorial/body-multiple-params.md
+++ b/docs/ja/docs/tutorial/body-multiple-params.md
@@ -9,7 +9,7 @@
また、デフォルトの`None`を設定することで、ボディパラメータをオプションとして宣言することもできます:
```Python hl_lines="19 20 21"
-{!../../../docs_src/body_multiple_params/tutorial001.py!}
+{!../../docs_src/body_multiple_params/tutorial001.py!}
```
/// note | "備考"
@@ -34,7 +34,7 @@
しかし、`item`と`user`のように複数のボディパラメータを宣言することもできます:
```Python hl_lines="22"
-{!../../../docs_src/body_multiple_params/tutorial002.py!}
+{!../../docs_src/body_multiple_params/tutorial002.py!}
```
この場合、**FastAPI**は関数内に複数のボディパラメータ（Pydanticモデルである２つのパラメータ）があることに気付きます。
@@ -78,7 +78,7 @@
```Python hl_lines="23"
-{!../../../docs_src/body_multiple_params/tutorial003.py!}
+{!../../docs_src/body_multiple_params/tutorial003.py!}
```
この場合、**FastAPI** は以下のようなボディを期待します:
@@ -115,7 +115,7 @@ q: str = None
以下において:
```Python hl_lines="27"
-{!../../../docs_src/body_multiple_params/tutorial004.py!}
+{!../../docs_src/body_multiple_params/tutorial004.py!}
```
/// info | "情報"
@@ -139,7 +139,7 @@ item: Item = Body(..., embed=True)
以下において:
```Python hl_lines="17"
-{!../../../docs_src/body_multiple_params/tutorial005.py!}
+{!../../docs_src/body_multiple_params/tutorial005.py!}
```
この場合、**FastAPI** は以下のようなボディを期待します:
diff --git a/docs/ja/docs/tutorial/body-nested-models.md b/docs/ja/docs/tutorial/body-nested-models.md
index 59ee67295..8703a40e7 100644
--- a/docs/ja/docs/tutorial/body-nested-models.md
+++ b/docs/ja/docs/tutorial/body-nested-models.md
@@ -7,7 +7,7 @@
属性をサブタイプとして定義することができます。例えば、Pythonの`list`は以下のように定義できます:
```Python hl_lines="12"
-{!../../../docs_src/body_nested_models/tutorial001.py!}
+{!../../docs_src/body_nested_models/tutorial001.py!}
```
これにより、各項目の型は宣言されていませんが、`tags`はある項目のリストになります。
@@ -21,7 +21,7 @@
まず、Pythonの標準の`typing`モジュールから`List`をインポートします:
```Python hl_lines="1"
-{!../../../docs_src/body_nested_models/tutorial002.py!}
+{!../../docs_src/body_nested_models/tutorial002.py!}
```
### タイプパラメータを持つ`List`の宣言
@@ -44,7 +44,7 @@ my_list: List[str]
そのため、以下の例では`tags`を具体的な「文字列のリスト」にすることができます:
```Python hl_lines="14"
-{!../../../docs_src/body_nested_models/tutorial002.py!}
+{!../../docs_src/body_nested_models/tutorial002.py!}
```
## セット型
@@ -56,7 +56,7 @@ my_list: List[str]
そのため、以下のように、`Set`をインポートして`str`の`set`として`tags`を宣言することができます:
```Python hl_lines="1 14"
-{!../../../docs_src/body_nested_models/tutorial003.py!}
+{!../../docs_src/body_nested_models/tutorial003.py!}
```
これを使えば、データが重複しているリクエストを受けた場合でも、ユニークな項目のセットに変換されます。
@@ -80,7 +80,7 @@ Pydanticモデルの各属性には型があります。
例えば、`Image`モデルを定義することができます:
```Python hl_lines="9 10 11"
-{!../../../docs_src/body_nested_models/tutorial004.py!}
+{!../../docs_src/body_nested_models/tutorial004.py!}
```
### サブモデルを型として使用
@@ -88,7 +88,7 @@ Pydanticモデルの各属性には型があります。
そして、それを属性の型として使用することができます:
```Python hl_lines="20"
-{!../../../docs_src/body_nested_models/tutorial004.py!}
+{!../../docs_src/body_nested_models/tutorial004.py!}
```
これは **FastAPI** が以下のようなボディを期待することを意味します:
@@ -123,7 +123,7 @@ Pydanticモデルの各属性には型があります。
例えば、`Image`モデルのように`url`フィールドがある場合、`str`の代わりにPydanticの`HttpUrl`を指定することができます:
```Python hl_lines="4 10"
-{!../../../docs_src/body_nested_models/tutorial005.py!}
+{!../../docs_src/body_nested_models/tutorial005.py!}
```
文字列は有効なURLであることが確認され、そのようにJSONスキーマ・OpenAPIで文書化されます。
@@ -133,7 +133,7 @@ Pydanticモデルの各属性には型があります。
Pydanticモデルを`list`や`set`などのサブタイプとして使用することもできます:
```Python hl_lines="20"
-{!../../../docs_src/body_nested_models/tutorial006.py!}
+{!../../docs_src/body_nested_models/tutorial006.py!}
```
これは、次のようなJSONボディを期待します（変換、検証、ドキュメントなど）:
@@ -173,7 +173,7 @@ Pydanticモデルを`list`や`set`などのサブタイプとして使用する
深くネストされた任意のモデルを定義することができます:
```Python hl_lines="9 14 20 23 27"
-{!../../../docs_src/body_nested_models/tutorial007.py!}
+{!../../docs_src/body_nested_models/tutorial007.py!}
```
/// info | "情報"
@@ -193,7 +193,7 @@ images: List[Image]
以下のように:
```Python hl_lines="15"
-{!../../../docs_src/body_nested_models/tutorial008.py!}
+{!../../docs_src/body_nested_models/tutorial008.py!}
```
## あらゆる場所でのエディタサポート
@@ -225,7 +225,7 @@ Pydanticモデルではなく、`dict`を直接使用している場合はこの
この場合、`int`のキーと`float`の値を持つものであれば、どんな`dict`でも受け入れることができます:
```Python hl_lines="15"
-{!../../../docs_src/body_nested_models/tutorial009.py!}
+{!../../docs_src/body_nested_models/tutorial009.py!}
```
/// tip | "豆知識"
diff --git a/docs/ja/docs/tutorial/body-updates.md b/docs/ja/docs/tutorial/body-updates.md
index 672a03a64..fde9f4f5e 100644
--- a/docs/ja/docs/tutorial/body-updates.md
+++ b/docs/ja/docs/tutorial/body-updates.md
@@ -7,7 +7,7 @@
`jsonable_encoder`を用いて、入力データをJSON形式で保存できるデータに変換することができます（例：NoSQLデータベース）。例えば、`datetime`を`str`に変換します。
```Python hl_lines="30 31 32 33 34 35"
-{!../../../docs_src/body_updates/tutorial001.py!}
+{!../../docs_src/body_updates/tutorial001.py!}
```
既存のデータを置き換えるべきデータを受け取るために`PUT`は使用されます。
@@ -57,7 +57,7 @@
これを使うことで、デフォルト値を省略して、設定された（リクエストで送られた）データのみを含む`dict`を生成することができます:
```Python hl_lines="34"
-{!../../../docs_src/body_updates/tutorial002.py!}
+{!../../docs_src/body_updates/tutorial002.py!}
```
### Pydanticの`update`パラメータ
@@ -67,7 +67,7 @@
`stored_item_model.copy(update=update_data)`のように:
```Python hl_lines="35"
-{!../../../docs_src/body_updates/tutorial002.py!}
+{!../../docs_src/body_updates/tutorial002.py!}
```
### 部分的更新のまとめ
@@ -86,7 +86,7 @@
* 更新されたモデルを返します。
```Python hl_lines="30 31 32 33 34 35 36 37"
-{!../../../docs_src/body_updates/tutorial002.py!}
+{!../../docs_src/body_updates/tutorial002.py!}
```
/// tip | "豆知識"
diff --git a/docs/ja/docs/tutorial/body.md b/docs/ja/docs/tutorial/body.md
index 017ff8986..888d4388a 100644
--- a/docs/ja/docs/tutorial/body.md
+++ b/docs/ja/docs/tutorial/body.md
@@ -23,7 +23,7 @@ GET リクエストでボディを送信することは、仕様では未定義
ます初めに、 `pydantic` から `BaseModel` をインポートする必要があります:
```Python hl_lines="2"
-{!../../../docs_src/body/tutorial001.py!}
+{!../../docs_src/body/tutorial001.py!}
```
## データモデルの作成
@@ -33,7 +33,7 @@ GET リクエストでボディを送信することは、仕様では未定義
すべての属性にpython標準の型を使用します:
```Python hl_lines="5-9"
-{!../../../docs_src/body/tutorial001.py!}
+{!../../docs_src/body/tutorial001.py!}
```
クエリパラメータの宣言と同様に、モデル属性がデフォルト値をもつとき、必須な属性ではなくなります。それ以外は必須になります。オプショナルな属性にしたい場合は `None` を使用してください。
@@ -63,7 +63,7 @@ GET リクエストでボディを送信することは、仕様では未定義
*パスオペレーション* に加えるために、パスパラメータやクエリパラメータと同じ様に宣言します:
```Python hl_lines="16"
-{!../../../docs_src/body/tutorial001.py!}
+{!../../docs_src/body/tutorial001.py!}
```
...そして、作成したモデル `Item` で型を宣言します。
@@ -132,7 +132,7 @@ GET リクエストでボディを送信することは、仕様では未定義
関数内部で、モデルの全ての属性に直接アクセスできます:
```Python hl_lines="19"
-{!../../../docs_src/body/tutorial002.py!}
+{!../../docs_src/body/tutorial002.py!}
```
## リクエストボディ + パスパラメータ
@@ -142,7 +142,7 @@ GET リクエストでボディを送信することは、仕様では未定義
**FastAPI** はパスパラメータである関数パラメータは**パスから受け取り**、Pydanticモデルによって宣言された関数パラメータは**リクエストボディから受け取る**ということを認識します。
```Python hl_lines="15-16"
-{!../../../docs_src/body/tutorial003.py!}
+{!../../docs_src/body/tutorial003.py!}
```
## リクエストボディ + パスパラメータ + クエリパラメータ
@@ -152,7 +152,7 @@ GET リクエストでボディを送信することは、仕様では未定義
**FastAPI** はそれぞれを認識し、適切な場所からデータを取得します。
```Python hl_lines="16"
-{!../../../docs_src/body/tutorial004.py!}
+{!../../docs_src/body/tutorial004.py!}
```
関数パラメータは以下の様に認識されます:
diff --git a/docs/ja/docs/tutorial/cookie-params.md b/docs/ja/docs/tutorial/cookie-params.md
index 212885209..1f45db17c 100644
--- a/docs/ja/docs/tutorial/cookie-params.md
+++ b/docs/ja/docs/tutorial/cookie-params.md
@@ -7,7 +7,7 @@
まず、`Cookie`をインポートします:
```Python hl_lines="3"
-{!../../../docs_src/cookie_params/tutorial001.py!}
+{!../../docs_src/cookie_params/tutorial001.py!}
```
## `Cookie`のパラメータを宣言
@@ -17,7 +17,7 @@
最初の値がデフォルト値で、追加の検証パラメータや注釈パラメータをすべて渡すことができます:
```Python hl_lines="9"
-{!../../../docs_src/cookie_params/tutorial001.py!}
+{!../../docs_src/cookie_params/tutorial001.py!}
```
/// note | "技術詳細"
diff --git a/docs/ja/docs/tutorial/cors.md b/docs/ja/docs/tutorial/cors.md
index 738240342..9530c51bf 100644
--- a/docs/ja/docs/tutorial/cors.md
+++ b/docs/ja/docs/tutorial/cors.md
@@ -47,7 +47,7 @@
* 特定のHTTPヘッダー、またはワイルドカード `"*"`を使用してすべて許可。
```Python hl_lines="2 6-11 13-19"
-{!../../../docs_src/cors/tutorial001.py!}
+{!../../docs_src/cors/tutorial001.py!}
```
`CORSMiddleware` 実装のデフォルトのパラメータはCORSに関して制限を与えるものになっているので、ブラウザにドメインを跨いで特定のオリジン、メソッド、またはヘッダーを使用可能にするためには、それらを明示的に有効にする必要があります
diff --git a/docs/ja/docs/tutorial/debugging.md b/docs/ja/docs/tutorial/debugging.md
index 06b8ad277..be0ff81d4 100644
--- a/docs/ja/docs/tutorial/debugging.md
+++ b/docs/ja/docs/tutorial/debugging.md
@@ -7,7 +7,7 @@ Visual Studio CodeやPyCharmなどを使用して、エディター上でデバ
FastAPIアプリケーション上で、`uvicorn` を直接インポートして実行します:
```Python hl_lines="1 15"
-{!../../../docs_src/debugging/tutorial001.py!}
+{!../../docs_src/debugging/tutorial001.py!}
```
### `__name__ == "__main__"` について
diff --git a/docs/ja/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/ja/docs/tutorial/dependencies/classes-as-dependencies.md
index 69b67d042..fb23a7b2b 100644
--- a/docs/ja/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/ja/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -7,7 +7,7 @@
前の例では、依存関係（"dependable"）から`dict`を返していました:
```Python hl_lines="9"
-{!../../../docs_src/dependencies/tutorial001.py!}
+{!../../docs_src/dependencies/tutorial001.py!}
```
しかし、*path operation関数*のパラメータ`commons`に`dict`が含まれています。
@@ -72,19 +72,19 @@ FastAPIが実際にチェックしているのは、それが「呼び出し可
そこで、上で紹介した依存関係の`common_parameters`を`CommonQueryParams`クラスに変更します:
```Python hl_lines="11 12 13 14 15"
-{!../../../docs_src/dependencies/tutorial002.py!}
+{!../../docs_src/dependencies/tutorial002.py!}
```
クラスのインスタンスを作成するために使用される`__init__`メソッドに注目してください:
```Python hl_lines="12"
-{!../../../docs_src/dependencies/tutorial002.py!}
+{!../../docs_src/dependencies/tutorial002.py!}
```
...以前の`common_parameters`と同じパラメータを持っています:
```Python hl_lines="8"
-{!../../../docs_src/dependencies/tutorial001.py!}
+{!../../docs_src/dependencies/tutorial001.py!}
```
これらのパラメータは **FastAPI** が依存関係を「解決」するために使用するものです。
@@ -102,7 +102,7 @@ FastAPIが実際にチェックしているのは、それが「呼び出し可
これで、このクラスを使用して依存関係を宣言することができます。
```Python hl_lines="19"
-{!../../../docs_src/dependencies/tutorial002.py!}
+{!../../docs_src/dependencies/tutorial002.py!}
```
**FastAPI** は`CommonQueryParams`クラスを呼び出します。これにより、そのクラスの「インスタンス」が作成され、インスタンスはパラメータ`commons`として関数に渡されます。
@@ -144,7 +144,7 @@ commons = Depends(CommonQueryParams)
以下にあるように:
```Python hl_lines="19"
-{!../../../docs_src/dependencies/tutorial003.py!}
+{!../../docs_src/dependencies/tutorial003.py!}
```
しかし、型を宣言することは推奨されています。そうすれば、エディタは`commons`のパラメータとして何が渡されるかを知ることができ、コードの補完や型チェックなどを行うのに役立ちます:
@@ -180,7 +180,7 @@ commons: CommonQueryParams = Depends()
同じ例では以下のようになります:
```Python hl_lines="19"
-{!../../../docs_src/dependencies/tutorial004.py!}
+{!../../docs_src/dependencies/tutorial004.py!}
```
...そして **FastAPI** は何をすべきか知っています。
diff --git a/docs/ja/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/ja/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index c6472cab5..59f21c3df 100644
--- a/docs/ja/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/ja/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -15,7 +15,7 @@
それは`Depends()`の`list`であるべきです:
```Python hl_lines="17"
-{!../../../docs_src/dependencies/tutorial006.py!}
+{!../../docs_src/dependencies/tutorial006.py!}
```
これらの依存関係は、通常の依存関係と同様に実行・解決されます。しかし、それらの値（何かを返す場合）は*path operation関数*には渡されません。
@@ -39,7 +39,7 @@
これらはリクエストの要件（ヘッダのようなもの）やその他のサブ依存関係を宣言することができます:
```Python hl_lines="6 11"
-{!../../../docs_src/dependencies/tutorial006.py!}
+{!../../docs_src/dependencies/tutorial006.py!}
```
### 例外の発生
@@ -47,7 +47,7 @@
これらの依存関係は通常の依存関係と同じように、例外を`raise`発生させることができます:
```Python hl_lines="8 13"
-{!../../../docs_src/dependencies/tutorial006.py!}
+{!../../docs_src/dependencies/tutorial006.py!}
```
### 戻り値
@@ -57,7 +57,7 @@
つまり、すでにどこかで使っている通常の依存関係（値を返すもの）を再利用することができ、値は使われなくても依存関係は実行されます:
```Python hl_lines="9 14"
-{!../../../docs_src/dependencies/tutorial006.py!}
+{!../../docs_src/dependencies/tutorial006.py!}
```
## *path operations*のグループに対する依存関係
diff --git a/docs/ja/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/ja/docs/tutorial/dependencies/dependencies-with-yield.md
index 3f22a7a7b..7ef1caf0d 100644
--- a/docs/ja/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/ja/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -42,19 +42,19 @@ pip install async-exit-stack async-generator
レスポンスを送信する前に`yield`文を含む前のコードのみが実行されます。
```Python hl_lines="2 3 4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
生成された値は、*path operations*や他の依存関係に注入されるものです:
```Python hl_lines="4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
`yield`文に続くコードは、レスポンスが送信された後に実行されます:
```Python hl_lines="5 6"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
/// tip | "豆知識"
@@ -76,7 +76,7 @@ pip install async-exit-stack async-generator
同様に、`finally`を用いて例外があったかどうかにかかわらず、終了ステップを確実に実行することができます。
```Python hl_lines="3 5"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
## `yield`を持つサブ依存関係
@@ -88,7 +88,7 @@ pip install async-exit-stack async-generator
例えば、`dependency_c`は`dependency_b`と`dependency_b`に依存する`dependency_a`に、依存することができます:
```Python hl_lines="4 12 20"
-{!../../../docs_src/dependencies/tutorial008.py!}
+{!../../docs_src/dependencies/tutorial008.py!}
```
そして、それらはすべて`yield`を使用することができます。
@@ -98,7 +98,7 @@ pip install async-exit-stack async-generator
そして、`dependency_b`は`dependency_a`（ここでは`dep_a`という名前）の値を終了コードで利用できるようにする必要があります。
```Python hl_lines="16 17 24 25"
-{!../../../docs_src/dependencies/tutorial008.py!}
+{!../../docs_src/dependencies/tutorial008.py!}
```
同様に、`yield`と`return`が混在した依存関係を持つこともできます。
@@ -234,7 +234,7 @@ Pythonでは、<a href="https://docs.python.org/3/reference/datamodel.html#conte
また、依存関数の中で`with`や`async with`文を使用することによって`yield`を持つ **FastAPI** の依存関係の中でそれらを使用することができます:
```Python hl_lines="1 2 3 4 5 6 7 8 9 13"
-{!../../../docs_src/dependencies/tutorial010.py!}
+{!../../docs_src/dependencies/tutorial010.py!}
```
/// tip | "豆知識"
diff --git a/docs/ja/docs/tutorial/dependencies/index.md b/docs/ja/docs/tutorial/dependencies/index.md
index 000148d1c..f6728ee84 100644
--- a/docs/ja/docs/tutorial/dependencies/index.md
+++ b/docs/ja/docs/tutorial/dependencies/index.md
@@ -32,7 +32,7 @@
以下のように、*path operation関数*と同じパラメータを全て取ることができる関数にすぎません:
```Python hl_lines="8 9"
-{!../../../docs_src/dependencies/tutorial001.py!}
+{!../../docs_src/dependencies/tutorial001.py!}
```
これだけです。
@@ -56,7 +56,7 @@
### `Depends`のインポート
```Python hl_lines="3"
-{!../../../docs_src/dependencies/tutorial001.py!}
+{!../../docs_src/dependencies/tutorial001.py!}
```
### "dependant"での依存関係の宣言
@@ -64,7 +64,7 @@
*path operation関数*のパラメータに`Body`や`Query`などを使用するのと同じように、新しいパラメータに`Depends`を使用することができます:
```Python hl_lines="13 18"
-{!../../../docs_src/dependencies/tutorial001.py!}
+{!../../docs_src/dependencies/tutorial001.py!}
```
関数のパラメータに`Depends`を使用するのは`Body`や`Query`などと同じですが、`Depends`の動作は少し異なります。
diff --git a/docs/ja/docs/tutorial/dependencies/sub-dependencies.md b/docs/ja/docs/tutorial/dependencies/sub-dependencies.md
index e183f28ba..754ec028e 100644
--- a/docs/ja/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/ja/docs/tutorial/dependencies/sub-dependencies.md
@@ -11,7 +11,7 @@
以下のような最初の依存関係（「依存可能なもの」）を作成することができます:
```Python hl_lines="8 9"
-{!../../../docs_src/dependencies/tutorial005.py!}
+{!../../docs_src/dependencies/tutorial005.py!}
```
これはオプショナルのクエリパラメータ`q`を`str`として宣言し、それを返すだけです。
@@ -23,7 +23,7 @@
そして、別の依存関数（「依存可能なもの」）を作成して、同時にそれ自身の依存関係を宣言することができます（つまりそれ自身も「依存」です）:
```Python hl_lines="13"
-{!../../../docs_src/dependencies/tutorial005.py!}
+{!../../docs_src/dependencies/tutorial005.py!}
```
宣言されたパラメータに注目してみましょう:
@@ -38,7 +38,7 @@
以下のように依存関係を使用することができます:
```Python hl_lines="21"
-{!../../../docs_src/dependencies/tutorial005.py!}
+{!../../docs_src/dependencies/tutorial005.py!}
```
/// info | "情報"
diff --git a/docs/ja/docs/tutorial/encoder.md b/docs/ja/docs/tutorial/encoder.md
index 086e1fc63..ea522f91f 100644
--- a/docs/ja/docs/tutorial/encoder.md
+++ b/docs/ja/docs/tutorial/encoder.md
@@ -21,7 +21,7 @@ JSON互換のデータのみを受信するデータベース`fase_db`がある
Pydanticモデルのようなオブジェクトを受け取り、JSON互換版を返します:
```Python hl_lines="5 22"
-{!../../../docs_src/encoder/tutorial001.py!}
+{!../../docs_src/encoder/tutorial001.py!}
```
この例では、Pydanticモデルを`dict`に、`datetime`を`str`に変換します。
diff --git a/docs/ja/docs/tutorial/extra-data-types.md b/docs/ja/docs/tutorial/extra-data-types.md
index c0fdbd58c..7f1b14648 100644
--- a/docs/ja/docs/tutorial/extra-data-types.md
+++ b/docs/ja/docs/tutorial/extra-data-types.md
@@ -56,11 +56,11 @@
ここでは、上記の型のいくつかを使用したパラメータを持つ*path operation*の例を示します。
```Python hl_lines="1 2 12-16"
-{!../../../docs_src/extra_data_types/tutorial001.py!}
+{!../../docs_src/extra_data_types/tutorial001.py!}
```
関数内のパラメータは自然なデータ型を持っていることに注意してください。そして、以下のように通常の日付操作を行うことができます:
```Python hl_lines="18 19"
-{!../../../docs_src/extra_data_types/tutorial001.py!}
+{!../../docs_src/extra_data_types/tutorial001.py!}
```
diff --git a/docs/ja/docs/tutorial/extra-models.md b/docs/ja/docs/tutorial/extra-models.md
index 90a22d3fa..f739e81b4 100644
--- a/docs/ja/docs/tutorial/extra-models.md
+++ b/docs/ja/docs/tutorial/extra-models.md
@@ -21,7 +21,7 @@
ここでは、パスワードフィールドをもつモデルがどのように見えるのか、また、どこで使われるのか、大まかなイメージを紹介します:
```Python hl_lines="9 11 16 22 24 29-30 33-35 40-41"
-{!../../../docs_src/extra_models/tutorial001.py!}
+{!../../docs_src/extra_models/tutorial001.py!}
```
### `**user_in.dict()`について
@@ -157,7 +157,7 @@ UserInDB(
このようにして、モデル間の違いだけを宣言することができます:
```Python hl_lines="9 15 16 19 20 23 24"
-{!../../../docs_src/extra_models/tutorial002.py!}
+{!../../docs_src/extra_models/tutorial002.py!}
```
## `Union`または`anyOf`
@@ -169,7 +169,7 @@ OpenAPIでは`anyOf`で定義されます。
そのためには、標準的なPythonの型ヒント<a href="https://docs.python.org/3/library/typing.html#typing.Union" class="external-link" target="_blank">`typing.Union`</a>を使用します:
```Python hl_lines="1 14 15 18 19 20 33"
-{!../../../docs_src/extra_models/tutorial003.py!}
+{!../../docs_src/extra_models/tutorial003.py!}
```
## モデルのリスト
@@ -179,7 +179,7 @@ OpenAPIでは`anyOf`で定義されます。
そのためには、標準のPythonの`typing.List`を使用する:
```Python hl_lines="1 20"
-{!../../../docs_src/extra_models/tutorial004.py!}
+{!../../docs_src/extra_models/tutorial004.py!}
```
## 任意の`dict`を持つレスポンス
@@ -191,7 +191,7 @@ OpenAPIでは`anyOf`で定義されます。
この場合、`typing.Dict`を使用することができます:
```Python hl_lines="1 8"
-{!../../../docs_src/extra_models/tutorial005.py!}
+{!../../docs_src/extra_models/tutorial005.py!}
```
## まとめ
diff --git a/docs/ja/docs/tutorial/first-steps.md b/docs/ja/docs/tutorial/first-steps.md
index dbe8e4518..77f3b5fbe 100644
--- a/docs/ja/docs/tutorial/first-steps.md
+++ b/docs/ja/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
最もシンプルなFastAPIファイルは以下のようになります:
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
これを`main.py`にコピーします。
@@ -134,7 +134,7 @@ OpenAPIスキーマは、FastAPIに含まれている2つのインタラクテ
### Step 1: `FastAPI`をインポート
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI`は、APIのすべての機能を提供するPythonクラスです。
@@ -150,7 +150,7 @@ OpenAPIスキーマは、FastAPIに含まれている2つのインタラクテ
### Step 2: `FastAPI`の「インスタンス」を生成
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
ここで、`app`変数が`FastAPI`クラスの「インスタンス」になります。
@@ -171,7 +171,7 @@ $ uvicorn main:app --reload
以下のようなアプリを作成したとき:
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial002.py!}
+{!../../docs_src/first_steps/tutorial002.py!}
```
そして、それを`main.py`ファイルに置き、次のように`uvicorn`を呼び出します:
@@ -250,7 +250,7 @@ APIを構築するときは、通常、これらの特定のHTTPメソッドを
#### *パスオペレーションデコレータ*を定義
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`@app.get("/")`は直下の関数が下記のリクエストの処理を担当することを**FastAPI**に伝えます:
@@ -305,7 +305,7 @@ Pythonにおける`@something`シンタックスはデコレータと呼ばれ
* **関数**: 「デコレータ」の直下にある関数 (`@app.get("/")`の直下) です。
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
これは、Pythonの関数です。
@@ -319,7 +319,7 @@ Pythonにおける`@something`シンタックスはデコレータと呼ばれ
`async def`の代わりに通常の関数として定義することもできます:
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note | "備考"
@@ -331,7 +331,7 @@ Pythonにおける`@something`シンタックスはデコレータと呼ばれ
### Step 5: コンテンツの返信
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`dict`、`list`、`str`、`int`などを返すことができます。
diff --git a/docs/ja/docs/tutorial/handling-errors.md b/docs/ja/docs/tutorial/handling-errors.md
index 8be054858..e94f16b21 100644
--- a/docs/ja/docs/tutorial/handling-errors.md
+++ b/docs/ja/docs/tutorial/handling-errors.md
@@ -26,7 +26,7 @@ HTTPレスポンスをエラーでクライアントに返すには、`HTTPExcep
### `HTTPException`のインポート
```Python hl_lines="1"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
### コード内での`HTTPException`の発生
@@ -42,7 +42,7 @@ Pythonの例外なので、`return`ではなく、`raise`です。
この例では、クライアントが存在しないIDでアイテムを要求した場合、`404`のステータスコードを持つ例外を発生させます:
```Python hl_lines="11"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
### レスポンス結果
@@ -82,7 +82,7 @@ Pythonの例外なので、`return`ではなく、`raise`です。
しかし、高度なシナリオのために必要な場合には、カスタムヘッダーを追加することができます:
```Python hl_lines="14"
-{!../../../docs_src/handling_errors/tutorial002.py!}
+{!../../docs_src/handling_errors/tutorial002.py!}
```
## カスタム例外ハンドラのインストール
@@ -96,7 +96,7 @@ Pythonの例外なので、`return`ではなく、`raise`です。
カスタム例外ハンドラを`@app.exception_handler()`で追加することができます:
```Python hl_lines="5 6 7 13 14 15 16 17 18 24"
-{!../../../docs_src/handling_errors/tutorial003.py!}
+{!../../docs_src/handling_errors/tutorial003.py!}
```
ここで、`/unicorns/yolo`をリクエストすると、*path operation*は`UnicornException`を`raise`します。
@@ -136,7 +136,7 @@ Pythonの例外なので、`return`ではなく、`raise`です。
この例外ハンドラは`Requset`と例外を受け取ります。
```Python hl_lines="2 14 15 16"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
これで、`/items/foo`にアクセスすると、デフォルトのJSONエラーの代わりに以下が返されます:
@@ -189,7 +189,7 @@ path -> item_id
例えば、これらのエラーに対しては、JSONではなくプレーンテキストを返すようにすることができます:
```Python hl_lines="3 4 9 10 11 22"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
/// note | "技術詳細"
@@ -207,7 +207,7 @@ path -> item_id
アプリ開発中に本体のログを取ってデバッグしたり、ユーザーに返したりなどに使用することができます。
```Python hl_lines="14"
-{!../../../docs_src/handling_errors/tutorial005.py!}
+{!../../docs_src/handling_errors/tutorial005.py!}
```
ここで、以下のような無効な項目を送信してみてください:
@@ -269,7 +269,7 @@ from starlette.exceptions import HTTPException as StarletteHTTPException
デフォルトの例外ハンドラを`fastapi.exception_handlers`からインポートして再利用することができます:
```Python hl_lines="2 3 4 5 15 21"
-{!../../../docs_src/handling_errors/tutorial006.py!}
+{!../../docs_src/handling_errors/tutorial006.py!}
```
この例では、非常に表現力のあるメッセージでエラーを`print`しています。
diff --git a/docs/ja/docs/tutorial/header-params.md b/docs/ja/docs/tutorial/header-params.md
index 4fab3d423..3180b78b5 100644
--- a/docs/ja/docs/tutorial/header-params.md
+++ b/docs/ja/docs/tutorial/header-params.md
@@ -7,7 +7,7 @@
まず、`Header`をインポートします:
```Python hl_lines="3"
-{!../../../docs_src/header_params/tutorial001.py!}
+{!../../docs_src/header_params/tutorial001.py!}
```
## `Header`のパラメータの宣言
@@ -17,7 +17,7 @@
最初の値がデフォルト値で、追加の検証パラメータや注釈パラメータをすべて渡すことができます。
```Python hl_lines="9"
-{!../../../docs_src/header_params/tutorial001.py!}
+{!../../docs_src/header_params/tutorial001.py!}
```
/// note | "技術詳細"
@@ -51,7 +51,7 @@
もしなんらかの理由でアンダースコアからハイフンへの自動変換を無効にする必要がある場合は、`Header`の`convert_underscores`に`False`を設定してください:
```Python hl_lines="9"
-{!../../../docs_src/header_params/tutorial002.py!}
+{!../../docs_src/header_params/tutorial002.py!}
```
/// warning | "注意"
@@ -71,7 +71,7 @@
例えば、複数回出現する可能性のある`X-Token`のヘッダを定義するには、以下のように書くことができます:
```Python hl_lines="9"
-{!../../../docs_src/header_params/tutorial003.py!}
+{!../../docs_src/header_params/tutorial003.py!}
```
もし、その*path operation*で通信する場合は、次のように２つのHTTPヘッダーを送信します:
diff --git a/docs/ja/docs/tutorial/metadata.md b/docs/ja/docs/tutorial/metadata.md
index eb85dc389..8285b479e 100644
--- a/docs/ja/docs/tutorial/metadata.md
+++ b/docs/ja/docs/tutorial/metadata.md
@@ -14,7 +14,7 @@
これらを設定するには、パラメータ `title`、`description`、`version` を使用します:
```Python hl_lines="4-6"
-{!../../../docs_src/metadata/tutorial001.py!}
+{!../../docs_src/metadata/tutorial001.py!}
```
この設定では、自動APIドキュメントは以下の様になります:
@@ -42,7 +42,7 @@
タグのためのメタデータを作成し、それを `openapi_tags` パラメータに渡します。
```Python hl_lines="3-16 18"
-{!../../../docs_src/metadata/tutorial004.py!}
+{!../../docs_src/metadata/tutorial004.py!}
```
説明文 (description) の中で Markdown を使用できることに注意してください。たとえば、「login」は太字 (**login**) で表示され、「fancy」は斜体 (_fancy_) で表示されます。
@@ -58,7 +58,7 @@
`tags` パラメーターを使用して、それぞれの *path operations* (および `APIRouter`) を異なるタグに割り当てます:
```Python hl_lines="21 26"
-{!../../../docs_src/metadata/tutorial004.py!}
+{!../../docs_src/metadata/tutorial004.py!}
```
/// info | "情報"
@@ -88,7 +88,7 @@
たとえば、`/api/v1/openapi.json` で提供されるように設定するには:
```Python hl_lines="3"
-{!../../../docs_src/metadata/tutorial002.py!}
+{!../../docs_src/metadata/tutorial002.py!}
```
OpenAPIスキーマを完全に無効にする場合は、`openapi_url=None` を設定できます。これにより、それを使用するドキュメントUIも無効になります。
@@ -107,5 +107,5 @@ OpenAPIスキーマを完全に無効にする場合は、`openapi_url=None` を
たとえば、`/documentation` でSwagger UIが提供されるように設定し、ReDocを無効にするには:
```Python hl_lines="3"
-{!../../../docs_src/metadata/tutorial003.py!}
+{!../../docs_src/metadata/tutorial003.py!}
```
diff --git a/docs/ja/docs/tutorial/middleware.md b/docs/ja/docs/tutorial/middleware.md
index 05e1b7a8c..f4a503720 100644
--- a/docs/ja/docs/tutorial/middleware.md
+++ b/docs/ja/docs/tutorial/middleware.md
@@ -32,7 +32,7 @@
* その後、`response` を返す前にさらに `response` を変更することもできます。
```Python hl_lines="8-9 11 14"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
/// tip | "豆知識"
@@ -60,7 +60,7 @@
例えば、リクエストの処理とレスポンスの生成にかかった秒数を含むカスタムヘッダー `X-Process-Time` を追加できます:
```Python hl_lines="10 12-13"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
## その他のミドルウェア
diff --git a/docs/ja/docs/tutorial/path-operation-configuration.md b/docs/ja/docs/tutorial/path-operation-configuration.md
index def12bd08..7eceb377d 100644
--- a/docs/ja/docs/tutorial/path-operation-configuration.md
+++ b/docs/ja/docs/tutorial/path-operation-configuration.md
@@ -17,7 +17,7 @@
しかし、それぞれの番号コードが何のためのものか覚えていない場合は、`status`のショートカット定数を使用することができます:
```Python hl_lines="3 17"
-{!../../../docs_src/path_operation_configuration/tutorial001.py!}
+{!../../docs_src/path_operation_configuration/tutorial001.py!}
```
そのステータスコードはレスポンスで使用され、OpenAPIスキーマに追加されます。
@@ -35,7 +35,7 @@
`tags`パラメータを`str`の`list`（通常は１つの`str`）と一緒に渡すと、*path operation*にタグを追加できます:
```Python hl_lines="17 22 27"
-{!../../../docs_src/path_operation_configuration/tutorial002.py!}
+{!../../docs_src/path_operation_configuration/tutorial002.py!}
```
これらはOpenAPIスキーマに追加され、自動ドキュメントのインターフェースで使用されます:
@@ -47,7 +47,7 @@
`summary`と`description`を追加できます:
```Python hl_lines="20-21"
-{!../../../docs_src/path_operation_configuration/tutorial003.py!}
+{!../../docs_src/path_operation_configuration/tutorial003.py!}
```
## docstringを用いた説明
@@ -57,7 +57,7 @@
docstringに<a href="https://en.wikipedia.org/wiki/Markdown" class="external-link" target="_blank">Markdown</a>を記述すれば、正しく解釈されて表示されます。（docstringのインデントを考慮して）
```Python hl_lines="19-27"
-{!../../../docs_src/path_operation_configuration/tutorial004.py!}
+{!../../docs_src/path_operation_configuration/tutorial004.py!}
```
これは対話的ドキュメントで使用されます:
@@ -69,7 +69,7 @@ docstringに<a href="https://en.wikipedia.org/wiki/Markdown" class="external-lin
`response_description`パラメータでレスポンスの説明をすることができます。
```Python hl_lines="21"
-{!../../../docs_src/path_operation_configuration/tutorial005.py!}
+{!../../docs_src/path_operation_configuration/tutorial005.py!}
```
/// info | "情報"
@@ -93,7 +93,7 @@ OpenAPIは*path operation*ごとにレスポンスの説明を必要としてい
*path operation*を<abbr title="非推奨、使わない方がよい">deprecated</abbr>としてマークする必要があるが、それを削除しない場合は、`deprecated`パラメータを渡します:
```Python hl_lines="16"
-{!../../../docs_src/path_operation_configuration/tutorial006.py!}
+{!../../docs_src/path_operation_configuration/tutorial006.py!}
```
対話的ドキュメントでは非推奨と明記されます:
diff --git a/docs/ja/docs/tutorial/path-params-numeric-validations.md b/docs/ja/docs/tutorial/path-params-numeric-validations.md
index 9f0b72585..42fbb2ee2 100644
--- a/docs/ja/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/ja/docs/tutorial/path-params-numeric-validations.md
@@ -7,7 +7,7 @@
まず初めに、`fastapi`から`Path`をインポートします:
```Python hl_lines="1"
-{!../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
## メタデータの宣言
@@ -17,7 +17,7 @@
例えば、パスパラメータ`item_id`に対して`title`のメタデータを宣言するには以下のようにします:
```Python hl_lines="8"
-{!../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
/// note | "備考"
@@ -47,7 +47,7 @@ Pythonは「デフォルト」を持たない値の前に「デフォルト」
そのため、以下のように関数を宣言することができます:
```Python hl_lines="8"
-{!../../../docs_src/path_params_numeric_validations/tutorial002.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial002.py!}
```
## 必要に応じてパラメータを並び替えるトリック
@@ -59,7 +59,7 @@ Pythonは「デフォルト」を持たない値の前に「デフォルト」
Pythonはその`*`で何かをすることはありませんが、それ以降のすべてのパラメータがキーワード引数（キーと値のペア）として呼ばれるべきものであると知っているでしょう。それは<abbr title="From: K-ey W-ord Arg-uments"><code>kwargs</code></abbr>としても知られています。たとえデフォルト値がなくても。
```Python hl_lines="8"
-{!../../../docs_src/path_params_numeric_validations/tutorial003.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial003.py!}
```
## 数値の検証: 以上
@@ -69,7 +69,7 @@ Pythonはその`*`で何かをすることはありませんが、それ以降
ここで、`ge=1`の場合、`item_id`は`1`「より大きい`g`か、同じ`e`」整数でなれけばなりません。
```Python hl_lines="8"
-{!../../../docs_src/path_params_numeric_validations/tutorial004.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial004.py!}
```
## 数値の検証: より大きいと小なりイコール
@@ -80,7 +80,7 @@ Pythonはその`*`で何かをすることはありませんが、それ以降
* `le`: 小なりイコール（`l`ess than or `e`qual）
```Python hl_lines="9"
-{!../../../docs_src/path_params_numeric_validations/tutorial005.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial005.py!}
```
## 数値の検証: 浮動小数点、 大なり小なり
@@ -94,7 +94,7 @@ Pythonはその`*`で何かをすることはありませんが、それ以降
これは<abbr title="未満"><code>lt</code></abbr>も同じです。
```Python hl_lines="11"
-{!../../../docs_src/path_params_numeric_validations/tutorial006.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial006.py!}
```
## まとめ
diff --git a/docs/ja/docs/tutorial/path-params.md b/docs/ja/docs/tutorial/path-params.md
index 0a7916012..e1cb67a13 100644
--- a/docs/ja/docs/tutorial/path-params.md
+++ b/docs/ja/docs/tutorial/path-params.md
@@ -3,7 +3,7 @@
Pythonのformat文字列と同様のシンタックスで「パスパラメータ」や「パス変数」を宣言できます:
```Python hl_lines="6 7"
-{!../../../docs_src/path_params/tutorial001.py!}
+{!../../docs_src/path_params/tutorial001.py!}
```
パスパラメータ `item_id` の値は、引数 `item_id` として関数に渡されます。
@@ -19,7 +19,7 @@ Pythonのformat文字列と同様のシンタックスで「パスパラメー
標準のPythonの型アノテーションを使用して、関数内のパスパラメータの型を宣言できます:
```Python hl_lines="7"
-{!../../../docs_src/path_params/tutorial002.py!}
+{!../../docs_src/path_params/tutorial002.py!}
```
ここでは、 `item_id` は `int` として宣言されています。
@@ -122,7 +122,7 @@ Pythonのformat文字列と同様のシンタックスで「パスパラメー
*path operations* は順に評価されるので、 `/users/me` が `/users/{user_id}` よりも先に宣言されているか確認する必要があります:
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003.py!}
+{!../../docs_src/path_params/tutorial003.py!}
```
それ以外の場合、 `/users/{users_id}` は `/users/me` としてもマッチします。値が「"me"」であるパラメータ `user_id` を受け取ると「考え」ます。
@@ -140,7 +140,7 @@ Pythonのformat文字列と同様のシンタックスで「パスパラメー
そして、固定値のクラス属性を作ります。すると、その値が使用可能な値となります:
```Python hl_lines="1 6 7 8 9"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// info | "情報"
@@ -160,7 +160,7 @@ Pythonのformat文字列と同様のシンタックスで「パスパラメー
次に、作成したenumクラスである`ModelName`を使用した型アノテーションをもつ*パスパラメータ*を作成します:
```Python hl_lines="16"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
### ドキュメントの確認
@@ -178,7 +178,7 @@ Pythonのformat文字列と同様のシンタックスで「パスパラメー
これは、作成した列挙型 `ModelName` の*列挙型メンバ*と比較できます:
```Python hl_lines="17"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
#### *列挙値*の取得
@@ -186,7 +186,7 @@ Pythonのformat文字列と同様のシンタックスで「パスパラメー
`model_name.value` 、もしくは一般に、 `your_enum_member.value` を使用して実際の値 (この場合は `str`) を取得できます。
```Python hl_lines="20"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// tip | "豆知識"
@@ -202,7 +202,7 @@ Pythonのformat文字列と同様のシンタックスで「パスパラメー
それらはクライアントに返される前に適切な値 (この場合は文字列) に変換されます。
```Python hl_lines="18 21 23"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
クライアントは以下の様なJSONレスポンスを得ます:
@@ -243,7 +243,7 @@ Starletteのオプションを直接使用することで、以下のURLの様
したがって、以下の様に使用できます:
```Python hl_lines="6"
-{!../../../docs_src/path_params/tutorial004.py!}
+{!../../docs_src/path_params/tutorial004.py!}
```
/// tip | "豆知識"
diff --git a/docs/ja/docs/tutorial/query-params-str-validations.md b/docs/ja/docs/tutorial/query-params-str-validations.md
index ada048844..9e54a6f55 100644
--- a/docs/ja/docs/tutorial/query-params-str-validations.md
+++ b/docs/ja/docs/tutorial/query-params-str-validations.md
@@ -5,7 +5,7 @@
以下のアプリケーションを例にしてみましょう:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial001.py!}
+{!../../docs_src/query_params_str_validations/tutorial001.py!}
```
クエリパラメータ `q` は `Optional[str]` 型で、`None` を許容する `str` 型を意味しており、デフォルトは `None` です。そのため、FastAPIはそれが必須ではないと理解します。
@@ -27,7 +27,7 @@ FastAPIは、 `q` はデフォルト値が `=None` であるため、必須で
そのために、まずは`fastapi`から`Query`をインポートします:
```Python hl_lines="3"
-{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!../../docs_src/query_params_str_validations/tutorial002.py!}
```
## デフォルト値として`Query`を使用
@@ -35,7 +35,7 @@ FastAPIは、 `q` はデフォルト値が `=None` であるため、必須で
パラメータのデフォルト値として使用し、パラメータ`max_length`を50に設定します:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!../../docs_src/query_params_str_validations/tutorial002.py!}
```
デフォルト値`None`を`Query(default=None)`に置き換える必要があるので、`Query`の最初の引数はデフォルト値を定義するのと同じです。
@@ -87,7 +87,7 @@ q: Union[str, None] = Query(default=None, max_length=50)
パラメータ`min_length`も追加することができます:
```Python hl_lines="10"
-{!../../../docs_src/query_params_str_validations/tutorial003.py!}
+{!../../docs_src/query_params_str_validations/tutorial003.py!}
```
## 正規表現の追加
@@ -95,7 +95,7 @@ q: Union[str, None] = Query(default=None, max_length=50)
パラメータが一致するべき<abbr title="正規表現とは、文字列の検索パターンを定義する文字列です。">正規表現</abbr>を定義することができます:
```Python hl_lines="11"
-{!../../../docs_src/query_params_str_validations/tutorial004.py!}
+{!../../docs_src/query_params_str_validations/tutorial004.py!}
```
この特定の正規表現は受け取ったパラメータの値をチェックします:
@@ -115,7 +115,7 @@ q: Union[str, None] = Query(default=None, max_length=50)
クエリパラメータ`q`の`min_length`を`3`とし、デフォルト値を`fixedquery`としてみましょう:
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial005.py!}
+{!../../docs_src/query_params_str_validations/tutorial005.py!}
```
/// note | "備考"
@@ -147,7 +147,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
そのため、`Query`を使用して必須の値を宣言する必要がある場合は、第一引数に`...`を使用することができます:
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial006.py!}
+{!../../docs_src/query_params_str_validations/tutorial006.py!}
```
/// info | "情報"
@@ -165,7 +165,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
例えば、URL内に複数回出現するクエリパラメータ`q`を宣言するには以下のように書きます:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial011.py!}
+{!../../docs_src/query_params_str_validations/tutorial011.py!}
```
そしてURLは以下です:
@@ -202,7 +202,7 @@ http://localhost:8000/items/?q=foo&q=bar
また、値が指定されていない場合はデフォルトの`list`を定義することもできます。
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial012.py!}
+{!../../docs_src/query_params_str_validations/tutorial012.py!}
```
以下のURLを開くと:
@@ -227,7 +227,7 @@ http://localhost:8000/items/
`List[str]`の代わりに直接`list`を使うこともできます:
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial013.py!}
+{!../../docs_src/query_params_str_validations/tutorial013.py!}
```
/// note | "備考"
@@ -255,13 +255,13 @@ http://localhost:8000/items/
`title`を追加できます:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial007.py!}
+{!../../docs_src/query_params_str_validations/tutorial007.py!}
```
`description`を追加できます:
```Python hl_lines="13"
-{!../../../docs_src/query_params_str_validations/tutorial008.py!}
+{!../../docs_src/query_params_str_validations/tutorial008.py!}
```
## エイリアスパラメータ
@@ -283,7 +283,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
それならば、`alias`を宣言することができます。エイリアスはパラメータの値を見つけるのに使用されます:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial009.py!}
+{!../../docs_src/query_params_str_validations/tutorial009.py!}
```
## 非推奨パラメータ
@@ -295,7 +295,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
その場合、`Query`にパラメータ`deprecated=True`を渡します:
```Python hl_lines="18"
-{!../../../docs_src/query_params_str_validations/tutorial010.py!}
+{!../../docs_src/query_params_str_validations/tutorial010.py!}
```
ドキュメントは以下のようになります:
diff --git a/docs/ja/docs/tutorial/query-params.md b/docs/ja/docs/tutorial/query-params.md
index c0eb2d096..6d41d3742 100644
--- a/docs/ja/docs/tutorial/query-params.md
+++ b/docs/ja/docs/tutorial/query-params.md
@@ -3,7 +3,7 @@
パスパラメータではない関数パラメータを宣言すると、それらは自動的に "クエリ" パラメータとして解釈されます。
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial001.py!}
+{!../../docs_src/query_params/tutorial001.py!}
```
クエリはURL内で `?` の後に続くキーとバリューの組で、 `&` で区切られています。
@@ -64,7 +64,7 @@ http://127.0.0.1:8000/items/?skip=20
同様に、デフォルト値を `None` とすることで、オプショナルなクエリパラメータを宣言できます:
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial002.py!}
+{!../../docs_src/query_params/tutorial002.py!}
```
この場合、関数パラメータ `q` はオプショナルとなり、デフォルトでは `None` になります。
@@ -80,7 +80,7 @@ http://127.0.0.1:8000/items/?skip=20
`bool` 型も宣言できます。これは以下の様に変換されます:
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial003.py!}
+{!../../docs_src/query_params/tutorial003.py!}
```
この場合、以下にアクセスすると:
@@ -124,7 +124,7 @@ http://127.0.0.1:8000/items/foo?short=yes
名前で判別されます:
```Python hl_lines="8 10"
-{!../../../docs_src/query_params/tutorial004.py!}
+{!../../docs_src/query_params/tutorial004.py!}
```
## 必須のクエリパラメータ
@@ -136,7 +136,7 @@ http://127.0.0.1:8000/items/foo?short=yes
しかしクエリパラメータを必須にしたい場合は、ただデフォルト値を宣言しなければよいです:
```Python hl_lines="6-7"
-{!../../../docs_src/query_params/tutorial005.py!}
+{!../../docs_src/query_params/tutorial005.py!}
```
ここで、クエリパラメータ `needy` は `str` 型の必須のクエリパラメータです
@@ -182,7 +182,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
そして当然、あるパラメータを必須に、別のパラメータにデフォルト値を設定し、また別のパラメータをオプショナルにできます:
```Python hl_lines="10"
-{!../../../docs_src/query_params/tutorial006.py!}
+{!../../docs_src/query_params/tutorial006.py!}
```
この場合、3つのクエリパラメータがあります。:
diff --git a/docs/ja/docs/tutorial/request-forms-and-files.md b/docs/ja/docs/tutorial/request-forms-and-files.md
index d8effc219..e03b9166d 100644
--- a/docs/ja/docs/tutorial/request-forms-and-files.md
+++ b/docs/ja/docs/tutorial/request-forms-and-files.md
@@ -13,7 +13,7 @@
## `File`と`Form`のインポート
```Python hl_lines="1"
-{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!../../docs_src/request_forms_and_files/tutorial001.py!}
```
## `File`と`Form`のパラメータの定義
@@ -21,7 +21,7 @@
ファイルやフォームのパラメータは`Body`や`Query`の場合と同じように作成します:
```Python hl_lines="8"
-{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!../../docs_src/request_forms_and_files/tutorial001.py!}
```
ファイルとフォームフィールドがフォームデータとしてアップロードされ、ファイルとフォームフィールドを受け取ります。
diff --git a/docs/ja/docs/tutorial/request-forms.md b/docs/ja/docs/tutorial/request-forms.md
index d04dc810b..eb453c04a 100644
--- a/docs/ja/docs/tutorial/request-forms.md
+++ b/docs/ja/docs/tutorial/request-forms.md
@@ -15,7 +15,7 @@ JSONの代わりにフィールドを受け取る場合は、`Form`を使用し
`fastapi`から`Form`をインポートします:
```Python hl_lines="1"
-{!../../../docs_src/request_forms/tutorial001.py!}
+{!../../docs_src/request_forms/tutorial001.py!}
```
## `Form`のパラメータの定義
@@ -23,7 +23,7 @@ JSONの代わりにフィールドを受け取る場合は、`Form`を使用し
`Body`や`Query`の場合と同じようにフォームパラメータを作成します:
```Python hl_lines="7"
-{!../../../docs_src/request_forms/tutorial001.py!}
+{!../../docs_src/request_forms/tutorial001.py!}
```
例えば、OAuth2仕様が使用できる方法の１つ（「パスワードフロー」と呼ばれる）では、フォームフィールドとして`username`と`password`を送信する必要があります。
diff --git a/docs/ja/docs/tutorial/response-model.md b/docs/ja/docs/tutorial/response-model.md
index 7bb5e2825..973f893de 100644
--- a/docs/ja/docs/tutorial/response-model.md
+++ b/docs/ja/docs/tutorial/response-model.md
@@ -9,7 +9,7 @@
* など。
```Python hl_lines="17"
-{!../../../docs_src/response_model/tutorial001.py!}
+{!../../docs_src/response_model/tutorial001.py!}
```
/// note | "備考"
@@ -42,13 +42,13 @@ FastAPIは`response_model`を使って以下のことをします:
ここでは`UserIn`モデルを宣言しています。それには平文のパスワードが含まれています:
```Python hl_lines="9 11"
-{!../../../docs_src/response_model/tutorial002.py!}
+{!../../docs_src/response_model/tutorial002.py!}
```
そして、このモデルを使用して入力を宣言し、同じモデルを使って出力を宣言しています:
```Python hl_lines="17 18"
-{!../../../docs_src/response_model/tutorial002.py!}
+{!../../docs_src/response_model/tutorial002.py!}
```
これで、ブラウザがパスワードを使ってユーザーを作成する際に、APIがレスポンスで同じパスワードを返すようになりました。
@@ -68,19 +68,19 @@ FastAPIは`response_model`を使って以下のことをします:
代わりに、平文のパスワードを持つ入力モデルと、パスワードを持たない出力モデルを作成することができます:
```Python hl_lines="9 11 16"
-{!../../../docs_src/response_model/tutorial003.py!}
+{!../../docs_src/response_model/tutorial003.py!}
```
ここでは、*path operation関数*がパスワードを含む同じ入力ユーザーを返しているにもかかわらず:
```Python hl_lines="24"
-{!../../../docs_src/response_model/tutorial003.py!}
+{!../../docs_src/response_model/tutorial003.py!}
```
...`response_model`を`UserOut`と宣言したことで、パスワードが含まれていません:
```Python hl_lines="22"
-{!../../../docs_src/response_model/tutorial003.py!}
+{!../../docs_src/response_model/tutorial003.py!}
```
そのため、**FastAPI** は出力モデルで宣言されていない全てのデータをフィルタリングしてくれます（Pydanticを使用）。
@@ -100,7 +100,7 @@ FastAPIは`response_model`を使って以下のことをします:
レスポンスモデルにはデフォルト値を設定することができます:
```Python hl_lines="11 13 14"
-{!../../../docs_src/response_model/tutorial004.py!}
+{!../../docs_src/response_model/tutorial004.py!}
```
* `description: str = None`は`None`がデフォルト値です。
@@ -116,7 +116,7 @@ FastAPIは`response_model`を使って以下のことをします:
*path operation デコレータ*に`response_model_exclude_unset=True`パラメータを設定することができます:
```Python hl_lines="24"
-{!../../../docs_src/response_model/tutorial004.py!}
+{!../../docs_src/response_model/tutorial004.py!}
```
そして、これらのデフォルト値はレスポンスに含まれず、実際に設定された値のみが含まれます。
@@ -206,7 +206,7 @@ FastAPIは十分に賢いので（実際には、Pydanticが十分に賢い）`d
///
```Python hl_lines="31 37"
-{!../../../docs_src/response_model/tutorial005.py!}
+{!../../docs_src/response_model/tutorial005.py!}
```
/// tip | "豆知識"
@@ -222,7 +222,7 @@ FastAPIは十分に賢いので（実際には、Pydanticが十分に賢い）`d
もし`set`を使用することを忘れて、代わりに`list`や`tuple`を使用しても、FastAPIはそれを`set`に変換して正しく動作します:
```Python hl_lines="31 37"
-{!../../../docs_src/response_model/tutorial006.py!}
+{!../../docs_src/response_model/tutorial006.py!}
```
## まとめ
diff --git a/docs/ja/docs/tutorial/response-status-code.md b/docs/ja/docs/tutorial/response-status-code.md
index 945767894..90b290887 100644
--- a/docs/ja/docs/tutorial/response-status-code.md
+++ b/docs/ja/docs/tutorial/response-status-code.md
@@ -9,7 +9,7 @@
* など。
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
/// note | "備考"
@@ -77,7 +77,7 @@ HTTPでは、レスポンスの一部として３桁の数字のステータス
先ほどの例をもう一度見てみましょう:
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
`201`は「作成完了」のためのステータスコードです。
@@ -87,7 +87,7 @@ HTTPでは、レスポンスの一部として３桁の数字のステータス
`fastapi.status`の便利な変数を利用することができます。
```Python hl_lines="1 6"
-{!../../../docs_src/response_status_code/tutorial002.py!}
+{!../../docs_src/response_status_code/tutorial002.py!}
```
それらは便利です。それらは同じ番号を保持しており、その方法ではエディタの自動補完を使用してそれらを見つけることができます。
diff --git a/docs/ja/docs/tutorial/schema-extra-example.md b/docs/ja/docs/tutorial/schema-extra-example.md
index a3cd5eb54..baf1bbedd 100644
--- a/docs/ja/docs/tutorial/schema-extra-example.md
+++ b/docs/ja/docs/tutorial/schema-extra-example.md
@@ -11,7 +11,7 @@ JSON Schemaの追加情報を宣言する方法はいくつかあります。
<a href="https://docs.pydantic.dev/latest/concepts/json_schema/#schema-customization" class="external-link" target="_blank">Pydanticのドキュメント: スキーマのカスタマイズ</a>で説明されているように、`Config`と`schema_extra`を使ってPydanticモデルの例を宣言することができます:
```Python hl_lines="15 16 17 18 19 20 21 22 23"
-{!../../../docs_src/schema_extra_example/tutorial001.py!}
+{!../../docs_src/schema_extra_example/tutorial001.py!}
```
その追加情報はそのまま出力され、JSON Schemaに追加されます。
@@ -21,7 +21,7 @@ JSON Schemaの追加情報を宣言する方法はいくつかあります。
後述する`Field`、`Path`、`Query`、`Body`などでは、任意の引数を関数に渡すことでJSON Schemaの追加情報を宣言することもできます:
```Python hl_lines="4 10 11 12 13"
-{!../../../docs_src/schema_extra_example/tutorial002.py!}
+{!../../docs_src/schema_extra_example/tutorial002.py!}
```
/// warning | "注意"
@@ -37,7 +37,7 @@ JSON Schemaの追加情報を宣言する方法はいくつかあります。
例えば、`Body`にボディリクエストの`example`を渡すことができます:
```Python hl_lines="21 22 23 24 25 26"
-{!../../../docs_src/schema_extra_example/tutorial003.py!}
+{!../../docs_src/schema_extra_example/tutorial003.py!}
```
## ドキュメントのUIの例
diff --git a/docs/ja/docs/tutorial/security/first-steps.md b/docs/ja/docs/tutorial/security/first-steps.md
index c78a3755e..51f7bf829 100644
--- a/docs/ja/docs/tutorial/security/first-steps.md
+++ b/docs/ja/docs/tutorial/security/first-steps.md
@@ -21,7 +21,7 @@
`main.py`に、下記の例をコピーします:
```Python
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
## 実行
@@ -129,7 +129,7 @@ OAuth2は、バックエンドやAPIがユーザーを認証するサーバー
`OAuth2PasswordBearer` クラスのインスタンスを作成する時に、パラメーター`tokenUrl`を渡します。このパラメーターには、クライアント (ユーザーのブラウザで動作するフロントエンド) がトークンを取得するために`ユーザー名`と`パスワード`を送信するURLを指定します。
```Python hl_lines="6"
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
/// tip | "豆知識"
@@ -169,7 +169,7 @@ oauth2_scheme(some, parameters)
これで`oauth2_scheme`を`Depends`で依存関係に渡すことができます。
```Python hl_lines="10"
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
この依存関係は、*path operation function*のパラメーター`token`に代入される`str`を提供します。
diff --git a/docs/ja/docs/tutorial/security/get-current-user.md b/docs/ja/docs/tutorial/security/get-current-user.md
index 250f66b81..0edbd983f 100644
--- a/docs/ja/docs/tutorial/security/get-current-user.md
+++ b/docs/ja/docs/tutorial/security/get-current-user.md
@@ -3,7 +3,7 @@
一つ前の章では、（依存性注入システムに基づいた）セキュリティシステムは、 *path operation関数* に `str` として `token` を与えていました:
```Python hl_lines="10"
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
しかし、それはまだそんなに有用ではありません。
@@ -17,7 +17,7 @@
ボディを宣言するのにPydanticを使用するのと同じやり方で、Pydanticを別のどんなところでも使うことができます:
```Python hl_lines="5 12-16"
-{!../../../docs_src/security/tutorial002.py!}
+{!../../docs_src/security/tutorial002.py!}
```
## 依存関係 `get_current_user` を作成
@@ -31,7 +31,7 @@
以前直接 *path operation* の中でしていたのと同じように、新しい依存関係である `get_current_user` は `str` として `token` を受け取るようになります:
```Python hl_lines="25"
-{!../../../docs_src/security/tutorial002.py!}
+{!../../docs_src/security/tutorial002.py!}
```
## ユーザーの取得
@@ -39,7 +39,7 @@
`get_current_user` は作成した（偽物の）ユーティリティ関数を使って、 `str` としてトークンを受け取り、先ほどのPydanticの `User` モデルを返却します:
```Python hl_lines="19-22 26-27"
-{!../../../docs_src/security/tutorial002.py!}
+{!../../docs_src/security/tutorial002.py!}
```
## 現在のユーザーの注入
@@ -47,7 +47,7 @@
ですので、 `get_current_user` に対して同様に *path operation* の中で `Depends` を利用できます。
```Python hl_lines="31"
-{!../../../docs_src/security/tutorial002.py!}
+{!../../docs_src/security/tutorial002.py!}
```
Pydanticモデルの `User` として、 `current_user` の型を宣言することに注意してください。
@@ -104,7 +104,7 @@ Pydanticモデルの `User` として、 `current_user` の型を宣言するこ
さらに、こうした何千もの *path operations* は、たった3行で表現できるのです:
```Python hl_lines="30-32"
-{!../../../docs_src/security/tutorial002.py!}
+{!../../docs_src/security/tutorial002.py!}
```
## まとめ
diff --git a/docs/ja/docs/tutorial/security/oauth2-jwt.md b/docs/ja/docs/tutorial/security/oauth2-jwt.md
index 4f6aebd4c..b2f511610 100644
--- a/docs/ja/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/ja/docs/tutorial/security/oauth2-jwt.md
@@ -119,7 +119,7 @@ PassLibのcontextには、検証だけが許された非推奨の古いハッシ
さらに、ユーザーを認証して返す関数も作成します。
```Python hl_lines="7 48 55-56 59-60 69-75"
-{!../../../docs_src/security/tutorial004.py!}
+{!../../docs_src/security/tutorial004.py!}
```
/// note | "備考"
@@ -157,7 +157,7 @@ JWTトークンの署名に使用するアルゴリズム`"HS256"`を指定し
新しいアクセストークンを生成するユーティリティ関数を作成します。
```Python hl_lines="6 12-14 28-30 78-86"
-{!../../../docs_src/security/tutorial004.py!}
+{!../../docs_src/security/tutorial004.py!}
```
## 依存関係の更新
@@ -169,7 +169,7 @@ JWTトークンの署名に使用するアルゴリズム`"HS256"`を指定し
トークンが無効な場合は、すぐにHTTPエラーを返します。
```Python hl_lines="89-106"
-{!../../../docs_src/security/tutorial004.py!}
+{!../../docs_src/security/tutorial004.py!}
```
## `/token` パスオペレーションの更新
@@ -179,7 +179,7 @@ JWTトークンの署名に使用するアルゴリズム`"HS256"`を指定し
JWTアクセストークンを作成し、それを返します。
```Python hl_lines="115-130"
-{!../../../docs_src/security/tutorial004.py!}
+{!../../docs_src/security/tutorial004.py!}
```
### JWTの"subject" `sub` についての技術的な詳細
diff --git a/docs/ja/docs/tutorial/static-files.md b/docs/ja/docs/tutorial/static-files.md
index c9d95bc34..e6002a1fb 100644
--- a/docs/ja/docs/tutorial/static-files.md
+++ b/docs/ja/docs/tutorial/static-files.md
@@ -8,7 +8,7 @@
* `StaticFiles()` インスタンスを生成し、特定のパスに「マウント」。
```Python hl_lines="2 6"
-{!../../../docs_src/static_files/tutorial001.py!}
+{!../../docs_src/static_files/tutorial001.py!}
```
/// note | "技術詳細"
diff --git a/docs/ja/docs/tutorial/testing.md b/docs/ja/docs/tutorial/testing.md
index 3ed03ebea..6c5e712e8 100644
--- a/docs/ja/docs/tutorial/testing.md
+++ b/docs/ja/docs/tutorial/testing.md
@@ -19,7 +19,7 @@
チェックしたい Python の標準的な式と共に、シンプルに `assert` 文を記述します。
```Python hl_lines="2 12 15-18"
-{!../../../docs_src/app_testing/tutorial001.py!}
+{!../../docs_src/app_testing/tutorial001.py!}
```
/// tip | "豆知識"
@@ -57,7 +57,7 @@ FastAPIアプリケーションへのリクエストの送信とは別に、テ
**FastAPI** アプリに `main.py` ファイルがあるとします:
```Python
-{!../../../docs_src/app_testing/main.py!}
+{!../../docs_src/app_testing/main.py!}
```
### テストファイル
@@ -65,7 +65,7 @@ FastAPIアプリケーションへのリクエストの送信とは別に、テ
次に、テストを含む `test_main.py` ファイルを作成し、`main` モジュール (`main.py`) から `app` をインポートします:
```Python
-{!../../../docs_src/app_testing/test_main.py!}
+{!../../docs_src/app_testing/test_main.py!}
```
## テスト: 例の拡張
@@ -86,7 +86,7 @@ FastAPIアプリケーションへのリクエストの送信とは別に、テ
//// tab | Python 3.10+
```Python
-{!> ../../../docs_src/app_testing/app_b_py310/main.py!}
+{!> ../../docs_src/app_testing/app_b_py310/main.py!}
```
////
@@ -94,7 +94,7 @@ FastAPIアプリケーションへのリクエストの送信とは別に、テ
//// tab | Python 3.6+
```Python
-{!> ../../../docs_src/app_testing/app_b/main.py!}
+{!> ../../docs_src/app_testing/app_b/main.py!}
```
////
@@ -104,7 +104,7 @@ FastAPIアプリケーションへのリクエストの送信とは別に、テ
次に、先程のものに拡張版のテストを加えた、`test_main_b.py` を作成します。
```Python
-{!> ../../../docs_src/app_testing/app_b/test_main.py!}
+{!> ../../docs_src/app_testing/app_b/test_main.py!}
```
リクエストに情報を渡せるクライアントが必要で、その方法がわからない場合はいつでも、`httpx` での実現方法を検索 (Google) できます。
diff --git a/docs/ko/docs/advanced/events.md b/docs/ko/docs/advanced/events.md
index e155f41f1..94867c198 100644
--- a/docs/ko/docs/advanced/events.md
+++ b/docs/ko/docs/advanced/events.md
@@ -15,7 +15,7 @@
응용 프로그램을 시작하기 전에 실행하려는 함수를 "startup" 이벤트로 선언합니다:
```Python hl_lines="8"
-{!../../../docs_src/events/tutorial001.py!}
+{!../../docs_src/events/tutorial001.py!}
```
이 경우 `startup` 이벤트 핸들러 함수는 단순히 몇 가지 값으로 구성된 `dict` 형식의 "데이터베이스"를 초기화합니다.
@@ -29,7 +29,7 @@
응용 프로그램이 종료될 때 실행하려는 함수를 추가하려면 `"shutdown"` 이벤트로 선언합니다:
```Python hl_lines="6"
-{!../../../docs_src/events/tutorial002.py!}
+{!../../docs_src/events/tutorial002.py!}
```
이 예제에서 `shutdown` 이벤트 핸들러 함수는 `"Application shutdown"`이라는 텍스트가 적힌 `log.txt` 파일을 추가할 것입니다.
diff --git a/docs/ko/docs/python-types.md b/docs/ko/docs/python-types.md
index 5c458e48d..6d7346189 100644
--- a/docs/ko/docs/python-types.md
+++ b/docs/ko/docs/python-types.md
@@ -23,7 +23,7 @@
간단한 예제부터 시작해봅시다:
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
이 프로그램을 실행한 결과값:
@@ -39,7 +39,7 @@ John Doe
* 두 단어를 중간에 공백을 두고 <abbr title="두 개를 하나로 차례차례 이어지게 하다">연결</abbr>합니다.
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### 코드 수정
@@ -83,7 +83,7 @@ John Doe
이게 "타입 힌트"입니다:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
타입힌트는 다음과 같이 기본 값을 선언하는 것과는 다릅니다:
@@ -113,7 +113,7 @@ John Doe
아래 함수를 보면, 이미 타입 힌트가 적용되어 있는 걸 볼 수 있습니다:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
편집기가 변수의 타입을 알고 있기 때문에, 자동완성 뿐 아니라 에러도 확인할 수 있습니다:
@@ -123,7 +123,7 @@ John Doe
이제 고쳐야하는 걸 알기 때문에, `age`를 `str(age)`과 같이 문자열로 바꾸게 됩니다:
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## 타입 선언
@@ -144,7 +144,7 @@ John Doe
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### 타입 매개변수를 활용한 Generic(제네릭) 타입
@@ -162,7 +162,7 @@ John Doe
`typing`에서 `List`(대문자 `L`)를 import 합니다.
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
콜론(`:`) 문법을 이용하여 변수를 선언합니다.
@@ -172,7 +172,7 @@ John Doe
이때 배열은 내부 타입을 포함하는 타입이기 때문에 대괄호 안에 넣어줍니다.
```Python hl_lines="4"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
/// tip | "팁"
@@ -200,7 +200,7 @@ John Doe
`tuple`과 `set`도 동일하게 선언할 수 있습니다.
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial007.py!}
+{!../../docs_src/python_types/tutorial007.py!}
```
이 뜻은 아래와 같습니다:
@@ -217,7 +217,7 @@ John Doe
두 번째 매개변수는 `dict`의 값(value)입니다.
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial008.py!}
+{!../../docs_src/python_types/tutorial008.py!}
```
이 뜻은 아래와 같습니다:
@@ -231,7 +231,7 @@ John Doe
`str`과 같이 타입을 선언할 때 `Optional`을 쓸 수도 있는데, "선택적(Optional)"이기때문에 `None`도 될 수 있습니다:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
`Optional[str]`을 `str` 대신 쓰게 되면, 특정 값이 실제로는 `None`이 될 수도 있는데 항상 `str`이라고 가정하는 상황에서 에디터가 에러를 찾게 도와줄 수 있습니다.
@@ -256,13 +256,13 @@ John Doe
이름(name)을 가진 `Person` 클래스가 있다고 해봅시다.
```Python hl_lines="1-3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
그렇게 하면 변수를 `Person`이라고 선언할 수 있게 됩니다.
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
그리고 역시나 모든 에디터 도움을 받게 되겠죠.
@@ -284,7 +284,7 @@ John Doe
Pydantic 공식 문서 예시:
```Python
-{!../../../docs_src/python_types/tutorial011.py!}
+{!../../docs_src/python_types/tutorial011.py!}
```
/// info | "정보"
diff --git a/docs/ko/docs/tutorial/background-tasks.md b/docs/ko/docs/tutorial/background-tasks.md
index 880a1c198..376c52524 100644
--- a/docs/ko/docs/tutorial/background-tasks.md
+++ b/docs/ko/docs/tutorial/background-tasks.md
@@ -16,7 +16,7 @@ FastAPI에서는 응답을 반환한 후에 실행할 백그라운드 작업을
먼저 아래와 같이 `BackgroundTasks`를 임포트하고, `BackgroundTasks`를 _경로 작동 함수_ 에서 매개변수로 가져오고 정의합니다.
```Python hl_lines="1 13"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
**FastAPI** 는 `BackgroundTasks` 개체를 생성하고, 매개 변수로 전달합니다.
@@ -34,7 +34,7 @@ FastAPI에서는 응답을 반환한 후에 실행할 백그라운드 작업을
그리고 이 작업은 `async`와 `await`를 사용하지 않으므로 일반 `def` 함수로 선언합니다.
```Python hl_lines="6-9"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
## 백그라운드 작업 추가
@@ -42,7 +42,7 @@ FastAPI에서는 응답을 반환한 후에 실행할 백그라운드 작업을
_경로 작동 함수_ 내에서 작업 함수를 `.add_task()` 함수 통해 _백그라운드 작업_ 개체에 전달합니다.
```Python hl_lines="14"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
`.add_task()` 함수는 다음과 같은 인자를 받습니다 :
@@ -60,7 +60,7 @@ _경로 작동 함수_ 내에서 작업 함수를 `.add_task()` 함수 통해 _
//// tab | Python 3.6 and above
```Python hl_lines="13 15 22 25"
-{!> ../../../docs_src/background_tasks/tutorial002.py!}
+{!> ../../docs_src/background_tasks/tutorial002.py!}
```
////
@@ -68,7 +68,7 @@ _경로 작동 함수_ 내에서 작업 함수를 `.add_task()` 함수 통해 _
//// tab | Python 3.10 and above
```Python hl_lines="11 13 20 23"
-{!> ../../../docs_src/background_tasks/tutorial002_py310.py!}
+{!> ../../docs_src/background_tasks/tutorial002_py310.py!}
```
////
diff --git a/docs/ko/docs/tutorial/body-fields.md b/docs/ko/docs/tutorial/body-fields.md
index b74722e26..a13159c27 100644
--- a/docs/ko/docs/tutorial/body-fields.md
+++ b/docs/ko/docs/tutorial/body-fields.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an.py!}
+{!> ../../docs_src/body_fields/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="2"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@
///
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
@@ -71,7 +71,7 @@
//// tab | Python 3.10+
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py310.py!}
```
////
@@ -79,7 +79,7 @@
//// tab | Python 3.9+
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py39.py!}
```
////
@@ -87,7 +87,7 @@
//// tab | Python 3.8+
```Python hl_lines="12-15"
-{!> ../../../docs_src/body_fields/tutorial001_an.py!}
+{!> ../../docs_src/body_fields/tutorial001_an.py!}
```
////
@@ -101,7 +101,7 @@
///
```Python hl_lines="9-12"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
@@ -115,7 +115,7 @@
///
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
diff --git a/docs/ko/docs/tutorial/body-multiple-params.md b/docs/ko/docs/tutorial/body-multiple-params.md
index 023575e1b..0a0f34585 100644
--- a/docs/ko/docs/tutorial/body-multiple-params.md
+++ b/docs/ko/docs/tutorial/body-multiple-params.md
@@ -11,7 +11,7 @@
또한, 기본 값을 `None`으로 설정해 본문 매개변수를 선택사항으로 선언할 수 있습니다.
```Python hl_lines="19-21"
-{!../../../docs_src/body_multiple_params/tutorial001.py!}
+{!../../docs_src/body_multiple_params/tutorial001.py!}
```
/// note | "참고"
@@ -36,7 +36,7 @@
하지만, 다중 본문 매개변수 역시 선언할 수 있습니다. 예. `item`과 `user`:
```Python hl_lines="22"
-{!../../../docs_src/body_multiple_params/tutorial002.py!}
+{!../../docs_src/body_multiple_params/tutorial002.py!}
```
이 경우에, **FastAPI**는 이 함수 안에 한 개 이상의 본문 매개변수(Pydantic 모델인 두 매개변수)가 있다고 알 것입니다.
@@ -80,7 +80,7 @@ FastAPI는 요청을 자동으로 변환해, 매개변수의 `item`과 `user`를
```Python hl_lines="23"
-{!../../../docs_src/body_multiple_params/tutorial003.py!}
+{!../../docs_src/body_multiple_params/tutorial003.py!}
```
이 경우에는 **FastAPI**는 본문을 이와 같이 예측할 것입니다:
@@ -111,7 +111,7 @@ FastAPI는 요청을 자동으로 변환해, 매개변수의 `item`과 `user`를
기본적으로 단일 값은 쿼리 매개변수로 해석되므로, 명시적으로 `Query`를 추가할 필요가 없고, 아래처럼 할 수 있습니다:
```Python hl_lines="27"
-{!../../../docs_src/body_multiple_params/tutorial004.py!}
+{!../../docs_src/body_multiple_params/tutorial004.py!}
```
이렇게:
@@ -135,7 +135,7 @@ Pydantic 모델 `Item`의 `item`을 본문 매개변수로 오직 한개만 갖
하지만, 만약 모델 내용에 `item `키를 가진 JSON으로 예측하길 원한다면, 추가적인 본문 매개변수를 선언한 것처럼 `Body`의 특별한 매개변수인 `embed`를 사용할 수 있습니다:
```Python hl_lines="17"
-{!../../../docs_src/body_multiple_params/tutorial005.py!}
+{!../../docs_src/body_multiple_params/tutorial005.py!}
```
아래 처럼:
diff --git a/docs/ko/docs/tutorial/body-nested-models.md b/docs/ko/docs/tutorial/body-nested-models.md
index 4d785f64b..12fb4e0cc 100644
--- a/docs/ko/docs/tutorial/body-nested-models.md
+++ b/docs/ko/docs/tutorial/body-nested-models.md
@@ -6,7 +6,7 @@
어트리뷰트를 서브타입으로 정의할 수 있습니다. 예를 들어 파이썬 `list`는:
```Python hl_lines="14"
-{!../../../docs_src/body_nested_models/tutorial001.py!}
+{!../../docs_src/body_nested_models/tutorial001.py!}
```
이는 `tags`를 항목 리스트로 만듭니다. 각 항목의 타입을 선언하지 않더라도요.
@@ -20,7 +20,7 @@
먼저, 파이썬 표준 `typing` 모듈에서 `List`를 임포트합니다:
```Python hl_lines="1"
-{!../../../docs_src/body_nested_models/tutorial002.py!}
+{!../../docs_src/body_nested_models/tutorial002.py!}
```
### 타입 매개변수로 `List` 선언
@@ -43,7 +43,7 @@ my_list: List[str]
마찬가지로 예제에서 `tags`를 구체적으로 "문자열의 리스트"로 만들 수 있습니다:
```Python hl_lines="14"
-{!../../../docs_src/body_nested_models/tutorial002.py!}
+{!../../docs_src/body_nested_models/tutorial002.py!}
```
## 집합 타입
@@ -55,7 +55,7 @@ my_list: List[str]
그렇다면 `Set`을 임포트 하고 `tags`를 `str`의 `set`으로 선언할 수 있습니다:
```Python hl_lines="1 14"
-{!../../../docs_src/body_nested_models/tutorial003.py!}
+{!../../docs_src/body_nested_models/tutorial003.py!}
```
덕분에 중복 데이터가 있는 요청을 수신하더라도 고유한 항목들의 집합으로 변환됩니다.
@@ -79,7 +79,7 @@ Pydantic 모델의 각 어트리뷰트는 타입을 갖습니다.
예를 들어, `Image` 모델을 선언할 수 있습니다:
```Python hl_lines="9-11"
-{!../../../docs_src/body_nested_models/tutorial004.py!}
+{!../../docs_src/body_nested_models/tutorial004.py!}
```
### 서브모듈을 타입으로 사용
@@ -87,7 +87,7 @@ Pydantic 모델의 각 어트리뷰트는 타입을 갖습니다.
그리고 어트리뷰트의 타입으로 사용할 수 있습니다:
```Python hl_lines="20"
-{!../../../docs_src/body_nested_models/tutorial004.py!}
+{!../../docs_src/body_nested_models/tutorial004.py!}
```
이는 **FastAPI**가 다음과 유사한 본문을 기대한다는 것을 의미합니다:
@@ -122,7 +122,7 @@ Pydantic 모델의 각 어트리뷰트는 타입을 갖습니다.
예를 들어 `Image` 모델 안에 `url` 필드를 `str` 대신 Pydantic의 `HttpUrl`로 선언할 수 있습니다:
```Python hl_lines="4 10"
-{!../../../docs_src/body_nested_models/tutorial005.py!}
+{!../../docs_src/body_nested_models/tutorial005.py!}
```
이 문자열이 유효한 URL인지 검사하고 JSON 스키마/OpenAPI로 문서화 됩니다.
@@ -132,7 +132,7 @@ Pydantic 모델의 각 어트리뷰트는 타입을 갖습니다.
`list`, `set` 등의 서브타입으로 Pydantic 모델을 사용할 수도 있습니다:
```Python hl_lines="20"
-{!../../../docs_src/body_nested_models/tutorial006.py!}
+{!../../docs_src/body_nested_models/tutorial006.py!}
```
아래와 같은 JSON 본문으로 예상(변환, 검증, 문서화 등을)합니다:
@@ -172,7 +172,7 @@ Pydantic 모델의 각 어트리뷰트는 타입을 갖습니다.
단독으로 깊게 중첩된 모델을 정의할 수 있습니다:
```Python hl_lines="9 14 20 23 27"
-{!../../../docs_src/body_nested_models/tutorial007.py!}
+{!../../docs_src/body_nested_models/tutorial007.py!}
```
/// info | "정보"
@@ -192,7 +192,7 @@ images: List[Image]
이를 아래처럼:
```Python hl_lines="15"
-{!../../../docs_src/body_nested_models/tutorial008.py!}
+{!../../docs_src/body_nested_models/tutorial008.py!}
```
## 어디서나 편집기 지원
@@ -224,7 +224,7 @@ Pydantic 모델 대신에 `dict`를 직접 사용하여 작업할 경우, 이러
이 경우, `float` 값을 가진 `int` 키가 있는 모든 `dict`를 받아들입니다:
```Python hl_lines="15"
-{!../../../docs_src/body_nested_models/tutorial009.py!}
+{!../../docs_src/body_nested_models/tutorial009.py!}
```
/// tip | "팁"
diff --git a/docs/ko/docs/tutorial/body.md b/docs/ko/docs/tutorial/body.md
index 337218eb4..8df8d556e 100644
--- a/docs/ko/docs/tutorial/body.md
+++ b/docs/ko/docs/tutorial/body.md
@@ -25,7 +25,7 @@
//// tab | Python 3.10+
```Python hl_lines="2"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -33,7 +33,7 @@
//// tab | Python 3.8+
```Python hl_lines="4"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -47,7 +47,7 @@
//// tab | Python 3.10+
```Python hl_lines="5-9"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -55,7 +55,7 @@
//// tab | Python 3.8+
```Python hl_lines="7-11"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -89,7 +89,7 @@
//// tab | Python 3.10+
```Python hl_lines="16"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -97,7 +97,7 @@
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -170,7 +170,7 @@
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/body/tutorial002_py310.py!}
+{!> ../../docs_src/body/tutorial002_py310.py!}
```
////
@@ -178,7 +178,7 @@
//// tab | Python 3.8+
```Python hl_lines="21"
-{!> ../../../docs_src/body/tutorial002.py!}
+{!> ../../docs_src/body/tutorial002.py!}
```
////
@@ -192,7 +192,7 @@
//// tab | Python 3.10+
```Python hl_lines="15-16"
-{!> ../../../docs_src/body/tutorial003_py310.py!}
+{!> ../../docs_src/body/tutorial003_py310.py!}
```
////
@@ -200,7 +200,7 @@
//// tab | Python 3.8+
```Python hl_lines="17-18"
-{!> ../../../docs_src/body/tutorial003.py!}
+{!> ../../docs_src/body/tutorial003.py!}
```
////
@@ -214,7 +214,7 @@
//// tab | Python 3.10+
```Python hl_lines="16"
-{!> ../../../docs_src/body/tutorial004_py310.py!}
+{!> ../../docs_src/body/tutorial004_py310.py!}
```
////
@@ -222,7 +222,7 @@
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/body/tutorial004.py!}
+{!> ../../docs_src/body/tutorial004.py!}
```
////
diff --git a/docs/ko/docs/tutorial/cookie-params.md b/docs/ko/docs/tutorial/cookie-params.md
index 5f129b63f..1e21e069d 100644
--- a/docs/ko/docs/tutorial/cookie-params.md
+++ b/docs/ko/docs/tutorial/cookie-params.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="1"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@
///
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
@@ -67,7 +67,7 @@
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -75,7 +75,7 @@
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -83,7 +83,7 @@
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -97,7 +97,7 @@
///
```Python hl_lines="7"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -111,7 +111,7 @@
///
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
diff --git a/docs/ko/docs/tutorial/cors.md b/docs/ko/docs/tutorial/cors.md
index 312fdee1b..65357ae3f 100644
--- a/docs/ko/docs/tutorial/cors.md
+++ b/docs/ko/docs/tutorial/cors.md
@@ -47,7 +47,7 @@
* 특정한 HTTP 헤더 또는 와일드카드 `"*"` 를 사용한 모든 HTTP 헤더.
```Python hl_lines="2 6-11 13-19"
-{!../../../docs_src/cors/tutorial001.py!}
+{!../../docs_src/cors/tutorial001.py!}
```
`CORSMiddleware` 에서 사용하는 기본 매개변수는 제한적이므로, 브라우저가 교차-도메인 상황에서 특정한 출처, 메소드, 헤더 등을 사용할 수 있도록 하려면 이들을 명시적으로 허용해야 합니다.
diff --git a/docs/ko/docs/tutorial/debugging.md b/docs/ko/docs/tutorial/debugging.md
index cb45e5169..27e8f9abf 100644
--- a/docs/ko/docs/tutorial/debugging.md
+++ b/docs/ko/docs/tutorial/debugging.md
@@ -7,7 +7,7 @@
FastAPI 애플리케이션에서 `uvicorn`을 직접 임포트하여 실행합니다
```Python hl_lines="1 15"
-{!../../../docs_src/debugging/tutorial001.py!}
+{!../../docs_src/debugging/tutorial001.py!}
```
### `__name__ == "__main__"` 에 대하여
diff --git a/docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md
index 259fe4b6d..7430efbb4 100644
--- a/docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -9,7 +9,7 @@
//// tab | 파이썬 3.6 이상
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | 파이썬 3.10 이상
```Python hl_lines="7"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -84,7 +84,7 @@ FastAPI가 실질적으로 확인하는 것은 "호출 가능성"(함수, 클래
//// tab | 파이썬 3.6 이상
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -92,7 +92,7 @@ FastAPI가 실질적으로 확인하는 것은 "호출 가능성"(함수, 클래
//// tab | 파이썬 3.10 이상
```Python hl_lines="9-13"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -102,7 +102,7 @@ FastAPI가 실질적으로 확인하는 것은 "호출 가능성"(함수, 클래
//// tab | 파이썬 3.6 이상
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -110,7 +110,7 @@ FastAPI가 실질적으로 확인하는 것은 "호출 가능성"(함수, 클래
//// tab | 파이썬 3.10 이상
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -120,7 +120,7 @@ FastAPI가 실질적으로 확인하는 것은 "호출 가능성"(함수, 클래
//// tab | 파이썬 3.6 이상
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -128,7 +128,7 @@ FastAPI가 실질적으로 확인하는 것은 "호출 가능성"(함수, 클래
//// tab | 파이썬 3.10 이상
```Python hl_lines="6"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -150,7 +150,7 @@ FastAPI가 실질적으로 확인하는 것은 "호출 가능성"(함수, 클래
//// tab | 파이썬 3.6 이상
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -158,7 +158,7 @@ FastAPI가 실질적으로 확인하는 것은 "호출 가능성"(함수, 클래
//// tab | 파이썬 3.10 이상
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -203,7 +203,7 @@ commons = Depends(CommonQueryParams)
//// tab | 파이썬 3.6 이상
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003.py!}
+{!> ../../docs_src/dependencies/tutorial003.py!}
```
////
@@ -211,7 +211,7 @@ commons = Depends(CommonQueryParams)
//// tab | 파이썬 3.10 이상
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial003_py310.py!}
+{!> ../../docs_src/dependencies/tutorial003_py310.py!}
```
////
@@ -251,7 +251,7 @@ commons: CommonQueryParams = Depends()
//// tab | 파이썬 3.6 이상
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004.py!}
+{!> ../../docs_src/dependencies/tutorial004.py!}
```
////
@@ -259,7 +259,7 @@ commons: CommonQueryParams = Depends()
//// tab | 파이썬 3.10 이상
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial004_py310.py!}
+{!> ../../docs_src/dependencies/tutorial004_py310.py!}
```
////
diff --git a/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index bc8af488d..e71ba8546 100644
--- a/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -75,7 +75,7 @@
//// tab | Python 3.9+
```Python hl_lines="8 13"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -83,7 +83,7 @@
//// tab | Python 3.8+
```Python hl_lines="7 12"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -97,7 +97,7 @@
///
```Python hl_lines="6 11"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -109,7 +109,7 @@
//// tab | Python 3.9+
```Python hl_lines="10 15"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -117,7 +117,7 @@
//// tab | Python 3.8+
```Python hl_lines="9 14"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -131,7 +131,7 @@
///
```Python hl_lines="8 13"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -145,7 +145,7 @@
//// tab | Python 3.9+
```Python hl_lines="11 16"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -153,7 +153,7 @@
//// tab | Python 3.8+
```Python hl_lines="10 15"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -167,7 +167,7 @@
///
```Python hl_lines="9 14"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
diff --git a/docs/ko/docs/tutorial/dependencies/global-dependencies.md b/docs/ko/docs/tutorial/dependencies/global-dependencies.md
index 2ce2cf4f2..dd6586c3e 100644
--- a/docs/ko/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/ko/docs/tutorial/dependencies/global-dependencies.md
@@ -9,7 +9,7 @@
//// tab | Python 3.9+
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial012_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial012_an_py39.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.8+
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial012_an.py!}
+{!> ../../docs_src/dependencies/tutorial012_an.py!}
```
////
@@ -31,7 +31,7 @@
///
```Python hl_lines="15"
-{!> ../../../docs_src/dependencies/tutorial012.py!}
+{!> ../../docs_src/dependencies/tutorial012.py!}
```
////
diff --git a/docs/ko/docs/tutorial/dependencies/index.md b/docs/ko/docs/tutorial/dependencies/index.md
index 361989e2b..f7b2f1788 100644
--- a/docs/ko/docs/tutorial/dependencies/index.md
+++ b/docs/ko/docs/tutorial/dependencies/index.md
@@ -34,7 +34,7 @@
//// tab | Python 3.10+
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -42,7 +42,7 @@
//// tab | Python 3.9+
```Python hl_lines="8-11"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -50,7 +50,7 @@
//// tab | Python 3.8+
```Python hl_lines="9-12"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -64,7 +64,7 @@
///
```Python hl_lines="6-7"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -78,7 +78,7 @@
///
```Python hl_lines="8-11"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -116,7 +116,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -124,7 +124,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -132,7 +132,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -146,7 +146,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
///
```Python hl_lines="1"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -160,7 +160,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
///
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -172,7 +172,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
//// tab | Python 3.10+
```Python hl_lines="13 18"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -180,7 +180,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
//// tab | Python 3.9+
```Python hl_lines="15 20"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -188,7 +188,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
//// tab | Python 3.8+
```Python hl_lines="16 21"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -202,7 +202,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
///
```Python hl_lines="11 16"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -216,7 +216,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
///
```Python hl_lines="15 20"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -279,7 +279,7 @@ commons: Annotated[dict, Depends(common_parameters)]
//// tab | Python 3.10+
```Python hl_lines="12 16 21"
-{!> ../../../docs_src/dependencies/tutorial001_02_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an_py310.py!}
```
////
@@ -287,7 +287,7 @@ commons: Annotated[dict, Depends(common_parameters)]
//// tab | Python 3.9+
```Python hl_lines="14 18 23"
-{!> ../../../docs_src/dependencies/tutorial001_02_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an_py39.py!}
```
////
@@ -295,7 +295,7 @@ commons: Annotated[dict, Depends(common_parameters)]
//// tab | Python 3.8+
```Python hl_lines="15 19 24"
-{!> ../../../docs_src/dependencies/tutorial001_02_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an.py!}
```
////
diff --git a/docs/ko/docs/tutorial/encoder.md b/docs/ko/docs/tutorial/encoder.md
index b8e87449c..732566d6d 100644
--- a/docs/ko/docs/tutorial/encoder.md
+++ b/docs/ko/docs/tutorial/encoder.md
@@ -21,7 +21,7 @@ JSON 호환 가능 데이터만 수신하는 `fake_db` 데이터베이스가 존
Pydantic 모델과 같은 객체를 받고 JSON 호환 가능한 버전으로 반환합니다:
```Python hl_lines="5 22"
-{!../../../docs_src/encoder/tutorial001.py!}
+{!../../docs_src/encoder/tutorial001.py!}
```
이 예시는 Pydantic 모델을 `dict`로, `datetime` 형식을 `str`로 변환합니다.
diff --git a/docs/ko/docs/tutorial/extra-data-types.md b/docs/ko/docs/tutorial/extra-data-types.md
index df3c7a06e..8baaa64fc 100644
--- a/docs/ko/docs/tutorial/extra-data-types.md
+++ b/docs/ko/docs/tutorial/extra-data-types.md
@@ -58,7 +58,7 @@
//// tab | Python 3.10+
```Python hl_lines="1 3 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py310.py!}
```
////
@@ -66,7 +66,7 @@
//// tab | Python 3.9+
```Python hl_lines="1 3 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py39.py!}
```
////
@@ -74,7 +74,7 @@
//// tab | Python 3.8+
```Python hl_lines="1 3 13-17"
-{!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an.py!}
```
////
@@ -88,7 +88,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1 2 11-15"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
@@ -102,7 +102,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1 2 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
@@ -112,7 +112,7 @@ Prefer to use the `Annotated` version if possible.
//// tab | Python 3.10+
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py310.py!}
```
////
@@ -120,7 +120,7 @@ Prefer to use the `Annotated` version if possible.
//// tab | Python 3.9+
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py39.py!}
```
////
@@ -128,7 +128,7 @@ Prefer to use the `Annotated` version if possible.
//// tab | Python 3.8+
```Python hl_lines="19-20"
-{!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an.py!}
```
////
@@ -142,7 +142,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="17-18"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
@@ -156,7 +156,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
diff --git a/docs/ko/docs/tutorial/first-steps.md b/docs/ko/docs/tutorial/first-steps.md
index 52e53fd89..c2c48fb3e 100644
--- a/docs/ko/docs/tutorial/first-steps.md
+++ b/docs/ko/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
가장 단순한 FastAPI 파일은 다음과 같이 보일 것입니다:
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
위 코드를 `main.py`에 복사합니다.
@@ -134,7 +134,7 @@ API와 통신하는 클라이언트(프론트엔드, 모바일, IoT 애플리케
### 1 단계: `FastAPI` 임포트
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI`는 당신의 API를 위한 모든 기능을 제공하는 파이썬 클래스입니다.
@@ -150,7 +150,7 @@ API와 통신하는 클라이언트(프론트엔드, 모바일, IoT 애플리케
### 2 단계: `FastAPI` "인스턴스" 생성
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
여기에서 `app` 변수는 `FastAPI` 클래스의 "인스턴스"가 됩니다.
@@ -172,7 +172,7 @@ $ uvicorn main:app --reload
아래처럼 앱을 만든다면:
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial002.py!}
+{!../../docs_src/first_steps/tutorial002.py!}
```
이를 `main.py` 파일에 넣고, `uvicorn`을 아래처럼 호출해야 합니다:
@@ -251,7 +251,7 @@ API를 설계할 때 일반적으로 특정 행동을 수행하기 위해 특정
#### *경로 작동 데코레이터* 정의
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`@app.get("/")`은 **FastAPI**에게 바로 아래에 있는 함수가 다음으로 이동하는 요청을 처리한다는 것을 알려줍니다.
@@ -307,7 +307,7 @@ API를 설계할 때 일반적으로 특정 행동을 수행하기 위해 특정
* **함수**: 는 "데코레이터" 아래에 있는 함수입니다 (`@app.get("/")` 아래).
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
이것은 파이썬 함수입니다.
@@ -321,7 +321,7 @@ URL "`/`"에 대한 `GET` 작동을 사용하는 요청을 받을 때마다 **Fa
`async def`을 이용하는 대신 일반 함수로 정의할 수 있습니다:
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note | "참고"
@@ -333,7 +333,7 @@ URL "`/`"에 대한 `GET` 작동을 사용하는 요청을 받을 때마다 **Fa
### 5 단계: 콘텐츠 반환
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`dict`, `list`, 단일값을 가진 `str`, `int` 등을 반환할 수 있습니다.
diff --git a/docs/ko/docs/tutorial/header-params.md b/docs/ko/docs/tutorial/header-params.md
index d403b9175..26e198869 100644
--- a/docs/ko/docs/tutorial/header-params.md
+++ b/docs/ko/docs/tutorial/header-params.md
@@ -7,7 +7,7 @@
먼저 `Header`를 임포트합니다:
```Python hl_lines="3"
-{!../../../docs_src/header_params/tutorial001.py!}
+{!../../docs_src/header_params/tutorial001.py!}
```
## `Header` 매개변수 선언
@@ -17,7 +17,7 @@
첫 번째 값은 기본값이며, 추가 검증이나 어노테이션 매개변수 모두 전달할 수 있습니다:
```Python hl_lines="9"
-{!../../../docs_src/header_params/tutorial001.py!}
+{!../../docs_src/header_params/tutorial001.py!}
```
/// note | "기술 세부사항"
@@ -51,7 +51,7 @@
만약 언더스코어를 하이픈으로 자동 변환을 비활성화해야 할 어떤 이유가 있다면, `Header`의 `convert_underscores` 매개변수를 `False`로 설정하십시오:
```Python hl_lines="10"
-{!../../../docs_src/header_params/tutorial002.py!}
+{!../../docs_src/header_params/tutorial002.py!}
```
/// warning | "경고"
@@ -71,7 +71,7 @@
예를 들어, 두 번 이상 나타날 수 있는 `X-Token`헤더를 선언하려면, 다음과 같이 작성합니다:
```Python hl_lines="9"
-{!../../../docs_src/header_params/tutorial003.py!}
+{!../../docs_src/header_params/tutorial003.py!}
```
다음과 같은 두 개의 HTTP 헤더를 전송하여 해당 *경로* 와 통신할 경우:
diff --git a/docs/ko/docs/tutorial/middleware.md b/docs/ko/docs/tutorial/middleware.md
index 84f67bd26..f36f11a27 100644
--- a/docs/ko/docs/tutorial/middleware.md
+++ b/docs/ko/docs/tutorial/middleware.md
@@ -32,7 +32,7 @@
* `response`를 반환하기 전에 추가로 `response`를 수정할 수 있습니다.
```Python hl_lines="8-9 11 14"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
/// tip | "팁"
@@ -60,7 +60,7 @@
예를 들어, 요청을 수행하고 응답을 생성하는데 까지 걸린 시간 값을 가지고 있는 `X-Process-Time` 같은 사용자 정의 헤더를 추가할 수 있습니다.
```Python hl_lines="10 12-13"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
## 다른 미들웨어
diff --git a/docs/ko/docs/tutorial/path-operation-configuration.md b/docs/ko/docs/tutorial/path-operation-configuration.md
index b6608a14d..6ebe613a8 100644
--- a/docs/ko/docs/tutorial/path-operation-configuration.md
+++ b/docs/ko/docs/tutorial/path-operation-configuration.md
@@ -17,7 +17,7 @@
하지만 각 코드의 의미를 모른다면, `status`에 있는 단축 상수들을 사용할수 있습니다:
```Python hl_lines="3 17"
-{!../../../docs_src/path_operation_configuration/tutorial001.py!}
+{!../../docs_src/path_operation_configuration/tutorial001.py!}
```
각 상태 코드들은 응답에 사용되며, OpenAPI 스키마에 추가됩니다.
@@ -35,7 +35,7 @@
(보통 단일 `str`인) `str`로 구성된 `list`와 함께 매개변수 `tags`를 전달하여, `경로 작동`에 태그를 추가할 수 있습니다:
```Python hl_lines="17 22 27"
-{!../../../docs_src/path_operation_configuration/tutorial002.py!}
+{!../../docs_src/path_operation_configuration/tutorial002.py!}
```
전달된 태그들은 OpenAPI의 스키마에 추가되며, 자동 문서 인터페이스에서 사용됩니다:
@@ -47,7 +47,7 @@
`summary`와 `description`을 추가할 수 있습니다:
```Python hl_lines="20-21"
-{!../../../docs_src/path_operation_configuration/tutorial003.py!}
+{!../../docs_src/path_operation_configuration/tutorial003.py!}
```
## 독스트링으로 만든 기술
@@ -57,7 +57,7 @@
<a href="https://ko.wikipedia.org/wiki/%EB%A7%88%ED%81%AC%EB%8B%A4%EC%9A%B4" class="external-link" target="_blank">마크다운</a> 문법으로 독스트링을 작성할 수 있습니다, 작성된 마크다운 형식의 독스트링은 (마크다운의 들여쓰기를 고려하여) 올바르게 화면에 출력됩니다.
```Python hl_lines="19-27"
-{!../../../docs_src/path_operation_configuration/tutorial004.py!}
+{!../../docs_src/path_operation_configuration/tutorial004.py!}
```
이는 대화형 문서에서 사용됩니다:
@@ -69,7 +69,7 @@
`response_description` 매개변수로 응답에 관한 설명을 명시할 수 있습니다:
```Python hl_lines="21"
-{!../../../docs_src/path_operation_configuration/tutorial005.py!}
+{!../../docs_src/path_operation_configuration/tutorial005.py!}
```
/// info | "정보"
@@ -93,7 +93,7 @@ OpenAPI는 각 *경로 작동*이 응답에 관한 설명을 요구할 것을
단일 *경로 작동*을 없애지 않고 <abbr title="구식, 사용하지 않는것이 권장됨">지원중단</abbr>을 해야한다면, `deprecated` 매개변수를 전달하면 됩니다.
```Python hl_lines="16"
-{!../../../docs_src/path_operation_configuration/tutorial006.py!}
+{!../../docs_src/path_operation_configuration/tutorial006.py!}
```
대화형 문서에 지원중단이라고 표시됩니다.
diff --git a/docs/ko/docs/tutorial/path-params-numeric-validations.md b/docs/ko/docs/tutorial/path-params-numeric-validations.md
index 6d3215c24..caab2d453 100644
--- a/docs/ko/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/ko/docs/tutorial/path-params-numeric-validations.md
@@ -7,7 +7,7 @@
먼저 `fastapi`에서 `Path`를 임포트합니다:
```Python hl_lines="3"
-{!../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
## 메타데이터 선언
@@ -17,7 +17,7 @@
예를 들어, `title` 메타데이터 값을 경로 매개변수 `item_id`에 선언하려면 다음과 같이 입력할 수 있습니다:
```Python hl_lines="10"
-{!../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
/// note | "참고"
@@ -47,7 +47,7 @@
따라서 함수를 다음과 같이 선언 할 수 있습니다:
```Python hl_lines="7"
-{!../../../docs_src/path_params_numeric_validations/tutorial002.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial002.py!}
```
## 필요한 경우 매개변수 정렬하기, 트릭
@@ -59,7 +59,7 @@
파이썬은 `*`으로 아무런 행동도 하지 않지만, 따르는 매개변수들은 <abbr title="유래: K-ey W-ord Arg-uments"><code>kwargs</code></abbr>로도 알려진 키워드 인자(키-값 쌍)여야 함을 인지합니다. 기본값을 가지고 있지 않더라도 그렇습니다.
```Python hl_lines="7"
-{!../../../docs_src/path_params_numeric_validations/tutorial003.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial003.py!}
```
## 숫자 검증: 크거나 같음
@@ -69,7 +69,7 @@
여기서 `ge=1`인 경우, `item_id`는 `1`보다 "크거나(`g`reater) 같은(`e`qual)" 정수형 숫자여야 합니다.
```Python hl_lines="8"
-{!../../../docs_src/path_params_numeric_validations/tutorial004.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial004.py!}
```
## 숫자 검증: 크거나 같음 및 작거나 같음
@@ -80,7 +80,7 @@
* `le`: 작거나 같은(`l`ess than or `e`qual)
```Python hl_lines="9"
-{!../../../docs_src/path_params_numeric_validations/tutorial005.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial005.py!}
```
## 숫자 검증: 부동소수, 크거나 및 작거나
@@ -94,7 +94,7 @@
<abbr title="less than"><code>lt</code></abbr> 역시 마찬가지입니다.
```Python hl_lines="11"
-{!../../../docs_src/path_params_numeric_validations/tutorial006.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial006.py!}
```
## 요약
diff --git a/docs/ko/docs/tutorial/path-params.md b/docs/ko/docs/tutorial/path-params.md
index 67a2d899d..09a27a7b3 100644
--- a/docs/ko/docs/tutorial/path-params.md
+++ b/docs/ko/docs/tutorial/path-params.md
@@ -3,7 +3,7 @@
파이썬의 포맷 문자열 리터럴에서 사용되는 문법을 이용하여 경로 "매개변수" 또는 "변수"를 선언할 수 있습니다:
```Python hl_lines="6-7"
-{!../../../docs_src/path_params/tutorial001.py!}
+{!../../docs_src/path_params/tutorial001.py!}
```
경로 매개변수 `item_id`의 값은 함수의 `item_id` 인자로 전달됩니다.
@@ -19,7 +19,7 @@
파이썬 표준 타입 어노테이션을 사용하여 함수에 있는 경로 매개변수의 타입을 선언할 수 있습니다:
```Python hl_lines="7"
-{!../../../docs_src/path_params/tutorial002.py!}
+{!../../docs_src/path_params/tutorial002.py!}
```
위의 예시에서, `item_id`는 `int`로 선언되었습니다.
@@ -122,7 +122,7 @@
*경로 작동*은 순차적으로 실행되기 때문에 `/users/{user_id}` 이전에 `/users/me`를 먼저 선언해야 합니다:
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003.py!}
+{!../../docs_src/path_params/tutorial003.py!}
```
그렇지 않으면 `/users/{user_id}`는 `/users/me` 요청 또한 매개변수 `user_id`의 값이 `"me"`인 것으로 "생각하게" 됩니다.
@@ -140,7 +140,7 @@
가능한 값들에 해당하는 고정된 값의 클래스 어트리뷰트들을 만듭니다:
```Python hl_lines="1 6-9"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// info | "정보"
@@ -160,7 +160,7 @@
생성한 열거형 클래스(`ModelName`)를 사용하는 타입 어노테이션으로 *경로 매개변수*를 만듭니다:
```Python hl_lines="16"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
### 문서 확인
@@ -178,7 +178,7 @@
열거형 `ModelName`의 *열거형 멤버*를 비교할 수 있습니다:
```Python hl_lines="17"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
#### *열거형 값* 가져오기
@@ -186,7 +186,7 @@
`model_name.value` 또는 일반적으로 `your_enum_member.value`를 이용하여 실제 값(위 예시의 경우 `str`)을 가져올 수 있습니다:
```Python hl_lines="20"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// tip | "팁"
@@ -202,7 +202,7 @@
클라이언트에 반환하기 전에 해당 값(이 경우 문자열)으로 변환됩니다:
```Python hl_lines="18 21 23"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
클라이언트는 아래의 JSON 응답을 얻습니다:
@@ -243,7 +243,7 @@ Starlette의 옵션을 직접 이용하여 다음과 같은 URL을 사용함으
따라서 다음과 같이 사용할 수 있습니다:
```Python hl_lines="6"
-{!../../../docs_src/path_params/tutorial004.py!}
+{!../../docs_src/path_params/tutorial004.py!}
```
/// tip | "팁"
diff --git a/docs/ko/docs/tutorial/query-params-str-validations.md b/docs/ko/docs/tutorial/query-params-str-validations.md
index 11193950b..e44f6dd16 100644
--- a/docs/ko/docs/tutorial/query-params-str-validations.md
+++ b/docs/ko/docs/tutorial/query-params-str-validations.md
@@ -5,7 +5,7 @@
이 응용 프로그램을 예로 들어보겠습니다:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial001.py!}
+{!../../docs_src/query_params_str_validations/tutorial001.py!}
```
쿼리 매개변수 `q`는 `Optional[str]` 자료형입니다. 즉, `str` 자료형이지만 `None` 역시 될 수 있음을 뜻하고, 실제로 기본값은 `None`이기 때문에 FastAPI는 이 매개변수가 필수가 아니라는 것을 압니다.
@@ -27,7 +27,7 @@ FastAPI는 `q`의 기본값이 `= None`이기 때문에 필수가 아님을 압
이를 위해 먼저 `fastapi`에서 `Query`를 임포트합니다:
```Python hl_lines="3"
-{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!../../docs_src/query_params_str_validations/tutorial002.py!}
```
## 기본값으로 `Query` 사용
@@ -35,7 +35,7 @@ FastAPI는 `q`의 기본값이 `= None`이기 때문에 필수가 아님을 압
이제 `Query`를 매개변수의 기본값으로 사용하여 `max_length` 매개변수를 50으로 설정합니다:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!../../docs_src/query_params_str_validations/tutorial002.py!}
```
기본값 `None`을 `Query(None)`으로 바꿔야 하므로, `Query`의 첫 번째 매개변수는 기본값을 정의하는 것과 같은 목적으로 사용됩니다.
@@ -87,7 +87,7 @@ q: str = Query(None, max_length=50)
매개변수 `min_length` 또한 추가할 수 있습니다:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial003.py!}
+{!../../docs_src/query_params_str_validations/tutorial003.py!}
```
## 정규식 추가
@@ -95,7 +95,7 @@ q: str = Query(None, max_length=50)
매개변수와 일치해야 하는 <abbr title="정규표현식(regular expression), regex 또는 regexp는 문자열 조회 패턴을 정의하는 문자들의 순열입니다">정규표현식</abbr>을 정의할 수 있습니다:
```Python hl_lines="10"
-{!../../../docs_src/query_params_str_validations/tutorial004.py!}
+{!../../docs_src/query_params_str_validations/tutorial004.py!}
```
이 특정 정규표현식은 전달 받은 매개변수 값을 검사합니다:
@@ -115,7 +115,7 @@ q: str = Query(None, max_length=50)
`min_length`가 `3`이고, 기본값이 `"fixedquery"`인 쿼리 매개변수 `q`를 선언해봅시다:
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial005.py!}
+{!../../docs_src/query_params_str_validations/tutorial005.py!}
```
/// note | "참고"
@@ -147,7 +147,7 @@ q: Optional[str] = Query(None, min_length=3)
그래서 `Query`를 필수값으로 만들어야 할 때면, 첫 번째 인자로 `...`를 사용할 수 있습니다:
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial006.py!}
+{!../../docs_src/query_params_str_validations/tutorial006.py!}
```
/// info | "정보"
@@ -165,7 +165,7 @@ q: Optional[str] = Query(None, min_length=3)
예를 들어, URL에서 여러번 나오는 `q` 쿼리 매개변수를 선언하려면 다음과 같이 작성할 수 있습니다:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial011.py!}
+{!../../docs_src/query_params_str_validations/tutorial011.py!}
```
아래와 같은 URL을 사용합니다:
@@ -202,7 +202,7 @@ http://localhost:8000/items/?q=foo&q=bar
그리고 제공된 값이 없으면 기본 `list` 값을 정의할 수도 있습니다:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial012.py!}
+{!../../docs_src/query_params_str_validations/tutorial012.py!}
```
아래로 이동한다면:
@@ -227,7 +227,7 @@ http://localhost:8000/items/
`List[str]` 대신 `list`를 직접 사용할 수도 있습니다:
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial013.py!}
+{!../../docs_src/query_params_str_validations/tutorial013.py!}
```
/// note | "참고"
@@ -255,13 +255,13 @@ http://localhost:8000/items/
`title`을 추가할 수 있습니다:
```Python hl_lines="10"
-{!../../../docs_src/query_params_str_validations/tutorial007.py!}
+{!../../docs_src/query_params_str_validations/tutorial007.py!}
```
그리고 `description`도 추가할 수 있습니다:
```Python hl_lines="13"
-{!../../../docs_src/query_params_str_validations/tutorial008.py!}
+{!../../docs_src/query_params_str_validations/tutorial008.py!}
```
## 별칭 매개변수
@@ -283,7 +283,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
이럴 경우 `alias`를 선언할 수 있으며, 해당 별칭은 매개변수 값을 찾는 데 사용됩니다:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial009.py!}
+{!../../docs_src/query_params_str_validations/tutorial009.py!}
```
## 매개변수 사용하지 않게 하기
@@ -295,7 +295,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
그렇다면 `deprecated=True` 매개변수를 `Query`로 전달합니다:
```Python hl_lines="18"
-{!../../../docs_src/query_params_str_validations/tutorial010.py!}
+{!../../docs_src/query_params_str_validations/tutorial010.py!}
```
문서가 아래와 같이 보일겁니다:
diff --git a/docs/ko/docs/tutorial/query-params.md b/docs/ko/docs/tutorial/query-params.md
index e71444c18..b2a946c09 100644
--- a/docs/ko/docs/tutorial/query-params.md
+++ b/docs/ko/docs/tutorial/query-params.md
@@ -3,7 +3,7 @@
경로 매개변수의 일부가 아닌 다른 함수 매개변수를 선언하면 "쿼리" 매개변수로 자동 해석합니다.
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial001.py!}
+{!../../docs_src/query_params/tutorial001.py!}
```
쿼리는 URL에서 `?` 후에 나오고 `&`으로 구분되는 키-값 쌍의 집합입니다.
@@ -64,7 +64,7 @@ http://127.0.0.1:8000/items/?skip=20
같은 방법으로 기본값을 `None`으로 설정하여 선택적 매개변수를 선언할 수 있습니다:
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial002.py!}
+{!../../docs_src/query_params/tutorial002.py!}
```
이 경우 함수 매개변수 `q`는 선택적이며 기본값으로 `None` 값이 됩니다.
@@ -88,7 +88,7 @@ FastAPI는 `q`가 `= None`이므로 선택적이라는 것을 인지합니다.
`bool` 형으로 선언할 수도 있고, 아래처럼 변환됩니다:
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial003.py!}
+{!../../docs_src/query_params/tutorial003.py!}
```
이 경우, 아래로 이동하면:
@@ -133,7 +133,7 @@ http://127.0.0.1:8000/items/foo?short=yes
매개변수들은 이름으로 감지됩니다:
```Python hl_lines="8 10"
-{!../../../docs_src/query_params/tutorial004.py!}
+{!../../docs_src/query_params/tutorial004.py!}
```
## 필수 쿼리 매개변수
@@ -145,7 +145,7 @@ http://127.0.0.1:8000/items/foo?short=yes
그러나 쿼리 매개변수를 필수로 만들려면 단순히 기본값을 선언하지 않으면 됩니다:
```Python hl_lines="6-7"
-{!../../../docs_src/query_params/tutorial005.py!}
+{!../../docs_src/query_params/tutorial005.py!}
```
여기 쿼리 매개변수 `needy`는 `str`형인 필수 쿼리 매개변수입니다.
@@ -191,7 +191,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
그리고 물론, 일부 매개변수는 필수로, 다른 일부는 기본값을, 또 다른 일부는 선택적으로 선언할 수 있습니다:
```Python hl_lines="10"
-{!../../../docs_src/query_params/tutorial006.py!}
+{!../../docs_src/query_params/tutorial006.py!}
```
위 예시에서는 3가지 쿼리 매개변수가 있습니다:
diff --git a/docs/ko/docs/tutorial/request-files.md b/docs/ko/docs/tutorial/request-files.md
index b7781ef5e..40579dd51 100644
--- a/docs/ko/docs/tutorial/request-files.md
+++ b/docs/ko/docs/tutorial/request-files.md
@@ -17,7 +17,7 @@
`fastapi` 에서 `File` 과 `UploadFile` 을 임포트 합니다:
```Python hl_lines="1"
-{!../../../docs_src/request_files/tutorial001.py!}
+{!../../docs_src/request_files/tutorial001.py!}
```
## `File` 매개변수 정의
@@ -25,7 +25,7 @@
`Body` 및 `Form` 과 동일한 방식으로 파일의 매개변수를 생성합니다:
```Python hl_lines="7"
-{!../../../docs_src/request_files/tutorial001.py!}
+{!../../docs_src/request_files/tutorial001.py!}
```
/// info | "정보"
@@ -55,7 +55,7 @@ File의 본문을 선언할 때, 매개변수가 쿼리 매개변수 또는 본
`File` 매개변수를 `UploadFile` 타입으로 정의합니다:
```Python hl_lines="12"
-{!../../../docs_src/request_files/tutorial001.py!}
+{!../../docs_src/request_files/tutorial001.py!}
```
`UploadFile` 을 사용하는 것은 `bytes` 과 비교해 다음과 같은 장점이 있습니다:
@@ -143,7 +143,7 @@ HTML의 폼들(`<form></form>`)이 서버에 데이터를 전송하는 방식은
이 기능을 사용하기 위해 , `bytes` 의 `List` 또는 `UploadFile` 를 선언하기 바랍니다:
```Python hl_lines="10 15"
-{!../../../docs_src/request_files/tutorial002.py!}
+{!../../docs_src/request_files/tutorial002.py!}
```
선언한대로, `bytes` 의 `list` 또는 `UploadFile` 들을 전송받을 것입니다.
diff --git a/docs/ko/docs/tutorial/request-forms-and-files.md b/docs/ko/docs/tutorial/request-forms-and-files.md
index 0867414ea..24501fe34 100644
--- a/docs/ko/docs/tutorial/request-forms-and-files.md
+++ b/docs/ko/docs/tutorial/request-forms-and-files.md
@@ -13,7 +13,7 @@
## `File` 및 `Form` 업로드
```Python hl_lines="1"
-{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!../../docs_src/request_forms_and_files/tutorial001.py!}
```
## `File` 및 `Form` 매개변수 정의
@@ -21,7 +21,7 @@
`Body` 및 `Query`와 동일한 방식으로 파일과 폼의 매개변수를 생성합니다:
```Python hl_lines="8"
-{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!../../docs_src/request_forms_and_files/tutorial001.py!}
```
파일과 폼 필드는 폼 데이터 형식으로 업로드되어 파일과 폼 필드로 전달됩니다.
diff --git a/docs/ko/docs/tutorial/response-model.md b/docs/ko/docs/tutorial/response-model.md
index fc74a60b3..74034e34d 100644
--- a/docs/ko/docs/tutorial/response-model.md
+++ b/docs/ko/docs/tutorial/response-model.md
@@ -9,7 +9,7 @@
* 기타.
```Python hl_lines="17"
-{!../../../docs_src/response_model/tutorial001.py!}
+{!../../docs_src/response_model/tutorial001.py!}
```
/// note | "참고"
@@ -42,13 +42,13 @@ FastAPI는 이 `response_model`를 사용하여:
여기서 우리는 평문 비밀번호를 포함하는 `UserIn` 모델을 선언합니다:
```Python hl_lines="9 11"
-{!../../../docs_src/response_model/tutorial002.py!}
+{!../../docs_src/response_model/tutorial002.py!}
```
그리고 이 모델을 사용하여 입력을 선언하고 같은 모델로 출력을 선언합니다:
```Python hl_lines="17-18"
-{!../../../docs_src/response_model/tutorial002.py!}
+{!../../docs_src/response_model/tutorial002.py!}
```
이제 브라우저가 비밀번호로 사용자를 만들 때마다 API는 응답으로 동일한 비밀번호를 반환합니다.
@@ -68,19 +68,19 @@ FastAPI는 이 `response_model`를 사용하여:
대신 평문 비밀번호로 입력 모델을 만들고 해당 비밀번호 없이 출력 모델을 만들 수 있습니다:
```Python hl_lines="9 11 16"
-{!../../../docs_src/response_model/tutorial003.py!}
+{!../../docs_src/response_model/tutorial003.py!}
```
여기서 *경로 작동 함수*가 비밀번호를 포함하는 동일한 입력 사용자를 반환할지라도:
```Python hl_lines="24"
-{!../../../docs_src/response_model/tutorial003.py!}
+{!../../docs_src/response_model/tutorial003.py!}
```
...`response_model`을 `UserOut` 모델로 선언했기 때문에 비밀번호를 포함하지 않습니다:
```Python hl_lines="22"
-{!../../../docs_src/response_model/tutorial003.py!}
+{!../../docs_src/response_model/tutorial003.py!}
```
따라서 **FastAPI**는 출력 모델에서 선언하지 않은 모든 데이터를 (Pydantic을 사용하여) 필터링합니다.
@@ -100,7 +100,7 @@ FastAPI는 이 `response_model`를 사용하여:
응답 모델은 아래와 같이 기본값을 가질 수 있습니다:
```Python hl_lines="11 13-14"
-{!../../../docs_src/response_model/tutorial004.py!}
+{!../../docs_src/response_model/tutorial004.py!}
```
* `description: Optional[str] = None`은 기본값으로 `None`을 갖습니다.
@@ -116,7 +116,7 @@ FastAPI는 이 `response_model`를 사용하여:
*경로 작동 데코레이터* 매개변수를 `response_model_exclude_unset=True`로 설정 할 수 있습니다:
```Python hl_lines="24"
-{!../../../docs_src/response_model/tutorial004.py!}
+{!../../docs_src/response_model/tutorial004.py!}
```
이러한 기본값은 응답에 포함되지 않고 실제로 설정된 값만 포함됩니다.
@@ -208,7 +208,7 @@ Pydantic 모델이 하나만 있고 출력에서 일부 데이터를 제
///
```Python hl_lines="31 37"
-{!../../../docs_src/response_model/tutorial005.py!}
+{!../../docs_src/response_model/tutorial005.py!}
```
/// tip | "팁"
@@ -224,7 +224,7 @@ Pydantic 모델이 하나만 있고 출력에서 일부 데이터를 제
`list` 또는 `tuple` 대신 `set`을 사용하는 법을 잊었더라도, FastAPI는 `set`으로 변환하고 정상적으로 작동합니다:
```Python hl_lines="31 37"
-{!../../../docs_src/response_model/tutorial006.py!}
+{!../../docs_src/response_model/tutorial006.py!}
```
## 요약
diff --git a/docs/ko/docs/tutorial/response-status-code.md b/docs/ko/docs/tutorial/response-status-code.md
index 48cb49cbf..57eef6ba1 100644
--- a/docs/ko/docs/tutorial/response-status-code.md
+++ b/docs/ko/docs/tutorial/response-status-code.md
@@ -9,7 +9,7 @@
* 기타
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
/// note | "참고"
@@ -77,7 +77,7 @@ HTTP는 세자리의 숫자 상태 코드를 응답의 일부로 전송합니다
상기 예시 참고:
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
`201` 은 "생성됨"를 의미하는 상태 코드입니다.
@@ -87,7 +87,7 @@ HTTP는 세자리의 숫자 상태 코드를 응답의 일부로 전송합니다
`fastapi.status` 의 편의 변수를 사용할 수 있습니다.
```Python hl_lines="1 6"
-{!../../../docs_src/response_status_code/tutorial002.py!}
+{!../../docs_src/response_status_code/tutorial002.py!}
```
이것은 단순히 작업을 편리하게 하기 위한 것으로, HTTP 상태 코드와 동일한 번호를 갖고있지만, 이를 사용하면 편집기의 자동완성 기능을 사용할 수 있습니다:
diff --git a/docs/ko/docs/tutorial/schema-extra-example.md b/docs/ko/docs/tutorial/schema-extra-example.md
index 7b5ccdd32..71052b334 100644
--- a/docs/ko/docs/tutorial/schema-extra-example.md
+++ b/docs/ko/docs/tutorial/schema-extra-example.md
@@ -11,7 +11,7 @@
//// tab | Python 3.10+ Pydantic v2
```Python hl_lines="13-24"
-{!> ../../../docs_src/schema_extra_example/tutorial001_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001_py310.py!}
```
////
@@ -19,7 +19,7 @@
//// tab | Python 3.10+ Pydantic v1
```Python hl_lines="13-23"
-{!> ../../../docs_src/schema_extra_example/tutorial001_py310_pv1.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001_py310_pv1.py!}
```
////
@@ -27,7 +27,7 @@
//// tab | Python 3.8+ Pydantic v2
```Python hl_lines="15-26"
-{!> ../../../docs_src/schema_extra_example/tutorial001.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001.py!}
```
////
@@ -35,7 +35,7 @@
//// tab | Python 3.8+ Pydantic v1
```Python hl_lines="15-25"
-{!> ../../../docs_src/schema_extra_example/tutorial001_pv1.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001_pv1.py!}
```
////
@@ -83,7 +83,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
//// tab | Python 3.10+
```Python hl_lines="2 8-11"
-{!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial002_py310.py!}
```
////
@@ -91,7 +91,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
//// tab | Python 3.8+
```Python hl_lines="4 10-13"
-{!> ../../../docs_src/schema_extra_example/tutorial002.py!}
+{!> ../../docs_src/schema_extra_example/tutorial002.py!}
```
////
@@ -117,7 +117,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
//// tab | Python 3.10+
```Python hl_lines="22-29"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
```
////
@@ -125,7 +125,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
//// tab | Python 3.9+
```Python hl_lines="22-29"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
```
////
@@ -133,7 +133,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
//// tab | Python 3.8+
```Python hl_lines="23-30"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an.py!}
```
////
@@ -147,7 +147,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
///
```Python hl_lines="18-25"
-{!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_py310.py!}
```
////
@@ -161,7 +161,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
///
```Python hl_lines="20-27"
-{!> ../../../docs_src/schema_extra_example/tutorial003.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003.py!}
```
////
@@ -179,7 +179,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
//// tab | Python 3.10+
```Python hl_lines="23-38"
-{!> ../../../docs_src/schema_extra_example/tutorial004_an_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_an_py310.py!}
```
////
@@ -187,7 +187,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
//// tab | Python 3.9+
```Python hl_lines="23-38"
-{!> ../../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
```
////
@@ -195,7 +195,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
//// tab | Python 3.8+
```Python hl_lines="24-39"
-{!> ../../../docs_src/schema_extra_example/tutorial004_an.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_an.py!}
```
////
@@ -209,7 +209,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
///
```Python hl_lines="19-34"
-{!> ../../../docs_src/schema_extra_example/tutorial004_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_py310.py!}
```
////
@@ -223,7 +223,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
///
```Python hl_lines="21-36"
-{!> ../../../docs_src/schema_extra_example/tutorial004.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004.py!}
```
////
@@ -270,7 +270,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
//// tab | Python 3.10+
```Python hl_lines="23-49"
-{!> ../../../docs_src/schema_extra_example/tutorial005_an_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005_an_py310.py!}
```
////
@@ -278,7 +278,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
//// tab | Python 3.9+
```Python hl_lines="23-49"
-{!> ../../../docs_src/schema_extra_example/tutorial005_an_py39.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005_an_py39.py!}
```
////
@@ -286,7 +286,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
//// tab | Python 3.8+
```Python hl_lines="24-50"
-{!> ../../../docs_src/schema_extra_example/tutorial005_an.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005_an.py!}
```
////
@@ -300,7 +300,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
///
```Python hl_lines="19-45"
-{!> ../../../docs_src/schema_extra_example/tutorial005_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005_py310.py!}
```
////
@@ -314,7 +314,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
///
```Python hl_lines="21-47"
-{!> ../../../docs_src/schema_extra_example/tutorial005.py!}
+{!> ../../docs_src/schema_extra_example/tutorial005.py!}
```
////
diff --git a/docs/ko/docs/tutorial/security/get-current-user.md b/docs/ko/docs/tutorial/security/get-current-user.md
index 9bf3d4ee1..56f5792a7 100644
--- a/docs/ko/docs/tutorial/security/get-current-user.md
+++ b/docs/ko/docs/tutorial/security/get-current-user.md
@@ -3,7 +3,7 @@
이전 장에서 (의존성 주입 시스템을 기반으로 한)보안 시스템은 *경로 작동 함수*에서 `str`로 `token`을 제공했습니다:
```Python hl_lines="10"
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
그러나 아직도 유용하지 않습니다.
@@ -19,7 +19,7 @@ Pydantic을 사용하여 본문을 선언하는 것과 같은 방식으로 다
//// tab | 파이썬 3.7 이상
```Python hl_lines="5 12-16"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -27,7 +27,7 @@ Pydantic을 사용하여 본문을 선언하는 것과 같은 방식으로 다
//// tab | 파이썬 3.10 이상
```Python hl_lines="3 10-14"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -45,7 +45,7 @@ Pydantic을 사용하여 본문을 선언하는 것과 같은 방식으로 다
//// tab | 파이썬 3.7 이상
```Python hl_lines="25"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -53,7 +53,7 @@ Pydantic을 사용하여 본문을 선언하는 것과 같은 방식으로 다
//// tab | 파이썬 3.10 이상
```Python hl_lines="23"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -65,7 +65,7 @@ Pydantic을 사용하여 본문을 선언하는 것과 같은 방식으로 다
//// tab | 파이썬 3.7 이상
```Python hl_lines="19-22 26-27"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -73,7 +73,7 @@ Pydantic을 사용하여 본문을 선언하는 것과 같은 방식으로 다
//// tab | 파이썬 3.10 이상
```Python hl_lines="17-20 24-25"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -85,7 +85,7 @@ Pydantic을 사용하여 본문을 선언하는 것과 같은 방식으로 다
//// tab | 파이썬 3.7 이상
```Python hl_lines="31"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -93,7 +93,7 @@ Pydantic을 사용하여 본문을 선언하는 것과 같은 방식으로 다
//// tab | 파이썬 3.10 이상
```Python hl_lines="29"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
@@ -153,7 +153,7 @@ Pydantic 모델인 `User`로 `current_user`의 타입을 선언하는 것을 알
//// tab | 파이썬 3.7 이상
```Python hl_lines="30-32"
-{!> ../../../docs_src/security/tutorial002.py!}
+{!> ../../docs_src/security/tutorial002.py!}
```
////
@@ -161,7 +161,7 @@ Pydantic 모델인 `User`로 `current_user`의 타입을 선언하는 것을 알
//// tab | 파이썬 3.10 이상
```Python hl_lines="28-30"
-{!> ../../../docs_src/security/tutorial002_py310.py!}
+{!> ../../docs_src/security/tutorial002_py310.py!}
```
////
diff --git a/docs/ko/docs/tutorial/security/simple-oauth2.md b/docs/ko/docs/tutorial/security/simple-oauth2.md
index 9593f96f5..fd18c1d47 100644
--- a/docs/ko/docs/tutorial/security/simple-oauth2.md
+++ b/docs/ko/docs/tutorial/security/simple-oauth2.md
@@ -55,7 +55,7 @@ OAuth2의 경우 문자열일 뿐입니다.
//// tab | 파이썬 3.7 이상
```Python hl_lines="4 76"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -63,7 +63,7 @@ OAuth2의 경우 문자열일 뿐입니다.
//// tab | 파이썬 3.10 이상
```Python hl_lines="2 74"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -117,7 +117,7 @@ OAuth2 사양은 실제로 `password`라는 고정 값이 있는 `grant_type`
//// tab | 파이썬 3.7 이상
```Python hl_lines="3 77-79"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -125,7 +125,7 @@ OAuth2 사양은 실제로 `password`라는 고정 값이 있는 `grant_type`
//// tab | 파이썬 3.10 이상
```Python hl_lines="1 75-77"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -157,7 +157,7 @@ OAuth2 사양은 실제로 `password`라는 고정 값이 있는 `grant_type`
//// tab | P파이썬 3.7 이상
```Python hl_lines="80-83"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -165,7 +165,7 @@ OAuth2 사양은 실제로 `password`라는 고정 값이 있는 `grant_type`
//// tab | 파이썬 3.10 이상
```Python hl_lines="78-81"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -213,7 +213,7 @@ UserInDB(
//// tab | 파이썬 3.7 이상
```Python hl_lines="85"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -221,7 +221,7 @@ UserInDB(
//// tab | 파이썬 3.10 이상
```Python hl_lines="83"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
@@ -253,7 +253,7 @@ UserInDB(
//// tab | 파이썬 3.7 이상
```Python hl_lines="58-66 69-72 90"
-{!> ../../../docs_src/security/tutorial003.py!}
+{!> ../../docs_src/security/tutorial003.py!}
```
////
@@ -261,7 +261,7 @@ UserInDB(
//// tab | 파이썬 3.10 이상
```Python hl_lines="55-64 67-70 88"
-{!> ../../../docs_src/security/tutorial003_py310.py!}
+{!> ../../docs_src/security/tutorial003_py310.py!}
```
////
diff --git a/docs/ko/docs/tutorial/static-files.md b/docs/ko/docs/tutorial/static-files.md
index 360aaaa6b..90a60d193 100644
--- a/docs/ko/docs/tutorial/static-files.md
+++ b/docs/ko/docs/tutorial/static-files.md
@@ -8,7 +8,7 @@
* 특정 경로에 `StaticFiles()` 인스턴스를 "마운트" 합니다.
```Python hl_lines="2 6"
-{!../../../docs_src/static_files/tutorial001.py!}
+{!../../docs_src/static_files/tutorial001.py!}
```
/// note | "기술적 세부사항"
diff --git a/docs/nl/docs/python-types.md b/docs/nl/docs/python-types.md
index a5562b795..00052037c 100644
--- a/docs/nl/docs/python-types.md
+++ b/docs/nl/docs/python-types.md
@@ -23,7 +23,7 @@ Als je een Python expert bent en alles al weet over type hints, sla dan dit hoof
Laten we beginnen met een eenvoudig voorbeeld:
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
Het aanroepen van dit programma leidt tot het volgende resultaat:
@@ -40,7 +40,7 @@ De functie voert het volgende uit:
* <abbr title="Voegt ze samen, als één. Met de inhoud van de een na de ander.">Voeg samen</abbr> met een spatie in het midden.
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### Bewerk het
@@ -84,7 +84,7 @@ Dat is alles.
Dat zijn de "type hints":
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
Dit is niet hetzelfde als het declareren van standaardwaarden zoals bij:
@@ -114,7 +114,7 @@ Nu kun je de opties bekijken en er doorheen scrollen totdat je de optie vindt di
Bekijk deze functie, deze heeft al type hints:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
Omdat de editor de types van de variabelen kent, krijgt u niet alleen aanvulling, maar ook controles op fouten:
@@ -124,7 +124,7 @@ Omdat de editor de types van de variabelen kent, krijgt u niet alleen aanvulling
Nu weet je hoe je het moet oplossen, converteer `age` naar een string met `str(age)`:
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## Types declareren
@@ -145,7 +145,7 @@ Je kunt bijvoorbeeld het volgende gebruiken:
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### Generieke types met typeparameters
@@ -183,7 +183,7 @@ Als type, vul `list` in.
Doordat de list een type is dat enkele interne types bevat, zet je ze tussen vierkante haakjes:
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006_py39.py!}
+{!> ../../docs_src/python_types/tutorial006_py39.py!}
```
////
@@ -193,7 +193,7 @@ Doordat de list een type is dat enkele interne types bevat, zet je ze tussen vie
Van `typing`, importeer `List` (met een hoofdletter `L`):
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
Declareer de variabele met dezelfde dubbele punt (`:`) syntax.
@@ -203,7 +203,7 @@ Zet als type de `List` die je hebt geïmporteerd uit `typing`.
Doordat de list een type is dat enkele interne types bevat, zet je ze tussen vierkante haakjes:
```Python hl_lines="4"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
////
@@ -241,7 +241,7 @@ Je kunt hetzelfde doen om `tuple`s en `set`s te declareren:
//// tab | Python 3.9+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial007_py39.py!}
+{!> ../../docs_src/python_types/tutorial007_py39.py!}
```
////
@@ -249,7 +249,7 @@ Je kunt hetzelfde doen om `tuple`s en `set`s te declareren:
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial007.py!}
+{!> ../../docs_src/python_types/tutorial007.py!}
```
////
@@ -270,7 +270,7 @@ De tweede typeparameter is voor de waarden (values) van het `dict`:
//// tab | Python 3.9+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008_py39.py!}
+{!> ../../docs_src/python_types/tutorial008_py39.py!}
```
////
@@ -278,7 +278,7 @@ De tweede typeparameter is voor de waarden (values) van het `dict`:
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008.py!}
+{!> ../../docs_src/python_types/tutorial008.py!}
```
////
@@ -300,7 +300,7 @@ In Python 3.10 is er ook een **nieuwe syntax** waarin je de mogelijke types kunt
//// tab | Python 3.10+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008b_py310.py!}
+{!> ../../docs_src/python_types/tutorial008b_py310.py!}
```
////
@@ -308,7 +308,7 @@ In Python 3.10 is er ook een **nieuwe syntax** waarin je de mogelijke types kunt
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008b.py!}
+{!> ../../docs_src/python_types/tutorial008b.py!}
```
////
@@ -322,7 +322,7 @@ Je kunt declareren dat een waarde een type kan hebben, zoals `str`, maar dat het
In Python 3.6 en hoger (inclusief Python 3.10) kun je het declareren door `Optional` te importeren en te gebruiken vanuit de `typing`-module.
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
Door `Optional[str]` te gebruiken in plaats van alleen `str`, kan de editor je helpen fouten te detecteren waarbij je ervan uit zou kunnen gaan dat een waarde altijd een `str` is, terwijl het in werkelijkheid ook `None` zou kunnen zijn.
@@ -334,7 +334,7 @@ Dit betekent ook dat je in Python 3.10 `EenType | None` kunt gebruiken:
//// tab | Python 3.10+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial009_py310.py!}
+{!> ../../docs_src/python_types/tutorial009_py310.py!}
```
////
@@ -342,7 +342,7 @@ Dit betekent ook dat je in Python 3.10 `EenType | None` kunt gebruiken:
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009.py!}
+{!> ../../docs_src/python_types/tutorial009.py!}
```
////
@@ -350,7 +350,7 @@ Dit betekent ook dat je in Python 3.10 `EenType | None` kunt gebruiken:
//// tab | Python 3.8+ alternative
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009b.py!}
+{!> ../../docs_src/python_types/tutorial009b.py!}
```
////
@@ -371,7 +371,7 @@ Het gaat alleen om de woorden en naamgeving. Maar die naamgeving kan invloed heb
Laten we als voorbeeld deze functie nemen:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009c.py!}
+{!../../docs_src/python_types/tutorial009c.py!}
```
De parameter `name` is gedefinieerd als `Optional[str]`, maar is **niet optioneel**, je kunt de functie niet aanroepen zonder de parameter:
@@ -389,7 +389,7 @@ say_hi(name=None) # Dit werkt, None is geldig 🎉
Het goede nieuws is dat als je eenmaal Python 3.10 gebruikt, je je daar geen zorgen meer over hoeft te maken, omdat je dan gewoon `|` kunt gebruiken om unions van types te definiëren:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009c_py310.py!}
+{!../../docs_src/python_types/tutorial009c_py310.py!}
```
Dan hoef je je geen zorgen te maken over namen als `Optional` en `Union`. 😎
@@ -453,13 +453,13 @@ Je kunt een klasse ook declareren als het type van een variabele.
Stel dat je een klasse `Person` hebt, met een naam:
```Python hl_lines="1-3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Vervolgens kun je een variabele van het type `Persoon` declareren:
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Dan krijg je ook nog eens volledige editorondersteuning:
@@ -487,7 +487,7 @@ Een voorbeeld uit de officiële Pydantic-documentatie:
//// tab | Python 3.10+
```Python
-{!> ../../../docs_src/python_types/tutorial011_py310.py!}
+{!> ../../docs_src/python_types/tutorial011_py310.py!}
```
////
@@ -495,7 +495,7 @@ Een voorbeeld uit de officiële Pydantic-documentatie:
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/python_types/tutorial011_py39.py!}
+{!> ../../docs_src/python_types/tutorial011_py39.py!}
```
////
@@ -503,7 +503,7 @@ Een voorbeeld uit de officiële Pydantic-documentatie:
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/python_types/tutorial011.py!}
+{!> ../../docs_src/python_types/tutorial011.py!}
```
////
@@ -533,7 +533,7 @@ Python heeft ook een functie waarmee je **extra <abbr title="Data over de data,
In Python 3.9 is `Annotated` onderdeel van de standaardpakket, dus je kunt het importeren vanuit `typing`.
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial013_py39.py!}
+{!> ../../docs_src/python_types/tutorial013_py39.py!}
```
////
@@ -545,7 +545,7 @@ In versies lager dan Python 3.9 importeer je `Annotated` vanuit `typing_extensio
Het wordt al geïnstalleerd met **FastAPI**.
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial013.py!}
+{!> ../../docs_src/python_types/tutorial013.py!}
```
////
diff --git a/docs/pl/docs/tutorial/first-steps.md b/docs/pl/docs/tutorial/first-steps.md
index 8f1b9b922..99c425f12 100644
--- a/docs/pl/docs/tutorial/first-steps.md
+++ b/docs/pl/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
Najprostszy plik FastAPI może wyglądać tak:
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Skopiuj to do pliku `main.py`.
@@ -134,7 +134,7 @@ Możesz go również użyć do automatycznego generowania kodu dla klientów, kt
### Krok 1: zaimportuj `FastAPI`
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI` jest klasą, która zapewnia wszystkie funkcjonalności Twojego API.
@@ -150,7 +150,7 @@ Oznacza to, że możesz korzystać ze wszystkich funkcjonalności <a href="https
### Krok 2: utwórz instancję `FastAPI`
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Zmienna `app` będzie tutaj "instancją" klasy `FastAPI`.
@@ -172,7 +172,7 @@ $ uvicorn main:app --reload
Jeśli stworzysz swoją aplikację, np.:
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial002.py!}
+{!../../docs_src/first_steps/tutorial002.py!}
```
I umieścisz to w pliku `main.py`, to będziesz mógł tak wywołać `uvicorn`:
@@ -251,7 +251,7 @@ Będziemy je również nazywali "**operacjami**".
#### Zdefiniuj *dekorator operacji na ścieżce*
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`@app.get("/")` mówi **FastAPI** że funkcja poniżej odpowiada za obsługę żądań, które trafiają do:
@@ -307,7 +307,7 @@ To jest nasza "**funkcja obsługująca ścieżkę**":
* **funkcja**: to funkcja poniżej "dekoratora" (poniżej `@app.get("/")`).
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Jest to funkcja Python.
@@ -321,7 +321,7 @@ W tym przypadku jest to funkcja "asynchroniczna".
Możesz również zdefiniować to jako normalną funkcję zamiast `async def`:
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note
@@ -333,7 +333,7 @@ Jeśli nie znasz różnicy, sprawdź [Async: *"In a hurry?"*](../async.md#in-a-h
### Krok 5: zwróć zawartość
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Możesz zwrócić `dict`, `list`, pojedynczą wartość jako `str`, `int`, itp.
diff --git a/docs/pt/docs/advanced/additional-responses.md b/docs/pt/docs/advanced/additional-responses.md
index c27301b61..46cf1efc3 100644
--- a/docs/pt/docs/advanced/additional-responses.md
+++ b/docs/pt/docs/advanced/additional-responses.md
@@ -27,7 +27,7 @@ O **FastAPI** pegará este modelo, gerará o esquema JSON dele e incluirá no lo
Por exemplo, para declarar um outro retorno com o status code `404` e um modelo do Pydantic chamado `Message`, você pode escrever:
```Python hl_lines="18 22"
-{!../../../docs_src/additional_responses/tutorial001.py!}
+{!../../docs_src/additional_responses/tutorial001.py!}
```
/// note | "Nota"
@@ -178,7 +178,7 @@ Você pode utilizar o mesmo parâmetro `responses` para adicionar diferentes med
Por exemplo, você pode adicionar um media type adicional de `image/png`, declarando que a sua *operação de caminho* pode retornar um objeto JSON (com o media type `application/json`) ou uma imagem PNG:
```Python hl_lines="19-24 28"
-{!../../../docs_src/additional_responses/tutorial002.py!}
+{!../../docs_src/additional_responses/tutorial002.py!}
```
/// note | "Nota"
@@ -208,7 +208,7 @@ Por exemplo, você pode declarar um retorno com o código de status `404` que ut
E um retorno com o código de status `200` que utiliza o seu `response_model`, porém inclui um `example` customizado:
```Python hl_lines="20-31"
-{!../../../docs_src/additional_responses/tutorial003.py!}
+{!../../docs_src/additional_responses/tutorial003.py!}
```
Isso será combinado e incluído em seu OpenAPI, e disponibilizado na documentação da sua API:
@@ -244,7 +244,7 @@ Você pode utilizar essa técnica para reutilizar alguns retornos predefinidos n
Por exemplo:
```Python hl_lines="13-17 26"
-{!../../../docs_src/additional_responses/tutorial004.py!}
+{!../../docs_src/additional_responses/tutorial004.py!}
```
## Mais informações sobre retornos OpenAPI
diff --git a/docs/pt/docs/advanced/additional-status-codes.md b/docs/pt/docs/advanced/additional-status-codes.md
index a0869f342..02bb4c015 100644
--- a/docs/pt/docs/advanced/additional-status-codes.md
+++ b/docs/pt/docs/advanced/additional-status-codes.md
@@ -17,7 +17,7 @@ Para conseguir isso, importe `JSONResponse` e retorne o seu conteúdo diretament
//// tab | Python 3.10+
```Python hl_lines="4 25"
-{!> ../../../docs_src/additional_status_codes/tutorial001_an_py310.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001_an_py310.py!}
```
////
@@ -25,7 +25,7 @@ Para conseguir isso, importe `JSONResponse` e retorne o seu conteúdo diretament
//// tab | Python 3.9+
```Python hl_lines="4 25"
-{!> ../../../docs_src/additional_status_codes/tutorial001_an_py39.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001_an_py39.py!}
```
////
@@ -33,7 +33,7 @@ Para conseguir isso, importe `JSONResponse` e retorne o seu conteúdo diretament
//// tab | Python 3.8+
```Python hl_lines="4 26"
-{!> ../../../docs_src/additional_status_codes/tutorial001_an.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001_an.py!}
```
////
@@ -47,7 +47,7 @@ Faça uso da versão `Annotated` quando possível.
///
```Python hl_lines="2 23"
-{!> ../../../docs_src/additional_status_codes/tutorial001_py310.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001_py310.py!}
```
////
@@ -61,7 +61,7 @@ Faça uso da versão `Annotated` quando possível.
///
```Python hl_lines="4 25"
-{!> ../../../docs_src/additional_status_codes/tutorial001.py!}
+{!> ../../docs_src/additional_status_codes/tutorial001.py!}
```
////
diff --git a/docs/pt/docs/advanced/advanced-dependencies.md b/docs/pt/docs/advanced/advanced-dependencies.md
index 5a7b921b2..a656390a4 100644
--- a/docs/pt/docs/advanced/advanced-dependencies.md
+++ b/docs/pt/docs/advanced/advanced-dependencies.md
@@ -21,7 +21,7 @@ Para fazer isso, nós declaramos o método `__call__`:
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
```
////
@@ -29,7 +29,7 @@ Para fazer isso, nós declaramos o método `__call__`:
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial011_an.py!}
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
```
////
@@ -43,7 +43,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial011.py!}
+{!> ../../docs_src/dependencies/tutorial011.py!}
```
////
@@ -57,7 +57,7 @@ E agora, nós podemos utilizar o `__init__` para declarar os parâmetros da inst
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
```
////
@@ -65,7 +65,7 @@ E agora, nós podemos utilizar o `__init__` para declarar os parâmetros da inst
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/dependencies/tutorial011_an.py!}
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
```
////
@@ -79,7 +79,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="7"
-{!> ../../../docs_src/dependencies/tutorial011.py!}
+{!> ../../docs_src/dependencies/tutorial011.py!}
```
////
@@ -93,7 +93,7 @@ Nós poderíamos criar uma instância desta classe com:
//// tab | Python 3.9+
```Python hl_lines="18"
-{!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
```
////
@@ -101,7 +101,7 @@ Nós poderíamos criar uma instância desta classe com:
//// tab | Python 3.8+
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial011_an.py!}
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
```
////
@@ -115,7 +115,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial011.py!}
+{!> ../../docs_src/dependencies/tutorial011.py!}
```
////
@@ -137,7 +137,7 @@ checker(q="somequery")
//// tab | Python 3.9+
```Python hl_lines="22"
-{!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
```
////
@@ -145,7 +145,7 @@ checker(q="somequery")
//// tab | Python 3.8+
```Python hl_lines="21"
-{!> ../../../docs_src/dependencies/tutorial011_an.py!}
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
```
////
@@ -159,7 +159,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial011.py!}
+{!> ../../docs_src/dependencies/tutorial011.py!}
```
////
diff --git a/docs/pt/docs/advanced/async-tests.md b/docs/pt/docs/advanced/async-tests.md
index 7cac26262..c81d6124b 100644
--- a/docs/pt/docs/advanced/async-tests.md
+++ b/docs/pt/docs/advanced/async-tests.md
@@ -33,13 +33,13 @@ Para um exemplos simples, vamos considerar uma estrutura de arquivos semelhante
O arquivo `main.py` teria:
```Python
-{!../../../docs_src/async_tests/main.py!}
+{!../../docs_src/async_tests/main.py!}
```
O arquivo `test_main.py` teria os testes para para o arquivo `main.py`, ele poderia ficar assim:
```Python
-{!../../../docs_src/async_tests/test_main.py!}
+{!../../docs_src/async_tests/test_main.py!}
```
## Executá-lo
@@ -61,7 +61,7 @@ $ pytest
O marcador `@pytest.mark.anyio` informa ao pytest que esta função de teste deve ser invocada de maneira assíncrona:
```Python hl_lines="7"
-{!../../../docs_src/async_tests/test_main.py!}
+{!../../docs_src/async_tests/test_main.py!}
```
/// tip | "Dica"
@@ -73,7 +73,7 @@ Note que a função de teste é `async def` agora, no lugar de apenas `def` como
Então podemos criar um `AsyncClient` com a aplicação, e enviar requisições assíncronas para ela utilizando `await`.
```Python hl_lines="9-12"
-{!../../../docs_src/async_tests/test_main.py!}
+{!../../docs_src/async_tests/test_main.py!}
```
Isso é equivalente a:
diff --git a/docs/pt/docs/advanced/behind-a-proxy.md b/docs/pt/docs/advanced/behind-a-proxy.md
index 2dfc5ca25..3c65b5a0a 100644
--- a/docs/pt/docs/advanced/behind-a-proxy.md
+++ b/docs/pt/docs/advanced/behind-a-proxy.md
@@ -19,7 +19,7 @@ Nesse caso, o caminho original `/app` seria servido em `/api/v1/app`.
Embora todo o seu código esteja escrito assumindo que existe apenas `/app`.
```Python hl_lines="6"
-{!../../../docs_src/behind_a_proxy/tutorial001.py!}
+{!../../docs_src/behind_a_proxy/tutorial001.py!}
```
E o proxy estaria **"removendo"** o **prefixo do caminho** dinamicamente antes de transmitir a solicitação para o servidor da aplicação (provavelmente Uvicorn via CLI do FastAPI), mantendo sua aplicação convencida de que está sendo servida em `/app`, para que você não precise atualizar todo o seu código para incluir o prefixo `/api/v1`.
@@ -99,7 +99,7 @@ Você pode obter o `root_path` atual usado pela sua aplicação para cada solici
Aqui estamos incluindo ele na mensagem apenas para fins de demonstração.
```Python hl_lines="8"
-{!../../../docs_src/behind_a_proxy/tutorial001.py!}
+{!../../docs_src/behind_a_proxy/tutorial001.py!}
```
Então, se você iniciar o Uvicorn com:
@@ -128,7 +128,7 @@ A resposta seria algo como:
Alternativamente, se você não tiver uma maneira de fornecer uma opção de linha de comando como `--root-path` ou equivalente, você pode definir o parâmetro `--root-path` ao criar sua aplicação FastAPI:
```Python hl_lines="3"
-{!../../../docs_src/behind_a_proxy/tutorial002.py!}
+{!../../docs_src/behind_a_proxy/tutorial002.py!}
```
Passar o `root_path`h para `FastAPI` seria o equivalente a passar a opção de linha de comando `--root-path` para Uvicorn ou Hypercorn.
@@ -310,7 +310,7 @@ Se você passar uma lista personalizada de `servers` e houver um `root_path` (po
Por exemplo:
```Python hl_lines="4-7"
-{!../../../docs_src/behind_a_proxy/tutorial003.py!}
+{!../../docs_src/behind_a_proxy/tutorial003.py!}
```
Gerará um OpenAPI schema como:
@@ -359,7 +359,7 @@ A interface de documentação interagirá com o servidor que você selecionar.
Se você não quiser que o **FastAPI** inclua um servidor automático usando o `root_path`, você pode usar o parâmetro `root_path_in_servers=False`:
```Python hl_lines="9"
-{!../../../docs_src/behind_a_proxy/tutorial004.py!}
+{!../../docs_src/behind_a_proxy/tutorial004.py!}
```
e então ele não será incluído no OpenAPI schema.
diff --git a/docs/pt/docs/advanced/events.md b/docs/pt/docs/advanced/events.md
index 5f722763e..02f5b6d2b 100644
--- a/docs/pt/docs/advanced/events.md
+++ b/docs/pt/docs/advanced/events.md
@@ -32,7 +32,7 @@ Vamos iniciar com um exemplo e ver isso detalhadamente.
Nós criamos uma função assíncrona chamada `lifespan()` com `yield` como este:
```Python hl_lines="16 19"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
Aqui nós estamos simulando a *inicialização* custosa do carregamento do modelo colocando a (falsa) função de modelo no dicionário com modelos de _machine learning_ antes do `yield`. Este código será executado **antes** da aplicação **começar a receber requisições**, durante a *inicialização*.
@@ -52,7 +52,7 @@ Talvez você precise inicializar uma nova versão, ou apenas cansou de executá-
A primeira coisa a notar, é que estamos definindo uma função assíncrona com `yield`. Isso é muito semelhante à Dependências com `yield`.
```Python hl_lines="14-19"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
A primeira parte da função, antes do `yield`, será executada **antes** da aplicação inicializar.
@@ -66,7 +66,7 @@ Se você verificar, a função está decorada com um `@asynccontextmanager`.
Que converte a função em algo chamado de "**Gerenciador de Contexto Assíncrono**".
```Python hl_lines="1 13"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
Um **gerenciador de contexto** em Python é algo que você pode usar em uma declaração `with`, por exemplo, `open()` pode ser usado como um gerenciador de contexto:
@@ -90,7 +90,7 @@ No nosso exemplo de código acima, nós não usamos ele diretamente, mas nós pa
O parâmetro `lifespan` da aplicação `FastAPI` usa um **Gerenciador de Contexto Assíncrono**, então nós podemos passar nosso novo gerenciador de contexto assíncrono do `lifespan` para ele.
```Python hl_lines="22"
-{!../../../docs_src/events/tutorial003.py!}
+{!../../docs_src/events/tutorial003.py!}
```
## Eventos alternativos (deprecados)
@@ -114,7 +114,7 @@ Essas funções podem ser declaradas com `async def` ou `def` normal.
Para adicionar uma função que deve rodar antes da aplicação iniciar, declare-a com o evento `"startup"`:
```Python hl_lines="8"
-{!../../../docs_src/events/tutorial001.py!}
+{!../../docs_src/events/tutorial001.py!}
```
Nesse caso, a função de manipulação de evento `startup` irá inicializar os itens do "banco de dados" (só um `dict`) com alguns valores.
@@ -128,7 +128,7 @@ E sua aplicação não irá começar a receber requisições até que todos os m
Para adicionar uma função que deve ser executada quando a aplicação estiver encerrando, declare ela com o evento `"shutdown"`:
```Python hl_lines="6"
-{!../../../docs_src/events/tutorial002.py!}
+{!../../docs_src/events/tutorial002.py!}
```
Aqui, a função de manipulação de evento `shutdown` irá escrever uma linha de texto `"Application shutdown"` no arquivo `log.txt`.
diff --git a/docs/pt/docs/advanced/openapi-webhooks.md b/docs/pt/docs/advanced/openapi-webhooks.md
index 2ccd0e819..5a0226c74 100644
--- a/docs/pt/docs/advanced/openapi-webhooks.md
+++ b/docs/pt/docs/advanced/openapi-webhooks.md
@@ -33,7 +33,7 @@ Webhooks estão disponíveis a partir do OpenAPI 3.1.0, e possui suporte do Fast
Quando você cria uma aplicação com o **FastAPI**, existe um atributo chamado `webhooks`, que você utilizar para defini-los da mesma maneira que você definiria as suas **operações de rotas**, utilizando por exemplo `@app.webhooks.post()`.
```Python hl_lines="9-13 36-53"
-{!../../../docs_src/openapi_webhooks/tutorial001.py!}
+{!../../docs_src/openapi_webhooks/tutorial001.py!}
```
Os webhooks que você define aparecerão no esquema do **OpenAPI** e na **página de documentação** gerada automaticamente.
diff --git a/docs/pt/docs/advanced/response-change-status-code.md b/docs/pt/docs/advanced/response-change-status-code.md
index 99695c831..2ac5eca18 100644
--- a/docs/pt/docs/advanced/response-change-status-code.md
+++ b/docs/pt/docs/advanced/response-change-status-code.md
@@ -21,7 +21,7 @@ Você pode declarar um parâmetro do tipo `Response` em sua *função de operaç
E então você pode definir o `status_code` neste objeto de retorno temporal.
```Python hl_lines="1 9 12"
-{!../../../docs_src/response_change_status_code/tutorial001.py!}
+{!../../docs_src/response_change_status_code/tutorial001.py!}
```
E então você pode retornar qualquer objeto que você precise, como você faria normalmente (um `dict`, um modelo de banco de dados, etc.).
diff --git a/docs/pt/docs/advanced/response-directly.md b/docs/pt/docs/advanced/response-directly.md
index fc571d39b..fd2a0eef1 100644
--- a/docs/pt/docs/advanced/response-directly.md
+++ b/docs/pt/docs/advanced/response-directly.md
@@ -35,7 +35,7 @@ Por exemplo, você não pode colocar um modelo do Pydantic em uma `JSONResponse`
Para esses casos, você pode usar o `jsonable_encoder` para converter seus dados antes de repassá-los para a resposta:
```Python hl_lines="6-7 21-22"
-{!../../../docs_src/response_directly/tutorial001.py!}
+{!../../docs_src/response_directly/tutorial001.py!}
```
/// note | Detalhes Técnicos
@@ -57,7 +57,7 @@ Vamos dizer quer retornar uma resposta <a href="https://pt.wikipedia.org/wiki/XM
Você pode colocar o seu conteúdo XML em uma string, colocar em uma `Response`, e retorná-lo:
```Python hl_lines="1 18"
-{!../../../docs_src/response_directly/tutorial002.py!}
+{!../../docs_src/response_directly/tutorial002.py!}
```
## Notas
diff --git a/docs/pt/docs/advanced/security/http-basic-auth.md b/docs/pt/docs/advanced/security/http-basic-auth.md
index 103d622c7..26983a103 100644
--- a/docs/pt/docs/advanced/security/http-basic-auth.md
+++ b/docs/pt/docs/advanced/security/http-basic-auth.md
@@ -23,7 +23,7 @@ Então, quando você digitar o usuário e senha, o navegador os envia automatica
//// tab | Python 3.9+
```Python hl_lines="4 8 12"
-{!> ../../../docs_src/security/tutorial006_an_py39.py!}
+{!> ../../docs_src/security/tutorial006_an_py39.py!}
```
////
@@ -31,7 +31,7 @@ Então, quando você digitar o usuário e senha, o navegador os envia automatica
//// tab | Python 3.8+
```Python hl_lines="2 7 11"
-{!> ../../../docs_src/security/tutorial006_an.py!}
+{!> ../../docs_src/security/tutorial006_an.py!}
```
////
@@ -45,7 +45,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="2 6 10"
-{!> ../../../docs_src/security/tutorial006.py!}
+{!> ../../docs_src/security/tutorial006.py!}
```
////
@@ -71,7 +71,7 @@ Então nós podemos utilizar o `secrets.compare_digest()` para garantir que o `c
//// tab | Python 3.9+
```Python hl_lines="1 12-24"
-{!> ../../../docs_src/security/tutorial007_an_py39.py!}
+{!> ../../docs_src/security/tutorial007_an_py39.py!}
```
////
@@ -79,7 +79,7 @@ Então nós podemos utilizar o `secrets.compare_digest()` para garantir que o `c
//// tab | Python 3.8+
```Python hl_lines="1 12-24"
-{!> ../../../docs_src/security/tutorial007_an.py!}
+{!> ../../docs_src/security/tutorial007_an.py!}
```
////
@@ -93,7 +93,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="1 11-21"
-{!> ../../../docs_src/security/tutorial007.py!}
+{!> ../../docs_src/security/tutorial007.py!}
```
////
@@ -164,7 +164,7 @@ Após detectar que as credenciais estão incorretas, retorne um `HTTPException`
//// tab | Python 3.9+
```Python hl_lines="26-30"
-{!> ../../../docs_src/security/tutorial007_an_py39.py!}
+{!> ../../docs_src/security/tutorial007_an_py39.py!}
```
////
@@ -172,7 +172,7 @@ Após detectar que as credenciais estão incorretas, retorne um `HTTPException`
//// tab | Python 3.8+
```Python hl_lines="26-30"
-{!> ../../../docs_src/security/tutorial007_an.py!}
+{!> ../../docs_src/security/tutorial007_an.py!}
```
////
@@ -186,7 +186,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="23-27"
-{!> ../../../docs_src/security/tutorial007.py!}
+{!> ../../docs_src/security/tutorial007.py!}
```
////
diff --git a/docs/pt/docs/advanced/security/oauth2-scopes.md b/docs/pt/docs/advanced/security/oauth2-scopes.md
index 4ad7c807e..fa4594c89 100644
--- a/docs/pt/docs/advanced/security/oauth2-scopes.md
+++ b/docs/pt/docs/advanced/security/oauth2-scopes.md
@@ -65,7 +65,7 @@ Primeiro, vamos olhar rapidamente as partes que mudam dos exemplos do **Tutorial
//// tab | Python 3.10+
```Python hl_lines="5 9 13 47 65 106 108-116 122-125 129-135 140 156"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -73,7 +73,7 @@ Primeiro, vamos olhar rapidamente as partes que mudam dos exemplos do **Tutorial
//// tab | Python 3.9+
```Python hl_lines="2 5 9 13 47 65 106 108-116 122-125 129-135 140 156"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -81,7 +81,7 @@ Primeiro, vamos olhar rapidamente as partes que mudam dos exemplos do **Tutorial
//// tab | Python 3.8+
```Python hl_lines="2 5 9 13 48 66 107 109-117 123-126 130-136 141 157"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -95,7 +95,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="4 8 12 46 64 105 107-115 121-124 128-134 139 155"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -109,7 +109,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="2 5 9 13 47 65 106 108-116 122-125 129-135 140 156"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -123,7 +123,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="2 5 9 13 47 65 106 108-116 122-125 129-135 140 156"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -139,7 +139,7 @@ O parâmetro `scopes` recebe um `dict` contendo cada escopo como chave e a descr
//// tab | Python 3.10+
```Python hl_lines="63-66"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -147,7 +147,7 @@ O parâmetro `scopes` recebe um `dict` contendo cada escopo como chave e a descr
//// tab | Python 3.9+
```Python hl_lines="63-66"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -155,7 +155,7 @@ O parâmetro `scopes` recebe um `dict` contendo cada escopo como chave e a descr
//// tab | Python 3.8+
```Python hl_lines="64-67"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -169,7 +169,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="62-65"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -183,7 +183,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="63-66"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -197,7 +197,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="63-66"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -229,7 +229,7 @@ Porém em sua aplicação, por segurança, você deve garantir que você apenas
//// tab | Python 3.10+
```Python hl_lines="156"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -237,7 +237,7 @@ Porém em sua aplicação, por segurança, você deve garantir que você apenas
//// tab | Python 3.9+
```Python hl_lines="156"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -245,7 +245,7 @@ Porém em sua aplicação, por segurança, você deve garantir que você apenas
//// tab | Python 3.8+
```Python hl_lines="157"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -259,7 +259,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="155"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -273,7 +273,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="156"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -287,7 +287,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="156"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -319,7 +319,7 @@ Nós estamos fazendo isso aqui para demonstrar como o **FastAPI** lida com escop
//// tab | Python 3.10+
```Python hl_lines="5 140 171"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -327,7 +327,7 @@ Nós estamos fazendo isso aqui para demonstrar como o **FastAPI** lida com escop
//// tab | Python 3.9+
```Python hl_lines="5 140 171"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -335,7 +335,7 @@ Nós estamos fazendo isso aqui para demonstrar como o **FastAPI** lida com escop
//// tab | Python 3.8+
```Python hl_lines="5 141 172"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -349,7 +349,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="4 139 168"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -363,7 +363,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="5 140 169"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -377,7 +377,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="5 140 169"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -409,7 +409,7 @@ A classe `SecurityScopes` é semelhante à classe `Request` (`Request` foi utili
//// tab | Python 3.10+
```Python hl_lines="9 106"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -417,7 +417,7 @@ A classe `SecurityScopes` é semelhante à classe `Request` (`Request` foi utili
//// tab | Python 3.9+
```Python hl_lines="9 106"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -425,7 +425,7 @@ A classe `SecurityScopes` é semelhante à classe `Request` (`Request` foi utili
//// tab | Python 3.8+
```Python hl_lines="9 107"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -439,7 +439,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="8 105"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -453,7 +453,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="9 106"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -467,7 +467,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="9 106"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -487,7 +487,7 @@ Nesta exceção, nós incluímos os escopos necessários (se houver algum) como
//// tab | Python 3.10+
```Python hl_lines="106 108-116"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -495,7 +495,7 @@ Nesta exceção, nós incluímos os escopos necessários (se houver algum) como
//// tab | Python 3.9+
```Python hl_lines="106 108-116"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -503,7 +503,7 @@ Nesta exceção, nós incluímos os escopos necessários (se houver algum) como
//// tab | Python 3.8+
```Python hl_lines="107 109-117"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -517,7 +517,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="105 107-115"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -531,7 +531,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="106 108-116"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -545,7 +545,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="106 108-116"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -567,7 +567,7 @@ Nós também verificamos que nós temos um usuário com o "*username*", e caso c
//// tab | Python 3.10+
```Python hl_lines="47 117-128"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -575,7 +575,7 @@ Nós também verificamos que nós temos um usuário com o "*username*", e caso c
//// tab | Python 3.9+
```Python hl_lines="47 117-128"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -583,7 +583,7 @@ Nós também verificamos que nós temos um usuário com o "*username*", e caso c
//// tab | Python 3.8+
```Python hl_lines="48 118-129"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -597,7 +597,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="46 116-127"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -611,7 +611,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="47 117-128"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -625,7 +625,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="47 117-128"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
@@ -639,7 +639,7 @@ Para isso, nós utilizamos `security_scopes.scopes`, que contém uma `list` com
//// tab | Python 3.10+
```Python hl_lines="129-135"
-{!> ../../../docs_src/security/tutorial005_an_py310.py!}
+{!> ../../docs_src/security/tutorial005_an_py310.py!}
```
////
@@ -647,7 +647,7 @@ Para isso, nós utilizamos `security_scopes.scopes`, que contém uma `list` com
//// tab | Python 3.9+
```Python hl_lines="129-135"
-{!> ../../../docs_src/security/tutorial005_an_py39.py!}
+{!> ../../docs_src/security/tutorial005_an_py39.py!}
```
////
@@ -655,7 +655,7 @@ Para isso, nós utilizamos `security_scopes.scopes`, que contém uma `list` com
//// tab | Python 3.8+
```Python hl_lines="130-136"
-{!> ../../../docs_src/security/tutorial005_an.py!}
+{!> ../../docs_src/security/tutorial005_an.py!}
```
////
@@ -669,7 +669,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="128-134"
-{!> ../../../docs_src/security/tutorial005_py310.py!}
+{!> ../../docs_src/security/tutorial005_py310.py!}
```
////
@@ -683,7 +683,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="129-135"
-{!> ../../../docs_src/security/tutorial005_py39.py!}
+{!> ../../docs_src/security/tutorial005_py39.py!}
```
////
@@ -697,7 +697,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="129-135"
-{!> ../../../docs_src/security/tutorial005.py!}
+{!> ../../docs_src/security/tutorial005.py!}
```
////
diff --git a/docs/pt/docs/advanced/settings.md b/docs/pt/docs/advanced/settings.md
index db2b4c9cc..d32b70ed4 100644
--- a/docs/pt/docs/advanced/settings.md
+++ b/docs/pt/docs/advanced/settings.md
@@ -181,7 +181,7 @@ Você pode utilizar todas as ferramentas e funcionalidades de validação que s
//// tab | Pydantic v2
```Python hl_lines="2 5-8 11"
-{!> ../../../docs_src/settings/tutorial001.py!}
+{!> ../../docs_src/settings/tutorial001.py!}
```
////
@@ -195,7 +195,7 @@ Na versão 1 do Pydantic você importaria `BaseSettings` diretamente do módulo
///
```Python hl_lines="2 5-8 11"
-{!> ../../../docs_src/settings/tutorial001_pv1.py!}
+{!> ../../docs_src/settings/tutorial001_pv1.py!}
```
////
@@ -215,7 +215,7 @@ Depois ele irá converter e validar os dados. Assim, quando você utilizar aquel
Depois, Você pode utilizar o novo objeto `settings` na sua aplicação:
```Python hl_lines="18-20"
-{!../../../docs_src/settings/tutorial001.py!}
+{!../../docs_src/settings/tutorial001.py!}
```
### Executando o servidor
@@ -251,13 +251,13 @@ Você também pode incluir essas configurações em um arquivo de um módulo sep
Por exemplo, você pode adicionar um arquivo `config.py` com:
```Python
-{!../../../docs_src/settings/app01/config.py!}
+{!../../docs_src/settings/app01/config.py!}
```
E utilizar essa configuração em `main.py`:
```Python hl_lines="3 11-13"
-{!../../../docs_src/settings/app01/main.py!}
+{!../../docs_src/settings/app01/main.py!}
```
/// dica
@@ -277,7 +277,7 @@ Isso é especialmente útil durante os testes, já que é bastante simples sobre
Baseando-se no exemplo anterior, seu arquivo `config.py` seria parecido com isso:
```Python hl_lines="10"
-{!../../../docs_src/settings/app02/config.py!}
+{!../../docs_src/settings/app02/config.py!}
```
Perceba que dessa vez não criamos uma instância padrão `settings = Settings()`.
@@ -289,7 +289,7 @@ Agora criamos a dependência que retorna um novo objeto `config.Settings()`.
//// tab | Python 3.9+
```Python hl_lines="6 12-13"
-{!> ../../../docs_src/settings/app02_an_py39/main.py!}
+{!> ../../docs_src/settings/app02_an_py39/main.py!}
```
////
@@ -297,7 +297,7 @@ Agora criamos a dependência que retorna um novo objeto `config.Settings()`.
//// tab | Python 3.8+
```Python hl_lines="6 12-13"
-{!> ../../../docs_src/settings/app02_an/main.py!}
+{!> ../../docs_src/settings/app02_an/main.py!}
```
////
@@ -311,7 +311,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="5 11-12"
-{!> ../../../docs_src/settings/app02/main.py!}
+{!> ../../docs_src/settings/app02/main.py!}
```
////
@@ -329,7 +329,7 @@ E então podemos declarar essas configurações como uma dependência na funçã
//// tab | Python 3.9+
```Python hl_lines="17 19-21"
-{!> ../../../docs_src/settings/app02_an_py39/main.py!}
+{!> ../../docs_src/settings/app02_an_py39/main.py!}
```
////
@@ -337,7 +337,7 @@ E então podemos declarar essas configurações como uma dependência na funçã
//// tab | Python 3.8+
```Python hl_lines="17 19-21"
-{!> ../../../docs_src/settings/app02_an/main.py!}
+{!> ../../docs_src/settings/app02_an/main.py!}
```
////
@@ -351,7 +351,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="16 18-20"
-{!> ../../../docs_src/settings/app02/main.py!}
+{!> ../../docs_src/settings/app02/main.py!}
```
////
@@ -361,7 +361,7 @@ Utilize a versão com `Annotated` se possível.
Então seria muito fácil fornecer uma configuração diferente durante a execução dos testes sobrescrevendo a dependência de `get_settings`:
```Python hl_lines="9-10 13 21"
-{!../../../docs_src/settings/app02/test_main.py!}
+{!../../docs_src/settings/app02/test_main.py!}
```
Na sobrescrita da dependência, definimos um novo valor para `admin_email` quando instanciamos um novo objeto `Settings`, e então retornamos esse novo objeto.
@@ -406,7 +406,7 @@ E então adicionar o seguinte código em `config.py`:
//// tab | Pydantic v2
```Python hl_lines="9"
-{!> ../../../docs_src/settings/app03_an/config.py!}
+{!> ../../docs_src/settings/app03_an/config.py!}
```
/// dica
@@ -420,7 +420,7 @@ O atributo `model_config` é usado apenas para configuração do Pydantic. Você
//// tab | Pydantic v1
```Python hl_lines="9-10"
-{!> ../../../docs_src/settings/app03_an/config_pv1.py!}
+{!> ../../docs_src/settings/app03_an/config_pv1.py!}
```
/// dica
@@ -465,7 +465,7 @@ Mas como estamos utilizando o decorador `@lru_cache` acima, o objeto `Settings`
//// tab | Python 3.9+
```Python hl_lines="1 11"
-{!> ../../../docs_src/settings/app03_an_py39/main.py!}
+{!> ../../docs_src/settings/app03_an_py39/main.py!}
```
////
@@ -473,7 +473,7 @@ Mas como estamos utilizando o decorador `@lru_cache` acima, o objeto `Settings`
//// tab | Python 3.8+
```Python hl_lines="1 11"
-{!> ../../../docs_src/settings/app03_an/main.py!}
+{!> ../../docs_src/settings/app03_an/main.py!}
```
////
@@ -487,7 +487,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="1 10"
-{!> ../../../docs_src/settings/app03/main.py!}
+{!> ../../docs_src/settings/app03/main.py!}
```
////
diff --git a/docs/pt/docs/advanced/sub-applications.md b/docs/pt/docs/advanced/sub-applications.md
index 8149edc5a..7f0381cc2 100644
--- a/docs/pt/docs/advanced/sub-applications.md
+++ b/docs/pt/docs/advanced/sub-applications.md
@@ -11,7 +11,7 @@ Se você precisar ter duas aplicações FastAPI independentes, cada uma com seu
Primeiro, crie a aplicação principal, de nível superior, **FastAPI**, e suas *operações de rota*:
```Python hl_lines="3 6-8"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### Sub-aplicação
@@ -21,7 +21,7 @@ Em seguida, crie sua sub-aplicação e suas *operações de rota*.
Essa sub-aplicação é apenas outra aplicação FastAPI padrão, mas esta é a que será "montada":
```Python hl_lines="11 14-16"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### Monte a sub-aplicação
@@ -31,7 +31,7 @@ Na sua aplicação de nível superior, `app`, monte a sub-aplicação, `subapi`.
Neste caso, ela será montada no caminho `/subapi`:
```Python hl_lines="11 19"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### Verifique a documentação automática da API
diff --git a/docs/pt/docs/advanced/templates.md b/docs/pt/docs/advanced/templates.md
index 6d231b3c2..88a5b940e 100644
--- a/docs/pt/docs/advanced/templates.md
+++ b/docs/pt/docs/advanced/templates.md
@@ -26,7 +26,7 @@ $ pip install jinja2
* Use o `template` que você criou para renderizar e retornar uma `TemplateResponse`, passe o nome do template, o request object, e um "context" dict com pares chave-valor a serem usados dentro do template do Jinja2.
```Python hl_lines="4 11 15-18"
-{!../../../docs_src/templates/tutorial001.py!}
+{!../../docs_src/templates/tutorial001.py!}
```
/// note
@@ -56,7 +56,7 @@ Você também poderia usar `from starlette.templating import Jinja2Templates`.
Então você pode escrever um template em `templates/item.html`, por exemplo:
```jinja hl_lines="7"
-{!../../../docs_src/templates/templates/item.html!}
+{!../../docs_src/templates/templates/item.html!}
```
### Interpolação de Valores no Template
@@ -110,13 +110,13 @@ Por exemplo, com um ID de `42`, isso renderizará:
Você também pode usar `url_for()` dentro do template e usá-lo, por examplo, com o `StaticFiles` que você montou com o `name="static"`.
```jinja hl_lines="4"
-{!../../../docs_src/templates/templates/item.html!}
+{!../../docs_src/templates/templates/item.html!}
```
Neste exemplo, ele seria vinculado a um arquivo CSS em `static/styles.css` com:
```CSS hl_lines="4"
-{!../../../docs_src/templates/static/styles.css!}
+{!../../docs_src/templates/static/styles.css!}
```
E como você está usando `StaticFiles`, este arquivo CSS será automaticamente servido pela sua aplicação FastAPI na URL `/static/styles.css`.
diff --git a/docs/pt/docs/advanced/testing-dependencies.md b/docs/pt/docs/advanced/testing-dependencies.md
index 747dd7d06..f978350a5 100644
--- a/docs/pt/docs/advanced/testing-dependencies.md
+++ b/docs/pt/docs/advanced/testing-dependencies.md
@@ -31,7 +31,7 @@ E então o **FastAPI** chamará a sobreposição no lugar da dependência origin
//// tab | Python 3.10+
```Python hl_lines="26-27 30"
-{!> ../../../docs_src/dependency_testing/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependency_testing/tutorial001_an_py310.py!}
```
////
@@ -39,7 +39,7 @@ E então o **FastAPI** chamará a sobreposição no lugar da dependência origin
//// tab | Python 3.9+
```Python hl_lines="28-29 32"
-{!> ../../../docs_src/dependency_testing/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependency_testing/tutorial001_an_py39.py!}
```
////
@@ -47,7 +47,7 @@ E então o **FastAPI** chamará a sobreposição no lugar da dependência origin
//// tab | Python 3.8+
```Python hl_lines="29-30 33"
-{!> ../../../docs_src/dependency_testing/tutorial001_an.py!}
+{!> ../../docs_src/dependency_testing/tutorial001_an.py!}
```
////
@@ -61,7 +61,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="24-25 28"
-{!> ../../../docs_src/dependency_testing/tutorial001_py310.py!}
+{!> ../../docs_src/dependency_testing/tutorial001_py310.py!}
```
////
@@ -75,7 +75,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="28-29 32"
-{!> ../../../docs_src/dependency_testing/tutorial001.py!}
+{!> ../../docs_src/dependency_testing/tutorial001.py!}
```
////
diff --git a/docs/pt/docs/advanced/testing-events.md b/docs/pt/docs/advanced/testing-events.md
index 392fb741c..b6796e835 100644
--- a/docs/pt/docs/advanced/testing-events.md
+++ b/docs/pt/docs/advanced/testing-events.md
@@ -3,5 +3,5 @@
Quando você precisa que os seus manipuladores de eventos (`startup` e `shutdown`) sejam executados em seus testes, você pode utilizar o `TestClient` usando a instrução `with`:
```Python hl_lines="9-12 20-24"
-{!../../../docs_src/app_testing/tutorial003.py!}
+{!../../docs_src/app_testing/tutorial003.py!}
```
diff --git a/docs/pt/docs/advanced/testing-websockets.md b/docs/pt/docs/advanced/testing-websockets.md
index f458a05d4..daa610df6 100644
--- a/docs/pt/docs/advanced/testing-websockets.md
+++ b/docs/pt/docs/advanced/testing-websockets.md
@@ -5,7 +5,7 @@ Você pode usar o mesmo `TestClient` para testar WebSockets.
Para isso, você utiliza o `TestClient` dentro de uma instrução `with`, conectando com o WebSocket:
```Python hl_lines="27-31"
-{!../../../docs_src/app_testing/tutorial002.py!}
+{!../../docs_src/app_testing/tutorial002.py!}
```
/// note | "Nota"
diff --git a/docs/pt/docs/advanced/using-request-directly.md b/docs/pt/docs/advanced/using-request-directly.md
index 3dd0a8aef..c2114c214 100644
--- a/docs/pt/docs/advanced/using-request-directly.md
+++ b/docs/pt/docs/advanced/using-request-directly.md
@@ -30,7 +30,7 @@ Vamos imaginar que você deseja obter o endereço de IP/host do cliente dentro d
Para isso você precisa acessar a requisição diretamente.
```Python hl_lines="1 7-8"
-{!../../../docs_src/using_request_directly/tutorial001.py!}
+{!../../docs_src/using_request_directly/tutorial001.py!}
```
Ao declarar o parâmetro com o tipo sendo um `Request` em sua *função de operação de rota*, o **FastAPI** saberá como passar o `Request` neste parâmetro.
diff --git a/docs/pt/docs/advanced/wsgi.md b/docs/pt/docs/advanced/wsgi.md
index 2c7ac1ffe..e6d08c8db 100644
--- a/docs/pt/docs/advanced/wsgi.md
+++ b/docs/pt/docs/advanced/wsgi.md
@@ -13,7 +13,7 @@ Em seguinda, encapsular a aplicação WSGI (e.g. Flask) com o middleware.
E então **"montar"** em um caminho de rota.
```Python hl_lines="2-3 23"
-{!../../../docs_src/wsgi/tutorial001.py!}
+{!../../docs_src/wsgi/tutorial001.py!}
```
## Conferindo
diff --git a/docs/pt/docs/how-to/conditional-openapi.md b/docs/pt/docs/how-to/conditional-openapi.md
index cfa652fa5..675b812e6 100644
--- a/docs/pt/docs/how-to/conditional-openapi.md
+++ b/docs/pt/docs/how-to/conditional-openapi.md
@@ -30,7 +30,7 @@ Você pode usar facilmente as mesmas configurações do Pydantic para configurar
Por exemplo:
```Python hl_lines="6 11"
-{!../../../docs_src/conditional_openapi/tutorial001.py!}
+{!../../docs_src/conditional_openapi/tutorial001.py!}
```
Aqui declaramos a configuração `openapi_url` com o mesmo padrão de `"/openapi.json"`.
diff --git a/docs/pt/docs/how-to/configure-swagger-ui.md b/docs/pt/docs/how-to/configure-swagger-ui.md
index ceb8c634e..58bb1557c 100644
--- a/docs/pt/docs/how-to/configure-swagger-ui.md
+++ b/docs/pt/docs/how-to/configure-swagger-ui.md
@@ -19,7 +19,7 @@ Sem alterar as configurações, o destaque de sintaxe é habilitado por padrão:
Mas você pode desabilitá-lo definindo `syntaxHighlight` como `False`:
```Python hl_lines="3"
-{!../../../docs_src/configure_swagger_ui/tutorial001.py!}
+{!../../docs_src/configure_swagger_ui/tutorial001.py!}
```
...e então o Swagger UI não mostrará mais o destaque de sintaxe:
@@ -31,7 +31,7 @@ Mas você pode desabilitá-lo definindo `syntaxHighlight` como `False`:
Da mesma forma que você pode definir o tema de destaque de sintaxe com a chave `"syntaxHighlight.theme"` (observe que há um ponto no meio):
```Python hl_lines="3"
-{!../../../docs_src/configure_swagger_ui/tutorial002.py!}
+{!../../docs_src/configure_swagger_ui/tutorial002.py!}
```
Essa configuração alteraria o tema de cores de destaque de sintaxe:
@@ -45,7 +45,7 @@ O FastAPI inclui alguns parâmetros de configuração padrão apropriados para a
Inclui estas configurações padrão:
```Python
-{!../../../fastapi/openapi/docs.py[ln:7-23]!}
+{!../../fastapi/openapi/docs.py[ln:7-23]!}
```
Você pode substituir qualquer um deles definindo um valor diferente no argumento `swagger_ui_parameters`.
@@ -53,7 +53,7 @@ Você pode substituir qualquer um deles definindo um valor diferente no argument
Por exemplo, para desabilitar `deepLinking` você pode passar essas configurações para `swagger_ui_parameters`:
```Python hl_lines="3"
-{!../../../docs_src/configure_swagger_ui/tutorial003.py!}
+{!../../docs_src/configure_swagger_ui/tutorial003.py!}
```
## Outros parâmetros da UI do Swagger
diff --git a/docs/pt/docs/how-to/graphql.md b/docs/pt/docs/how-to/graphql.md
index 0b711aa5e..2cfd790c5 100644
--- a/docs/pt/docs/how-to/graphql.md
+++ b/docs/pt/docs/how-to/graphql.md
@@ -36,7 +36,7 @@ Dependendo do seu caso de uso, você pode preferir usar uma biblioteca diferente
Aqui está uma pequena prévia de como você poderia integrar Strawberry com FastAPI:
```Python hl_lines="3 22 25-26"
-{!../../../docs_src/graphql/tutorial001.py!}
+{!../../docs_src/graphql/tutorial001.py!}
```
Você pode aprender mais sobre Strawberry na <a href="https://strawberry.rocks/" class="external-link" target="_blank">documentação do Strawberry</a>.
diff --git a/docs/pt/docs/python-types.md b/docs/pt/docs/python-types.md
index 86630cd2a..05faa860c 100644
--- a/docs/pt/docs/python-types.md
+++ b/docs/pt/docs/python-types.md
@@ -23,7 +23,7 @@ Se você é um especialista em Python e já sabe tudo sobre type hints, pule par
Vamos começar com um exemplo simples:
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
A chamada deste programa gera:
@@ -39,7 +39,7 @@ A função faz o seguinte:
* <abbr title = "Agrupa-os, como um. Com o conteúdo de um após o outro."> Concatena </abbr> com um espaço no meio.
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### Edite-o
@@ -83,7 +83,7 @@ para:
Esses são os "type hints":
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
Isso não é o mesmo que declarar valores padrão como seria com:
@@ -113,7 +113,7 @@ Com isso, você pode rolar, vendo as opções, até encontrar o que "toca uma ca
Marque esta função, ela já possui type hints:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
Como o editor conhece os tipos de variáveis, você não apenas obtém a conclusão, mas também as verificações de erro:
@@ -123,7 +123,7 @@ Como o editor conhece os tipos de variáveis, você não apenas obtém a conclus
Agora você sabe que precisa corrigí-lo, converta `age` em uma string com `str (age)`:
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## Tipos de declaração
@@ -144,7 +144,7 @@ Você pode usar, por exemplo:
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### Tipos genéricos com parâmetros de tipo
@@ -162,7 +162,7 @@ Por exemplo, vamos definir uma variável para ser uma `lista` de `str`.
Em `typing`, importe `List` (com um `L` maiúsculo):
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
Declare a variável com a mesma sintaxe de dois pontos (`:`).
@@ -172,7 +172,7 @@ Como o tipo, coloque a `List`.
Como a lista é um tipo que contém alguns tipos internos, você os coloca entre colchetes:
```Python hl_lines="4"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
/// tip | "Dica"
@@ -200,7 +200,7 @@ E, ainda assim, o editor sabe que é um `str` e fornece suporte para isso.
Você faria o mesmo para declarar `tuple`s e `set`s:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial007.py!}
+{!../../docs_src/python_types/tutorial007.py!}
```
Isso significa que:
@@ -217,7 +217,7 @@ O primeiro parâmetro de tipo é para as chaves do `dict`.
O segundo parâmetro de tipo é para os valores do `dict`:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial008.py!}
+{!../../docs_src/python_types/tutorial008.py!}
```
Isso significa que:
@@ -231,7 +231,7 @@ Isso significa que:
Você também pode usar o `Opcional` para declarar que uma variável tem um tipo, como `str`, mas que é "opcional", o que significa que também pode ser `None`:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
O uso de `Opcional [str]` em vez de apenas `str` permitirá que o editor o ajude a detectar erros, onde você pode estar assumindo que um valor é sempre um `str`, quando na verdade também pode ser `None`.
@@ -256,13 +256,13 @@ Você também pode declarar uma classe como o tipo de uma variável.
Digamos que você tenha uma classe `Person`, com um nome:
```Python hl_lines="1 2 3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Então você pode declarar que uma variável é do tipo `Person`:
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
E então, novamente, você recebe todo o suporte do editor:
@@ -284,7 +284,7 @@ E você recebe todo o suporte do editor com esse objeto resultante.
Retirado dos documentos oficiais dos Pydantic:
```Python
-{!../../../docs_src/python_types/tutorial011.py!}
+{!../../docs_src/python_types/tutorial011.py!}
```
/// info | "Informação"
diff --git a/docs/pt/docs/tutorial/background-tasks.md b/docs/pt/docs/tutorial/background-tasks.md
index 625fa2b11..2b5f82464 100644
--- a/docs/pt/docs/tutorial/background-tasks.md
+++ b/docs/pt/docs/tutorial/background-tasks.md
@@ -16,7 +16,7 @@ Isso inclui, por exemplo:
Primeiro, importe `BackgroundTasks` e defina um parâmetro em sua _função de operação de caminho_ com uma declaração de tipo de `BackgroundTasks`:
```Python hl_lines="1 13"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
O **FastAPI** criará o objeto do tipo `BackgroundTasks` para você e o passará como esse parâmetro.
@@ -34,7 +34,7 @@ Nesse caso, a função de tarefa gravará em um arquivo (simulando o envio de um
E como a operação de gravação não usa `async` e `await`, definimos a função com `def` normal:
```Python hl_lines="6-9"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
## Adicionar a tarefa em segundo plano
@@ -42,7 +42,7 @@ E como a operação de gravação não usa `async` e `await`, definimos a funç
Dentro de sua _função de operação de caminho_, passe sua função de tarefa para o objeto _tarefas em segundo plano_ com o método `.add_task()`:
```Python hl_lines="14"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
`.add_task()` recebe como argumentos:
@@ -58,7 +58,7 @@ Usar `BackgroundTasks` também funciona com o sistema de injeção de dependênc
O **FastAPI** sabe o que fazer em cada caso e como reutilizar o mesmo objeto, de forma que todas as tarefas em segundo plano sejam mescladas e executadas em segundo plano posteriormente:
```Python hl_lines="13 15 22 25"
-{!../../../docs_src/background_tasks/tutorial002.py!}
+{!../../docs_src/background_tasks/tutorial002.py!}
```
Neste exemplo, as mensagens serão gravadas no arquivo `log.txt` _após_ o envio da resposta.
diff --git a/docs/pt/docs/tutorial/bigger-applications.md b/docs/pt/docs/tutorial/bigger-applications.md
index 7137bf865..fcc30961f 100644
--- a/docs/pt/docs/tutorial/bigger-applications.md
+++ b/docs/pt/docs/tutorial/bigger-applications.md
@@ -86,7 +86,7 @@ Você pode criar as *operações de rotas* para esse módulo usando o `APIRouter
você o importa e cria uma "instância" da mesma maneira que faria com a classe `FastAPI`:
```Python hl_lines="1 3" title="app/routers/users.py"
-{!../../../docs_src/bigger_applications/app/routers/users.py!}
+{!../../docs_src/bigger_applications/app/routers/users.py!}
```
### *Operações de Rota* com `APIRouter`
@@ -96,7 +96,7 @@ E então você o utiliza para declarar suas *operações de rota*.
Utilize-o da mesma maneira que utilizaria a classe `FastAPI`:
```Python hl_lines="6 11 16" title="app/routers/users.py"
-{!../../../docs_src/bigger_applications/app/routers/users.py!}
+{!../../docs_src/bigger_applications/app/routers/users.py!}
```
Você pode pensar em `APIRouter` como uma classe "mini `FastAPI`".
@@ -124,7 +124,7 @@ Agora usaremos uma dependência simples para ler um cabeçalho `X-Token` persona
//// tab | Python 3.9+
```Python hl_lines="3 6-8" title="app/dependencies.py"
-{!> ../../../docs_src/bigger_applications/app_an_py39/dependencies.py!}
+{!> ../../docs_src/bigger_applications/app_an_py39/dependencies.py!}
```
////
@@ -132,7 +132,7 @@ Agora usaremos uma dependência simples para ler um cabeçalho `X-Token` persona
//// tab | Python 3.8+
```Python hl_lines="1 5-7" title="app/dependencies.py"
-{!> ../../../docs_src/bigger_applications/app_an/dependencies.py!}
+{!> ../../docs_src/bigger_applications/app_an/dependencies.py!}
```
////
@@ -146,7 +146,7 @@ Prefira usar a versão `Annotated` se possível.
///
```Python hl_lines="1 4-6" title="app/dependencies.py"
-{!> ../../../docs_src/bigger_applications/app/dependencies.py!}
+{!> ../../docs_src/bigger_applications/app/dependencies.py!}
```
////
@@ -182,7 +182,7 @@ Sabemos que todas as *operações de rota* neste módulo têm o mesmo:
Então, em vez de adicionar tudo isso a cada *operação de rota*, podemos adicioná-lo ao `APIRouter`.
```Python hl_lines="5-10 16 21" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
Como o caminho de cada *operação de rota* deve começar com `/`, como em:
@@ -243,7 +243,7 @@ E precisamos obter a função de dependência do módulo `app.dependencies`, o a
Então usamos uma importação relativa com `..` para as dependências:
```Python hl_lines="3" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
#### Como funcionam as importações relativas
@@ -316,7 +316,7 @@ Não estamos adicionando o prefixo `/items` nem `tags=["items"]` a cada *operaç
Mas ainda podemos adicionar _mais_ `tags` que serão aplicadas a uma *operação de rota* específica, e também algumas `respostas` extras específicas para essa *operação de rota*:
```Python hl_lines="30-31" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
/// tip | "Dica"
@@ -344,7 +344,7 @@ Você importa e cria uma classe `FastAPI` normalmente.
E podemos até declarar [dependências globais](dependencies/global-dependencies.md){.internal-link target=_blank} que serão combinadas com as dependências para cada `APIRouter`:
```Python hl_lines="1 3 7" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
### Importe o `APIRouter`
@@ -352,7 +352,7 @@ E podemos até declarar [dependências globais](dependencies/global-dependencies
Agora importamos os outros submódulos que possuem `APIRouter`s:
```Python hl_lines="4-5" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
Como os arquivos `app/routers/users.py` e `app/routers/items.py` são submódulos que fazem parte do mesmo pacote Python `app`, podemos usar um único ponto `.` para importá-los usando "importações relativas".
@@ -417,7 +417,7 @@ o `router` de `users` sobrescreveria o de `items` e não poderíamos usá-los ao
Então, para poder usar ambos no mesmo arquivo, importamos os submódulos diretamente:
```Python hl_lines="5" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
### Incluir o `APIRouter`s para `usuários` e `itens`
@@ -425,7 +425,7 @@ Então, para poder usar ambos no mesmo arquivo, importamos os submódulos direta
Agora, vamos incluir os `roteadores` dos submódulos `usuários` e `itens`:
```Python hl_lines="10-11" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
/// info | "Informação"
@@ -467,7 +467,7 @@ Ele contém um `APIRouter` com algumas *operações de rota* de administração
Para este exemplo, será super simples. Mas digamos que, como ele é compartilhado com outros projetos na organização, não podemos modificá-lo e adicionar um `prefix`, `dependencies`, `tags`, etc. diretamente ao `APIRouter`:
```Python hl_lines="3" title="app/internal/admin.py"
-{!../../../docs_src/bigger_applications/app/internal/admin.py!}
+{!../../docs_src/bigger_applications/app/internal/admin.py!}
```
Mas ainda queremos definir um `prefixo` personalizado ao incluir o `APIRouter` para que todas as suas *operações de rota* comecem com `/admin`, queremos protegê-lo com as `dependências` que já temos para este projeto e queremos incluir `tags` e `responses`.
@@ -475,7 +475,7 @@ Mas ainda queremos definir um `prefixo` personalizado ao incluir o `APIRouter` p
Podemos declarar tudo isso sem precisar modificar o `APIRouter` original passando esses parâmetros para `app.include_router()`:
```Python hl_lines="14-17" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
Dessa forma, o `APIRouter` original permanecerá inalterado, para que possamos compartilhar o mesmo arquivo `app/internal/admin.py` com outros projetos na organização.
@@ -498,7 +498,7 @@ Também podemos adicionar *operações de rota* diretamente ao aplicativo `FastA
Aqui fazemos isso... só para mostrar que podemos 🤷:
```Python hl_lines="21-23" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
e funcionará corretamente, junto com todas as outras *operações de rota* adicionadas com `app.include_router()`.
diff --git a/docs/pt/docs/tutorial/body-fields.md b/docs/pt/docs/tutorial/body-fields.md
index cce37cd55..ab9377fdb 100644
--- a/docs/pt/docs/tutorial/body-fields.md
+++ b/docs/pt/docs/tutorial/body-fields.md
@@ -7,7 +7,7 @@ Da mesma forma que você pode declarar validações adicionais e metadados nos p
Primeiro, você tem que importá-lo:
```Python hl_lines="4"
-{!../../../docs_src/body_fields/tutorial001.py!}
+{!../../docs_src/body_fields/tutorial001.py!}
```
/// warning | "Aviso"
@@ -21,7 +21,7 @@ Note que `Field` é importado diretamente do `pydantic`, não do `fastapi` como
Você pode então utilizar `Field` com atributos do modelo:
```Python hl_lines="11-14"
-{!../../../docs_src/body_fields/tutorial001.py!}
+{!../../docs_src/body_fields/tutorial001.py!}
```
`Field` funciona da mesma forma que `Query`, `Path` e `Body`, ele possui todos os mesmos parâmetros, etc.
diff --git a/docs/pt/docs/tutorial/body-multiple-params.md b/docs/pt/docs/tutorial/body-multiple-params.md
index d36dd60b3..400813a7b 100644
--- a/docs/pt/docs/tutorial/body-multiple-params.md
+++ b/docs/pt/docs/tutorial/body-multiple-params.md
@@ -11,7 +11,7 @@ E você também pode declarar parâmetros de corpo como opcionais, definindo o v
//// tab | Python 3.10+
```Python hl_lines="17-19"
-{!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_py310.py!}
```
////
@@ -19,7 +19,7 @@ E você também pode declarar parâmetros de corpo como opcionais, definindo o v
//// tab | Python 3.8+
```Python hl_lines="19-21"
-{!> ../../../docs_src/body_multiple_params/tutorial001.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001.py!}
```
////
@@ -48,7 +48,7 @@ Mas você pode também declarar múltiplos parâmetros de corpo, por exemplo, `i
//// tab | Python 3.10+
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002_py310.py!}
```
////
@@ -56,7 +56,7 @@ Mas você pode também declarar múltiplos parâmetros de corpo, por exemplo, `i
//// tab | Python 3.8+
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial002.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002.py!}
```
////
@@ -103,7 +103,7 @@ Mas você pode instruir o **FastAPI** para tratá-lo como outra chave do corpo u
//// tab | Python 3.8+
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial003.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003.py!}
```
////
@@ -111,7 +111,7 @@ Mas você pode instruir o **FastAPI** para tratá-lo como outra chave do corpo u
//// tab | Python 3.10+
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_py310.py!}
```
////
@@ -157,7 +157,7 @@ Por exemplo:
//// tab | Python 3.10+
```Python hl_lines="26"
-{!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_py310.py!}
```
////
@@ -165,7 +165,7 @@ Por exemplo:
//// tab | Python 3.8+
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004.py!}
```
////
@@ -193,7 +193,7 @@ como em:
//// tab | Python 3.10+
```Python hl_lines="15"
-{!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_py310.py!}
```
////
@@ -201,7 +201,7 @@ como em:
//// tab | Python 3.8+
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005.py!}
```
////
diff --git a/docs/pt/docs/tutorial/body-nested-models.md b/docs/pt/docs/tutorial/body-nested-models.md
index 7d933b27f..3aa79d563 100644
--- a/docs/pt/docs/tutorial/body-nested-models.md
+++ b/docs/pt/docs/tutorial/body-nested-models.md
@@ -7,7 +7,7 @@ Com o **FastAPI**, você pode definir, validar, documentar e usar modelos profun
Você pode definir um atributo como um subtipo. Por exemplo, uma `list` do Python:
```Python hl_lines="14"
-{!../../../docs_src/body_nested_models/tutorial001.py!}
+{!../../docs_src/body_nested_models/tutorial001.py!}
```
Isso fará com que tags seja uma lista de itens mesmo sem declarar o tipo dos elementos desta lista.
@@ -21,7 +21,7 @@ Mas o Python tem uma maneira específica de declarar listas com tipos internos o
Primeiramente, importe `List` do módulo `typing` que já vem por padrão no Python:
```Python hl_lines="1"
-{!../../../docs_src/body_nested_models/tutorial002.py!}
+{!../../docs_src/body_nested_models/tutorial002.py!}
```
### Declare a `List` com um parâmetro de tipo
@@ -45,7 +45,7 @@ Portanto, em nosso exemplo, podemos fazer com que `tags` sejam especificamente u
```Python hl_lines="14"
-{!../../../docs_src/body_nested_models/tutorial002.py!}
+{!../../docs_src/body_nested_models/tutorial002.py!}
```
## Tipo "set"
@@ -59,7 +59,7 @@ Então podemos importar `Set` e declarar `tags` como um `set` de `str`s:
```Python hl_lines="1 14"
-{!../../../docs_src/body_nested_models/tutorial003.py!}
+{!../../docs_src/body_nested_models/tutorial003.py!}
```
Com isso, mesmo que você receba uma requisição contendo dados duplicados, ela será convertida em um conjunto de itens exclusivos.
@@ -83,7 +83,7 @@ Tudo isso, aninhado arbitrariamente.
Por exemplo, nós podemos definir um modelo `Image`:
```Python hl_lines="9-11"
-{!../../../docs_src/body_nested_models/tutorial004.py!}
+{!../../docs_src/body_nested_models/tutorial004.py!}
```
### Use o sub-modelo como um tipo
@@ -91,7 +91,7 @@ Por exemplo, nós podemos definir um modelo `Image`:
E então podemos usa-lo como o tipo de um atributo:
```Python hl_lines="20"
-{!../../../docs_src/body_nested_models/tutorial004.py!}
+{!../../docs_src/body_nested_models/tutorial004.py!}
```
Isso significa que o **FastAPI** vai esperar um corpo similar à:
@@ -126,7 +126,7 @@ Para ver todas as opções possíveis, cheque a documentação para os<a href="h
Por exemplo, no modelo `Image` nós temos um campo `url`, nós podemos declara-lo como um `HttpUrl` do Pydantic invés de como uma `str`:
```Python hl_lines="4 10"
-{!../../../docs_src/body_nested_models/tutorial005.py!}
+{!../../docs_src/body_nested_models/tutorial005.py!}
```
A string será verificada para se tornar uma URL válida e documentada no esquema JSON/1OpenAPI como tal.
@@ -136,7 +136,7 @@ A string será verificada para se tornar uma URL válida e documentada no esquem
Você também pode usar modelos Pydantic como subtipos de `list`, `set`, etc:
```Python hl_lines="20"
-{!../../../docs_src/body_nested_models/tutorial006.py!}
+{!../../docs_src/body_nested_models/tutorial006.py!}
```
Isso vai esperar(converter, validar, documentar, etc) um corpo JSON tal qual:
@@ -176,7 +176,7 @@ Note como o campo `images` agora tem uma lista de objetos de image.
Você pode definir modelos profundamente aninhados de forma arbitrária:
```Python hl_lines="9 14 20 23 27"
-{!../../../docs_src/body_nested_models/tutorial007.py!}
+{!../../docs_src/body_nested_models/tutorial007.py!}
```
/// info | "informação"
@@ -197,7 +197,7 @@ images: List[Image]
como em:
```Python hl_lines="15"
-{!../../../docs_src/body_nested_models/tutorial008.py!}
+{!../../docs_src/body_nested_models/tutorial008.py!}
```
## Suporte de editor em todo canto
@@ -229,7 +229,7 @@ Outro caso útil é quando você deseja ter chaves de outro tipo, por exemplo, `
Neste caso, você aceitaria qualquer `dict`, desde que tenha chaves` int` com valores `float`:
```Python hl_lines="9"
-{!../../../docs_src/body_nested_models/tutorial009.py!}
+{!../../docs_src/body_nested_models/tutorial009.py!}
```
/// tip | "Dica"
diff --git a/docs/pt/docs/tutorial/body.md b/docs/pt/docs/tutorial/body.md
index f67687fb5..429e4fd5a 100644
--- a/docs/pt/docs/tutorial/body.md
+++ b/docs/pt/docs/tutorial/body.md
@@ -23,7 +23,7 @@ Como é desencorajado, a documentação interativa com Swagger UI não irá most
Primeiro, você precisa importar `BaseModel` do `pydantic`:
```Python hl_lines="4"
-{!../../../docs_src/body/tutorial001.py!}
+{!../../docs_src/body/tutorial001.py!}
```
## Crie seu modelo de dados
@@ -33,7 +33,7 @@ Então você declara seu modelo de dados como uma classe que herda `BaseModel`.
Utilize os tipos Python padrão para todos os atributos:
```Python hl_lines="7-11"
-{!../../../docs_src/body/tutorial001.py!}
+{!../../docs_src/body/tutorial001.py!}
```
Assim como quando declaramos parâmetros de consulta, quando um atributo do modelo possui um valor padrão, ele se torna opcional. Caso contrário, se torna obrigatório. Use `None` para torná-lo opcional.
@@ -63,7 +63,7 @@ Por exemplo, o modelo acima declara um JSON "`object`" (ou `dict` no Python) com
Para adicionar o corpo na *função de operação de rota*, declare-o da mesma maneira que você declarou parâmetros de rota e consulta:
```Python hl_lines="18"
-{!../../../docs_src/body/tutorial001.py!}
+{!../../docs_src/body/tutorial001.py!}
```
...E declare o tipo como o modelo que você criou, `Item`.
@@ -132,7 +132,7 @@ Melhora o suporte do editor para seus modelos Pydantic com::
Dentro da função, você pode acessar todos os atributos do objeto do modelo diretamente:
```Python hl_lines="21"
-{!../../../docs_src/body/tutorial002.py!}
+{!../../docs_src/body/tutorial002.py!}
```
## Corpo da requisição + parâmetros de rota
@@ -142,7 +142,7 @@ Você pode declarar parâmetros de rota e corpo da requisição ao mesmo tempo.
O **FastAPI** irá reconhecer que os parâmetros da função que combinam com parâmetros de rota devem ser **retirados da rota**, e parâmetros da função que são declarados como modelos Pydantic sejam **retirados do corpo da requisição**.
```Python hl_lines="17-18"
-{!../../../docs_src/body/tutorial003.py!}
+{!../../docs_src/body/tutorial003.py!}
```
## Corpo da requisição + parâmetros de rota + parâmetros de consulta
@@ -152,7 +152,7 @@ Você também pode declarar parâmetros de **corpo**, **rota** e **consulta**, a
O **FastAPI** irá reconhecer cada um deles e retirar a informação do local correto.
```Python hl_lines="18"
-{!../../../docs_src/body/tutorial004.py!}
+{!../../docs_src/body/tutorial004.py!}
```
Os parâmetros da função serão reconhecidos conforme abaixo:
diff --git a/docs/pt/docs/tutorial/cookie-params.md b/docs/pt/docs/tutorial/cookie-params.md
index bb59dcd2c..50bec8cf7 100644
--- a/docs/pt/docs/tutorial/cookie-params.md
+++ b/docs/pt/docs/tutorial/cookie-params.md
@@ -9,7 +9,7 @@ Primeiro importe `Cookie`:
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ Primeiro importe `Cookie`:
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ Primeiro importe `Cookie`:
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="1"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
@@ -68,7 +68,7 @@ Você pode definir o valor padrão, assim como todas as validações extras ou p
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -76,7 +76,7 @@ Você pode definir o valor padrão, assim como todas as validações extras ou p
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -84,7 +84,7 @@ Você pode definir o valor padrão, assim como todas as validações extras ou p
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -98,7 +98,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="7"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -112,7 +112,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
diff --git a/docs/pt/docs/tutorial/cors.md b/docs/pt/docs/tutorial/cors.md
index e5e2f8c27..16c4e9bf5 100644
--- a/docs/pt/docs/tutorial/cors.md
+++ b/docs/pt/docs/tutorial/cors.md
@@ -47,7 +47,7 @@ Você também pode especificar se o seu backend permite:
* Cabeçalhos HTTP específicos ou todos eles com o curinga `"*"`.
```Python hl_lines="2 6-11 13-19"
-{!../../../docs_src/cors/tutorial001.py!}
+{!../../docs_src/cors/tutorial001.py!}
```
Os parâmetros padrão usados pela implementação `CORSMiddleware` são restritivos por padrão, então você precisará habilitar explicitamente as origens, métodos ou cabeçalhos específicos para que os navegadores tenham permissão para usá-los em um contexto de domínios diferentes.
diff --git a/docs/pt/docs/tutorial/debugging.md b/docs/pt/docs/tutorial/debugging.md
index 54582fcbc..6bac7eb85 100644
--- a/docs/pt/docs/tutorial/debugging.md
+++ b/docs/pt/docs/tutorial/debugging.md
@@ -7,7 +7,7 @@ Você pode conectar o depurador no seu editor, por exemplo, com o Visual Studio
Em seu aplicativo FastAPI, importe e execute `uvicorn` diretamente:
```Python hl_lines="1 15"
-{!../../../docs_src/debugging/tutorial001.py!}
+{!../../docs_src/debugging/tutorial001.py!}
```
### Sobre `__name__ == "__main__"`
diff --git a/docs/pt/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/pt/docs/tutorial/dependencies/classes-as-dependencies.md
index 420503b87..179bfefb5 100644
--- a/docs/pt/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/pt/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -9,7 +9,7 @@ No exemplo anterior, nós retornávamos um `dict` da nossa dependência ("injet
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@ No exemplo anterior, nós retornávamos um `dict` da nossa dependência ("injet
//// tab | Python 3.9+
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ No exemplo anterior, nós retornávamos um `dict` da nossa dependência ("injet
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="7"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -122,7 +122,7 @@ Então, podemos mudar o "injetável" na dependência `common_parameters` acima p
//// tab | Python 3.10+
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py310.py!}
```
////
@@ -130,7 +130,7 @@ Então, podemos mudar o "injetável" na dependência `common_parameters` acima p
//// tab | Python 3.9+
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py39.py!}
```
////
@@ -138,7 +138,7 @@ Então, podemos mudar o "injetável" na dependência `common_parameters` acima p
//// tab | Python 3.8+
```Python hl_lines="12-16"
-{!> ../../../docs_src/dependencies/tutorial002_an.py!}
+{!> ../../docs_src/dependencies/tutorial002_an.py!}
```
////
@@ -152,7 +152,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="9-13"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -166,7 +166,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -176,7 +176,7 @@ Observe o método `__init__` usado para criar uma instância da classe:
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py310.py!}
```
////
@@ -184,7 +184,7 @@ Observe o método `__init__` usado para criar uma instância da classe:
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py39.py!}
```
////
@@ -192,7 +192,7 @@ Observe o método `__init__` usado para criar uma instância da classe:
//// tab | Python 3.8+
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial002_an.py!}
+{!> ../../docs_src/dependencies/tutorial002_an.py!}
```
////
@@ -206,7 +206,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -220,7 +220,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -230,7 +230,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -238,7 +238,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -246,7 +246,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -260,7 +260,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="6"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -274,7 +274,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -296,7 +296,7 @@ Agora você pode declarar sua dependência utilizando essa classe.
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py310.py!}
```
////
@@ -304,7 +304,7 @@ Agora você pode declarar sua dependência utilizando essa classe.
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py39.py!}
```
////
@@ -312,7 +312,7 @@ Agora você pode declarar sua dependência utilizando essa classe.
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial002_an.py!}
+{!> ../../docs_src/dependencies/tutorial002_an.py!}
```
////
@@ -326,7 +326,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -340,7 +340,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -440,7 +440,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial003_an_py310.py!}
```
////
@@ -448,7 +448,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial003_an_py39.py!}
```
////
@@ -456,7 +456,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial003_an.py!}
+{!> ../../docs_src/dependencies/tutorial003_an.py!}
```
////
@@ -470,7 +470,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial003_py310.py!}
+{!> ../../docs_src/dependencies/tutorial003_py310.py!}
```
////
@@ -484,7 +484,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003.py!}
+{!> ../../docs_src/dependencies/tutorial003.py!}
```
////
@@ -578,7 +578,7 @@ O mesmo exemplo ficaria então dessa forma:
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial004_an_py310.py!}
```
////
@@ -586,7 +586,7 @@ O mesmo exemplo ficaria então dessa forma:
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial004_an_py39.py!}
```
////
@@ -594,7 +594,7 @@ O mesmo exemplo ficaria então dessa forma:
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial004_an.py!}
+{!> ../../docs_src/dependencies/tutorial004_an.py!}
```
////
@@ -608,7 +608,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial004_py310.py!}
+{!> ../../docs_src/dependencies/tutorial004_py310.py!}
```
////
@@ -622,7 +622,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004.py!}
+{!> ../../docs_src/dependencies/tutorial004.py!}
```
////
diff --git a/docs/pt/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/pt/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index 4a7a29390..7d7086945 100644
--- a/docs/pt/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/pt/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -17,7 +17,7 @@ Ele deve ser uma lista de `Depends()`:
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ Ele deve ser uma lista de `Depends()`:
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -39,7 +39,7 @@ Utilize a versão com `Annotated` se possível
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -75,7 +75,7 @@ Dependências podem declarar requisitos de requisições (como cabeçalhos) ou o
//// tab | Python 3.9+
```Python hl_lines="8 13"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -83,7 +83,7 @@ Dependências podem declarar requisitos de requisições (como cabeçalhos) ou o
//// tab | Python 3.8+
```Python hl_lines="7 12"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -97,7 +97,7 @@ Utilize a versão com `Annotated` se possível
///
```Python hl_lines="6 11"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -109,7 +109,7 @@ Essas dependências podem levantar exceções, da mesma forma que dependências
//// tab | Python 3.9+
```Python hl_lines="10 15"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -117,7 +117,7 @@ Essas dependências podem levantar exceções, da mesma forma que dependências
//// tab | Python 3.8+
```Python hl_lines="9 14"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -131,7 +131,7 @@ Utilize a versão com `Annotated` se possível
///
```Python hl_lines="8 13"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -145,7 +145,7 @@ Então, você pode reutilizar uma dependência comum (que retorna um valor) que
//// tab | Python 3.9+
```Python hl_lines="11 16"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -153,7 +153,7 @@ Então, você pode reutilizar uma dependência comum (que retorna um valor) que
//// tab | Python 3.8+
```Python hl_lines="10 15"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -169,7 +169,7 @@ Então, você pode reutilizar uma dependência comum (que retorna um valor) que
Utilize a versão com `Annotated` se possível
```Python hl_lines="9 14"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
diff --git a/docs/pt/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/pt/docs/tutorial/dependencies/dependencies-with-yield.md
index 16c2cf899..d90bebe39 100644
--- a/docs/pt/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/pt/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -30,19 +30,19 @@ Por exemplo, você poderia utilizar isso para criar uma sessão do banco de dado
Apenas o código anterior a declaração com `yield` e o código contendo essa declaração são executados antes de criar uma resposta.
```Python hl_lines="2-4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
O valor gerado (yielded) é o que é injetado nas *operações de rota* e outras dependências.
```Python hl_lines="4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
O código após o `yield` é executado após a resposta ser entregue:
```Python hl_lines="5-6"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
/// tip | "Dica"
@@ -64,7 +64,7 @@ Então, você pode procurar por essa exceção específica dentro da dependênci
Da mesma forma, você pode utilizar `finally` para garantir que os passos de saída são executados, com ou sem exceções.
```python hl_lines="3 5"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
## Subdependências com `yield`
@@ -78,7 +78,7 @@ Por exemplo, `dependency_c` pode depender de `dependency_b`, e `dependency_b` de
//// tab | python 3.9+
```python hl_lines="6 14 22"
-{!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008_an_py39.py!}
```
////
@@ -86,7 +86,7 @@ Por exemplo, `dependency_c` pode depender de `dependency_b`, e `dependency_b` de
//// tab | python 3.8+
```python hl_lines="5 13 21"
-{!> ../../../docs_src/dependencies/tutorial008_an.py!}
+{!> ../../docs_src/dependencies/tutorial008_an.py!}
```
////
@@ -100,7 +100,7 @@ Utilize a versão com `Annotated` se possível.
///
```python hl_lines="4 12 20"
-{!> ../../../docs_src/dependencies/tutorial008.py!}
+{!> ../../docs_src/dependencies/tutorial008.py!}
```
////
@@ -114,7 +114,7 @@ E, por outro lado, `dependency_b` precisa que o valor de `dependency_a` (nomeada
//// tab | python 3.9+
```python hl_lines="18-19 26-27"
-{!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008_an_py39.py!}
```
////
@@ -122,7 +122,7 @@ E, por outro lado, `dependency_b` precisa que o valor de `dependency_a` (nomeada
//// tab | python 3.8+
```python hl_lines="17-18 25-26"
-{!> ../../../docs_src/dependencies/tutorial008_an.py!}
+{!> ../../docs_src/dependencies/tutorial008_an.py!}
```
////
@@ -136,7 +136,7 @@ Utilize a versão com `Annotated` se possível.
///
```python hl_lines="16-17 24-25"
-{!> ../../../docs_src/dependencies/tutorial008.py!}
+{!> ../../docs_src/dependencies/tutorial008.py!}
```
////
@@ -174,7 +174,7 @@ Mas ela existe para ser utilizada caso você precise. 🤓
//// tab | python 3.9+
```python hl_lines="18-22 31"
-{!> ../../../docs_src/dependencies/tutorial008b_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008b_an_py39.py!}
```
////
@@ -182,7 +182,7 @@ Mas ela existe para ser utilizada caso você precise. 🤓
//// tab | python 3.8+
```python hl_lines="17-21 30"
-{!> ../../../docs_src/dependencies/tutorial008b_an.py!}
+{!> ../../docs_src/dependencies/tutorial008b_an.py!}
```
////
@@ -196,7 +196,7 @@ Utilize a versão com `Annotated` se possível.
///
```python hl_lines="16-20 29"
-{!> ../../../docs_src/dependencies/tutorial008b.py!}
+{!> ../../docs_src/dependencies/tutorial008b.py!}
```
////
@@ -210,7 +210,7 @@ Se você capturar uma exceção com `except` em uma dependência que utilize `yi
//// tab | Python 3.9+
```Python hl_lines="15-16"
-{!> ../../../docs_src/dependencies/tutorial008c_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008c_an_py39.py!}
```
////
@@ -218,7 +218,7 @@ Se você capturar uma exceção com `except` em uma dependência que utilize `yi
//// tab | Python 3.8+
```Python hl_lines="14-15"
-{!> ../../../docs_src/dependencies/tutorial008c_an.py!}
+{!> ../../docs_src/dependencies/tutorial008c_an.py!}
```
////
@@ -232,7 +232,7 @@ utilize a versão com `Annotated` se possível.
///
```Python hl_lines="13-14"
-{!> ../../../docs_src/dependencies/tutorial008c.py!}
+{!> ../../docs_src/dependencies/tutorial008c.py!}
```
////
@@ -248,7 +248,7 @@ Você pode relançar a mesma exceção utilizando `raise`:
//// tab | Python 3.9+
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial008d_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008d_an_py39.py!}
```
////
@@ -256,7 +256,7 @@ Você pode relançar a mesma exceção utilizando `raise`:
//// tab | Python 3.8+
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial008d_an.py!}
+{!> ../../docs_src/dependencies/tutorial008d_an.py!}
```
////
@@ -270,7 +270,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="15"
-{!> ../../../docs_src/dependencies/tutorial008d.py!}
+{!> ../../docs_src/dependencies/tutorial008d.py!}
```
////
@@ -403,7 +403,7 @@ Em python, você pode criar Gerenciadores de Contexto ao <a href="https://docs.p
Você também pode usá-los dentro de dependências com `yield` do **FastAPI** ao utilizar `with` ou `async with` dentro da função da dependência:
```Python hl_lines="1-9 13"
-{!../../../docs_src/dependencies/tutorial010.py!}
+{!../../docs_src/dependencies/tutorial010.py!}
```
/// tip | "Dica"
diff --git a/docs/pt/docs/tutorial/dependencies/global-dependencies.md b/docs/pt/docs/tutorial/dependencies/global-dependencies.md
index 96dbaee5e..60a88940c 100644
--- a/docs/pt/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/pt/docs/tutorial/dependencies/global-dependencies.md
@@ -9,7 +9,7 @@ Nesse caso, elas serão aplicadas a todas as *operações de rota* da aplicaçã
//// tab | Python 3.9+
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial012_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial012_an_py39.py!}
```
////
@@ -17,7 +17,7 @@ Nesse caso, elas serão aplicadas a todas as *operações de rota* da aplicaçã
//// tab | Python 3.8+
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial012_an.py!}
+{!> ../../docs_src/dependencies/tutorial012_an.py!}
```
////
@@ -31,7 +31,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="15"
-{!> ../../../docs_src/dependencies/tutorial012.py!}
+{!> ../../docs_src/dependencies/tutorial012.py!}
```
////
diff --git a/docs/pt/docs/tutorial/dependencies/index.md b/docs/pt/docs/tutorial/dependencies/index.md
index f7b32966c..2a63e7ab8 100644
--- a/docs/pt/docs/tutorial/dependencies/index.md
+++ b/docs/pt/docs/tutorial/dependencies/index.md
@@ -34,7 +34,7 @@ Ela é apenas uma função que pode receber os mesmos parâmetros de uma *funç
//// tab | Python 3.10+
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -42,7 +42,7 @@ Ela é apenas uma função que pode receber os mesmos parâmetros de uma *funç
//// tab | Python 3.9+
```Python hl_lines="8-11"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -50,7 +50,7 @@ Ela é apenas uma função que pode receber os mesmos parâmetros de uma *funç
//// tab | Python 3.8+
```Python hl_lines="9-12"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -64,7 +64,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="6-7"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -78,7 +78,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="8-11"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -116,7 +116,7 @@ Certifique-se de [Atualizar a versão do FastAPI](../../deployment/versions.md#a
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -124,7 +124,7 @@ Certifique-se de [Atualizar a versão do FastAPI](../../deployment/versions.md#a
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -132,7 +132,7 @@ Certifique-se de [Atualizar a versão do FastAPI](../../deployment/versions.md#a
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -146,7 +146,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="1"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -160,7 +160,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -172,7 +172,7 @@ Da mesma forma que você utiliza `Body`, `Query`, etc. Como parâmetros de sua *
//// tab | Python 3.10+
```Python hl_lines="13 18"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -180,7 +180,7 @@ Da mesma forma que você utiliza `Body`, `Query`, etc. Como parâmetros de sua *
//// tab | Python 3.9+
```Python hl_lines="15 20"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -188,7 +188,7 @@ Da mesma forma que você utiliza `Body`, `Query`, etc. Como parâmetros de sua *
//// tab | Python 3.8+
```Python hl_lines="16 21"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -202,7 +202,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="11 16"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -216,7 +216,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="15 20"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -279,7 +279,7 @@ Mas como estamos utilizando `Annotated`, podemos guardar esse valor `Annotated`
//// tab | Python 3.10+
```Python hl_lines="12 16 21"
-{!> ../../../docs_src/dependencies/tutorial001_02_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an_py310.py!}
```
////
@@ -287,7 +287,7 @@ Mas como estamos utilizando `Annotated`, podemos guardar esse valor `Annotated`
//// tab | Python 3.9+
```Python hl_lines="14 18 23"
-{!> ../../../docs_src/dependencies/tutorial001_02_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an_py39.py!}
```
////
@@ -295,7 +295,7 @@ Mas como estamos utilizando `Annotated`, podemos guardar esse valor `Annotated`
//// tab | Python 3.8+
```Python hl_lines="15 19 24"
-{!> ../../../docs_src/dependencies/tutorial001_02_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an.py!}
```
////
diff --git a/docs/pt/docs/tutorial/dependencies/sub-dependencies.md b/docs/pt/docs/tutorial/dependencies/sub-dependencies.md
index 279bf3339..b890fe793 100644
--- a/docs/pt/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/pt/docs/tutorial/dependencies/sub-dependencies.md
@@ -13,7 +13,7 @@ Você pode criar uma primeira dependência (injetável) dessa forma:
//// tab | Python 3.10+
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial005_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
```
////
@@ -21,7 +21,7 @@ Você pode criar uma primeira dependência (injetável) dessa forma:
//// tab | Python 3.9+
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
```
////
@@ -29,7 +29,7 @@ Você pode criar uma primeira dependência (injetável) dessa forma:
//// tab | Python 3.8+
```Python hl_lines="9-10"
-{!> ../../../docs_src/dependencies/tutorial005_an.py!}
+{!> ../../docs_src/dependencies/tutorial005_an.py!}
```
////
@@ -43,7 +43,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="6-7"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -57,7 +57,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
@@ -73,7 +73,7 @@ Então, você pode criar uma outra função para uma dependência (um "injetáve
//// tab | Python 3.10+
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial005_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
```
////
@@ -81,7 +81,7 @@ Então, você pode criar uma outra função para uma dependência (um "injetáve
//// tab | Python 3.9+
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
```
////
@@ -89,7 +89,7 @@ Então, você pode criar uma outra função para uma dependência (um "injetáve
//// tab | Python 3.8+
```Python hl_lines="14"
-{!> ../../../docs_src/dependencies/tutorial005_an.py!}
+{!> ../../docs_src/dependencies/tutorial005_an.py!}
```
////
@@ -103,7 +103,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -117,7 +117,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
@@ -136,7 +136,7 @@ Então podemos utilizar a dependência com:
//// tab | Python 3.10+
```Python hl_lines="23"
-{!> ../../../docs_src/dependencies/tutorial005_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
```
////
@@ -144,7 +144,7 @@ Então podemos utilizar a dependência com:
//// tab | Python 3.9+
```Python hl_lines="23"
-{!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
```
////
@@ -152,7 +152,7 @@ Então podemos utilizar a dependência com:
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/dependencies/tutorial005_an.py!}
+{!> ../../docs_src/dependencies/tutorial005_an.py!}
```
////
@@ -166,7 +166,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -180,7 +180,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="22"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
diff --git a/docs/pt/docs/tutorial/encoder.md b/docs/pt/docs/tutorial/encoder.md
index c104098ee..c8ce77e74 100644
--- a/docs/pt/docs/tutorial/encoder.md
+++ b/docs/pt/docs/tutorial/encoder.md
@@ -23,7 +23,7 @@ A função recebe um objeto, como um modelo Pydantic e retorna uma versão compa
//// tab | Python 3.10+
```Python hl_lines="4 21"
-{!> ../../../docs_src/encoder/tutorial001_py310.py!}
+{!> ../../docs_src/encoder/tutorial001_py310.py!}
```
////
@@ -31,7 +31,7 @@ A função recebe um objeto, como um modelo Pydantic e retorna uma versão compa
//// tab | Python 3.8+
```Python hl_lines="5 22"
-{!> ../../../docs_src/encoder/tutorial001.py!}
+{!> ../../docs_src/encoder/tutorial001.py!}
```
////
diff --git a/docs/pt/docs/tutorial/extra-data-types.md b/docs/pt/docs/tutorial/extra-data-types.md
index 5d50d8942..78f7ac694 100644
--- a/docs/pt/docs/tutorial/extra-data-types.md
+++ b/docs/pt/docs/tutorial/extra-data-types.md
@@ -56,11 +56,11 @@ Aqui estão alguns dos tipos de dados adicionais que você pode usar:
Aqui está um exemplo de *operação de rota* com parâmetros utilizando-se de alguns dos tipos acima.
```Python hl_lines="1 3 12-16"
-{!../../../docs_src/extra_data_types/tutorial001.py!}
+{!../../docs_src/extra_data_types/tutorial001.py!}
```
Note que os parâmetros dentro da função tem seu tipo de dados natural, e você pode, por exemplo, realizar manipulações normais de data, como:
```Python hl_lines="18-19"
-{!../../../docs_src/extra_data_types/tutorial001.py!}
+{!../../docs_src/extra_data_types/tutorial001.py!}
```
diff --git a/docs/pt/docs/tutorial/extra-models.md b/docs/pt/docs/tutorial/extra-models.md
index 564aeadca..03227f2bb 100644
--- a/docs/pt/docs/tutorial/extra-models.md
+++ b/docs/pt/docs/tutorial/extra-models.md
@@ -23,7 +23,7 @@ Aqui está uma ideia geral de como os modelos poderiam parecer com seus campos d
//// tab | Python 3.8 and above
```Python hl_lines="9 11 16 22 24 29-30 33-35 40-41"
-{!> ../../../docs_src/extra_models/tutorial001.py!}
+{!> ../../docs_src/extra_models/tutorial001.py!}
```
////
@@ -31,7 +31,7 @@ Aqui está uma ideia geral de como os modelos poderiam parecer com seus campos d
//// tab | Python 3.10 and above
```Python hl_lines="7 9 14 20 22 27-28 31-33 38-39"
-{!> ../../../docs_src/extra_models/tutorial001_py310.py!}
+{!> ../../docs_src/extra_models/tutorial001_py310.py!}
```
////
@@ -171,7 +171,7 @@ Dessa forma, podemos declarar apenas as diferenças entre os modelos (com `passw
//// tab | Python 3.8 and above
```Python hl_lines="9 15-16 19-20 23-24"
-{!> ../../../docs_src/extra_models/tutorial002.py!}
+{!> ../../docs_src/extra_models/tutorial002.py!}
```
////
@@ -179,7 +179,7 @@ Dessa forma, podemos declarar apenas as diferenças entre os modelos (com `passw
//// tab | Python 3.10 and above
```Python hl_lines="7 13-14 17-18 21-22"
-{!> ../../../docs_src/extra_models/tutorial002_py310.py!}
+{!> ../../docs_src/extra_models/tutorial002_py310.py!}
```
////
@@ -201,7 +201,7 @@ Ao definir um <a href="https://docs.pydantic.dev/latest/concepts/types/#unions"
//// tab | Python 3.8 and above
```Python hl_lines="1 14-15 18-20 33"
-{!> ../../../docs_src/extra_models/tutorial003.py!}
+{!> ../../docs_src/extra_models/tutorial003.py!}
```
////
@@ -209,7 +209,7 @@ Ao definir um <a href="https://docs.pydantic.dev/latest/concepts/types/#unions"
//// tab | Python 3.10 and above
```Python hl_lines="1 14-15 18-20 33"
-{!> ../../../docs_src/extra_models/tutorial003_py310.py!}
+{!> ../../docs_src/extra_models/tutorial003_py310.py!}
```
////
@@ -237,7 +237,7 @@ Para isso, use o padrão Python `typing.List` (ou simplesmente `list` no Python
//// tab | Python 3.8 and above
```Python hl_lines="1 20"
-{!> ../../../docs_src/extra_models/tutorial004.py!}
+{!> ../../docs_src/extra_models/tutorial004.py!}
```
////
@@ -245,7 +245,7 @@ Para isso, use o padrão Python `typing.List` (ou simplesmente `list` no Python
//// tab | Python 3.9 and above
```Python hl_lines="18"
-{!> ../../../docs_src/extra_models/tutorial004_py39.py!}
+{!> ../../docs_src/extra_models/tutorial004_py39.py!}
```
////
@@ -261,7 +261,7 @@ Neste caso, você pode usar `typing.Dict` (ou simplesmente dict no Python 3.9 e
//// tab | Python 3.8 and above
```Python hl_lines="1 8"
-{!> ../../../docs_src/extra_models/tutorial005.py!}
+{!> ../../docs_src/extra_models/tutorial005.py!}
```
////
@@ -269,7 +269,7 @@ Neste caso, você pode usar `typing.Dict` (ou simplesmente dict no Python 3.9 e
//// tab | Python 3.9 and above
```Python hl_lines="6"
-{!> ../../../docs_src/extra_models/tutorial005_py39.py!}
+{!> ../../docs_src/extra_models/tutorial005_py39.py!}
```
////
diff --git a/docs/pt/docs/tutorial/first-steps.md b/docs/pt/docs/tutorial/first-steps.md
index 4c2a8a8e3..4990b5984 100644
--- a/docs/pt/docs/tutorial/first-steps.md
+++ b/docs/pt/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
O arquivo FastAPI mais simples pode se parecer com:
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Copie o conteúdo para um arquivo `main.py`.
@@ -134,7 +134,7 @@ Você também pode usá-lo para gerar código automaticamente para clientes que
### Passo 1: importe `FastAPI`
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI` é uma classe Python que fornece todas as funcionalidades para sua API.
@@ -150,7 +150,7 @@ Você pode usar todas as funcionalidades do <a href="https://www.starlette.io/"
### Passo 2: crie uma "instância" de `FastAPI`
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Aqui, a variável `app` será uma "instância" da classe `FastAPI`.
@@ -172,7 +172,7 @@ $ uvicorn main:app --reload
Se você criar a sua aplicação como:
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial002.py!}
+{!../../docs_src/first_steps/tutorial002.py!}
```
E colocar em um arquivo `main.py`, você iria chamar o `uvicorn` assim:
@@ -251,7 +251,7 @@ Vamos chamá-los de "**operações**" também.
#### Defina um *decorador de rota*
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
O `@app.get("/")` diz ao **FastAPI** que a função logo abaixo é responsável por tratar as requisições que vão para:
@@ -307,7 +307,7 @@ Esta é a nossa "**função de rota**":
* **função**: é a função abaixo do "decorador" (abaixo do `@app.get("/")`).
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Esta é uma função Python.
@@ -321,7 +321,7 @@ Neste caso, é uma função `assíncrona`.
Você também pode defini-la como uma função normal em vez de `async def`:
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note | "Nota"
@@ -333,7 +333,7 @@ Se você não sabe a diferença, verifique o [Async: *"Com pressa?"*](../async.m
### Passo 5: retorne o conteúdo
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Você pode retornar um `dict`, `list` e valores singulares como `str`, `int`, etc.
diff --git a/docs/pt/docs/tutorial/handling-errors.md b/docs/pt/docs/tutorial/handling-errors.md
index 6bebf604e..4a042f219 100644
--- a/docs/pt/docs/tutorial/handling-errors.md
+++ b/docs/pt/docs/tutorial/handling-errors.md
@@ -27,7 +27,7 @@ Para retornar ao cliente *responses* HTTP com erros, use o `HTTPException`.
### Import `HTTPException`
```Python hl_lines="1"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
### Lance o `HTTPException` no seu código.
@@ -43,7 +43,7 @@ O benefício de lançar uma exceção em vez de retornar um valor ficará mais e
Neste exemplo, quando o cliente pede, na requisição, por um item cujo ID não existe, a exceção com o status code `404` é lançada:
```Python hl_lines="11"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
### A response resultante
@@ -84,7 +84,7 @@ Você provavelmente não precisará utilizar esses headers diretamente no seu c
Mas caso você precise, para um cenário mais complexo, você pode adicionar headers customizados:
```Python hl_lines="14"
-{!../../../docs_src/handling_errors/tutorial002.py!}
+{!../../docs_src/handling_errors/tutorial002.py!}
```
## Instalando manipuladores de exceções customizados
@@ -96,7 +96,7 @@ Digamos que você tenha uma exceção customizada `UnicornException` que você (
Nesse cenário, se você precisa manipular essa exceção de modo global com o FastAPI, você pode adicionar um manipulador de exceção customizada com `@app.exception_handler()`.
```Python hl_lines="5-7 13-18 24"
-{!../../../docs_src/handling_errors/tutorial003.py!}
+{!../../docs_src/handling_errors/tutorial003.py!}
```
Nesse cenário, se você fizer uma requisição para `/unicorns/yolo`, a *operação de caminho* vai lançar (`raise`) o `UnicornException`.
@@ -132,7 +132,7 @@ Quando a requisição contém dados inválidos, **FastAPI** internamente lança
Para sobrescrevê-lo, importe o `RequestValidationError` e use-o com o `@app.exception_handler(RequestValidationError)` para decorar o manipulador de exceções.
```Python hl_lines="2 14-16"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
Se você for ao `/items/foo`, em vez de receber o JSON padrão com o erro:
@@ -183,7 +183,7 @@ Do mesmo modo, você pode sobreescrever o `HTTPException`.
Por exemplo, você pode querer retornar uma *response* em *plain text* ao invés de um JSON para os seguintes erros:
```Python hl_lines="3-4 9-11 22"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
/// note | "Detalhes Técnicos"
@@ -255,7 +255,7 @@ from starlette.exceptions import HTTPException as StarletteHTTPException
Se você quer usar a exceção em conjunto com o mesmo manipulador de exceção *default* do **FastAPI**, você pode importar e re-usar esses manipuladores de exceção do `fastapi.exception_handlers`:
```Python hl_lines="2-5 15 21"
-{!../../../docs_src/handling_errors/tutorial006.py!}
+{!../../docs_src/handling_errors/tutorial006.py!}
```
Nesse exemplo você apenas imprime (`print`) o erro com uma mensagem expressiva. Mesmo assim, dá para pegar a ideia. Você pode usar a exceção e então apenas re-usar o manipulador de exceção *default*.
diff --git a/docs/pt/docs/tutorial/header-params.md b/docs/pt/docs/tutorial/header-params.md
index 809fb5cf1..f7be2b0b7 100644
--- a/docs/pt/docs/tutorial/header-params.md
+++ b/docs/pt/docs/tutorial/header-params.md
@@ -9,7 +9,7 @@ Primeiro importe `Header`:
//// tab | Python 3.10+
```Python hl_lines="1"
-{!> ../../../docs_src/header_params/tutorial001_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_py310.py!}
```
////
@@ -17,7 +17,7 @@ Primeiro importe `Header`:
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001.py!}
+{!> ../../docs_src/header_params/tutorial001.py!}
```
////
@@ -31,7 +31,7 @@ O primeiro valor é o valor padrão, você pode passar todas as validações adi
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/header_params/tutorial001_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_py310.py!}
```
////
@@ -39,7 +39,7 @@ O primeiro valor é o valor padrão, você pode passar todas as validações adi
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001.py!}
+{!> ../../docs_src/header_params/tutorial001.py!}
```
////
@@ -77,7 +77,7 @@ Se por algum motivo você precisar desabilitar a conversão automática de subli
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/header_params/tutorial002_py310.py!}
+{!> ../../docs_src/header_params/tutorial002_py310.py!}
```
////
@@ -85,7 +85,7 @@ Se por algum motivo você precisar desabilitar a conversão automática de subli
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial002.py!}
+{!> ../../docs_src/header_params/tutorial002.py!}
```
////
@@ -109,7 +109,7 @@ Por exemplo, para declarar um cabeçalho de `X-Token` que pode aparecer mais de
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/header_params/tutorial003_py310.py!}
+{!> ../../docs_src/header_params/tutorial003_py310.py!}
```
////
@@ -117,7 +117,7 @@ Por exemplo, para declarar um cabeçalho de `X-Token` que pode aparecer mais de
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_py39.py!}
+{!> ../../docs_src/header_params/tutorial003_py39.py!}
```
////
@@ -125,7 +125,7 @@ Por exemplo, para declarar um cabeçalho de `X-Token` que pode aparecer mais de
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003.py!}
+{!> ../../docs_src/header_params/tutorial003.py!}
```
////
diff --git a/docs/pt/docs/tutorial/middleware.md b/docs/pt/docs/tutorial/middleware.md
index 1760246ee..35c61d5fc 100644
--- a/docs/pt/docs/tutorial/middleware.md
+++ b/docs/pt/docs/tutorial/middleware.md
@@ -32,7 +32,7 @@ A função middleware recebe:
* Você pode então modificar ainda mais o `response` antes de retorná-lo.
```Python hl_lines="8-9 11 14"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
/// tip | "Dica"
@@ -60,7 +60,7 @@ E também depois que a `response` é gerada, antes de retorná-la.
Por exemplo, você pode adicionar um cabeçalho personalizado `X-Process-Time` contendo o tempo em segundos que levou para processar a solicitação e gerar uma resposta:
```Python hl_lines="10 12-13"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
## Outros middlewares
diff --git a/docs/pt/docs/tutorial/path-operation-configuration.md b/docs/pt/docs/tutorial/path-operation-configuration.md
index c57813780..48753d725 100644
--- a/docs/pt/docs/tutorial/path-operation-configuration.md
+++ b/docs/pt/docs/tutorial/path-operation-configuration.md
@@ -19,7 +19,7 @@ Mas se você não se lembrar o que cada código numérico significa, pode usar a
//// tab | Python 3.8 and above
```Python hl_lines="3 17"
-{!> ../../../docs_src/path_operation_configuration/tutorial001.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001.py!}
```
////
@@ -27,7 +27,7 @@ Mas se você não se lembrar o que cada código numérico significa, pode usar a
//// tab | Python 3.9 and above
```Python hl_lines="3 17"
-{!> ../../../docs_src/path_operation_configuration/tutorial001_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001_py39.py!}
```
////
@@ -35,7 +35,7 @@ Mas se você não se lembrar o que cada código numérico significa, pode usar a
//// tab | Python 3.10 and above
```Python hl_lines="1 15"
-{!> ../../../docs_src/path_operation_configuration/tutorial001_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001_py310.py!}
```
////
@@ -57,7 +57,7 @@ Você pode adicionar tags para sua *operação de rota*, passe o parâmetro `tag
//// tab | Python 3.8 and above
```Python hl_lines="17 22 27"
-{!> ../../../docs_src/path_operation_configuration/tutorial002.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002.py!}
```
////
@@ -65,7 +65,7 @@ Você pode adicionar tags para sua *operação de rota*, passe o parâmetro `tag
//// tab | Python 3.9 and above
```Python hl_lines="17 22 27"
-{!> ../../../docs_src/path_operation_configuration/tutorial002_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002_py39.py!}
```
////
@@ -73,7 +73,7 @@ Você pode adicionar tags para sua *operação de rota*, passe o parâmetro `tag
//// tab | Python 3.10 and above
```Python hl_lines="15 20 25"
-{!> ../../../docs_src/path_operation_configuration/tutorial002_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002_py310.py!}
```
////
@@ -91,7 +91,7 @@ Nestes casos, pode fazer sentido armazenar as tags em um `Enum`.
**FastAPI** suporta isso da mesma maneira que com strings simples:
```Python hl_lines="1 8-10 13 18"
-{!../../../docs_src/path_operation_configuration/tutorial002b.py!}
+{!../../docs_src/path_operation_configuration/tutorial002b.py!}
```
## Resumo e descrição
@@ -101,7 +101,7 @@ Você pode adicionar um `summary` e uma `description`:
//// tab | Python 3.8 and above
```Python hl_lines="20-21"
-{!> ../../../docs_src/path_operation_configuration/tutorial003.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003.py!}
```
////
@@ -109,7 +109,7 @@ Você pode adicionar um `summary` e uma `description`:
//// tab | Python 3.9 and above
```Python hl_lines="20-21"
-{!> ../../../docs_src/path_operation_configuration/tutorial003_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003_py39.py!}
```
////
@@ -117,7 +117,7 @@ Você pode adicionar um `summary` e uma `description`:
//// tab | Python 3.10 and above
```Python hl_lines="18-19"
-{!> ../../../docs_src/path_operation_configuration/tutorial003_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003_py310.py!}
```
////
@@ -131,7 +131,7 @@ Você pode escrever <a href="https://en.wikipedia.org/wiki/Markdown" class="exte
//// tab | Python 3.8 and above
```Python hl_lines="19-27"
-{!> ../../../docs_src/path_operation_configuration/tutorial004.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004.py!}
```
////
@@ -139,7 +139,7 @@ Você pode escrever <a href="https://en.wikipedia.org/wiki/Markdown" class="exte
//// tab | Python 3.9 and above
```Python hl_lines="19-27"
-{!> ../../../docs_src/path_operation_configuration/tutorial004_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004_py39.py!}
```
////
@@ -147,7 +147,7 @@ Você pode escrever <a href="https://en.wikipedia.org/wiki/Markdown" class="exte
//// tab | Python 3.10 and above
```Python hl_lines="17-25"
-{!> ../../../docs_src/path_operation_configuration/tutorial004_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004_py310.py!}
```
////
@@ -164,7 +164,7 @@ Você pode especificar a descrição da resposta com o parâmetro `response_desc
//// tab | Python 3.8 and above
```Python hl_lines="21"
-{!> ../../../docs_src/path_operation_configuration/tutorial005.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005.py!}
```
////
@@ -172,7 +172,7 @@ Você pode especificar a descrição da resposta com o parâmetro `response_desc
//// tab | Python 3.9 and above
```Python hl_lines="21"
-{!> ../../../docs_src/path_operation_configuration/tutorial005_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005_py39.py!}
```
////
@@ -180,7 +180,7 @@ Você pode especificar a descrição da resposta com o parâmetro `response_desc
//// tab | Python 3.10 and above
```Python hl_lines="19"
-{!> ../../../docs_src/path_operation_configuration/tutorial005_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005_py310.py!}
```
////
@@ -206,7 +206,7 @@ Então, se você não fornecer uma, o **FastAPI** irá gerar automaticamente uma
Se você precisar marcar uma *operação de rota* como <abbr title="obsoleta, recomendada não usá-la">descontinuada</abbr>, mas sem removê-la, passe o parâmetro `deprecated`:
```Python hl_lines="16"
-{!../../../docs_src/path_operation_configuration/tutorial006.py!}
+{!../../docs_src/path_operation_configuration/tutorial006.py!}
```
Ela será claramente marcada como descontinuada nas documentações interativas:
diff --git a/docs/pt/docs/tutorial/path-params-numeric-validations.md b/docs/pt/docs/tutorial/path-params-numeric-validations.md
index 08ed03f75..28c55482f 100644
--- a/docs/pt/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/pt/docs/tutorial/path-params-numeric-validations.md
@@ -9,7 +9,7 @@ Primeiro, importe `Path` de `fastapi`:
//// tab | Python 3.10+
```Python hl_lines="1"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -17,7 +17,7 @@ Primeiro, importe `Path` de `fastapi`:
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -31,7 +31,7 @@ Por exemplo para declarar um valor de metadado `title` para o parâmetro de rota
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -39,7 +39,7 @@ Por exemplo para declarar um valor de metadado `title` para o parâmetro de rota
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -71,7 +71,7 @@ Isso não faz diferença para o **FastAPI**. Ele vai detectar os parâmetros pel
Então, você pode declarar sua função assim:
```Python hl_lines="7"
-{!../../../docs_src/path_params_numeric_validations/tutorial002.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial002.py!}
```
## Ordene os parâmetros de a acordo com sua necessidade, truques
@@ -83,7 +83,7 @@ Passe `*`, como o primeiro parâmetro da função.
O Python não vai fazer nada com esse `*`, mas ele vai saber que a partir dali os parâmetros seguintes deverão ser chamados argumentos nomeados (pares chave-valor), também conhecidos como <abbr title="Do inglês: K-ey W-ord Arg-uments"><code>kwargs</code></abbr>. Mesmo que eles não possuam um valor padrão.
```Python hl_lines="7"
-{!../../../docs_src/path_params_numeric_validations/tutorial003.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial003.py!}
```
## Validações numéricas: maior que ou igual
@@ -93,7 +93,7 @@ Com `Query` e `Path` (e outras que você verá mais tarde) você pode declarar r
Aqui, com `ge=1`, `item_id` precisará ser um número inteiro maior que ("`g`reater than") ou igual ("`e`qual") a 1.
```Python hl_lines="8"
-{!../../../docs_src/path_params_numeric_validations/tutorial004.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial004.py!}
```
## Validações numéricas: maior que e menor que ou igual
@@ -104,7 +104,7 @@ O mesmo se aplica para:
* `le`: menor que ou igual (`l`ess than or `e`qual)
```Python hl_lines="9"
-{!../../../docs_src/path_params_numeric_validations/tutorial005.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial005.py!}
```
## Validações numéricas: valores do tipo float, maior que e menor que
@@ -118,7 +118,7 @@ Assim, `0.5` seria um valor válido. Mas `0.0` ou `0` não seria.
E o mesmo para <abbr title="less than"><code>lt</code></abbr>.
```Python hl_lines="11"
-{!../../../docs_src/path_params_numeric_validations/tutorial006.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial006.py!}
```
## Recapitulando
diff --git a/docs/pt/docs/tutorial/path-params.md b/docs/pt/docs/tutorial/path-params.md
index fb872e4f5..a68354a1b 100644
--- a/docs/pt/docs/tutorial/path-params.md
+++ b/docs/pt/docs/tutorial/path-params.md
@@ -3,7 +3,7 @@
Você pode declarar os "parâmetros" ou "variáveis" com a mesma sintaxe utilizada pelo formato de strings do Python:
```Python hl_lines="6-7"
-{!../../../docs_src/path_params/tutorial001.py!}
+{!../../docs_src/path_params/tutorial001.py!}
```
O valor do parâmetro que foi passado à `item_id` será passado para a sua função como o argumento `item_id`.
@@ -19,7 +19,7 @@ Então, se você rodar este exemplo e for até <a href="http://127.0.0.1:8000/it
Você pode declarar o tipo de um parâmetro na função usando as anotações padrões do Python:
```Python hl_lines="7"
-{!../../../docs_src/path_params/tutorial002.py!}
+{!../../docs_src/path_params/tutorial002.py!}
```
Nesse caso, `item_id` está sendo declarado como um `int`.
@@ -130,7 +130,7 @@ E então você pode ter também uma rota `/users/{user_id}` para pegar dados sob
Porque as operações de rota são avaliadas em ordem, você precisa ter certeza que a rota para `/users/me` está sendo declarado antes da rota `/users/{user_id}`:
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003.py!}
+{!../../docs_src/path_params/tutorial003.py!}
```
Caso contrário, a rota para `/users/{user_id}` coincidiria também para `/users/me`, "pensando" que estaria recebendo o parâmetro `user_id` com o valor de `"me"`.
@@ -148,7 +148,7 @@ Por herdar de `str` a documentação da API vai ser capaz de saber que os valore
Assim, crie atributos de classe com valores fixos, que serão os valores válidos disponíveis.
```Python hl_lines="1 6-9"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// info | "informação"
@@ -170,7 +170,7 @@ Assim, crie atributos de classe com valores fixos, que serão os valores válido
Logo, crie um *parâmetro de rota* com anotações de tipo usando a classe enum que você criou (`ModelName`):
```Python hl_lines="16"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
### Revise a documentação
@@ -188,7 +188,7 @@ O valor do *parâmetro da rota* será um *membro de enumeration*.
Você pode comparar eles com o *membro de enumeration* no enum `ModelName` que você criou:
```Python hl_lines="17"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
#### Obtenha o *valor de enumerate*
@@ -196,7 +196,7 @@ Você pode comparar eles com o *membro de enumeration* no enum `ModelName` que v
Você pode ter o valor exato de enumerate (um `str` nesse caso) usando `model_name.value`, ou em geral, `your_enum_member.value`:
```Python hl_lines="20"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// tip | "Dica"
@@ -214,7 +214,7 @@ Você pode retornar *membros de enum* da sua *rota de operação*, em um corpo J
Eles serão convertidos para o seus valores correspondentes (strings nesse caso) antes de serem retornados ao cliente:
```Python hl_lines="18 21 23"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
No seu cliente você vai obter uma resposta JSON como:
@@ -255,7 +255,7 @@ Nesse caso, o nome do parâmetro é `file_path`, e a última parte, `:path`, diz
Então, você poderia usar ele com:
```Python hl_lines="6"
-{!../../../docs_src/path_params/tutorial004.py!}
+{!../../docs_src/path_params/tutorial004.py!}
```
/// tip | "Dica"
diff --git a/docs/pt/docs/tutorial/query-params-str-validations.md b/docs/pt/docs/tutorial/query-params-str-validations.md
index eac879593..e6dcf748e 100644
--- a/docs/pt/docs/tutorial/query-params-str-validations.md
+++ b/docs/pt/docs/tutorial/query-params-str-validations.md
@@ -5,7 +5,7 @@ O **FastAPI** permite que você declare informações adicionais e validações
Vamos utilizar essa aplicação como exemplo:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial001.py!}
+{!../../docs_src/query_params_str_validations/tutorial001.py!}
```
O parâmetro de consulta `q` é do tipo `Union[str, None]`, o que significa que é do tipo `str` mas que também pode ser `None`, e de fato, o valor padrão é `None`, então o FastAPI saberá que não é obrigatório.
@@ -27,7 +27,7 @@ Nós iremos forçar que mesmo o parâmetro `q` seja opcional, sempre que informa
Para isso, primeiro importe `Query` de `fastapi`:
```Python hl_lines="3"
-{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!../../docs_src/query_params_str_validations/tutorial002.py!}
```
## Use `Query` como o valor padrão
@@ -35,7 +35,7 @@ Para isso, primeiro importe `Query` de `fastapi`:
Agora utilize-o como valor padrão do seu parâmetro, definindo o parâmetro `max_length` para 50:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!../../docs_src/query_params_str_validations/tutorial002.py!}
```
Note que substituímos o valor padrão de `None` para `Query(default=None)`, o primeiro parâmetro de `Query` serve para o mesmo propósito: definir o valor padrão do parâmetro.
@@ -87,7 +87,7 @@ Isso irá validar os dados, mostrar um erro claro quando os dados forem inválid
Você também pode incluir um parâmetro `min_length`:
```Python hl_lines="10"
-{!../../../docs_src/query_params_str_validations/tutorial003.py!}
+{!../../docs_src/query_params_str_validations/tutorial003.py!}
```
## Adicionando expressões regulares
@@ -95,7 +95,7 @@ Você também pode incluir um parâmetro `min_length`:
Você pode definir uma <abbr title="Uma expressão regular, regex ou regexp é uma sequência de caracteres que define um parâmetro de busca para textos.">expressão regular</abbr> que combine com um padrão esperado pelo parâmetro:
```Python hl_lines="11"
-{!../../../docs_src/query_params_str_validations/tutorial004.py!}
+{!../../docs_src/query_params_str_validations/tutorial004.py!}
```
Essa expressão regular específica verifica se o valor recebido no parâmetro:
@@ -115,7 +115,7 @@ Da mesma maneira que você utiliza `None` como o primeiro argumento para ser uti
Vamos dizer que você queira que o parâmetro de consulta `q` tenha um `min_length` de `3`, e um valor padrão de `"fixedquery"`, então declararíamos assim:
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial005.py!}
+{!../../docs_src/query_params_str_validations/tutorial005.py!}
```
/// note | "Observação"
@@ -147,7 +147,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
Então, quando você precisa declarar um parâmetro obrigatório utilizando o `Query`, você pode utilizar `...` como o primeiro argumento:
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial006.py!}
+{!../../docs_src/query_params_str_validations/tutorial006.py!}
```
/// info | "Informação"
@@ -165,7 +165,7 @@ Quando você declara explicitamente um parâmetro com `Query` você pode declar
Por exemplo, para declarar que o parâmetro `q` pode aparecer diversas vezes na URL, você escreveria:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial011.py!}
+{!../../docs_src/query_params_str_validations/tutorial011.py!}
```
Então, com uma URL assim:
@@ -202,7 +202,7 @@ A documentação interativa da API irá atualizar de acordo, permitindo múltipl
E você também pode definir uma lista (`list`) de valores padrão caso nenhum seja informado:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial012.py!}
+{!../../docs_src/query_params_str_validations/tutorial012.py!}
```
Se você for até:
@@ -227,7 +227,7 @@ O valor padrão de `q` será: `["foo", "bar"]` e sua resposta será:
Você também pode utilizar o tipo `list` diretamente em vez de `List[str]`:
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial013.py!}
+{!../../docs_src/query_params_str_validations/tutorial013.py!}
```
/// note | "Observação"
@@ -255,13 +255,13 @@ Algumas delas não exibem todas as informações extras que declaramos, ainda qu
Você pode adicionar um `title`:
```Python hl_lines="10"
-{!../../../docs_src/query_params_str_validations/tutorial007.py!}
+{!../../docs_src/query_params_str_validations/tutorial007.py!}
```
E uma `description`:
```Python hl_lines="13"
-{!../../../docs_src/query_params_str_validations/tutorial008.py!}
+{!../../docs_src/query_params_str_validations/tutorial008.py!}
```
## Apelidos (alias) de parâmetros
@@ -283,7 +283,7 @@ Mas ainda você precisa que o nome seja exatamente `item-query`...
Então você pode declarar um `alias`, e esse apelido (alias) que será utilizado para encontrar o valor do parâmetro:
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial009.py!}
+{!../../docs_src/query_params_str_validations/tutorial009.py!}
```
## Parâmetros descontinuados
@@ -295,7 +295,7 @@ Você tem que deixá-lo ativo por um tempo, já que existem clientes o utilizand
Então você passa o parâmetro `deprecated=True` para `Query`:
```Python hl_lines="18"
-{!../../../docs_src/query_params_str_validations/tutorial010.py!}
+{!../../docs_src/query_params_str_validations/tutorial010.py!}
```
Na documentação aparecerá assim:
diff --git a/docs/pt/docs/tutorial/query-params.md b/docs/pt/docs/tutorial/query-params.md
index 78d54f09b..6e6699cd5 100644
--- a/docs/pt/docs/tutorial/query-params.md
+++ b/docs/pt/docs/tutorial/query-params.md
@@ -3,7 +3,7 @@
Quando você declara outros parâmetros na função que não fazem parte dos parâmetros da rota, esses parâmetros são automaticamente interpretados como parâmetros de "consulta".
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial001.py!}
+{!../../docs_src/query_params/tutorial001.py!}
```
A consulta é o conjunto de pares chave-valor que vai depois de `?` na URL, separado pelo caractere `&`.
@@ -66,7 +66,7 @@ Da mesma forma, você pode declarar parâmetros de consulta opcionais, definindo
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial002_py310.py!}
+{!> ../../docs_src/query_params/tutorial002_py310.py!}
```
////
@@ -74,7 +74,7 @@ Da mesma forma, você pode declarar parâmetros de consulta opcionais, definindo
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial002.py!}
+{!> ../../docs_src/query_params/tutorial002.py!}
```
////
@@ -94,7 +94,7 @@ Você também pode declarar tipos `bool`, e eles serão convertidos:
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial003_py310.py!}
+{!> ../../docs_src/query_params/tutorial003_py310.py!}
```
////
@@ -102,7 +102,7 @@ Você também pode declarar tipos `bool`, e eles serão convertidos:
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial003.py!}
+{!> ../../docs_src/query_params/tutorial003.py!}
```
////
@@ -150,7 +150,7 @@ Eles serão detectados pelo nome:
//// tab | Python 3.10+
```Python hl_lines="6 8"
-{!> ../../../docs_src/query_params/tutorial004_py310.py!}
+{!> ../../docs_src/query_params/tutorial004_py310.py!}
```
////
@@ -158,7 +158,7 @@ Eles serão detectados pelo nome:
//// tab | Python 3.8+
```Python hl_lines="8 10"
-{!> ../../../docs_src/query_params/tutorial004.py!}
+{!> ../../docs_src/query_params/tutorial004.py!}
```
////
@@ -172,7 +172,7 @@ Caso você não queira adicionar um valor específico mas queira apenas torná-l
Porém, quando você quiser fazer com que o parâmetro de consulta seja obrigatório, você pode simplesmente não declarar nenhum valor como padrão.
```Python hl_lines="6-7"
-{!../../../docs_src/query_params/tutorial005.py!}
+{!../../docs_src/query_params/tutorial005.py!}
```
Aqui o parâmetro de consulta `needy` é um valor obrigatório, do tipo `str`.
@@ -220,7 +220,7 @@ E claro, você pode definir alguns parâmetros como obrigatórios, alguns possui
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params/tutorial006_py310.py!}
+{!> ../../docs_src/query_params/tutorial006_py310.py!}
```
////
@@ -228,7 +228,7 @@ E claro, você pode definir alguns parâmetros como obrigatórios, alguns possui
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params/tutorial006.py!}
+{!> ../../docs_src/query_params/tutorial006.py!}
```
////
diff --git a/docs/pt/docs/tutorial/request-form-models.md b/docs/pt/docs/tutorial/request-form-models.md
index a9db18e9d..837e24c34 100644
--- a/docs/pt/docs/tutorial/request-form-models.md
+++ b/docs/pt/docs/tutorial/request-form-models.md
@@ -27,7 +27,7 @@ Você precisa apenas declarar um **modelo Pydantic** com os campos que deseja re
//// tab | Python 3.9+
```Python hl_lines="9-11 15"
-{!> ../../../docs_src/request_form_models/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_form_models/tutorial001_an_py39.py!}
```
////
@@ -35,7 +35,7 @@ Você precisa apenas declarar um **modelo Pydantic** com os campos que deseja re
//// tab | Python 3.8+
```Python hl_lines="8-10 14"
-{!> ../../../docs_src/request_form_models/tutorial001_an.py!}
+{!> ../../docs_src/request_form_models/tutorial001_an.py!}
```
////
@@ -49,7 +49,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="7-9 13"
-{!> ../../../docs_src/request_form_models/tutorial001.py!}
+{!> ../../docs_src/request_form_models/tutorial001.py!}
```
////
@@ -79,7 +79,7 @@ Você pode utilizar a configuração de modelo do Pydantic para `proibir` qualqu
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/request_form_models/tutorial002_an_py39.py!}
+{!> ../../docs_src/request_form_models/tutorial002_an_py39.py!}
```
////
@@ -87,7 +87,7 @@ Você pode utilizar a configuração de modelo do Pydantic para `proibir` qualqu
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/request_form_models/tutorial002_an.py!}
+{!> ../../docs_src/request_form_models/tutorial002_an.py!}
```
////
@@ -101,7 +101,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="10"
-{!> ../../../docs_src/request_form_models/tutorial002.py!}
+{!> ../../docs_src/request_form_models/tutorial002.py!}
```
////
diff --git a/docs/pt/docs/tutorial/request-forms-and-files.md b/docs/pt/docs/tutorial/request-forms-and-files.md
index 2cf406386..29488b4f2 100644
--- a/docs/pt/docs/tutorial/request-forms-and-files.md
+++ b/docs/pt/docs/tutorial/request-forms-and-files.md
@@ -13,7 +13,7 @@ Por exemplo: `pip install python-multipart`.
## Importe `File` e `Form`
```Python hl_lines="1"
-{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!../../docs_src/request_forms_and_files/tutorial001.py!}
```
## Defina parâmetros de `File` e `Form`
@@ -21,7 +21,7 @@ Por exemplo: `pip install python-multipart`.
Crie parâmetros de arquivo e formulário da mesma forma que você faria para `Body` ou `Query`:
```Python hl_lines="8"
-{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!../../docs_src/request_forms_and_files/tutorial001.py!}
```
Os arquivos e campos de formulário serão carregados como dados de formulário e você receberá os arquivos e campos de formulário.
diff --git a/docs/pt/docs/tutorial/request-forms.md b/docs/pt/docs/tutorial/request-forms.md
index fc8c7bbad..1e2faf269 100644
--- a/docs/pt/docs/tutorial/request-forms.md
+++ b/docs/pt/docs/tutorial/request-forms.md
@@ -15,7 +15,7 @@ Ex: `pip install python-multipart`.
Importe `Form` de `fastapi`:
```Python hl_lines="1"
-{!../../../docs_src/request_forms/tutorial001.py!}
+{!../../docs_src/request_forms/tutorial001.py!}
```
## Declare parâmetros de `Form`
@@ -23,7 +23,7 @@ Importe `Form` de `fastapi`:
Crie parâmetros de formulário da mesma forma que você faria para `Body` ou `Query`:
```Python hl_lines="7"
-{!../../../docs_src/request_forms/tutorial001.py!}
+{!../../docs_src/request_forms/tutorial001.py!}
```
Por exemplo, em uma das maneiras que a especificação OAuth2 pode ser usada (chamada "fluxo de senha"), é necessário enviar um `username` e uma `password` como campos do formulário.
diff --git a/docs/pt/docs/tutorial/request_files.md b/docs/pt/docs/tutorial/request_files.md
index 60e4ecb26..39bfe284a 100644
--- a/docs/pt/docs/tutorial/request_files.md
+++ b/docs/pt/docs/tutorial/request_files.md
@@ -19,7 +19,7 @@ Importe `File` e `UploadFile` do `fastapi`:
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
```
////
@@ -27,7 +27,7 @@ Importe `File` e `UploadFile` do `fastapi`:
//// tab | Python 3.8+
```Python hl_lines="1"
-{!> ../../../docs_src/request_files/tutorial001_an.py!}
+{!> ../../docs_src/request_files/tutorial001_an.py!}
```
////
@@ -41,7 +41,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="1"
-{!> ../../../docs_src/request_files/tutorial001.py!}
+{!> ../../docs_src/request_files/tutorial001.py!}
```
////
@@ -53,7 +53,7 @@ Cria os parâmetros do arquivo da mesma forma que você faria para `Body` ou `Fo
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
```
////
@@ -61,7 +61,7 @@ Cria os parâmetros do arquivo da mesma forma que você faria para `Body` ou `Fo
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/request_files/tutorial001_an.py!}
+{!> ../../docs_src/request_files/tutorial001_an.py!}
```
////
@@ -75,7 +75,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="7"
-{!> ../../../docs_src/request_files/tutorial001.py!}
+{!> ../../docs_src/request_files/tutorial001.py!}
```
////
@@ -109,7 +109,7 @@ Defina um parâmetro de arquivo com o tipo `UploadFile`
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
```
////
@@ -117,7 +117,7 @@ Defina um parâmetro de arquivo com o tipo `UploadFile`
//// tab | Python 3.8+
```Python hl_lines="13"
-{!> ../../../docs_src/request_files/tutorial001_an.py!}
+{!> ../../docs_src/request_files/tutorial001_an.py!}
```
////
@@ -131,7 +131,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="12"
-{!> ../../../docs_src/request_files/tutorial001.py!}
+{!> ../../docs_src/request_files/tutorial001.py!}
```
////
@@ -220,7 +220,7 @@ Você pode definir um arquivo como opcional utilizando as anotações de tipo pa
//// tab | Python 3.10+
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02_an_py310.py!}
+{!> ../../docs_src/request_files/tutorial001_02_an_py310.py!}
```
////
@@ -228,7 +228,7 @@ Você pode definir um arquivo como opcional utilizando as anotações de tipo pa
//// tab | Python 3.9+
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_02_an_py39.py!}
```
////
@@ -236,7 +236,7 @@ Você pode definir um arquivo como opcional utilizando as anotações de tipo pa
//// tab | Python 3.8+
```Python hl_lines="10 18"
-{!> ../../../docs_src/request_files/tutorial001_02_an.py!}
+{!> ../../docs_src/request_files/tutorial001_02_an.py!}
```
////
@@ -250,7 +250,7 @@ Utilize a versão com `Annotated`, se possível
///
```Python hl_lines="7 15"
-{!> ../../../docs_src/request_files/tutorial001_02_py310.py!}
+{!> ../../docs_src/request_files/tutorial001_02_py310.py!}
```
////
@@ -264,7 +264,7 @@ Utilize a versão com `Annotated`, se possível
///
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02.py!}
+{!> ../../docs_src/request_files/tutorial001_02.py!}
```
////
@@ -276,7 +276,7 @@ Você também pode utilizar `File()` com `UploadFile`, por exemplo, para definir
//// tab | Python 3.9+
```Python hl_lines="9 15"
-{!> ../../../docs_src/request_files/tutorial001_03_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_03_an_py39.py!}
```
////
@@ -284,7 +284,7 @@ Você também pode utilizar `File()` com `UploadFile`, por exemplo, para definir
//// tab | Python 3.8+
```Python hl_lines="8 14"
-{!> ../../../docs_src/request_files/tutorial001_03_an.py!}
+{!> ../../docs_src/request_files/tutorial001_03_an.py!}
```
////
@@ -298,7 +298,7 @@ Utilize a versão com `Annotated` se possível
///
```Python hl_lines="7 13"
-{!> ../../../docs_src/request_files/tutorial001_03.py!}
+{!> ../../docs_src/request_files/tutorial001_03.py!}
```
////
@@ -314,7 +314,7 @@ Para usar isso, declare uma lista de `bytes` ou `UploadFile`:
//// tab | Python 3.9+
```Python hl_lines="10 15"
-{!> ../../../docs_src/request_files/tutorial002_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial002_an_py39.py!}
```
////
@@ -322,7 +322,7 @@ Para usar isso, declare uma lista de `bytes` ou `UploadFile`:
//// tab | Python 3.8+
```Python hl_lines="11 16"
-{!> ../../../docs_src/request_files/tutorial002_an.py!}
+{!> ../../docs_src/request_files/tutorial002_an.py!}
```
////
@@ -336,7 +336,7 @@ Utilize a versão com `Annotated` se possível
///
```Python hl_lines="8 13"
-{!> ../../../docs_src/request_files/tutorial002_py39.py!}
+{!> ../../docs_src/request_files/tutorial002_py39.py!}
```
////
@@ -350,7 +350,7 @@ Utilize a versão com `Annotated` se possível
///
```Python hl_lines="10 15"
-{!> ../../../docs_src/request_files/tutorial002.py!}
+{!> ../../docs_src/request_files/tutorial002.py!}
```
////
@@ -372,7 +372,7 @@ E da mesma forma que antes, você pode utilizar `File()` para definir parâmetro
//// tab | Python 3.9+
```Python hl_lines="11 18-20"
-{!> ../../../docs_src/request_files/tutorial003_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial003_an_py39.py!}
```
////
@@ -380,7 +380,7 @@ E da mesma forma que antes, você pode utilizar `File()` para definir parâmetro
//// tab | Python 3.8+
```Python hl_lines="12 19-21"
-{!> ../../../docs_src/request_files/tutorial003_an.py!}
+{!> ../../docs_src/request_files/tutorial003_an.py!}
```
////
@@ -394,7 +394,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="9 16"
-{!> ../../../docs_src/request_files/tutorial003_py39.py!}
+{!> ../../docs_src/request_files/tutorial003_py39.py!}
```
////
@@ -408,7 +408,7 @@ Utilize a versão com `Annotated` se possível.
///
```Python hl_lines="11 18"
-{!> ../../../docs_src/request_files/tutorial003.py!}
+{!> ../../docs_src/request_files/tutorial003.py!}
```
////
diff --git a/docs/pt/docs/tutorial/response-status-code.md b/docs/pt/docs/tutorial/response-status-code.md
index dc8e12048..bc4a2cd34 100644
--- a/docs/pt/docs/tutorial/response-status-code.md
+++ b/docs/pt/docs/tutorial/response-status-code.md
@@ -9,7 +9,7 @@ Da mesma forma que você pode especificar um modelo de resposta, você também p
* etc.
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
/// note | "Nota"
@@ -78,7 +78,7 @@ Para saber mais sobre cada código de status e qual código serve para quê, ver
Vamos ver o exemplo anterior novamente:
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
`201` é o código de status para "Criado".
@@ -88,7 +88,7 @@ Mas você não precisa memorizar o que cada um desses códigos significa.
Você pode usar as variáveis de conveniência de `fastapi.status`.
```Python hl_lines="1 6"
-{!../../../docs_src/response_status_code/tutorial002.py!}
+{!../../docs_src/response_status_code/tutorial002.py!}
```
Eles são apenas uma conveniência, eles possuem o mesmo número, mas dessa forma você pode usar o autocomplete do editor para encontrá-los:
diff --git a/docs/pt/docs/tutorial/schema-extra-example.md b/docs/pt/docs/tutorial/schema-extra-example.md
index a291db045..2d78e4ef1 100644
--- a/docs/pt/docs/tutorial/schema-extra-example.md
+++ b/docs/pt/docs/tutorial/schema-extra-example.md
@@ -9,7 +9,7 @@ Aqui estão várias formas de se fazer isso.
Você pode declarar um `example` para um modelo Pydantic usando `Config` e `schema_extra`, conforme descrito em <a href="https://docs.pydantic.dev/latest/concepts/json_schema/#schema-customization" class="external-link" target="_blank">Documentação do Pydantic: Schema customization</a>:
```Python hl_lines="15-23"
-{!../../../docs_src/schema_extra_example/tutorial001.py!}
+{!../../docs_src/schema_extra_example/tutorial001.py!}
```
Essas informações extras serão adicionadas como se encontram no **JSON Schema** de resposta desse modelo e serão usadas na documentação da API.
@@ -29,7 +29,7 @@ Ao usar `Field ()` com modelos Pydantic, você também pode declarar informaçõ
Você pode usar isso para adicionar um `example` para cada campo:
```Python hl_lines="4 10-13"
-{!../../../docs_src/schema_extra_example/tutorial002.py!}
+{!../../docs_src/schema_extra_example/tutorial002.py!}
```
/// warning | "Atenção"
@@ -57,7 +57,7 @@ você também pode declarar um dado `example` ou um grupo de `examples` com info
Aqui nós passamos um `example` dos dados esperados por `Body()`:
```Python hl_lines="21-26"
-{!../../../docs_src/schema_extra_example/tutorial003.py!}
+{!../../docs_src/schema_extra_example/tutorial003.py!}
```
### Exemplo na UI da documentação
@@ -80,7 +80,7 @@ Cada `dict` de exemplo específico em `examples` pode conter:
* `externalValue`: alternativa ao `value`, uma URL apontando para o exemplo. Embora isso possa não ser suportado por tantas ferramentas quanto `value`.
```Python hl_lines="22-48"
-{!../../../docs_src/schema_extra_example/tutorial004.py!}
+{!../../docs_src/schema_extra_example/tutorial004.py!}
```
### Exemplos na UI da documentação
diff --git a/docs/pt/docs/tutorial/security/first-steps.md b/docs/pt/docs/tutorial/security/first-steps.md
index 007fefcb9..9fb94fe67 100644
--- a/docs/pt/docs/tutorial/security/first-steps.md
+++ b/docs/pt/docs/tutorial/security/first-steps.md
@@ -20,7 +20,7 @@ Vamos primeiro usar o código e ver como funciona, e depois voltaremos para ente
Copie o exemplo em um arquivo `main.py`:
```Python
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
## Execute-o
@@ -136,7 +136,7 @@ Neste exemplo, nós vamos usar o **OAuth2** com o fluxo de **Senha**, usando um
Quando nós criamos uma instância da classe `OAuth2PasswordBearer`, nós passamos pelo parâmetro `tokenUrl` Esse parâmetro contém a URL que o client (o frontend rodando no browser do usuário) vai usar para mandar o `username` e `senha` para obter um token.
```Python hl_lines="6"
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
/// tip | "Dica"
@@ -180,7 +180,7 @@ Então, pode ser usado com `Depends`.
Agora você pode passar aquele `oauth2_scheme` em uma dependência com `Depends`.
```Python hl_lines="10"
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
Esse dependência vai fornecer uma `str` que é atribuído ao parâmetro `token da *função do path operation*
diff --git a/docs/pt/docs/tutorial/static-files.md b/docs/pt/docs/tutorial/static-files.md
index efaf07dfb..901fca1d2 100644
--- a/docs/pt/docs/tutorial/static-files.md
+++ b/docs/pt/docs/tutorial/static-files.md
@@ -8,7 +8,7 @@ Você pode servir arquivos estáticos automaticamente de um diretório usando `S
* "Monte" uma instância de `StaticFiles()` em um caminho específico.
```Python hl_lines="2 6"
-{!../../../docs_src/static_files/tutorial001.py!}
+{!../../docs_src/static_files/tutorial001.py!}
```
/// note | "Detalhes técnicos"
diff --git a/docs/pt/docs/tutorial/testing.md b/docs/pt/docs/tutorial/testing.md
index f734a7d9a..4e28a43c0 100644
--- a/docs/pt/docs/tutorial/testing.md
+++ b/docs/pt/docs/tutorial/testing.md
@@ -31,7 +31,7 @@ Use o objeto `TestClient` da mesma forma que você faz com `httpx`.
Escreva instruções `assert` simples com as expressões Python padrão que você precisa verificar (novamente, `pytest` padrão).
```Python hl_lines="2 12 15-18"
-{!../../../docs_src/app_testing/tutorial001.py!}
+{!../../docs_src/app_testing/tutorial001.py!}
```
/// tip | "Dica"
@@ -79,7 +79,7 @@ No arquivo `main.py` você tem seu aplicativo **FastAPI**:
```Python
-{!../../../docs_src/app_testing/main.py!}
+{!../../docs_src/app_testing/main.py!}
```
### Arquivo de teste
@@ -97,7 +97,7 @@ Então você poderia ter um arquivo `test_main.py` com seus testes. Ele poderia
Como esse arquivo está no mesmo pacote, você pode usar importações relativas para importar o objeto `app` do módulo `main` (`main.py`):
```Python hl_lines="3"
-{!../../../docs_src/app_testing/test_main.py!}
+{!../../docs_src/app_testing/test_main.py!}
```
...e ter o código para os testes como antes.
@@ -129,7 +129,7 @@ Ambas as *operações de rotas* requerem um cabeçalho `X-Token`.
//// tab | Python 3.10+
```Python
-{!> ../../../docs_src/app_testing/app_b_an_py310/main.py!}
+{!> ../../docs_src/app_testing/app_b_an_py310/main.py!}
```
////
@@ -137,7 +137,7 @@ Ambas as *operações de rotas* requerem um cabeçalho `X-Token`.
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/app_testing/app_b_an_py39/main.py!}
+{!> ../../docs_src/app_testing/app_b_an_py39/main.py!}
```
////
@@ -145,7 +145,7 @@ Ambas as *operações de rotas* requerem um cabeçalho `X-Token`.
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/app_testing/app_b_an/main.py!}
+{!> ../../docs_src/app_testing/app_b_an/main.py!}
```
////
@@ -159,7 +159,7 @@ Prefira usar a versão `Annotated` se possível.
///
```Python
-{!> ../../../docs_src/app_testing/app_b_py310/main.py!}
+{!> ../../docs_src/app_testing/app_b_py310/main.py!}
```
////
@@ -173,7 +173,7 @@ Prefira usar a versão `Annotated` se possível.
///
```Python
-{!> ../../../docs_src/app_testing/app_b/main.py!}
+{!> ../../docs_src/app_testing/app_b/main.py!}
```
////
@@ -183,7 +183,7 @@ Prefira usar a versão `Annotated` se possível.
Você pode então atualizar `test_main.py` com os testes estendidos:
```Python
-{!> ../../../docs_src/app_testing/app_b/test_main.py!}
+{!> ../../docs_src/app_testing/app_b/test_main.py!}
```
Sempre que você precisar que o cliente passe informações na requisição e não souber como, você pode pesquisar (no Google) como fazer isso no `httpx`, ou até mesmo como fazer isso com `requests`, já que o design do HTTPX é baseado no design do Requests.
diff --git a/docs/ru/docs/python-types.md b/docs/ru/docs/python-types.md
index c052bc675..e5905304a 100644
--- a/docs/ru/docs/python-types.md
+++ b/docs/ru/docs/python-types.md
@@ -23,7 +23,7 @@ Python имеет поддержку необязательных аннотац
Давайте начнем с простого примера:
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
Вызов этой программы выводит:
@@ -39,7 +39,7 @@ John Doe
* <abbr title="Объединяет в одно целое, последовательно, друг за другом.">Соединяет</abbr> их через пробел.
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### Отредактируем пример
@@ -83,7 +83,7 @@ John Doe
Это аннотации типов:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
Это не то же самое, что объявление значений по умолчанию, например:
@@ -113,7 +113,7 @@ John Doe
Проверьте эту функцию, она уже имеет аннотации типов:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
Поскольку редактор знает типы переменных, вы получаете не только дополнение, но и проверки ошибок:
@@ -123,7 +123,7 @@ John Doe
Теперь вы знаете, что вам нужно исправить, преобразовав `age` в строку с `str(age)`:
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## Объявление типов
@@ -144,7 +144,7 @@ John Doe
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### Generic-типы с параметрами типов
@@ -162,7 +162,7 @@ John Doe
Импортируйте `List` из `typing` (с заглавной `L`):
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
Объявите переменную с тем же синтаксисом двоеточия (`:`).
@@ -172,7 +172,7 @@ John Doe
Поскольку список является типом, содержащим некоторые внутренние типы, вы помещаете их в квадратные скобки:
```Python hl_lines="4"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
/// tip
@@ -200,7 +200,7 @@ John Doe
Вы бы сделали то же самое, чтобы объявить `tuple` и `set`:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial007.py!}
+{!../../docs_src/python_types/tutorial007.py!}
```
Это означает:
@@ -217,7 +217,7 @@ John Doe
Второй параметр типа предназначен для значений `dict`:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial008.py!}
+{!../../docs_src/python_types/tutorial008.py!}
```
Это означает:
@@ -231,7 +231,7 @@ John Doe
Вы также можете использовать `Optional`, чтобы объявить, что переменная имеет тип, например, `str`, но это является «необязательным», что означает, что она также может быть `None`:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
Использование `Optional[str]` вместо просто `str` позволит редактору помочь вам в обнаружении ошибок, в которых вы могли бы предположить, что значение всегда является `str`, хотя на самом деле это может быть и `None`.
@@ -256,13 +256,13 @@ John Doe
Допустим, у вас есть класс `Person` с полем `name`:
```Python hl_lines="1-3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Тогда вы можете объявить переменную типа `Person`:
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
И снова вы получаете полную поддержку редактора:
@@ -284,7 +284,7 @@ John Doe
Взято из официальной документации Pydantic:
```Python
-{!../../../docs_src/python_types/tutorial011.py!}
+{!../../docs_src/python_types/tutorial011.py!}
```
/// info
diff --git a/docs/ru/docs/tutorial/background-tasks.md b/docs/ru/docs/tutorial/background-tasks.md
index 073276848..0f6ce0eb3 100644
--- a/docs/ru/docs/tutorial/background-tasks.md
+++ b/docs/ru/docs/tutorial/background-tasks.md
@@ -16,7 +16,7 @@
Сначала импортируйте `BackgroundTasks`, потом добавьте в функцию параметр с типом `BackgroundTasks`:
```Python hl_lines="1 13"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
**FastAPI** создаст объект класса `BackgroundTasks` для вас и запишет его в параметр.
@@ -34,7 +34,7 @@
Так как операция записи не использует `async` и `await`, мы определим ее как обычную `def`:
```Python hl_lines="6-9"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
## Добавление фоновой задачи
@@ -42,7 +42,7 @@
Внутри функции вызовите метод `.add_task()` у объекта *background tasks* и передайте ему функцию, которую хотите выполнить в фоне:
```Python hl_lines="14"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
`.add_task()` принимает следующие аргументы:
@@ -60,7 +60,7 @@
//// tab | Python 3.10+
```Python hl_lines="11 13 20 23"
-{!> ../../../docs_src/background_tasks/tutorial002_py310.py!}
+{!> ../../docs_src/background_tasks/tutorial002_py310.py!}
```
////
@@ -68,7 +68,7 @@
//// tab | Python 3.8+
```Python hl_lines="13 15 22 25"
-{!> ../../../docs_src/background_tasks/tutorial002.py!}
+{!> ../../docs_src/background_tasks/tutorial002.py!}
```
////
diff --git a/docs/ru/docs/tutorial/body-fields.md b/docs/ru/docs/tutorial/body-fields.md
index f4db0e9ff..f3b2c6113 100644
--- a/docs/ru/docs/tutorial/body-fields.md
+++ b/docs/ru/docs/tutorial/body-fields.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="2"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.8+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
@@ -35,7 +35,7 @@
//// tab | Python 3.10+
```Python hl_lines="9-12"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
@@ -43,7 +43,7 @@
//// tab | Python 3.8+
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
diff --git a/docs/ru/docs/tutorial/body-multiple-params.md b/docs/ru/docs/tutorial/body-multiple-params.md
index 107e6293b..53965f0ec 100644
--- a/docs/ru/docs/tutorial/body-multiple-params.md
+++ b/docs/ru/docs/tutorial/body-multiple-params.md
@@ -11,7 +11,7 @@
//// tab | Python 3.10+
```Python hl_lines="18-20"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
```
////
@@ -19,7 +19,7 @@
//// tab | Python 3.9+
```Python hl_lines="18-20"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
```
////
@@ -27,7 +27,7 @@
//// tab | Python 3.8+
```Python hl_lines="19-21"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an.py!}
```
////
@@ -41,7 +41,7 @@
///
```Python hl_lines="17-19"
-{!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_py310.py!}
```
////
@@ -55,7 +55,7 @@
///
```Python hl_lines="19-21"
-{!> ../../../docs_src/body_multiple_params/tutorial001.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001.py!}
```
////
@@ -84,7 +84,7 @@
//// tab | Python 3.10+
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002_py310.py!}
```
////
@@ -92,7 +92,7 @@
//// tab | Python 3.8+
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial002.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002.py!}
```
////
@@ -139,7 +139,7 @@
//// tab | Python 3.10+
```Python hl_lines="23"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
```
////
@@ -147,7 +147,7 @@
//// tab | Python 3.9+
```Python hl_lines="23"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
```
////
@@ -155,7 +155,7 @@
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an.py!}
```
////
@@ -169,7 +169,7 @@
///
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_py310.py!}
```
////
@@ -183,7 +183,7 @@
///
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial003.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003.py!}
```
////
@@ -229,7 +229,7 @@ q: str | None = None
//// tab | Python 3.10+
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
```
////
@@ -237,7 +237,7 @@ q: str | None = None
//// tab | Python 3.9+
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
```
////
@@ -245,7 +245,7 @@ q: str | None = None
//// tab | Python 3.8+
```Python hl_lines="28"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an.py!}
```
////
@@ -259,7 +259,7 @@ q: str | None = None
///
```Python hl_lines="25"
-{!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_py310.py!}
```
////
@@ -273,7 +273,7 @@ q: str | None = None
///
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004.py!}
```
////
@@ -301,7 +301,7 @@ item: Item = Body(embed=True)
//// tab | Python 3.10+
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
```
////
@@ -309,7 +309,7 @@ item: Item = Body(embed=True)
//// tab | Python 3.9+
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
```
////
@@ -317,7 +317,7 @@ item: Item = Body(embed=True)
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an.py!}
```
////
@@ -331,7 +331,7 @@ item: Item = Body(embed=True)
///
```Python hl_lines="15"
-{!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_py310.py!}
```
////
@@ -345,7 +345,7 @@ item: Item = Body(embed=True)
///
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005.py!}
```
////
diff --git a/docs/ru/docs/tutorial/body-nested-models.md b/docs/ru/docs/tutorial/body-nested-models.md
index ecb8b92a7..780946725 100644
--- a/docs/ru/docs/tutorial/body-nested-models.md
+++ b/docs/ru/docs/tutorial/body-nested-models.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial001_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial001_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.8+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial001.py!}
+{!> ../../docs_src/body_nested_models/tutorial001.py!}
```
////
@@ -35,7 +35,7 @@
Но в версиях Python до 3.9 (начиная с 3.6) сначала вам необходимо импортировать `List` из стандартного модуля `typing` в Python:
```Python hl_lines="1"
-{!> ../../../docs_src/body_nested_models/tutorial002.py!}
+{!> ../../docs_src/body_nested_models/tutorial002.py!}
```
### Объявление `list` с указанием типов для вложенных элементов
@@ -68,7 +68,7 @@ my_list: List[str]
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial002_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial002_py310.py!}
```
////
@@ -76,7 +76,7 @@ my_list: List[str]
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial002_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial002_py39.py!}
```
////
@@ -84,7 +84,7 @@ my_list: List[str]
//// tab | Python 3.8+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial002.py!}
+{!> ../../docs_src/body_nested_models/tutorial002.py!}
```
////
@@ -100,7 +100,7 @@ my_list: List[str]
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial003_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial003_py310.py!}
```
////
@@ -108,7 +108,7 @@ my_list: List[str]
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial003_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial003_py39.py!}
```
////
@@ -116,7 +116,7 @@ my_list: List[str]
//// tab | Python 3.8+
```Python hl_lines="1 14"
-{!> ../../../docs_src/body_nested_models/tutorial003.py!}
+{!> ../../docs_src/body_nested_models/tutorial003.py!}
```
////
@@ -144,7 +144,7 @@ my_list: List[str]
//// tab | Python 3.10+
```Python hl_lines="7-9"
-{!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py310.py!}
```
////
@@ -152,7 +152,7 @@ my_list: List[str]
//// tab | Python 3.9+
```Python hl_lines="9-11"
-{!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py39.py!}
```
////
@@ -160,7 +160,7 @@ my_list: List[str]
//// tab | Python 3.8+
```Python hl_lines="9-11"
-{!> ../../../docs_src/body_nested_models/tutorial004.py!}
+{!> ../../docs_src/body_nested_models/tutorial004.py!}
```
////
@@ -172,7 +172,7 @@ my_list: List[str]
//// tab | Python 3.10+
```Python hl_lines="18"
-{!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py310.py!}
```
////
@@ -180,7 +180,7 @@ my_list: List[str]
//// tab | Python 3.9+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py39.py!}
```
////
@@ -188,7 +188,7 @@ my_list: List[str]
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial004.py!}
+{!> ../../docs_src/body_nested_models/tutorial004.py!}
```
////
@@ -227,7 +227,7 @@ my_list: List[str]
//// tab | Python 3.10+
```Python hl_lines="2 8"
-{!> ../../../docs_src/body_nested_models/tutorial005_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial005_py310.py!}
```
////
@@ -235,7 +235,7 @@ my_list: List[str]
//// tab | Python 3.9+
```Python hl_lines="4 10"
-{!> ../../../docs_src/body_nested_models/tutorial005_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial005_py39.py!}
```
////
@@ -243,7 +243,7 @@ my_list: List[str]
//// tab | Python 3.8+
```Python hl_lines="4 10"
-{!> ../../../docs_src/body_nested_models/tutorial005.py!}
+{!> ../../docs_src/body_nested_models/tutorial005.py!}
```
////
@@ -257,7 +257,7 @@ my_list: List[str]
//// tab | Python 3.10+
```Python hl_lines="18"
-{!> ../../../docs_src/body_nested_models/tutorial006_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial006_py310.py!}
```
////
@@ -265,7 +265,7 @@ my_list: List[str]
//// tab | Python 3.9+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial006_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial006_py39.py!}
```
////
@@ -273,7 +273,7 @@ my_list: List[str]
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial006.py!}
+{!> ../../docs_src/body_nested_models/tutorial006.py!}
```
////
@@ -317,7 +317,7 @@ my_list: List[str]
//// tab | Python 3.10+
```Python hl_lines="7 12 18 21 25"
-{!> ../../../docs_src/body_nested_models/tutorial007_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial007_py310.py!}
```
////
@@ -325,7 +325,7 @@ my_list: List[str]
//// tab | Python 3.9+
```Python hl_lines="9 14 20 23 27"
-{!> ../../../docs_src/body_nested_models/tutorial007_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial007_py39.py!}
```
////
@@ -333,7 +333,7 @@ my_list: List[str]
//// tab | Python 3.8+
```Python hl_lines="9 14 20 23 27"
-{!> ../../../docs_src/body_nested_models/tutorial007.py!}
+{!> ../../docs_src/body_nested_models/tutorial007.py!}
```
////
@@ -363,7 +363,7 @@ images: list[Image]
//// tab | Python 3.9+
```Python hl_lines="13"
-{!> ../../../docs_src/body_nested_models/tutorial008_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial008_py39.py!}
```
////
@@ -371,7 +371,7 @@ images: list[Image]
//// tab | Python 3.8+
```Python hl_lines="15"
-{!> ../../../docs_src/body_nested_models/tutorial008.py!}
+{!> ../../docs_src/body_nested_models/tutorial008.py!}
```
////
@@ -407,7 +407,7 @@ images: list[Image]
//// tab | Python 3.9+
```Python hl_lines="7"
-{!> ../../../docs_src/body_nested_models/tutorial009_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial009_py39.py!}
```
////
@@ -415,7 +415,7 @@ images: list[Image]
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/body_nested_models/tutorial009.py!}
+{!> ../../docs_src/body_nested_models/tutorial009.py!}
```
////
diff --git a/docs/ru/docs/tutorial/body-updates.md b/docs/ru/docs/tutorial/body-updates.md
index c458329d8..3ecfe52f4 100644
--- a/docs/ru/docs/tutorial/body-updates.md
+++ b/docs/ru/docs/tutorial/body-updates.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="28-33"
-{!> ../../../docs_src/body_updates/tutorial001_py310.py!}
+{!> ../../docs_src/body_updates/tutorial001_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="30-35"
-{!> ../../../docs_src/body_updates/tutorial001_py39.py!}
+{!> ../../docs_src/body_updates/tutorial001_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.6+
```Python hl_lines="30-35"
-{!> ../../../docs_src/body_updates/tutorial001.py!}
+{!> ../../docs_src/body_updates/tutorial001.py!}
```
////
@@ -77,7 +77,7 @@
//// tab | Python 3.10+
```Python hl_lines="32"
-{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+{!> ../../docs_src/body_updates/tutorial002_py310.py!}
```
////
@@ -85,7 +85,7 @@
//// tab | Python 3.9+
```Python hl_lines="34"
-{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+{!> ../../docs_src/body_updates/tutorial002_py39.py!}
```
////
@@ -93,7 +93,7 @@
//// tab | Python 3.6+
```Python hl_lines="34"
-{!> ../../../docs_src/body_updates/tutorial002.py!}
+{!> ../../docs_src/body_updates/tutorial002.py!}
```
////
@@ -107,7 +107,7 @@
//// tab | Python 3.10+
```Python hl_lines="33"
-{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+{!> ../../docs_src/body_updates/tutorial002_py310.py!}
```
////
@@ -115,7 +115,7 @@
//// tab | Python 3.9+
```Python hl_lines="35"
-{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+{!> ../../docs_src/body_updates/tutorial002_py39.py!}
```
////
@@ -123,7 +123,7 @@
//// tab | Python 3.6+
```Python hl_lines="35"
-{!> ../../../docs_src/body_updates/tutorial002.py!}
+{!> ../../docs_src/body_updates/tutorial002.py!}
```
////
@@ -146,7 +146,7 @@
//// tab | Python 3.10+
```Python hl_lines="28-35"
-{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+{!> ../../docs_src/body_updates/tutorial002_py310.py!}
```
////
@@ -154,7 +154,7 @@
//// tab | Python 3.9+
```Python hl_lines="30-37"
-{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+{!> ../../docs_src/body_updates/tutorial002_py39.py!}
```
////
@@ -162,7 +162,7 @@
//// tab | Python 3.6+
```Python hl_lines="30-37"
-{!> ../../../docs_src/body_updates/tutorial002.py!}
+{!> ../../docs_src/body_updates/tutorial002.py!}
```
////
diff --git a/docs/ru/docs/tutorial/body.md b/docs/ru/docs/tutorial/body.md
index c3e6326da..91b169d07 100644
--- a/docs/ru/docs/tutorial/body.md
+++ b/docs/ru/docs/tutorial/body.md
@@ -23,7 +23,7 @@
Первое, что вам необходимо сделать, это импортировать `BaseModel` из пакета `pydantic`:
```Python hl_lines="4"
-{!../../../docs_src/body/tutorial001.py!}
+{!../../docs_src/body/tutorial001.py!}
```
## Создание вашей собственной модели
@@ -33,7 +33,7 @@
Используйте аннотации типов Python для всех атрибутов:
```Python hl_lines="7-11"
-{!../../../docs_src/body/tutorial001.py!}
+{!../../docs_src/body/tutorial001.py!}
```
Также как и при описании параметров запроса, когда атрибут модели имеет значение по умолчанию, он является необязательным. Иначе он обязателен. Используйте `None`, чтобы сделать его необязательным без использования конкретных значений по умолчанию.
@@ -63,7 +63,7 @@
Чтобы добавить параметр к вашему *обработчику*, объявите его также, как вы объявляли параметры пути или параметры запроса:
```Python hl_lines="18"
-{!../../../docs_src/body/tutorial001.py!}
+{!../../docs_src/body/tutorial001.py!}
```
...и укажите созданную модель в качестве типа параметра, `Item`.
@@ -132,7 +132,7 @@
Внутри функции вам доступны все атрибуты объекта модели напрямую:
```Python hl_lines="21"
-{!../../../docs_src/body/tutorial002.py!}
+{!../../docs_src/body/tutorial002.py!}
```
## Тело запроса + параметры пути
@@ -142,7 +142,7 @@
**FastAPI** распознает, какие параметры функции соответствуют параметрам пути и должны быть **получены из пути**, а какие параметры функции, объявленные как модели Pydantic, должны быть **получены из тела запроса**.
```Python hl_lines="17-18"
-{!../../../docs_src/body/tutorial003.py!}
+{!../../docs_src/body/tutorial003.py!}
```
## Тело запроса + параметры пути + параметры запроса
@@ -152,7 +152,7 @@
**FastAPI** распознает каждый из них и возьмет данные из правильного источника.
```Python hl_lines="18"
-{!../../../docs_src/body/tutorial004.py!}
+{!../../docs_src/body/tutorial004.py!}
```
Параметры функции распознаются следующим образом:
diff --git a/docs/ru/docs/tutorial/cookie-params.md b/docs/ru/docs/tutorial/cookie-params.md
index e88b9d7ee..2a73a5918 100644
--- a/docs/ru/docs/tutorial/cookie-params.md
+++ b/docs/ru/docs/tutorial/cookie-params.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="1"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
@@ -31,7 +31,7 @@
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -39,7 +39,7 @@
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
diff --git a/docs/ru/docs/tutorial/cors.md b/docs/ru/docs/tutorial/cors.md
index 852833208..8d415a2c1 100644
--- a/docs/ru/docs/tutorial/cors.md
+++ b/docs/ru/docs/tutorial/cors.md
@@ -47,7 +47,7 @@
* Отдельных HTTP-заголовков или всех вместе, используя `"*"`.
```Python hl_lines="2 6-11 13-19"
-{!../../../docs_src/cors/tutorial001.py!}
+{!../../docs_src/cors/tutorial001.py!}
```
`CORSMiddleware` использует для параметров "запрещающие" значения по умолчанию, поэтому вам нужно явным образом разрешить использование отдельных источников, методов или заголовков, чтобы браузеры могли использовать их в кросс-доменном контексте.
diff --git a/docs/ru/docs/tutorial/debugging.md b/docs/ru/docs/tutorial/debugging.md
index 685fb7356..606a32bfc 100644
--- a/docs/ru/docs/tutorial/debugging.md
+++ b/docs/ru/docs/tutorial/debugging.md
@@ -7,7 +7,7 @@
В вашем FastAPI приложении, импортируйте и вызовите `uvicorn` напрямую:
```Python hl_lines="1 15"
-{!../../../docs_src/debugging/tutorial001.py!}
+{!../../docs_src/debugging/tutorial001.py!}
```
### Описание `__name__ == "__main__"`
diff --git a/docs/ru/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/ru/docs/tutorial/dependencies/classes-as-dependencies.md
index d0471baca..161101bb3 100644
--- a/docs/ru/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/ru/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.6+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="7"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@
///
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -120,7 +120,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.10+
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py310.py!}
```
////
@@ -128,7 +128,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.9+
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py39.py!}
```
////
@@ -136,7 +136,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.6+
```Python hl_lines="12-16"
-{!> ../../../docs_src/dependencies/tutorial002_an.py!}
+{!> ../../docs_src/dependencies/tutorial002_an.py!}
```
////
@@ -150,7 +150,7 @@ fluffy = Cat(name="Mr Fluffy")
///
```Python hl_lines="9-13"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -164,7 +164,7 @@ fluffy = Cat(name="Mr Fluffy")
///
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -174,7 +174,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py310.py!}
```
////
@@ -182,7 +182,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py39.py!}
```
////
@@ -190,7 +190,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.6+
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial002_an.py!}
+{!> ../../docs_src/dependencies/tutorial002_an.py!}
```
////
@@ -204,7 +204,7 @@ fluffy = Cat(name="Mr Fluffy")
///
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -218,7 +218,7 @@ fluffy = Cat(name="Mr Fluffy")
///
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -228,7 +228,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -236,7 +236,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -244,7 +244,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.6+
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -258,7 +258,7 @@ fluffy = Cat(name="Mr Fluffy")
///
```Python hl_lines="6"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -272,7 +272,7 @@ fluffy = Cat(name="Mr Fluffy")
///
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -294,7 +294,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py310.py!}
```
////
@@ -302,7 +302,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial002_an_py39.py!}
```
////
@@ -310,7 +310,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.6+
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial002_an.py!}
+{!> ../../docs_src/dependencies/tutorial002_an.py!}
```
////
@@ -324,7 +324,7 @@ fluffy = Cat(name="Mr Fluffy")
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -338,7 +338,7 @@ fluffy = Cat(name="Mr Fluffy")
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -438,7 +438,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial003_an_py310.py!}
```
////
@@ -446,7 +446,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial003_an_py39.py!}
```
////
@@ -454,7 +454,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.6+
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial003_an.py!}
+{!> ../../docs_src/dependencies/tutorial003_an.py!}
```
////
@@ -468,7 +468,7 @@ commons = Depends(CommonQueryParams)
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial003_py310.py!}
+{!> ../../docs_src/dependencies/tutorial003_py310.py!}
```
////
@@ -482,7 +482,7 @@ commons = Depends(CommonQueryParams)
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003.py!}
+{!> ../../docs_src/dependencies/tutorial003.py!}
```
////
@@ -575,7 +575,7 @@ commons: CommonQueryParams = Depends()
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial004_an_py310.py!}
```
////
@@ -583,7 +583,7 @@ commons: CommonQueryParams = Depends()
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial004_an_py39.py!}
```
////
@@ -591,7 +591,7 @@ commons: CommonQueryParams = Depends()
//// tab | Python 3.6+
```Python hl_lines="20"
-{!> ../../../docs_src/dependencies/tutorial004_an.py!}
+{!> ../../docs_src/dependencies/tutorial004_an.py!}
```
////
@@ -605,7 +605,7 @@ commons: CommonQueryParams = Depends()
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial004_py310.py!}
+{!> ../../docs_src/dependencies/tutorial004_py310.py!}
```
////
@@ -619,7 +619,7 @@ commons: CommonQueryParams = Depends()
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004.py!}
+{!> ../../docs_src/dependencies/tutorial004.py!}
```
////
diff --git a/docs/ru/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/ru/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index 11df4b474..305ce46cb 100644
--- a/docs/ru/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/ru/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -75,7 +75,7 @@
//// tab | Python 3.9+
```Python hl_lines="8 13"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -83,7 +83,7 @@
//// tab | Python 3.8+
```Python hl_lines="7 12"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -97,7 +97,7 @@
///
```Python hl_lines="6 11"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -109,7 +109,7 @@
//// tab | Python 3.9+
```Python hl_lines="10 15"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -117,7 +117,7 @@
//// tab | Python 3.8+
```Python hl_lines="9 14"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -131,7 +131,7 @@
///
```Python hl_lines="8 13"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
@@ -145,7 +145,7 @@
//// tab | Python 3.9+
```Python hl_lines="11 16"
-{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial006_an_py39.py!}
```
////
@@ -153,7 +153,7 @@
//// tab | Python 3.8+
```Python hl_lines="10 15"
-{!> ../../../docs_src/dependencies/tutorial006_an.py!}
+{!> ../../docs_src/dependencies/tutorial006_an.py!}
```
////
@@ -167,7 +167,7 @@
///
```Python hl_lines="9 14"
-{!> ../../../docs_src/dependencies/tutorial006.py!}
+{!> ../../docs_src/dependencies/tutorial006.py!}
```
////
diff --git a/docs/ru/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/ru/docs/tutorial/dependencies/dependencies-with-yield.md
index ece7ef8e3..99a86e999 100644
--- a/docs/ru/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/ru/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -30,19 +30,19 @@ FastAPI поддерживает зависимости, которые выпо
Перед созданием ответа будет выполнен только код до и включая `yield`.
```Python hl_lines="2-4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
Полученное значение и есть то, что будет внедрено в функцию операции пути и другие зависимости:
```Python hl_lines="4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
Код, следующий за оператором `yield`, выполняется после доставки ответа:
```Python hl_lines="5-6"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
/// tip | "Подсказка"
@@ -64,7 +64,7 @@ FastAPI поддерживает зависимости, которые выпо
Таким же образом можно использовать `finally`, чтобы убедиться, что обязательные шаги при выходе выполнены, независимо от того, было ли исключение или нет.
```Python hl_lines="3 5"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
## Подзависимости с `yield`
@@ -78,7 +78,7 @@ FastAPI поддерживает зависимости, которые выпо
//// tab | Python 3.9+
```Python hl_lines="6 14 22"
-{!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008_an_py39.py!}
```
////
@@ -86,7 +86,7 @@ FastAPI поддерживает зависимости, которые выпо
//// tab | Python 3.6+
```Python hl_lines="5 13 21"
-{!> ../../../docs_src/dependencies/tutorial008_an.py!}
+{!> ../../docs_src/dependencies/tutorial008_an.py!}
```
////
@@ -100,7 +100,7 @@ FastAPI поддерживает зависимости, которые выпо
///
```Python hl_lines="4 12 20"
-{!> ../../../docs_src/dependencies/tutorial008.py!}
+{!> ../../docs_src/dependencies/tutorial008.py!}
```
////
@@ -114,7 +114,7 @@ FastAPI поддерживает зависимости, которые выпо
//// tab | Python 3.9+
```Python hl_lines="18-19 26-27"
-{!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008_an_py39.py!}
```
////
@@ -122,7 +122,7 @@ FastAPI поддерживает зависимости, которые выпо
//// tab | Python 3.6+
```Python hl_lines="17-18 25-26"
-{!> ../../../docs_src/dependencies/tutorial008_an.py!}
+{!> ../../docs_src/dependencies/tutorial008_an.py!}
```
////
@@ -136,7 +136,7 @@ FastAPI поддерживает зависимости, которые выпо
///
```Python hl_lines="16-17 24-25"
-{!> ../../../docs_src/dependencies/tutorial008.py!}
+{!> ../../docs_src/dependencies/tutorial008.py!}
```
////
@@ -304,7 +304,7 @@ with open("./somefile.txt") as f:
`with` или `async with` внутри функции зависимости:
```Python hl_lines="1-9 13"
-{!../../../docs_src/dependencies/tutorial010.py!}
+{!../../docs_src/dependencies/tutorial010.py!}
```
/// tip | "Подсказка"
diff --git a/docs/ru/docs/tutorial/dependencies/global-dependencies.md b/docs/ru/docs/tutorial/dependencies/global-dependencies.md
index 9e03e3723..7dbd50ae1 100644
--- a/docs/ru/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/ru/docs/tutorial/dependencies/global-dependencies.md
@@ -9,7 +9,7 @@
//// tab | Python 3.9+
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial012_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial012_an_py39.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.8+
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial012_an.py!}
+{!> ../../docs_src/dependencies/tutorial012_an.py!}
```
////
@@ -31,7 +31,7 @@
///
```Python hl_lines="15"
-{!> ../../../docs_src/dependencies/tutorial012.py!}
+{!> ../../docs_src/dependencies/tutorial012.py!}
```
////
diff --git a/docs/ru/docs/tutorial/dependencies/index.md b/docs/ru/docs/tutorial/dependencies/index.md
index b244b3fdc..fcd9f46dc 100644
--- a/docs/ru/docs/tutorial/dependencies/index.md
+++ b/docs/ru/docs/tutorial/dependencies/index.md
@@ -32,7 +32,7 @@
//// tab | Python 3.10+
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -40,7 +40,7 @@
//// tab | Python 3.9+
```Python hl_lines="8-11"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -48,7 +48,7 @@
//// tab | Python 3.8+
```Python hl_lines="9-12"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -62,7 +62,7 @@
///
```Python hl_lines="6-7"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -76,7 +76,7 @@
///
```Python hl_lines="8-11"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -114,7 +114,7 @@
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -122,7 +122,7 @@
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -130,7 +130,7 @@
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -144,7 +144,7 @@
///
```Python hl_lines="1"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -158,7 +158,7 @@
///
```Python hl_lines="3"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -170,7 +170,7 @@
//// tab | Python 3.10+
```Python hl_lines="13 18"
-{!> ../../../docs_src/dependencies/tutorial001_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
```
////
@@ -178,7 +178,7 @@
//// tab | Python 3.9+
```Python hl_lines="15 20"
-{!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
```
////
@@ -186,7 +186,7 @@
//// tab | Python 3.8+
```Python hl_lines="16 21"
-{!> ../../../docs_src/dependencies/tutorial001_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_an.py!}
```
////
@@ -200,7 +200,7 @@
///
```Python hl_lines="11 16"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -214,7 +214,7 @@
///
```Python hl_lines="15 20"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -273,7 +273,7 @@ commons: Annotated[dict, Depends(common_parameters)]
//// tab | Python 3.10+
```Python hl_lines="12 16 21"
-{!> ../../../docs_src/dependencies/tutorial001_02_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an_py310.py!}
```
////
@@ -281,7 +281,7 @@ commons: Annotated[dict, Depends(common_parameters)]
//// tab | Python 3.9+
```Python hl_lines="14 18 23"
-{!> ../../../docs_src/dependencies/tutorial001_02_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an_py39.py!}
```
////
@@ -289,7 +289,7 @@ commons: Annotated[dict, Depends(common_parameters)]
//// tab | Python 3.8+
```Python hl_lines="15 19 24"
-{!> ../../../docs_src/dependencies/tutorial001_02_an.py!}
+{!> ../../docs_src/dependencies/tutorial001_02_an.py!}
```
////
diff --git a/docs/ru/docs/tutorial/dependencies/sub-dependencies.md b/docs/ru/docs/tutorial/dependencies/sub-dependencies.md
index 332470396..ae0fd0824 100644
--- a/docs/ru/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/ru/docs/tutorial/dependencies/sub-dependencies.md
@@ -13,7 +13,7 @@
//// tab | Python 3.10+
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial005_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
```
////
@@ -21,7 +21,7 @@
//// tab | Python 3.9+
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
```
////
@@ -29,7 +29,7 @@
//// tab | Python 3.6+
```Python hl_lines="9-10"
-{!> ../../../docs_src/dependencies/tutorial005_an.py!}
+{!> ../../docs_src/dependencies/tutorial005_an.py!}
```
////
@@ -43,7 +43,7 @@
///
```Python hl_lines="6-7"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -57,7 +57,7 @@
///
```Python hl_lines="8-9"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
@@ -73,7 +73,7 @@
//// tab | Python 3.10+
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial005_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
```
////
@@ -81,7 +81,7 @@
//// tab | Python 3.9+
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
```
////
@@ -89,7 +89,7 @@
//// tab | Python 3.6+
```Python hl_lines="14"
-{!> ../../../docs_src/dependencies/tutorial005_an.py!}
+{!> ../../docs_src/dependencies/tutorial005_an.py!}
```
////
@@ -103,7 +103,7 @@
///
```Python hl_lines="11"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -117,7 +117,7 @@
///
```Python hl_lines="13"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
@@ -136,7 +136,7 @@
//// tab | Python 3.10+
```Python hl_lines="23"
-{!> ../../../docs_src/dependencies/tutorial005_an_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
```
////
@@ -144,7 +144,7 @@
//// tab | Python 3.9+
```Python hl_lines="23"
-{!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
```
////
@@ -152,7 +152,7 @@
//// tab | Python 3.6+
```Python hl_lines="24"
-{!> ../../../docs_src/dependencies/tutorial005_an.py!}
+{!> ../../docs_src/dependencies/tutorial005_an.py!}
```
////
@@ -166,7 +166,7 @@
///
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial005_py310.py!}
+{!> ../../docs_src/dependencies/tutorial005_py310.py!}
```
////
@@ -180,7 +180,7 @@
///
```Python hl_lines="22"
-{!> ../../../docs_src/dependencies/tutorial005.py!}
+{!> ../../docs_src/dependencies/tutorial005.py!}
```
////
diff --git a/docs/ru/docs/tutorial/encoder.md b/docs/ru/docs/tutorial/encoder.md
index 02c3587f3..c9900cb2c 100644
--- a/docs/ru/docs/tutorial/encoder.md
+++ b/docs/ru/docs/tutorial/encoder.md
@@ -23,7 +23,7 @@
//// tab | Python 3.10+
```Python hl_lines="4 21"
-{!> ../../../docs_src/encoder/tutorial001_py310.py!}
+{!> ../../docs_src/encoder/tutorial001_py310.py!}
```
////
@@ -31,7 +31,7 @@
//// tab | Python 3.6+
```Python hl_lines="5 22"
-{!> ../../../docs_src/encoder/tutorial001.py!}
+{!> ../../docs_src/encoder/tutorial001.py!}
```
////
diff --git a/docs/ru/docs/tutorial/extra-data-types.md b/docs/ru/docs/tutorial/extra-data-types.md
index 2650bb0af..82cb0ff7a 100644
--- a/docs/ru/docs/tutorial/extra-data-types.md
+++ b/docs/ru/docs/tutorial/extra-data-types.md
@@ -58,7 +58,7 @@
//// tab | Python 3.8 и выше
```Python hl_lines="1 3 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
@@ -66,7 +66,7 @@
//// tab | Python 3.10 и выше
```Python hl_lines="1 2 11-15"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
@@ -76,7 +76,7 @@
//// tab | Python 3.8 и выше
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
@@ -84,7 +84,7 @@
//// tab | Python 3.10 и выше
```Python hl_lines="17-18"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
diff --git a/docs/ru/docs/tutorial/extra-models.md b/docs/ru/docs/tutorial/extra-models.md
index 2aac76aa3..e7ff3f40f 100644
--- a/docs/ru/docs/tutorial/extra-models.md
+++ b/docs/ru/docs/tutorial/extra-models.md
@@ -23,7 +23,7 @@
//// tab | Python 3.10+
```Python hl_lines="7 9 14 20 22 27-28 31-33 38-39"
-{!> ../../../docs_src/extra_models/tutorial001_py310.py!}
+{!> ../../docs_src/extra_models/tutorial001_py310.py!}
```
////
@@ -31,7 +31,7 @@
//// tab | Python 3.8+
```Python hl_lines="9 11 16 22 24 29-30 33-35 40-41"
-{!> ../../../docs_src/extra_models/tutorial001.py!}
+{!> ../../docs_src/extra_models/tutorial001.py!}
```
////
@@ -171,7 +171,7 @@ UserInDB(
//// tab | Python 3.10+
```Python hl_lines="7 13-14 17-18 21-22"
-{!> ../../../docs_src/extra_models/tutorial002_py310.py!}
+{!> ../../docs_src/extra_models/tutorial002_py310.py!}
```
////
@@ -179,7 +179,7 @@ UserInDB(
//// tab | Python 3.8+
```Python hl_lines="9 15-16 19-20 23-24"
-{!> ../../../docs_src/extra_models/tutorial002.py!}
+{!> ../../docs_src/extra_models/tutorial002.py!}
```
////
@@ -201,7 +201,7 @@ UserInDB(
//// tab | Python 3.10+
```Python hl_lines="1 14-15 18-20 33"
-{!> ../../../docs_src/extra_models/tutorial003_py310.py!}
+{!> ../../docs_src/extra_models/tutorial003_py310.py!}
```
////
@@ -209,7 +209,7 @@ UserInDB(
//// tab | Python 3.8+
```Python hl_lines="1 14-15 18-20 33"
-{!> ../../../docs_src/extra_models/tutorial003.py!}
+{!> ../../docs_src/extra_models/tutorial003.py!}
```
////
@@ -237,7 +237,7 @@ some_variable: PlaneItem | CarItem
//// tab | Python 3.9+
```Python hl_lines="18"
-{!> ../../../docs_src/extra_models/tutorial004_py39.py!}
+{!> ../../docs_src/extra_models/tutorial004_py39.py!}
```
////
@@ -245,7 +245,7 @@ some_variable: PlaneItem | CarItem
//// tab | Python 3.8+
```Python hl_lines="1 20"
-{!> ../../../docs_src/extra_models/tutorial004.py!}
+{!> ../../docs_src/extra_models/tutorial004.py!}
```
////
@@ -261,7 +261,7 @@ some_variable: PlaneItem | CarItem
//// tab | Python 3.9+
```Python hl_lines="6"
-{!> ../../../docs_src/extra_models/tutorial005_py39.py!}
+{!> ../../docs_src/extra_models/tutorial005_py39.py!}
```
////
@@ -269,7 +269,7 @@ some_variable: PlaneItem | CarItem
//// tab | Python 3.8+
```Python hl_lines="1 8"
-{!> ../../../docs_src/extra_models/tutorial005.py!}
+{!> ../../docs_src/extra_models/tutorial005.py!}
```
////
diff --git a/docs/ru/docs/tutorial/first-steps.md b/docs/ru/docs/tutorial/first-steps.md
index e60d58823..b1de217cd 100644
--- a/docs/ru/docs/tutorial/first-steps.md
+++ b/docs/ru/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
Самый простой FastAPI файл может выглядеть так:
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Скопируйте в файл `main.py`.
@@ -134,7 +134,7 @@ OpenAPI описывает схему API. Эта схема содержит о
### Шаг 1: импортируйте `FastAPI`
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI` это класс в Python, который предоставляет всю функциональность для API.
@@ -150,7 +150,7 @@ OpenAPI описывает схему API. Эта схема содержит о
### Шаг 2: создайте экземпляр `FastAPI`
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Переменная `app` является экземпляром класса `FastAPI`.
@@ -172,7 +172,7 @@ $ uvicorn main:app --reload
Если создать такое приложение:
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial002.py!}
+{!../../docs_src/first_steps/tutorial002.py!}
```
И поместить его в `main.py`, тогда вызов `uvicorn` будет таким:
@@ -251,7 +251,7 @@ https://example.com/items/foo
#### Определите *декоратор операции пути (path operation decorator)*
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Декоратор `@app.get("/")` указывает **FastAPI**, что функция, прямо под ним, отвечает за обработку запросов, поступающих по адресу:
@@ -307,7 +307,7 @@ https://example.com/items/foo
* **функция**: функция ниже "декоратора" (ниже `@app.get("/")`).
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Это обычная Python функция.
@@ -321,7 +321,7 @@ https://example.com/items/foo
Вы также можете определить ее как обычную функцию вместо `async def`:
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note | "Технические детали"
@@ -333,7 +333,7 @@ https://example.com/items/foo
### Шаг 5: верните результат
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Вы можете вернуть `dict`, `list`, отдельные значения `str`, `int` и т.д.
diff --git a/docs/ru/docs/tutorial/handling-errors.md b/docs/ru/docs/tutorial/handling-errors.md
index 028f3e0d2..e7bfb85aa 100644
--- a/docs/ru/docs/tutorial/handling-errors.md
+++ b/docs/ru/docs/tutorial/handling-errors.md
@@ -26,7 +26,7 @@
### Импортируйте `HTTPException`
```Python hl_lines="1"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
### Вызовите `HTTPException` в своем коде
@@ -42,7 +42,7 @@
В данном примере, когда клиент запрашивает элемент по несуществующему ID, возникает исключение со статус-кодом `404`:
```Python hl_lines="11"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
### Возвращаемый ответ
@@ -82,7 +82,7 @@
Но в случае, если это необходимо для продвинутого сценария, можно добавить пользовательские заголовки:
```Python hl_lines="14"
-{!../../../docs_src/handling_errors/tutorial002.py!}
+{!../../docs_src/handling_errors/tutorial002.py!}
```
## Установка пользовательских обработчиков исключений
@@ -96,7 +96,7 @@
Можно добавить собственный обработчик исключений с помощью `@app.exception_handler()`:
```Python hl_lines="5-7 13-18 24"
-{!../../../docs_src/handling_errors/tutorial003.py!}
+{!../../docs_src/handling_errors/tutorial003.py!}
```
Здесь, если запросить `/unicorns/yolo`, то *операция пути* вызовет `UnicornException`.
@@ -136,7 +136,7 @@
Обработчик исключения получит объект `Request` и исключение.
```Python hl_lines="2 14-16"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
Теперь, если перейти к `/items/foo`, то вместо стандартной JSON-ошибки с:
@@ -189,7 +189,7 @@ path -> item_id
Например, для этих ошибок можно вернуть обычный текстовый ответ вместо JSON:
```Python hl_lines="3-4 9-11 22"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
/// note | "Технические детали"
@@ -207,7 +207,7 @@ path -> item_id
Вы можете использовать его при разработке приложения для регистрации тела и его отладки, возврата пользователю и т.д.
```Python hl_lines="14"
-{!../../../docs_src/handling_errors/tutorial005.py!}
+{!../../docs_src/handling_errors/tutorial005.py!}
```
Теперь попробуйте отправить недействительный элемент, например:
@@ -267,7 +267,7 @@ from starlette.exceptions import HTTPException as StarletteHTTPException
Если вы хотите использовать исключение вместе с теми же обработчиками исключений по умолчанию из **FastAPI**, вы можете импортировать и повторно использовать обработчики исключений по умолчанию из `fastapi.exception_handlers`:
```Python hl_lines="2-5 15 21"
-{!../../../docs_src/handling_errors/tutorial006.py!}
+{!../../docs_src/handling_errors/tutorial006.py!}
```
В этом примере вы просто `выводите в терминал` ошибку с очень выразительным сообщением, но идея вам понятна. Вы можете использовать исключение, а затем просто повторно использовать стандартные обработчики исключений.
diff --git a/docs/ru/docs/tutorial/header-params.md b/docs/ru/docs/tutorial/header-params.md
index 3b5e38328..18e1e60d0 100644
--- a/docs/ru/docs/tutorial/header-params.md
+++ b/docs/ru/docs/tutorial/header-params.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001_an.py!}
+{!> ../../docs_src/header_params/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="1"
-{!> ../../../docs_src/header_params/tutorial001_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@
///
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001.py!}
+{!> ../../docs_src/header_params/tutorial001.py!}
```
////
@@ -67,7 +67,7 @@
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py310.py!}
```
////
@@ -75,7 +75,7 @@
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py39.py!}
```
////
@@ -83,7 +83,7 @@
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial001_an.py!}
+{!> ../../docs_src/header_params/tutorial001_an.py!}
```
////
@@ -97,7 +97,7 @@
///
```Python hl_lines="7"
-{!> ../../../docs_src/header_params/tutorial001_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_py310.py!}
```
////
@@ -111,7 +111,7 @@
///
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001.py!}
+{!> ../../docs_src/header_params/tutorial001.py!}
```
////
@@ -149,7 +149,7 @@
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial002_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial002_an_py310.py!}
```
////
@@ -157,7 +157,7 @@
//// tab | Python 3.9+
```Python hl_lines="11"
-{!> ../../../docs_src/header_params/tutorial002_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial002_an_py39.py!}
```
////
@@ -165,7 +165,7 @@
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/header_params/tutorial002_an.py!}
+{!> ../../docs_src/header_params/tutorial002_an.py!}
```
////
@@ -179,7 +179,7 @@
///
```Python hl_lines="8"
-{!> ../../../docs_src/header_params/tutorial002_py310.py!}
+{!> ../../docs_src/header_params/tutorial002_py310.py!}
```
////
@@ -193,7 +193,7 @@
///
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial002.py!}
+{!> ../../docs_src/header_params/tutorial002.py!}
```
////
@@ -217,7 +217,7 @@
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial003_an_py310.py!}
```
////
@@ -225,7 +225,7 @@
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial003_an_py39.py!}
```
////
@@ -233,7 +233,7 @@
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial003_an.py!}
+{!> ../../docs_src/header_params/tutorial003_an.py!}
```
////
@@ -247,7 +247,7 @@
///
```Python hl_lines="7"
-{!> ../../../docs_src/header_params/tutorial003_py310.py!}
+{!> ../../docs_src/header_params/tutorial003_py310.py!}
```
////
@@ -261,7 +261,7 @@
///
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_py39.py!}
+{!> ../../docs_src/header_params/tutorial003_py39.py!}
```
////
@@ -275,7 +275,7 @@
///
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003.py!}
+{!> ../../docs_src/header_params/tutorial003.py!}
```
////
diff --git a/docs/ru/docs/tutorial/metadata.md b/docs/ru/docs/tutorial/metadata.md
index 9799fe538..246458f42 100644
--- a/docs/ru/docs/tutorial/metadata.md
+++ b/docs/ru/docs/tutorial/metadata.md
@@ -18,7 +18,7 @@
Вы можете задать их следующим образом:
```Python hl_lines="3-16 19-31"
-{!../../../docs_src/metadata/tutorial001.py!}
+{!../../docs_src/metadata/tutorial001.py!}
```
/// tip | "Подсказка"
@@ -52,7 +52,7 @@
Создайте метаданные для ваших тегов и передайте их в параметре `openapi_tags`:
```Python hl_lines="3-16 18"
-{!../../../docs_src/metadata/tutorial004.py!}
+{!../../docs_src/metadata/tutorial004.py!}
```
Помните, что вы можете использовать Markdown внутри описания, к примеру "login" будет отображен жирным шрифтом (**login**) и "fancy" будет отображаться курсивом (_fancy_).
@@ -67,7 +67,7 @@
Используйте параметр `tags` с вашими *операциями пути* (и `APIRouter`ами), чтобы присвоить им различные теги:
```Python hl_lines="21 26"
-{!../../../docs_src/metadata/tutorial004.py!}
+{!../../docs_src/metadata/tutorial004.py!}
```
/// info | "Дополнительная информация"
@@ -97,7 +97,7 @@
К примеру, чтобы задать её отображение по адресу `/api/v1/openapi.json`:
```Python hl_lines="3"
-{!../../../docs_src/metadata/tutorial002.py!}
+{!../../docs_src/metadata/tutorial002.py!}
```
Если вы хотите отключить схему OpenAPI полностью, вы можете задать `openapi_url=None`, это также отключит пользовательские интерфейсы документации, которые его использует.
@@ -116,5 +116,5 @@
К примеру, чтобы задать отображение Swagger UI по адресу `/documentation` и отключить ReDoc:
```Python hl_lines="3"
-{!../../../docs_src/metadata/tutorial003.py!}
+{!../../docs_src/metadata/tutorial003.py!}
```
diff --git a/docs/ru/docs/tutorial/path-operation-configuration.md b/docs/ru/docs/tutorial/path-operation-configuration.md
index 26b1726ad..5f3855af2 100644
--- a/docs/ru/docs/tutorial/path-operation-configuration.md
+++ b/docs/ru/docs/tutorial/path-operation-configuration.md
@@ -19,7 +19,7 @@
//// tab | Python 3.10+
```Python hl_lines="1 15"
-{!> ../../../docs_src/path_operation_configuration/tutorial001_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001_py310.py!}
```
////
@@ -27,7 +27,7 @@
//// tab | Python 3.9+
```Python hl_lines="3 17"
-{!> ../../../docs_src/path_operation_configuration/tutorial001_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001_py39.py!}
```
////
@@ -35,7 +35,7 @@
//// tab | Python 3.8+
```Python hl_lines="3 17"
-{!> ../../../docs_src/path_operation_configuration/tutorial001.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial001.py!}
```
////
@@ -57,7 +57,7 @@
//// tab | Python 3.10+
```Python hl_lines="15 20 25"
-{!> ../../../docs_src/path_operation_configuration/tutorial002_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002_py310.py!}
```
////
@@ -65,7 +65,7 @@
//// tab | Python 3.9+
```Python hl_lines="17 22 27"
-{!> ../../../docs_src/path_operation_configuration/tutorial002_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002_py39.py!}
```
////
@@ -73,7 +73,7 @@
//// tab | Python 3.8+
```Python hl_lines="17 22 27"
-{!> ../../../docs_src/path_operation_configuration/tutorial002.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial002.py!}
```
////
@@ -91,7 +91,7 @@
**FastAPI** поддерживает это так же, как и в случае с обычными строками:
```Python hl_lines="1 8-10 13 18"
-{!../../../docs_src/path_operation_configuration/tutorial002b.py!}
+{!../../docs_src/path_operation_configuration/tutorial002b.py!}
```
## Краткое и развёрнутое содержание
@@ -101,7 +101,7 @@
//// tab | Python 3.10+
```Python hl_lines="18-19"
-{!> ../../../docs_src/path_operation_configuration/tutorial003_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003_py310.py!}
```
////
@@ -109,7 +109,7 @@
//// tab | Python 3.9+
```Python hl_lines="20-21"
-{!> ../../../docs_src/path_operation_configuration/tutorial003_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003_py39.py!}
```
////
@@ -117,7 +117,7 @@
//// tab | Python 3.8+
```Python hl_lines="20-21"
-{!> ../../../docs_src/path_operation_configuration/tutorial003.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial003.py!}
```
////
@@ -131,7 +131,7 @@
//// tab | Python 3.10+
```Python hl_lines="17-25"
-{!> ../../../docs_src/path_operation_configuration/tutorial004_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004_py310.py!}
```
////
@@ -139,7 +139,7 @@
//// tab | Python 3.9+
```Python hl_lines="19-27"
-{!> ../../../docs_src/path_operation_configuration/tutorial004_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004_py39.py!}
```
////
@@ -147,7 +147,7 @@
//// tab | Python 3.8+
```Python hl_lines="19-27"
-{!> ../../../docs_src/path_operation_configuration/tutorial004.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial004.py!}
```
////
@@ -163,7 +163,7 @@
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/path_operation_configuration/tutorial005_py310.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005_py310.py!}
```
////
@@ -171,7 +171,7 @@
//// tab | Python 3.9+
```Python hl_lines="21"
-{!> ../../../docs_src/path_operation_configuration/tutorial005_py39.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005_py39.py!}
```
////
@@ -179,7 +179,7 @@
//// tab | Python 3.8+
```Python hl_lines="21"
-{!> ../../../docs_src/path_operation_configuration/tutorial005.py!}
+{!> ../../docs_src/path_operation_configuration/tutorial005.py!}
```
////
@@ -205,7 +205,7 @@ OpenAPI указывает, что каждой *операции пути* не
Если вам необходимо пометить *операцию пути* как <abbr title="устаревшее, не рекомендовано к использованию">устаревшую</abbr>, при этом не удаляя её, передайте параметр `deprecated`:
```Python hl_lines="16"
-{!../../../docs_src/path_operation_configuration/tutorial006.py!}
+{!../../docs_src/path_operation_configuration/tutorial006.py!}
```
Он будет четко помечен как устаревший в интерактивной документации:
diff --git a/docs/ru/docs/tutorial/path-params-numeric-validations.md b/docs/ru/docs/tutorial/path-params-numeric-validations.md
index ced12c826..bf42ec725 100644
--- a/docs/ru/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/ru/docs/tutorial/path-params-numeric-validations.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="1 3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="1 3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="3-4"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="1"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@
///
```Python hl_lines="3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -77,7 +77,7 @@
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
```
////
@@ -85,7 +85,7 @@
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
```
////
@@ -93,7 +93,7 @@
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
```
////
@@ -107,7 +107,7 @@
///
```Python hl_lines="8"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -121,7 +121,7 @@
///
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -167,7 +167,7 @@ Path-параметр всегда является обязательным, п
///
```Python hl_lines="7"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial002.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial002.py!}
```
////
@@ -177,7 +177,7 @@ Path-параметр всегда является обязательным, п
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
```
////
@@ -185,7 +185,7 @@ Path-параметр всегда является обязательным, п
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
```
////
@@ -214,7 +214,7 @@ Path-параметр всегда является обязательным, п
Python не будет ничего делать с `*`, но он будет знать, что все следующие параметры являются именованными аргументами (парами ключ-значение), также известными как <abbr title="From: K-ey W-ord Arg-uments"><code>kwargs</code></abbr>, даже если у них нет значений по умолчанию.
```Python hl_lines="7"
-{!../../../docs_src/path_params_numeric_validations/tutorial003.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial003.py!}
```
### Лучше с `Annotated`
@@ -224,7 +224,7 @@ Python не будет ничего делать с `*`, но он будет з
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
```
////
@@ -232,7 +232,7 @@ Python не будет ничего делать с `*`, но он будет з
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
```
////
@@ -246,7 +246,7 @@ Python не будет ничего делать с `*`, но он будет з
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
```
////
@@ -254,7 +254,7 @@ Python не будет ничего делать с `*`, но он будет з
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
```
////
@@ -268,7 +268,7 @@ Python не будет ничего делать с `*`, но он будет з
///
```Python hl_lines="8"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial004.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial004.py!}
```
////
@@ -283,7 +283,7 @@ Python не будет ничего делать с `*`, но он будет з
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
```
////
@@ -291,7 +291,7 @@ Python не будет ничего делать с `*`, но он будет з
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
```
////
@@ -305,7 +305,7 @@ Python не будет ничего делать с `*`, но он будет з
///
```Python hl_lines="9"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial005.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial005.py!}
```
////
@@ -323,7 +323,7 @@ Python не будет ничего делать с `*`, но он будет з
//// tab | Python 3.9+
```Python hl_lines="13"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
```
////
@@ -331,7 +331,7 @@ Python не будет ничего делать с `*`, но он будет з
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
```
////
@@ -345,7 +345,7 @@ Python не будет ничего делать с `*`, но он будет з
///
```Python hl_lines="11"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial006.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial006.py!}
```
////
diff --git a/docs/ru/docs/tutorial/path-params.md b/docs/ru/docs/tutorial/path-params.md
index dc3d64af4..d1d76cf7b 100644
--- a/docs/ru/docs/tutorial/path-params.md
+++ b/docs/ru/docs/tutorial/path-params.md
@@ -3,7 +3,7 @@
Вы можете определить "параметры" или "переменные" пути, используя синтаксис форматированных строк Python:
```Python hl_lines="6-7"
-{!../../../docs_src/path_params/tutorial001.py!}
+{!../../docs_src/path_params/tutorial001.py!}
```
Значение параметра пути `item_id` будет передано в функцию в качестве аргумента `item_id`.
@@ -19,7 +19,7 @@
Вы можете объявить тип параметра пути в функции, используя стандартные аннотации типов Python.
```Python hl_lines="7"
-{!../../../docs_src/path_params/tutorial002.py!}
+{!../../docs_src/path_params/tutorial002.py!}
```
Здесь, `item_id` объявлен типом `int`.
@@ -123,7 +123,7 @@
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003.py!}
+{!../../docs_src/path_params/tutorial003.py!}
```
Иначе путь для `/users/{user_id}` также будет соответствовать `/users/me`, "подразумевая", что он получает параметр `user_id` со значением `"me"`.
@@ -131,7 +131,7 @@
Аналогично, вы не можете переопределить операцию с путем:
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003b.py!}
+{!../../docs_src/path_params/tutorial003b.py!}
```
Первый будет выполняться всегда, так как путь совпадает первым.
@@ -149,7 +149,7 @@
Затем создайте атрибуты класса с фиксированными допустимыми значениями:
```Python hl_lines="1 6-9"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// info | "Дополнительная информация"
@@ -169,7 +169,7 @@
Определите *параметр пути*, используя в аннотации типа класс перечисления (`ModelName`), созданный ранее:
```Python hl_lines="16"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
### Проверьте документацию
@@ -187,7 +187,7 @@
Вы можете сравнить это значение с *элементом перечисления* класса `ModelName`:
```Python hl_lines="17"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
#### Получение *значения перечисления*
@@ -195,7 +195,7 @@
Можно получить фактическое значение (в данном случае - `str`) с помощью `model_name.value` или в общем случае `your_enum_member.value`:
```Python hl_lines="20"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// tip | "Подсказка"
@@ -211,7 +211,7 @@
Они будут преобразованы в соответствующие значения (в данном случае - строки) перед их возвратом клиенту:
```Python hl_lines="18 21 23"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
Вы отправите клиенту такой JSON-ответ:
@@ -251,7 +251,7 @@ OpenAPI не поддерживает способов объявления *п
Можете использовать так:
```Python hl_lines="6"
-{!../../../docs_src/path_params/tutorial004.py!}
+{!../../docs_src/path_params/tutorial004.py!}
```
/// tip | "Подсказка"
diff --git a/docs/ru/docs/tutorial/query-params-str-validations.md b/docs/ru/docs/tutorial/query-params-str-validations.md
index e6653a837..0054af6ed 100644
--- a/docs/ru/docs/tutorial/query-params-str-validations.md
+++ b/docs/ru/docs/tutorial/query-params-str-validations.md
@@ -7,7 +7,7 @@
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial001_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial001_py310.py!}
```
////
@@ -15,7 +15,7 @@
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial001.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial001.py!}
```
////
@@ -46,7 +46,7 @@ FastAPI определит параметр `q` как необязательн
В Python 3.9 или выше, `Annotated` является частью стандартной библиотеки, таким образом вы можете импортировать его из `typing`.
```Python hl_lines="1 3"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
```
////
@@ -58,7 +58,7 @@ FastAPI определит параметр `q` как необязательн
Эта библиотека будет установлена вместе с FastAPI.
```Python hl_lines="3-4"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_an.py!}
```
////
@@ -116,7 +116,7 @@ q: Annotated[Union[str, None]] = None
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
```
////
@@ -124,7 +124,7 @@ q: Annotated[Union[str, None]] = None
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_an.py!}
```
////
@@ -154,7 +154,7 @@ q: Annotated[Union[str, None]] = None
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial002_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002_py310.py!}
```
////
@@ -162,7 +162,7 @@ q: Annotated[Union[str, None]] = None
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial002.py!}
```
////
@@ -268,7 +268,7 @@ q: str = Query(default="rick")
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial003_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003_an_py310.py!}
```
////
@@ -276,7 +276,7 @@ q: str = Query(default="rick")
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial003_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003_an_py39.py!}
```
////
@@ -284,7 +284,7 @@ q: str = Query(default="rick")
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial003_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003_an.py!}
```
////
@@ -298,7 +298,7 @@ q: str = Query(default="rick")
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial003_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003_py310.py!}
```
////
@@ -312,7 +312,7 @@ q: str = Query(default="rick")
///
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial003.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial003.py!}
```
////
@@ -324,7 +324,7 @@ q: str = Query(default="rick")
//// tab | Python 3.10+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_an_py310.py!}
```
////
@@ -332,7 +332,7 @@ q: str = Query(default="rick")
//// tab | Python 3.9+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_an_py39.py!}
```
////
@@ -340,7 +340,7 @@ q: str = Query(default="rick")
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_an.py!}
```
////
@@ -354,7 +354,7 @@ q: str = Query(default="rick")
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial004_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004_py310.py!}
```
////
@@ -368,7 +368,7 @@ q: str = Query(default="rick")
///
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial004.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial004.py!}
```
////
@@ -392,7 +392,7 @@ q: str = Query(default="rick")
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial005_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial005_an_py39.py!}
```
////
@@ -400,7 +400,7 @@ q: str = Query(default="rick")
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial005_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial005_an.py!}
```
////
@@ -414,7 +414,7 @@ q: str = Query(default="rick")
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial005.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial005.py!}
```
////
@@ -462,7 +462,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006_an_py39.py!}
```
////
@@ -470,7 +470,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial006_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006_an.py!}
```
////
@@ -484,7 +484,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial006.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006.py!}
```
/// tip | "Подсказка"
@@ -504,7 +504,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006b_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006b_an_py39.py!}
```
////
@@ -512,7 +512,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial006b_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006b_an.py!}
```
////
@@ -526,7 +526,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial006b.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006b.py!}
```
////
@@ -550,7 +550,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c_an_py310.py!}
```
////
@@ -558,7 +558,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c_an_py39.py!}
```
////
@@ -566,7 +566,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c_an.py!}
```
////
@@ -580,7 +580,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c_py310.py!}
```
////
@@ -594,7 +594,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006c.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006c.py!}
```
////
@@ -612,7 +612,7 @@ Pydantic, мощь которого используется в FastAPI для
//// tab | Python 3.9+
```Python hl_lines="4 10"
-{!> ../../../docs_src/query_params_str_validations/tutorial006d_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006d_an_py39.py!}
```
////
@@ -620,7 +620,7 @@ Pydantic, мощь которого используется в FastAPI для
//// tab | Python 3.8+
```Python hl_lines="2 9"
-{!> ../../../docs_src/query_params_str_validations/tutorial006d_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006d_an.py!}
```
////
@@ -634,7 +634,7 @@ Pydantic, мощь которого используется в FastAPI для
///
```Python hl_lines="2 8"
-{!> ../../../docs_src/query_params_str_validations/tutorial006d.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial006d.py!}
```
////
@@ -654,7 +654,7 @@ Pydantic, мощь которого используется в FastAPI для
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_an_py310.py!}
```
////
@@ -662,7 +662,7 @@ Pydantic, мощь которого используется в FastAPI для
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_an_py39.py!}
```
////
@@ -670,7 +670,7 @@ Pydantic, мощь которого используется в FastAPI для
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_an.py!}
```
////
@@ -684,7 +684,7 @@ Pydantic, мощь которого используется в FastAPI для
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_py310.py!}
```
////
@@ -698,7 +698,7 @@ Pydantic, мощь которого используется в FastAPI для
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011_py39.py!}
```
////
@@ -712,7 +712,7 @@ Pydantic, мощь которого используется в FastAPI для
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial011.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial011.py!}
```
////
@@ -753,7 +753,7 @@ http://localhost:8000/items/?q=foo&q=bar
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial012_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012_an_py39.py!}
```
////
@@ -761,7 +761,7 @@ http://localhost:8000/items/?q=foo&q=bar
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial012_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012_an.py!}
```
////
@@ -775,7 +775,7 @@ http://localhost:8000/items/?q=foo&q=bar
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial012_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012_py39.py!}
```
////
@@ -789,7 +789,7 @@ http://localhost:8000/items/?q=foo&q=bar
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial012.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial012.py!}
```
////
@@ -818,7 +818,7 @@ http://localhost:8000/items/
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial013_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial013_an_py39.py!}
```
////
@@ -826,7 +826,7 @@ http://localhost:8000/items/
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial013_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial013_an.py!}
```
////
@@ -840,7 +840,7 @@ http://localhost:8000/items/
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial013.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial013.py!}
```
////
@@ -872,7 +872,7 @@ http://localhost:8000/items/
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial007_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007_an_py310.py!}
```
////
@@ -880,7 +880,7 @@ http://localhost:8000/items/
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial007_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007_an_py39.py!}
```
////
@@ -888,7 +888,7 @@ http://localhost:8000/items/
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial007_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007_an.py!}
```
////
@@ -902,7 +902,7 @@ http://localhost:8000/items/
///
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial007_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007_py310.py!}
```
////
@@ -916,7 +916,7 @@ http://localhost:8000/items/
///
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial007.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial007.py!}
```
////
@@ -926,7 +926,7 @@ http://localhost:8000/items/
//// tab | Python 3.10+
```Python hl_lines="14"
-{!> ../../../docs_src/query_params_str_validations/tutorial008_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008_an_py310.py!}
```
////
@@ -934,7 +934,7 @@ http://localhost:8000/items/
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/query_params_str_validations/tutorial008_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008_an_py39.py!}
```
////
@@ -942,7 +942,7 @@ http://localhost:8000/items/
//// tab | Python 3.8+
```Python hl_lines="15"
-{!> ../../../docs_src/query_params_str_validations/tutorial008_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008_an.py!}
```
////
@@ -956,7 +956,7 @@ http://localhost:8000/items/
///
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial008_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008_py310.py!}
```
////
@@ -970,7 +970,7 @@ http://localhost:8000/items/
///
```Python hl_lines="13"
-{!> ../../../docs_src/query_params_str_validations/tutorial008.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial008.py!}
```
////
@@ -996,7 +996,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial009_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009_an_py310.py!}
```
////
@@ -1004,7 +1004,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial009_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009_an_py39.py!}
```
////
@@ -1012,7 +1012,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial009_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009_an.py!}
```
////
@@ -1026,7 +1026,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
///
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial009_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009_py310.py!}
```
////
@@ -1040,7 +1040,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
///
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial009.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial009.py!}
```
////
@@ -1056,7 +1056,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/query_params_str_validations/tutorial010_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010_an_py310.py!}
```
////
@@ -1064,7 +1064,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.9+
```Python hl_lines="19"
-{!> ../../../docs_src/query_params_str_validations/tutorial010_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010_an_py39.py!}
```
////
@@ -1072,7 +1072,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/query_params_str_validations/tutorial010_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010_an.py!}
```
////
@@ -1086,7 +1086,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
///
```Python hl_lines="16"
-{!> ../../../docs_src/query_params_str_validations/tutorial010_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010_py310.py!}
```
////
@@ -1100,7 +1100,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
///
```Python hl_lines="18"
-{!> ../../../docs_src/query_params_str_validations/tutorial010.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial010.py!}
```
////
@@ -1116,7 +1116,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial014_an_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014_an_py310.py!}
```
////
@@ -1124,7 +1124,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial014_an_py39.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014_an_py39.py!}
```
////
@@ -1132,7 +1132,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/query_params_str_validations/tutorial014_an.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014_an.py!}
```
////
@@ -1146,7 +1146,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
///
```Python hl_lines="8"
-{!> ../../../docs_src/query_params_str_validations/tutorial014_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014_py310.py!}
```
////
@@ -1160,7 +1160,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
///
```Python hl_lines="10"
-{!> ../../../docs_src/query_params_str_validations/tutorial014.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial014.py!}
```
////
diff --git a/docs/ru/docs/tutorial/query-params.md b/docs/ru/docs/tutorial/query-params.md
index 061f9be04..edf06746b 100644
--- a/docs/ru/docs/tutorial/query-params.md
+++ b/docs/ru/docs/tutorial/query-params.md
@@ -3,7 +3,7 @@
Когда вы объявляете параметры функции, которые не являются параметрами пути, они автоматически интерпретируются как "query"-параметры.
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial001.py!}
+{!../../docs_src/query_params/tutorial001.py!}
```
Query-параметры представляют из себя набор пар ключ-значение, которые идут после знака `?` в URL-адресе, разделенные символами `&`.
@@ -66,7 +66,7 @@ http://127.0.0.1:8000/items/?skip=20
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial002_py310.py!}
+{!> ../../docs_src/query_params/tutorial002_py310.py!}
```
////
@@ -74,7 +74,7 @@ http://127.0.0.1:8000/items/?skip=20
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial002.py!}
+{!> ../../docs_src/query_params/tutorial002.py!}
```
////
@@ -94,7 +94,7 @@ http://127.0.0.1:8000/items/?skip=20
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial003_py310.py!}
+{!> ../../docs_src/query_params/tutorial003_py310.py!}
```
////
@@ -102,7 +102,7 @@ http://127.0.0.1:8000/items/?skip=20
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial003.py!}
+{!> ../../docs_src/query_params/tutorial003.py!}
```
////
@@ -151,7 +151,7 @@ http://127.0.0.1:8000/items/foo?short=yes
//// tab | Python 3.10+
```Python hl_lines="6 8"
-{!> ../../../docs_src/query_params/tutorial004_py310.py!}
+{!> ../../docs_src/query_params/tutorial004_py310.py!}
```
////
@@ -159,7 +159,7 @@ http://127.0.0.1:8000/items/foo?short=yes
//// tab | Python 3.8+
```Python hl_lines="8 10"
-{!> ../../../docs_src/query_params/tutorial004.py!}
+{!> ../../docs_src/query_params/tutorial004.py!}
```
////
@@ -173,7 +173,7 @@ http://127.0.0.1:8000/items/foo?short=yes
Но если вы хотите сделать query-параметр обязательным, вы можете просто не указывать значение по умолчанию:
```Python hl_lines="6-7"
-{!../../../docs_src/query_params/tutorial005.py!}
+{!../../docs_src/query_params/tutorial005.py!}
```
Здесь параметр запроса `needy` является обязательным параметром с типом данных `str`.
@@ -221,7 +221,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params/tutorial006_py310.py!}
+{!> ../../docs_src/query_params/tutorial006_py310.py!}
```
////
@@ -229,7 +229,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params/tutorial006.py!}
+{!> ../../docs_src/query_params/tutorial006.py!}
```
////
diff --git a/docs/ru/docs/tutorial/request-files.md b/docs/ru/docs/tutorial/request-files.md
index 1fbc4acc0..34b9c94fa 100644
--- a/docs/ru/docs/tutorial/request-files.md
+++ b/docs/ru/docs/tutorial/request-files.md
@@ -19,7 +19,7 @@
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
```
////
@@ -27,7 +27,7 @@
//// tab | Python 3.6+
```Python hl_lines="1"
-{!> ../../../docs_src/request_files/tutorial001_an.py!}
+{!> ../../docs_src/request_files/tutorial001_an.py!}
```
////
@@ -41,7 +41,7 @@
///
```Python hl_lines="1"
-{!> ../../../docs_src/request_files/tutorial001.py!}
+{!> ../../docs_src/request_files/tutorial001.py!}
```
////
@@ -53,7 +53,7 @@
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
```
////
@@ -61,7 +61,7 @@
//// tab | Python 3.6+
```Python hl_lines="8"
-{!> ../../../docs_src/request_files/tutorial001_an.py!}
+{!> ../../docs_src/request_files/tutorial001_an.py!}
```
////
@@ -75,7 +75,7 @@
///
```Python hl_lines="7"
-{!> ../../../docs_src/request_files/tutorial001.py!}
+{!> ../../docs_src/request_files/tutorial001.py!}
```
////
@@ -109,7 +109,7 @@
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
```
////
@@ -117,7 +117,7 @@
//// tab | Python 3.6+
```Python hl_lines="13"
-{!> ../../../docs_src/request_files/tutorial001_an.py!}
+{!> ../../docs_src/request_files/tutorial001_an.py!}
```
////
@@ -131,7 +131,7 @@
///
```Python hl_lines="12"
-{!> ../../../docs_src/request_files/tutorial001.py!}
+{!> ../../docs_src/request_files/tutorial001.py!}
```
////
@@ -220,7 +220,7 @@ contents = myfile.file.read()
//// tab | Python 3.10+
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02_an_py310.py!}
+{!> ../../docs_src/request_files/tutorial001_02_an_py310.py!}
```
////
@@ -228,7 +228,7 @@ contents = myfile.file.read()
//// tab | Python 3.9+
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_02_an_py39.py!}
```
////
@@ -236,7 +236,7 @@ contents = myfile.file.read()
//// tab | Python 3.6+
```Python hl_lines="10 18"
-{!> ../../../docs_src/request_files/tutorial001_02_an.py!}
+{!> ../../docs_src/request_files/tutorial001_02_an.py!}
```
////
@@ -250,7 +250,7 @@ contents = myfile.file.read()
///
```Python hl_lines="7 15"
-{!> ../../../docs_src/request_files/tutorial001_02_py310.py!}
+{!> ../../docs_src/request_files/tutorial001_02_py310.py!}
```
////
@@ -264,7 +264,7 @@ contents = myfile.file.read()
///
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02.py!}
+{!> ../../docs_src/request_files/tutorial001_02.py!}
```
////
@@ -276,7 +276,7 @@ contents = myfile.file.read()
//// tab | Python 3.9+
```Python hl_lines="9 15"
-{!> ../../../docs_src/request_files/tutorial001_03_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial001_03_an_py39.py!}
```
////
@@ -284,7 +284,7 @@ contents = myfile.file.read()
//// tab | Python 3.6+
```Python hl_lines="8 14"
-{!> ../../../docs_src/request_files/tutorial001_03_an.py!}
+{!> ../../docs_src/request_files/tutorial001_03_an.py!}
```
////
@@ -298,7 +298,7 @@ contents = myfile.file.read()
///
```Python hl_lines="7 13"
-{!> ../../../docs_src/request_files/tutorial001_03.py!}
+{!> ../../docs_src/request_files/tutorial001_03.py!}
```
////
@@ -314,7 +314,7 @@ contents = myfile.file.read()
//// tab | Python 3.9+
```Python hl_lines="10 15"
-{!> ../../../docs_src/request_files/tutorial002_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial002_an_py39.py!}
```
////
@@ -322,7 +322,7 @@ contents = myfile.file.read()
//// tab | Python 3.6+
```Python hl_lines="11 16"
-{!> ../../../docs_src/request_files/tutorial002_an.py!}
+{!> ../../docs_src/request_files/tutorial002_an.py!}
```
////
@@ -336,7 +336,7 @@ contents = myfile.file.read()
///
```Python hl_lines="8 13"
-{!> ../../../docs_src/request_files/tutorial002_py39.py!}
+{!> ../../docs_src/request_files/tutorial002_py39.py!}
```
////
@@ -350,7 +350,7 @@ contents = myfile.file.read()
///
```Python hl_lines="10 15"
-{!> ../../../docs_src/request_files/tutorial002.py!}
+{!> ../../docs_src/request_files/tutorial002.py!}
```
////
@@ -372,7 +372,7 @@ contents = myfile.file.read()
//// tab | Python 3.9+
```Python hl_lines="11 18-20"
-{!> ../../../docs_src/request_files/tutorial003_an_py39.py!}
+{!> ../../docs_src/request_files/tutorial003_an_py39.py!}
```
////
@@ -380,7 +380,7 @@ contents = myfile.file.read()
//// tab | Python 3.6+
```Python hl_lines="12 19-21"
-{!> ../../../docs_src/request_files/tutorial003_an.py!}
+{!> ../../docs_src/request_files/tutorial003_an.py!}
```
////
@@ -394,7 +394,7 @@ contents = myfile.file.read()
///
```Python hl_lines="9 16"
-{!> ../../../docs_src/request_files/tutorial003_py39.py!}
+{!> ../../docs_src/request_files/tutorial003_py39.py!}
```
////
@@ -408,7 +408,7 @@ contents = myfile.file.read()
///
```Python hl_lines="11 18"
-{!> ../../../docs_src/request_files/tutorial003.py!}
+{!> ../../docs_src/request_files/tutorial003.py!}
```
////
diff --git a/docs/ru/docs/tutorial/request-forms-and-files.md b/docs/ru/docs/tutorial/request-forms-and-files.md
index b38962866..9b449bcd9 100644
--- a/docs/ru/docs/tutorial/request-forms-and-files.md
+++ b/docs/ru/docs/tutorial/request-forms-and-files.md
@@ -15,7 +15,7 @@
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
```
////
@@ -23,7 +23,7 @@
//// tab | Python 3.6+
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms_and_files/tutorial001_an.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001_an.py!}
```
////
@@ -37,7 +37,7 @@
///
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001.py!}
```
////
@@ -49,7 +49,7 @@
//// tab | Python 3.9+
```Python hl_lines="10-12"
-{!> ../../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
```
////
@@ -57,7 +57,7 @@
//// tab | Python 3.6+
```Python hl_lines="9-11"
-{!> ../../../docs_src/request_forms_and_files/tutorial001_an.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001_an.py!}
```
////
@@ -71,7 +71,7 @@
///
```Python hl_lines="8"
-{!> ../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!> ../../docs_src/request_forms_and_files/tutorial001.py!}
```
////
diff --git a/docs/ru/docs/tutorial/request-forms.md b/docs/ru/docs/tutorial/request-forms.md
index 3737f1347..93b44437b 100644
--- a/docs/ru/docs/tutorial/request-forms.md
+++ b/docs/ru/docs/tutorial/request-forms.md
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms/tutorial001_an.py!}
+{!> ../../docs_src/request_forms/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms/tutorial001.py!}
+{!> ../../docs_src/request_forms/tutorial001.py!}
```
////
@@ -51,7 +51,7 @@
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms/tutorial001_an_py39.py!}
```
////
@@ -59,7 +59,7 @@
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/request_forms/tutorial001_an.py!}
+{!> ../../docs_src/request_forms/tutorial001_an.py!}
```
////
@@ -73,7 +73,7 @@
///
```Python hl_lines="7"
-{!> ../../../docs_src/request_forms/tutorial001.py!}
+{!> ../../docs_src/request_forms/tutorial001.py!}
```
////
diff --git a/docs/ru/docs/tutorial/response-model.md b/docs/ru/docs/tutorial/response-model.md
index f8c910fe9..363e64676 100644
--- a/docs/ru/docs/tutorial/response-model.md
+++ b/docs/ru/docs/tutorial/response-model.md
@@ -7,7 +7,7 @@ FastAPI позволяет использовать **аннотации тип
//// tab | Python 3.10+
```Python hl_lines="16 21"
-{!> ../../../docs_src/response_model/tutorial001_01_py310.py!}
+{!> ../../docs_src/response_model/tutorial001_01_py310.py!}
```
////
@@ -15,7 +15,7 @@ FastAPI позволяет использовать **аннотации тип
//// tab | Python 3.9+
```Python hl_lines="18 23"
-{!> ../../../docs_src/response_model/tutorial001_01_py39.py!}
+{!> ../../docs_src/response_model/tutorial001_01_py39.py!}
```
////
@@ -23,7 +23,7 @@ FastAPI позволяет использовать **аннотации тип
//// tab | Python 3.8+
```Python hl_lines="18 23"
-{!> ../../../docs_src/response_model/tutorial001_01.py!}
+{!> ../../docs_src/response_model/tutorial001_01.py!}
```
////
@@ -62,7 +62,7 @@ FastAPI будет использовать этот возвращаемый т
//// tab | Python 3.10+
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001_py310.py!}
+{!> ../../docs_src/response_model/tutorial001_py310.py!}
```
////
@@ -70,7 +70,7 @@ FastAPI будет использовать этот возвращаемый т
//// tab | Python 3.9+
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001_py39.py!}
+{!> ../../docs_src/response_model/tutorial001_py39.py!}
```
////
@@ -78,7 +78,7 @@ FastAPI будет использовать этот возвращаемый т
//// tab | Python 3.8+
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001.py!}
+{!> ../../docs_src/response_model/tutorial001.py!}
```
////
@@ -116,7 +116,7 @@ FastAPI будет использовать значение `response_model` д
//// tab | Python 3.10+
```Python hl_lines="7 9"
-{!> ../../../docs_src/response_model/tutorial002_py310.py!}
+{!> ../../docs_src/response_model/tutorial002_py310.py!}
```
////
@@ -124,7 +124,7 @@ FastAPI будет использовать значение `response_model` д
//// tab | Python 3.8+
```Python hl_lines="9 11"
-{!> ../../../docs_src/response_model/tutorial002.py!}
+{!> ../../docs_src/response_model/tutorial002.py!}
```
////
@@ -142,7 +142,7 @@ FastAPI будет использовать значение `response_model` д
//// tab | Python 3.10+
```Python hl_lines="16"
-{!> ../../../docs_src/response_model/tutorial002_py310.py!}
+{!> ../../docs_src/response_model/tutorial002_py310.py!}
```
////
@@ -150,7 +150,7 @@ FastAPI будет использовать значение `response_model` д
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/response_model/tutorial002.py!}
+{!> ../../docs_src/response_model/tutorial002.py!}
```
////
@@ -174,7 +174,7 @@ FastAPI будет использовать значение `response_model` д
//// tab | Python 3.10+
```Python hl_lines="9 11 16"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -182,7 +182,7 @@ FastAPI будет использовать значение `response_model` д
//// tab | Python 3.8+
```Python hl_lines="9 11 16"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -192,7 +192,7 @@ FastAPI будет использовать значение `response_model` д
//// tab | Python 3.10+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -200,7 +200,7 @@ FastAPI будет использовать значение `response_model` д
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -210,7 +210,7 @@ FastAPI будет использовать значение `response_model` д
//// tab | Python 3.10+
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -218,7 +218,7 @@ FastAPI будет использовать значение `response_model` д
//// tab | Python 3.8+
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -248,7 +248,7 @@ FastAPI будет использовать значение `response_model` д
//// tab | Python 3.10+
```Python hl_lines="7-10 13-14 18"
-{!> ../../../docs_src/response_model/tutorial003_01_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_01_py310.py!}
```
////
@@ -256,7 +256,7 @@ FastAPI будет использовать значение `response_model` д
//// tab | Python 3.8+
```Python hl_lines="9-13 15-16 20"
-{!> ../../../docs_src/response_model/tutorial003_01.py!}
+{!> ../../docs_src/response_model/tutorial003_01.py!}
```
////
@@ -302,7 +302,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
Самый частый сценарий использования - это [возвращать Response напрямую, как описано в расширенной документации](../advanced/response-directly.md){.internal-link target=_blank}.
```Python hl_lines="8 10-11"
-{!> ../../../docs_src/response_model/tutorial003_02.py!}
+{!> ../../docs_src/response_model/tutorial003_02.py!}
```
Это поддерживается FastAPI по-умолчанию, т.к. аннотация проставлена в классе (или подклассе) `Response`.
@@ -314,7 +314,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
Вы также можете указать подкласс `Response` в аннотации типа:
```Python hl_lines="8-9"
-{!> ../../../docs_src/response_model/tutorial003_03.py!}
+{!> ../../docs_src/response_model/tutorial003_03.py!}
```
Это сработает, потому что `RedirectResponse` является подклассом `Response` и FastAPI автоматически обработает этот простейший случай.
@@ -328,7 +328,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/response_model/tutorial003_04_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_04_py310.py!}
```
////
@@ -336,7 +336,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/response_model/tutorial003_04.py!}
+{!> ../../docs_src/response_model/tutorial003_04.py!}
```
////
@@ -354,7 +354,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/response_model/tutorial003_05_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_05_py310.py!}
```
////
@@ -362,7 +362,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/response_model/tutorial003_05.py!}
+{!> ../../docs_src/response_model/tutorial003_05.py!}
```
////
@@ -376,7 +376,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
//// tab | Python 3.10+
```Python hl_lines="9 11-12"
-{!> ../../../docs_src/response_model/tutorial004_py310.py!}
+{!> ../../docs_src/response_model/tutorial004_py310.py!}
```
////
@@ -384,7 +384,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
//// tab | Python 3.9+
```Python hl_lines="11 13-14"
-{!> ../../../docs_src/response_model/tutorial004_py39.py!}
+{!> ../../docs_src/response_model/tutorial004_py39.py!}
```
////
@@ -392,7 +392,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
//// tab | Python 3.8+
```Python hl_lines="11 13-14"
-{!> ../../../docs_src/response_model/tutorial004.py!}
+{!> ../../docs_src/response_model/tutorial004.py!}
```
////
@@ -412,7 +412,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
//// tab | Python 3.10+
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial004_py310.py!}
+{!> ../../docs_src/response_model/tutorial004_py310.py!}
```
////
@@ -420,7 +420,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
//// tab | Python 3.9+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial004_py39.py!}
+{!> ../../docs_src/response_model/tutorial004_py39.py!}
```
////
@@ -428,7 +428,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial004.py!}
+{!> ../../docs_src/response_model/tutorial004.py!}
```
////
@@ -523,7 +523,7 @@ FastAPI достаточно умен (на самом деле, это засл
//// tab | Python 3.10+
```Python hl_lines="29 35"
-{!> ../../../docs_src/response_model/tutorial005_py310.py!}
+{!> ../../docs_src/response_model/tutorial005_py310.py!}
```
////
@@ -531,7 +531,7 @@ FastAPI достаточно умен (на самом деле, это засл
//// tab | Python 3.8+
```Python hl_lines="31 37"
-{!> ../../../docs_src/response_model/tutorial005.py!}
+{!> ../../docs_src/response_model/tutorial005.py!}
```
////
@@ -551,7 +551,7 @@ FastAPI достаточно умен (на самом деле, это засл
//// tab | Python 3.10+
```Python hl_lines="29 35"
-{!> ../../../docs_src/response_model/tutorial006_py310.py!}
+{!> ../../docs_src/response_model/tutorial006_py310.py!}
```
////
@@ -559,7 +559,7 @@ FastAPI достаточно умен (на самом деле, это засл
//// tab | Python 3.8+
```Python hl_lines="31 37"
-{!> ../../../docs_src/response_model/tutorial006.py!}
+{!> ../../docs_src/response_model/tutorial006.py!}
```
////
diff --git a/docs/ru/docs/tutorial/response-status-code.md b/docs/ru/docs/tutorial/response-status-code.md
index a36c42d05..48808bea7 100644
--- a/docs/ru/docs/tutorial/response-status-code.md
+++ b/docs/ru/docs/tutorial/response-status-code.md
@@ -9,7 +9,7 @@
* и других.
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
/// note | "Примечание"
@@ -77,7 +77,7 @@ FastAPI знает об этом и создаст документацию Open
Рассмотрим предыдущий пример еще раз:
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
`201` – это код статуса "Создано".
@@ -87,7 +87,7 @@ FastAPI знает об этом и создаст документацию Open
Для удобства вы можете использовать переменные из `fastapi.status`.
```Python hl_lines="1 6"
-{!../../../docs_src/response_status_code/tutorial002.py!}
+{!../../docs_src/response_status_code/tutorial002.py!}
```
Они содержат те же числовые значения, но позволяют использовать подсказки редактора для выбора кода статуса:
diff --git a/docs/ru/docs/tutorial/schema-extra-example.md b/docs/ru/docs/tutorial/schema-extra-example.md
index 1b216de3a..daa264afc 100644
--- a/docs/ru/docs/tutorial/schema-extra-example.md
+++ b/docs/ru/docs/tutorial/schema-extra-example.md
@@ -11,7 +11,7 @@
//// tab | Python 3.10+
```Python hl_lines="13-21"
-{!> ../../../docs_src/schema_extra_example/tutorial001_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001_py310.py!}
```
////
@@ -19,7 +19,7 @@
//// tab | Python 3.8+
```Python hl_lines="15-23"
-{!> ../../../docs_src/schema_extra_example/tutorial001.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001.py!}
```
////
@@ -43,7 +43,7 @@
//// tab | Python 3.10+
```Python hl_lines="2 8-11"
-{!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial002_py310.py!}
```
////
@@ -51,7 +51,7 @@
//// tab | Python 3.8+
```Python hl_lines="4 10-13"
-{!> ../../../docs_src/schema_extra_example/tutorial002.py!}
+{!> ../../docs_src/schema_extra_example/tutorial002.py!}
```
////
@@ -83,7 +83,7 @@
//// tab | Python 3.10+
```Python hl_lines="22-27"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
```
////
@@ -91,7 +91,7 @@
//// tab | Python 3.9+
```Python hl_lines="22-27"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
```
////
@@ -99,7 +99,7 @@
//// tab | Python 3.8+
```Python hl_lines="23-28"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an.py!}
```
////
@@ -113,7 +113,7 @@
///
```Python hl_lines="18-23"
-{!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_py310.py!}
```
////
@@ -127,7 +127,7 @@
///
```Python hl_lines="20-25"
-{!> ../../../docs_src/schema_extra_example/tutorial003.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003.py!}
```
////
@@ -154,7 +154,7 @@
//// tab | Python 3.10+
```Python hl_lines="23-49"
-{!> ../../../docs_src/schema_extra_example/tutorial004_an_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_an_py310.py!}
```
////
@@ -162,7 +162,7 @@
//// tab | Python 3.9+
```Python hl_lines="23-49"
-{!> ../../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
```
////
@@ -170,7 +170,7 @@
//// tab | Python 3.8+
```Python hl_lines="24-50"
-{!> ../../../docs_src/schema_extra_example/tutorial004_an.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_an.py!}
```
////
@@ -184,7 +184,7 @@
///
```Python hl_lines="19-45"
-{!> ../../../docs_src/schema_extra_example/tutorial004_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004_py310.py!}
```
////
@@ -198,7 +198,7 @@
///
```Python hl_lines="21-47"
-{!> ../../../docs_src/schema_extra_example/tutorial004.py!}
+{!> ../../docs_src/schema_extra_example/tutorial004.py!}
```
////
diff --git a/docs/ru/docs/tutorial/security/first-steps.md b/docs/ru/docs/tutorial/security/first-steps.md
index 444a06915..c98ce2c60 100644
--- a/docs/ru/docs/tutorial/security/first-steps.md
+++ b/docs/ru/docs/tutorial/security/first-steps.md
@@ -23,7 +23,7 @@
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/security/tutorial001_an_py39.py!}
+{!> ../../docs_src/security/tutorial001_an_py39.py!}
```
////
@@ -31,7 +31,7 @@
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/security/tutorial001_an.py!}
+{!> ../../docs_src/security/tutorial001_an.py!}
```
////
@@ -45,7 +45,7 @@
///
```Python
-{!> ../../../docs_src/security/tutorial001.py!}
+{!> ../../docs_src/security/tutorial001.py!}
```
////
@@ -155,7 +155,7 @@ OAuth2 был разработан для того, чтобы бэкэнд ил
//// tab | Python 3.9+
```Python hl_lines="8"
-{!> ../../../docs_src/security/tutorial001_an_py39.py!}
+{!> ../../docs_src/security/tutorial001_an_py39.py!}
```
////
@@ -163,7 +163,7 @@ OAuth2 был разработан для того, чтобы бэкэнд ил
//// tab | Python 3.8+
```Python hl_lines="7"
-{!> ../../../docs_src/security/tutorial001_an.py!}
+{!> ../../docs_src/security/tutorial001_an.py!}
```
////
@@ -177,7 +177,7 @@ OAuth2 был разработан для того, чтобы бэкэнд ил
///
```Python hl_lines="6"
-{!> ../../../docs_src/security/tutorial001.py!}
+{!> ../../docs_src/security/tutorial001.py!}
```
////
@@ -221,7 +221,7 @@ oauth2_scheme(some, parameters)
//// tab | Python 3.9+
```Python hl_lines="12"
-{!> ../../../docs_src/security/tutorial001_an_py39.py!}
+{!> ../../docs_src/security/tutorial001_an_py39.py!}
```
////
@@ -229,7 +229,7 @@ oauth2_scheme(some, parameters)
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/security/tutorial001_an.py!}
+{!> ../../docs_src/security/tutorial001_an.py!}
```
////
@@ -243,7 +243,7 @@ oauth2_scheme(some, parameters)
///
```Python hl_lines="10"
-{!> ../../../docs_src/security/tutorial001.py!}
+{!> ../../docs_src/security/tutorial001.py!}
```
////
diff --git a/docs/ru/docs/tutorial/static-files.md b/docs/ru/docs/tutorial/static-files.md
index ccddae249..4734554f3 100644
--- a/docs/ru/docs/tutorial/static-files.md
+++ b/docs/ru/docs/tutorial/static-files.md
@@ -8,7 +8,7 @@
* "Примонтируйте" экземпляр `StaticFiles()` с указанием определенной директории.
```Python hl_lines="2 6"
-{!../../../docs_src/static_files/tutorial001.py!}
+{!../../docs_src/static_files/tutorial001.py!}
```
/// note | "Технические детали"
diff --git a/docs/ru/docs/tutorial/testing.md b/docs/ru/docs/tutorial/testing.md
index efefbfb01..ae045bbbe 100644
--- a/docs/ru/docs/tutorial/testing.md
+++ b/docs/ru/docs/tutorial/testing.md
@@ -27,7 +27,7 @@
Напишите простое утверждение с `assert` дабы проверить истинность Python-выражения (это тоже стандарт `pytest`).
```Python hl_lines="2 12 15-18"
-{!../../../docs_src/app_testing/tutorial001.py!}
+{!../../docs_src/app_testing/tutorial001.py!}
```
/// tip | "Подсказка"
@@ -75,7 +75,7 @@
```Python
-{!../../../docs_src/app_testing/main.py!}
+{!../../docs_src/app_testing/main.py!}
```
### Файл тестов
@@ -93,7 +93,7 @@
Так как оба файла находятся в одной директории, для импорта объекта приложения из файла `main` в файл `test_main` Вы можете использовать относительный импорт:
```Python hl_lines="3"
-{!../../../docs_src/app_testing/test_main.py!}
+{!../../docs_src/app_testing/test_main.py!}
```
...и писать дальше тесты, как и раньше.
@@ -125,7 +125,7 @@
//// tab | Python 3.10+
```Python
-{!> ../../../docs_src/app_testing/app_b_an_py310/main.py!}
+{!> ../../docs_src/app_testing/app_b_an_py310/main.py!}
```
////
@@ -133,7 +133,7 @@
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/app_testing/app_b_an_py39/main.py!}
+{!> ../../docs_src/app_testing/app_b_an_py39/main.py!}
```
////
@@ -141,7 +141,7 @@
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/app_testing/app_b_an/main.py!}
+{!> ../../docs_src/app_testing/app_b_an/main.py!}
```
////
@@ -155,7 +155,7 @@
///
```Python
-{!> ../../../docs_src/app_testing/app_b_py310/main.py!}
+{!> ../../docs_src/app_testing/app_b_py310/main.py!}
```
////
@@ -169,7 +169,7 @@
///
```Python
-{!> ../../../docs_src/app_testing/app_b/main.py!}
+{!> ../../docs_src/app_testing/app_b/main.py!}
```
////
@@ -179,7 +179,7 @@
Теперь обновим файл `test_main.py`, добавив в него тестов:
```Python
-{!> ../../../docs_src/app_testing/app_b/test_main.py!}
+{!> ../../docs_src/app_testing/app_b/test_main.py!}
```
Если Вы не знаете, как передать информацию в запросе, можете воспользоваться поисковиком (погуглить) и задать вопрос: "Как передать информацию в запросе с помощью `httpx`", можно даже спросить: "Как передать информацию в запросе с помощью `requests`", поскольку дизайн HTTPX основан на дизайне Requests.
diff --git a/docs/tr/docs/advanced/testing-websockets.md b/docs/tr/docs/advanced/testing-websockets.md
index 59a2499e2..aa8a040d0 100644
--- a/docs/tr/docs/advanced/testing-websockets.md
+++ b/docs/tr/docs/advanced/testing-websockets.md
@@ -5,7 +5,7 @@ WebSockets testi yapmak için `TestClient`'ı kullanabilirsiniz.
Bu işlem için, `TestClient`'ı bir `with` ifadesinde kullanarak WebSocket'e bağlanabilirsiniz:
```Python hl_lines="27-31"
-{!../../../docs_src/app_testing/tutorial002.py!}
+{!../../docs_src/app_testing/tutorial002.py!}
```
/// note | "Not"
diff --git a/docs/tr/docs/advanced/wsgi.md b/docs/tr/docs/advanced/wsgi.md
index 54a6f20e2..bc8da16df 100644
--- a/docs/tr/docs/advanced/wsgi.md
+++ b/docs/tr/docs/advanced/wsgi.md
@@ -13,7 +13,7 @@ Ardından WSGI (örneğin Flask) uygulamanızı middleware ile sarmalayın.
Son olarak da bir yol altında bağlama işlemini gerçekleştirin.
```Python hl_lines="2-3 23"
-{!../../../docs_src/wsgi/tutorial001.py!}
+{!../../docs_src/wsgi/tutorial001.py!}
```
## Kontrol Edelim
diff --git a/docs/tr/docs/python-types.md b/docs/tr/docs/python-types.md
index b8b880c6d..9584a5732 100644
--- a/docs/tr/docs/python-types.md
+++ b/docs/tr/docs/python-types.md
@@ -23,7 +23,7 @@ Python uzmanıysanız ve tip belirteçleri ilgili her şeyi zaten biliyorsanız,
Basit bir örnek ile başlayalım:
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
Programın çıktısı:
@@ -39,7 +39,7 @@ Fonksiyon sırayla şunları yapar:
* Değişkenleri aralarında bir boşlukla beraber <abbr title="Onları bir bütün olarak sırayla birleştirir.">Birleştirir</abbr>.
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### Düzenle
@@ -83,7 +83,7 @@ Bu kadar.
İşte bunlar "tip belirteçleri":
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
Bu, aşağıdaki gibi varsayılan değerleri bildirmekle aynı şey değildir:
@@ -113,7 +113,7 @@ Aradığınızı bulana kadar seçenekleri kaydırabilirsiniz:
Bu fonksiyon, zaten tür belirteçlerine sahip:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
Editör değişkenlerin tiplerini bildiğinden, yalnızca otomatik tamamlama değil, hata kontrolleri de sağlar:
@@ -123,7 +123,7 @@ Editör değişkenlerin tiplerini bildiğinden, yalnızca otomatik tamamlama de
Artık `age` değişkenini `str(age)` olarak kullanmanız gerektiğini biliyorsunuz:
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## Tip bildirme
@@ -144,7 +144,7 @@ Yalnızca `str` değil, tüm standart Python tiplerinin bildirebilirsiniz.
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### Tip parametreleri ile Generic tipler
@@ -162,7 +162,7 @@ Bu tür tip belirteçlerini desteklemek için özel olarak mevcuttur.
From `typing`, import `List` (büyük harf olan `L` ile):
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
Değişkenin tipini yine iki nokta üstüste (`:`) ile belirleyin.
@@ -172,7 +172,7 @@ tip olarak `List` kullanın.
Liste, bazı dahili tipleri içeren bir tür olduğundan, bunları köşeli parantez içine alırsınız:
```Python hl_lines="4"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
/// tip | "Ipucu"
@@ -200,7 +200,7 @@ Ve yine, editör bunun bir `str` olduğunu biliyor ve bunun için destek s
`Tuple` ve `set`lerin tiplerini bildirmek için de aynısını yapıyoruz:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial007.py!}
+{!../../docs_src/python_types/tutorial007.py!}
```
Bu şu anlama geliyor:
@@ -217,7 +217,7 @@ Bir `dict` tanımlamak için virgülle ayrılmış iki parametre verebilirsiniz.
İkinci parametre ise `dict` değerinin `value` değeri içindir:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial008.py!}
+{!../../docs_src/python_types/tutorial008.py!}
```
Bu şu anlama gelir:
@@ -231,7 +231,7 @@ Bu şu anlama gelir:
`Optional` bir değişkenin `str`gibi bir tipi olabileceğini ama isteğe bağlı olarak tipinin `None` olabileceğini belirtir:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
`str` yerine `Optional[str]` kullanmak editorün bu değerin her zaman `str` tipinde değil bazen `None` tipinde de olabileceğini belirtir ve hataları tespit etmemizde yardımcı olur.
@@ -256,13 +256,13 @@ Bir değişkenin tipini bir sınıf ile bildirebilirsiniz.
Diyelim ki `name` değerine sahip `Person` sınıfınız var:
```Python hl_lines="1-3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Sonra bir değişkeni 'Person' tipinde tanımlayabilirsiniz:
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Ve yine bütün editör desteğini alırsınız:
@@ -284,7 +284,7 @@ Ve ortaya çıkan nesne üzerindeki bütün editör desteğini alırsınız.
Resmi Pydantic dokümanlarından alınmıştır:
```Python
-{!../../../docs_src/python_types/tutorial011.py!}
+{!../../docs_src/python_types/tutorial011.py!}
```
/// info
diff --git a/docs/tr/docs/tutorial/cookie-params.md b/docs/tr/docs/tutorial/cookie-params.md
index 807f85e8a..895cf9b03 100644
--- a/docs/tr/docs/tutorial/cookie-params.md
+++ b/docs/tr/docs/tutorial/cookie-params.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
///
```Python hl_lines="1"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@ Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
///
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
@@ -67,7 +67,7 @@ Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -75,7 +75,7 @@ Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -83,7 +83,7 @@ Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -97,7 +97,7 @@ Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
///
```Python hl_lines="7"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -111,7 +111,7 @@ Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
///
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
diff --git a/docs/tr/docs/tutorial/first-steps.md b/docs/tr/docs/tutorial/first-steps.md
index 76c035992..335fcaece 100644
--- a/docs/tr/docs/tutorial/first-steps.md
+++ b/docs/tr/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
En sade FastAPI dosyası şu şekilde görünür:
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Yukarıdaki içeriği bir `main.py` dosyasına kopyalayalım.
@@ -134,7 +134,7 @@ Ayrıca, API'ınızla iletişim kuracak önyüz, mobil veya IoT uygulamaları gi
### Adım 1: `FastAPI`yı Projemize Dahil Edelim
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI`, API'niz için tüm işlevselliği sağlayan bir Python sınıfıdır.
@@ -150,7 +150,7 @@ Ayrıca, API'ınızla iletişim kuracak önyüz, mobil veya IoT uygulamaları gi
### Adım 2: Bir `FastAPI` "Örneği" Oluşturalım
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Burada `app` değişkeni `FastAPI` sınıfının bir örneği olacaktır.
@@ -172,7 +172,7 @@ $ uvicorn main:app --reload
Uygulamanızı aşağıdaki gibi oluşturursanız:
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial002.py!}
+{!../../docs_src/first_steps/tutorial002.py!}
```
Ve bunu `main.py` dosyasına yerleştirirseniz eğer `uvicorn` komutunu şu şekilde çalıştırabilirsiniz:
@@ -251,7 +251,7 @@ Biz de onları "**operasyonlar**" olarak adlandıracağız.
#### Bir *Yol Operasyonu Dekoratörü* Tanımlayalım
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`@app.get("/")` dekoratörü, **FastAPI**'a hemen altındaki fonksiyonun aşağıdaki durumlardan sorumlu olduğunu söyler:
@@ -307,7 +307,7 @@ Aşağıdaki, bizim **yol operasyonu fonksiyonumuzdur**:
* **fonksiyon**: "dekoratör"ün (`@app.get("/")`'in) altındaki fonksiyondur.
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Bu bir Python fonksiyonudur.
@@ -321,7 +321,7 @@ Bu durumda bu fonksiyon bir `async` fonksiyondur.
Bu fonksiyonu `async def` yerine normal bir fonksiyon olarak da tanımlayabilirsiniz.
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note | "Not"
@@ -333,7 +333,7 @@ Eğer farkı bilmiyorsanız, [Async: *"Aceleniz mi var?"*](../async.md#in-a-hurr
### Adım 5: İçeriği Geri Döndürün
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Bir `dict`, `list` veya `str`, `int` gibi tekil değerler döndürebilirsiniz.
diff --git a/docs/tr/docs/tutorial/path-params.md b/docs/tr/docs/tutorial/path-params.md
index d36242083..9017d99ab 100644
--- a/docs/tr/docs/tutorial/path-params.md
+++ b/docs/tr/docs/tutorial/path-params.md
@@ -3,7 +3,7 @@
Yol "parametrelerini" veya "değişkenlerini" Python <abbr title="String Biçimleme: Format String">string biçimlemede</abbr> kullanılan sözdizimi ile tanımlayabilirsiniz.
```Python hl_lines="6-7"
-{!../../../docs_src/path_params/tutorial001.py!}
+{!../../docs_src/path_params/tutorial001.py!}
```
Yol parametresi olan `item_id`'nin değeri, fonksiyonunuza `item_id` argümanı olarak aktarılacaktır.
@@ -19,7 +19,7 @@ Eğer bu örneği çalıştırıp <a href="http://127.0.0.1:8000/items/foo" clas
Standart Python tip belirteçlerini kullanarak yol parametresinin tipini fonksiyonun içerisinde tanımlayabilirsiniz.
```Python hl_lines="7"
-{!../../../docs_src/path_params/tutorial002.py!}
+{!../../docs_src/path_params/tutorial002.py!}
```
Bu durumda, `item_id` bir `int` olarak tanımlanacaktır.
@@ -124,7 +124,7 @@ Benzer şekilde `/users/{user_id}` gibi tanımlanmış ve belirli bir kullanıc
*Yol operasyonları* sıralı bir şekilde gözden geçirildiğinden dolayı `/users/me` yolunun `/users/{user_id}` yolundan önce tanımlanmış olmasından emin olmanız gerekmektedir:
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003.py!}
+{!../../docs_src/path_params/tutorial003.py!}
```
Aksi halde, `/users/{user_id}` yolu `"me"` değerinin `user_id` parametresi için gönderildiğini "düşünerek" `/users/me` ile de eşleşir.
@@ -132,7 +132,7 @@ Aksi halde, `/users/{user_id}` yolu `"me"` değerinin `user_id` parametresi içi
Benzer şekilde, bir yol operasyonunu yeniden tanımlamanız mümkün değildir:
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003b.py!}
+{!../../docs_src/path_params/tutorial003b.py!}
```
Yol, ilk kısım ile eşleştiğinden dolayı her koşulda ilk yol operasyonu kullanılacaktır.
@@ -150,7 +150,7 @@ Eğer *yol parametresi* alan bir *yol operasyonunuz* varsa ve alabileceği *yol
Sonrasında, sınıf içerisinde, mevcut ve geçerli değerler olacak olan sabit değerli özelliklerini oluşturalım:
```Python hl_lines="1 6-9"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// info | "Bilgi"
@@ -170,7 +170,7 @@ Merak ediyorsanız söyleyeyim, "AlexNet", "ResNet" ve "LeNet" isimleri Makine
Sonrasında, yarattığımız enum sınıfını (`ModelName`) kullanarak tip belirteci aracılığıyla bir *yol parametresi* oluşturalım:
```Python hl_lines="16"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
### Dokümana Göz Atalım
@@ -188,7 +188,7 @@ Sonrasında, yarattığımız enum sınıfını (`ModelName`) kullanarak tip bel
Parametreyi, yarattığınız enum olan `ModelName` içerisindeki *enumeration üyesi* ile karşılaştırabilirsiniz:
```Python hl_lines="17"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
#### *Enumeration Değerini* Edinelim
@@ -196,7 +196,7 @@ Parametreyi, yarattığınız enum olan `ModelName` içerisindeki *enumeration
`model_name.value` veya genel olarak `your_enum_member.value` tanımlarını kullanarak (bu durumda bir `str` olan) gerçek değere ulaşabilirsiniz:
```Python hl_lines="20"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// tip | "İpucu"
@@ -212,7 +212,7 @@ JSON gövdesine (örneğin bir `dict`) gömülü olsalar bile *yol operasyonunda
Bu üyeler istemciye iletilmeden önce kendilerine karşılık gelen değerlerine (bu durumda string) dönüştürüleceklerdir:
```Python hl_lines="18 21 23"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
İstemci tarafında şuna benzer bir JSON yanıtı ile karşılaşırsınız:
@@ -253,7 +253,7 @@ Bu durumda, parametrenin adı `file_path` olacaktır ve son kısım olan `:path`
Böylece şunun gibi bir kullanım yapabilirsiniz:
```Python hl_lines="6"
-{!../../../docs_src/path_params/tutorial004.py!}
+{!../../docs_src/path_params/tutorial004.py!}
```
/// tip | "İpucu"
diff --git a/docs/tr/docs/tutorial/query-params.md b/docs/tr/docs/tutorial/query-params.md
index bf66dbe74..886f5783f 100644
--- a/docs/tr/docs/tutorial/query-params.md
+++ b/docs/tr/docs/tutorial/query-params.md
@@ -3,7 +3,7 @@
Fonksiyonda yol parametrelerinin parçası olmayan diğer tanımlamalar otomatik olarak "sorgu" parametresi olarak yorumlanır.
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial001.py!}
+{!../../docs_src/query_params/tutorial001.py!}
```
Sorgu, bağlantıdaki `?` kısmından sonra gelen ve `&` işareti ile ayrılan anahtar-değer çiftlerinin oluşturduğu bir kümedir.
@@ -66,7 +66,7 @@ Aynı şekilde, varsayılan değerlerini `None` olarak atayarak isteğe bağlı
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial002_py310.py!}
+{!> ../../docs_src/query_params/tutorial002_py310.py!}
```
////
@@ -74,7 +74,7 @@ Aynı şekilde, varsayılan değerlerini `None` olarak atayarak isteğe bağlı
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial002.py!}
+{!> ../../docs_src/query_params/tutorial002.py!}
```
////
@@ -94,7 +94,7 @@ Aşağıda görüldüğü gibi dönüştürülmek üzere `bool` tipleri de tanı
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial003_py310.py!}
+{!> ../../docs_src/query_params/tutorial003_py310.py!}
```
////
@@ -102,7 +102,7 @@ Aşağıda görüldüğü gibi dönüştürülmek üzere `bool` tipleri de tanı
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial003.py!}
+{!> ../../docs_src/query_params/tutorial003.py!}
```
////
@@ -151,7 +151,7 @@ Ve parametreleri, herhangi bir sıraya koymanıza da gerek yoktur.
//// tab | Python 3.10+
```Python hl_lines="6 8"
-{!> ../../../docs_src/query_params/tutorial004_py310.py!}
+{!> ../../docs_src/query_params/tutorial004_py310.py!}
```
////
@@ -159,7 +159,7 @@ Ve parametreleri, herhangi bir sıraya koymanıza da gerek yoktur.
//// tab | Python 3.8+
```Python hl_lines="8 10"
-{!> ../../../docs_src/query_params/tutorial004.py!}
+{!> ../../docs_src/query_params/tutorial004.py!}
```
////
@@ -173,7 +173,7 @@ Parametre için belirli bir değer atamak istemeyip parametrenin sadece isteğe
Fakat, bir sorgu parametresini zorunlu yapmak istiyorsanız varsayılan bir değer atamamanız yeterli olacaktır:
```Python hl_lines="6-7"
-{!../../../docs_src/query_params/tutorial005.py!}
+{!../../docs_src/query_params/tutorial005.py!}
```
Burada `needy` parametresi `str` tipinden oluşan zorunlu bir sorgu parametresidir.
@@ -223,7 +223,7 @@ Ve elbette, bazı parametreleri zorunlu, bazılarını varsayılan değerli ve b
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params/tutorial006_py310.py!}
+{!> ../../docs_src/query_params/tutorial006_py310.py!}
```
////
@@ -231,7 +231,7 @@ Ve elbette, bazı parametreleri zorunlu, bazılarını varsayılan değerli ve b
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params/tutorial006.py!}
+{!> ../../docs_src/query_params/tutorial006.py!}
```
////
diff --git a/docs/tr/docs/tutorial/request-forms.md b/docs/tr/docs/tutorial/request-forms.md
index 8e8ccfba4..19b6150ff 100644
--- a/docs/tr/docs/tutorial/request-forms.md
+++ b/docs/tr/docs/tutorial/request-forms.md
@@ -17,7 +17,7 @@ Formları kullanmak için öncelikle <a href="https://github.com/Kludex/python-m
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@ Formları kullanmak için öncelikle <a href="https://github.com/Kludex/python-m
//// tab | Python 3.8+
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms/tutorial001_an.py!}
+{!> ../../docs_src/request_forms/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="1"
-{!> ../../../docs_src/request_forms/tutorial001.py!}
+{!> ../../docs_src/request_forms/tutorial001.py!}
```
////
@@ -51,7 +51,7 @@ Form parametrelerini `Body` veya `Query` için yaptığınız gibi oluşturun:
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
+{!> ../../docs_src/request_forms/tutorial001_an_py39.py!}
```
////
@@ -59,7 +59,7 @@ Form parametrelerini `Body` veya `Query` için yaptığınız gibi oluşturun:
//// tab | Python 3.8+
```Python hl_lines="8"
-{!> ../../../docs_src/request_forms/tutorial001_an.py!}
+{!> ../../docs_src/request_forms/tutorial001_an.py!}
```
////
@@ -73,7 +73,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/request_forms/tutorial001.py!}
+{!> ../../docs_src/request_forms/tutorial001.py!}
```
////
diff --git a/docs/tr/docs/tutorial/static-files.md b/docs/tr/docs/tutorial/static-files.md
index b82be611f..8bff59744 100644
--- a/docs/tr/docs/tutorial/static-files.md
+++ b/docs/tr/docs/tutorial/static-files.md
@@ -8,7 +8,7 @@
* Bir `StaticFiles()` örneğini belirli bir yola bağlayın.
```Python hl_lines="2 6"
-{!../../../docs_src/static_files/tutorial001.py!}
+{!../../docs_src/static_files/tutorial001.py!}
```
/// note | "Teknik Detaylar"
diff --git a/docs/uk/docs/python-types.md b/docs/uk/docs/python-types.md
index 511a5264a..573b5372c 100644
--- a/docs/uk/docs/python-types.md
+++ b/docs/uk/docs/python-types.md
@@ -23,7 +23,7 @@ Python підтримує додаткові "підказки типу" ("type
Давайте почнемо з простого прикладу:
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
Виклик цієї програми виводить:
@@ -39,7 +39,7 @@ John Doe
* <abbr title="З’єднує їх, як одне ціле. З вмістом один за одним.">Конкатенує</abbr> їх разом із пробілом по середині.
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### Редагуйте це
@@ -83,7 +83,7 @@ John Doe
Це "type hints":
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
Це не те саме, що оголошення значень за замовчуванням, як це було б з:
@@ -113,7 +113,7 @@ John Doe
Перевірте цю функцію, вона вже має анотацію типу:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
Оскільки редактор знає типи змінних, ви не тільки отримаєте автозаповнення, ви також отримаєте перевірку помилок:
@@ -123,7 +123,7 @@ John Doe
Тепер ви знаєте, щоб виправити це, вам потрібно перетворити `age` у строку з допомогою `str(age)`:
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## Оголошення типів
@@ -144,7 +144,7 @@ John Doe
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### Generic-типи з параметрами типів
@@ -172,7 +172,7 @@ John Doe
З модуля `typing`, імпортуємо `List` (з великої літери `L`):
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
Оголосимо змінну з тим самим синтаксисом двокрапки (`:`).
@@ -182,7 +182,7 @@ John Doe
Оскільки список є типом, який містить деякі внутрішні типи, ви поміщаєте їх у квадратні дужки:
```Python hl_lines="4"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
////
@@ -196,7 +196,7 @@ John Doe
Оскільки список є типом, який містить деякі внутрішні типи, ви поміщаєте їх у квадратні дужки:
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006_py39.py!}
+{!> ../../docs_src/python_types/tutorial006_py39.py!}
```
////
@@ -234,7 +234,7 @@ John Doe
//// tab | Python 3.8 і вище
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial007.py!}
+{!> ../../docs_src/python_types/tutorial007.py!}
```
////
@@ -242,7 +242,7 @@ John Doe
//// tab | Python 3.9 і вище
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial007_py39.py!}
+{!> ../../docs_src/python_types/tutorial007_py39.py!}
```
////
@@ -263,7 +263,7 @@ John Doe
//// tab | Python 3.8 і вище
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008.py!}
+{!> ../../docs_src/python_types/tutorial008.py!}
```
////
@@ -271,7 +271,7 @@ John Doe
//// tab | Python 3.9 і вище
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008_py39.py!}
+{!> ../../docs_src/python_types/tutorial008_py39.py!}
```
////
@@ -293,7 +293,7 @@ John Doe
//// tab | Python 3.8 і вище
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008b.py!}
+{!> ../../docs_src/python_types/tutorial008b.py!}
```
////
@@ -301,7 +301,7 @@ John Doe
//// tab | Python 3.10 і вище
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008b_py310.py!}
+{!> ../../docs_src/python_types/tutorial008b_py310.py!}
```
////
@@ -315,7 +315,7 @@ John Doe
У Python 3.6 і вище (включаючи Python 3.10) ви можете оголосити його, імпортувавши та використовуючи `Optional` з модуля `typing`.
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
Використання `Optional[str]` замість просто `str` дозволить редактору допомогти вам виявити помилки, коли ви могли б вважати, що значенням завжди є `str`, хоча насправді воно також може бути `None`.
@@ -327,7 +327,7 @@ John Doe
//// tab | Python 3.8 і вище
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009.py!}
+{!> ../../docs_src/python_types/tutorial009.py!}
```
////
@@ -335,7 +335,7 @@ John Doe
//// tab | Python 3.8 і вище - альтернатива
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009b.py!}
+{!> ../../docs_src/python_types/tutorial009b.py!}
```
////
@@ -343,7 +343,7 @@ John Doe
//// tab | Python 3.10 і вище
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial009_py310.py!}
+{!> ../../docs_src/python_types/tutorial009_py310.py!}
```
////
@@ -407,13 +407,13 @@ John Doe
Скажімо, у вас є клас `Person` з імʼям:
```Python hl_lines="1-3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Потім ви можете оголосити змінну типу `Person`:
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
І знову ж таки, ви отримуєте всю підтримку редактора:
@@ -437,7 +437,7 @@ John Doe
//// tab | Python 3.8 і вище
```Python
-{!> ../../../docs_src/python_types/tutorial011.py!}
+{!> ../../docs_src/python_types/tutorial011.py!}
```
////
@@ -445,7 +445,7 @@ John Doe
//// tab | Python 3.9 і вище
```Python
-{!> ../../../docs_src/python_types/tutorial011_py39.py!}
+{!> ../../docs_src/python_types/tutorial011_py39.py!}
```
////
@@ -453,7 +453,7 @@ John Doe
//// tab | Python 3.10 і вище
```Python
-{!> ../../../docs_src/python_types/tutorial011_py310.py!}
+{!> ../../docs_src/python_types/tutorial011_py310.py!}
```
////
diff --git a/docs/uk/docs/tutorial/body-fields.md b/docs/uk/docs/tutorial/body-fields.md
index e4d5b1fad..b1f645932 100644
--- a/docs/uk/docs/tutorial/body-fields.md
+++ b/docs/uk/docs/tutorial/body-fields.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an.py!}
+{!> ../../docs_src/body_fields/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="2"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@
///
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
@@ -71,7 +71,7 @@
//// tab | Python 3.10+
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py310.py!}
```
////
@@ -79,7 +79,7 @@
//// tab | Python 3.9+
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py39.py!}
```
////
@@ -87,7 +87,7 @@
//// tab | Python 3.8+
```Python hl_lines="12-15"
-{!> ../../../docs_src/body_fields/tutorial001_an.py!}
+{!> ../../docs_src/body_fields/tutorial001_an.py!}
```
////
@@ -101,7 +101,7 @@
///
```Python hl_lines="9-12"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
@@ -115,7 +115,7 @@
///
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
diff --git a/docs/uk/docs/tutorial/body.md b/docs/uk/docs/tutorial/body.md
index 50fd76f84..1e4188831 100644
--- a/docs/uk/docs/tutorial/body.md
+++ b/docs/uk/docs/tutorial/body.md
@@ -25,7 +25,7 @@
//// tab | Python 3.8 і вище
```Python hl_lines="4"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -33,7 +33,7 @@
//// tab | Python 3.10 і вище
```Python hl_lines="2"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -47,7 +47,7 @@
//// tab | Python 3.8 і вище
```Python hl_lines="7-11"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -55,7 +55,7 @@
//// tab | Python 3.10 і вище
```Python hl_lines="5-9"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -89,7 +89,7 @@
//// tab | Python 3.8 і вище
```Python hl_lines="18"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -97,7 +97,7 @@
//// tab | Python 3.10 і вище
```Python hl_lines="16"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -170,7 +170,7 @@
//// tab | Python 3.8 і вище
```Python hl_lines="21"
-{!> ../../../docs_src/body/tutorial002.py!}
+{!> ../../docs_src/body/tutorial002.py!}
```
////
@@ -178,7 +178,7 @@
//// tab | Python 3.10 і вище
```Python hl_lines="19"
-{!> ../../../docs_src/body/tutorial002_py310.py!}
+{!> ../../docs_src/body/tutorial002_py310.py!}
```
////
@@ -192,7 +192,7 @@
//// tab | Python 3.8 і вище
```Python hl_lines="17-18"
-{!> ../../../docs_src/body/tutorial003.py!}
+{!> ../../docs_src/body/tutorial003.py!}
```
////
@@ -200,7 +200,7 @@
//// tab | Python 3.10 і вище
```Python hl_lines="15-16"
-{!> ../../../docs_src/body/tutorial003_py310.py!}
+{!> ../../docs_src/body/tutorial003_py310.py!}
```
////
@@ -214,7 +214,7 @@
//// tab | Python 3.8 і вище
```Python hl_lines="18"
-{!> ../../../docs_src/body/tutorial004.py!}
+{!> ../../docs_src/body/tutorial004.py!}
```
////
@@ -222,7 +222,7 @@
//// tab | Python 3.10 і вище
```Python hl_lines="16"
-{!> ../../../docs_src/body/tutorial004_py310.py!}
+{!> ../../docs_src/body/tutorial004_py310.py!}
```
////
diff --git a/docs/uk/docs/tutorial/cookie-params.md b/docs/uk/docs/tutorial/cookie-params.md
index 4720a42ba..40ca4f6e6 100644
--- a/docs/uk/docs/tutorial/cookie-params.md
+++ b/docs/uk/docs/tutorial/cookie-params.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="1"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@
///
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
@@ -67,7 +67,7 @@
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -75,7 +75,7 @@
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -83,7 +83,7 @@
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -97,7 +97,7 @@
///
```Python hl_lines="7"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -111,7 +111,7 @@
///
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
diff --git a/docs/uk/docs/tutorial/encoder.md b/docs/uk/docs/tutorial/encoder.md
index 9ef8d5c5d..39dca9be8 100644
--- a/docs/uk/docs/tutorial/encoder.md
+++ b/docs/uk/docs/tutorial/encoder.md
@@ -23,7 +23,7 @@
//// tab | Python 3.10+
```Python hl_lines="4 21"
-{!> ../../../docs_src/encoder/tutorial001_py310.py!}
+{!> ../../docs_src/encoder/tutorial001_py310.py!}
```
////
@@ -31,7 +31,7 @@
//// tab | Python 3.8+
```Python hl_lines="5 22"
-{!> ../../../docs_src/encoder/tutorial001.py!}
+{!> ../../docs_src/encoder/tutorial001.py!}
```
////
diff --git a/docs/uk/docs/tutorial/extra-data-types.md b/docs/uk/docs/tutorial/extra-data-types.md
index 54cbd4b00..5e6c364e4 100644
--- a/docs/uk/docs/tutorial/extra-data-types.md
+++ b/docs/uk/docs/tutorial/extra-data-types.md
@@ -58,7 +58,7 @@
//// tab | Python 3.10+
```Python hl_lines="1 3 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py310.py!}
```
////
@@ -66,7 +66,7 @@
//// tab | Python 3.9+
```Python hl_lines="1 3 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py39.py!}
```
////
@@ -74,7 +74,7 @@
//// tab | Python 3.8+
```Python hl_lines="1 3 13-17"
-{!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an.py!}
```
////
@@ -88,7 +88,7 @@
///
```Python hl_lines="1 2 11-15"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
@@ -102,7 +102,7 @@
///
```Python hl_lines="1 2 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
@@ -112,7 +112,7 @@
//// tab | Python 3.10+
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py310.py!}
```
////
@@ -120,7 +120,7 @@
//// tab | Python 3.9+
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py39.py!}
```
////
@@ -128,7 +128,7 @@
//// tab | Python 3.8+
```Python hl_lines="19-20"
-{!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an.py!}
```
////
@@ -142,7 +142,7 @@
///
```Python hl_lines="17-18"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
@@ -156,7 +156,7 @@
///
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
diff --git a/docs/uk/docs/tutorial/first-steps.md b/docs/uk/docs/tutorial/first-steps.md
index 784da65f5..6f79c0d1d 100644
--- a/docs/uk/docs/tutorial/first-steps.md
+++ b/docs/uk/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
Найпростіший файл FastAPI може виглядати так:
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Скопіюйте це до файлу `main.py`.
@@ -158,7 +158,7 @@ OpenAPI описує схему для вашого API. І ця схема вк
### Крок 1: імпортуємо `FastAPI`
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI` це клас у Python, який надає всю функціональність для API.
@@ -174,7 +174,7 @@ OpenAPI описує схему для вашого API. І ця схема вк
### Крок 2: створюємо екземпляр `FastAPI`
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Змінна `app` є екземпляром класу `FastAPI`.
@@ -243,7 +243,7 @@ https://example.com/items/foo
#### Визначте декоратор операції шляху (path operation decorator)
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Декоратор `@app.get("/")` вказує **FastAPI**, що функція нижче, відповідає за обробку запитів, які надходять до неї:
@@ -298,7 +298,7 @@ https://example.com/items/foo
* **функція**: це функція, яка знаходиться нижче "декоратора" (нижче `@app.get("/")`).
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Це звичайна функція Python.
@@ -312,7 +312,7 @@ FastAPI викликатиме її щоразу, коли отримає зап
Ви також можете визначити її як звичайну функцію замість `async def`:
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note | "Примітка"
@@ -324,7 +324,7 @@ FastAPI викликатиме її щоразу, коли отримає зап
### Крок 5: поверніть результат
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Ви можете повернути `dict`, `list`, а також окремі значення `str`, `int`, ітд.
diff --git a/docs/vi/docs/python-types.md b/docs/vi/docs/python-types.md
index 99d1d207f..275b0eb39 100644
--- a/docs/vi/docs/python-types.md
+++ b/docs/vi/docs/python-types.md
@@ -23,7 +23,7 @@ Nếu bạn là một chuyên gia về Python, và bạn đã biết mọi thứ
Hãy bắt đầu với một ví dụ đơn giản:
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
Kết quả khi gọi chương trình này:
@@ -39,7 +39,7 @@ Hàm thực hiện như sau:
* <abbr title="Đặt chúng lại với nhau thành một. Với các nội dung lần lượt.">Nối</abbr> chúng lại với nhau bằng một kí tự trắng ở giữa.
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### Sửa đổi
@@ -83,7 +83,7 @@ Chính là nó.
Những thứ đó là "type hints":
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
Đó không giống như khai báo những giá trị mặc định giống như:
@@ -113,7 +113,7 @@ Với cái đó, bạn có thể cuộn, nhìn thấy các lựa chọn, cho đ
Kiểm tra hàm này, nó đã có gợi ý kiểu dữ liệu:
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
Bởi vì trình soạn thảo biết kiểu dữ liệu của các biến, bạn không chỉ có được completion, bạn cũng được kiểm tra lỗi:
@@ -123,7 +123,7 @@ Bởi vì trình soạn thảo biết kiểu dữ liệu của các biến, bạ
Bây giờ bạn biết rằng bạn phải sửa nó, chuyển `age` sang một xâu với `str(age)`:
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## Khai báo các kiểu dữ liệu
@@ -144,7 +144,7 @@ Bạn có thể sử dụng, ví dụ:
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### Các kiểu dữ liệu tổng quát với tham số kiểu dữ liệu
@@ -182,7 +182,7 @@ Tương tự kiểu dữ liệu `list`.
Như danh sách là một kiểu dữ liệu chứa một vài kiểu dữ liệu có sẵn, bạn đặt chúng trong các dấu ngoặc vuông:
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006_py39.py!}
+{!> ../../docs_src/python_types/tutorial006_py39.py!}
```
////
@@ -192,7 +192,7 @@ Như danh sách là một kiểu dữ liệu chứa một vài kiểu dữ liệ
Từ `typing`, import `List` (với chữ cái `L` viết hoa):
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
Khai báo biến với cùng dấu hai chấm (`:`).
@@ -202,7 +202,7 @@ Tương tự như kiểu dữ liệu, `List` bạn import từ `typing`.
Như danh sách là một kiểu dữ liệu chứa các kiểu dữ liệu có sẵn, bạn đặt chúng bên trong dấu ngoặc vuông:
```Python hl_lines="4"
-{!> ../../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
////
@@ -240,7 +240,7 @@ Bạn sẽ làm điều tương tự để khai báo các `tuple` và các `set
//// tab | Python 3.9+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial007_py39.py!}
+{!> ../../docs_src/python_types/tutorial007_py39.py!}
```
////
@@ -248,7 +248,7 @@ Bạn sẽ làm điều tương tự để khai báo các `tuple` và các `set
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial007.py!}
+{!> ../../docs_src/python_types/tutorial007.py!}
```
////
@@ -269,7 +269,7 @@ Tham số kiểu dữ liệu thứ hai dành cho giá trị của `dict`.
//// tab | Python 3.9+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008_py39.py!}
+{!> ../../docs_src/python_types/tutorial008_py39.py!}
```
////
@@ -277,7 +277,7 @@ Tham số kiểu dữ liệu thứ hai dành cho giá trị của `dict`.
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008.py!}
+{!> ../../docs_src/python_types/tutorial008.py!}
```
////
@@ -302,7 +302,7 @@ Trong Python 3.10 cũng có một **cú pháp mới** mà bạn có thể đặt
//// tab | Python 3.10+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial008b_py310.py!}
+{!> ../../docs_src/python_types/tutorial008b_py310.py!}
```
////
@@ -310,7 +310,7 @@ Trong Python 3.10 cũng có một **cú pháp mới** mà bạn có thể đặt
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial008b.py!}
+{!> ../../docs_src/python_types/tutorial008b.py!}
```
////
@@ -324,7 +324,7 @@ Bạn có thể khai báo một giá trị có thể có một kiểu dữ liệ
Trong Python 3.6 hoặc lớn hơn (bao gồm Python 3.10) bạn có thể khai báo nó bằng các import và sử dụng `Optional` từ mô đun `typing`.
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009.py!}
+{!../../docs_src/python_types/tutorial009.py!}
```
Sử dụng `Optional[str]` thay cho `str` sẽ cho phép trình soạn thảo giúp bạn phát hiện các lỗi mà bạn có thể gặp như một giá trị luôn là một `str`, trong khi thực tế nó rất có thể là `None`.
@@ -336,7 +336,7 @@ Sử dụng `Optional[str]` thay cho `str` sẽ cho phép trình soạn thảo g
//// tab | Python 3.10+
```Python hl_lines="1"
-{!> ../../../docs_src/python_types/tutorial009_py310.py!}
+{!> ../../docs_src/python_types/tutorial009_py310.py!}
```
////
@@ -344,7 +344,7 @@ Sử dụng `Optional[str]` thay cho `str` sẽ cho phép trình soạn thảo g
//// tab | Python 3.8+
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009.py!}
+{!> ../../docs_src/python_types/tutorial009.py!}
```
////
@@ -352,7 +352,7 @@ Sử dụng `Optional[str]` thay cho `str` sẽ cho phép trình soạn thảo g
//// tab | Python 3.8+ alternative
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial009b.py!}
+{!> ../../docs_src/python_types/tutorial009b.py!}
```
////
@@ -375,7 +375,7 @@ Nó chỉ là về các từ và tên. Nhưng những từ đó có thể ảnh
Cho một ví dụ, hãy để ý hàm này:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009c.py!}
+{!../../docs_src/python_types/tutorial009c.py!}
```
Tham số `name` được định nghĩa là `Optional[str]`, nhưng nó **không phải là tùy chọn**, bạn không thể gọi hàm mà không có tham số:
@@ -393,7 +393,7 @@ say_hi(name=None) # This works, None is valid 🎉
Tin tốt là, khi bạn sử dụng Python 3.10, bạn sẽ không phải lo lắng về điều đó, bạn sẽ có thể sử dụng `|` để định nghĩa hợp của các kiểu dữ liệu một cách đơn giản:
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial009c_py310.py!}
+{!../../docs_src/python_types/tutorial009c_py310.py!}
```
Và sau đó, bạn sẽ không phải lo rằng những cái tên như `Optional` và `Union`. 😎
@@ -458,13 +458,13 @@ Bạn cũng có thể khai báo một lớp như là kiểu dữ liệu của m
Hãy nói rằng bạn muốn có một lớp `Person` với một tên:
```Python hl_lines="1-3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Sau đó bạn có thể khai báo một biến có kiểu là `Person`:
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
Và lại một lần nữa, bạn có được tất cả sự hỗ trợ từ trình soạn thảo:
@@ -492,7 +492,7 @@ Một ví dụ từ tài liệu chính thức của Pydantic:
//// tab | Python 3.10+
```Python
-{!> ../../../docs_src/python_types/tutorial011_py310.py!}
+{!> ../../docs_src/python_types/tutorial011_py310.py!}
```
////
@@ -500,7 +500,7 @@ Một ví dụ từ tài liệu chính thức của Pydantic:
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/python_types/tutorial011_py39.py!}
+{!> ../../docs_src/python_types/tutorial011_py39.py!}
```
////
@@ -508,7 +508,7 @@ Một ví dụ từ tài liệu chính thức của Pydantic:
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/python_types/tutorial011.py!}
+{!> ../../docs_src/python_types/tutorial011.py!}
```
////
@@ -538,7 +538,7 @@ Python cũng có một tính năng cho phép đặt **metadata bổ sung** trong
Trong Python 3.9, `Annotated` là một phần của thư viện chuẩn, do đó bạn có thể import nó từ `typing`.
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial013_py39.py!}
+{!> ../../docs_src/python_types/tutorial013_py39.py!}
```
////
@@ -550,7 +550,7 @@ Trong Python 3.9, `Annotated` là một phần của thư viện chuẩn, do đ
Nó đã được cài đặt sẵng cùng với **FastAPI**.
```Python hl_lines="1 4"
-{!> ../../../docs_src/python_types/tutorial013.py!}
+{!> ../../docs_src/python_types/tutorial013.py!}
```
////
diff --git a/docs/vi/docs/tutorial/first-steps.md b/docs/vi/docs/tutorial/first-steps.md
index ce808eb91..d80d78506 100644
--- a/docs/vi/docs/tutorial/first-steps.md
+++ b/docs/vi/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
Tệp tin FastAPI đơn giản nhất có thể trông như này:
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Sao chép sang một tệp tin `main.py`.
@@ -134,7 +134,7 @@ Bạn cũng có thể sử dụng nó để sinh code tự động, với các c
### Bước 1: import `FastAPI`
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI` là một Python class cung cấp tất cả chức năng cho API của bạn.
@@ -150,7 +150,7 @@ Bạn cũng có thể sử dụng tất cả <a href="https://www.starlette.io/"
### Bước 2: Tạo một `FastAPI` "instance"
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Biến `app` này là một "instance" của class `FastAPI`.
@@ -172,7 +172,7 @@ $ uvicorn main:app --reload
Nếu bạn tạo ứng dụng của bạn giống như:
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial002.py!}
+{!../../docs_src/first_steps/tutorial002.py!}
```
Và đặt nó trong một tệp tin `main.py`, sau đó bạn sẽ gọi `uvicorn` giống như:
@@ -251,7 +251,7 @@ Chúng ta cũng sẽ gọi chúng là "**các toán tử**".
#### Định nghĩa moojt *decorator cho đường dẫn toán tử*
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`@app.get("/")` nói **FastAPI** rằng hàm bên dưới có trách nhiệm xử lí request tới:
@@ -307,7 +307,7 @@ Ví dụ, khi sử dụng GraphQL bạn thông thường thực hiện tất c
* **hàm**: là hàm bên dưới "decorator" (bên dưới `@app.get("/")`).
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Đây là một hàm Python.
@@ -321,7 +321,7 @@ Trong trường hợp này, nó là một hàm `async`.
Bạn cũng có thể định nghĩa nó như là một hàm thông thường thay cho `async def`:
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note
@@ -333,7 +333,7 @@ Nếu bạn không biết sự khác nhau, kiểm tra [Async: *"Trong khi vội
### Bước 5: Nội dung trả về
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
Bạn có thể trả về một `dict`, `list`, một trong những giá trị đơn như `str`, `int`,...
diff --git a/docs/zh/docs/advanced/additional-responses.md b/docs/zh/docs/advanced/additional-responses.md
index 1fc634933..f051b12a4 100644
--- a/docs/zh/docs/advanced/additional-responses.md
+++ b/docs/zh/docs/advanced/additional-responses.md
@@ -17,7 +17,7 @@
例如，要声明另一个具有状态码 `404` 和`Pydantic`模型 `Message` 的响应，可以写：
```Python hl_lines="18 22"
-{!../../../docs_src/additional_responses/tutorial001.py!}
+{!../../docs_src/additional_responses/tutorial001.py!}
```
/// note
@@ -164,7 +164,7 @@
例如，您可以添加一个额外的媒体类型` image/png` ，声明您的路径操作可以返回JSON对象（媒体类型 `application/json` ）或PNG图像：
```Python hl_lines="19-24 28"
-{!../../../docs_src/additional_responses/tutorial002.py!}
+{!../../docs_src/additional_responses/tutorial002.py!}
```
/// note
@@ -192,7 +192,7 @@
以及一个状态码为 `200` 的响应，它使用您的 `response_model` ，但包含自定义的 `example` ：
```Python hl_lines="20-31"
-{!../../../docs_src/additional_responses/tutorial003.py!}
+{!../../docs_src/additional_responses/tutorial003.py!}
```
所有这些都将被合并并包含在您的OpenAPI中，并在API文档中显示：
@@ -220,7 +220,7 @@ new_dict = {**old_dict, "new key": "new value"}
您可以使用该技术在路径操作中重用一些预定义的响应，并将它们与其他自定义响应相结合。
**例如：**
```Python hl_lines="13-17 26"
-{!../../../docs_src/additional_responses/tutorial004.py!}
+{!../../docs_src/additional_responses/tutorial004.py!}
```
## 有关OpenAPI响应的更多信息
diff --git a/docs/zh/docs/advanced/additional-status-codes.md b/docs/zh/docs/advanced/additional-status-codes.md
index 06320faad..f79b853ef 100644
--- a/docs/zh/docs/advanced/additional-status-codes.md
+++ b/docs/zh/docs/advanced/additional-status-codes.md
@@ -15,7 +15,7 @@
要实现它，导入 `JSONResponse`，然后在其中直接返回你的内容，并将 `status_code` 设置为为你要的值。
```Python hl_lines="4 25"
-{!../../../docs_src/additional_status_codes/tutorial001.py!}
+{!../../docs_src/additional_status_codes/tutorial001.py!}
```
/// warning | "警告"
diff --git a/docs/zh/docs/advanced/advanced-dependencies.md b/docs/zh/docs/advanced/advanced-dependencies.md
index 3d8afbb62..f3fe1e395 100644
--- a/docs/zh/docs/advanced/advanced-dependencies.md
+++ b/docs/zh/docs/advanced/advanced-dependencies.md
@@ -19,7 +19,7 @@ Python 可以把类实例变为**可调用项**。
为此，需要声明 `__call__` 方法：
```Python hl_lines="10"
-{!../../../docs_src/dependencies/tutorial011.py!}
+{!../../docs_src/dependencies/tutorial011.py!}
```
本例中，**FastAPI** 使用 `__call__` 检查附加参数及子依赖项，稍后，还要调用它向*路径操作函数*传递值。
@@ -29,7 +29,7 @@ Python 可以把类实例变为**可调用项**。
接下来，使用 `__init__` 声明用于**参数化**依赖项的实例参数：
```Python hl_lines="7"
-{!../../../docs_src/dependencies/tutorial011.py!}
+{!../../docs_src/dependencies/tutorial011.py!}
```
本例中，**FastAPI** 不使用 `__init__`，我们要直接在代码中使用。
@@ -39,7 +39,7 @@ Python 可以把类实例变为**可调用项**。
使用以下代码创建类实例：
```Python hl_lines="16"
-{!../../../docs_src/dependencies/tutorial011.py!}
+{!../../docs_src/dependencies/tutorial011.py!}
```
这样就可以**参数化**依赖项，它包含 `checker.fixed_content` 的属性 - `"bar"`。
@@ -57,7 +57,7 @@ checker(q="somequery")
……并用*路径操作函数*的参数 `fixed_content_included` 返回依赖项的值：
```Python hl_lines="20"
-{!../../../docs_src/dependencies/tutorial011.py!}
+{!../../docs_src/dependencies/tutorial011.py!}
```
/// tip | "提示"
diff --git a/docs/zh/docs/advanced/behind-a-proxy.md b/docs/zh/docs/advanced/behind-a-proxy.md
index 52f6acda1..8c4b6bb04 100644
--- a/docs/zh/docs/advanced/behind-a-proxy.md
+++ b/docs/zh/docs/advanced/behind-a-proxy.md
@@ -93,7 +93,7 @@ ASGI 规范定义的 `root_path` 就是为了这种用例。
我们在这里的信息里包含 `roo_path` 只是为了演示。
```Python hl_lines="8"
-{!../../../docs_src/behind_a_proxy/tutorial001.py!}
+{!../../docs_src/behind_a_proxy/tutorial001.py!}
```
然后，用以下命令启动 Uvicorn：
@@ -122,7 +122,7 @@ $ uvicorn main:app --root-path /api/v1
还有一种方案，如果不能提供 `--root-path` 或等效的命令行选项，则在创建 FastAPI 应用时要设置 `root_path` 参数。
```Python hl_lines="3"
-{!../../../docs_src/behind_a_proxy/tutorial002.py!}
+{!../../docs_src/behind_a_proxy/tutorial002.py!}
```
传递 `root_path` 给 `FastAPI` 与传递 `--root-path` 命令行选项给 Uvicorn 或 Hypercorn 一样。
@@ -304,7 +304,7 @@ $ uvicorn main:app --root-path /api/v1
例如：
```Python hl_lines="4-7"
-{!../../../docs_src/behind_a_proxy/tutorial003.py!}
+{!../../docs_src/behind_a_proxy/tutorial003.py!}
```
这段代码生产如下 OpenAPI 概图：
@@ -353,7 +353,7 @@ API 文档与所选的服务器进行交互。
如果不想让 **FastAPI** 包含使用 `root_path` 的自动服务器，则要使用参数 `root_path_in_servers=False`：
```Python hl_lines="9"
-{!../../../docs_src/behind_a_proxy/tutorial004.py!}
+{!../../docs_src/behind_a_proxy/tutorial004.py!}
```
这样，就不会在 OpenAPI 概图中包含服务器了。
diff --git a/docs/zh/docs/advanced/custom-response.md b/docs/zh/docs/advanced/custom-response.md
index 9594c72ac..27c026904 100644
--- a/docs/zh/docs/advanced/custom-response.md
+++ b/docs/zh/docs/advanced/custom-response.md
@@ -25,7 +25,7 @@
导入你想要使用的 `Response` 类（子类）然后在 *路径操作装饰器* 中声明它。
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial001b.py!}
+{!../../docs_src/custom_response/tutorial001b.py!}
```
/// info | "提示"
@@ -52,7 +52,7 @@
* 将 `HTMLResponse` 作为你的 *路径操作* 的 `response_class` 参数传入。
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial002.py!}
+{!../../docs_src/custom_response/tutorial002.py!}
```
/// info | "提示"
@@ -72,7 +72,7 @@
和上面一样的例子，返回一个 `HTMLResponse` 看起来可能是这样：
```Python hl_lines="2 7 19"
-{!../../../docs_src/custom_response/tutorial003.py!}
+{!../../docs_src/custom_response/tutorial003.py!}
```
/// warning | "警告"
@@ -98,7 +98,7 @@
比如像这样：
```Python hl_lines="7 23 21"
-{!../../../docs_src/custom_response/tutorial004.py!}
+{!../../docs_src/custom_response/tutorial004.py!}
```
在这个例子中，函数 `generate_html_response()` 已经生成并返回 `Response` 对象而不是在 `str` 中返回 HTML。
@@ -140,7 +140,7 @@ FastAPI（实际上是 Starlette）将自动包含 Content-Length 的头。它
```Python hl_lines="1 18"
-{!../../../docs_src/response_directly/tutorial002.py!}
+{!../../docs_src/response_directly/tutorial002.py!}
```
### `HTMLResponse`
@@ -152,7 +152,7 @@ FastAPI（实际上是 Starlette）将自动包含 Content-Length 的头。它
接受文本或字节并返回纯文本响应。
```Python hl_lines="2 7 9"
-{!../../../docs_src/custom_response/tutorial005.py!}
+{!../../docs_src/custom_response/tutorial005.py!}
```
### `JSONResponse`
@@ -177,7 +177,7 @@ FastAPI（实际上是 Starlette）将自动包含 Content-Length 的头。它
///
```Python hl_lines="2 7"
-{!../../../docs_src/custom_response/tutorial001.py!}
+{!../../docs_src/custom_response/tutorial001.py!}
```
/// tip | "小贴士"
@@ -191,7 +191,7 @@ FastAPI（实际上是 Starlette）将自动包含 Content-Length 的头。它
返回 HTTP 重定向。默认情况下使用 307 状态代码（临时重定向）。
```Python hl_lines="2 9"
-{!../../../docs_src/custom_response/tutorial006.py!}
+{!../../docs_src/custom_response/tutorial006.py!}
```
### `StreamingResponse`
@@ -199,7 +199,7 @@ FastAPI（实际上是 Starlette）将自动包含 Content-Length 的头。它
采用异步生成器或普通生成器/迭代器，然后流式传输响应主体。
```Python hl_lines="2 14"
-{!../../../docs_src/custom_response/tutorial007.py!}
+{!../../docs_src/custom_response/tutorial007.py!}
```
#### 对类似文件的对象使用 `StreamingResponse`
@@ -209,7 +209,7 @@ FastAPI（实际上是 Starlette）将自动包含 Content-Length 的头。它
包括许多与云存储，视频处理等交互的库。
```Python hl_lines="2 10-12 14"
-{!../../../docs_src/custom_response/tutorial008.py!}
+{!../../docs_src/custom_response/tutorial008.py!}
```
/// tip | "小贴士"
@@ -232,7 +232,7 @@ FastAPI（实际上是 Starlette）将自动包含 Content-Length 的头。它
文件响应将包含适当的 `Content-Length`，`Last-Modified` 和 `ETag` 的响应头。
```Python hl_lines="2 10"
-{!../../../docs_src/custom_response/tutorial009.py!}
+{!../../docs_src/custom_response/tutorial009.py!}
```
## 额外文档
diff --git a/docs/zh/docs/advanced/dataclasses.md b/docs/zh/docs/advanced/dataclasses.md
index 72567e245..f33c05ff4 100644
--- a/docs/zh/docs/advanced/dataclasses.md
+++ b/docs/zh/docs/advanced/dataclasses.md
@@ -5,7 +5,7 @@ FastAPI 基于 **Pydantic** 构建，前文已经介绍过如何使用 Pydantic
但 FastAPI 还可以使用数据类（<a href="https://docs.python.org/3/library/dataclasses.html" class="external-link" target="_blank">`dataclasses`</a>）：
```Python hl_lines="1 7-12 19-20"
-{!../../../docs_src/dataclasses/tutorial001.py!}
+{!../../docs_src/dataclasses/tutorial001.py!}
```
这还是借助于 **Pydantic** 及其<a href="https://pydantic-docs.helpmanual.io/usage/dataclasses/#use-of-stdlib-dataclasses-with-basemodel" class="external-link" target="_blank">内置的 `dataclasses`</a>。
@@ -35,7 +35,7 @@ FastAPI 基于 **Pydantic** 构建，前文已经介绍过如何使用 Pydantic
在 `response_model` 参数中使用 `dataclasses`：
```Python hl_lines="1 7-13 19"
-{!../../../docs_src/dataclasses/tutorial002.py!}
+{!../../docs_src/dataclasses/tutorial002.py!}
```
本例把数据类自动转换为 Pydantic 数据类。
@@ -53,7 +53,7 @@ API 文档中也会显示相关概图：
本例把标准的 `dataclasses` 直接替换为 `pydantic.dataclasses`：
```{ .python .annotate hl_lines="1 5 8-11 14-17 23-25 28" }
-{!../../../docs_src/dataclasses/tutorial003.py!}
+{!../../docs_src/dataclasses/tutorial003.py!}
```
1. 本例依然要从标准的 `dataclasses` 中导入 `field`；
diff --git a/docs/zh/docs/advanced/events.md b/docs/zh/docs/advanced/events.md
index c9389f533..e5b44f321 100644
--- a/docs/zh/docs/advanced/events.md
+++ b/docs/zh/docs/advanced/events.md
@@ -15,7 +15,7 @@
使用 `startup` 事件声明 `app` 启动前运行的函数：
```Python hl_lines="8"
-{!../../../docs_src/events/tutorial001.py!}
+{!../../docs_src/events/tutorial001.py!}
```
本例中，`startup` 事件处理器函数为项目数据库（只是**字典**）提供了一些初始值。
@@ -29,7 +29,7 @@
使用 `shutdown` 事件声明 `app` 关闭时运行的函数：
```Python hl_lines="6"
-{!../../../docs_src/events/tutorial002.py!}
+{!../../docs_src/events/tutorial002.py!}
```
此处，`shutdown` 事件处理器函数在 `log.txt` 中写入一行文本 `Application shutdown`。
diff --git a/docs/zh/docs/advanced/generate-clients.md b/docs/zh/docs/advanced/generate-clients.md
index 56aad3bd2..baf131361 100644
--- a/docs/zh/docs/advanced/generate-clients.md
+++ b/docs/zh/docs/advanced/generate-clients.md
@@ -19,7 +19,7 @@
//// tab | Python 3.9+
```Python hl_lines="7-9 12-13 16-17 21"
-{!> ../../../docs_src/generate_clients/tutorial001_py39.py!}
+{!> ../../docs_src/generate_clients/tutorial001_py39.py!}
```
////
@@ -27,7 +27,7 @@
//// tab | Python 3.8+
```Python hl_lines="9-11 14-15 18 19 23"
-{!> ../../../docs_src/generate_clients/tutorial001.py!}
+{!> ../../docs_src/generate_clients/tutorial001.py!}
```
////
@@ -138,7 +138,7 @@ frontend-app@1.0.0 generate-client /home/user/code/frontend-app
//// tab | Python 3.9+
```Python hl_lines="21 26 34"
-{!> ../../../docs_src/generate_clients/tutorial002_py39.py!}
+{!> ../../docs_src/generate_clients/tutorial002_py39.py!}
```
////
@@ -146,7 +146,7 @@ frontend-app@1.0.0 generate-client /home/user/code/frontend-app
//// tab | Python 3.8+
```Python hl_lines="23 28 36"
-{!> ../../../docs_src/generate_clients/tutorial002.py!}
+{!> ../../docs_src/generate_clients/tutorial002.py!}
```
////
@@ -199,7 +199,7 @@ FastAPI为每个*路径操作*使用一个**唯一ID**，它用于**操作ID**
//// tab | Python 3.9+
```Python hl_lines="6-7 10"
-{!> ../../../docs_src/generate_clients/tutorial003_py39.py!}
+{!> ../../docs_src/generate_clients/tutorial003_py39.py!}
```
////
@@ -207,7 +207,7 @@ FastAPI为每个*路径操作*使用一个**唯一ID**，它用于**操作ID**
//// tab | Python 3.8+
```Python hl_lines="8-9 12"
-{!> ../../../docs_src/generate_clients/tutorial003.py!}
+{!> ../../docs_src/generate_clients/tutorial003.py!}
```
////
@@ -233,7 +233,7 @@ FastAPI为每个*路径操作*使用一个**唯一ID**，它用于**操作ID**
我们可以将 OpenAPI JSON 下载到一个名为`openapi.json`的文件中，然后使用以下脚本**删除此前缀的标签**：
```Python
-{!../../../docs_src/generate_clients/tutorial004.py!}
+{!../../docs_src/generate_clients/tutorial004.py!}
```
通过这样做，操作ID将从类似于 `items-get_items` 的名称重命名为 `get_items` ，这样客户端生成器就可以生成更简洁的方法名称。
diff --git a/docs/zh/docs/advanced/middleware.md b/docs/zh/docs/advanced/middleware.md
index 926082b94..525dc89ac 100644
--- a/docs/zh/docs/advanced/middleware.md
+++ b/docs/zh/docs/advanced/middleware.md
@@ -58,7 +58,7 @@ app.add_middleware(UnicornMiddleware, some_config="rainbow")
任何传向 `http` 或 `ws` 的请求都会被重定向至安全方案。
```Python hl_lines="2 6"
-{!../../../docs_src/advanced_middleware/tutorial001.py!}
+{!../../docs_src/advanced_middleware/tutorial001.py!}
```
## `TrustedHostMiddleware`
@@ -66,7 +66,7 @@ app.add_middleware(UnicornMiddleware, some_config="rainbow")
强制所有传入请求都必须正确设置 `Host` 请求头，以防 HTTP 主机头攻击。
```Python hl_lines="2 6-8"
-{!../../../docs_src/advanced_middleware/tutorial002.py!}
+{!../../docs_src/advanced_middleware/tutorial002.py!}
```
支持以下参数：
@@ -82,7 +82,7 @@ app.add_middleware(UnicornMiddleware, some_config="rainbow")
中间件会处理标准响应与流响应。
```Python hl_lines="2 6"
-{!../../../docs_src/advanced_middleware/tutorial003.py!}
+{!../../docs_src/advanced_middleware/tutorial003.py!}
```
支持以下参数：
diff --git a/docs/zh/docs/advanced/openapi-callbacks.md b/docs/zh/docs/advanced/openapi-callbacks.md
index 7c7323cb5..dc1c2539b 100644
--- a/docs/zh/docs/advanced/openapi-callbacks.md
+++ b/docs/zh/docs/advanced/openapi-callbacks.md
@@ -32,7 +32,7 @@ API 的用户 （外部开发者）要在您的 API 内使用 POST 请求创建
这部分代码很常规，您对绝大多数代码应该都比较熟悉了：
```Python hl_lines="10-14 37-54"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
/// tip | "提示"
@@ -93,7 +93,7 @@ requests.post(callback_url, json={"description": "Invoice paid", "paid": True})
首先，新建包含一些用于回调的 `APIRouter`。
```Python hl_lines="5 26"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
### 创建回调*路径操作*
@@ -106,7 +106,7 @@ requests.post(callback_url, json={"description": "Invoice paid", "paid": True})
* 还要声明要返回的响应，例如，`response_model=InvoiceEventReceived`
```Python hl_lines="17-19 22-23 29-33"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
回调*路径操作*与常规*路径操作*有两点主要区别：
@@ -176,7 +176,7 @@ JSON 请求体包含如下内容：
现在使用 API *路径操作装饰器*的参数 `callbacks`，从回调路由传递属性 `.routes`（实际上只是路由/路径操作的**列表**）：
```Python hl_lines="36"
-{!../../../docs_src/openapi_callbacks/tutorial001.py!}
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
/// tip | "提示"
diff --git a/docs/zh/docs/advanced/path-operation-advanced-configuration.md b/docs/zh/docs/advanced/path-operation-advanced-configuration.md
index c37846916..0d77dd69e 100644
--- a/docs/zh/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/zh/docs/advanced/path-operation-advanced-configuration.md
@@ -13,7 +13,7 @@
务必确保每个操作路径的 `operation_id` 都是唯一的。
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
```
### 使用 *路径操作函数* 的函数名作为 operationId
@@ -23,7 +23,7 @@
你应该在添加了所有 *路径操作* 之后执行此操作。
```Python hl_lines="2 12 13 14 15 16 17 18 19 20 21 24"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
```
/// tip
@@ -45,7 +45,7 @@
使用参数 `include_in_schema` 并将其设置为 `False` ，来从生成的 OpenAPI 方案中排除一个 *路径操作*（这样一来，就从自动化文档系统中排除掉了）。
```Python hl_lines="6"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
```
## docstring 的高级描述
@@ -58,5 +58,5 @@
```Python hl_lines="19 20 21 22 23 24 25 26 27 28 29"
-{!../../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
+{!../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
```
diff --git a/docs/zh/docs/advanced/response-change-status-code.md b/docs/zh/docs/advanced/response-change-status-code.md
index a289cf201..c38f80f1f 100644
--- a/docs/zh/docs/advanced/response-change-status-code.md
+++ b/docs/zh/docs/advanced/response-change-status-code.md
@@ -21,7 +21,7 @@
然后你可以在这个*临时*响应对象中设置`status_code`。
```Python hl_lines="1 9 12"
-{!../../../docs_src/response_change_status_code/tutorial001.py!}
+{!../../docs_src/response_change_status_code/tutorial001.py!}
```
然后你可以像平常一样返回任何你需要的对象（例如一个`dict`或者一个数据库模型）。如果你声明了一个`response_model`，它仍然会被用来过滤和转换你返回的对象。
diff --git a/docs/zh/docs/advanced/response-cookies.md b/docs/zh/docs/advanced/response-cookies.md
index dd942a981..5772664b0 100644
--- a/docs/zh/docs/advanced/response-cookies.md
+++ b/docs/zh/docs/advanced/response-cookies.md
@@ -5,7 +5,7 @@
你可以在 *路径函数* 中定义一个类型为 `Response`的参数，这样你就可以在这个临时响应对象中设置cookie了。
```Python hl_lines="1 8-9"
-{!../../../docs_src/response_cookies/tutorial002.py!}
+{!../../docs_src/response_cookies/tutorial002.py!}
```
而且你还可以根据你的需要响应不同的对象，比如常用的 `dict`，数据库model等。
@@ -25,7 +25,7 @@
然后设置Cookies，并返回：
```Python hl_lines="10-12"
-{!../../../docs_src/response_cookies/tutorial001.py!}
+{!../../docs_src/response_cookies/tutorial001.py!}
```
/// tip
diff --git a/docs/zh/docs/advanced/response-directly.md b/docs/zh/docs/advanced/response-directly.md
index b2c7de8fd..9d191c622 100644
--- a/docs/zh/docs/advanced/response-directly.md
+++ b/docs/zh/docs/advanced/response-directly.md
@@ -36,7 +36,7 @@
```Python hl_lines="4 6 20 21"
-{!../../../docs_src/response_directly/tutorial001.py!}
+{!../../docs_src/response_directly/tutorial001.py!}
```
/// note | "技术细节"
@@ -58,7 +58,7 @@
你可以把你的 XML 内容放到一个字符串中，放到一个 `Response` 中，然后返回。
```Python hl_lines="1 18"
-{!../../../docs_src/response_directly/tutorial002.py!}
+{!../../docs_src/response_directly/tutorial002.py!}
```
## 说明
diff --git a/docs/zh/docs/advanced/response-headers.md b/docs/zh/docs/advanced/response-headers.md
index e18d1620d..d593fdccc 100644
--- a/docs/zh/docs/advanced/response-headers.md
+++ b/docs/zh/docs/advanced/response-headers.md
@@ -6,7 +6,7 @@
然后你可以在这个*临时*响应对象中设置头部。
```Python hl_lines="1 7-8"
-{!../../../docs_src/response_headers/tutorial002.py!}
+{!../../docs_src/response_headers/tutorial002.py!}
```
然后你可以像平常一样返回任何你需要的对象（例如一个`dict`或者一个数据库模型）。如果你声明了一个`response_model`，它仍然会被用来过滤和转换你返回的对象。
@@ -21,7 +21,7 @@
按照[直接返回响应](response-directly.md){.internal-link target=_blank}中所述创建响应，并将头部作为附加参数传递：
```Python hl_lines="10-12"
-{!../../../docs_src/response_headers/tutorial001.py!}
+{!../../docs_src/response_headers/tutorial001.py!}
```
diff --git a/docs/zh/docs/advanced/security/http-basic-auth.md b/docs/zh/docs/advanced/security/http-basic-auth.md
index a76353186..06c6dbbab 100644
--- a/docs/zh/docs/advanced/security/http-basic-auth.md
+++ b/docs/zh/docs/advanced/security/http-basic-auth.md
@@ -23,7 +23,7 @@ HTTP 基础授权让浏览器显示内置的用户名与密码提示。
//// tab | Python 3.9+
```Python hl_lines="4 8 12"
-{!> ../../../docs_src/security/tutorial006_an_py39.py!}
+{!> ../../docs_src/security/tutorial006_an_py39.py!}
```
////
@@ -31,7 +31,7 @@ HTTP 基础授权让浏览器显示内置的用户名与密码提示。
//// tab | Python 3.8+
```Python hl_lines="2 7 11"
-{!> ../../../docs_src/security/tutorial006_an.py!}
+{!> ../../docs_src/security/tutorial006_an.py!}
```
////
@@ -45,7 +45,7 @@ HTTP 基础授权让浏览器显示内置的用户名与密码提示。
///
```Python hl_lines="2 6 10"
-{!> ../../../docs_src/security/tutorial006.py!}
+{!> ../../docs_src/security/tutorial006.py!}
```
////
@@ -71,7 +71,7 @@ HTTP 基础授权让浏览器显示内置的用户名与密码提示。
//// tab | Python 3.9+
```Python hl_lines="1 12-24"
-{!> ../../../docs_src/security/tutorial007_an_py39.py!}
+{!> ../../docs_src/security/tutorial007_an_py39.py!}
```
////
@@ -79,7 +79,7 @@ HTTP 基础授权让浏览器显示内置的用户名与密码提示。
//// tab | Python 3.8+
```Python hl_lines="1 12-24"
-{!> ../../../docs_src/security/tutorial007_an.py!}
+{!> ../../docs_src/security/tutorial007_an.py!}
```
////
@@ -93,7 +93,7 @@ HTTP 基础授权让浏览器显示内置的用户名与密码提示。
///
```Python hl_lines="1 11-21"
-{!> ../../../docs_src/security/tutorial007.py!}
+{!> ../../docs_src/security/tutorial007.py!}
```
////
@@ -163,7 +163,7 @@ if "stanleyjobsox" == "stanleyjobson" and "love123" == "swordfish":
//// tab | Python 3.9+
```Python hl_lines="26-30"
-{!> ../../../docs_src/security/tutorial007_an_py39.py!}
+{!> ../../docs_src/security/tutorial007_an_py39.py!}
```
////
@@ -171,7 +171,7 @@ if "stanleyjobsox" == "stanleyjobson" and "love123" == "swordfish":
//// tab | Python 3.8+
```Python hl_lines="26-30"
-{!> ../../../docs_src/security/tutorial007_an.py!}
+{!> ../../docs_src/security/tutorial007_an.py!}
```
////
@@ -185,7 +185,7 @@ if "stanleyjobsox" == "stanleyjobson" and "love123" == "swordfish":
///
```Python hl_lines="23-27"
-{!> ../../../docs_src/security/tutorial007.py!}
+{!> ../../docs_src/security/tutorial007.py!}
```
////
diff --git a/docs/zh/docs/advanced/security/oauth2-scopes.md b/docs/zh/docs/advanced/security/oauth2-scopes.md
index b75ae11a4..d6354230e 100644
--- a/docs/zh/docs/advanced/security/oauth2-scopes.md
+++ b/docs/zh/docs/advanced/security/oauth2-scopes.md
@@ -63,7 +63,7 @@ OAuth2 中，**作用域**只是声明特定权限的字符串。
首先，快速浏览一下以下代码与**用户指南**中 [OAuth2 实现密码哈希与 Bearer JWT 令牌验证](../../tutorial/security/oauth2-jwt.md){.internal-link target=_blank}一章中代码的区别。以下代码使用 OAuth2 作用域：
```Python hl_lines="2 4 8 12 46 64 105 107-115 121-124 128-134 139 153"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
下面，我们逐步说明修改的代码内容。
@@ -75,7 +75,7 @@ OAuth2 中，**作用域**只是声明特定权限的字符串。
`scopes` 参数接收**字典**，键是作用域、值是作用域的描述：
```Python hl_lines="62-65"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
因为声明了作用域，所以登录或授权时会在 API 文档中显示。
@@ -103,7 +103,7 @@ OAuth2 中，**作用域**只是声明特定权限的字符串。
///
```Python hl_lines="153"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
## 在*路径操作*与依赖项中声明作用域
@@ -131,7 +131,7 @@ OAuth2 中，**作用域**只是声明特定权限的字符串。
///
```Python hl_lines="4 139 166"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
/// info | "技术细节"
@@ -159,7 +159,7 @@ OAuth2 中，**作用域**只是声明特定权限的字符串。
`SecuriScopes` 类与 `Request` 类似（`Request` 用于直接提取请求对象）。
```Python hl_lines="8 105"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
## 使用 `scopes`
@@ -175,7 +175,7 @@ OAuth2 中，**作用域**只是声明特定权限的字符串。
该异常包含了作用域所需的（如有），以空格分割的字符串（使用 `scope_str`）。该字符串要放到包含作用域的 `WWW-Authenticate` 请求头中（这也是规范的要求）。
```Python hl_lines="105 107-115"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
## 校验 `username` 与数据形状
@@ -193,7 +193,7 @@ OAuth2 中，**作用域**只是声明特定权限的字符串。
还可以使用用户名验证用户，如果没有用户，也会触发之前创建的异常。
```Python hl_lines="46 116-127"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
## 校验 `scopes`
@@ -203,7 +203,7 @@ OAuth2 中，**作用域**只是声明特定权限的字符串。
为此，要使用包含所有作用域**字符串列表**的 `security_scopes.scopes`， 。
```Python hl_lines="128-134"
-{!../../../docs_src/security/tutorial005.py!}
+{!../../docs_src/security/tutorial005.py!}
```
## 依赖项树与作用域
diff --git a/docs/zh/docs/advanced/settings.md b/docs/zh/docs/advanced/settings.md
index 37a2d98d3..4d35731cb 100644
--- a/docs/zh/docs/advanced/settings.md
+++ b/docs/zh/docs/advanced/settings.md
@@ -151,7 +151,7 @@ Hello World from Python
您可以使用与 Pydantic 模型相同的验证功能和工具，比如不同的数据类型和使用 `Field()` 进行附加验证。
```Python hl_lines="2 5-8 11"
-{!../../../docs_src/settings/tutorial001.py!}
+{!../../docs_src/settings/tutorial001.py!}
```
/// tip
@@ -169,7 +169,7 @@ Hello World from Python
然后，您可以在应用程序中使用新的 `settings` 对象：
```Python hl_lines="18-20"
-{!../../../docs_src/settings/tutorial001.py!}
+{!../../docs_src/settings/tutorial001.py!}
```
### 运行服务器
@@ -205,13 +205,13 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
例如，您可以创建一个名为 `config.py` 的文件，其中包含以下内容：
```Python
-{!../../../docs_src/settings/app01/config.py!}
+{!../../docs_src/settings/app01/config.py!}
```
然后在一个名为 `main.py` 的文件中使用它：
```Python hl_lines="3 11-13"
-{!../../../docs_src/settings/app01/main.py!}
+{!../../docs_src/settings/app01/main.py!}
```
/// tip
@@ -231,7 +231,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
根据前面的示例，您的 `config.py` 文件可能如下所示：
```Python hl_lines="10"
-{!../../../docs_src/settings/app02/config.py!}
+{!../../docs_src/settings/app02/config.py!}
```
请注意，现在我们不创建默认实例 `settings = Settings()`。
@@ -243,7 +243,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
//// tab | Python 3.9+
```Python hl_lines="6 12-13"
-{!> ../../../docs_src/settings/app02_an_py39/main.py!}
+{!> ../../docs_src/settings/app02_an_py39/main.py!}
```
////
@@ -251,7 +251,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
//// tab | Python 3.8+
```Python hl_lines="6 12-13"
-{!> ../../../docs_src/settings/app02_an/main.py!}
+{!> ../../docs_src/settings/app02_an/main.py!}
```
////
@@ -265,7 +265,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
///
```Python hl_lines="5 11-12"
-{!> ../../../docs_src/settings/app02/main.py!}
+{!> ../../docs_src/settings/app02/main.py!}
```
////
@@ -283,7 +283,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
//// tab | Python 3.9+
```Python hl_lines="17 19-21"
-{!> ../../../docs_src/settings/app02_an_py39/main.py!}
+{!> ../../docs_src/settings/app02_an_py39/main.py!}
```
////
@@ -291,7 +291,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
//// tab | Python 3.8+
```Python hl_lines="17 19-21"
-{!> ../../../docs_src/settings/app02_an/main.py!}
+{!> ../../docs_src/settings/app02_an/main.py!}
```
////
@@ -305,7 +305,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
///
```Python hl_lines="16 18-20"
-{!> ../../../docs_src/settings/app02/main.py!}
+{!> ../../docs_src/settings/app02/main.py!}
```
////
@@ -315,7 +315,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
然后，在测试期间，通过创建 `get_settings` 的依赖项覆盖，很容易提供一个不同的设置对象：
```Python hl_lines="9-10 13 21"
-{!../../../docs_src/settings/app02/test_main.py!}
+{!../../docs_src/settings/app02/test_main.py!}
```
在依赖项覆盖中，我们在创建新的 `Settings` 对象时为 `admin_email` 设置了一个新值，然后返回该新对象。
@@ -358,7 +358,7 @@ APP_NAME="ChimichangApp"
然后，您可以使用以下方式更新您的 `config.py`：
```Python hl_lines="9-10"
-{!../../../docs_src/settings/app03/config.py!}
+{!../../docs_src/settings/app03/config.py!}
```
在这里，我们在 Pydantic 的 `Settings` 类中创建了一个名为 `Config` 的类，并将 `env_file` 设置为我们想要使用的 dotenv 文件的文件名。
@@ -395,7 +395,7 @@ def get_settings():
//// tab | Python 3.9+
```Python hl_lines="1 11"
-{!> ../../../docs_src/settings/app03_an_py39/main.py!}
+{!> ../../docs_src/settings/app03_an_py39/main.py!}
```
////
@@ -403,7 +403,7 @@ def get_settings():
//// tab | Python 3.8+
```Python hl_lines="1 11"
-{!> ../../../docs_src/settings/app03_an/main.py!}
+{!> ../../docs_src/settings/app03_an/main.py!}
```
////
@@ -417,7 +417,7 @@ def get_settings():
///
```Python hl_lines="1 10"
-{!> ../../../docs_src/settings/app03/main.py!}
+{!> ../../docs_src/settings/app03/main.py!}
```
////
diff --git a/docs/zh/docs/advanced/sub-applications.md b/docs/zh/docs/advanced/sub-applications.md
index a26301b50..f93ab1d24 100644
--- a/docs/zh/docs/advanced/sub-applications.md
+++ b/docs/zh/docs/advanced/sub-applications.md
@@ -11,7 +11,7 @@
首先，创建主（顶层）**FastAPI** 应用及其*路径操作*：
```Python hl_lines="3 6-8"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### 子应用
@@ -21,7 +21,7 @@
子应用只是另一个标准 FastAPI 应用，但这个应用是被**挂载**的应用：
```Python hl_lines="11 14-16"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### 挂载子应用
@@ -31,7 +31,7 @@
本例的子应用挂载在 `/subapi` 路径下：
```Python hl_lines="11 19"
-{!../../../docs_src/sub_applications/tutorial001.py!}
+{!../../docs_src/sub_applications/tutorial001.py!}
```
### 查看文档
diff --git a/docs/zh/docs/advanced/templates.md b/docs/zh/docs/advanced/templates.md
index b09644e39..1159302a9 100644
--- a/docs/zh/docs/advanced/templates.md
+++ b/docs/zh/docs/advanced/templates.md
@@ -28,7 +28,7 @@ $ pip install jinja2
* 使用 `templates` 渲染并返回 `TemplateResponse`， 传递模板的名称、request对象以及一个包含多个键值对（用于Jinja2模板）的"context"字典，
```Python hl_lines="4 11 15-16"
-{!../../../docs_src/templates/tutorial001.py!}
+{!../../docs_src/templates/tutorial001.py!}
```
/// note | "笔记"
@@ -57,7 +57,7 @@ $ pip install jinja2
编写模板 `templates/item.html`，代码如下：
```jinja hl_lines="7"
-{!../../../docs_src/templates/templates/item.html!}
+{!../../docs_src/templates/templates/item.html!}
```
### 模板上下文
@@ -111,13 +111,13 @@ Item ID: 42
你还可以在模板内部将 `url_for()`用于静态文件，例如你挂载的 `name="static"`的 `StaticFiles`。
```jinja hl_lines="4"
-{!../../../docs_src/templates/templates/item.html!}
+{!../../docs_src/templates/templates/item.html!}
```
本例中，它将链接到 `static/styles.css`中的CSS文件：
```CSS hl_lines="4"
-{!../../../docs_src/templates/static/styles.css!}
+{!../../docs_src/templates/static/styles.css!}
```
因为使用了 `StaticFiles`， **FastAPI** 应用会自动提供位于 URL `/static/styles.css`的 CSS 文件。
diff --git a/docs/zh/docs/advanced/testing-database.md b/docs/zh/docs/advanced/testing-database.md
index 58bf9af8c..ecab4f65b 100644
--- a/docs/zh/docs/advanced/testing-database.md
+++ b/docs/zh/docs/advanced/testing-database.md
@@ -49,7 +49,7 @@
但其余的会话代码基本上都是一样的，只要复制就可以了。
```Python hl_lines="8-13"
-{!../../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
+{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
```
/// tip | "提示"
@@ -73,7 +73,7 @@ Base.metadata.create_all(bind=engine)
因此，要在测试代码中添加这行代码创建新的数据库文件。
```Python hl_lines="16"
-{!../../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
+{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
```
## 覆盖依赖项
@@ -81,7 +81,7 @@ Base.metadata.create_all(bind=engine)
接下来，创建覆盖依赖项，并为应用添加覆盖内容。
```Python hl_lines="19-24 27"
-{!../../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
+{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
```
/// tip | "提示"
@@ -95,7 +95,7 @@ Base.metadata.create_all(bind=engine)
然后，就可以正常测试了。
```Python hl_lines="32-47"
-{!../../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
+{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
```
测试期间，所有在数据库中所做的修改都在 `test.db` 里，不会影响主应用的 `sql_app.db`。
diff --git a/docs/zh/docs/advanced/testing-dependencies.md b/docs/zh/docs/advanced/testing-dependencies.md
index cc9a38200..c3d912e2f 100644
--- a/docs/zh/docs/advanced/testing-dependencies.md
+++ b/docs/zh/docs/advanced/testing-dependencies.md
@@ -29,7 +29,7 @@
这样一来，**FastAPI** 就会调用覆盖依赖项，不再调用原依赖项。
```Python hl_lines="26-27 30"
-{!../../../docs_src/dependency_testing/tutorial001.py!}
+{!../../docs_src/dependency_testing/tutorial001.py!}
```
/// tip | "提示"
diff --git a/docs/zh/docs/advanced/testing-events.md b/docs/zh/docs/advanced/testing-events.md
index 222a67c8c..00e661cd2 100644
--- a/docs/zh/docs/advanced/testing-events.md
+++ b/docs/zh/docs/advanced/testing-events.md
@@ -3,5 +3,5 @@
使用 `TestClient` 和 `with` 语句，在测试中运行事件处理器（`startup` 与 `shutdown`）。
```Python hl_lines="9-12 20-24"
-{!../../../docs_src/app_testing/tutorial003.py!}
+{!../../docs_src/app_testing/tutorial003.py!}
```
diff --git a/docs/zh/docs/advanced/testing-websockets.md b/docs/zh/docs/advanced/testing-websockets.md
index 795b73945..a69053f24 100644
--- a/docs/zh/docs/advanced/testing-websockets.md
+++ b/docs/zh/docs/advanced/testing-websockets.md
@@ -5,7 +5,7 @@
为此，要在 `with` 语句中使用 `TestClient` 连接 WebSocket。
```Python hl_lines="27-31"
-{!../../../docs_src/app_testing/tutorial002.py!}
+{!../../docs_src/app_testing/tutorial002.py!}
```
/// note | "笔记"
diff --git a/docs/zh/docs/advanced/using-request-directly.md b/docs/zh/docs/advanced/using-request-directly.md
index bc9e898d9..992458217 100644
--- a/docs/zh/docs/advanced/using-request-directly.md
+++ b/docs/zh/docs/advanced/using-request-directly.md
@@ -30,7 +30,7 @@
此时，需要直接访问请求。
```Python hl_lines="1 7-8"
-{!../../../docs_src/using_request_directly/tutorial001.py!}
+{!../../docs_src/using_request_directly/tutorial001.py!}
```
把*路径操作函数*的参数类型声明为 `Request`，**FastAPI** 就能把 `Request` 传递到参数里。
diff --git a/docs/zh/docs/advanced/websockets.md b/docs/zh/docs/advanced/websockets.md
index 3fcc36dfe..15ae84c58 100644
--- a/docs/zh/docs/advanced/websockets.md
+++ b/docs/zh/docs/advanced/websockets.md
@@ -35,7 +35,7 @@ $ pip install websockets
但这是一种专注于 WebSockets 的服务器端并提供一个工作示例的最简单方式：
```Python hl_lines="2 6-38 41-43"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
## 创建 `websocket`
@@ -43,7 +43,7 @@ $ pip install websockets
在您的 **FastAPI** 应用程序中，创建一个 `websocket`：
```Python hl_lines="1 46-47"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
/// note | "技术细节"
@@ -59,7 +59,7 @@ $ pip install websockets
在您的 WebSocket 路由中，您可以使用 `await` 等待消息并发送消息。
```Python hl_lines="48-52"
-{!../../../docs_src/websockets/tutorial001.py!}
+{!../../docs_src/websockets/tutorial001.py!}
```
您可以接收和发送二进制、文本和 JSON 数据。
@@ -112,7 +112,7 @@ $ uvicorn main:app --reload
//// tab | Python 3.10+
```Python hl_lines="68-69 82"
-{!> ../../../docs_src/websockets/tutorial002_an_py310.py!}
+{!> ../../docs_src/websockets/tutorial002_an_py310.py!}
```
////
@@ -120,7 +120,7 @@ $ uvicorn main:app --reload
//// tab | Python 3.9+
```Python hl_lines="68-69 82"
-{!> ../../../docs_src/websockets/tutorial002_an_py39.py!}
+{!> ../../docs_src/websockets/tutorial002_an_py39.py!}
```
////
@@ -128,7 +128,7 @@ $ uvicorn main:app --reload
//// tab | Python 3.8+
```Python hl_lines="69-70 83"
-{!> ../../../docs_src/websockets/tutorial002_an.py!}
+{!> ../../docs_src/websockets/tutorial002_an.py!}
```
////
@@ -142,7 +142,7 @@ $ uvicorn main:app --reload
///
```Python hl_lines="66-67 79"
-{!> ../../../docs_src/websockets/tutorial002_py310.py!}
+{!> ../../docs_src/websockets/tutorial002_py310.py!}
```
////
@@ -156,7 +156,7 @@ $ uvicorn main:app --reload
///
```Python hl_lines="68-69 81"
-{!> ../../../docs_src/websockets/tutorial002.py!}
+{!> ../../docs_src/websockets/tutorial002.py!}
```
////
@@ -203,7 +203,7 @@ $ uvicorn main:app --reload
//// tab | Python 3.9+
```Python hl_lines="79-81"
-{!> ../../../docs_src/websockets/tutorial003_py39.py!}
+{!> ../../docs_src/websockets/tutorial003_py39.py!}
```
////
@@ -211,7 +211,7 @@ $ uvicorn main:app --reload
//// tab | Python 3.8+
```Python hl_lines="81-83"
-{!> ../../../docs_src/websockets/tutorial003.py!}
+{!> ../../docs_src/websockets/tutorial003.py!}
```
////
diff --git a/docs/zh/docs/advanced/wsgi.md b/docs/zh/docs/advanced/wsgi.md
index 179ec88aa..92bd998d0 100644
--- a/docs/zh/docs/advanced/wsgi.md
+++ b/docs/zh/docs/advanced/wsgi.md
@@ -13,7 +13,7 @@
之后将其挂载到某一个路径下。
```Python hl_lines="2-3 22"
-{!../../../docs_src/wsgi/tutorial001.py!}
+{!../../docs_src/wsgi/tutorial001.py!}
```
## 检查
diff --git a/docs/zh/docs/how-to/configure-swagger-ui.md b/docs/zh/docs/how-to/configure-swagger-ui.md
index 17f89b22f..1a2daeec1 100644
--- a/docs/zh/docs/how-to/configure-swagger-ui.md
+++ b/docs/zh/docs/how-to/configure-swagger-ui.md
@@ -19,7 +19,7 @@ FastAPI会将这些配置转换为 **JSON**，使其与 JavaScript 兼容，因
但是你可以通过设置 `syntaxHighlight` 为 `False` 来禁用 Swagger UI 中的语法高亮：
```Python hl_lines="3"
-{!../../../docs_src/configure_swagger_ui/tutorial001.py!}
+{!../../docs_src/configure_swagger_ui/tutorial001.py!}
```
...在此之后，Swagger UI 将不会高亮代码:
@@ -31,7 +31,7 @@ FastAPI会将这些配置转换为 **JSON**，使其与 JavaScript 兼容，因
同样地，你也可以通过设置键 `"syntaxHighlight.theme"` 来设置语法高亮主题（注意中间有一个点）：
```Python hl_lines="3"
-{!../../../docs_src/configure_swagger_ui/tutorial002.py!}
+{!../../docs_src/configure_swagger_ui/tutorial002.py!}
```
这个配置会改变语法高亮主题：
@@ -45,7 +45,7 @@ FastAPI 包含了一些默认配置参数，适用于大多数用例。
其包括这些默认配置参数：
```Python
-{!../../../fastapi/openapi/docs.py[ln:7-23]!}
+{!../../fastapi/openapi/docs.py[ln:7-23]!}
```
你可以通过在 `swagger_ui_parameters` 中设置不同的值来覆盖它们。
@@ -53,7 +53,7 @@ FastAPI 包含了一些默认配置参数，适用于大多数用例。
比如，如果要禁用 `deepLinking`，你可以像这样传递设置到 `swagger_ui_parameters` 中：
```Python hl_lines="3"
-{!../../../docs_src/configure_swagger_ui/tutorial003.py!}
+{!../../docs_src/configure_swagger_ui/tutorial003.py!}
```
## 其他 Swagger UI 参数
diff --git a/docs/zh/docs/python-types.md b/docs/zh/docs/python-types.md
index c78852539..dab6bd4c0 100644
--- a/docs/zh/docs/python-types.md
+++ b/docs/zh/docs/python-types.md
@@ -23,7 +23,7 @@
让我们从一个简单的例子开始：
```Python
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
运行这段程序将输出：
@@ -39,7 +39,7 @@ John Doe
* 中间用一个空格来<abbr title="将它们按顺序放置组合成一个整体。">拼接</abbr>它们。
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial001.py!}
+{!../../docs_src/python_types/tutorial001.py!}
```
### 修改示例
@@ -83,7 +83,7 @@ John Doe
这些就是"类型提示"：
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial002.py!}
+{!../../docs_src/python_types/tutorial002.py!}
```
这和声明默认值是不同的，例如：
@@ -113,7 +113,7 @@ John Doe
下面是一个已经有类型提示的函数：
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial003.py!}
+{!../../docs_src/python_types/tutorial003.py!}
```
因为编辑器已经知道了这些变量的类型，所以不仅能对代码进行补全，还能检查其中的错误：
@@ -123,7 +123,7 @@ John Doe
现在你知道了必须先修复这个问题，通过 `str(age)` 把 `age` 转换成字符串：
```Python hl_lines="2"
-{!../../../docs_src/python_types/tutorial004.py!}
+{!../../docs_src/python_types/tutorial004.py!}
```
## 声明类型
@@ -144,7 +144,7 @@ John Doe
* `bytes`
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial005.py!}
+{!../../docs_src/python_types/tutorial005.py!}
```
### 嵌套类型
@@ -162,7 +162,7 @@ John Doe
从 `typing` 模块导入 `List`（注意是大写的 `L`）：
```Python hl_lines="1"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
同样以冒号（`:`）来声明这个变量。
@@ -172,7 +172,7 @@ John Doe
由于列表是带有"子类型"的类型，所以我们把子类型放在方括号中：
```Python hl_lines="4"
-{!../../../docs_src/python_types/tutorial006.py!}
+{!../../docs_src/python_types/tutorial006.py!}
```
这表示："变量 `items` 是一个 `list`，并且这个列表里的每一个元素都是 `str`"。
@@ -192,7 +192,7 @@ John Doe
声明 `tuple` 和 `set` 的方法也是一样的：
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial007.py!}
+{!../../docs_src/python_types/tutorial007.py!}
```
这表示：
@@ -209,7 +209,7 @@ John Doe
第二个子类型声明 `dict` 的所有值：
```Python hl_lines="1 4"
-{!../../../docs_src/python_types/tutorial008.py!}
+{!../../docs_src/python_types/tutorial008.py!}
```
这表示：
@@ -225,13 +225,13 @@ John Doe
假设你有一个名为 `Person` 的类，拥有 name 属性：
```Python hl_lines="1-3"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
接下来，你可以将一个变量声明为 `Person` 类型：
```Python hl_lines="6"
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
然后，你将再次获得所有的编辑器支持：
@@ -253,7 +253,7 @@ John Doe
下面的例子来自 Pydantic 官方文档：
```Python
-{!../../../docs_src/python_types/tutorial010.py!}
+{!../../docs_src/python_types/tutorial010.py!}
```
/// info
diff --git a/docs/zh/docs/tutorial/background-tasks.md b/docs/zh/docs/tutorial/background-tasks.md
index 95fd7b6b5..fc9312bc5 100644
--- a/docs/zh/docs/tutorial/background-tasks.md
+++ b/docs/zh/docs/tutorial/background-tasks.md
@@ -16,7 +16,7 @@
首先导入 `BackgroundTasks` 并在 *路径操作函数* 中使用类型声明 `BackgroundTasks` 定义一个参数：
```Python hl_lines="1 13"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
**FastAPI** 会创建一个 `BackgroundTasks` 类型的对象并作为该参数传入。
@@ -34,7 +34,7 @@
由于写操作不使用 `async` 和 `await`，我们用普通的 `def` 定义函数：
```Python hl_lines="6-9"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
## 添加后台任务
@@ -42,7 +42,7 @@
在你的 *路径操作函数* 里，用 `.add_task()` 方法将任务函数传到 *后台任务* 对象中：
```Python hl_lines="14"
-{!../../../docs_src/background_tasks/tutorial001.py!}
+{!../../docs_src/background_tasks/tutorial001.py!}
```
`.add_task()` 接收以下参数：
@@ -60,7 +60,7 @@
//// tab | Python 3.10+
```Python hl_lines="13 15 22 25"
-{!> ../../../docs_src/background_tasks/tutorial002_an_py310.py!}
+{!> ../../docs_src/background_tasks/tutorial002_an_py310.py!}
```
////
@@ -68,7 +68,7 @@
//// tab | Python 3.9+
```Python hl_lines="13 15 22 25"
-{!> ../../../docs_src/background_tasks/tutorial002_an_py39.py!}
+{!> ../../docs_src/background_tasks/tutorial002_an_py39.py!}
```
////
@@ -76,7 +76,7 @@
//// tab | Python 3.8+
```Python hl_lines="14 16 23 26"
-{!> ../../../docs_src/background_tasks/tutorial002_an.py!}
+{!> ../../docs_src/background_tasks/tutorial002_an.py!}
```
////
@@ -90,7 +90,7 @@
///
```Python hl_lines="11 13 20 23"
-{!> ../../../docs_src/background_tasks/tutorial002_py310.py!}
+{!> ../../docs_src/background_tasks/tutorial002_py310.py!}
```
////
@@ -104,7 +104,7 @@
///
```Python hl_lines="13 15 22 25"
-{!> ../../../docs_src/background_tasks/tutorial002.py!}
+{!> ../../docs_src/background_tasks/tutorial002.py!}
```
////
diff --git a/docs/zh/docs/tutorial/bigger-applications.md b/docs/zh/docs/tutorial/bigger-applications.md
index a0c7095e9..64afd99af 100644
--- a/docs/zh/docs/tutorial/bigger-applications.md
+++ b/docs/zh/docs/tutorial/bigger-applications.md
@@ -86,7 +86,7 @@ from app.routers import items
你可以导入它并通过与 `FastAPI` 类相同的方式创建一个「实例」：
```Python hl_lines="1 3" title="app/routers/users.py"
-{!../../../docs_src/bigger_applications/app/routers/users.py!}
+{!../../docs_src/bigger_applications/app/routers/users.py!}
```
### 使用 `APIRouter` 的*路径操作*
@@ -96,7 +96,7 @@ from app.routers import items
使用方式与 `FastAPI` 类相同：
```Python hl_lines="6 11 16" title="app/routers/users.py"
-{!../../../docs_src/bigger_applications/app/routers/users.py!}
+{!../../docs_src/bigger_applications/app/routers/users.py!}
```
你可以将 `APIRouter` 视为一个「迷你 `FastAPI`」类。
@@ -122,7 +122,7 @@ from app.routers import items
现在我们将使用一个简单的依赖项来读取一个自定义的 `X-Token` 请求首部：
```Python hl_lines="1 4-6" title="app/dependencies.py"
-{!../../../docs_src/bigger_applications/app/dependencies.py!}
+{!../../docs_src/bigger_applications/app/dependencies.py!}
```
/// tip
@@ -156,7 +156,7 @@ from app.routers import items
因此，我们可以将其添加到 `APIRouter` 中，而不是将其添加到每个路径操作中。
```Python hl_lines="5-10 16 21" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
由于每个*路径操作*的路径都必须以 `/` 开头，例如：
@@ -217,7 +217,7 @@ async def read_item(item_id: str):
因此，我们通过 `..` 对依赖项使用了相对导入：
```Python hl_lines="3" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
#### 相对导入如何工作
@@ -290,7 +290,7 @@ from ...dependencies import get_token_header
但是我们仍然可以添加*更多*将会应用于特定的*路径操作*的 `tags`，以及一些特定于该*路径操作*的额外 `responses`：
```Python hl_lines="30-31" title="app/routers/items.py"
-{!../../../docs_src/bigger_applications/app/routers/items.py!}
+{!../../docs_src/bigger_applications/app/routers/items.py!}
```
/// tip
@@ -318,7 +318,7 @@ from ...dependencies import get_token_header
我们甚至可以声明[全局依赖项](dependencies/global-dependencies.md){.internal-link target=_blank}，它会和每个 `APIRouter` 的依赖项组合在一起：
```Python hl_lines="1 3 7" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
### 导入 `APIRouter`
@@ -326,7 +326,7 @@ from ...dependencies import get_token_header
现在，我们导入具有 `APIRouter` 的其他子模块：
```Python hl_lines="5" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
由于文件 `app/routers/users.py` 和 `app/routers/items.py` 是同一 Python 包 `app` 一个部分的子模块，因此我们可以使用单个点 ` .` 通过「相对导入」来导入它们。
@@ -391,7 +391,7 @@ from .routers.users import router
因此，为了能够在同一个文件中使用它们，我们直接导入子模块：
```Python hl_lines="5" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
### 包含 `users` 和 `items` 的 `APIRouter`
@@ -399,7 +399,7 @@ from .routers.users import router
现在，让我们来包含来自 `users` 和 `items` 子模块的 `router`。
```Python hl_lines="10-11" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
/// info
@@ -441,7 +441,7 @@ from .routers.users import router
对于此示例，它将非常简单。但是假设由于它是与组织中的其他项目所共享的，因此我们无法对其进行修改，以及直接在 `APIRouter` 中添加 `prefix`、`dependencies`、`tags` 等：
```Python hl_lines="3" title="app/internal/admin.py"
-{!../../../docs_src/bigger_applications/app/internal/admin.py!}
+{!../../docs_src/bigger_applications/app/internal/admin.py!}
```
但是我们仍然希望在包含 `APIRouter` 时设置一个自定义的 `prefix`，以便其所有*路径操作*以 `/admin` 开头，我们希望使用本项目已经有的 `dependencies` 保护它，并且我们希望它包含自定义的 `tags` 和 `responses`。
@@ -449,7 +449,7 @@ from .routers.users import router
我们可以通过将这些参数传递给 `app.include_router()` 来完成所有的声明，而不必修改原始的 `APIRouter`：
```Python hl_lines="14-17" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
这样，原始的 `APIRouter` 将保持不变，因此我们仍然可以与组织中的其他项目共享相同的 `app/internal/admin.py` 文件。
@@ -472,7 +472,7 @@ from .routers.users import router
这里我们这样做了...只是为了表明我们可以做到🤷：
```Python hl_lines="21-23" title="app/main.py"
-{!../../../docs_src/bigger_applications/app/main.py!}
+{!../../docs_src/bigger_applications/app/main.py!}
```
它将与通过 `app.include_router()` 添加的所有其他*路径操作*一起正常运行。
diff --git a/docs/zh/docs/tutorial/body-fields.md b/docs/zh/docs/tutorial/body-fields.md
index 6e4c385dd..ac59d7e6a 100644
--- a/docs/zh/docs/tutorial/body-fields.md
+++ b/docs/zh/docs/tutorial/body-fields.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001_an.py!}
+{!> ../../docs_src/body_fields/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="2"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@
///
```Python hl_lines="4"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
@@ -71,7 +71,7 @@
//// tab | Python 3.10+
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py310.py!}
```
////
@@ -79,7 +79,7 @@
//// tab | Python 3.9+
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_fields/tutorial001_an_py39.py!}
```
////
@@ -87,7 +87,7 @@
//// tab | Python 3.8+
```Python hl_lines="12-15"
-{!> ../../../docs_src/body_fields/tutorial001_an.py!}
+{!> ../../docs_src/body_fields/tutorial001_an.py!}
```
////
@@ -101,7 +101,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9-12"
-{!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+{!> ../../docs_src/body_fields/tutorial001_py310.py!}
```
////
@@ -115,7 +115,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="11-14"
-{!> ../../../docs_src/body_fields/tutorial001.py!}
+{!> ../../docs_src/body_fields/tutorial001.py!}
```
////
diff --git a/docs/zh/docs/tutorial/body-multiple-params.md b/docs/zh/docs/tutorial/body-multiple-params.md
index fe951e544..c3bc0db9e 100644
--- a/docs/zh/docs/tutorial/body-multiple-params.md
+++ b/docs/zh/docs/tutorial/body-multiple-params.md
@@ -11,7 +11,7 @@
//// tab | Python 3.10+
```Python hl_lines="18-20"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
```
////
@@ -19,7 +19,7 @@
//// tab | Python 3.9+
```Python hl_lines="18-20"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
```
////
@@ -27,7 +27,7 @@
//// tab | Python 3.8+
```Python hl_lines="19-21"
-{!> ../../../docs_src/body_multiple_params/tutorial001_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_an.py!}
```
////
@@ -41,7 +41,7 @@
///
```Python hl_lines="17-19"
-{!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001_py310.py!}
```
////
@@ -55,7 +55,7 @@
///
```Python hl_lines="19-21"
-{!> ../../../docs_src/body_multiple_params/tutorial001.py!}
+{!> ../../docs_src/body_multiple_params/tutorial001.py!}
```
////
@@ -84,7 +84,7 @@
//// tab | Python 3.10+
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002_py310.py!}
```
////
@@ -92,7 +92,7 @@
//// tab | Python 3.8+
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial002.py!}
+{!> ../../docs_src/body_multiple_params/tutorial002.py!}
```
////
@@ -140,7 +140,7 @@
//// tab | Python 3.10+
```Python hl_lines="23"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
```
////
@@ -148,7 +148,7 @@
//// tab | Python 3.9+
```Python hl_lines="23"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
```
////
@@ -156,7 +156,7 @@
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/body_multiple_params/tutorial003_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_an.py!}
```
////
@@ -170,7 +170,7 @@
///
```Python hl_lines="20"
-{!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003_py310.py!}
```
////
@@ -184,7 +184,7 @@
///
```Python hl_lines="22"
-{!> ../../../docs_src/body_multiple_params/tutorial003.py!}
+{!> ../../docs_src/body_multiple_params/tutorial003.py!}
```
////
@@ -225,7 +225,7 @@ q: str = None
//// tab | Python 3.10+
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
```
////
@@ -233,7 +233,7 @@ q: str = None
//// tab | Python 3.9+
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
```
////
@@ -241,7 +241,7 @@ q: str = None
//// tab | Python 3.8+
```Python hl_lines="28"
-{!> ../../../docs_src/body_multiple_params/tutorial004_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_an.py!}
```
////
@@ -255,7 +255,7 @@ q: str = None
///
```Python hl_lines="25"
-{!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004_py310.py!}
```
////
@@ -269,7 +269,7 @@ q: str = None
///
```Python hl_lines="27"
-{!> ../../../docs_src/body_multiple_params/tutorial004.py!}
+{!> ../../docs_src/body_multiple_params/tutorial004.py!}
```
////
@@ -297,7 +297,7 @@ item: Item = Body(embed=True)
//// tab | Python 3.10+
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
```
////
@@ -305,7 +305,7 @@ item: Item = Body(embed=True)
//// tab | Python 3.9+
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
```
////
@@ -313,7 +313,7 @@ item: Item = Body(embed=True)
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/body_multiple_params/tutorial005_an.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_an.py!}
```
////
@@ -327,7 +327,7 @@ item: Item = Body(embed=True)
///
```Python hl_lines="15"
-{!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005_py310.py!}
```
////
@@ -341,7 +341,7 @@ item: Item = Body(embed=True)
///
```Python hl_lines="17"
-{!> ../../../docs_src/body_multiple_params/tutorial005.py!}
+{!> ../../docs_src/body_multiple_params/tutorial005.py!}
```
////
diff --git a/docs/zh/docs/tutorial/body-nested-models.md b/docs/zh/docs/tutorial/body-nested-models.md
index 26837abc6..316ba9878 100644
--- a/docs/zh/docs/tutorial/body-nested-models.md
+++ b/docs/zh/docs/tutorial/body-nested-models.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial001_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial001_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.8+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial001.py!}
+{!> ../../docs_src/body_nested_models/tutorial001.py!}
```
////
@@ -33,7 +33,7 @@
首先，从 Python 的标准库 `typing` 模块中导入 `List`：
```Python hl_lines="1"
-{!> ../../../docs_src/body_nested_models/tutorial002.py!}
+{!> ../../docs_src/body_nested_models/tutorial002.py!}
```
### 声明具有子类型的 List
@@ -58,7 +58,7 @@ my_list: List[str]
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial002_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial002_py310.py!}
```
////
@@ -66,7 +66,7 @@ my_list: List[str]
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial002_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial002_py39.py!}
```
////
@@ -74,7 +74,7 @@ my_list: List[str]
//// tab | Python 3.8+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial002.py!}
+{!> ../../docs_src/body_nested_models/tutorial002.py!}
```
////
@@ -90,7 +90,7 @@ Python 具有一种特殊的数据类型来保存一组唯一的元素，即 `se
//// tab | Python 3.10+
```Python hl_lines="12"
-{!> ../../../docs_src/body_nested_models/tutorial003_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial003_py310.py!}
```
////
@@ -98,7 +98,7 @@ Python 具有一种特殊的数据类型来保存一组唯一的元素，即 `se
//// tab | Python 3.9+
```Python hl_lines="14"
-{!> ../../../docs_src/body_nested_models/tutorial003_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial003_py39.py!}
```
////
@@ -106,7 +106,7 @@ Python 具有一种特殊的数据类型来保存一组唯一的元素，即 `se
//// tab | Python 3.8+
```Python hl_lines="1 14"
-{!> ../../../docs_src/body_nested_models/tutorial003.py!}
+{!> ../../docs_src/body_nested_models/tutorial003.py!}
```
////
@@ -134,7 +134,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.10+
```Python hl_lines="7-9"
-{!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py310.py!}
```
////
@@ -142,7 +142,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.9+
```Python hl_lines="9-11"
-{!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py39.py!}
```
////
@@ -150,7 +150,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.8+
```Python hl_lines="9-11"
-{!> ../../../docs_src/body_nested_models/tutorial004.py!}
+{!> ../../docs_src/body_nested_models/tutorial004.py!}
```
////
@@ -162,7 +162,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.10+
```Python hl_lines="18"
-{!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py310.py!}
```
////
@@ -170,7 +170,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.9+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial004_py39.py!}
```
////
@@ -178,7 +178,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial004.py!}
+{!> ../../docs_src/body_nested_models/tutorial004.py!}
```
////
@@ -217,7 +217,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.10+
```Python hl_lines="2 8"
-{!> ../../../docs_src/body_nested_models/tutorial005_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial005_py310.py!}
```
////
@@ -225,7 +225,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.9+
```Python hl_lines="4 10"
-{!> ../../../docs_src/body_nested_models/tutorial005_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial005_py39.py!}
```
////
@@ -233,7 +233,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.8+
```Python hl_lines="4 10"
-{!> ../../../docs_src/body_nested_models/tutorial005.py!}
+{!> ../../docs_src/body_nested_models/tutorial005.py!}
```
////
@@ -247,7 +247,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.10+
```Python hl_lines="18"
-{!> ../../../docs_src/body_nested_models/tutorial006_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial006_py310.py!}
```
////
@@ -255,7 +255,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.9+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial006_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial006_py39.py!}
```
////
@@ -263,7 +263,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.8+
```Python hl_lines="20"
-{!> ../../../docs_src/body_nested_models/tutorial006.py!}
+{!> ../../docs_src/body_nested_models/tutorial006.py!}
```
////
@@ -307,7 +307,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.10+
```Python hl_lines="7 12 18 21 25"
-{!> ../../../docs_src/body_nested_models/tutorial007_py310.py!}
+{!> ../../docs_src/body_nested_models/tutorial007_py310.py!}
```
////
@@ -315,7 +315,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.9+
```Python hl_lines="9 14 20 23 27"
-{!> ../../../docs_src/body_nested_models/tutorial007_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial007_py39.py!}
```
////
@@ -323,7 +323,7 @@ Pydantic 模型的每个属性都具有类型。
//// tab | Python 3.8+
```Python hl_lines="9 14 20 23 27"
-{!> ../../../docs_src/body_nested_models/tutorial007.py!}
+{!> ../../docs_src/body_nested_models/tutorial007.py!}
```
////
@@ -347,7 +347,7 @@ images: List[Image]
//// tab | Python 3.9+
```Python hl_lines="13"
-{!> ../../../docs_src/body_nested_models/tutorial008_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial008_py39.py!}
```
////
@@ -355,7 +355,7 @@ images: List[Image]
//// tab | Python 3.8+
```Python hl_lines="15"
-{!> ../../../docs_src/body_nested_models/tutorial008.py!}
+{!> ../../docs_src/body_nested_models/tutorial008.py!}
```
////
@@ -391,7 +391,7 @@ images: List[Image]
//// tab | Python 3.9+
```Python hl_lines="7"
-{!> ../../../docs_src/body_nested_models/tutorial009_py39.py!}
+{!> ../../docs_src/body_nested_models/tutorial009_py39.py!}
```
////
@@ -399,7 +399,7 @@ images: List[Image]
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/body_nested_models/tutorial009.py!}
+{!> ../../docs_src/body_nested_models/tutorial009.py!}
```
////
diff --git a/docs/zh/docs/tutorial/body-updates.md b/docs/zh/docs/tutorial/body-updates.md
index 6c74d12e0..5e9008d6a 100644
--- a/docs/zh/docs/tutorial/body-updates.md
+++ b/docs/zh/docs/tutorial/body-updates.md
@@ -7,7 +7,7 @@
把输入数据转换为以 JSON 格式存储的数据（比如，使用 NoSQL 数据库时），可以使用 `jsonable_encoder`。例如，把 `datetime` 转换为 `str`。
```Python hl_lines="30-35"
-{!../../../docs_src/body_updates/tutorial001.py!}
+{!../../docs_src/body_updates/tutorial001.py!}
```
`PUT` 用于接收替换现有数据的数据。
@@ -57,7 +57,7 @@
然后再用它生成一个只含已设置（在请求中所发送）数据，且省略了默认值的 `dict`：
```Python hl_lines="34"
-{!../../../docs_src/body_updates/tutorial002.py!}
+{!../../docs_src/body_updates/tutorial002.py!}
```
### 使用 Pydantic 的 `update` 参数
@@ -67,7 +67,7 @@
例如，`stored_item_model.copy(update=update_data)`：
```Python hl_lines="35"
-{!../../../docs_src/body_updates/tutorial002.py!}
+{!../../docs_src/body_updates/tutorial002.py!}
```
### 更新部分数据小结
@@ -86,7 +86,7 @@
* 返回更新后的模型。
```Python hl_lines="30-37"
-{!../../../docs_src/body_updates/tutorial002.py!}
+{!../../docs_src/body_updates/tutorial002.py!}
```
/// tip | "提示"
diff --git a/docs/zh/docs/tutorial/body.md b/docs/zh/docs/tutorial/body.md
index c47abec77..67a7f28e0 100644
--- a/docs/zh/docs/tutorial/body.md
+++ b/docs/zh/docs/tutorial/body.md
@@ -25,7 +25,7 @@ API 基本上肯定要发送**响应体**，但是客户端不一定发送**请
//// tab | Python 3.10+
```Python hl_lines="2"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -33,7 +33,7 @@ API 基本上肯定要发送**响应体**，但是客户端不一定发送**请
//// tab | Python 3.8+
```Python hl_lines="4"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -47,7 +47,7 @@ API 基本上肯定要发送**响应体**，但是客户端不一定发送**请
//// tab | Python 3.10+
```Python hl_lines="5-9"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -55,7 +55,7 @@ API 基本上肯定要发送**响应体**，但是客户端不一定发送**请
//// tab | Python 3.8+
```Python hl_lines="7-11"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -89,7 +89,7 @@ API 基本上肯定要发送**响应体**，但是客户端不一定发送**请
//// tab | Python 3.10+
```Python hl_lines="16"
-{!> ../../../docs_src/body/tutorial001_py310.py!}
+{!> ../../docs_src/body/tutorial001_py310.py!}
```
////
@@ -97,7 +97,7 @@ API 基本上肯定要发送**响应体**，但是客户端不一定发送**请
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/body/tutorial001.py!}
+{!> ../../docs_src/body/tutorial001.py!}
```
////
@@ -170,7 +170,7 @@ Pydantic 模型的 JSON 概图是 OpenAPI 生成的概图部件，可在 API 文
//// tab | Python 3.10+
```Python hl_lines="19"
-{!> ../../../docs_src/body/tutorial002_py310.py!}
+{!> ../../docs_src/body/tutorial002_py310.py!}
```
////
@@ -178,7 +178,7 @@ Pydantic 模型的 JSON 概图是 OpenAPI 生成的概图部件，可在 API 文
//// tab | Python 3.8+
```Python hl_lines="21"
-{!> ../../../docs_src/body/tutorial002.py!}
+{!> ../../docs_src/body/tutorial002.py!}
```
////
@@ -192,7 +192,7 @@ Pydantic 模型的 JSON 概图是 OpenAPI 生成的概图部件，可在 API 文
//// tab | Python 3.10+
```Python hl_lines="15-16"
-{!> ../../../docs_src/body/tutorial003_py310.py!}
+{!> ../../docs_src/body/tutorial003_py310.py!}
```
////
@@ -200,7 +200,7 @@ Pydantic 模型的 JSON 概图是 OpenAPI 生成的概图部件，可在 API 文
//// tab | Python 3.8+
```Python hl_lines="17-18"
-{!> ../../../docs_src/body/tutorial003.py!}
+{!> ../../docs_src/body/tutorial003.py!}
```
////
@@ -214,7 +214,7 @@ Pydantic 模型的 JSON 概图是 OpenAPI 生成的概图部件，可在 API 文
//// tab | Python 3.10+
```Python hl_lines="16"
-{!> ../../../docs_src/body/tutorial004_py310.py!}
+{!> ../../docs_src/body/tutorial004_py310.py!}
```
////
@@ -222,7 +222,7 @@ Pydantic 模型的 JSON 概图是 OpenAPI 生成的概图部件，可在 API 文
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/body/tutorial004.py!}
+{!> ../../docs_src/body/tutorial004.py!}
```
////
diff --git a/docs/zh/docs/tutorial/cookie-params.md b/docs/zh/docs/tutorial/cookie-params.md
index 7ca77696e..b01c28238 100644
--- a/docs/zh/docs/tutorial/cookie-params.md
+++ b/docs/zh/docs/tutorial/cookie-params.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="1"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@
///
```Python hl_lines="3"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
@@ -68,7 +68,7 @@
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
```
////
@@ -76,7 +76,7 @@
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
```
////
@@ -84,7 +84,7 @@
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+{!> ../../docs_src/cookie_params/tutorial001_an.py!}
```
////
@@ -98,7 +98,7 @@
///
```Python hl_lines="7"
-{!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
```
////
@@ -112,7 +112,7 @@
///
```Python hl_lines="9"
-{!> ../../../docs_src/cookie_params/tutorial001.py!}
+{!> ../../docs_src/cookie_params/tutorial001.py!}
```
////
diff --git a/docs/zh/docs/tutorial/cors.md b/docs/zh/docs/tutorial/cors.md
index de880f347..1166d5c97 100644
--- a/docs/zh/docs/tutorial/cors.md
+++ b/docs/zh/docs/tutorial/cors.md
@@ -47,7 +47,7 @@
* 特定的 HTTP headers 或者使用通配符 `"*"` 允许所有 headers。
```Python hl_lines="2 6-11 13-19"
-{!../../../docs_src/cors/tutorial001.py!}
+{!../../docs_src/cors/tutorial001.py!}
```
默认情况下，这个 `CORSMiddleware` 实现所使用的默认参数较为保守，所以你需要显式地启用特定的源、方法或者 headers，以便浏览器能够在跨域上下文中使用它们。
diff --git a/docs/zh/docs/tutorial/debugging.md b/docs/zh/docs/tutorial/debugging.md
index 945094207..a5afa1aaa 100644
--- a/docs/zh/docs/tutorial/debugging.md
+++ b/docs/zh/docs/tutorial/debugging.md
@@ -7,7 +7,7 @@
在你的 FastAPI 应用中直接导入 `uvicorn` 并运行：
```Python hl_lines="1 15"
-{!../../../docs_src/debugging/tutorial001.py!}
+{!../../docs_src/debugging/tutorial001.py!}
```
### 关于 `__name__ == "__main__"`
diff --git a/docs/zh/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/zh/docs/tutorial/dependencies/classes-as-dependencies.md
index 9932f90fc..917459d1d 100644
--- a/docs/zh/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/zh/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -86,7 +86,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.10+
```Python hl_lines="9-13"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -94,7 +94,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.8+
```Python hl_lines="11-15"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -104,7 +104,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -112,7 +112,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.6+
```Python hl_lines="12"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -122,7 +122,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.10+
```Python hl_lines="6"
-{!> ../../../docs_src/dependencies/tutorial001_py310.py!}
+{!> ../../docs_src/dependencies/tutorial001_py310.py!}
```
////
@@ -130,7 +130,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.6+
```Python hl_lines="9"
-{!> ../../../docs_src/dependencies/tutorial001.py!}
+{!> ../../docs_src/dependencies/tutorial001.py!}
```
////
@@ -152,7 +152,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.10+
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial002_py310.py!}
+{!> ../../docs_src/dependencies/tutorial002_py310.py!}
```
////
@@ -160,7 +160,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.6+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial002.py!}
+{!> ../../docs_src/dependencies/tutorial002.py!}
```
////
@@ -206,7 +206,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.10+
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial003_py310.py!}
+{!> ../../docs_src/dependencies/tutorial003_py310.py!}
```
////
@@ -214,7 +214,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.6+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial003.py!}
+{!> ../../docs_src/dependencies/tutorial003.py!}
```
////
@@ -254,7 +254,7 @@ commons: CommonQueryParams = Depends()
//// tab | Python 3.10+
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial004_py310.py!}
+{!> ../../docs_src/dependencies/tutorial004_py310.py!}
```
////
@@ -262,7 +262,7 @@ commons: CommonQueryParams = Depends()
//// tab | Python 3.6+
```Python hl_lines="19"
-{!> ../../../docs_src/dependencies/tutorial004.py!}
+{!> ../../docs_src/dependencies/tutorial004.py!}
```
////
diff --git a/docs/zh/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/zh/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index e6bbd47c1..c7cfe0531 100644
--- a/docs/zh/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/zh/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -15,7 +15,7 @@
该参数的值是由 `Depends()` 组成的 `list`：
```Python hl_lines="17"
-{!../../../docs_src/dependencies/tutorial006.py!}
+{!../../docs_src/dependencies/tutorial006.py!}
```
路径操作装饰器依赖项（以下简称为**“路径装饰器依赖项”**）的执行或解析方式和普通依赖项一样，但就算这些依赖项会返回值，它们的值也不会传递给*路径操作函数*。
@@ -47,7 +47,7 @@
路径装饰器依赖项可以声明请求的需求项（比如响应头）或其他子依赖项：
```Python hl_lines="6 11"
-{!../../../docs_src/dependencies/tutorial006.py!}
+{!../../docs_src/dependencies/tutorial006.py!}
```
### 触发异常
@@ -55,7 +55,7 @@
路径装饰器依赖项与正常的依赖项一样，可以 `raise` 异常：
```Python hl_lines="8 13"
-{!../../../docs_src/dependencies/tutorial006.py!}
+{!../../docs_src/dependencies/tutorial006.py!}
```
### 返回值
@@ -65,7 +65,7 @@
因此，可以复用在其他位置使用过的、（能返回值的）普通依赖项，即使没有使用这个值，也会执行该依赖项：
```Python hl_lines="9 14"
-{!../../../docs_src/dependencies/tutorial006.py!}
+{!../../docs_src/dependencies/tutorial006.py!}
```
## 为一组路径操作定义依赖项
diff --git a/docs/zh/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/zh/docs/tutorial/dependencies/dependencies-with-yield.md
index 6058f7878..a30313719 100644
--- a/docs/zh/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/zh/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -30,19 +30,19 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
在发送响应之前，只会执行 `yield` 语句及之前的代码：
```Python hl_lines="2-4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
生成的值会注入到 *路由函数* 和其他依赖项中：
```Python hl_lines="4"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
`yield` 语句后面的代码会在创建响应后，发送响应前执行：
```Python hl_lines="5-6"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
/// tip | 提示
@@ -64,7 +64,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
同样，你也可以使用 `finally` 来确保退出步骤得到执行，无论是否存在异常。
```Python hl_lines="3 5"
-{!../../../docs_src/dependencies/tutorial007.py!}
+{!../../docs_src/dependencies/tutorial007.py!}
```
## 使用 `yield` 的子依赖项
@@ -77,7 +77,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
//// tab | Python 3.9+
```Python hl_lines="6 14 22"
-{!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008_an_py39.py!}
```
////
@@ -85,7 +85,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
//// tab | Python 3.8+
```Python hl_lines="5 13 21"
-{!> ../../../docs_src/dependencies/tutorial008_an.py!}
+{!> ../../docs_src/dependencies/tutorial008_an.py!}
```
////
@@ -99,7 +99,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
///
```Python hl_lines="4 12 20"
-{!> ../../../docs_src/dependencies/tutorial008.py!}
+{!> ../../docs_src/dependencies/tutorial008.py!}
```
////
@@ -113,7 +113,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
//// tab | Python 3.9+
```Python hl_lines="18-19 26-27"
-{!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008_an_py39.py!}
```
////
@@ -121,7 +121,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
//// tab | Python 3.8+
```Python hl_lines="17-18 25-26"
-{!> ../../../docs_src/dependencies/tutorial008_an.py!}
+{!> ../../docs_src/dependencies/tutorial008_an.py!}
```
////
@@ -135,7 +135,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
///
```Python hl_lines="16-17 24-25"
-{!> ../../../docs_src/dependencies/tutorial008.py!}
+{!> ../../docs_src/dependencies/tutorial008.py!}
```
////
@@ -173,7 +173,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
//// tab | Python 3.9+
```Python hl_lines="18-22 31"
-{!> ../../../docs_src/dependencies/tutorial008b_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008b_an_py39.py!}
```
////
@@ -181,7 +181,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
//// tab | Python 3.8+
```Python hl_lines="17-21 30"
-{!> ../../../docs_src/dependencies/tutorial008b_an.py!}
+{!> ../../docs_src/dependencies/tutorial008b_an.py!}
```
////
@@ -195,7 +195,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
///
```Python hl_lines="16-20 29"
-{!> ../../../docs_src/dependencies/tutorial008b.py!}
+{!> ../../docs_src/dependencies/tutorial008b.py!}
```
////
@@ -209,7 +209,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
//// tab | Python 3.9+
```Python hl_lines="15-16"
-{!> ../../../docs_src/dependencies/tutorial008c_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008c_an_py39.py!}
```
////
@@ -217,7 +217,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
//// tab | Python 3.8+
```Python hl_lines="14-15"
-{!> ../../../docs_src/dependencies/tutorial008c_an.py!}
+{!> ../../docs_src/dependencies/tutorial008c_an.py!}
```
////
@@ -231,7 +231,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
///
```Python hl_lines="13-14"
-{!> ../../../docs_src/dependencies/tutorial008c.py!}
+{!> ../../docs_src/dependencies/tutorial008c.py!}
```
////
@@ -247,7 +247,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
//// tab | Python 3.9+
```Python hl_lines="17"
-{!> ../../../docs_src/dependencies/tutorial008d_an_py39.py!}
+{!> ../../docs_src/dependencies/tutorial008d_an_py39.py!}
```
////
@@ -255,7 +255,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
//// tab | Python 3.8+
```Python hl_lines="16"
-{!> ../../../docs_src/dependencies/tutorial008d_an.py!}
+{!> ../../docs_src/dependencies/tutorial008d_an.py!}
```
////
@@ -269,7 +269,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
///
```Python hl_lines="15"
-{!> ../../../docs_src/dependencies/tutorial008d.py!}
+{!> ../../docs_src/dependencies/tutorial008d.py!}
```
////
@@ -400,7 +400,7 @@ with open("./somefile.txt") as f:
你也可以在 **FastAPI** 的 `yield` 依赖项中通过 `with` 或者 `async with` 语句来使用它们：
```Python hl_lines="1-9 13"
-{!../../../docs_src/dependencies/tutorial010.py!}
+{!../../docs_src/dependencies/tutorial010.py!}
```
/// tip | 提示
diff --git a/docs/zh/docs/tutorial/dependencies/global-dependencies.md b/docs/zh/docs/tutorial/dependencies/global-dependencies.md
index 3f7afa32c..66f153f6b 100644
--- a/docs/zh/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/zh/docs/tutorial/dependencies/global-dependencies.md
@@ -7,7 +7,7 @@
这样一来，就可以为所有*路径操作*应用该依赖项：
```Python hl_lines="15"
-{!../../../docs_src/dependencies/tutorial012.py!}
+{!../../docs_src/dependencies/tutorial012.py!}
```
[*路径装饰器依赖项*](dependencies-in-path-operation-decorators.md){.internal-link target=_blank} 一章的思路均适用于全局依赖项， 在本例中，这些依赖项可以用于应用中的所有*路径操作*。
diff --git a/docs/zh/docs/tutorial/dependencies/index.md b/docs/zh/docs/tutorial/dependencies/index.md
index b360bf71e..b039e1654 100644
--- a/docs/zh/docs/tutorial/dependencies/index.md
+++ b/docs/zh/docs/tutorial/dependencies/index.md
@@ -32,7 +32,7 @@ FastAPI 提供了简单易用，但功能强大的**<abbr title="也称为组件
依赖项就是一个函数，且可以使用与*路径操作函数*相同的参数：
```Python hl_lines="8-11"
-{!../../../docs_src/dependencies/tutorial001.py!}
+{!../../docs_src/dependencies/tutorial001.py!}
```
大功告成。
@@ -56,7 +56,7 @@ FastAPI 提供了简单易用，但功能强大的**<abbr title="也称为组件
### 导入 `Depends`
```Python hl_lines="3"
-{!../../../docs_src/dependencies/tutorial001.py!}
+{!../../docs_src/dependencies/tutorial001.py!}
```
### 声明依赖项
@@ -64,7 +64,7 @@ FastAPI 提供了简单易用，但功能强大的**<abbr title="也称为组件
与在*路径操作函数*参数中使用 `Body`、`Query` 的方式相同，声明依赖项需要使用 `Depends` 和一个新的参数：
```Python hl_lines="15 20"
-{!../../../docs_src/dependencies/tutorial001.py!}
+{!../../docs_src/dependencies/tutorial001.py!}
```
虽然，在路径操作函数的参数中使用 `Depends` 的方式与 `Body`、`Query` 相同，但 `Depends` 的工作方式略有不同。
diff --git a/docs/zh/docs/tutorial/dependencies/sub-dependencies.md b/docs/zh/docs/tutorial/dependencies/sub-dependencies.md
index d2a204c3d..dd4c60857 100644
--- a/docs/zh/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/zh/docs/tutorial/dependencies/sub-dependencies.md
@@ -11,7 +11,7 @@ FastAPI 支持创建含**子依赖项**的依赖项。
下列代码创建了第一层依赖项：
```Python hl_lines="8-9"
-{!../../../docs_src/dependencies/tutorial005.py!}
+{!../../docs_src/dependencies/tutorial005.py!}
```
这段代码声明了类型为 `str` 的可选查询参数 `q`，然后返回这个查询参数。
@@ -23,7 +23,7 @@ FastAPI 支持创建含**子依赖项**的依赖项。
接下来，创建另一个依赖项函数，并同时用该依赖项自身再声明一个依赖项（所以这也是一个「依赖项」）：
```Python hl_lines="13"
-{!../../../docs_src/dependencies/tutorial005.py!}
+{!../../docs_src/dependencies/tutorial005.py!}
```
这里重点说明一下声明的参数：
@@ -38,7 +38,7 @@ FastAPI 支持创建含**子依赖项**的依赖项。
接下来，就可以使用依赖项：
```Python hl_lines="22"
-{!../../../docs_src/dependencies/tutorial005.py!}
+{!../../docs_src/dependencies/tutorial005.py!}
```
/// info | "信息"
diff --git a/docs/zh/docs/tutorial/encoder.md b/docs/zh/docs/tutorial/encoder.md
index 8270a4093..41f37cd8d 100644
--- a/docs/zh/docs/tutorial/encoder.md
+++ b/docs/zh/docs/tutorial/encoder.md
@@ -23,7 +23,7 @@
//// tab | Python 3.10+
```Python hl_lines="4 21"
-{!> ../../../docs_src/encoder/tutorial001_py310.py!}
+{!> ../../docs_src/encoder/tutorial001_py310.py!}
```
////
@@ -31,7 +31,7 @@
//// tab | Python 3.8+
```Python hl_lines="5 22"
-{!> ../../../docs_src/encoder/tutorial001.py!}
+{!> ../../docs_src/encoder/tutorial001.py!}
```
////
diff --git a/docs/zh/docs/tutorial/extra-data-types.md b/docs/zh/docs/tutorial/extra-data-types.md
index 3b50da01f..ea5798b67 100644
--- a/docs/zh/docs/tutorial/extra-data-types.md
+++ b/docs/zh/docs/tutorial/extra-data-types.md
@@ -58,7 +58,7 @@
//// tab | Python 3.10+
```Python hl_lines="1 3 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py310.py!}
```
////
@@ -66,7 +66,7 @@
//// tab | Python 3.9+
```Python hl_lines="1 3 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py39.py!}
```
////
@@ -74,7 +74,7 @@
//// tab | Python 3.8+
```Python hl_lines="1 3 13-17"
-{!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an.py!}
```
////
@@ -88,7 +88,7 @@
///
```Python hl_lines="1 2 11-15"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
@@ -102,7 +102,7 @@
///
```Python hl_lines="1 2 12-16"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
@@ -112,7 +112,7 @@
//// tab | Python 3.10+
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py310.py!}
```
////
@@ -120,7 +120,7 @@
//// tab | Python 3.9+
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an_py39.py!}
```
////
@@ -128,7 +128,7 @@
//// tab | Python 3.8+
```Python hl_lines="19-20"
-{!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_an.py!}
```
////
@@ -142,7 +142,7 @@
///
```Python hl_lines="17-18"
-{!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+{!> ../../docs_src/extra_data_types/tutorial001_py310.py!}
```
////
@@ -156,7 +156,7 @@
///
```Python hl_lines="18-19"
-{!> ../../../docs_src/extra_data_types/tutorial001.py!}
+{!> ../../docs_src/extra_data_types/tutorial001.py!}
```
////
diff --git a/docs/zh/docs/tutorial/extra-models.md b/docs/zh/docs/tutorial/extra-models.md
index b23d4188f..6649b06c7 100644
--- a/docs/zh/docs/tutorial/extra-models.md
+++ b/docs/zh/docs/tutorial/extra-models.md
@@ -23,7 +23,7 @@
//// tab | Python 3.10+
```Python hl_lines="7 9 14 20 22 27-28 31-33 38-39"
-{!> ../../../docs_src/extra_models/tutorial001_py310.py!}
+{!> ../../docs_src/extra_models/tutorial001_py310.py!}
```
////
@@ -31,7 +31,7 @@
//// tab | Python 3.8+
```Python hl_lines="9 11 16 22 24 29-30 33-35 40-41"
-{!> ../../../docs_src/extra_models/tutorial001.py!}
+{!> ../../docs_src/extra_models/tutorial001.py!}
```
////
@@ -173,7 +173,7 @@ FastAPI 可以做得更好。
//// tab | Python 3.10+
```Python hl_lines="7 13-14 17-18 21-22"
-{!> ../../../docs_src/extra_models/tutorial002_py310.py!}
+{!> ../../docs_src/extra_models/tutorial002_py310.py!}
```
////
@@ -181,7 +181,7 @@ FastAPI 可以做得更好。
//// tab | Python 3.8+
```Python hl_lines="9 15-16 19-20 23-24"
-{!> ../../../docs_src/extra_models/tutorial002.py!}
+{!> ../../docs_src/extra_models/tutorial002.py!}
```
////
@@ -203,7 +203,7 @@ FastAPI 可以做得更好。
//// tab | Python 3.10+
```Python hl_lines="1 14-15 18-20 33"
-{!> ../../../docs_src/extra_models/tutorial003_py310.py!}
+{!> ../../docs_src/extra_models/tutorial003_py310.py!}
```
////
@@ -211,7 +211,7 @@ FastAPI 可以做得更好。
//// tab | Python 3.8+
```Python hl_lines="1 14-15 18-20 33"
-{!> ../../../docs_src/extra_models/tutorial003.py!}
+{!> ../../docs_src/extra_models/tutorial003.py!}
```
////
@@ -225,7 +225,7 @@ FastAPI 可以做得更好。
//// tab | Python 3.9+
```Python hl_lines="18"
-{!> ../../../docs_src/extra_models/tutorial004_py39.py!}
+{!> ../../docs_src/extra_models/tutorial004_py39.py!}
```
////
@@ -233,7 +233,7 @@ FastAPI 可以做得更好。
//// tab | Python 3.8+
```Python hl_lines="1 20"
-{!> ../../../docs_src/extra_models/tutorial004.py!}
+{!> ../../docs_src/extra_models/tutorial004.py!}
```
////
@@ -249,7 +249,7 @@ FastAPI 可以做得更好。
//// tab | Python 3.9+
```Python hl_lines="6"
-{!> ../../../docs_src/extra_models/tutorial005_py39.py!}
+{!> ../../docs_src/extra_models/tutorial005_py39.py!}
```
////
@@ -257,7 +257,7 @@ FastAPI 可以做得更好。
//// tab | Python 3.8+
```Python hl_lines="1 8"
-{!> ../../../docs_src/extra_models/tutorial005.py!}
+{!> ../../docs_src/extra_models/tutorial005.py!}
```
////
diff --git a/docs/zh/docs/tutorial/first-steps.md b/docs/zh/docs/tutorial/first-steps.md
index 779d1b8be..b9bbca193 100644
--- a/docs/zh/docs/tutorial/first-steps.md
+++ b/docs/zh/docs/tutorial/first-steps.md
@@ -3,7 +3,7 @@
最简单的 FastAPI 文件可能像下面这样：
```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
将其复制到 `main.py` 文件中。
@@ -135,7 +135,7 @@ OpenAPI 为你的 API 定义 API 模式。该模式中包含了你的 API 发送
### 步骤 1：导入 `FastAPI`
```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`FastAPI` 是一个为你的 API 提供了所有功能的 Python 类。
@@ -151,7 +151,7 @@ OpenAPI 为你的 API 定义 API 模式。该模式中包含了你的 API 发送
### 步骤 2：创建一个 `FastAPI`「实例」
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
这里的变量 `app` 会是 `FastAPI` 类的一个「实例」。
@@ -173,7 +173,7 @@ $ uvicorn main:app --reload
如果你像下面这样创建应用：
```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial002.py!}
+{!../../docs_src/first_steps/tutorial002.py!}
```
将代码放入 `main.py` 文件中，然后你可以像下面这样运行 `uvicorn`：
@@ -252,7 +252,7 @@ https://example.com/items/foo
#### 定义一个*路径操作装饰器*
```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
`@app.get("/")` 告诉 **FastAPI** 在它下方的函数负责处理如下访问请求：
@@ -308,7 +308,7 @@ https://example.com/items/foo
* **函数**：是位于「装饰器」下方的函数（位于 `@app.get("/")` 下方）。
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
这是一个 Python 函数。
@@ -322,7 +322,7 @@ https://example.com/items/foo
你也可以将其定义为常规函数而不使用 `async def`:
```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
+{!../../docs_src/first_steps/tutorial003.py!}
```
/// note
@@ -334,7 +334,7 @@ https://example.com/items/foo
### 步骤 5：返回内容
```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
+{!../../docs_src/first_steps/tutorial001.py!}
```
你可以返回一个 `dict`、`list`，像 `str`、`int` 一样的单个值，等等。
diff --git a/docs/zh/docs/tutorial/handling-errors.md b/docs/zh/docs/tutorial/handling-errors.md
index b5c027d44..0820c363c 100644
--- a/docs/zh/docs/tutorial/handling-errors.md
+++ b/docs/zh/docs/tutorial/handling-errors.md
@@ -26,7 +26,7 @@
### 导入 `HTTPException`
```Python hl_lines="1"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
@@ -43,7 +43,7 @@
本例中，客户端用 `ID` 请求的 `item` 不存在时，触发状态码为 `404` 的异常：
```Python hl_lines="11"
-{!../../../docs_src/handling_errors/tutorial001.py!}
+{!../../docs_src/handling_errors/tutorial001.py!}
```
@@ -86,7 +86,7 @@
但对于某些高级应用场景，还是需要添加自定义响应头：
```Python hl_lines="14"
-{!../../../docs_src/handling_errors/tutorial002.py!}
+{!../../docs_src/handling_errors/tutorial002.py!}
```
@@ -101,7 +101,7 @@
此时，可以用 `@app.exception_handler()` 添加自定义异常控制器：
```Python hl_lines="5-7 13-18 24"
-{!../../../docs_src/handling_errors/tutorial003.py!}
+{!../../docs_src/handling_errors/tutorial003.py!}
```
@@ -143,7 +143,7 @@
这样，异常处理器就可以接收 `Request` 与异常。
```Python hl_lines="2 14-16"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
@@ -199,7 +199,7 @@ path -> item_id
例如，只为错误返回纯文本响应，而不是返回 JSON 格式的内容：
```Python hl_lines="3-4 9-11 22"
-{!../../../docs_src/handling_errors/tutorial004.py!}
+{!../../docs_src/handling_errors/tutorial004.py!}
```
@@ -218,7 +218,7 @@ path -> item_id
开发时，可以用这个请求体生成日志、调试错误，并返回给用户。
```Python hl_lines="14"
-{!../../../docs_src/handling_errors/tutorial005.py!}
+{!../../docs_src/handling_errors/tutorial005.py!}
```
@@ -284,7 +284,7 @@ FastAPI 支持先对异常进行某些处理，然后再使用 **FastAPI** 中
从 `fastapi.exception_handlers` 中导入要复用的默认异常处理器：
```Python hl_lines="2-5 15 21"
-{!../../../docs_src/handling_errors/tutorial006.py!}
+{!../../docs_src/handling_errors/tutorial006.py!}
```
diff --git a/docs/zh/docs/tutorial/header-params.md b/docs/zh/docs/tutorial/header-params.md
index a9064c519..4de8bf4df 100644
--- a/docs/zh/docs/tutorial/header-params.md
+++ b/docs/zh/docs/tutorial/header-params.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001_an.py!}
+{!> ../../docs_src/header_params/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="1"
-{!> ../../../docs_src/header_params/tutorial001_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@
///
```Python hl_lines="3"
-{!> ../../../docs_src/header_params/tutorial001.py!}
+{!> ../../docs_src/header_params/tutorial001.py!}
```
////
@@ -67,7 +67,7 @@
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py310.py!}
```
////
@@ -75,7 +75,7 @@
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial001_an_py39.py!}
```
////
@@ -83,7 +83,7 @@
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial001_an.py!}
+{!> ../../docs_src/header_params/tutorial001_an.py!}
```
////
@@ -97,7 +97,7 @@
///
```Python hl_lines="7"
-{!> ../../../docs_src/header_params/tutorial001_py310.py!}
+{!> ../../docs_src/header_params/tutorial001_py310.py!}
```
////
@@ -111,7 +111,7 @@
///
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial001.py!}
+{!> ../../docs_src/header_params/tutorial001.py!}
```
////
@@ -149,7 +149,7 @@
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial002_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial002_an_py310.py!}
```
////
@@ -157,7 +157,7 @@
//// tab | Python 3.9+
```Python hl_lines="11"
-{!> ../../../docs_src/header_params/tutorial002_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial002_an_py39.py!}
```
////
@@ -165,7 +165,7 @@
//// tab | Python 3.8+
```Python hl_lines="12"
-{!> ../../../docs_src/header_params/tutorial002_an.py!}
+{!> ../../docs_src/header_params/tutorial002_an.py!}
```
////
@@ -179,7 +179,7 @@
///
```Python hl_lines="8"
-{!> ../../../docs_src/header_params/tutorial002_py310.py!}
+{!> ../../docs_src/header_params/tutorial002_py310.py!}
```
////
@@ -193,7 +193,7 @@
///
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial002.py!}
+{!> ../../docs_src/header_params/tutorial002.py!}
```
////
@@ -217,7 +217,7 @@
//// tab | Python 3.10+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_an_py310.py!}
+{!> ../../docs_src/header_params/tutorial003_an_py310.py!}
```
////
@@ -225,7 +225,7 @@
//// tab | Python 3.9+
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_an_py39.py!}
+{!> ../../docs_src/header_params/tutorial003_an_py39.py!}
```
////
@@ -233,7 +233,7 @@
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/header_params/tutorial003_an.py!}
+{!> ../../docs_src/header_params/tutorial003_an.py!}
```
////
@@ -247,7 +247,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7"
-{!> ../../../docs_src/header_params/tutorial003_py310.py!}
+{!> ../../docs_src/header_params/tutorial003_py310.py!}
```
////
@@ -261,7 +261,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003_py39.py!}
+{!> ../../docs_src/header_params/tutorial003_py39.py!}
```
////
@@ -275,7 +275,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="9"
-{!> ../../../docs_src/header_params/tutorial003.py!}
+{!> ../../docs_src/header_params/tutorial003.py!}
```
////
diff --git a/docs/zh/docs/tutorial/metadata.md b/docs/zh/docs/tutorial/metadata.md
index 3316e2ce4..7252db9f6 100644
--- a/docs/zh/docs/tutorial/metadata.md
+++ b/docs/zh/docs/tutorial/metadata.md
@@ -19,7 +19,7 @@
你可以按如下方式设置它们：
```Python hl_lines="4-6"
-{!../../../docs_src/metadata/tutorial001.py!}
+{!../../docs_src/metadata/tutorial001.py!}
```
/// tip
@@ -41,7 +41,7 @@
创建标签元数据并把它传递给 `openapi_tags` 参数：
```Python hl_lines="3-16 18"
-{!../../../docs_src/metadata/tutorial004.py!}
+{!../../docs_src/metadata/tutorial004.py!}
```
注意你可以在描述内使用 Markdown，例如「login」会显示为粗体（**login**）以及「fancy」会显示为斜体（_fancy_）。
@@ -57,7 +57,7 @@
将 `tags` 参数和*路径操作*（以及 `APIRouter`）一起使用，将其分配给不同的标签：
```Python hl_lines="21 26"
-{!../../../docs_src/metadata/tutorial004.py!}
+{!../../docs_src/metadata/tutorial004.py!}
```
/// info | "信息"
@@ -87,7 +87,7 @@
例如，将其设置为服务于 `/api/v1/openapi.json`：
```Python hl_lines="3"
-{!../../../docs_src/metadata/tutorial002.py!}
+{!../../docs_src/metadata/tutorial002.py!}
```
如果你想完全禁用 OpenAPI 模式，可以将其设置为 `openapi_url=None`，这样也会禁用使用它的文档用户界面。
@@ -106,5 +106,5 @@
例如，设置 Swagger UI 服务于 `/documentation` 并禁用 ReDoc：
```Python hl_lines="3"
-{!../../../docs_src/metadata/tutorial003.py!}
+{!../../docs_src/metadata/tutorial003.py!}
```
diff --git a/docs/zh/docs/tutorial/middleware.md b/docs/zh/docs/tutorial/middleware.md
index 7cc6cac42..fb2874ba3 100644
--- a/docs/zh/docs/tutorial/middleware.md
+++ b/docs/zh/docs/tutorial/middleware.md
@@ -32,7 +32,7 @@
* 然后你可以在返回 `response` 前进一步修改它.
```Python hl_lines="8-9 11 14"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
/// tip
@@ -60,7 +60,7 @@
例如你可以添加自定义请求头 `X-Process-Time` 包含以秒为单位的接收请求和生成响应的时间:
```Python hl_lines="10 12-13"
-{!../../../docs_src/middleware/tutorial001.py!}
+{!../../docs_src/middleware/tutorial001.py!}
```
## 其他中间件
diff --git a/docs/zh/docs/tutorial/path-operation-configuration.md b/docs/zh/docs/tutorial/path-operation-configuration.md
index ac0177128..12e1f24ba 100644
--- a/docs/zh/docs/tutorial/path-operation-configuration.md
+++ b/docs/zh/docs/tutorial/path-operation-configuration.md
@@ -17,7 +17,7 @@
如果记不住数字码的涵义，也可以用 `status` 的快捷常量：
```Python hl_lines="3 17"
-{!../../../docs_src/path_operation_configuration/tutorial001.py!}
+{!../../docs_src/path_operation_configuration/tutorial001.py!}
```
状态码在响应中使用，并会被添加到 OpenAPI 概图。
@@ -35,7 +35,7 @@
`tags` 参数的值是由 `str` 组成的 `list` （一般只有一个 `str` ），`tags` 用于为*路径操作*添加标签：
```Python hl_lines="17 22 27"
-{!../../../docs_src/path_operation_configuration/tutorial002.py!}
+{!../../docs_src/path_operation_configuration/tutorial002.py!}
```
OpenAPI 概图会自动添加标签，供 API 文档接口使用：
@@ -47,7 +47,7 @@ OpenAPI 概图会自动添加标签，供 API 文档接口使用：
路径装饰器还支持 `summary` 和 `description` 这两个参数：
```Python hl_lines="20-21"
-{!../../../docs_src/path_operation_configuration/tutorial003.py!}
+{!../../docs_src/path_operation_configuration/tutorial003.py!}
```
## 文档字符串（`docstring`）
@@ -57,7 +57,7 @@ OpenAPI 概图会自动添加标签，供 API 文档接口使用：
文档字符串支持 <a href="https://en.wikipedia.org/wiki/Markdown" class="external-link" target="_blank">Markdown</a>，能正确解析和显示 Markdown 的内容，但要注意文档字符串的缩进。
```Python hl_lines="19-27"
-{!../../../docs_src/path_operation_configuration/tutorial004.py!}
+{!../../docs_src/path_operation_configuration/tutorial004.py!}
```
下图为 Markdown 文本在 API 文档中的显示效果：
@@ -69,7 +69,7 @@ OpenAPI 概图会自动添加标签，供 API 文档接口使用：
`response_description` 参数用于定义响应的描述说明：
```Python hl_lines="21"
-{!../../../docs_src/path_operation_configuration/tutorial005.py!}
+{!../../docs_src/path_operation_configuration/tutorial005.py!}
```
/// info | "说明"
@@ -93,7 +93,7 @@ OpenAPI 规定每个*路径操作*都要有响应描述。
`deprecated` 参数可以把*路径操作*标记为<abbr title="过时，建议不要使用">弃用</abbr>，无需直接删除：
```Python hl_lines="16"
-{!../../../docs_src/path_operation_configuration/tutorial006.py!}
+{!../../docs_src/path_operation_configuration/tutorial006.py!}
```
API 文档会把该路径操作标记为弃用：
diff --git a/docs/zh/docs/tutorial/path-params-numeric-validations.md b/docs/zh/docs/tutorial/path-params-numeric-validations.md
index 6310ad8d2..29197ac53 100644
--- a/docs/zh/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/zh/docs/tutorial/path-params-numeric-validations.md
@@ -9,7 +9,7 @@
//// tab | Python 3.10+
```Python hl_lines="1 3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
```
////
@@ -17,7 +17,7 @@
//// tab | Python 3.9+
```Python hl_lines="1 3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
```
////
@@ -25,7 +25,7 @@
//// tab | Python 3.8+
```Python hl_lines="3-4"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
```
////
@@ -39,7 +39,7 @@
///
```Python hl_lines="1"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -53,7 +53,7 @@
///
```Python hl_lines="3"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -67,7 +67,7 @@
//// tab | Python 3.10+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
```
////
@@ -75,7 +75,7 @@
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
```
////
@@ -83,7 +83,7 @@
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
```
////
@@ -97,7 +97,7 @@
///
```Python hl_lines="8"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
```
////
@@ -111,7 +111,7 @@
///
```Python hl_lines="10"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
////
@@ -151,7 +151,7 @@
///
```Python hl_lines="7"
-{!> ../../../docs_src/path_params_numeric_validations/tutorial002.py!}
+{!> ../../docs_src/path_params_numeric_validations/tutorial002.py!}
```
////
@@ -165,7 +165,7 @@
Python 不会对该 `*` 做任何事情，但是它将知道之后的所有参数都应作为关键字参数（键值对），也被称为 <abbr title="来自：K-ey W-ord Arg-uments"><code>kwargs</code></abbr>，来调用。即使它们没有默认值。
```Python hl_lines="7"
-{!../../../docs_src/path_params_numeric_validations/tutorial003.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial003.py!}
```
## 数值校验：大于等于
@@ -175,7 +175,7 @@ Python 不会对该 `*` 做任何事情，但是它将知道之后的所有参
像下面这样，添加 `ge=1` 后，`item_id` 将必须是一个大于（`g`reater than）或等于（`e`qual）`1` 的整数。
```Python hl_lines="8"
-{!../../../docs_src/path_params_numeric_validations/tutorial004.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial004.py!}
```
## 数值校验：大于和小于等于
@@ -186,7 +186,7 @@ Python 不会对该 `*` 做任何事情，但是它将知道之后的所有参
* `le`：小于等于（`l`ess than or `e`qual）
```Python hl_lines="9"
-{!../../../docs_src/path_params_numeric_validations/tutorial005.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial005.py!}
```
## 数值校验：浮点数、大于和小于
@@ -200,7 +200,7 @@ Python 不会对该 `*` 做任何事情，但是它将知道之后的所有参
对于 <abbr title="less than"><code>lt</code></abbr> 也是一样的。
```Python hl_lines="11"
-{!../../../docs_src/path_params_numeric_validations/tutorial006.py!}
+{!../../docs_src/path_params_numeric_validations/tutorial006.py!}
```
## 总结
diff --git a/docs/zh/docs/tutorial/path-params.md b/docs/zh/docs/tutorial/path-params.md
index 091dcbeb0..a29ee0e2b 100644
--- a/docs/zh/docs/tutorial/path-params.md
+++ b/docs/zh/docs/tutorial/path-params.md
@@ -3,7 +3,7 @@
FastAPI 支持使用 Python 字符串格式化语法声明**路径参数**（**变量**）：
```Python hl_lines="6-7"
-{!../../../docs_src/path_params/tutorial001.py!}
+{!../../docs_src/path_params/tutorial001.py!}
```
这段代码把路径参数 `item_id` 的值传递给路径函数的参数 `item_id`。
@@ -19,7 +19,7 @@ FastAPI 支持使用 Python 字符串格式化语法声明**路径参数**（**
使用 Python 标准类型注解，声明路径操作函数中路径参数的类型。
```Python hl_lines="7"
-{!../../../docs_src/path_params/tutorial002.py!}
+{!../../docs_src/path_params/tutorial002.py!}
```
本例把 `item_id` 的类型声明为 `int`。
@@ -122,7 +122,7 @@ FastAPI 充分地利用了 <a href="https://docs.pydantic.dev/" class="external-
由于*路径操作*是按顺序依次运行的，因此，一定要在 `/users/{user_id}` 之前声明 `/users/me` ：
```Python hl_lines="6 11"
-{!../../../docs_src/path_params/tutorial003.py!}
+{!../../docs_src/path_params/tutorial003.py!}
```
否则，`/users/{user_id}` 将匹配 `/users/me`，FastAPI 会**认为**正在接收值为 `"me"` 的 `user_id` 参数。
@@ -140,7 +140,7 @@ FastAPI 充分地利用了 <a href="https://docs.pydantic.dev/" class="external-
然后，创建包含固定值的类属性，这些固定值是可用的有效值：
```Python hl_lines="1 6-9"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// info | "说明"
@@ -160,7 +160,7 @@ Python 3.4 及之后版本支持<a href="https://docs.python.org/3/library/enum.
使用 Enum 类（`ModelName`）创建使用类型注解的*路径参数*：
```Python hl_lines="16"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
### 查看文档
@@ -178,7 +178,7 @@ Python 3.4 及之后版本支持<a href="https://docs.python.org/3/library/enum.
枚举类 `ModelName` 中的*枚举元素*支持比较操作：
```Python hl_lines="17"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
#### 获取*枚举值*
@@ -186,7 +186,7 @@ Python 3.4 及之后版本支持<a href="https://docs.python.org/3/library/enum.
使用 `model_name.value` 或 `your_enum_member.value` 获取实际的值（本例中为**字符串**）：
```Python hl_lines="20"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
/// tip | "提示"
@@ -202,7 +202,7 @@ Python 3.4 及之后版本支持<a href="https://docs.python.org/3/library/enum.
返回给客户端之前，要把枚举元素转换为对应的值（本例中为字符串）：
```Python hl_lines="18 21 23"
-{!../../../docs_src/path_params/tutorial005.py!}
+{!../../docs_src/path_params/tutorial005.py!}
```
客户端中的 JSON 响应如下：
@@ -243,7 +243,7 @@ OpenAPI 不支持声明包含路径的*路径参数*，因为这会导致测试
用法如下：
```Python hl_lines="6"
-{!../../../docs_src/path_params/tutorial004.py!}
+{!../../docs_src/path_params/tutorial004.py!}
```
/// tip | "提示"
diff --git a/docs/zh/docs/tutorial/query-params-str-validations.md b/docs/zh/docs/tutorial/query-params-str-validations.md
index cb4beb0ca..70e6f8a96 100644
--- a/docs/zh/docs/tutorial/query-params-str-validations.md
+++ b/docs/zh/docs/tutorial/query-params-str-validations.md
@@ -7,7 +7,7 @@
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params_str_validations/tutorial001_py310.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial001_py310.py!}
```
////
@@ -15,7 +15,7 @@
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params_str_validations/tutorial001.py!}
+{!> ../../docs_src/query_params_str_validations/tutorial001.py!}
```
////
@@ -31,7 +31,7 @@
为此，首先从 `fastapi` 导入 `Query`：
```Python hl_lines="1"
-{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!../../docs_src/query_params_str_validations/tutorial002.py!}
```
## 使用 `Query` 作为默认值
@@ -39,7 +39,7 @@
现在，将 `Query` 用作查询参数的默认值，并将它的 `max_length` 参数设置为 50：
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+{!../../docs_src/query_params_str_validations/tutorial002.py!}
```
由于我们必须用 `Query(default=None)` 替换默认值 `None`，`Query` 的第一个参数同样也是用于定义默认值。
@@ -71,7 +71,7 @@ q: Union[str, None] = Query(default=None, max_length=50)
你还可以添加 `min_length` 参数：
```Python hl_lines="10"
-{!../../../docs_src/query_params_str_validations/tutorial003.py!}
+{!../../docs_src/query_params_str_validations/tutorial003.py!}
```
## 添加正则表达式
@@ -79,7 +79,7 @@ q: Union[str, None] = Query(default=None, max_length=50)
你可以定义一个参数值必须匹配的<abbr title="正则表达式或正则是定义字符串搜索模式的字符序列。">正则表达式</abbr>：
```Python hl_lines="11"
-{!../../../docs_src/query_params_str_validations/tutorial004.py!}
+{!../../docs_src/query_params_str_validations/tutorial004.py!}
```
这个指定的正则表达式通过以下规则检查接收到的参数值：
@@ -99,7 +99,7 @@ q: Union[str, None] = Query(default=None, max_length=50)
假设你想要声明查询参数 `q`，使其 `min_length` 为 `3`，并且默认值为 `fixedquery`：
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial005.py!}
+{!../../docs_src/query_params_str_validations/tutorial005.py!}
```
/// note
@@ -131,7 +131,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
因此，当你在使用 `Query` 且需要声明一个值是必需的时，只需不声明默认参数：
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial006.py!}
+{!../../docs_src/query_params_str_validations/tutorial006.py!}
```
### 使用省略号(`...`)声明必需参数
@@ -139,7 +139,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
有另一种方法可以显式的声明一个值是必需的，即将默认参数的默认值设为 `...` ：
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial006b.py!}
+{!../../docs_src/query_params_str_validations/tutorial006b.py!}
```
/// info
@@ -158,7 +158,7 @@ Pydantic 和 FastAPI 使用它来显式的声明需要一个值。
为此，你可以声明`None`是一个有效的类型，并仍然使用`default=...`：
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial006c.py!}
+{!../../docs_src/query_params_str_validations/tutorial006c.py!}
```
/// tip
@@ -172,7 +172,7 @@ Pydantic 是 FastAPI 中所有数据验证和序列化的核心，当你在没
如果你觉得使用 `...` 不舒服，你也可以从 Pydantic 导入并使用 `Required`：
```Python hl_lines="2 8"
-{!../../../docs_src/query_params_str_validations/tutorial006d.py!}
+{!../../docs_src/query_params_str_validations/tutorial006d.py!}
```
/// tip
@@ -188,7 +188,7 @@ Pydantic 是 FastAPI 中所有数据验证和序列化的核心，当你在没
例如，要声明一个可在 URL 中出现多次的查询参数 `q`，你可以这样写：
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial011.py!}
+{!../../docs_src/query_params_str_validations/tutorial011.py!}
```
然后，输入如下网址：
@@ -225,7 +225,7 @@ http://localhost:8000/items/?q=foo&q=bar
你还可以定义在没有任何给定值时的默认 `list` 值：
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial012.py!}
+{!../../docs_src/query_params_str_validations/tutorial012.py!}
```
如果你访问：
@@ -250,7 +250,7 @@ http://localhost:8000/items/
你也可以直接使用 `list` 代替 `List [str]`：
```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial013.py!}
+{!../../docs_src/query_params_str_validations/tutorial013.py!}
```
/// note
@@ -278,13 +278,13 @@ http://localhost:8000/items/
你可以添加 `title`：
```Python hl_lines="10"
-{!../../../docs_src/query_params_str_validations/tutorial007.py!}
+{!../../docs_src/query_params_str_validations/tutorial007.py!}
```
以及 `description`：
```Python hl_lines="13"
-{!../../../docs_src/query_params_str_validations/tutorial008.py!}
+{!../../docs_src/query_params_str_validations/tutorial008.py!}
```
## 别名参数
@@ -306,7 +306,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
这时你可以用 `alias` 参数声明一个别名，该别名将用于在 URL 中查找查询参数值：
```Python hl_lines="9"
-{!../../../docs_src/query_params_str_validations/tutorial009.py!}
+{!../../docs_src/query_params_str_validations/tutorial009.py!}
```
## 弃用参数
@@ -318,7 +318,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
那么将参数 `deprecated=True` 传入 `Query`：
```Python hl_lines="18"
-{!../../../docs_src/query_params_str_validations/tutorial010.py!}
+{!../../docs_src/query_params_str_validations/tutorial010.py!}
```
文档将会像下面这样展示它：
diff --git a/docs/zh/docs/tutorial/query-params.md b/docs/zh/docs/tutorial/query-params.md
index 6853e3899..f17d43d3a 100644
--- a/docs/zh/docs/tutorial/query-params.md
+++ b/docs/zh/docs/tutorial/query-params.md
@@ -3,7 +3,7 @@
声明的参数不是路径参数时，路径操作函数会把该参数自动解释为**查询**参数。
```Python hl_lines="9"
-{!../../../docs_src/query_params/tutorial001.py!}
+{!../../docs_src/query_params/tutorial001.py!}
```
查询字符串是键值对的集合，这些键值对位于 URL 的 `?` 之后，以 `&` 分隔。
@@ -66,7 +66,7 @@ http://127.0.0.1:8000/items/?skip=20
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial002_py310.py!}
+{!> ../../docs_src/query_params/tutorial002_py310.py!}
```
////
@@ -74,7 +74,7 @@ http://127.0.0.1:8000/items/?skip=20
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial002.py!}
+{!> ../../docs_src/query_params/tutorial002.py!}
```
////
@@ -103,7 +103,7 @@ FastAPI 不使用 `Optional[str]` 中的 `Optional`（只使用 `str`），但 `
//// tab | Python 3.10+
```Python hl_lines="7"
-{!> ../../../docs_src/query_params/tutorial003_py310.py!}
+{!> ../../docs_src/query_params/tutorial003_py310.py!}
```
////
@@ -111,7 +111,7 @@ FastAPI 不使用 `Optional[str]` 中的 `Optional`（只使用 `str`），但 `
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/query_params/tutorial003.py!}
+{!> ../../docs_src/query_params/tutorial003.py!}
```
////
@@ -160,7 +160,7 @@ FastAPI 通过参数名进行检测：
//// tab | Python 3.10+
```Python hl_lines="6 8"
-{!> ../../../docs_src/query_params/tutorial004_py310.py!}
+{!> ../../docs_src/query_params/tutorial004_py310.py!}
```
////
@@ -168,7 +168,7 @@ FastAPI 通过参数名进行检测：
//// tab | Python 3.8+
```Python hl_lines="8 10"
-{!> ../../../docs_src/query_params/tutorial004.py!}
+{!> ../../docs_src/query_params/tutorial004.py!}
```
////
@@ -182,7 +182,7 @@ FastAPI 通过参数名进行检测：
如果要把查询参数设置为**必选**，就不要声明默认值：
```Python hl_lines="6-7"
-{!../../../docs_src/query_params/tutorial005.py!}
+{!../../docs_src/query_params/tutorial005.py!}
```
这里的查询参数 `needy` 是类型为 `str` 的必选查询参数。
@@ -230,7 +230,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
//// tab | Python 3.10+
```Python hl_lines="8"
-{!> ../../../docs_src/query_params/tutorial006_py310.py!}
+{!> ../../docs_src/query_params/tutorial006_py310.py!}
```
////
@@ -238,7 +238,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
//// tab | Python 3.8+
```Python hl_lines="10"
-{!> ../../../docs_src/query_params/tutorial006.py!}
+{!> ../../docs_src/query_params/tutorial006.py!}
```
////
diff --git a/docs/zh/docs/tutorial/request-files.md b/docs/zh/docs/tutorial/request-files.md
index d5d0fb671..026771495 100644
--- a/docs/zh/docs/tutorial/request-files.md
+++ b/docs/zh/docs/tutorial/request-files.md
@@ -17,7 +17,7 @@
从 `fastapi` 导入 `File` 和 `UploadFile`：
```Python hl_lines="1"
-{!../../../docs_src/request_files/tutorial001.py!}
+{!../../docs_src/request_files/tutorial001.py!}
```
## 定义 `File` 参数
@@ -25,7 +25,7 @@
创建文件（`File`）参数的方式与 `Body` 和 `Form` 一样：
```Python hl_lines="7"
-{!../../../docs_src/request_files/tutorial001.py!}
+{!../../docs_src/request_files/tutorial001.py!}
```
/// info | "说明"
@@ -55,7 +55,7 @@
定义文件参数时使用 `UploadFile`：
```Python hl_lines="12"
-{!../../../docs_src/request_files/tutorial001.py!}
+{!../../docs_src/request_files/tutorial001.py!}
```
`UploadFile` 与 `bytes` 相比有更多优势：
@@ -141,7 +141,7 @@ contents = myfile.file.read()
//// tab | Python 3.9+
```Python hl_lines="7 14"
-{!> ../../../docs_src/request_files/tutorial001_02_py310.py!}
+{!> ../../docs_src/request_files/tutorial001_02_py310.py!}
```
////
@@ -149,7 +149,7 @@ contents = myfile.file.read()
//// tab | Python 3.8+
```Python hl_lines="9 17"
-{!> ../../../docs_src/request_files/tutorial001_02.py!}
+{!> ../../docs_src/request_files/tutorial001_02.py!}
```
////
@@ -159,7 +159,7 @@ contents = myfile.file.read()
您也可以将 `File()` 与 `UploadFile` 一起使用，例如，设置额外的元数据:
```Python hl_lines="13"
-{!../../../docs_src/request_files/tutorial001_03.py!}
+{!../../docs_src/request_files/tutorial001_03.py!}
```
## 多文件上传
@@ -173,7 +173,7 @@ FastAPI 支持同时上传多个文件。
//// tab | Python 3.9+
```Python hl_lines="8 13"
-{!> ../../../docs_src/request_files/tutorial002_py39.py!}
+{!> ../../docs_src/request_files/tutorial002_py39.py!}
```
////
@@ -181,7 +181,7 @@ FastAPI 支持同时上传多个文件。
//// tab | Python 3.8+
```Python hl_lines="10 15"
-{!> ../../../docs_src/request_files/tutorial002.py!}
+{!> ../../docs_src/request_files/tutorial002.py!}
```
////
@@ -204,7 +204,7 @@ FastAPI 支持同时上传多个文件。
//// tab | Python 3.9+
```Python hl_lines="16"
-{!> ../../../docs_src/request_files/tutorial003_py39.py!}
+{!> ../../docs_src/request_files/tutorial003_py39.py!}
```
////
@@ -212,7 +212,7 @@ FastAPI 支持同时上传多个文件。
//// tab | Python 3.8+
```Python hl_lines="18"
-{!> ../../../docs_src/request_files/tutorial003.py!}
+{!> ../../docs_src/request_files/tutorial003.py!}
```
////
diff --git a/docs/zh/docs/tutorial/request-forms-and-files.md b/docs/zh/docs/tutorial/request-forms-and-files.md
index 723cf5b18..ae0fd82ca 100644
--- a/docs/zh/docs/tutorial/request-forms-and-files.md
+++ b/docs/zh/docs/tutorial/request-forms-and-files.md
@@ -13,7 +13,7 @@ FastAPI 支持同时使用 `File` 和 `Form` 定义文件和表单字段。
## 导入 `File` 与 `Form`
```Python hl_lines="1"
-{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!../../docs_src/request_forms_and_files/tutorial001.py!}
```
## 定义 `File` 与 `Form` 参数
@@ -21,7 +21,7 @@ FastAPI 支持同时使用 `File` 和 `Form` 定义文件和表单字段。
创建文件和表单参数的方式与 `Body` 和 `Query` 一样：
```Python hl_lines="8"
-{!../../../docs_src/request_forms_and_files/tutorial001.py!}
+{!../../docs_src/request_forms_and_files/tutorial001.py!}
```
文件和表单字段作为表单数据上传与接收。
diff --git a/docs/zh/docs/tutorial/request-forms.md b/docs/zh/docs/tutorial/request-forms.md
index 6cc472ac1..94c8839b3 100644
--- a/docs/zh/docs/tutorial/request-forms.md
+++ b/docs/zh/docs/tutorial/request-forms.md
@@ -15,7 +15,7 @@
从 `fastapi` 导入 `Form`：
```Python hl_lines="1"
-{!../../../docs_src/request_forms/tutorial001.py!}
+{!../../docs_src/request_forms/tutorial001.py!}
```
## 定义 `Form` 参数
@@ -23,7 +23,7 @@
创建表单（`Form`）参数的方式与 `Body` 和 `Query` 一样：
```Python hl_lines="7"
-{!../../../docs_src/request_forms/tutorial001.py!}
+{!../../docs_src/request_forms/tutorial001.py!}
```
例如，OAuth2 规范的 "密码流" 模式规定要通过表单字段发送 `username` 和 `password`。
diff --git a/docs/zh/docs/tutorial/response-model.md b/docs/zh/docs/tutorial/response-model.md
index 3c196c964..40fb40720 100644
--- a/docs/zh/docs/tutorial/response-model.md
+++ b/docs/zh/docs/tutorial/response-model.md
@@ -11,7 +11,7 @@
//// tab | Python 3.10+
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001_py310.py!}
+{!> ../../docs_src/response_model/tutorial001_py310.py!}
```
////
@@ -19,7 +19,7 @@
//// tab | Python 3.9+
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001_py39.py!}
+{!> ../../docs_src/response_model/tutorial001_py39.py!}
```
////
@@ -27,7 +27,7 @@
//// tab | Python 3.8+
```Python hl_lines="17 22 24-27"
-{!> ../../../docs_src/response_model/tutorial001.py!}
+{!> ../../docs_src/response_model/tutorial001.py!}
```
////
@@ -62,13 +62,13 @@ FastAPI 将使用此 `response_model` 来：
现在我们声明一个 `UserIn` 模型，它将包含一个明文密码属性。
```Python hl_lines="9 11"
-{!../../../docs_src/response_model/tutorial002.py!}
+{!../../docs_src/response_model/tutorial002.py!}
```
我们正在使用此模型声明输入数据，并使用同一模型声明输出数据：
```Python hl_lines="17-18"
-{!../../../docs_src/response_model/tutorial002.py!}
+{!../../docs_src/response_model/tutorial002.py!}
```
现在，每当浏览器使用一个密码创建用户时，API 都会在响应中返回相同的密码。
@@ -90,7 +90,7 @@ FastAPI 将使用此 `response_model` 来：
//// tab | Python 3.10+
```Python hl_lines="9 11 16"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -98,7 +98,7 @@ FastAPI 将使用此 `response_model` 来：
//// tab | Python 3.8+
```Python hl_lines="9 11 16"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -108,7 +108,7 @@ FastAPI 将使用此 `response_model` 来：
//// tab | Python 3.10+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -116,7 +116,7 @@ FastAPI 将使用此 `response_model` 来：
//// tab | Python 3.8+
```Python hl_lines="24"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -126,7 +126,7 @@ FastAPI 将使用此 `response_model` 来：
//// tab | Python 3.10+
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial003_py310.py!}
+{!> ../../docs_src/response_model/tutorial003_py310.py!}
```
////
@@ -134,7 +134,7 @@ FastAPI 将使用此 `response_model` 来：
//// tab | Python 3.8+
```Python hl_lines="22"
-{!> ../../../docs_src/response_model/tutorial003.py!}
+{!> ../../docs_src/response_model/tutorial003.py!}
```
////
@@ -156,7 +156,7 @@ FastAPI 将使用此 `response_model` 来：
你的响应模型可以具有默认值，例如：
```Python hl_lines="11 13-14"
-{!../../../docs_src/response_model/tutorial004.py!}
+{!../../docs_src/response_model/tutorial004.py!}
```
* `description: Union[str, None] = None` 具有默认值 `None`。
@@ -172,7 +172,7 @@ FastAPI 将使用此 `response_model` 来：
你可以设置*路径操作装饰器*的 `response_model_exclude_unset=True` 参数：
```Python hl_lines="24"
-{!../../../docs_src/response_model/tutorial004.py!}
+{!../../docs_src/response_model/tutorial004.py!}
```
然后响应中将不会包含那些默认值，而是仅有实际设置的值。
@@ -263,7 +263,7 @@ FastAPI 通过 Pydantic 模型的 `.dict()` 配合 <a href="https://docs.pydanti
///
```Python hl_lines="31 37"
-{!../../../docs_src/response_model/tutorial005.py!}
+{!../../docs_src/response_model/tutorial005.py!}
```
/// tip
@@ -279,7 +279,7 @@ FastAPI 通过 Pydantic 模型的 `.dict()` 配合 <a href="https://docs.pydanti
如果你忘记使用 `set` 而是使用 `list` 或 `tuple`，FastAPI 仍会将其转换为 `set` 并且正常工作：
```Python hl_lines="31 37"
-{!../../../docs_src/response_model/tutorial006.py!}
+{!../../docs_src/response_model/tutorial006.py!}
```
## 总结
diff --git a/docs/zh/docs/tutorial/response-status-code.md b/docs/zh/docs/tutorial/response-status-code.md
index 506cd4a43..55bf502ae 100644
--- a/docs/zh/docs/tutorial/response-status-code.md
+++ b/docs/zh/docs/tutorial/response-status-code.md
@@ -9,7 +9,7 @@
* 等……
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
/// note | "笔记"
@@ -77,7 +77,7 @@ FastAPI 可以进行识别，并生成表明无响应体的 OpenAPI 文档。
再看下之前的例子：
```Python hl_lines="6"
-{!../../../docs_src/response_status_code/tutorial001.py!}
+{!../../docs_src/response_status_code/tutorial001.py!}
```
`201` 表示**已创建**的状态码。
@@ -87,7 +87,7 @@ FastAPI 可以进行识别，并生成表明无响应体的 OpenAPI 文档。
可以使用 `fastapi.status` 中的快捷变量。
```Python hl_lines="1 6"
-{!../../../docs_src/response_status_code/tutorial002.py!}
+{!../../docs_src/response_status_code/tutorial002.py!}
```
这只是一种快捷方式，具有相同的数字代码，但它可以使用编辑器的自动补全功能：
diff --git a/docs/zh/docs/tutorial/schema-extra-example.md b/docs/zh/docs/tutorial/schema-extra-example.md
index 6063bd731..b3883e4d3 100644
--- a/docs/zh/docs/tutorial/schema-extra-example.md
+++ b/docs/zh/docs/tutorial/schema-extra-example.md
@@ -13,7 +13,7 @@
//// tab | Python 3.10+
```Python hl_lines="13-21"
-{!> ../../../docs_src/schema_extra_example/tutorial001_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001_py310.py!}
```
////
@@ -21,7 +21,7 @@
//// tab | Python 3.8+
```Python hl_lines="15-23"
-{!> ../../../docs_src/schema_extra_example/tutorial001.py!}
+{!> ../../docs_src/schema_extra_example/tutorial001.py!}
```
////
@@ -35,7 +35,7 @@
//// tab | Python 3.10+
```Python hl_lines="2 8-11"
-{!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial002_py310.py!}
```
////
@@ -43,7 +43,7 @@
//// tab | Python 3.8+
```Python hl_lines="4 10-13"
-{!> ../../../docs_src/schema_extra_example/tutorial002.py!}
+{!> ../../docs_src/schema_extra_example/tutorial002.py!}
```
////
@@ -63,7 +63,7 @@
//// tab | Python 3.10+
```Python hl_lines="22-27"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
```
////
@@ -71,7 +71,7 @@
//// tab | Python 3.9+
```Python hl_lines="22-27"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
```
////
@@ -79,7 +79,7 @@
//// tab | Python 3.8+
```Python hl_lines="23-28"
-{!> ../../../docs_src/schema_extra_example/tutorial003_an.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_an.py!}
```
////
@@ -93,7 +93,7 @@
///
```Python hl_lines="18-23"
-{!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003_py310.py!}
```
////
@@ -107,7 +107,7 @@
///
```Python hl_lines="20-25"
-{!> ../../../docs_src/schema_extra_example/tutorial003.py!}
+{!> ../../docs_src/schema_extra_example/tutorial003.py!}
```
////
diff --git a/docs/zh/docs/tutorial/security/first-steps.md b/docs/zh/docs/tutorial/security/first-steps.md
index 266a5fcdf..8294b6444 100644
--- a/docs/zh/docs/tutorial/security/first-steps.md
+++ b/docs/zh/docs/tutorial/security/first-steps.md
@@ -23,7 +23,7 @@
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/security/tutorial001_an_py39.py!}
+{!> ../../docs_src/security/tutorial001_an_py39.py!}
```
////
@@ -31,7 +31,7 @@
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/security/tutorial001_an.py!}
+{!> ../../docs_src/security/tutorial001_an.py!}
```
////
@@ -45,7 +45,7 @@
///
```Python
-{!> ../../../docs_src/security/tutorial001.py!}
+{!> ../../docs_src/security/tutorial001.py!}
```
////
@@ -155,7 +155,7 @@ OAuth2 的设计目标是为了让后端或 API 独立于服务器验证用户
创建 `OAuth2PasswordBearer` 的类实例时，要传递 `tokenUrl` 参数。该参数包含客户端（用户浏览器中运行的前端） 的 URL，用于发送 `username` 与 `password`，并获取令牌。
```Python hl_lines="6"
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
/// tip | "提示"
@@ -195,7 +195,7 @@ oauth2_scheme(some, parameters)
接下来，使用 `Depends` 把 `oauth2_scheme` 传入依赖项。
```Python hl_lines="10"
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
该依赖项使用字符串（`str`）接收*路径操作函数*的参数 `token` 。
diff --git a/docs/zh/docs/tutorial/security/get-current-user.md b/docs/zh/docs/tutorial/security/get-current-user.md
index f8094e86a..97461817a 100644
--- a/docs/zh/docs/tutorial/security/get-current-user.md
+++ b/docs/zh/docs/tutorial/security/get-current-user.md
@@ -3,7 +3,7 @@
上一章中，（基于依赖注入系统的）安全系统向*路径操作函数*传递了 `str` 类型的 `token`：
```Python hl_lines="10"
-{!../../../docs_src/security/tutorial001.py!}
+{!../../docs_src/security/tutorial001.py!}
```
但这并不实用。
@@ -18,7 +18,7 @@
与使用 Pydantic 声明请求体相同，并且可在任何位置使用：
```Python hl_lines="5 12-16"
-{!../../../docs_src/security/tutorial002.py!}
+{!../../docs_src/security/tutorial002.py!}
```
## 创建 `get_current_user` 依赖项
@@ -32,7 +32,7 @@
与之前直接在路径操作中的做法相同，新的 `get_current_user` 依赖项从子依赖项 `oauth2_scheme` 中接收 `str` 类型的 `token`：
```Python hl_lines="25"
-{!../../../docs_src/security/tutorial002.py!}
+{!../../docs_src/security/tutorial002.py!}
```
## 获取用户
@@ -40,7 +40,7 @@
`get_current_user` 使用创建的（伪）工具函数，该函数接收 `str` 类型的令牌，并返回 Pydantic 的 `User` 模型：
```Python hl_lines="19-22 26-27"
-{!../../../docs_src/security/tutorial002.py!}
+{!../../docs_src/security/tutorial002.py!}
```
## 注入当前用户
@@ -48,7 +48,7 @@
在*路径操作* 的 `Depends` 中使用 `get_current_user`：
```Python hl_lines="31"
-{!../../../docs_src/security/tutorial002.py!}
+{!../../docs_src/security/tutorial002.py!}
```
注意，此处把 `current_user` 的类型声明为 Pydantic 的 `User` 模型。
@@ -105,7 +105,7 @@
所有*路径操作*只需 3 行代码就可以了：
```Python hl_lines="30-32"
-{!../../../docs_src/security/tutorial002.py!}
+{!../../docs_src/security/tutorial002.py!}
```
## 小结
diff --git a/docs/zh/docs/tutorial/security/oauth2-jwt.md b/docs/zh/docs/tutorial/security/oauth2-jwt.md
index 690bd1789..8e497b844 100644
--- a/docs/zh/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/zh/docs/tutorial/security/oauth2-jwt.md
@@ -117,7 +117,7 @@ PassLib 上下文还支持使用不同哈希算法的功能，包括只能校验
//// tab | Python 3.10+
```Python hl_lines="8 49 56-57 60-61 70-76"
-{!> ../../../docs_src/security/tutorial004_an_py310.py!}
+{!> ../../docs_src/security/tutorial004_an_py310.py!}
```
////
@@ -125,7 +125,7 @@ PassLib 上下文还支持使用不同哈希算法的功能，包括只能校验
//// tab | Python 3.9+
```Python hl_lines="8 49 56-57 60-61 70-76"
-{!> ../../../docs_src/security/tutorial004_an_py39.py!}
+{!> ../../docs_src/security/tutorial004_an_py39.py!}
```
////
@@ -133,7 +133,7 @@ PassLib 上下文还支持使用不同哈希算法的功能，包括只能校验
//// tab | Python 3.8+
```Python hl_lines="8 50 57-58 61-62 71-77"
-{!> ../../../docs_src/security/tutorial004_an.py!}
+{!> ../../docs_src/security/tutorial004_an.py!}
```
////
@@ -147,7 +147,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="7 48 55-56 59-60 69-75"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -161,7 +161,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="8 49 56-57 60-61 70-76"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
@@ -201,7 +201,7 @@ $ openssl rand -hex 32
创建生成新的访问令牌的工具函数。
```Python hl_lines="6 12-14 28-30 78-86"
-{!../../../docs_src/security/tutorial004.py!}
+{!../../docs_src/security/tutorial004.py!}
```
## 更新依赖项
@@ -215,7 +215,7 @@ $ openssl rand -hex 32
//// tab | Python 3.10+
```Python hl_lines="4 7 13-15 29-31 79-87"
-{!> ../../../docs_src/security/tutorial004_an_py310.py!}
+{!> ../../docs_src/security/tutorial004_an_py310.py!}
```
////
@@ -223,7 +223,7 @@ $ openssl rand -hex 32
//// tab | Python 3.9+
```Python hl_lines="4 7 13-15 29-31 79-87"
-{!> ../../../docs_src/security/tutorial004_an_py39.py!}
+{!> ../../docs_src/security/tutorial004_an_py39.py!}
```
////
@@ -231,7 +231,7 @@ $ openssl rand -hex 32
//// tab | Python 3.8+
```Python hl_lines="4 7 14-16 30-32 80-88"
-{!> ../../../docs_src/security/tutorial004_an.py!}
+{!> ../../docs_src/security/tutorial004_an.py!}
```
////
@@ -245,7 +245,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="3 6 12-14 28-30 78-86"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -259,7 +259,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="4 7 13-15 29-31 79-87"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
@@ -273,7 +273,7 @@ Prefer to use the `Annotated` version if possible.
//// tab | Python 3.10+
```Python hl_lines="118-133"
-{!> ../../../docs_src/security/tutorial004_an_py310.py!}
+{!> ../../docs_src/security/tutorial004_an_py310.py!}
```
////
@@ -281,7 +281,7 @@ Prefer to use the `Annotated` version if possible.
//// tab | Python 3.9+
```Python hl_lines="118-133"
-{!> ../../../docs_src/security/tutorial004_an_py39.py!}
+{!> ../../docs_src/security/tutorial004_an_py39.py!}
```
////
@@ -289,7 +289,7 @@ Prefer to use the `Annotated` version if possible.
//// tab | Python 3.8+
```Python hl_lines="119-134"
-{!> ../../../docs_src/security/tutorial004_an.py!}
+{!> ../../docs_src/security/tutorial004_an.py!}
```
////
@@ -303,7 +303,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="115-130"
-{!> ../../../docs_src/security/tutorial004_py310.py!}
+{!> ../../docs_src/security/tutorial004_py310.py!}
```
////
@@ -317,7 +317,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python hl_lines="116-131"
-{!> ../../../docs_src/security/tutorial004.py!}
+{!> ../../docs_src/security/tutorial004.py!}
```
////
diff --git a/docs/zh/docs/tutorial/security/simple-oauth2.md b/docs/zh/docs/tutorial/security/simple-oauth2.md
index 261421dad..1f031a6b2 100644
--- a/docs/zh/docs/tutorial/security/simple-oauth2.md
+++ b/docs/zh/docs/tutorial/security/simple-oauth2.md
@@ -53,7 +53,7 @@ OAuth2 中，**作用域**只是声明指定权限的字符串。
首先，导入 `OAuth2PasswordRequestForm`，然后，在 `/token` *路径操作* 中，用 `Depends` 把该类作为依赖项。
```Python hl_lines="4 76"
-{!../../../docs_src/security/tutorial003.py!}
+{!../../docs_src/security/tutorial003.py!}
```
`OAuth2PasswordRequestForm` 是用以下几项内容声明表单请求体的类依赖项：
@@ -103,7 +103,7 @@ OAuth2 中，**作用域**只是声明指定权限的字符串。
本例使用 `HTTPException` 异常显示此错误：
```Python hl_lines="3 77-79"
-{!../../../docs_src/security/tutorial003.py!}
+{!../../docs_src/security/tutorial003.py!}
```
### 校验密码
@@ -131,7 +131,7 @@ OAuth2 中，**作用域**只是声明指定权限的字符串。
这样一来，窃贼就无法在其它应用中使用窃取的密码，要知道，很多用户在所有系统中都使用相同的密码，风险超大。
```Python hl_lines="80-83"
-{!../../../docs_src/security/tutorial003.py!}
+{!../../docs_src/security/tutorial003.py!}
```
#### 关于 `**user_dict`
@@ -175,7 +175,7 @@ UserInDB(
///
```Python hl_lines="85"
-{!../../../docs_src/security/tutorial003.py!}
+{!../../docs_src/security/tutorial003.py!}
```
/// tip | "提示"
@@ -203,7 +203,7 @@ UserInDB(
因此，在端点中，只有当用户存在、通过身份验证、且状态为激活时，才能获得该用户：
```Python hl_lines="58-67 69-72 90"
-{!../../../docs_src/security/tutorial003.py!}
+{!../../docs_src/security/tutorial003.py!}
```
/// info | "说明"
diff --git a/docs/zh/docs/tutorial/sql-databases.md b/docs/zh/docs/tutorial/sql-databases.md
index 45ec71f7c..379c44143 100644
--- a/docs/zh/docs/tutorial/sql-databases.md
+++ b/docs/zh/docs/tutorial/sql-databases.md
@@ -118,13 +118,13 @@ $ pip install sqlalchemy
### 导入 SQLAlchemy 部件
```Python hl_lines="1-3"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
### 为 SQLAlchemy 定义数据库 URL地址
```Python hl_lines="5-6"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
在这个例子中，我们正在“连接”到一个 SQLite 数据库（用 SQLite 数据库打开一个文件）。
@@ -154,7 +154,7 @@ SQLALCHEMY_DATABASE_URL = "postgresql://user:password@postgresserver/db"
我们稍后会将这个`engine`在其他地方使用。
```Python hl_lines="8-10"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
#### 注意
@@ -192,7 +192,7 @@ connect_args={"check_same_thread": False}
要创建`SessionLocal`类，请使用函数`sessionmaker`：
```Python hl_lines="11"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
### 创建一个`Base`类
@@ -202,7 +202,7 @@ connect_args={"check_same_thread": False}
稍后我们将继承这个类，来创建每个数据库模型或类（ORM 模型）：
```Python hl_lines="13"
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
## 创建数据库模型
@@ -228,7 +228,7 @@ SQLAlchemy 使用的“**模型**”这个术语 来指代与数据库交互的
这些类就是 SQLAlchemy 模型。
```Python hl_lines="4 7-8 18-19"
-{!../../../docs_src/sql_databases/sql_app/models.py!}
+{!../../docs_src/sql_databases/sql_app/models.py!}
```
这个`__tablename__`属性是用来告诉 SQLAlchemy 要在数据库中为每个模型使用的数据库表的名称。
@@ -244,7 +244,7 @@ SQLAlchemy 使用的“**模型**”这个术语 来指代与数据库交互的
我们传递一个 SQLAlchemy “类型”，如`Integer`、`String`和`Boolean`，它定义了数据库中的类型，作为参数。
```Python hl_lines="1 10-13 21-24"
-{!../../../docs_src/sql_databases/sql_app/models.py!}
+{!../../docs_src/sql_databases/sql_app/models.py!}
```
### 创建关系
@@ -256,7 +256,7 @@ SQLAlchemy 使用的“**模型**”这个术语 来指代与数据库交互的
这将或多或少会成为一种“神奇”属性，其中表示该表与其他相关的表中的值。
```Python hl_lines="2 15 26"
-{!../../../docs_src/sql_databases/sql_app/models.py!}
+{!../../docs_src/sql_databases/sql_app/models.py!}
```
当访问 user 中的属性`items`时，如 中`my_user.items`，它将有一个`Item`SQLAlchemy 模型列表（来自`items`表），这些模型具有指向`users`表中此记录的外键。
@@ -292,7 +292,7 @@ SQLAlchemy 使用的“**模型**”这个术语 来指代与数据库交互的
//// tab | Python 3.10+
```Python hl_lines="1 4-6 9-10 21-22 25-26"
-{!> ../../../docs_src/sql_databases/sql_app_py310/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
```
////
@@ -300,7 +300,7 @@ SQLAlchemy 使用的“**模型**”这个术语 来指代与数据库交互的
//// tab | Python 3.9+
```Python hl_lines="3 6-8 11-12 23-24 27-28"
-{!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
```
////
@@ -308,7 +308,7 @@ SQLAlchemy 使用的“**模型**”这个术语 来指代与数据库交互的
//// tab | Python 3.8+
```Python hl_lines="3 6-8 11-12 23-24 27-28"
-{!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
```
////
@@ -342,7 +342,7 @@ name: str
//// tab | Python 3.10+
```Python hl_lines="13-15 29-32"
-{!> ../../../docs_src/sql_databases/sql_app_py310/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
```
////
@@ -350,7 +350,7 @@ name: str
//// tab | Python 3.9+
```Python hl_lines="15-17 31-34"
-{!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
```
////
@@ -358,7 +358,7 @@ name: str
//// tab | Python 3.8+
```Python hl_lines="15-17 31-34"
-{!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
```
////
@@ -380,7 +380,7 @@ name: str
//// tab | Python 3.10+
```Python hl_lines="13 17-18 29 34-35"
-{!> ../../../docs_src/sql_databases/sql_app_py310/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
```
////
@@ -388,7 +388,7 @@ name: str
//// tab | Python 3.9+
```Python hl_lines="15 19-20 31 36-37"
-{!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
```
////
@@ -396,7 +396,7 @@ name: str
//// tab | Python 3.8+
```Python hl_lines="15 19-20 31 36-37"
-{!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
```
////
@@ -474,7 +474,7 @@ current_user.items
* 查询多个项目。
```Python hl_lines="1 3 6-7 10-11 14-15 27-28"
-{!../../../docs_src/sql_databases/sql_app/crud.py!}
+{!../../docs_src/sql_databases/sql_app/crud.py!}
```
/// tip
@@ -495,7 +495,7 @@ current_user.items
* 使用`refresh`来刷新您的实例对象（以便它包含来自数据库的任何新数据，例如生成的 ID）。
```Python hl_lines="18-24 31-36"
-{!../../../docs_src/sql_databases/sql_app/crud.py!}
+{!../../docs_src/sql_databases/sql_app/crud.py!}
```
/// tip
@@ -547,7 +547,7 @@ SQLAlchemy 模型`User`包含一个`hashed_password`，它应该是一个包含
//// tab | Python 3.9+
```Python hl_lines="7"
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -555,7 +555,7 @@ SQLAlchemy 模型`User`包含一个`hashed_password`，它应该是一个包含
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -585,7 +585,7 @@ SQLAlchemy 模型`User`包含一个`hashed_password`，它应该是一个包含
//// tab | Python 3.9+
```Python hl_lines="13-18"
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -593,7 +593,7 @@ SQLAlchemy 模型`User`包含一个`hashed_password`，它应该是一个包含
//// tab | Python 3.8+
```Python hl_lines="15-20"
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -617,7 +617,7 @@ SQLAlchemy 模型`User`包含一个`hashed_password`，它应该是一个包含
//// tab | Python 3.9+
```Python hl_lines="22 30 36 45 51"
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -625,7 +625,7 @@ SQLAlchemy 模型`User`包含一个`hashed_password`，它应该是一个包含
//// tab | Python 3.8+
```Python hl_lines="24 32 38 47 53"
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -645,7 +645,7 @@ SQLAlchemy 模型`User`包含一个`hashed_password`，它应该是一个包含
//// tab | Python 3.9+
```Python hl_lines="21-26 29-32 35-40 43-47 50-53"
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -653,7 +653,7 @@ SQLAlchemy 模型`User`包含一个`hashed_password`，它应该是一个包含
//// tab | Python 3.8+
```Python hl_lines="23-28 31-34 37-42 45-49 52-55"
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -740,13 +740,13 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
* `sql_app/database.py`：
```Python
-{!../../../docs_src/sql_databases/sql_app/database.py!}
+{!../../docs_src/sql_databases/sql_app/database.py!}
```
* `sql_app/models.py`:
```Python
-{!../../../docs_src/sql_databases/sql_app/models.py!}
+{!../../docs_src/sql_databases/sql_app/models.py!}
```
* `sql_app/schemas.py`:
@@ -754,7 +754,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
//// tab | Python 3.10+
```Python
-{!> ../../../docs_src/sql_databases/sql_app_py310/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
```
////
@@ -762,7 +762,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
```
////
@@ -770,7 +770,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
```
////
@@ -778,7 +778,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
* `sql_app/crud.py`:
```Python
-{!../../../docs_src/sql_databases/sql_app/crud.py!}
+{!../../docs_src/sql_databases/sql_app/crud.py!}
```
* `sql_app/main.py`:
@@ -786,7 +786,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -794,7 +794,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -851,7 +851,7 @@ $ uvicorn sql_app.main:app --reload
//// tab | Python 3.9+
```Python hl_lines="12-20"
-{!> ../../../docs_src/sql_databases/sql_app_py39/alt_main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/alt_main.py!}
```
////
@@ -859,7 +859,7 @@ $ uvicorn sql_app.main:app --reload
//// tab | Python 3.8+
```Python hl_lines="14-22"
-{!> ../../../docs_src/sql_databases/sql_app/alt_main.py!}
+{!> ../../docs_src/sql_databases/sql_app/alt_main.py!}
```
////
diff --git a/docs/zh/docs/tutorial/static-files.md b/docs/zh/docs/tutorial/static-files.md
index 3d14f34d8..37e90ad43 100644
--- a/docs/zh/docs/tutorial/static-files.md
+++ b/docs/zh/docs/tutorial/static-files.md
@@ -8,7 +8,7 @@
* "挂载"(Mount) 一个 `StaticFiles()` 实例到一个指定路径。
```Python hl_lines="2 6"
-{!../../../docs_src/static_files/tutorial001.py!}
+{!../../docs_src/static_files/tutorial001.py!}
```
/// note | "技术细节"
diff --git a/docs/zh/docs/tutorial/testing.md b/docs/zh/docs/tutorial/testing.md
index 18c35e8c6..173e6f8a6 100644
--- a/docs/zh/docs/tutorial/testing.md
+++ b/docs/zh/docs/tutorial/testing.md
@@ -27,7 +27,7 @@
为你需要检查的地方用标准的Python表达式写个简单的 `assert` 语句（重申，标准的`pytest`）。
```Python hl_lines="2 12 15-18"
-{!../../../docs_src/app_testing/tutorial001.py!}
+{!../../docs_src/app_testing/tutorial001.py!}
```
/// tip | "提示"
@@ -75,7 +75,7 @@
```Python
-{!../../../docs_src/app_testing/main.py!}
+{!../../docs_src/app_testing/main.py!}
```
### 测试文件
@@ -93,7 +93,7 @@
因为这文件在同一个包中，所以你可以通过相对导入从 `main` 模块（`main.py`）导入`app`对象：
```Python hl_lines="3"
-{!../../../docs_src/app_testing/test_main.py!}
+{!../../docs_src/app_testing/test_main.py!}
```
...然后测试代码和之前一样的。
@@ -125,7 +125,7 @@
//// tab | Python 3.10+
```Python
-{!> ../../../docs_src/app_testing/app_b_an_py310/main.py!}
+{!> ../../docs_src/app_testing/app_b_an_py310/main.py!}
```
////
@@ -133,7 +133,7 @@
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/app_testing/app_b_an_py39/main.py!}
+{!> ../../docs_src/app_testing/app_b_an_py39/main.py!}
```
////
@@ -141,7 +141,7 @@
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/app_testing/app_b_an/main.py!}
+{!> ../../docs_src/app_testing/app_b_an/main.py!}
```
////
@@ -155,7 +155,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python
-{!> ../../../docs_src/app_testing/app_b_py310/main.py!}
+{!> ../../docs_src/app_testing/app_b_py310/main.py!}
```
////
@@ -169,7 +169,7 @@ Prefer to use the `Annotated` version if possible.
///
```Python
-{!> ../../../docs_src/app_testing/app_b/main.py!}
+{!> ../../docs_src/app_testing/app_b/main.py!}
```
////
@@ -179,7 +179,7 @@ Prefer to use the `Annotated` version if possible.
然后您可以使用扩展后的测试更新`test_main.py`：
```Python
-{!> ../../../docs_src/app_testing/app_b/test_main.py!}
+{!> ../../docs_src/app_testing/app_b/test_main.py!}
```
每当你需要客户端在请求中传递信息，但你不知道如何传递时，你可以通过搜索（谷歌）如何用 `httpx`做，或者是用 `requests` 做，毕竟HTTPX的设计是基于Requests的设计的。
From b36b7dfed06b3fe72847881ab035560f3394b9b7 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 6 Oct 2024 20:37:15 +0000
Subject: [PATCH 124/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2995aa8df..e438fb9dd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 🔧 Remove `base_path` for `mdx_include` Markdown extension in MkDocs. PR [#12391](https://github.com/fastapi/fastapi/pull/12391) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update link to Swagger UI configuration docs. PR [#12264](https://github.com/fastapi/fastapi/pull/12264) by [@makisukurisu](https://github.com/makisukurisu).
* 📝 Adding links for Playwright and Vite in `docs/project-generation.md`. PR [#12274](https://github.com/fastapi/fastapi/pull/12274) by [@kayqueGovetri](https://github.com/kayqueGovetri).
* 📝 Fix small typos in the documentation. PR [#12213](https://github.com/fastapi/fastapi/pull/12213) by [@svlandeg](https://github.com/svlandeg).
From e62960e32334ff0576c05a9c3b79908d0c497600 Mon Sep 17 00:00:00 2001
From: Rafael de Oliveira Marques <rafaelomarques@gmail.com>
Date: Mon, 7 Oct 2024 08:23:18 -0300
Subject: [PATCH 125/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/cookie-param-models.md`?=
=?UTF-8?q?=20(#12298)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/tutorial/cookie-param-models.md | 156 +++++++++++++++++++
1 file changed, 156 insertions(+)
create mode 100644 docs/pt/docs/tutorial/cookie-param-models.md
diff --git a/docs/pt/docs/tutorial/cookie-param-models.md b/docs/pt/docs/tutorial/cookie-param-models.md
new file mode 100644
index 000000000..12d7ee08c
--- /dev/null
+++ b/docs/pt/docs/tutorial/cookie-param-models.md
@@ -0,0 +1,156 @@
+# Modelos de Parâmetros de Cookie
+
+Se você possui um grupo de **cookies** que estão relacionados, você pode criar um **modelo Pydantic** para declará-los. 🍪
+
+Isso lhe permitiria **reutilizar o modelo** em **diversos lugares** e também declarar validações e metadata para todos os parâmetros de uma vez. 😎
+
+/// note | Nota
+
+Isso é suportado desde a versão `0.115.0` do FastAPI. 🤓
+
+///
+
+/// tip | Dica
+
+Essa mesma técnica se aplica para `Query`, `Cookie`, e `Header`. 😎
+
+///
+
+## Cookies com Modelos Pydantic
+
+Declare o parâmetro de **cookie** que você precisa em um **modelo Pydantic**, e depois declare o parâmetro como um `Cookie`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="9-12 16"
+{!> ../../../docs_src/cookie_param_models/tutorial001_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9-12 16"
+{!> ../../../docs_src/cookie_param_models/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="10-13 17"
+{!> ../../../docs_src/cookie_param_models/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="7-10 14"
+{!> ../../../docs_src/cookie_param_models/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="9-12 16"
+{!> ../../../docs_src/cookie_param_models/tutorial001.py!}
+```
+
+////
+
+O **FastAPI** irá **extrair** os dados para **cada campo** dos **cookies** recebidos na requisição e lhe fornecer o modelo Pydantic que você definiu.
+
+## Verifique os Documentos
+
+Você pode ver os cookies definidos na IU dos documentos em `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/cookie-param-models/image01.png">
+</div>
+
+/// info | Informação
+
+Tenha em mente que, como os **navegadores lidam com cookies** de maneira especial e por baixo dos panos, eles **não** permitem facilmente que o **JavaScript** lidem com eles.
+
+Se você for na **IU de documentos da API** em `/docs` você poderá ver a **documentação** para cookies das suas *operações de rotas*.
+
+Mas mesmo que você **adicionar os dados** e clicar em "Executar", pelo motivo da IU dos documentos trabalharem com **JavaScript**, os cookies não serão enviados, e você verá uma mensagem de **erro** como se você não tivesse escrito nenhum dado.
+
+///
+
+## Proibir Cookies Adicionais
+
+Em alguns casos especiais (provavelmente não muito comuns), você pode querer **restringir** os cookies que você deseja receber.
+
+Agora a sua API possui o poder de contrar o seu próprio <abbr title="Isso é uma brincadeira, só por precaução. Isso não tem nada a ver com consentimentos de cookies, mas é engraçado que até a API consegue rejeitar os coitados dos cookies. Coma um biscoito. 🍪">consentimento de cookie</abbr>. 🤪🍪
+
+
+ Você pode utilizar a configuração do modelo Pydantic para `proibir` qualquer campo `extra`.
+
+
+//// tab | Python 3.9+
+
+```Python hl_lines="10"
+{!> ../../../docs_src/cookie_param_models/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../../docs_src/cookie_param_models/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="10"
+{!> ../../../docs_src/cookie_param_models/tutorial002.py!}
+```
+
+////
+
+Se o cliente tentar enviar alguns **cookies extras**, eles receberão um retorno de **erro**.
+
+Coitados dos banners de cookies com todo o seu esforço para obter o seu consentimento para a <abbr title="Isso é uma outra piada. Não preste atenção em mim. Beba um café com o seu cookie. ☕">API rejeitá-lo</abbr>. 🍪
+
+Por exemplo, se o cliente tentar enviar um cookie `santa_tracker` com o valor de `good-list-please`, o cliente receberá uma resposta de **erro** informando que o <abbr title="O papai noel desaprova a falta de biscoitos. 🎅 Ok, chega de piadas com os cookies.">cookie `santa_tracker` is not allowed</abbr>:
+
+```json
+{
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["cookie", "santa_tracker"],
+ "msg": "Extra inputs are not permitted",
+ "input": "good-list-please",
+ }
+ ]
+}
+```
+
+## Resumo
+
+Você consegue utilizar **modelos Pydantic** para declarar <abbr title="Coma um último biscoito antes de você ir embora. 🍪">**cookies**</abbr> no **FastAPI**. 😎
From 3f8a527b502a52600df49460df50d0e083e9ef5a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 7 Oct 2024 11:23:42 +0000
Subject: [PATCH 126/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e438fb9dd..4c294c107 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -16,6 +16,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/cookie-param-models.md`. PR [#12298](https://github.com/fastapi/fastapi/pull/12298) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/graphql.md`. PR [#12215](https://github.com/fastapi/fastapi/pull/12215) by [@AnandaCampelo](https://github.com/AnandaCampelo).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/security/oauth2-scopes.md`. PR [#12263](https://github.com/fastapi/fastapi/pull/12263) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Add Portuguese translation for `docs/pt/docs/deployment/concepts.md`. PR [#12219](https://github.com/fastapi/fastapi/pull/12219) by [@marcelomarkus](https://github.com/marcelomarkus).
From e9c6408af7e23485426caf73877e85ea1362422d Mon Sep 17 00:00:00 2001
From: Balthazar Rouberol <br@imap.cc>
Date: Mon, 7 Oct 2024 13:31:55 +0200
Subject: [PATCH 127/504] =?UTF-8?q?=F0=9F=93=9D=20Add=20External=20Link:?=
=?UTF-8?q?=20How=20to=20profile=20a=20FastAPI=20asynchronous=20request=20?=
=?UTF-8?q?(#12389)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/data/external_links.yml | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/data/external_links.yml b/docs/en/data/external_links.yml
index 63fd3d0cf..dedbe87f4 100644
--- a/docs/en/data/external_links.yml
+++ b/docs/en/data/external_links.yml
@@ -1,5 +1,9 @@
Articles:
English:
+ - author: Balthazar Rouberol
+ author_link: https://balthazar-rouberol.com
+ link: https://blog.balthazar-rouberol.com/how-to-profile-a-fastapi-asynchronous-request
+ title: How to profile a FastAPI asynchronous request
- author: Stephen Siegert - Neon
link: https://neon.tech/blog/deploy-a-serverless-fastapi-app-with-neon-postgres-and-aws-app-runner-at-any-scale
title: Deploy a Serverless FastAPI App with Neon Postgres and AWS App Runner at any scale
From 31aec0967a1c4e877dc30c7ccdfb457d47c7fd36 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 7 Oct 2024 11:32:19 +0000
Subject: [PATCH 128/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4c294c107..490f99c70 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Add External Link: How to profile a FastAPI asynchronous request. PR [#12389](https://github.com/fastapi/fastapi/pull/12389) by [@brouberol](https://github.com/brouberol).
* 🔧 Remove `base_path` for `mdx_include` Markdown extension in MkDocs. PR [#12391](https://github.com/fastapi/fastapi/pull/12391) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update link to Swagger UI configuration docs. PR [#12264](https://github.com/fastapi/fastapi/pull/12264) by [@makisukurisu](https://github.com/makisukurisu).
* 📝 Adding links for Playwright and Vite in `docs/project-generation.md`. PR [#12274](https://github.com/fastapi/fastapi/pull/12274) by [@kayqueGovetri](https://github.com/kayqueGovetri).
From b45192c68a49876e5657c9fb7704e02d91c1633b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 7 Oct 2024 22:11:20 +0200
Subject: [PATCH 129/504] =?UTF-8?q?=F0=9F=91=B7=20Tweak=20labeler=20to=20n?=
=?UTF-8?q?ot=20override=20custom=20labels=20(#12398)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/workflows/labeler.yml | 2 ++
1 file changed, 2 insertions(+)
diff --git a/.github/workflows/labeler.yml b/.github/workflows/labeler.yml
index c3bb83f9a..e8e58015a 100644
--- a/.github/workflows/labeler.yml
+++ b/.github/workflows/labeler.yml
@@ -17,6 +17,8 @@ jobs:
runs-on: ubuntu-latest
steps:
- uses: actions/labeler@v5
+ if: ${{ github.event.action != 'labeled' && github.event.action != 'unlabeled' }}
+ - run: echo "Done adding labels"
# Run this after labeler applied labels
check-labels:
needs:
From e45b5d3589bbfdbe7953a8da3eae0829c74d6697 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 7 Oct 2024 20:11:42 +0000
Subject: [PATCH 130/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 490f99c70..26cba035b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -35,6 +35,7 @@ hide:
### Internal
+* 👷 Tweak labeler to not override custom labels. PR [#12398](https://github.com/fastapi/fastapi/pull/12398) by [@tiangolo](https://github.com/tiangolo).
* 👷 Update worfkow deploy-docs-notify URL. PR [#12392](https://github.com/fastapi/fastapi/pull/12392) by [@tiangolo](https://github.com/tiangolo).
* 👷 Update Cloudflare GitHub Action. PR [#12387](https://github.com/fastapi/fastapi/pull/12387) by [@tiangolo](https://github.com/tiangolo).
* ⬆ Bump pypa/gh-action-pypi-publish from 1.10.1 to 1.10.3. PR [#12386](https://github.com/fastapi/fastapi/pull/12386) by [@dependabot[bot]](https://github.com/apps/dependabot).
From 797cad7162592b6e581228bec09682da8feb6752 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 7 Oct 2024 22:18:07 +0200
Subject: [PATCH 131/504] =?UTF-8?q?=F0=9F=93=9D=20Fix=20extra=20mdx-base-p?=
=?UTF-8?q?ath=20paths=20(#12397)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/sql-databases.md | 48 ++++++++++----------
docs/it/docs/index.md | 3 --
docs/pt/docs/tutorial/cookie-param-models.md | 16 +++----
scripts/docs.py | 2 +-
4 files changed, 33 insertions(+), 36 deletions(-)
diff --git a/docs/en/docs/tutorial/sql-databases.md b/docs/en/docs/tutorial/sql-databases.md
index f65fa773c..7836efae1 100644
--- a/docs/en/docs/tutorial/sql-databases.md
+++ b/docs/en/docs/tutorial/sql-databases.md
@@ -296,7 +296,7 @@ But for security, the `password` won't be in other Pydantic *models*, for exampl
//// tab | Python 3.10+
```Python hl_lines="1 4-6 9-10 21-22 25-26"
-{!> ../../../docs_src/sql_databases/sql_app_py310/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
```
////
@@ -304,7 +304,7 @@ But for security, the `password` won't be in other Pydantic *models*, for exampl
//// tab | Python 3.9+
```Python hl_lines="3 6-8 11-12 23-24 27-28"
-{!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
```
////
@@ -312,7 +312,7 @@ But for security, the `password` won't be in other Pydantic *models*, for exampl
//// tab | Python 3.8+
```Python hl_lines="3 6-8 11-12 23-24 27-28"
-{!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
```
////
@@ -346,7 +346,7 @@ Not only the IDs of those items, but all the data that we defined in the Pydanti
//// tab | Python 3.10+
```Python hl_lines="13-15 29-32"
-{!> ../../../docs_src/sql_databases/sql_app_py310/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
```
////
@@ -354,7 +354,7 @@ Not only the IDs of those items, but all the data that we defined in the Pydanti
//// tab | Python 3.9+
```Python hl_lines="15-17 31-34"
-{!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
```
////
@@ -362,7 +362,7 @@ Not only the IDs of those items, but all the data that we defined in the Pydanti
//// tab | Python 3.8+
```Python hl_lines="15-17 31-34"
-{!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
```
////
@@ -384,7 +384,7 @@ In the `Config` class, set the attribute `orm_mode = True`.
//// tab | Python 3.10+
```Python hl_lines="13 17-18 29 34-35"
-{!> ../../../docs_src/sql_databases/sql_app_py310/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
```
////
@@ -392,7 +392,7 @@ In the `Config` class, set the attribute `orm_mode = True`.
//// tab | Python 3.9+
```Python hl_lines="15 19-20 31 36-37"
-{!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
```
////
@@ -400,7 +400,7 @@ In the `Config` class, set the attribute `orm_mode = True`.
//// tab | Python 3.8+
```Python hl_lines="15 19-20 31 36-37"
-{!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
```
////
@@ -559,7 +559,7 @@ In a very simplistic way create the database tables:
//// tab | Python 3.9+
```Python hl_lines="7"
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -567,7 +567,7 @@ In a very simplistic way create the database tables:
//// tab | Python 3.8+
```Python hl_lines="9"
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -597,7 +597,7 @@ Our dependency will create a new SQLAlchemy `SessionLocal` that will be used in
//// tab | Python 3.9+
```Python hl_lines="13-18"
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -605,7 +605,7 @@ Our dependency will create a new SQLAlchemy `SessionLocal` that will be used in
//// tab | Python 3.8+
```Python hl_lines="15-20"
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -629,7 +629,7 @@ This will then give us better editor support inside the *path operation function
//// tab | Python 3.9+
```Python hl_lines="22 30 36 45 51"
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -637,7 +637,7 @@ This will then give us better editor support inside the *path operation function
//// tab | Python 3.8+
```Python hl_lines="24 32 38 47 53"
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -657,7 +657,7 @@ Now, finally, here's the standard **FastAPI** *path operations* code.
//// tab | Python 3.9+
```Python hl_lines="21-26 29-32 35-40 43-47 50-53"
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -665,7 +665,7 @@ Now, finally, here's the standard **FastAPI** *path operations* code.
//// tab | Python 3.8+
```Python hl_lines="23-28 31-34 37-42 45-49 52-55"
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -766,7 +766,7 @@ For example, in a background task worker with <a href="https://docs.celeryq.dev"
//// tab | Python 3.10+
```Python
-{!> ../../../docs_src/sql_databases/sql_app_py310/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
```
////
@@ -774,7 +774,7 @@ For example, in a background task worker with <a href="https://docs.celeryq.dev"
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
```
////
@@ -782,7 +782,7 @@ For example, in a background task worker with <a href="https://docs.celeryq.dev"
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
+{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
```
////
@@ -798,7 +798,7 @@ For example, in a background task worker with <a href="https://docs.celeryq.dev"
//// tab | Python 3.9+
```Python
-{!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
```
////
@@ -806,7 +806,7 @@ For example, in a background task worker with <a href="https://docs.celeryq.dev"
//// tab | Python 3.8+
```Python
-{!> ../../../docs_src/sql_databases/sql_app/main.py!}
+{!> ../../docs_src/sql_databases/sql_app/main.py!}
```
////
@@ -863,7 +863,7 @@ The middleware we'll add (just a function) will create a new SQLAlchemy `Session
//// tab | Python 3.9+
```Python hl_lines="12-20"
-{!> ../../../docs_src/sql_databases/sql_app_py39/alt_main.py!}
+{!> ../../docs_src/sql_databases/sql_app_py39/alt_main.py!}
```
////
@@ -871,7 +871,7 @@ The middleware we'll add (just a function) will create a new SQLAlchemy `Session
//// tab | Python 3.8+
```Python hl_lines="14-22"
-{!> ../../../docs_src/sql_databases/sql_app/alt_main.py!}
+{!> ../../docs_src/sql_databases/sql_app/alt_main.py!}
```
////
diff --git a/docs/it/docs/index.md b/docs/it/docs/index.md
index 57940f0ed..3bfff82f1 100644
--- a/docs/it/docs/index.md
+++ b/docs/it/docs/index.md
@@ -1,6 +1,3 @@
-{!../../../docs/missing-translation.md!}
-
-
<p align="center">
<a href="https://fastapi.tiangolo.com"><img src="https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png" alt="FastAPI"></a>
</p>
diff --git a/docs/pt/docs/tutorial/cookie-param-models.md b/docs/pt/docs/tutorial/cookie-param-models.md
index 12d7ee08c..671e0d74f 100644
--- a/docs/pt/docs/tutorial/cookie-param-models.md
+++ b/docs/pt/docs/tutorial/cookie-param-models.md
@@ -23,7 +23,7 @@ Declare o parâmetro de **cookie** que você precisa em um **modelo Pydantic**,
//// tab | Python 3.10+
```Python hl_lines="9-12 16"
-{!> ../../../docs_src/cookie_param_models/tutorial001_an_py310.py!}
+{!> ../../docs_src/cookie_param_models/tutorial001_an_py310.py!}
```
////
@@ -31,7 +31,7 @@ Declare o parâmetro de **cookie** que você precisa em um **modelo Pydantic**,
//// tab | Python 3.9+
```Python hl_lines="9-12 16"
-{!> ../../../docs_src/cookie_param_models/tutorial001_an_py39.py!}
+{!> ../../docs_src/cookie_param_models/tutorial001_an_py39.py!}
```
////
@@ -39,7 +39,7 @@ Declare o parâmetro de **cookie** que você precisa em um **modelo Pydantic**,
//// tab | Python 3.8+
```Python hl_lines="10-13 17"
-{!> ../../../docs_src/cookie_param_models/tutorial001_an.py!}
+{!> ../../docs_src/cookie_param_models/tutorial001_an.py!}
```
////
@@ -53,7 +53,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="7-10 14"
-{!> ../../../docs_src/cookie_param_models/tutorial001_py310.py!}
+{!> ../../docs_src/cookie_param_models/tutorial001_py310.py!}
```
////
@@ -67,7 +67,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="9-12 16"
-{!> ../../../docs_src/cookie_param_models/tutorial001.py!}
+{!> ../../docs_src/cookie_param_models/tutorial001.py!}
```
////
@@ -105,7 +105,7 @@ Agora a sua API possui o poder de contrar o seu próprio <abbr title="Isso é um
//// tab | Python 3.9+
```Python hl_lines="10"
-{!> ../../../docs_src/cookie_param_models/tutorial002_an_py39.py!}
+{!> ../../docs_src/cookie_param_models/tutorial002_an_py39.py!}
```
////
@@ -113,7 +113,7 @@ Agora a sua API possui o poder de contrar o seu próprio <abbr title="Isso é um
//// tab | Python 3.8+
```Python hl_lines="11"
-{!> ../../../docs_src/cookie_param_models/tutorial002_an.py!}
+{!> ../../docs_src/cookie_param_models/tutorial002_an.py!}
```
////
@@ -127,7 +127,7 @@ Prefira utilizar a versão `Annotated` se possível.
///
```Python hl_lines="10"
-{!> ../../../docs_src/cookie_param_models/tutorial002.py!}
+{!> ../../docs_src/cookie_param_models/tutorial002.py!}
```
////
diff --git a/scripts/docs.py b/scripts/docs.py
index f0c51f7a6..e5c423d58 100644
--- a/scripts/docs.py
+++ b/scripts/docs.py
@@ -23,7 +23,7 @@ app = typer.Typer()
mkdocs_name = "mkdocs.yml"
missing_translation_snippet = """
-{!../../../docs/missing-translation.md!}
+{!../../docs/missing-translation.md!}
"""
non_translated_sections = [
From ecc4133907df47830bab6f11607c981ec82091b2 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 7 Oct 2024 20:18:29 +0000
Subject: [PATCH 132/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 26cba035b..ab23184a1 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -35,6 +35,7 @@ hide:
### Internal
+* 📝 Fix extra mdx-base-path paths. PR [#12397](https://github.com/fastapi/fastapi/pull/12397) by [@tiangolo](https://github.com/tiangolo).
* 👷 Tweak labeler to not override custom labels. PR [#12398](https://github.com/fastapi/fastapi/pull/12398) by [@tiangolo](https://github.com/tiangolo).
* 👷 Update worfkow deploy-docs-notify URL. PR [#12392](https://github.com/fastapi/fastapi/pull/12392) by [@tiangolo](https://github.com/tiangolo).
* 👷 Update Cloudflare GitHub Action. PR [#12387](https://github.com/fastapi/fastapi/pull/12387) by [@tiangolo](https://github.com/tiangolo).
From 95f167f0480f8df94c06c95cd19323534d123a2d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 7 Oct 2024 22:24:40 +0200
Subject: [PATCH 133/504] =?UTF-8?q?=E2=9E=95=20Add=20docs=20dependency:=20?=
=?UTF-8?q?markdown-include-variants=20(#12399)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/mkdocs.yml | 1 +
requirements-docs.txt | 1 +
2 files changed, 2 insertions(+)
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index a18af2022..e55c6f176 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -305,6 +305,7 @@ markdown_extensions:
# Other extensions
mdx_include:
+ markdown_include_variants:
extra:
analytics:
diff --git a/requirements-docs.txt b/requirements-docs.txt
index 16b2998b9..c05bd51e3 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -16,3 +16,4 @@ griffe-typingdoc==0.2.7
# For griffe, it formats with black
black==24.3.0
mkdocs-macros-plugin==1.0.5
+markdown-include-variants==0.0.1
From 6345147c245248302e90f0eb6371f7ab7557fd1b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 7 Oct 2024 20:25:03 +0000
Subject: [PATCH 134/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ab23184a1..b9dfe3da5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -35,6 +35,7 @@ hide:
### Internal
+* ➕ Add docs dependency: markdown-include-variants. PR [#12399](https://github.com/fastapi/fastapi/pull/12399) by [@tiangolo](https://github.com/tiangolo).
* 📝 Fix extra mdx-base-path paths. PR [#12397](https://github.com/fastapi/fastapi/pull/12397) by [@tiangolo](https://github.com/tiangolo).
* 👷 Tweak labeler to not override custom labels. PR [#12398](https://github.com/fastapi/fastapi/pull/12398) by [@tiangolo](https://github.com/tiangolo).
* 👷 Update worfkow deploy-docs-notify URL. PR [#12392](https://github.com/fastapi/fastapi/pull/12392) by [@tiangolo](https://github.com/tiangolo).
From 018e303fd9d04fe91a12cd39561d5bc5ca7b0aee Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 8 Oct 2024 10:37:32 +0200
Subject: [PATCH 135/504] =?UTF-8?q?=F0=9F=94=A7=20Add=20speakeasy-api=20to?=
=?UTF-8?q?=20`sponsors=5Fbadge.yml`=20(#12404)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/data/sponsors_badge.yml | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/data/sponsors_badge.yml b/docs/en/data/sponsors_badge.yml
index d8a41fbcb..d45028aaa 100644
--- a/docs/en/data/sponsors_badge.yml
+++ b/docs/en/data/sponsors_badge.yml
@@ -30,3 +30,4 @@ logins:
- svix
- zuplo-oss
- Kong
+ - speakeasy-api
From fcb15b4db162f2504d3f9f984d938e9a8ff03b35 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 8 Oct 2024 08:38:00 +0000
Subject: [PATCH 136/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b9dfe3da5..d785805e9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -35,6 +35,7 @@ hide:
### Internal
+* 🔧 Add speakeasy-api to `sponsors_badge.yml`. PR [#12404](https://github.com/fastapi/fastapi/pull/12404) by [@tiangolo](https://github.com/tiangolo).
* ➕ Add docs dependency: markdown-include-variants. PR [#12399](https://github.com/fastapi/fastapi/pull/12399) by [@tiangolo](https://github.com/tiangolo).
* 📝 Fix extra mdx-base-path paths. PR [#12397](https://github.com/fastapi/fastapi/pull/12397) by [@tiangolo](https://github.com/tiangolo).
* 👷 Tweak labeler to not override custom labels. PR [#12398](https://github.com/fastapi/fastapi/pull/12398) by [@tiangolo](https://github.com/tiangolo).
From 40490abaa3526eee394eb84362bfa4ca6b4da9d2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 8 Oct 2024 12:55:26 +0200
Subject: [PATCH 137/504] =?UTF-8?q?=E2=99=BB=EF=B8=8F=20Update=20type=20an?=
=?UTF-8?q?notations=20for=20improved=20`python-multipart`=20(#12407)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
fastapi/dependencies/utils.py | 6 +++---
requirements-docs-tests.txt | 2 ++
requirements-tests.txt | 1 -
3 files changed, 5 insertions(+), 4 deletions(-)
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 5cebbf00f..813c74620 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -91,14 +91,14 @@ multipart_incorrect_install_error = (
def ensure_multipart_is_installed() -> None:
try:
# __version__ is available in both multiparts, and can be mocked
- from multipart import __version__ # type: ignore
+ from multipart import __version__
assert __version__
try:
# parse_options_header is only available in the right multipart
- from multipart.multipart import parse_options_header # type: ignore
+ from multipart.multipart import parse_options_header
- assert parse_options_header
+ assert parse_options_header # type: ignore[truthy-function]
except ImportError:
logger.error(multipart_incorrect_install_error)
raise RuntimeError(multipart_incorrect_install_error) from None
diff --git a/requirements-docs-tests.txt b/requirements-docs-tests.txt
index b82df4933..40b956e51 100644
--- a/requirements-docs-tests.txt
+++ b/requirements-docs-tests.txt
@@ -1,2 +1,4 @@
# For mkdocstrings and tests
httpx >=0.23.0,<0.25.0
+# For linting and generating docs versions
+ruff ==0.6.4
diff --git a/requirements-tests.txt b/requirements-tests.txt
index 2f2576dd5..7b1f7ea1a 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -3,7 +3,6 @@
pytest >=7.1.3,<8.0.0
coverage[toml] >= 6.5.0,< 8.0
mypy ==1.8.0
-ruff ==0.6.4
dirty-equals ==0.6.0
# TODO: once removing databases from tutorial, upgrade SQLAlchemy
# probably when including SQLModel
From a94d61b2c09c7ba5bc2bf5016e590e2b0a35189e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 8 Oct 2024 10:55:50 +0000
Subject: [PATCH 138/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d785805e9..16faa52f9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Refactors
+
+* ♻️ Update type annotations for improved `python-multipart`. PR [#12407](https://github.com/fastapi/fastapi/pull/12407) by [@tiangolo](https://github.com/tiangolo).
+
### Docs
* 📝 Add External Link: How to profile a FastAPI asynchronous request. PR [#12389](https://github.com/fastapi/fastapi/pull/12389) by [@brouberol](https://github.com/brouberol).
From c6dfdb85239d32eb0f9825b1374f780b33eb8a7e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 8 Oct 2024 13:01:17 +0200
Subject: [PATCH 139/504] =?UTF-8?q?=F0=9F=94=A8=20Add=20script=20to=20gene?=
=?UTF-8?q?rate=20variants=20of=20files=20(#12405)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
scripts/docs.py | 37 +++++++++++++++++++++++++++++++++++++
1 file changed, 37 insertions(+)
diff --git a/scripts/docs.py b/scripts/docs.py
index e5c423d58..f26f96d85 100644
--- a/scripts/docs.py
+++ b/scripts/docs.py
@@ -15,6 +15,7 @@ import mkdocs.utils
import typer
import yaml
from jinja2 import Template
+from ruff.__main__ import find_ruff_bin
logging.basicConfig(level=logging.INFO)
@@ -382,5 +383,41 @@ def langs_json():
print(json.dumps(langs))
+@app.command()
+def generate_docs_src_versions_for_file(file_path: Path) -> None:
+ target_versions = ["py39", "py310"]
+ base_content = file_path.read_text(encoding="utf-8")
+ previous_content = {base_content}
+ for target_version in target_versions:
+ version_result = subprocess.run(
+ [
+ find_ruff_bin(),
+ "check",
+ "--target-version",
+ target_version,
+ "--fix",
+ "--unsafe-fixes",
+ "-",
+ ],
+ input=base_content.encode("utf-8"),
+ capture_output=True,
+ )
+ content_target = version_result.stdout.decode("utf-8")
+ format_result = subprocess.run(
+ [find_ruff_bin(), "format", "-"],
+ input=content_target.encode("utf-8"),
+ capture_output=True,
+ )
+ content_format = format_result.stdout.decode("utf-8")
+ if content_format in previous_content:
+ continue
+ previous_content.add(content_format)
+ version_file = file_path.with_name(
+ file_path.name.replace(".py", f"_{target_version}.py")
+ )
+ logging.info(f"Writing to {version_file}")
+ version_file.write_text(content_format, encoding="utf-8")
+
+
if __name__ == "__main__":
app()
From 13a18f80b3b0c7f0272c67b6ac7b73aafbb8584c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 8 Oct 2024 11:01:43 +0000
Subject: [PATCH 140/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 16faa52f9..e34fd0df9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -39,6 +39,7 @@ hide:
### Internal
+* 🔨 Add script to generate variants of files. PR [#12405](https://github.com/fastapi/fastapi/pull/12405) by [@tiangolo](https://github.com/tiangolo).
* 🔧 Add speakeasy-api to `sponsors_badge.yml`. PR [#12404](https://github.com/fastapi/fastapi/pull/12404) by [@tiangolo](https://github.com/tiangolo).
* ➕ Add docs dependency: markdown-include-variants. PR [#12399](https://github.com/fastapi/fastapi/pull/12399) by [@tiangolo](https://github.com/tiangolo).
* 📝 Fix extra mdx-base-path paths. PR [#12397](https://github.com/fastapi/fastapi/pull/12397) by [@tiangolo](https://github.com/tiangolo).
From 7daaac2bc350e2907554a01eb7eb1286247e5832 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 9 Oct 2024 21:44:42 +0200
Subject: [PATCH 141/504] =?UTF-8?q?=E2=9C=A8=20Add=20new=20tutorial=20for?=
=?UTF-8?q?=20SQL=20databases=20with=20SQLModel=20(#12285)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/em/docs/advanced/testing-database.md | 101 --
docs/em/docs/how-to/sql-databases-peewee.md | 576 ------------
docs/en/docs/advanced/testing-database.md | 111 ---
.../docs/how-to/async-sql-encode-databases.md | 201 ----
.../docs/how-to/nosql-databases-couchbase.md | 178 ----
docs/en/docs/how-to/sql-databases-peewee.md | 594 ------------
docs/en/docs/how-to/testing-database.md | 7 +
.../img/tutorial/sql-databases/image01.png | Bin 78949 -> 69755 bytes
.../img/tutorial/sql-databases/image02.png | Bin 83482 -> 69197 bytes
docs/en/docs/tutorial/sql-databases.md | 888 ++++--------------
docs/en/mkdocs.yml | 9 +-
docs/zh/docs/advanced/testing-database.md | 101 --
docs_src/async_sql_databases/tutorial001.py | 65 --
docs_src/nosql_databases/tutorial001.py | 53 --
docs_src/sql_databases/sql_app/__init__.py | 0
docs_src/sql_databases/sql_app/alt_main.py | 62 --
docs_src/sql_databases/sql_app/crud.py | 36 -
docs_src/sql_databases/sql_app/database.py | 13 -
docs_src/sql_databases/sql_app/main.py | 55 --
docs_src/sql_databases/sql_app/models.py | 26 -
docs_src/sql_databases/sql_app/schemas.py | 37 -
.../sql_databases/sql_app/tests/__init__.py | 0
.../sql_app/tests/test_sql_app.py | 50 -
.../sql_databases/sql_app_py310/__init__.py | 0
.../sql_databases/sql_app_py310/alt_main.py | 60 --
docs_src/sql_databases/sql_app_py310/crud.py | 36 -
.../sql_databases/sql_app_py310/database.py | 13 -
docs_src/sql_databases/sql_app_py310/main.py | 53 --
.../sql_databases/sql_app_py310/models.py | 26 -
.../sql_databases/sql_app_py310/schemas.py | 35 -
.../sql_app_py310/tests/__init__.py | 0
.../sql_app_py310/tests/test_sql_app.py | 47 -
.../sql_databases/sql_app_py39/__init__.py | 0
.../sql_databases/sql_app_py39/alt_main.py | 60 --
docs_src/sql_databases/sql_app_py39/crud.py | 36 -
.../sql_databases/sql_app_py39/database.py | 13 -
docs_src/sql_databases/sql_app_py39/main.py | 53 --
docs_src/sql_databases/sql_app_py39/models.py | 26 -
.../sql_databases/sql_app_py39/schemas.py | 37 -
.../sql_app_py39/tests/__init__.py | 0
.../sql_app_py39/tests/test_sql_app.py | 47 -
docs_src/sql_databases/tutorial001.py | 71 ++
docs_src/sql_databases/tutorial001_an.py | 74 ++
.../sql_databases/tutorial001_an_py310.py | 73 ++
docs_src/sql_databases/tutorial001_an_py39.py | 73 ++
docs_src/sql_databases/tutorial001_py310.py | 69 ++
docs_src/sql_databases/tutorial001_py39.py | 71 ++
docs_src/sql_databases/tutorial002.py | 104 ++
docs_src/sql_databases/tutorial002_an.py | 104 ++
.../sql_databases/tutorial002_an_py310.py | 103 ++
docs_src/sql_databases/tutorial002_an_py39.py | 103 ++
docs_src/sql_databases/tutorial002_py310.py | 102 ++
docs_src/sql_databases/tutorial002_py39.py | 104 ++
requirements-docs.txt | 2 +-
requirements-tests.txt | 5 +-
scripts/playwright/sql_databases/image01.py | 37 +
scripts/playwright/sql_databases/image02.py | 37 +
.../test_async_sql_databases/__init__.py | 0
.../test_tutorial001.py | 146 ---
.../test_sql_databases/test_sql_databases.py | 419 ---------
.../test_sql_databases_middleware.py | 421 ---------
.../test_sql_databases_middleware_py310.py | 433 ---------
.../test_sql_databases_middleware_py39.py | 433 ---------
.../test_sql_databases_py310.py | 432 ---------
.../test_sql_databases_py39.py | 432 ---------
.../test_testing_databases.py | 27 -
.../test_testing_databases_py310.py | 28 -
.../test_testing_databases_py39.py | 28 -
.../test_sql_databases/test_tutorial001.py | 373 ++++++++
.../test_sql_databases/test_tutorial002.py | 481 ++++++++++
70 files changed, 2154 insertions(+), 6336 deletions(-)
delete mode 100644 docs/em/docs/advanced/testing-database.md
delete mode 100644 docs/em/docs/how-to/sql-databases-peewee.md
delete mode 100644 docs/en/docs/advanced/testing-database.md
delete mode 100644 docs/en/docs/how-to/async-sql-encode-databases.md
delete mode 100644 docs/en/docs/how-to/nosql-databases-couchbase.md
delete mode 100644 docs/en/docs/how-to/sql-databases-peewee.md
create mode 100644 docs/en/docs/how-to/testing-database.md
delete mode 100644 docs/zh/docs/advanced/testing-database.md
delete mode 100644 docs_src/async_sql_databases/tutorial001.py
delete mode 100644 docs_src/nosql_databases/tutorial001.py
delete mode 100644 docs_src/sql_databases/sql_app/__init__.py
delete mode 100644 docs_src/sql_databases/sql_app/alt_main.py
delete mode 100644 docs_src/sql_databases/sql_app/crud.py
delete mode 100644 docs_src/sql_databases/sql_app/database.py
delete mode 100644 docs_src/sql_databases/sql_app/main.py
delete mode 100644 docs_src/sql_databases/sql_app/models.py
delete mode 100644 docs_src/sql_databases/sql_app/schemas.py
delete mode 100644 docs_src/sql_databases/sql_app/tests/__init__.py
delete mode 100644 docs_src/sql_databases/sql_app/tests/test_sql_app.py
delete mode 100644 docs_src/sql_databases/sql_app_py310/__init__.py
delete mode 100644 docs_src/sql_databases/sql_app_py310/alt_main.py
delete mode 100644 docs_src/sql_databases/sql_app_py310/crud.py
delete mode 100644 docs_src/sql_databases/sql_app_py310/database.py
delete mode 100644 docs_src/sql_databases/sql_app_py310/main.py
delete mode 100644 docs_src/sql_databases/sql_app_py310/models.py
delete mode 100644 docs_src/sql_databases/sql_app_py310/schemas.py
delete mode 100644 docs_src/sql_databases/sql_app_py310/tests/__init__.py
delete mode 100644 docs_src/sql_databases/sql_app_py310/tests/test_sql_app.py
delete mode 100644 docs_src/sql_databases/sql_app_py39/__init__.py
delete mode 100644 docs_src/sql_databases/sql_app_py39/alt_main.py
delete mode 100644 docs_src/sql_databases/sql_app_py39/crud.py
delete mode 100644 docs_src/sql_databases/sql_app_py39/database.py
delete mode 100644 docs_src/sql_databases/sql_app_py39/main.py
delete mode 100644 docs_src/sql_databases/sql_app_py39/models.py
delete mode 100644 docs_src/sql_databases/sql_app_py39/schemas.py
delete mode 100644 docs_src/sql_databases/sql_app_py39/tests/__init__.py
delete mode 100644 docs_src/sql_databases/sql_app_py39/tests/test_sql_app.py
create mode 100644 docs_src/sql_databases/tutorial001.py
create mode 100644 docs_src/sql_databases/tutorial001_an.py
create mode 100644 docs_src/sql_databases/tutorial001_an_py310.py
create mode 100644 docs_src/sql_databases/tutorial001_an_py39.py
create mode 100644 docs_src/sql_databases/tutorial001_py310.py
create mode 100644 docs_src/sql_databases/tutorial001_py39.py
create mode 100644 docs_src/sql_databases/tutorial002.py
create mode 100644 docs_src/sql_databases/tutorial002_an.py
create mode 100644 docs_src/sql_databases/tutorial002_an_py310.py
create mode 100644 docs_src/sql_databases/tutorial002_an_py39.py
create mode 100644 docs_src/sql_databases/tutorial002_py310.py
create mode 100644 docs_src/sql_databases/tutorial002_py39.py
create mode 100644 scripts/playwright/sql_databases/image01.py
create mode 100644 scripts/playwright/sql_databases/image02.py
delete mode 100644 tests/test_tutorial/test_async_sql_databases/__init__.py
delete mode 100644 tests/test_tutorial/test_async_sql_databases/test_tutorial001.py
delete mode 100644 tests/test_tutorial/test_sql_databases/test_sql_databases.py
delete mode 100644 tests/test_tutorial/test_sql_databases/test_sql_databases_middleware.py
delete mode 100644 tests/test_tutorial/test_sql_databases/test_sql_databases_middleware_py310.py
delete mode 100644 tests/test_tutorial/test_sql_databases/test_sql_databases_middleware_py39.py
delete mode 100644 tests/test_tutorial/test_sql_databases/test_sql_databases_py310.py
delete mode 100644 tests/test_tutorial/test_sql_databases/test_sql_databases_py39.py
delete mode 100644 tests/test_tutorial/test_sql_databases/test_testing_databases.py
delete mode 100644 tests/test_tutorial/test_sql_databases/test_testing_databases_py310.py
delete mode 100644 tests/test_tutorial/test_sql_databases/test_testing_databases_py39.py
create mode 100644 tests/test_tutorial/test_sql_databases/test_tutorial001.py
create mode 100644 tests/test_tutorial/test_sql_databases/test_tutorial002.py
diff --git a/docs/em/docs/advanced/testing-database.md b/docs/em/docs/advanced/testing-database.md
deleted file mode 100644
index 71b29f9b7..000000000
--- a/docs/em/docs/advanced/testing-database.md
+++ /dev/null
@@ -1,101 +0,0 @@
-# 🔬 💽
-
-👆 💪 ⚙️ 🎏 🔗 🔐 ⚪️➡️ [🔬 🔗 ⏮️ 🔐](testing-dependencies.md){.internal-link target=_blank} 📉 💽 🔬.
-
-👆 💪 💚 ⚒ 🆙 🎏 💽 🔬, 💾 💽 ⏮️ 💯, 🏤-🥧 ⚫️ ⏮️ 🔬 💽, ♒️.
-
-👑 💭 ⚫️❔ 🎏 👆 👀 👈 ⏮️ 📃.
-
-## 🚮 💯 🗄 📱
-
-➡️ ℹ 🖼 ⚪️➡️ [🗄 (🔗) 💽](../tutorial/sql-databases.md){.internal-link target=_blank} ⚙️ 🔬 💽.
-
-🌐 📱 📟 🎏, 👆 💪 🚶 🔙 👈 📃 ✅ ❔ ⚫️.
-
-🕴 🔀 📥 🆕 🔬 📁.
-
-👆 😐 🔗 `get_db()` 🔜 📨 💽 🎉.
-
-💯, 👆 💪 ⚙️ 🔗 🔐 📨 👆 *🛃* 💽 🎉 ↩️ 1️⃣ 👈 🔜 ⚙️ 🛎.
-
-👉 🖼 👥 🔜 ✍ 🍕 💽 🕴 💯.
-
-## 📁 📊
-
-👥 ✍ 🆕 📁 `sql_app/tests/test_sql_app.py`.
-
-🆕 📁 📊 👀 💖:
-
-``` hl_lines="9-11"
-.
-└── sql_app
- ├── __init__.py
- ├── crud.py
- ├── database.py
- ├── main.py
- ├── models.py
- ├── schemas.py
- └── tests
- ├── __init__.py
- └── test_sql_app.py
-```
-
-## ✍ 🆕 💽 🎉
-
-🥇, 👥 ✍ 🆕 💽 🎉 ⏮️ 🆕 💽.
-
-💯 👥 🔜 ⚙️ 📁 `test.db` ↩️ `sql_app.db`.
-
-✋️ 🎂 🎉 📟 🌅 ⚖️ 🌘 🎏, 👥 📁 ⚫️.
-
-```Python hl_lines="8-13"
-{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
-```
-
-/// tip
-
-👆 💪 📉 ❎ 👈 📟 🚮 ⚫️ 🔢 & ⚙️ ⚫️ ⚪️➡️ 👯♂️ `database.py` & `tests/test_sql_app.py`.
-
-🦁 & 🎯 🔛 🎯 🔬 📟, 👥 🖨 ⚫️.
-
-///
-
-## ✍ 💽
-
-↩️ 🔜 👥 🔜 ⚙️ 🆕 💽 🆕 📁, 👥 💪 ⚒ 💭 👥 ✍ 💽 ⏮️:
-
-```Python
-Base.metadata.create_all(bind=engine)
-```
-
-👈 🛎 🤙 `main.py`, ✋️ ⏸ `main.py` ⚙️ 💽 📁 `sql_app.db`, & 👥 💪 ⚒ 💭 👥 ✍ `test.db` 💯.
-
-👥 🚮 👈 ⏸ 📥, ⏮️ 🆕 📁.
-
-```Python hl_lines="16"
-{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
-```
-
-## 🔗 🔐
-
-🔜 👥 ✍ 🔗 🔐 & 🚮 ⚫️ 🔐 👆 📱.
-
-```Python hl_lines="19-24 27"
-{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
-```
-
-/// tip
-
-📟 `override_get_db()` 🌖 ⚫️❔ 🎏 `get_db()`, ✋️ `override_get_db()` 👥 ⚙️ `TestingSessionLocal` 🔬 💽 ↩️.
-
-///
-
-## 💯 📱
-
-⤴️ 👥 💪 💯 📱 🛎.
-
-```Python hl_lines="32-47"
-{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
-```
-
-& 🌐 🛠️ 👥 ⚒ 💽 ⏮️ 💯 🔜 `test.db` 💽 ↩️ 👑 `sql_app.db`.
diff --git a/docs/em/docs/how-to/sql-databases-peewee.md b/docs/em/docs/how-to/sql-databases-peewee.md
deleted file mode 100644
index d25b77894..000000000
--- a/docs/em/docs/how-to/sql-databases-peewee.md
+++ /dev/null
@@ -1,576 +0,0 @@
-# 🗄 (🔗) 💽 ⏮️ 🏒
-
-/// warning
-
-🚥 👆 ▶️, 🔰 [🗄 (🔗) 💽](../tutorial/sql-databases.md){.internal-link target=_blank} 👈 ⚙️ 🇸🇲 🔜 🥃.
-
-💭 🆓 🚶 👉.
-
-///
-
-🚥 👆 ▶️ 🏗 ⚪️➡️ 🖌, 👆 🎲 👻 📆 ⏮️ 🇸🇲 🐜 ([🗄 (🔗) 💽](../tutorial/sql-databases.md){.internal-link target=_blank}), ⚖️ 🙆 🎏 🔁 🐜.
-
-🚥 👆 ⏪ ✔️ 📟 🧢 👈 ⚙️ <a href="https://docs.peewee-orm.com/en/latest/" class="external-link" target="_blank">🏒 🐜</a>, 👆 💪 ✅ 📥 ❔ ⚙️ ⚫️ ⏮️ **FastAPI**.
-
-/// warning | "🐍 3️⃣.7️⃣ ➕ ✔"
-
-👆 🔜 💪 🐍 3️⃣.7️⃣ ⚖️ 🔛 🔒 ⚙️ 🏒 ⏮️ FastAPI.
-
-///
-
-## 🏒 🔁
-
-🏒 🚫 🔧 🔁 🛠️, ⚖️ ⏮️ 👫 🤯.
-
-🏒 ✔️ 🏋️ 🔑 🔃 🚮 🔢 & 🔃 ❔ ⚫️ 🔜 ⚙️.
-
-🚥 👆 🛠️ 🈸 ⏮️ 🗝 🚫-🔁 🛠️, & 💪 👷 ⏮️ 🌐 🚮 🔢, **⚫️ 💪 👑 🧰**.
-
-✋️ 🚥 👆 💪 🔀 🔢, 🐕🦺 🌖 🌘 1️⃣ 🔁 💽, 👷 ⏮️ 🔁 🛠️ (💖 FastAPI), ♒️, 👆 🔜 💪 🚮 🏗 ➕ 📟 🔐 👈 🔢.
-
-👐, ⚫️ 💪 ⚫️, & 📥 👆 🔜 👀 ⚫️❔ ⚫️❔ 📟 👆 ✔️ 🚮 💪 ⚙️ 🏒 ⏮️ FastAPI.
-
-/// note | "📡 ℹ"
-
-👆 💪 ✍ 🌅 🔃 🏒 🧍 🔃 🔁 🐍 <a href="https://docs.peewee-orm.com/en/latest/peewee/database.html#async-with-gevent" class="external-link" target="_blank">🩺</a>, <a href="https://github.com/coleifer/peewee/issues/263#issuecomment-517347032" class="external-link" target="_blank">❔</a>, <a href="https://github.com/coleifer/peewee/pull/2072#issuecomment-563215132" class="external-link" target="_blank">🇵🇷</a>.
-
-///
-
-## 🎏 📱
-
-👥 🔜 ✍ 🎏 🈸 🇸🇲 🔰 ([🗄 (🔗) 💽](../tutorial/sql-databases.md){.internal-link target=_blank}).
-
-🌅 📟 🤙 🎏.
-
-, 👥 🔜 🎯 🕴 🔛 🔺.
-
-## 📁 📊
-
-➡️ 💬 👆 ✔️ 📁 📛 `my_super_project` 👈 🔌 🎧-📁 🤙 `sql_app` ⏮️ 📊 💖 👉:
-
-```
-.
-└── sql_app
- ├── __init__.py
- ├── crud.py
- ├── database.py
- ├── main.py
- └── schemas.py
-```
-
-👉 🌖 🎏 📊 👥 ✔️ 🇸🇲 🔰.
-
-🔜 ➡️ 👀 ⚫️❔ 🔠 📁/🕹 🔨.
-
-## ✍ 🏒 🍕
-
-➡️ 🔗 📁 `sql_app/database.py`.
-
-### 🐩 🏒 📟
-
-➡️ 🥇 ✅ 🌐 😐 🏒 📟, ✍ 🏒 💽:
-
-```Python hl_lines="3 5 22"
-{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
-```
-
-/// tip
-
-✔️ 🤯 👈 🚥 👆 💚 ⚙️ 🎏 💽, 💖 ✳, 👆 🚫 🚫 🔀 🎻. 👆 🔜 💪 ⚙️ 🎏 🏒 💽 🎓.
-
-///
-
-#### 🗒
-
-❌:
-
-```Python
-check_same_thread=False
-```
-
-🌓 1️⃣ 🇸🇲 🔰:
-
-```Python
-connect_args={"check_same_thread": False}
-```
-
-...⚫️ 💪 🕴 `SQLite`.
-
-/// info | "📡 ℹ"
-
-⚫️❔ 🎏 📡 ℹ [🗄 (🔗) 💽](../tutorial/sql-databases.md#_7){.internal-link target=_blank} ✔.
-
-///
-
-### ⚒ 🏒 🔁-🔗 `PeeweeConnectionState`
-
-👑 ❔ ⏮️ 🏒 & FastAPI 👈 🏒 ⚓️ 🙇 🔛 <a href="https://docs.python.org/3/library/threading.html#thread-local-data" class="external-link" target="_blank">🐍 `threading.local`</a>, & ⚫️ 🚫 ✔️ 🎯 🌌 🔐 ⚫️ ⚖️ ➡️ 👆 🍵 🔗/🎉 🔗 (🔨 🇸🇲 🔰).
-
-& `threading.local` 🚫 🔗 ⏮️ 🆕 🔁 ⚒ 🏛 🐍.
-
-/// note | "📡 ℹ"
-
-`threading.local` ⚙️ ✔️ "🎱" 🔢 👈 ✔️ 🎏 💲 🔠 🧵.
-
-👉 ⚠ 🗝 🛠️ 🏗 ✔️ 1️⃣ 👁 🧵 📍 📨, 🙅♂ 🌖, 🙅♂ 🌘.
-
-⚙️ 👉, 🔠 📨 🔜 ✔️ 🚮 👍 💽 🔗/🎉, ❔ ☑ 🏁 🥅.
-
-✋️ FastAPI, ⚙️ 🆕 🔁 ⚒, 💪 🍵 🌅 🌘 1️⃣ 📨 🔛 🎏 🧵. & 🎏 🕰, 👁 📨, ⚫️ 💪 🏃 💗 👜 🎏 🧵 (🧵), ⚓️ 🔛 🚥 👆 ⚙️ `async def` ⚖️ 😐 `def`. 👉 ⚫️❔ 🤝 🌐 🎭 📈 FastAPI.
-
-///
-
-✋️ 🐍 3️⃣.7️⃣ & 🔛 🚚 🌖 🏧 🎛 `threading.local`, 👈 💪 ⚙️ 🥉 🌐❔ `threading.local` 🔜 ⚙️, ✋️ 🔗 ⏮️ 🆕 🔁 ⚒.
-
-👥 🔜 ⚙️ 👈. ⚫️ 🤙 <a href="https://docs.python.org/3/library/contextvars.html" class="external-link" target="_blank">`contextvars`</a>.
-
-👥 🔜 🔐 🔗 🍕 🏒 👈 ⚙️ `threading.local` & ❎ 👫 ⏮️ `contextvars`, ⏮️ 🔗 ℹ.
-
-👉 5️⃣📆 😑 🍖 🏗 (& ⚫️ 🤙), 👆 🚫 🤙 💪 🍕 🤔 ❔ ⚫️ 👷 ⚙️ ⚫️.
-
-👥 🔜 ✍ `PeeweeConnectionState`:
-
-```Python hl_lines="10-19"
-{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
-```
-
-👉 🎓 😖 ⚪️➡️ 🎁 🔗 🎓 ⚙️ 🏒.
-
-⚫️ ✔️ 🌐 ⚛ ⚒ 🏒 ⚙️ `contextvars` ↩️ `threading.local`.
-
-`contextvars` 👷 🍖 🎏 🌘 `threading.local`. ✋️ 🎂 🏒 🔗 📟 🤔 👈 👉 🎓 👷 ⏮️ `threading.local`.
-
-, 👥 💪 ➕ 🎱 ⚒ ⚫️ 👷 🚥 ⚫️ ⚙️ `threading.local`. `__init__`, `__setattr__`, & `__getattr__` 🛠️ 🌐 ✔ 🎱 👉 ⚙️ 🏒 🍵 🤔 👈 ⚫️ 🔜 🔗 ⏮️ FastAPI.
-
-/// tip
-
-👉 🔜 ⚒ 🏒 🎭 ☑ 🕐❔ ⚙️ ⏮️ FastAPI. 🚫 🎲 📂 ⚖️ 📪 🔗 👈 ➖ ⚙️, 🏗 ❌, ♒️.
-
-✋️ ⚫️ 🚫 🤝 🏒 🔁 💎-🏋️. 👆 🔜 ⚙️ 😐 `def` 🔢 & 🚫 `async def`.
-
-///
-
-### ⚙️ 🛃 `PeeweeConnectionState` 🎓
-
-🔜, 📁 `._state` 🔗 🔢 🏒 💽 `db` 🎚 ⚙️ 🆕 `PeeweeConnectionState`:
-
-```Python hl_lines="24"
-{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
-```
-
-/// tip
-
-⚒ 💭 👆 📁 `db._state` *⏮️* 🏗 `db`.
-
-///
-
-/// tip
-
-👆 🔜 🎏 🙆 🎏 🏒 💽, 🔌 `PostgresqlDatabase`, `MySQLDatabase`, ♒️.
-
-///
-
-## ✍ 💽 🏷
-
-➡️ 🔜 👀 📁 `sql_app/models.py`.
-
-### ✍ 🏒 🏷 👆 💽
-
-🔜 ✍ 🏒 🏷 (🎓) `User` & `Item`.
-
-👉 🎏 👆 🔜 🚥 👆 ⏩ 🏒 🔰 & ℹ 🏷 ✔️ 🎏 💽 🇸🇲 🔰.
-
-/// tip
-
-🏒 ⚙️ ⚖ "**🏷**" 🔗 👉 🎓 & 👐 👈 🔗 ⏮️ 💽.
-
-✋️ Pydantic ⚙️ ⚖ "**🏷**" 🔗 🕳 🎏, 💽 🔬, 🛠️, & 🧾 🎓 & 👐.
-
-///
-
-🗄 `db` ⚪️➡️ `database` (📁 `database.py` ⚪️➡️ 🔛) & ⚙️ ⚫️ 📥.
-
-```Python hl_lines="3 6-12 15-21"
-{!../../docs_src/sql_databases_peewee/sql_app/models.py!}
-```
-
-/// tip
-
-🏒 ✍ 📚 🎱 🔢.
-
-⚫️ 🔜 🔁 🚮 `id` 🔢 🔢 👑 🔑.
-
-⚫️ 🔜 ⚒ 📛 🏓 ⚓️ 🔛 🎓 📛.
-
- `Item`, ⚫️ 🔜 ✍ 🔢 `owner_id` ⏮️ 🔢 🆔 `User`. ✋️ 👥 🚫 📣 ⚫️ 🙆.
-
-///
-
-## ✍ Pydantic 🏷
-
-🔜 ➡️ ✅ 📁 `sql_app/schemas.py`.
-
-/// tip
-
-❎ 😨 🖖 🏒 *🏷* & Pydantic *🏷*, 👥 🔜 ✔️ 📁 `models.py` ⏮️ 🏒 🏷, & 📁 `schemas.py` ⏮️ Pydantic 🏷.
-
-👫 Pydantic 🏷 🔬 🌅 ⚖️ 🌘 "🔗" (☑ 📊 💠).
-
-👉 🔜 ℹ 👥 ❎ 😨 ⏪ ⚙️ 👯♂️.
-
-///
-
-### ✍ Pydantic *🏷* / 🔗
-
-✍ 🌐 🎏 Pydantic 🏷 🇸🇲 🔰:
-
-```Python hl_lines="16-18 21-22 25-30 34-35 38-39 42-48"
-{!../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
-```
-
-/// tip
-
-📥 👥 🏗 🏷 ⏮️ `id`.
-
-👥 🚫 🎯 ✔ `id` 🔢 🏒 🏷, ✋️ 🏒 🚮 1️⃣ 🔁.
-
-👥 ❎ 🎱 `owner_id` 🔢 `Item`.
-
-///
-
-### ✍ `PeeweeGetterDict` Pydantic *🏷* / 🔗
-
-🕐❔ 👆 🔐 💛 🏒 🎚, 💖 `some_user.items`, 🏒 🚫 🚚 `list` `Item`.
-
-⚫️ 🚚 🎁 🛃 🎚 🎓 `ModelSelect`.
-
-⚫️ 💪 ✍ `list` 🚮 🏬 ⏮️ `list(some_user.items)`.
-
-✋️ 🎚 ⚫️ 🚫 `list`. & ⚫️ 🚫 ☑ 🐍 <a href="https://docs.python.org/3/glossary.html#term-generator" class="external-link" target="_blank">🚂</a>. ↩️ 👉, Pydantic 🚫 💭 🔢 ❔ 🗜 ⚫️ `list` Pydantic *🏷* / 🔗.
-
-✋️ ⏮️ ⏬ Pydantic ✔ 🚚 🛃 🎓 👈 😖 ⚪️➡️ `pydantic.utils.GetterDict`, 🚚 🛠️ ⚙️ 🕐❔ ⚙️ `orm_mode = True` 🗃 💲 🐜 🏷 🔢.
-
-👥 🔜 ✍ 🛃 `PeeweeGetterDict` 🎓 & ⚙️ ⚫️ 🌐 🎏 Pydantic *🏷* / 🔗 👈 ⚙️ `orm_mode`:
-
-```Python hl_lines="3 8-13 31 49"
-{!../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
-```
-
-📥 👥 ✅ 🚥 🔢 👈 ➖ 🔐 (✅ `.items` `some_user.items`) 👐 `peewee.ModelSelect`.
-
-& 🚥 👈 💼, 📨 `list` ⏮️ ⚫️.
-
-& ⤴️ 👥 ⚙️ ⚫️ Pydantic *🏷* / 🔗 👈 ⚙️ `orm_mode = True`, ⏮️ 📳 🔢 `getter_dict = PeeweeGetterDict`.
-
-/// tip
-
-👥 🕴 💪 ✍ 1️⃣ `PeeweeGetterDict` 🎓, & 👥 💪 ⚙️ ⚫️ 🌐 Pydantic *🏷* / 🔗.
-
-///
-
-## 💩 🇨🇻
-
-🔜 ➡️ 👀 📁 `sql_app/crud.py`.
-
-### ✍ 🌐 💩 🇨🇻
-
-✍ 🌐 🎏 💩 🇨🇻 🇸🇲 🔰, 🌐 📟 📶 🎏:
-
-```Python hl_lines="1 4-5 8-9 12-13 16-20 23-24 27-30"
-{!../../docs_src/sql_databases_peewee/sql_app/crud.py!}
-```
-
-📤 🔺 ⏮️ 📟 🇸🇲 🔰.
-
-👥 🚫 🚶♀️ `db` 🔢 🤭. ↩️ 👥 ⚙️ 🏷 🔗. 👉 ↩️ `db` 🎚 🌐 🎚, 👈 🔌 🌐 🔗 ⚛. 👈 ⚫️❔ 👥 ✔️ 🌐 `contextvars` ℹ 🔛.
-
-🆖, 🕐❔ 🛬 📚 🎚, 💖 `get_users`, 👥 🔗 🤙 `list`, 💖:
-
-```Python
-list(models.User.select())
-```
-
-👉 🎏 🤔 👈 👥 ✔️ ✍ 🛃 `PeeweeGetterDict`. ✋️ 🛬 🕳 👈 ⏪ `list` ↩️ `peewee.ModelSelect` `response_model` *➡ 🛠️* ⏮️ `List[models.User]` (👈 👥 🔜 👀 ⏪) 🔜 👷 ☑.
-
-## 👑 **FastAPI** 📱
-
-& 🔜 📁 `sql_app/main.py` ➡️ 🛠️ & ⚙️ 🌐 🎏 🍕 👥 ✍ ⏭.
-
-### ✍ 💽 🏓
-
-📶 🙃 🌌 ✍ 💽 🏓:
-
-```Python hl_lines="9-11"
-{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
-```
-
-### ✍ 🔗
-
-✍ 🔗 👈 🔜 🔗 💽 ▶️️ ▶️ 📨 & 🔌 ⚫️ 🔚:
-
-```Python hl_lines="23-29"
-{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
-```
-
-📥 👥 ✔️ 🛁 `yield` ↩️ 👥 🤙 🚫 ⚙️ 💽 🎚 🔗.
-
-⚫️ 🔗 💽 & ♻ 🔗 💽 🔗 🔢 👈 🔬 🔠 📨 (⚙️ `contextvars` 🎱 ⚪️➡️ 🔛).
-
-↩️ 💽 🔗 ⚠ 👤/🅾 🚧, 👉 🔗 ✍ ⏮️ 😐 `def` 🔢.
-
-& ⤴️, 🔠 *➡ 🛠️ 🔢* 👈 💪 🔐 💽 👥 🚮 ⚫️ 🔗.
-
-✋️ 👥 🚫 ⚙️ 💲 👐 👉 🔗 (⚫️ 🤙 🚫 🤝 🙆 💲, ⚫️ ✔️ 🛁 `yield`). , 👥 🚫 🚮 ⚫️ *➡ 🛠️ 🔢* ✋️ *➡ 🛠️ 👨🎨* `dependencies` 🔢:
-
-```Python hl_lines="32 40 47 59 65 72"
-{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
-```
-
-### 🔑 🔢 🎧-🔗
-
-🌐 `contextvars` 🍕 👷, 👥 💪 ⚒ 💭 👥 ✔️ 🔬 💲 `ContextVar` 🔠 📨 👈 ⚙️ 💽, & 👈 💲 🔜 ⚙️ 💽 🇵🇸 (🔗, 💵, ♒️) 🎂 📨.
-
-👈, 👥 💪 ✍ ➕1️⃣ `async` 🔗 `reset_db_state()` 👈 ⚙️ 🎧-🔗 `get_db()`. ⚫️ 🔜 ⚒ 💲 🔑 🔢 (⏮️ 🔢 `dict`) 👈 🔜 ⚙️ 💽 🇵🇸 🎂 📨. & ⤴️ 🔗 `get_db()` 🔜 🏪 ⚫️ 💽 🇵🇸 (🔗, 💵, ♒️).
-
-```Python hl_lines="18-20"
-{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
-```
-
-**⏭ 📨**, 👥 🔜 ⏲ 👈 🔑 🔢 🔄 `async` 🔗 `reset_db_state()` & ⤴️ ✍ 🆕 🔗 `get_db()` 🔗, 👈 🆕 📨 🔜 ✔️ 🚮 👍 💽 🇵🇸 (🔗, 💵, ♒️).
-
-/// tip
-
-FastAPI 🔁 🛠️, 1️⃣ 📨 💪 ▶️ ➖ 🛠️, & ⏭ 🏁, ➕1️⃣ 📨 💪 📨 & ▶️ 🏭 👍, & ⚫️ 🌐 💪 🛠️ 🎏 🧵.
-
-✋️ 🔑 🔢 🤔 👫 🔁 ⚒,, 🏒 💽 🇵🇸 ⚒ `async` 🔗 `reset_db_state()` 🔜 🚧 🚮 👍 💽 🎂 🎂 📨.
-
- & 🎏 🕰, 🎏 🛠️ 📨 🔜 ✔️ 🚮 👍 💽 🇵🇸 👈 🔜 🔬 🎂 📨.
-
-///
-
-#### 🏒 🗳
-
-🚥 👆 ⚙️ <a href="https://docs.peewee-orm.com/en/latest/peewee/database.html#dynamically-defining-a-database" class="external-link" target="_blank">🏒 🗳</a>, ☑ 💽 `db.obj`.
-
-, 👆 🔜 ⏲ ⚫️ ⏮️:
-
-```Python hl_lines="3-4"
-async def reset_db_state():
- database.db.obj._state._state.set(db_state_default.copy())
- database.db.obj._state.reset()
-```
-
-### ✍ 👆 **FastAPI** *➡ 🛠️*
-
-🔜, 😒, 📥 🐩 **FastAPI** *➡ 🛠️* 📟.
-
-```Python hl_lines="32-37 40-43 46-53 56-62 65-68 71-79"
-{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
-```
-
-### 🔃 `def` 🆚 `async def`
-
-🎏 ⏮️ 🇸🇲, 👥 🚫 🔨 🕳 💖:
-
-```Python
-user = await models.User.select().first()
-```
-
-...✋️ ↩️ 👥 ⚙️:
-
-```Python
-user = models.User.select().first()
-```
-
-, 🔄, 👥 🔜 📣 *➡ 🛠️ 🔢* & 🔗 🍵 `async def`, ⏮️ 😐 `def`,:
-
-```Python hl_lines="2"
-# Something goes here
-def read_users(skip: int = 0, limit: int = 100):
- # Something goes here
-```
-
-## 🔬 🏒 ⏮️ 🔁
-
-👉 🖼 🔌 ➕ *➡ 🛠️* 👈 🔬 📏 🏭 📨 ⏮️ `time.sleep(sleep_time)`.
-
-⚫️ 🔜 ✔️ 💽 🔗 📂 ▶️ & 🔜 ⌛ 🥈 ⏭ 🙇 🔙. & 🔠 🆕 📨 🔜 ⌛ 🕐 🥈 🌘.
-
-👉 🔜 💪 ➡️ 👆 💯 👈 👆 📱 ⏮️ 🏒 & FastAPI 🎭 ☑ ⏮️ 🌐 💩 🔃 🧵.
-
-🚥 👆 💚 ✅ ❔ 🏒 🔜 💔 👆 📱 🚥 ⚙️ 🍵 🛠️, 🚶 `sql_app/database.py` 📁 & 🏤 ⏸:
-
-```Python
-# db._state = PeeweeConnectionState()
-```
-
-& 📁 `sql_app/main.py` 📁, 🏤 💪 `async` 🔗 `reset_db_state()` & ❎ ⚫️ ⏮️ `pass`:
-
-```Python
-async def reset_db_state():
-# database.db._state._state.set(db_state_default.copy())
-# database.db._state.reset()
- pass
-```
-
-⤴️ 🏃 👆 📱 ⏮️ Uvicorn:
-
-<div class="termy">
-
-```console
-$ uvicorn sql_app.main:app --reload
-
-<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
-```
-
-</div>
-
-📂 👆 🖥 <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> & ✍ 👩❤👨 👩💻.
-
-⤴️ 📂 1️⃣0️⃣ 📑 <a href="http://127.0.0.1:8000/docs#/default/read_slow_users_slowusers__get" class="external-link" target="_blank">http://127.0.0.1:8000/docs#/default/read_🐌_👩💻_slowusers_ = </a> 🎏 🕰.
-
-🚶 *➡ 🛠️* "🤚 `/slowusers/`" 🌐 📑. ⚙️ "🔄 ⚫️ 👅" 🔼 & 🛠️ 📨 🔠 📑, 1️⃣ ▶️️ ⏮️ 🎏.
-
-📑 🔜 ⌛ 🍖 & ⤴️ 👫 🔜 🎦 `Internal Server Error`.
-
-### ⚫️❔ 🔨
-
-🥇 📑 🔜 ⚒ 👆 📱 ✍ 🔗 💽 & ⌛ 🥈 ⏭ 🙇 🔙 & 📪 💽 🔗.
-
-⤴️, 📨 ⏭ 📑, 👆 📱 🔜 ⌛ 🕐 🥈 🌘, & 🔛.
-
-👉 ⛓ 👈 ⚫️ 🔜 🔚 🆙 🏁 🏁 📑' 📨 ⏪ 🌘 ⏮️ 🕐.
-
-⤴️ 1️⃣ 🏁 📨 👈 ⌛ 🌘 🥈 🔜 🔄 📂 💽 🔗, ✋️ 1️⃣ 📚 ⏮️ 📨 🎏 📑 🔜 🎲 🍵 🎏 🧵 🥇 🕐, ⚫️ 🔜 ✔️ 🎏 💽 🔗 👈 ⏪ 📂, & 🏒 🔜 🚮 ❌ & 👆 🔜 👀 ⚫️ 📶, & 📨 🔜 ✔️ `Internal Server Error`.
-
-👉 🔜 🎲 🔨 🌅 🌘 1️⃣ 📚 📑.
-
-🚥 👆 ✔️ 💗 👩💻 💬 👆 📱 ⚫️❔ 🎏 🕰, 👉 ⚫️❔ 💪 🔨.
-
-& 👆 📱 ▶️ 🍵 🌅 & 🌖 👩💻 🎏 🕰, ⌛ 🕰 👁 📨 💪 📏 & 📏 ⏲ ❌.
-
-### 🔧 🏒 ⏮️ FastAPI
-
-🔜 🚶 🔙 📁 `sql_app/database.py`, & ✍ ⏸:
-
-```Python
-db._state = PeeweeConnectionState()
-```
-
-& 📁 `sql_app/main.py` 📁, ✍ 💪 `async` 🔗 `reset_db_state()`:
-
-```Python
-async def reset_db_state():
- database.db._state._state.set(db_state_default.copy())
- database.db._state.reset()
-```
-
-❎ 👆 🏃♂ 📱 & ▶️ ⚫️ 🔄.
-
-🔁 🎏 🛠️ ⏮️ 1️⃣0️⃣ 📑. 👉 🕰 🌐 👫 🔜 ⌛ & 👆 🔜 🤚 🌐 🏁 🍵 ❌.
-
-...👆 🔧 ⚫️ ❗
-
-## 📄 🌐 📁
-
- 💭 👆 🔜 ✔️ 📁 📛 `my_super_project` (⚖️ 👐 👆 💚) 👈 🔌 🎧-📁 🤙 `sql_app`.
-
-`sql_app` 🔜 ✔️ 📄 📁:
-
-* `sql_app/__init__.py`: 🛁 📁.
-
-* `sql_app/database.py`:
-
-```Python
-{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
-```
-
-* `sql_app/models.py`:
-
-```Python
-{!../../docs_src/sql_databases_peewee/sql_app/models.py!}
-```
-
-* `sql_app/schemas.py`:
-
-```Python
-{!../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
-```
-
-* `sql_app/crud.py`:
-
-```Python
-{!../../docs_src/sql_databases_peewee/sql_app/crud.py!}
-```
-
-* `sql_app/main.py`:
-
-```Python
-{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
-```
-
-## 📡 ℹ
-
-/// warning
-
-👉 📶 📡 ℹ 👈 👆 🎲 🚫 💪.
-
-///
-
-### ⚠
-
-🏒 ⚙️ <a href="https://docs.python.org/3/library/threading.html#thread-local-data" class="external-link" target="_blank">`threading.local`</a> 🔢 🏪 ⚫️ 💽 "🇵🇸" 💽 (🔗, 💵, ♒️).
-
-`threading.local` ✍ 💲 🌟 ⏮️ 🧵, ✋️ 🔁 🛠️ 🔜 🏃 🌐 📟 (✅ 🔠 📨) 🎏 🧵, & 🎲 🚫 ✔.
-
-🔛 🔝 👈, 🔁 🛠️ 💪 🏃 🔁 📟 🧵 (⚙️ `asyncio.run_in_executor`), ✋️ 🔗 🎏 📨.
-
-👉 ⛓ 👈, ⏮️ 🏒 ⏮️ 🛠️, 💗 📋 💪 ⚙️ 🎏 `threading.local` 🔢 & 🔚 🆙 🤝 🎏 🔗 & 💽 (👈 👫 🚫🔜 🚫), & 🎏 🕰, 🚥 👫 🛠️ 🔁 👤/🅾-🚧 📟 🧵 (⏮️ 😐 `def` 🔢 FastAPI, *➡ 🛠️* & 🔗), 👈 📟 🏆 🚫 ✔️ 🔐 💽 🇵🇸 🔢, ⏪ ⚫️ 🍕 🎏 📨 & ⚫️ 🔜 💪 🤚 🔐 🎏 💽 🇵🇸.
-
-### 🔑 🔢
-
-🐍 3️⃣.7️⃣ ✔️ <a href="https://docs.python.org/3/library/contextvars.html" class="external-link" target="_blank">`contextvars`</a> 👈 💪 ✍ 🇧🇿 🔢 📶 🎏 `threading.local`, ✋️ 🔗 👫 🔁 ⚒.
-
-📤 📚 👜 ✔️ 🤯.
-
-`ContextVar` ✔️ ✍ 🔝 🕹, 💖:
-
-```Python
-some_var = ContextVar("some_var", default="default value")
-```
-
-⚒ 💲 ⚙️ ⏮️ "🔑" (✅ ⏮️ 📨) ⚙️:
-
-```Python
-some_var.set("new value")
-```
-
-🤚 💲 🙆 🔘 🔑 (✅ 🙆 🍕 🚚 ⏮️ 📨) ⚙️:
-
-```Python
-some_var.get()
-```
-
-### ⚒ 🔑 🔢 `async` 🔗 `reset_db_state()`
-
-🚥 🍕 🔁 📟 ⚒ 💲 ⏮️ `some_var.set("updated in function")` (✅ 💖 `async` 🔗), 🎂 📟 ⚫️ & 📟 👈 🚶 ⏮️ (✅ 📟 🔘 `async` 🔢 🤙 ⏮️ `await`) 🔜 👀 👈 🆕 💲.
-
-, 👆 💼, 🚥 👥 ⚒ 🏒 🇵🇸 🔢 (⏮️ 🔢 `dict`) `async` 🔗, 🌐 🎂 🔗 📟 👆 📱 🔜 👀 👉 💲 & 🔜 💪 ♻ ⚫️ 🎂 📨.
-
-& 🔑 🔢 🔜 ⚒ 🔄 ⏭ 📨, 🚥 👫 🛠️.
-
-### ⚒ 💽 🇵🇸 🔗 `get_db()`
-
-`get_db()` 😐 `def` 🔢, **FastAPI** 🔜 ⚒ ⚫️ 🏃 🧵, ⏮️ *📁* "🔑", 🧑🤝🧑 🎏 💲 🔑 🔢 ( `dict` ⏮️ ⏲ 💽 🇵🇸). ⤴️ ⚫️ 💪 🚮 💽 🇵🇸 👈 `dict`, 💖 🔗, ♒️.
-
-✋️ 🚥 💲 🔑 🔢 (🔢 `dict`) ⚒ 👈 😐 `def` 🔢, ⚫️ 🔜 ✍ 🆕 💲 👈 🔜 🚧 🕴 👈 🧵 🧵, & 🎂 📟 (💖 *➡ 🛠️ 🔢*) 🚫🔜 ✔️ 🔐 ⚫️. `get_db()` 👥 💪 🕴 ⚒ 💲 `dict`, ✋️ 🚫 🎂 `dict` ⚫️.
-
-, 👥 💪 ✔️ `async` 🔗 `reset_db_state()` ⚒ `dict` 🔑 🔢. 👈 🌌, 🌐 📟 ✔️ 🔐 🎏 `dict` 💽 🇵🇸 👁 📨.
-
-### 🔗 & 🔌 🔗 `get_db()`
-
-⤴️ ⏭ ❔ 🔜, ⚫️❔ 🚫 🔗 & 🔌 💽 `async` 🔗 ⚫️, ↩️ `get_db()`❓
-
-`async` 🔗 ✔️ `async` 🔑 🔢 🛡 🎂 📨, ✋️ 🏗 & 📪 💽 🔗 ⚠ 🚧, ⚫️ 💪 📉 🎭 🚥 ⚫️ 📤.
-
-👥 💪 😐 `def` 🔗 `get_db()`.
diff --git a/docs/en/docs/advanced/testing-database.md b/docs/en/docs/advanced/testing-database.md
deleted file mode 100644
index 2b704f229..000000000
--- a/docs/en/docs/advanced/testing-database.md
+++ /dev/null
@@ -1,111 +0,0 @@
-# Testing a Database
-
-/// info
-
-These docs are about to be updated. 🎉
-
-The current version assumes Pydantic v1, and SQLAlchemy versions less than 2.0.
-
-The new docs will include Pydantic v2 and will use <a href="https://sqlmodel.tiangolo.com/" class="external-link" target="_blank">SQLModel</a> (which is also based on SQLAlchemy) once it is updated to use Pydantic v2 as well.
-
-///
-
-You can use the same dependency overrides from [Testing Dependencies with Overrides](testing-dependencies.md){.internal-link target=_blank} to alter a database for testing.
-
-You could want to set up a different database for testing, rollback the data after the tests, pre-fill it with some testing data, etc.
-
-The main idea is exactly the same you saw in that previous chapter.
-
-## Add tests for the SQL app
-
-Let's update the example from [SQL (Relational) Databases](../tutorial/sql-databases.md){.internal-link target=_blank} to use a testing database.
-
-All the app code is the same, you can go back to that chapter check how it was.
-
-The only changes here are in the new testing file.
-
-Your normal dependency `get_db()` would return a database session.
-
-In the test, you could use a dependency override to return your *custom* database session instead of the one that would be used normally.
-
-In this example we'll create a temporary database only for the tests.
-
-## File structure
-
-We create a new file at `sql_app/tests/test_sql_app.py`.
-
-So the new file structure looks like:
-
-``` hl_lines="9-11"
-.
-└── sql_app
- ├── __init__.py
- ├── crud.py
- ├── database.py
- ├── main.py
- ├── models.py
- ├── schemas.py
- └── tests
- ├── __init__.py
- └── test_sql_app.py
-```
-
-## Create the new database session
-
-First, we create a new database session with the new database.
-
-We'll use an in-memory database that persists during the tests instead of the local file `sql_app.db`.
-
-But the rest of the session code is more or less the same, we just copy it.
-
-```Python hl_lines="8-13"
-{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
-```
-
-/// tip
-
-You could reduce duplication in that code by putting it in a function and using it from both `database.py` and `tests/test_sql_app.py`.
-
-For simplicity and to focus on the specific testing code, we are just copying it.
-
-///
-
-## Create the database
-
-Because now we are going to use a new database in a new file, we need to make sure we create the database with:
-
-```Python
-Base.metadata.create_all(bind=engine)
-```
-
-That is normally called in `main.py`, but the line in `main.py` uses the database file `sql_app.db`, and we need to make sure we create `test.db` for the tests.
-
-So we add that line here, with the new file.
-
-```Python hl_lines="16"
-{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
-```
-
-## Dependency override
-
-Now we create the dependency override and add it to the overrides for our app.
-
-```Python hl_lines="19-24 27"
-{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
-```
-
-/// tip
-
-The code for `override_get_db()` is almost exactly the same as for `get_db()`, but in `override_get_db()` we use the `TestingSessionLocal` for the testing database instead.
-
-///
-
-## Test the app
-
-Then we can just test the app as normally.
-
-```Python hl_lines="32-47"
-{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
-```
-
-And all the modifications we made in the database during the tests will be in the `test.db` database instead of the main `sql_app.db`.
diff --git a/docs/en/docs/how-to/async-sql-encode-databases.md b/docs/en/docs/how-to/async-sql-encode-databases.md
deleted file mode 100644
index a72316c4d..000000000
--- a/docs/en/docs/how-to/async-sql-encode-databases.md
+++ /dev/null
@@ -1,201 +0,0 @@
-# ~~Async SQL (Relational) Databases with Encode/Databases~~ (deprecated)
-
-/// info
-
-These docs are about to be updated. 🎉
-
-The current version assumes Pydantic v1.
-
-The new docs will include Pydantic v2 and will use <a href="https://sqlmodel.tiangolo.com/" class="external-link" target="_blank">SQLModel</a> once it is updated to use Pydantic v2 as well.
-
-///
-
-/// warning | "Deprecated"
-
-This tutorial is deprecated and will be removed in a future version.
-
-///
-
-You can also use <a href="https://github.com/encode/databases" class="external-link" target="_blank">`encode/databases`</a> with **FastAPI** to connect to databases using `async` and `await`.
-
-It is compatible with:
-
-* PostgreSQL
-* MySQL
-* SQLite
-
-In this example, we'll use **SQLite**, because it uses a single file and Python has integrated support. So, you can copy this example and run it as is.
-
-Later, for your production application, you might want to use a database server like **PostgreSQL**.
-
-/// tip
-
-You could adopt ideas from the section about SQLAlchemy ORM ([SQL (Relational) Databases](../tutorial/sql-databases.md){.internal-link target=_blank}), like using utility functions to perform operations in the database, independent of your **FastAPI** code.
-
-This section doesn't apply those ideas, to be equivalent to the counterpart in <a href="https://www.starlette.io/database/" class="external-link" target="_blank">Starlette</a>.
-
-///
-
-## Import and set up `SQLAlchemy`
-
-* Import `SQLAlchemy`.
-* Create a `metadata` object.
-* Create a table `notes` using the `metadata` object.
-
-```Python hl_lines="4 14 16-22"
-{!../../docs_src/async_sql_databases/tutorial001.py!}
-```
-
-/// tip
-
-Notice that all this code is pure SQLAlchemy Core.
-
-`databases` is not doing anything here yet.
-
-///
-
-## Import and set up `databases`
-
-* Import `databases`.
-* Create a `DATABASE_URL`.
-* Create a `database` object.
-
-```Python hl_lines="3 9 12"
-{!../../docs_src/async_sql_databases/tutorial001.py!}
-```
-
-/// tip
-
-If you were connecting to a different database (e.g. PostgreSQL), you would need to change the `DATABASE_URL`.
-
-///
-
-## Create the tables
-
-In this case, we are creating the tables in the same Python file, but in production, you would probably want to create them with Alembic, integrated with migrations, etc.
-
-Here, this section would run directly, right before starting your **FastAPI** application.
-
-* Create an `engine`.
-* Create all the tables from the `metadata` object.
-
-```Python hl_lines="25-28"
-{!../../docs_src/async_sql_databases/tutorial001.py!}
-```
-
-## Create models
-
-Create Pydantic models for:
-
-* Notes to be created (`NoteIn`).
-* Notes to be returned (`Note`).
-
-```Python hl_lines="31-33 36-39"
-{!../../docs_src/async_sql_databases/tutorial001.py!}
-```
-
-By creating these Pydantic models, the input data will be validated, serialized (converted), and annotated (documented).
-
-So, you will be able to see it all in the interactive API docs.
-
-## Connect and disconnect
-
-* Create your `FastAPI` application.
-* Create event handlers to connect and disconnect from the database.
-
-```Python hl_lines="42 45-47 50-52"
-{!../../docs_src/async_sql_databases/tutorial001.py!}
-```
-
-## Read notes
-
-Create the *path operation function* to read notes:
-
-```Python hl_lines="55-58"
-{!../../docs_src/async_sql_databases/tutorial001.py!}
-```
-
-/// note
-
-Notice that as we communicate with the database using `await`, the *path operation function* is declared with `async`.
-
-///
-
-### Notice the `response_model=List[Note]`
-
-It uses `typing.List`.
-
-That documents (and validates, serializes, filters) the output data, as a `list` of `Note`s.
-
-## Create notes
-
-Create the *path operation function* to create notes:
-
-```Python hl_lines="61-65"
-{!../../docs_src/async_sql_databases/tutorial001.py!}
-```
-
-/// info
-
-In Pydantic v1 the method was called `.dict()`, it was deprecated (but still supported) in Pydantic v2, and renamed to `.model_dump()`.
-
-The examples here use `.dict()` for compatibility with Pydantic v1, but you should use `.model_dump()` instead if you can use Pydantic v2.
-
-///
-
-/// note
-
-Notice that as we communicate with the database using `await`, the *path operation function* is declared with `async`.
-
-///
-
-### About `{**note.dict(), "id": last_record_id}`
-
-`note` is a Pydantic `Note` object.
-
-`note.dict()` returns a `dict` with its data, something like:
-
-```Python
-{
- "text": "Some note",
- "completed": False,
-}
-```
-
-but it doesn't have the `id` field.
-
-So we create a new `dict`, that contains the key-value pairs from `note.dict()` with:
-
-```Python
-{**note.dict()}
-```
-
-`**note.dict()` "unpacks" the key value pairs directly, so, `{**note.dict()}` would be, more or less, a copy of `note.dict()`.
-
-And then, we extend that copy `dict`, adding another key-value pair: `"id": last_record_id`:
-
-```Python
-{**note.dict(), "id": last_record_id}
-```
-
-So, the final result returned would be something like:
-
-```Python
-{
- "id": 1,
- "text": "Some note",
- "completed": False,
-}
-```
-
-## Check it
-
-You can copy this code as is, and see the docs at <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
-
-There you can see all your API documented and interact with it:
-
-<img src="/img/tutorial/async-sql-databases/image01.png">
-
-## More info
-
-You can read more about <a href="https://github.com/encode/databases" class="external-link" target="_blank">`encode/databases` at its GitHub page</a>.
diff --git a/docs/en/docs/how-to/nosql-databases-couchbase.md b/docs/en/docs/how-to/nosql-databases-couchbase.md
deleted file mode 100644
index feb4025dd..000000000
--- a/docs/en/docs/how-to/nosql-databases-couchbase.md
+++ /dev/null
@@ -1,178 +0,0 @@
-# ~~NoSQL (Distributed / Big Data) Databases with Couchbase~~ (deprecated)
-
-/// info
-
-These docs are about to be updated. 🎉
-
-The current version assumes Pydantic v1.
-
-The new docs will hopefully use Pydantic v2 and will use <a href="https://art049.github.io/odmantic/" class="external-link" target="_blank">ODMantic</a> with MongoDB.
-
-///
-
-/// warning | "Deprecated"
-
-This tutorial is deprecated and will be removed in a future version.
-
-///
-
-**FastAPI** can also be integrated with any <abbr title="Distributed database (Big Data), also 'Not Only SQL'">NoSQL</abbr>.
-
-Here we'll see an example using **<a href="https://www.couchbase.com/" class="external-link" target="_blank">Couchbase</a>**, a <abbr title="Document here refers to a JSON object (a dict), with keys and values, and those values can also be other JSON objects, arrays (lists), numbers, strings, booleans, etc.">document</abbr> based NoSQL database.
-
-You can adapt it to any other NoSQL database like:
-
-* **MongoDB**
-* **Cassandra**
-* **CouchDB**
-* **ArangoDB**
-* **ElasticSearch**, etc.
-
-/// tip
-
-There is an official project generator with **FastAPI** and **Couchbase**, all based on **Docker**, including a frontend and more tools: <a href="https://github.com/tiangolo/full-stack-fastapi-couchbase" class="external-link" target="_blank">https://github.com/tiangolo/full-stack-fastapi-couchbase</a>
-
-///
-
-## Import Couchbase components
-
-For now, don't pay attention to the rest, only the imports:
-
-```Python hl_lines="3-5"
-{!../../docs_src/nosql_databases/tutorial001.py!}
-```
-
-## Define a constant to use as a "document type"
-
-We will use it later as a fixed field `type` in our documents.
-
-This is not required by Couchbase, but is a good practice that will help you afterwards.
-
-```Python hl_lines="9"
-{!../../docs_src/nosql_databases/tutorial001.py!}
-```
-
-## Add a function to get a `Bucket`
-
-In **Couchbase**, a bucket is a set of documents, that can be of different types.
-
-They are generally all related to the same application.
-
-The analogy in the relational database world would be a "database" (a specific database, not the database server).
-
-The analogy in **MongoDB** would be a "collection".
-
-In the code, a `Bucket` represents the main entrypoint of communication with the database.
-
-This utility function will:
-
-* Connect to a **Couchbase** cluster (that might be a single machine).
- * Set defaults for timeouts.
-* Authenticate in the cluster.
-* Get a `Bucket` instance.
- * Set defaults for timeouts.
-* Return it.
-
-```Python hl_lines="12-21"
-{!../../docs_src/nosql_databases/tutorial001.py!}
-```
-
-## Create Pydantic models
-
-As **Couchbase** "documents" are actually just "JSON objects", we can model them with Pydantic.
-
-### `User` model
-
-First, let's create a `User` model:
-
-```Python hl_lines="24-28"
-{!../../docs_src/nosql_databases/tutorial001.py!}
-```
-
-We will use this model in our *path operation function*, so, we don't include in it the `hashed_password`.
-
-### `UserInDB` model
-
-Now, let's create a `UserInDB` model.
-
-This will have the data that is actually stored in the database.
-
-We don't create it as a subclass of Pydantic's `BaseModel` but as a subclass of our own `User`, because it will have all the attributes in `User` plus a couple more:
-
-```Python hl_lines="31-33"
-{!../../docs_src/nosql_databases/tutorial001.py!}
-```
-
-/// note
-
-Notice that we have a `hashed_password` and a `type` field that will be stored in the database.
-
-But it is not part of the general `User` model (the one we will return in the *path operation*).
-
-///
-
-## Get the user
-
-Now create a function that will:
-
-* Take a username.
-* Generate a document ID from it.
-* Get the document with that ID.
-* Put the contents of the document in a `UserInDB` model.
-
-By creating a function that is only dedicated to getting your user from a `username` (or any other parameter) independent of your *path operation function*, you can more easily reuse it in multiple parts and also add <abbr title="Automated test, written in code, that checks if another piece of code is working correctly.">unit tests</abbr> for it:
-
-```Python hl_lines="36-42"
-{!../../docs_src/nosql_databases/tutorial001.py!}
-```
-
-### f-strings
-
-If you are not familiar with the `f"userprofile::{username}"`, it is a Python "<a href="https://docs.python.org/3/glossary.html#term-f-string" class="external-link" target="_blank">f-string</a>".
-
-Any variable that is put inside of `{}` in an f-string will be expanded / injected in the string.
-
-### `dict` unpacking
-
-If you are not familiar with the `UserInDB(**result.value)`, <a href="https://docs.python.org/3/glossary.html#term-argument" class="external-link" target="_blank">it is using `dict` "unpacking"</a>.
-
-It will take the `dict` at `result.value`, and take each of its keys and values and pass them as key-values to `UserInDB` as keyword arguments.
-
-So, if the `dict` contains:
-
-```Python
-{
- "username": "johndoe",
- "hashed_password": "some_hash",
-}
-```
-
-It will be passed to `UserInDB` as:
-
-```Python
-UserInDB(username="johndoe", hashed_password="some_hash")
-```
-
-## Create your **FastAPI** code
-
-### Create the `FastAPI` app
-
-```Python hl_lines="46"
-{!../../docs_src/nosql_databases/tutorial001.py!}
-```
-
-### Create the *path operation function*
-
-As our code is calling Couchbase and we are not using the <a href="https://docs.couchbase.com/python-sdk/2.5/async-programming.html#asyncio-python-3-5" class="external-link" target="_blank">experimental Python <code>await</code> support</a>, we should declare our function with normal `def` instead of `async def`.
-
-Also, Couchbase recommends not using a single `Bucket` object in multiple "<abbr title="A sequence of code being executed by the program, while at the same time, or at intervals, there can be others being executed too.">thread</abbr>s", so, we can just get the bucket directly and pass it to our utility functions:
-
-```Python hl_lines="49-53"
-{!../../docs_src/nosql_databases/tutorial001.py!}
-```
-
-## Recap
-
-You can integrate any third party NoSQL database, just using their standard packages.
-
-The same applies to any other external tool, system or API.
diff --git a/docs/en/docs/how-to/sql-databases-peewee.md b/docs/en/docs/how-to/sql-databases-peewee.md
deleted file mode 100644
index e73ca369b..000000000
--- a/docs/en/docs/how-to/sql-databases-peewee.md
+++ /dev/null
@@ -1,594 +0,0 @@
-# ~~SQL (Relational) Databases with Peewee~~ (deprecated)
-
-/// warning | "Deprecated"
-
-This tutorial is deprecated and will be removed in a future version.
-
-///
-
-/// warning
-
-If you are just starting, the tutorial [SQL (Relational) Databases](../tutorial/sql-databases.md){.internal-link target=_blank} that uses SQLAlchemy should be enough.
-
-Feel free to skip this.
-
-Peewee is not recommended with FastAPI as it doesn't play well with anything async Python. There are several better alternatives.
-
-///
-
-/// info
-
-These docs assume Pydantic v1.
-
-Because Pewee doesn't play well with anything async and there are better alternatives, I won't update these docs for Pydantic v2, they are kept for now only for historical purposes.
-
-The examples here are no longer tested in CI (as they were before).
-
-///
-
-If you are starting a project from scratch, you are probably better off with SQLAlchemy ORM ([SQL (Relational) Databases](../tutorial/sql-databases.md){.internal-link target=_blank}), or any other async ORM.
-
-If you already have a code base that uses <a href="https://docs.peewee-orm.com/en/latest/" class="external-link" target="_blank">Peewee ORM</a>, you can check here how to use it with **FastAPI**.
-
-/// warning | "Python 3.7+ required"
-
-You will need Python 3.7 or above to safely use Peewee with FastAPI.
-
-///
-
-## Peewee for async
-
-Peewee was not designed for async frameworks, or with them in mind.
-
-Peewee has some heavy assumptions about its defaults and about how it should be used.
-
-If you are developing an application with an older non-async framework, and can work with all its defaults, **it can be a great tool**.
-
-But if you need to change some of the defaults, support more than one predefined database, work with an async framework (like FastAPI), etc, you will need to add quite some complex extra code to override those defaults.
-
-Nevertheless, it's possible to do it, and here you'll see exactly what code you have to add to be able to use Peewee with FastAPI.
-
-/// note | "Technical Details"
-
-You can read more about Peewee's stand about async in Python <a href="https://docs.peewee-orm.com/en/latest/peewee/database.html#async-with-gevent" class="external-link" target="_blank">in the docs</a>, <a href="https://github.com/coleifer/peewee/issues/263#issuecomment-517347032" class="external-link" target="_blank">an issue</a>, <a href="https://github.com/coleifer/peewee/pull/2072#issuecomment-563215132" class="external-link" target="_blank">a PR</a>.
-
-///
-
-## The same app
-
-We are going to create the same application as in the SQLAlchemy tutorial ([SQL (Relational) Databases](../tutorial/sql-databases.md){.internal-link target=_blank}).
-
-Most of the code is actually the same.
-
-So, we are going to focus only on the differences.
-
-## File structure
-
-Let's say you have a directory named `my_super_project` that contains a sub-directory called `sql_app` with a structure like this:
-
-```
-.
-└── sql_app
- ├── __init__.py
- ├── crud.py
- ├── database.py
- ├── main.py
- └── schemas.py
-```
-
-This is almost the same structure as we had for the SQLAlchemy tutorial.
-
-Now let's see what each file/module does.
-
-## Create the Peewee parts
-
-Let's refer to the file `sql_app/database.py`.
-
-### The standard Peewee code
-
-Let's first check all the normal Peewee code, create a Peewee database:
-
-```Python hl_lines="3 5 22"
-{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
-```
-
-/// tip
-
-Keep in mind that if you wanted to use a different database, like PostgreSQL, you couldn't just change the string. You would need to use a different Peewee database class.
-
-///
-
-#### Note
-
-The argument:
-
-```Python
-check_same_thread=False
-```
-
-is equivalent to the one in the SQLAlchemy tutorial:
-
-```Python
-connect_args={"check_same_thread": False}
-```
-
-...it is needed only for `SQLite`.
-
-/// info | "Technical Details"
-
-Exactly the same technical details as in [SQL (Relational) Databases](../tutorial/sql-databases.md#note){.internal-link target=_blank} apply.
-
-///
-
-### Make Peewee async-compatible `PeeweeConnectionState`
-
-The main issue with Peewee and FastAPI is that Peewee relies heavily on <a href="https://docs.python.org/3/library/threading.html#thread-local-data" class="external-link" target="_blank">Python's `threading.local`</a>, and it doesn't have a direct way to override it or let you handle connections/sessions directly (as is done in the SQLAlchemy tutorial).
-
-And `threading.local` is not compatible with the new async features of modern Python.
-
-/// note | "Technical Details"
-
-`threading.local` is used to have a "magic" variable that has a different value for each thread.
-
-This was useful in older frameworks designed to have one single thread per request, no more, no less.
-
-Using this, each request would have its own database connection/session, which is the actual final goal.
-
-But FastAPI, using the new async features, could handle more than one request on the same thread. And at the same time, for a single request, it could run multiple things in different threads (in a threadpool), depending on if you use `async def` or normal `def`. This is what gives all the performance improvements to FastAPI.
-
-///
-
-But Python 3.7 and above provide a more advanced alternative to `threading.local`, that can also be used in the places where `threading.local` would be used, but is compatible with the new async features.
-
-We are going to use that. It's called <a href="https://docs.python.org/3/library/contextvars.html" class="external-link" target="_blank">`contextvars`</a>.
-
-We are going to override the internal parts of Peewee that use `threading.local` and replace them with `contextvars`, with the corresponding updates.
-
-This might seem a bit complex (and it actually is), you don't really need to completely understand how it works to use it.
-
-We will create a `PeeweeConnectionState`:
-
-```Python hl_lines="10-19"
-{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
-```
-
-This class inherits from a special internal class used by Peewee.
-
-It has all the logic to make Peewee use `contextvars` instead of `threading.local`.
-
-`contextvars` works a bit differently than `threading.local`. But the rest of Peewee's internal code assumes that this class works with `threading.local`.
-
-So, we need to do some extra tricks to make it work as if it was just using `threading.local`. The `__init__`, `__setattr__`, and `__getattr__` implement all the required tricks for this to be used by Peewee without knowing that it is now compatible with FastAPI.
-
-/// tip
-
-This will just make Peewee behave correctly when used with FastAPI. Not randomly opening or closing connections that are being used, creating errors, etc.
-
-But it doesn't give Peewee async super-powers. You should still use normal `def` functions and not `async def`.
-
-///
-
-### Use the custom `PeeweeConnectionState` class
-
-Now, overwrite the `._state` internal attribute in the Peewee database `db` object using the new `PeeweeConnectionState`:
-
-```Python hl_lines="24"
-{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
-```
-
-/// tip
-
-Make sure you overwrite `db._state` *after* creating `db`.
-
-///
-
-/// tip
-
-You would do the same for any other Peewee database, including `PostgresqlDatabase`, `MySQLDatabase`, etc.
-
-///
-
-## Create the database models
-
-Let's now see the file `sql_app/models.py`.
-
-### Create Peewee models for our data
-
-Now create the Peewee models (classes) for `User` and `Item`.
-
-This is the same you would do if you followed the Peewee tutorial and updated the models to have the same data as in the SQLAlchemy tutorial.
-
-/// tip
-
-Peewee also uses the term "**model**" to refer to these classes and instances that interact with the database.
-
-But Pydantic also uses the term "**model**" to refer to something different, the data validation, conversion, and documentation classes and instances.
-
-///
-
-Import `db` from `database` (the file `database.py` from above) and use it here.
-
-```Python hl_lines="3 6-12 15-21"
-{!../../docs_src/sql_databases_peewee/sql_app/models.py!}
-```
-
-/// tip
-
-Peewee creates several magic attributes.
-
-It will automatically add an `id` attribute as an integer to be the primary key.
-
-It will chose the name of the tables based on the class names.
-
-For the `Item`, it will create an attribute `owner_id` with the integer ID of the `User`. But we don't declare it anywhere.
-
-///
-
-## Create the Pydantic models
-
-Now let's check the file `sql_app/schemas.py`.
-
-/// tip
-
-To avoid confusion between the Peewee *models* and the Pydantic *models*, we will have the file `models.py` with the Peewee models, and the file `schemas.py` with the Pydantic models.
-
-These Pydantic models define more or less a "schema" (a valid data shape).
-
-So this will help us avoiding confusion while using both.
-
-///
-
-### Create the Pydantic *models* / schemas
-
-Create all the same Pydantic models as in the SQLAlchemy tutorial:
-
-```Python hl_lines="16-18 21-22 25-30 34-35 38-39 42-48"
-{!../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
-```
-
-/// tip
-
-Here we are creating the models with an `id`.
-
-We didn't explicitly specify an `id` attribute in the Peewee models, but Peewee adds one automatically.
-
-We are also adding the magic `owner_id` attribute to `Item`.
-
-///
-
-### Create a `PeeweeGetterDict` for the Pydantic *models* / schemas
-
-When you access a relationship in a Peewee object, like in `some_user.items`, Peewee doesn't provide a `list` of `Item`.
-
-It provides a special custom object of class `ModelSelect`.
-
-It's possible to create a `list` of its items with `list(some_user.items)`.
-
-But the object itself is not a `list`. And it's also not an actual Python <a href="https://docs.python.org/3/glossary.html#term-generator" class="external-link" target="_blank">generator</a>. Because of this, Pydantic doesn't know by default how to convert it to a `list` of Pydantic *models* / schemas.
-
-But recent versions of Pydantic allow providing a custom class that inherits from `pydantic.utils.GetterDict`, to provide the functionality used when using the `orm_mode = True` to retrieve the values for ORM model attributes.
-
-We are going to create a custom `PeeweeGetterDict` class and use it in all the same Pydantic *models* / schemas that use `orm_mode`:
-
-```Python hl_lines="3 8-13 31 49"
-{!../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
-```
-
-Here we are checking if the attribute that is being accessed (e.g. `.items` in `some_user.items`) is an instance of `peewee.ModelSelect`.
-
-And if that's the case, just return a `list` with it.
-
-And then we use it in the Pydantic *models* / schemas that use `orm_mode = True`, with the configuration variable `getter_dict = PeeweeGetterDict`.
-
-/// tip
-
-We only need to create one `PeeweeGetterDict` class, and we can use it in all the Pydantic *models* / schemas.
-
-///
-
-## CRUD utils
-
-Now let's see the file `sql_app/crud.py`.
-
-### Create all the CRUD utils
-
-Create all the same CRUD utils as in the SQLAlchemy tutorial, all the code is very similar:
-
-```Python hl_lines="1 4-5 8-9 12-13 16-20 23-24 27-30"
-{!../../docs_src/sql_databases_peewee/sql_app/crud.py!}
-```
-
-There are some differences with the code for the SQLAlchemy tutorial.
-
-We don't pass a `db` attribute around. Instead we use the models directly. This is because the `db` object is a global object, that includes all the connection logic. That's why we had to do all the `contextvars` updates above.
-
-Aso, when returning several objects, like in `get_users`, we directly call `list`, like in:
-
-```Python
-list(models.User.select())
-```
-
-This is for the same reason that we had to create a custom `PeeweeGetterDict`. But by returning something that is already a `list` instead of the `peewee.ModelSelect` the `response_model` in the *path operation* with `List[models.User]` (that we'll see later) will work correctly.
-
-## Main **FastAPI** app
-
-And now in the file `sql_app/main.py` let's integrate and use all the other parts we created before.
-
-### Create the database tables
-
-In a very simplistic way create the database tables:
-
-```Python hl_lines="9-11"
-{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
-```
-
-### Create a dependency
-
-Create a dependency that will connect the database right at the beginning of a request and disconnect it at the end:
-
-```Python hl_lines="23-29"
-{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
-```
-
-Here we have an empty `yield` because we are actually not using the database object directly.
-
-It is connecting to the database and storing the connection data in an internal variable that is independent for each request (using the `contextvars` tricks from above).
-
-Because the database connection is potentially I/O blocking, this dependency is created with a normal `def` function.
-
-And then, in each *path operation function* that needs to access the database we add it as a dependency.
-
-But we are not using the value given by this dependency (it actually doesn't give any value, as it has an empty `yield`). So, we don't add it to the *path operation function* but to the *path operation decorator* in the `dependencies` parameter:
-
-```Python hl_lines="32 40 47 59 65 72"
-{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
-```
-
-### Context variable sub-dependency
-
-For all the `contextvars` parts to work, we need to make sure we have an independent value in the `ContextVar` for each request that uses the database, and that value will be used as the database state (connection, transactions, etc) for the whole request.
-
-For that, we need to create another `async` dependency `reset_db_state()` that is used as a sub-dependency in `get_db()`. It will set the value for the context variable (with just a default `dict`) that will be used as the database state for the whole request. And then the dependency `get_db()` will store in it the database state (connection, transactions, etc).
-
-```Python hl_lines="18-20"
-{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
-```
-
-For the **next request**, as we will reset that context variable again in the `async` dependency `reset_db_state()` and then create a new connection in the `get_db()` dependency, that new request will have its own database state (connection, transactions, etc).
-
-/// tip
-
-As FastAPI is an async framework, one request could start being processed, and before finishing, another request could be received and start processing as well, and it all could be processed in the same thread.
-
-But context variables are aware of these async features, so, a Peewee database state set in the `async` dependency `reset_db_state()` will keep its own data throughout the entire request.
-
-And at the same time, the other concurrent request will have its own database state that will be independent for the whole request.
-
-///
-
-#### Peewee Proxy
-
-If you are using a <a href="https://docs.peewee-orm.com/en/latest/peewee/database.html#dynamically-defining-a-database" class="external-link" target="_blank">Peewee Proxy</a>, the actual database is at `db.obj`.
-
-So, you would reset it with:
-
-```Python hl_lines="3-4"
-async def reset_db_state():
- database.db.obj._state._state.set(db_state_default.copy())
- database.db.obj._state.reset()
-```
-
-### Create your **FastAPI** *path operations*
-
-Now, finally, here's the standard **FastAPI** *path operations* code.
-
-```Python hl_lines="32-37 40-43 46-53 56-62 65-68 71-79"
-{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
-```
-
-### About `def` vs `async def`
-
-The same as with SQLAlchemy, we are not doing something like:
-
-```Python
-user = await models.User.select().first()
-```
-
-...but instead we are using:
-
-```Python
-user = models.User.select().first()
-```
-
-So, again, we should declare the *path operation functions* and the dependency without `async def`, just with a normal `def`, as:
-
-```Python hl_lines="2"
-# Something goes here
-def read_users(skip: int = 0, limit: int = 100):
- # Something goes here
-```
-
-## Testing Peewee with async
-
-This example includes an extra *path operation* that simulates a long processing request with `time.sleep(sleep_time)`.
-
-It will have the database connection open at the beginning and will just wait some seconds before replying back. And each new request will wait one second less.
-
-This will easily let you test that your app with Peewee and FastAPI is behaving correctly with all the stuff about threads.
-
-If you want to check how Peewee would break your app if used without modification, go the `sql_app/database.py` file and comment the line:
-
-```Python
-# db._state = PeeweeConnectionState()
-```
-
-And in the file `sql_app/main.py` file, comment the body of the `async` dependency `reset_db_state()` and replace it with a `pass`:
-
-```Python
-async def reset_db_state():
-# database.db._state._state.set(db_state_default.copy())
-# database.db._state.reset()
- pass
-```
-
-Then run your app with Uvicorn:
-
-<div class="termy">
-
-```console
-$ uvicorn sql_app.main:app --reload
-
-<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
-```
-
-</div>
-
-Open your browser at <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> and create a couple of users.
-
-Then open 10 tabs at <a href="http://127.0.0.1:8000/docs#/default/read_slow_users_slowusers__get" class="external-link" target="_blank">http://127.0.0.1:8000/docs#/default/read_slow_users_slowusers__get</a> at the same time.
-
-Go to the *path operation* "Get `/slowusers/`" in all of the tabs. Use the "Try it out" button and execute the request in each tab, one right after the other.
-
-The tabs will wait for a bit and then some of them will show `Internal Server Error`.
-
-### What happens
-
-The first tab will make your app create a connection to the database and wait for some seconds before replying back and closing the database connection.
-
-Then, for the request in the next tab, your app will wait for one second less, and so on.
-
-This means that it will end up finishing some of the last tabs' requests earlier than some of the previous ones.
-
-Then one the last requests that wait less seconds will try to open a database connection, but as one of those previous requests for the other tabs will probably be handled in the same thread as the first one, it will have the same database connection that is already open, and Peewee will throw an error and you will see it in the terminal, and the response will have an `Internal Server Error`.
-
-This will probably happen for more than one of those tabs.
-
-If you had multiple clients talking to your app exactly at the same time, this is what could happen.
-
-And as your app starts to handle more and more clients at the same time, the waiting time in a single request needs to be shorter and shorter to trigger the error.
-
-### Fix Peewee with FastAPI
-
-Now go back to the file `sql_app/database.py`, and uncomment the line:
-
-```Python
-db._state = PeeweeConnectionState()
-```
-
-And in the file `sql_app/main.py` file, uncomment the body of the `async` dependency `reset_db_state()`:
-
-```Python
-async def reset_db_state():
- database.db._state._state.set(db_state_default.copy())
- database.db._state.reset()
-```
-
-Terminate your running app and start it again.
-
-Repeat the same process with the 10 tabs. This time all of them will wait and you will get all the results without errors.
-
-...You fixed it!
-
-## Review all the files
-
- Remember you should have a directory named `my_super_project` (or however you want) that contains a sub-directory called `sql_app`.
-
-`sql_app` should have the following files:
-
-* `sql_app/__init__.py`: is an empty file.
-
-* `sql_app/database.py`:
-
-```Python
-{!../../docs_src/sql_databases_peewee/sql_app/database.py!}
-```
-
-* `sql_app/models.py`:
-
-```Python
-{!../../docs_src/sql_databases_peewee/sql_app/models.py!}
-```
-
-* `sql_app/schemas.py`:
-
-```Python
-{!../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
-```
-
-* `sql_app/crud.py`:
-
-```Python
-{!../../docs_src/sql_databases_peewee/sql_app/crud.py!}
-```
-
-* `sql_app/main.py`:
-
-```Python
-{!../../docs_src/sql_databases_peewee/sql_app/main.py!}
-```
-
-## Technical Details
-
-/// warning
-
-These are very technical details that you probably don't need.
-
-///
-
-### The problem
-
-Peewee uses <a href="https://docs.python.org/3/library/threading.html#thread-local-data" class="external-link" target="_blank">`threading.local`</a> by default to store it's database "state" data (connection, transactions, etc).
-
-`threading.local` creates a value exclusive to the current thread, but an async framework would run all the code (e.g. for each request) in the same thread, and possibly not in order.
-
-On top of that, an async framework could run some sync code in a threadpool (using `asyncio.run_in_executor`), but belonging to the same request.
-
-This means that, with Peewee's current implementation, multiple tasks could be using the same `threading.local` variable and end up sharing the same connection and data (that they shouldn't), and at the same time, if they execute sync I/O-blocking code in a threadpool (as with normal `def` functions in FastAPI, in *path operations* and dependencies), that code won't have access to the database state variables, even while it's part of the same request and it should be able to get access to the same database state.
-
-### Context variables
-
-Python 3.7 has <a href="https://docs.python.org/3/library/contextvars.html" class="external-link" target="_blank">`contextvars`</a> that can create a local variable very similar to `threading.local`, but also supporting these async features.
-
-There are several things to keep in mind.
-
-The `ContextVar` has to be created at the top of the module, like:
-
-```Python
-some_var = ContextVar("some_var", default="default value")
-```
-
-To set a value used in the current "context" (e.g. for the current request) use:
-
-```Python
-some_var.set("new value")
-```
-
-To get a value anywhere inside of the context (e.g. in any part handling the current request) use:
-
-```Python
-some_var.get()
-```
-
-### Set context variables in the `async` dependency `reset_db_state()`
-
-If some part of the async code sets the value with `some_var.set("updated in function")` (e.g. like the `async` dependency), the rest of the code in it and the code that goes after (including code inside of `async` functions called with `await`) will see that new value.
-
-So, in our case, if we set the Peewee state variable (with a default `dict`) in the `async` dependency, all the rest of the internal code in our app will see this value and will be able to reuse it for the whole request.
-
-And the context variable would be set again for the next request, even if they are concurrent.
-
-### Set database state in the dependency `get_db()`
-
-As `get_db()` is a normal `def` function, **FastAPI** will make it run in a threadpool, with a *copy* of the "context", holding the same value for the context variable (the `dict` with the reset database state). Then it can add database state to that `dict`, like the connection, etc.
-
-But if the value of the context variable (the default `dict`) was set in that normal `def` function, it would create a new value that would stay only in that thread of the threadpool, and the rest of the code (like the *path operation functions*) wouldn't have access to it. In `get_db()` we can only set values in the `dict`, but not the entire `dict` itself.
-
-So, we need to have the `async` dependency `reset_db_state()` to set the `dict` in the context variable. That way, all the code has access to the same `dict` for the database state for a single request.
-
-### Connect and disconnect in the dependency `get_db()`
-
-Then the next question would be, why not just connect and disconnect the database in the `async` dependency itself, instead of in `get_db()`?
-
-The `async` dependency has to be `async` for the context variable to be preserved for the rest of the request, but creating and closing the database connection is potentially blocking, so it could degrade performance if it was there.
-
-So we also need the normal `def` dependency `get_db()`.
diff --git a/docs/en/docs/how-to/testing-database.md b/docs/en/docs/how-to/testing-database.md
new file mode 100644
index 000000000..d0ed15bca
--- /dev/null
+++ b/docs/en/docs/how-to/testing-database.md
@@ -0,0 +1,7 @@
+# Testing a Database
+
+You can study about databases, SQL, and SQLModel in the <a href="https://sqlmodel.tiangolo.com/" class="external-link" target="_blank">SQLModel docs</a>. 🤓
+
+There's a mini <a href="https://sqlmodel.tiangolo.com/tutorial/fastapi/" class="external-link" target="_blank">tutorial on using SQLModel with FastAPI</a>. ✨
+
+That tutorial includes a section about <a href="https://sqlmodel.tiangolo.com/tutorial/fastapi/tests/" class="external-link" target="_blank">testing SQL databases</a>. 😎
diff --git a/docs/en/docs/img/tutorial/sql-databases/image01.png b/docs/en/docs/img/tutorial/sql-databases/image01.png
index 8e575abd65aaf37a33fed5bdae4029955dffb090..bfcdb57a0743c5fdcd453007987a19d878af1f1a 100644
GIT binary patch
literal 69755
zcmd?Qbx@p5)F(<p2ni6#;7&5QyKBPW7Th7|;O<U%fx!a=cXxN4BxrDVcXyXzhrIjM
z?zgpD_ufD5R&DLnRP{_hr@K#|K7IN*zjHd|i@d};6hagP1cY}|k{~4n1jL^R2(NhF
zyoA?CjRCpf#S2FziO&e-L&UoX2p<rnK%Z3HQV$l*HI%`3!YBOm22$VOcUGc6{FJ`D
z!chcpt4uVjmd&YYC-9xwmQ3#LRLGO?AMVUl%}tGJmECKV$?U7yzu;aFc@_GtuN{en
zfr{a+6pUHJSXCbB<;`R3PF!m0dFnlAE14PN+8te@U>pGF0pX`*X=P>QDZgV%4d(NI
zzpK|T2><>-dS&)pBH+HyeDPdri1@vJF2BC`mmsr#VPRp}=bn+9yWvRU&B*gJ1kR1E
zt))i$0Eo>(qawE`xd`HOt$=!5djI6$2(f@9((`{k$4RnWOgubwS7ded>Eh{s8=o|H
z#J>4ER5I#Ij%PXq)c@Ko!-s!6s{A?a`j-OX4v&CfHgQovP>>bz-81RWm;b9aehB|}
z6P#S?BGjT>XOnhzQRjnA@r0CjoSO4VQae_iSOBvc&JND@2a`Gc^Bp-gR|0<o<MQ74
zs>PI(%Z*QUqja!G<G0MEygQoOwJz#aj*5dz+K<#eS%C4=yaV&zue=d$q`+aVEvI}E
z*`T|74mNQK@L^MWZF40>-tE5OpxoWi`+~a9-Ac=W@RlN2Gz<*k;o(*T>G02+k&3!;
z-+z{xi6+msFLxJ>1|*;GjvZG=e?u+?8C6I14Gh1Y=g$jikNe*-y@EH_!zn?CAl;cx
zXdhz-EH)E4-$jk!9gN(KvjYU_<%9`2<@3!Zo@U^bnTsNRK5~m;9+?#vI!9BBg`SES
zdyh1HmJ0g{!<#C}VBb#05my{I<w&+2)~e;6(oUI2!}*}D`0Kl?+TE{(jD6uPj%zw9
z`Ncy*xJ=|dXjfINnVloPWDvR{eiWl!_P*ieNu^H4L7Au)w=1oQaSt0<3${nelIhOA
zR7nXGCsg>dCS%ojOs+SF%~{Rm*C}L!*$`(^!Ez>VKIcz-e6FY4c6!g|Z;L!ag$rk$
z1F9<y9Q+tAs0aaWM)QHiRY$d!Iz_5b<Ni~V%MR5>JWX6ePK;1fa*E1!^}Rdq(+c$^
z#}_gI02jNSb`|gb>|%@g@^$@V?$R+9d{%QArf4Ip`(S2)wBain)0Kkl_6wurf?QL)
zChNYnnj}sxsRHkYP4cJ&;_1TUP=F+b(*987QJc5Ks|!a~?^~W2))HTBrQxPyF~P#8
z@=xV~Po1kmN_{eNeJr(mYpcR?luxTVT9=LHTdZe`icF?+c%?zV_Su{^@T1Tv6~@<a
zNSbG^6IrS_z&(Sq)`yQMC>ik8_(CrVSC1l}=}hwi!SQA}?oB0gDdV8(&Y!*Gb8E_$
z?E2?BekDk81j%?iR8<t#QUnbtVYSPXzf*9K9Pe+Np2m6_L7Hw{ble%XEBh3055^ax
zRlJ$D)%%xQKL#vbyAj0EWa!FI@y<EDxj2L=|5*gMhL*%pYO&0E>*9TqD%;RK^66Ii
zYg8&QYV9~A0iFieLx}S(q%+=3RYMe3Z4;{>4U+1(`#y`VCFg&L(@KxSb-drp8r(O9
zwtd}QGP~8+9b;q?s#-eqB5EL2BF$T#Z8*Nxy)W-d_^x@)tz+@P)xln~cX9wDn;+_=
zB_vEcUYTq|EQ%RA<ZriKJ`LL?Y@e9y51Q_kPTxo`=9&OO%g5!KZV70~eOhP1%Yx7h
zTaVNjN&r-!Z2KwJf$lm+*2%E&gQv{5P}xE7jLPE|qKG3akV^Hr%EpAFJz09_o+I$q
zt@=TaKwoG5hj@BW9(Qbw&@3M7njPrp<V&C)bJ0j;Hz&b8N*GrvL?d2ldl~`gp@khR
z54Z1r)5tHKM1Oqrthb)`bh=*3nP(ERVqs7#2t{vK8)k6Ws-s_(Yj>-X#;tdpyf0xk
zhUG<%v)Ak|4mJEpe7|V|-ZBr7c3?w=pbeG|6dz|xH91*L-`=EpfDQYTG&S%sH#d!O
z0nu#iGEx)2evf5F#~IW9&X^`oHyeJBL)Mz?)Ku#g%SC(j2a3hfiTAqsO+R;tE*}!%
z7d3~ghEt?lWBi%LTDJRQc9~j`>{sS}5l10F90j$!AhF=Ng^gN-G96cH=mr0S9oRn-
z4J2xX7Q%6D+((#3Ytlq^6m<t|Pq&FfsRmyY!o;7=g6=0j8$SUC4yD1pH>x*-L}zzG
zy#|6R<bNux@4XZr9se+^-IT(X-^ik&-GEH;OiVzzjEsr^`*&y&ma?P?acvYe=MnGF
znn1;4n2Z4Pi9I$T8yi=t>vnUT0KHU&hxOMT8VWjk6qyR4<C1o2da5;^L_z{gz}uI)
z1D&~iL>U>E6xR;4ygX9DDo#{IE_!n9r4+~s<<LQblY^(rCca<Jfhi%0dtGTl2ALiP
z#~ICL!+MX7rV+4rz_F?2Rz<O*;`0V%_*Bdaw2r7gNBfRMISTG&1eXp;ju8@OZW^d}
z5KT8IN|BIaUI_@#yWJ{*G{mq6Fq-fmqZ`!MD`YmvF4mD3Ev%GiGxDiH|D-;0a+GOp
zsPvF6`dU2nRbi^-RjcTaf9@|9_DW!9$*>uw&O5LQjqls&iS4IqmZWmoN|PITuP7zn
z2PvBs)!{?mwVG3y`!(HFoDt^avW@Js?NGfJ{v(k|*z)VdVmC!)#kygVq2|jLGC0!+
zZo0KPex@KLWFqshw4=$5<u~rVOhP!p8PKv)5AdYx1B0H&jH2eP_U&QHYL{NScmzo}
zK#GKKerj%KWO8y|*zTao`FwiOD}5p?C!k_8ie&m{sRbfmB4n>E<V4fnoB*Kza~mrT
zzF_Y{YV#<?4(338*kY7g!0w;lWpX#)qQMoUORUes_2?_GxUQ>nB!7?U_t+Y;^d2?#
zRrTtTY<b`5gPsyOP*>@b;@jv=qO>6V_XLu@nhy`b^do}<EFT-Pm$OSZ9IWOxXE=bE
z+OD_WTH8K0_2U&=R)xCXueQ==>|G@n^0Y6E`xPEbT_`AotsYcS2}-(;(cl8G)|%Jo
zmXE{nh8;{+_6DEQRu`bug}w@xG+dk=?FWy{uwGV3D2kDKUOsfStX75CYqE)TReiQ3
z;s<jd{~`~%b;VIz=G_XO_2t(qh~o8{Z_Jv9KqOb74$IS`NY2CAjoy@{nR{t74bWiz
zVHt-DE3vV-;IydJ?S1WGe=E(1WX|=8LAfebq6vFnsu3P$wSXB7=VES=1mn#ObL&Bd
zvVlf(-flIue2^G#kvj+&#)SJ?g+k#w4kt%`R#TocvQL!&d(8*x8c68?Luoi|P4C3e
zSYqwjK=@b?T~S?^(uOWhX8&1~FzsVz@G5cuNfeofL(>mPBRZ4(({!MONnnp*7zB-q
zFNH9Mi}rT6EfkBTO-Gg_HP`=jQ;%3ZRPIRNpEKbFJkKvupdU{v(M2EGR`AuHnz+9o
zCGE2<ic}qJ_r61F#vF@#56EDqip*14Sp1TZ6!%mK+bfAqzVMi3g3EbCzV;5G><`9#
zlfmGs7QK9-DpGZ>nWoakpiwX}HKS(z479!J@Y~MfKG!jN>}0BpS_#ToEc|Pj6A*Re
zihl>g3wx<+p%74=ht`7s*jn>Dy8(&}aKBDS6{M_~`>3-yUqRcfoU4~!kDa1+sTWNi
zi&bT@X6I}l9^t7pjGR=Zm?Ri9d*SXHWRhN`iYFe6bqfAWa7uFD%0CqHw6T^DY{=+=
zei3t47?Af7Ae9;v!ICpJFt47GcpL8CkYK;J`8aQr8}vkbeP)l(X_T$47|f)m5>H4p
zDiT~-5@uA!C{NPUy-ix-mc#3Lc`AQ@L?(GS^fU-OGnWeSk1lBP|5#)jB)D{<B9V`a
zW$mVNcd<+jThNTQe}~t)c<t$V>O>7YooVgAMfbl-yBfgp`L6RrOhBT@To{q=Pp_cf
zm&5S9Tkv?@xUMYJtHJeadG}~_0OD>;%w{x&21{cP-+gre^>0%uCyf>GXj+dw%l7+I
zkIS7qZ?LZE=f32Blz>1-BlV)**g@#?&aX8nd!YJkGSiKdLFTsVVIA6Or2lw6Kkv-<
zDs-KT5oV!%c%c)<w>wr3WfUfS3SBHm0(@K@M*V(qdHxlGkMYz#%ukQqQ1K6^1!GhK
zJ8KbdY?*;~uwe!1q8xwX#JRs3smEE=euy+VQScB|UeW5u;LkM{O9DMLc6+Pi1;J4z
z|0sa+>xH~MZZ0a>OHLhgrQY#+uIZ^&g~WwLd|Hb2lu%geFRF;1s|}D^L@sjE7&`bm
z)3jH{w%y^am;ve~@4s0r?Ru1L(j?%ulwUx7L(lNh!LI6LQ`x8b;O3lQEoMFHOh%HW
zvr9*|?;UlvQ22L=c$Ri1+;QE`#hb2#9MUNMbfp^ZoQsv&9ffR^>Kk#<138BN9|`1Z
zOK5*es@8)1?F`9Mko2bf^NE2r4NOz0t)=h-A0{+0e%F!Uv;C~rHnn>MW@0l(oCPJ6
zU&Z$XsaRGb<X?B0uYwiQL(2wA31_RwBExTPy{|2>TBU+vt~96a)!5Egga`A3S+U<g
zUe+AcLM*dZcX2X`4KYdu7i@bx>p{kgzI_sD6Bis0KSy^gTwh(KaMo+PFV*g8=|72U
zn9ZDv5p_O3HnW02FOPq<QEoG-gy%qne6@FlRWz>c>eGeFMkRjX6Fdcm9A?3UdVHZ@
zhLPPBU_2)qQOWat*~4B0x~F`5Gh25V2tHfe%tI<9AEJ01Db{4$?k5YgmJSh#)zZ9q
z3gE)_?GJolyqrvS+D`wIHb+zg%$5bxE&sqhYJFc<({5x*!?@sZv=r}HS6|FUjK28g
zl+U}f`N9L80w@!^<Q59|w|`pZaU$<Ld^gIPoC?Hh9DaCcA;4*vLVD!}5z?_Q+zWBu
zRhJiQUtemVTcmoe@42+`vvKIge%v_NqNHjtnV`{g_sqHqhky?@F`GzmzTi%Aik`Y9
z_oI-{w{@<zA+JZ<7MW{-Jetgb_0GL7;o|DLlqTTxU|QcHt2m5YfZ{Xj#Ib6N7>D`l
zYV{t`0RQ}BAgkx)PI`2b_rA@eK_k-5#gXE%V{1QkmdWsM@-glPH^ov`f!OGB?F-#!
z@3^*5jW|>F?J4i)5V1{dy#xSk5;y;=PS4#u>6~_4%=!Ad@kE0IvYeiHok<@^SC_;>
z@Xc_q{oMks6u4%PGL6p#Gevtw^J$ZB)8N<Wa6vPr_r1Hi+#7aMn0Hsfkm^EQ;Tw#1
z^e3optBg_1Ir4n%hhHP|GP>G@bYXKEM&fr^(RysP3df|IVB221?PEw`9M}vCF@<~a
zD(jvA0b#{?+~I{*-gnA8SC3u35h`3IMRx>~R@~#cs>W48el2H1nlg($?rU?>(er<-
zf4*0(SMBYPCzUzi`cox-jkM0|uBuEy=Dss%aX!2T3lJ>kRGBzfqlpwE%SXe%JYzyv
zwf8ZNFWt(|F4$H0J@lmJNMZ);Sv3-Tx?3ZKv!|`?-2CimiSZ@}m?Ou+74F@jpgQ-$
zEq_tS^=0m)YM4VUoz0kQ5KkEnTl~MCqn1`bl9|}fmaC|KbAsK$TwDJ=mxV}B(d?b}
zqqwLZ-gWsm<<&T>jx&g@u-A2FN<#&hJIbc~h_qa-Vop*~3|Gm!Yscb|2uEycXYEU{
zK3Z%PA#4nX9Xo+bwrK(qd!8G+73I3hX*e8oxi{LT9(D9TxZCQ4Rp{u!<G(=0Mw5Rg
zyQ)}6n?i#(Wik4bMm0U*jzFK%Kf?4<(~7aeIB7^hU?8hY9XHWJ+4y{-8ys|Tv#wji
zjYR3otqdz*3X<r|Gu_yrCv4FPayy}T%J|JJV4F2n$ev?M8rJR}4w3v|f3USU?OD0}
zL7)4So{=%ZXWz>T@sViL!o|KYyJG1(hHW-7GD_Pv^L?Q$)<T>HPELw(A(c95&gEYX
z6bYOn$#evAl`YxP)Wd>j+7f$RmwdPTh355+G2JZO4V~-^olaJDf$C5UVVGUaync9A
z()4Ge;s|Ep>&cNh8QzIp4}9WeVHaQvGV+w@8mqP9hy>z%Uo6QpcrzCTSMV^n(SK67
z%-exL03m~vz<{%Sq(BDRZ6uiws5(n}-apq56g-F0F%*<JP7-{@7A9@+dU`5!YP?qT
z-_)6Ji((R0X*=)jd}q1s#4Ft$WfA`nBT3Tia(*a$Fql;ylkY}@3LgrgauTkqY^ImC
zG6IB9->qHUp5g+qa+Ev0aN6dhz*aGnH|Jgn1n=4jvhWhG;+>ApcU)3Zfc>$7>_NxQ
z4=>d+ma>>ME$I04y0UNmz7fR|n)krjd!Xt;+_|RzxSrcF!Tj+v$cLaMTaxBKgwaB%
z&Pa^f3Z9Z22IYP!B$@|UTkH!?OnL6`0JGN~a%Xl%zOzGL_xve|WNvids~;2g(<PTs
z>W#aB+R3C)F;S>+9a=l-KlfNGRmLe|sT5mX3{Bv1Et@pV3U5z1Q5WaJ<afL0b-Qny
z^zA^-&>t+FDISs?qH?gxO!VNUdL1m}tA=_?y!}|~(kzEaEhl{2fPtZscbNFSB*|8x
z{*Hd~8Ito$ubV>9<*%p1?&1`d6Yyjy?H&xIn>_cy=vs$VHr9r3)aE*A=9}F>)o&&b
zd2!vZTnx%hxlA!zG&Hqb*Vjiz_J&<tE-qcMIcDMyW`>tfMZ8p@J?oX{w6S1ko6e%=
zh0csy-D~lCeKIg$=|n+qn+nyuL;$Gv1y1S{hZH4w<M37&i|w<0b}7??TF#H6{xTS4
zO+bHeVuT(MY#10!lKKHF8;&m?*n=!UtDPr=nn@6dA=8p{G43geR~w0*lVClpeUdb%
zPztR~$n!78XDtC=g?eXKEakQH6?$l`fq4A&N_jST7o!6>j!g(eW%do*87VeN%<<Ls
zow2e4cP~u#n^<LDpIWbO#!eB=7EO}%Twh*#cT6ozBz~+b7Ky(AU);`z43q7G=WPG6
zt$S^zT*O;3huuhLGyWUL9#+1U42(N(>@u>F!oqVXn~QzvUJrXDGJ7iA7=dPV_~)o5
z@e6H8kA)M|k+GmZuWOlJ$-9vaLGxPA6Mu{G0SotoL8Gd;W4E!YFrno5n~IT{zQ7HR
z>XEYj&r$-rDI{TShzZDn!}?^3tkh+S-NCvL49gW+f!!G~vKw_@uB_gUdAaw5n%3{$
zyX%~s@&K!o1;QaTchY8;xYjbvPvy)l>E%n03{h07gT@65X!5D7$9WRZ%OgTRuBFWb
z>9s#Aru0#}tj8gmmDjo*-fTAvR>UII@*J`lScdAeE^M06kF&<>olli(9_jC+i=ECi
zt?LpVn5n_-V1Mb=Qs4CT=J5Dd6Z(<1_2xS{tsSv?OUb`V2CG{lFauVj+&F>Nm-VAk
z-$lqu_9+&-y$mtIi)s(ZS9t5x@Bs)6Sq`m3i7kT$cJ^Tt`uF~x>gbqmSlbft7Zn+a
z^tTPvZ^rlFX4<m12+}E{QNsclQE)U=I@>v49vut2WabpMAM`g4-uNgN=<*K-i5HmA
zO?1AY#7!e6N%Qi~%?(9IFIiGyygEFdOYFD5KCkBUsi$+N)<um-+TV#}dR`MhuE3n}
z-3#5nV6~qR4lb^^xHy-of`Y=Z+QRR@fb+=Re?ZXxKf=iz`hHCJ>uyt547xQDPln0D
z^7&<<lkIkYO&Nma!xo{2u1CWcmfzpTb=IM;Y<p??{k@J*8=ln)p>oRV1z+1nNRxpA
zDQyi3x1N#!?dJQ0`S~7(LLyO3_w!-P*E8m1#+D|OsW6`{$Ci_jz9XGj+bDWvM_$vZ
zY_Sfx1D>wsM;)32MoGCZ{it=}H8=hK;-ANaLSk&u)M@KLp97L|C<3}tOZlrQ*-Rnw
zmn%tJQHe=8lmT6H{oB<xJlYj5CDH@Qp^QVt%Dx+9vF1`TpXo=lqe)U<HBaE*cAtz1
zFh&E|%^}96KT>d*?xDmTfVr6aKrPLrl|$Ao^1+MC{=bu{1rBnMmw3ix$IlV4B*z5!
z(!5$qbMg9mxvtSct$rqtgJ};zQE|W8vRtZv_!Z?!UVGvn{{!Qki|RDMRO2|&<TU?o
zw%HB`04O@fBl3mCUj)+vskUb841s|T_wNS3zg6Sk(qO8kS#&AU5CiEbnf`Dlq0$xZ
za40IXn2#`2?TDkz5STB+EzdA&Gm<YbCy}lITkM*zHWMX(TrY!jQn#e*$<oLY*Xt*9
zrV_XLVK>=49@SbU_&9-U81HYC!&;Ud$?P%>O@4UDD<)w<kyW($ECj;JP5QOCJtK<}
z$oBPa{v0A{X1k$M>XSJlMpek5D<&8LX?*x)6E0B269$1y_x$nu2sCP^R7g<&Ou?qf
z-eVX;5Db}L460Bu`>{#=gYc4-3MlW29ONLQOl0GXi|;_-e!59rEI{J>^FvrtT9dmu
zWs%bQM?-W#&%k7(rNQpwXCSbeV~-gKln1jOYXXuBp7q-=xhycJ@S<IsW&8(?Xo;y?
zcIXmvdgpiSyv-NQ4&=e)Yx~%FS_VZ|Qf^25iXc$#WKp=AG$SCPgC#BkONRsyt>!FP
zx}p&(-bG0_`2{)W3<K%4j=?Q`5WSKm&bx$ep2RYeFLozK;{m=qeEdnT-f<d)It^oN
z+f#a_wf=xe{#<7pJUe_|dl8~3h8J3KTEJM8v_{Zt9sgok#VYJzalOw#Q6@mNw04zZ
zj`9!t1GGjUVtH&-*PY(C?HseP{m9br!R16Mjr;n*SU;7jS!FU6EA<2mRS+5=&J5>e
z`HtA6{b6$w<G#3xmczloc*HeYJI7XGO`SCGBfz}&j4d)&aoij4nT3&d4hhuYBOmFc
z*tQp<psgTp{K?H8I2hQcsK@-(W8N+VA}wP}@dKc^6q~K_aa_6c^x(H~7i~sih-3=k
z<wZ;3-F#w3+@2&&CHDKc_|#B(^1AwLZcR0(rY{n?ZBHOECB&BP1l6mRtg}y}=K!US
z8ubMlMa*dbpYolQ?~<IkocfrWQ!B{FOay5>7+4Q(e<S=oJ1S~S6aA;+mxed4E;a#h
zToN3K?d?blzIsP;>h>5cDIN;>0V2V#sVyK2Hs7#V>NOxqZ3Hb2;BNL!AO87b8A1`{
z`0^Dfx!Fj&IT<aa|H-c4GthKt&uDDhYPHz%bxDMz8Rhpt)8S!8Wqg9y5nQIlk(2Sd
z?Rp}>^`mYaqJ!qJR9Nr5T}mVb6#rWck$?@8;VjNpAjw@;#@LF5Ju`qrQE%Lr`L7U3
z?VOr%eWyYgY++=z2fFM9RLQU*lmx~<hn2n?VMNRvzNrJHO_e0i#0UUI0|NtNV`HPM
zi;D{{@3CBQO<6PyOWtRb{FB~Y?q%)WL<O&B=sV>3kAGu<Kj}v$P@j=d1QE+`xPPVN
zxApD+@=)LZhBNB_s3D%i#hkj@+!tXfbU?#9Z*Pwz;i$vYy#bkfZjxrq^q7i~Hy~UX
zy${M69;awp)_zcVdl3*w4z=~UpGa^{dseRzwYqAAM+=qJ79mYXE@fqyd|7X_;JB;Q
z--koBB?u%wFljN5c(*}qj-^G(4YP@CB%06Da(dp%27sGIfA^)t_~*#ES=5}epPEn{
zeZRic>&Ohwk(^D`H!b*OW~VjJSphrK>43o?`TxiT5cGtYZ4D&dG35r<79f<Bdzk!W
z@!)|1ffPDL!RLP)4A0eBs+Vef0uc}p^d~S+yYe!Aih7|%;Cs|tZ={~Be1;=X6`*}A
z#SV_3{DjC~vbl=qlGcg|NQqa>q#&;fu(W+TwUr~IVN~e*H&&=$=ejkDgBXQ*DiBYm
zFQ^6r_2tS?W2C*q@J+o^$)XZBTbiA8?fh}w(<EI?$Y^6r+VJo#6@p)(Dxv;bWzj>!
z&R}(8aFq~<sc`4gV>o<QJPs;NyO}I1{<EE0gNitW`SxYIK&!=9EN|^+>6H!p!p<{r
z=+(kW1(P9ar5eAs&xP*~*uC*44=!-v?t?Z|!-Gdr^^{AP_ThKKC`N3zvmr#~^6=qy
zwR3wB5c+U)f_l1|m1SG;;M3mIA3xiRp<83<TzPO?+0{4D2r;q;d~^+{_u*YY8SHx=
z@xXea(f;;q)2KU~*XMx;AeYKxzdM%aCFDDrEq2FL=DtfS(nC6HR|^yj(+T$F$;-e|
z!1X!n&005izK+Y7{}P=Z0mqN;?3xQ|IX3(1FIzs>Oq>RDm-?;;t0D%LkHb#a-)Q!3
zIR~#nAQZ53HMu=Qk<ZBFN;-Gua_$~mQiww6$w%h-p^u025qN8=6d3buv=i6+S-;iW
zh|~8=>nvZ|9BMUkM?!jQm)BI+b={1QZi*3~tzfM@5x335#kc~seCka<GxX%v3&>}`
z*7?s{ETP8>WkkdPBvjm;mY=4%2?%BA{LYj`UQKA@KJ-(sZ&NS<w|6dC80y5*MNJh{
zr_-W<O~+xTW3OhOpYf1h!-ZnXYS;Mm!Q6)ta&<Q3*IKhY&GU(rszYK#8cwHIc8tCx
z%+yisdLR&2hcM~($B)@V=lRQTbiL)|a?zjwInn#JGn}_&3p#@}19bVr1niy|>aMa@
zaIQu8>rDFN&n~<+dI6*rz>AaH2P|rN*)%>*8X5>>&OT^L!fz_Kt5fxYKI{(tnzL+S
zs4<dc%gqdI7?D<!-7yZ|D~pS{bgG+a-^xjk#KG)gQaE^|<!^}R?TCW=H%yjg%j@L6
zntY__qXvrkfBrN<JgoKnLSvRtZ#9dFjm=>_SL=O$rJA?x;3f3b8%=)Pes6O>G~$uu
zKh)n_<Yr>MTy*C_FqM{vMme?PFR##F=*ALyFtgSWHAx~Ho1P@UahH8=vIIL^sTzSh
z#_({BwDP{Fb6ULRvpy9rN0RV=`}WOrD7DFQnh8Bv*%g^I%5~-E3m^L6VcqM&EJ
zP@k0^d_1*cI#K$LiNpt!a8R8sP$jP2*u*4a&HPuGkOE)xo^1+!0+<U^TMG1AfG)1U
z#IVcsc?2$>$IEG6$E|@h{_BDapJHyogmpU}WOQN{F0OQTaAZ=_Y-b3TcKv{9K@`Fu
z7F!&vW}edfkP;z9TI{;*fCw}Y$N{)EJ9NK$uW4o5udK6JUjP);j?ijy4pF~tc4j34
zKOHta++mD<F~4jm&K|qFe%3a(Hc5&YGM}5(oG2lW-E?Af@cq@HpvT2`NeV_Kt*|i}
z)ZnDLe<VMFenh910q2XEB6B6o>kw=6$~dDo2!V2XO7Y3WL|Qb>FQUlQI>G6OkW;<5
z5+QncY+T^<pCUqD1;vwAMy)udNzrFpcA`bZX59PzqbOk$dvJ$lqn!b}dM=rcU}`LQ
z|46IKA$9F4aHRM(npkJm2w(q<ria`752#X528QpFOSI4GJo6MBM6e!TN|9oI)2PZ#
z5_5M8a_H;QC!efy{hsK|5H+1#TX|CaXZK+w*1(}2Pown92gkp=N*TT~xNgYk)hI$K
zQXnMmY3AhzCuw0%X;glPjaHp6k0A>nkU&pEzWZY{)8|hV7>~=;`{$<b>Tz%=(&wPU
zJc@E4wVc*v-(TPC)2zz~VoD$!)#si*=V|*UF+PshQ{<=lN>Y)s@}Q8_?VPp;ewi{W
zfmQ|@p)knA>ip9squgmjt^^*&K`5?dpM)EMxXSF$vc{(S;F<~T&Kb8`7w=86{AZ2M
z<Q(lm;{dGl8lBRZ-&%?-1j^}q*Ikt8_9*emWz1Go%ZaPj=>!>1NR&|VvB6FE&G@{K
zezV1@dQ0DUO|MaR@rMdL#?N40t9W0rs5$|w>EFB=1F$s_v#Or8itTsxG{W8&`GFY>
zg7M-4(**2obVKEm0`>Nbzc=@}bd~O3d$Tm|y<$#Rcey+%pHU|9^_br-;XXj`i3o*r
zhj19-^O7Ta#Pv_|@z#CQ{2KyNR$x`wapUH)H*ZBnt*97TU~_Gw1-R<C$MU+u+c%~n
zC$7kE6+jSDws0qR?{?{LOWguBeh1Dvj^WfF-q|*!HFoPvlx{;b^{O%1oGI5kW+vRW
zru_iy{yn<56b_-tfx#Y&?P0oIz#s@f%l*dt;xbuP)LM>CKFdq(;kR<q9it{^$FkzU
z2?ReYx2D7s%)s)D5{)d`Iq{{n|J}a`BL%;I|L*PW?LOGu-7Tsh_?z?Q$MyFAWfGj<
z|5KLS{|ADbLDrqiO8!AshG%*HL|7KOW6aciS-Vv67h%jy$_#wgSOmX7(<FZ?V4A%8
z<zJxCPrY;1t{7ILFGrT?99OGleH%t4{MQ3*RpTK>5AIlXXiAm#V8{<abaFSGGUG5Y
zF(Hf)&lxqV(~=c??((O;a(Y~o4pUUm`l*|jP)5)Ct}9*hE@G{Cj$)BYR9JP?wuBhn
zn95vrzTm$d+u$=TD;x7GF65NhQwJHi3Fz^^9oZZohIb7oSI<jJve{%G9$NlRZT4IF
zndzUFg`k}F_$N2jxunVZ9Norv9VYdH@m+dR?o+f{wGu{pdj51W&c!}(qx*F}3Gs6q
zJ%u2FPww>s>11`CmE;-2+YXoY$vVpEjeASKB*o@L?5C-S;Q<MFN@8ZCWiC+em|m5`
z-hmlogwC3PkNf#Sra8gcD>`dUcfTnk0y*K!2&8|jZ+8T(xuyeD_U6)j9<^ZWm=Vog
zLo;V+?%({^%4@7%@3g#sZf?fJh@I(LpbtH{_|%^&6D7^Dch(OIg1^l9aWV4KUte7o
zZggH$R};!$rX(jdUfb;+&Wrly?dqd0wz)Ar+4rXwa=Mi<;ljI`%Qz@qAip0Ha{r-2
zFNmf1X{lyEYZY&JaYWg?>@zCT&edX*V!x$x6`Xbiw$M(h%FU;aheePOoj(2zr;f=(
zTNvY+C9MMZhzUor(J`~Yx?1sn^CQ1>gcW4aUyYh+<;G9F`Om8B2FMyIw6(=hR>tzi
z8`JtA(twVE?!|G}7Ue>P1u!>kXg^=Ni9YsrZ<ky)c|=0`MGubh-EW~s`Zsct{4%)X
zcBL((tBdluRj|8vWJNWoPg3F9!Kb7DHX{5Y;aa1?l=1pQoceFKGS}<<p(3x6ahl25
z=%xm4Fy-bh1cHwkETyI=%I6ew_D)ipf?m2U)q7pTC#%@Yx4cU-1!mNx=JFCTh(lV{
zCHLWKI7w=Fpogr=wQ$>MPguQ6r!mL6s-M33Ova3E{5<FMiqWNS>x|;Y_#Z7kpNkL5
z-s;cCN5#*v>h)kU+0}D*kki@4=8iB~(S%9Aa7zEGU9Hw3tfOESJux~Rw)H)lEh!wb
zM9g+3yMt5|XL3HVbTB9BH)ZYw%2gJK2MbMNlCwB+)e(Lb6wkglky1k^xO`Y}w<CK|
zG;vFN%S)GUq>eS6M1?Lm?xRT=ThjYgWcw6#FtB*7R-2a>rChT@9v!i?Te22e9otlA
zP>mhbsd0fBM&NwZ)+&GlFt2vhK6@K2^{dAgN2({1l)?O0ELT`|rT#Z%f`(gLUTzy-
z=e^0;d*63q9x-JUMpbDwPulEDM5c^xfha#PKL1X75s*sAD*oUf6>lsncr*J!aWj4*
zHsf{I>jOR3=D{aXxG-AjiUN5vhQnazql+i_K!@4}#kgXZL&4R(y_w~n@$O>fs>rV9
zwpq>U(+)&-cJ`=LzE2?KZh3rur_SB}Uug_^gYJOAyogsj4#~CTtUb);Ax?AhYV0m9
zt_L=I#?;Eqvo}|O?*i0rVi$+6&=WXPnYe7rc8?auElwb<Mg@Hg9&ZA3`}rJvkC|{1
za>fb!UsqJJ#+F1BuG}SPnt(bJk&kdZrKQ)ny7Z(*0rp5<(SGBQ(ByA?4+$%;($62>
z+SG|=JiuT$5(+&V(Y4$2GT*vgD{gciDXfl%u(DWrZwWEATP`zLHWx)a4Z2vxe$j8)
zhJG+#Np+3*?bCEaqx$J{(bL&sjmHTDJ8H;E*kh|ZM+GUQEbSi3nKS3lOkB?c51{zR
za+Bua79s(aWh}wVyT{OVWpE5H=S61(@U(LD1qqS!W)bz%{k5R<Q>Fsf{cIQ~(pzqM
z+r{QPnJy@dvwd72#zmISOSm@Gp!j#s>Fr1vS{#iFAS0*j5y{A?vQ|Zfh)(Rxb{{az
zCVqU8M35vQpN7A3ECGU-Zk`LdtfDXH%z|u`UnKJ^pm)Dy1Vn$PPKeE+jH1Wpxxgd%
z&a@BuY%CpoHd7+=2WkggcCVi)h8CR`Er1nNK|v(msdt^dq)W_`g`pMY;iC@tLAJeb
zUZDZrqBU-Iob%zMYB?MwL5%U_br|2@51u!aKT1txSu0X}h|o&&aP8@i)k~qCKZV2$
z`7~{asIb1}({csG{ZTs3n8i=|Qn@EQZc*#o%XFk!@v$gCv>_6yh~QQls6_cxZ8!*X
z<2-$32-qy>PM>YOyY*)#tf#SB=T7;I(mT;CVT=07U??`X#lRkG@0FSJL`4Bv%;Q0W
z2Nzu%-4U!>xJY88`L?64hxL%nsyj4t%GK>P2)o?|CNyeRaQ{p3=##Mb!FM}{=_!4q
z^IkttTF<LNqGKCb&@DH5>9Rd}ULvGZFn{RYxYc_viy4YR`(^2|ryzu#`xWoBrwaL|
zMCyb6eH=0h+e*?^BA=yCW}C>lS<eDlSdeEydef-+QV?apBnF1{ya$!oA96#!s}vlL
z7U4Oy=LA9bGm6RHnUSG<;EEn<3*Hk=2&CC{A6Um?yYWH6(V++JZEyUa$Ta@R>FENm
zbp&6i(YCxC0lUq>cRxpUrX+0+o1?NxGwm16n9GKRCh9W4z%_FeeTGfUxIWBV+09he
z;1093AGZ{^+9(v^Oq<u8Dc&vDjy3r0-G+@yapxLI_7bF*674!g+x;JammT`dAoGLe
zq&a1cZT9^8@OS#}xEpVloA!@Ol*t4cKJZJ8#w}83he`>!t-8{CgoXT2=SKF%xjO0H
ztvvnIE<TCA#oJnQR8zDV5h9ruUACbJyCsKqmi*~;zq-R&Popt-N;dH%6%=sVkX``?
z$m;Vj#KKlSy@>wl3M=012oHf^6TEF&o7>z9B7IBy{;pMcq1--!)K^$~^Qs{^OL@W3
z4gmmo>-KGee>VrZbP>&2Wc%29_hqzYpX=4k+cVpTR;xj#`NL03$t}X=(2u(HNBTnD
zdx?k{<ufD;$6=%6xb5EC<1HOemtvXrj}io&DspmX-;byD06q_0Hp0p=fu*{&?iC%r
zrY$V5TU$qvP4y2KjC;PHb=Px3QMbGre7;C1i66l3r&A7f)HodW;AmoI86-5)^MR-7
z!TD(13)wSeqPDb~48}q2dN2ZL;^n0t%GjNpZ@H83_V$)f6=pZ++^G_kNNsj%w>H_~
z!pXcX_dVXcyDo0ntJPN`#U;3T53uL$q%3xsCo2$;+jjyjtgX?bRxIz2S7|ecOcLe0
zEDm~Had;Z#9yD~B7kLbgob5wXhjH&-MHC&Yi5I-^&J_SsBg-s3swm;cy*DQnd(;Gh
z_HtJ)>A!_QRBkPRbn^0&l==zVJt!U#=`(GHzg533O3Ch3_G)lOXR7}+qkaK!CJ-*{
z$&y&@ippLy|2`cSd}wS=`yq+%AlUbTd||qwB1OWsfyo)g=VpJFChl^gsBIrc^@X`k
zDGNI^P!^Hw9I`9)wUQH{I8ishQN!|6UIb*A@#(Stk((j3)!T!4b~-lv6^LR7CeEF6
z!oaIoC;WobPGzvh%n+I(_|&s)J1HH(4xl|=jM!UgDHm9fL4I|?*Ld!6W`zd?7JP!a
zpaDiZD(@%2tC^7?(C_pB??JWTWp!jU(fv1Y?1ElUK<CgZH$l{vnyO%aUbBt+aWDXy
zN=wTmC;z9?)#p#Drn|>b-@wD;8rhMc=fq-`y6rL6_OL7=XZ_&cRdEiTNgV*I<d0ck
zixuIq8)g#(scU^N${TuFl=3l9o$<aK;DQ$d>0=8^FNR2d{jicCPII(0IKDGsVptQs
z?|HeqFq)$vZXwyvSf?2EPb|1YHLY9WvW(ja1^)#Apl~Aa!#otb>lyNzDa^HKvG{?a
z8etTOxt^>jUq+*X75&9ft7@@V))17dM2|AbOf=<mk?mfzf0g0>oy7Unc%m!T*jR99
zol+)9bzg<)4ZppR_6{dF9F;Rhga(uD{5&iKbb0)NjS>2)u399Gtj>KZtq()Guq7KJ
z`M9zHBcG1Nq4+=-k28Kk7$s`4Q<$tvEU-OG6mUnR);`G7<{`!gphXFts9u?57o|fc
zKl?+CiS_oM{BG6t6dpBL%V{_Ws6-bE8R>#Mi-*#;XihGXtvOAzp2y)>Z*JI^3DjYu
zIk`XZh!d%YiTIsB@-8l-yG=S3OG{Aw2czGRQ7nl_Uia11q|Q<TrtICiB7`z2{@axs
zO2%Ng6A{(JY3!y0)LpwQpcG2WwViWYl!LfsegvlLN<i&NZgPFRc%g}`yU^~cg4nCo
z;^2?h1VA7Xj=-c67+rn1CNQ+6XV~<O$58S_+i37fxR^MI&i}evP9M!vQKI5S#Z=c@
z5Xmc$MP93j9L0z1H34_~&8q}-%R_$OoMS6Z2Nl_aMPd1jrVM+N{n1}OpO)gzdx{F=
zgK7C9(%CZQjU+mBJg&ZSAqN{{5Z((w=xs?Blg7>iXeaSb-$Udg^2l*v*eXUQ7@L#F
zQ!sho`y=51KFp${@(iEKsmm!(6_S^V$jbJr-_+G!8AcaXjo4hMr}RwU3~I&dJc?u$
zt!RGQBxB*|LP1hBh5L<uSKmaH%q1K{imD5FsJWT>wxV5`8%8W$>$DgF1WEW(R)h!t
zEZucHrEhJ)e0IIAxfk@jFt5`E<zHuzaC=Q$4GJ^qHf0kq<?Pm#As5*-l7u6XgukK+
z@-lkS(CQ+;dz*`@E+aYd%eL(vS-4SN>#4hyjL(&GoYqFL-AS)UQPA@OOdG{|&@^Y=
zZBd|@!7n$r!P<xyg{`oDw0{XWs;&Y5Mv+BUI0FOt+=m34-$Eu7p&9NPx4D=mV~?@-
z9ZLERxtT2mDSndP%r^sAoY8!%GjTLH(b0|=2?^*W@{L&Z^i=*6OP(4l4`MGC-9Vu)
zo3b6Ox*lT-VvvqHs5y>~exYP9DKFdmRC_<>D_5~0Dcb+)IB!ueM^%*Mn@o;67AjQV
zy<DMZ0|K4JXCf;i#c3sVzvN=h&LjgA6@UNv&Ld~8xJlfqlx4P4D2{oxw@7~7oy0E&
z0(JcXbJ++H=zHd++q4Vr%AdsP0D+s2-zz^izywF2&*~i(nVU91a%kQC`tJVXipL#(
ze`k_EOZ}LFB7bueM`+M@RCzqULW>|H>1+&s0Vsl$RH1r&UfRRPl6~ZI-HsOn+Inx*
zYy@4!b#eKP9<CM*jB5Mt_BcJpR{kQG##4La*8&rwM2hw$N8Q&#S;ZJn`t_m6A3RC+
zVP&f75~q*k)TGh<;iujjc}zyju05_{e0L|m{y?Eb42LvygZ)FyRMqGgiCZ$QcqFu>
zTqb)-GmocHE?xppm5?7u7Qjyp=E|>=+MQ;ygM+86BDm`uD|d~>-4#eF%^(M<X>=_(
z#@h-(y>iIRXW*7M5sNp&Fmm3er-TgQ#pJS$q`9U>B!(wLuZ%g}_uquZ)#VoJoNp!W
zIaK=gC%}89M?lP*hzz&Q?Me1yNs2Wa+rgW!C)e;ablU`G;dA^IFSlV~Auj>%#ZZq(
z3x+={P)6n(`+H&2N0HoBS5lVE9KQXvxA#ye(0hI=Pv!~`9X)xndH&kq5{`|SfqAgK
zPQ@?Z;fdPB3D3^UE@VlTSlslwMCOch&Q@D%m8q4f(Z}_<VqG5{vNqgF9E(}|)@7+$
zxL3t@ycvkt%V3|j;ONRr9%D;WlOSf2_^?7ia8kTxf2j~6szW;ceU<1fkLszWu2QnT
zbofUjixG<G=Bdr;IA4pw1+o|~bsLQ}_3dL=@=O`~bm||<V@ho(zJaV1weUN>WRa_y
z24BvlWI9}{CD*&H41(&Hbw7J2#{SG&_U<(F@SzsX@r|rQ3ky86Rz{Q3n01hwVFr^J
z3P-&5ltLdlCCb0VMi(s-Jr)e5tXWcj04jCaq_u2?o1Nv8b<el4{DMOzBHE{mb7}ec
zRO{VnfRp_v-|H0_gDLd*$JbXDr(-*9g@^aV%UCFZFa7=ct*cE#|2uGLR{W)t_IV6K
znR~6#Q3AF5I=5BYLS97h(8KxDJFTa}p6Yk~`ZKZ52$glOtEFqZ6Iq6TdWE&04KgFK
z_4{G>tD&}<OI@+p_fa<oKi_!cJ%fTH-{z*|{(=8MK=26qH~7hUa?5P1v~oV@Mz%-)
z@10FQ!UGa(z2+!qa0zZv9;ZbXg0;qd6Y1gXf8Y%lBqQrxu_H(6<x^a^j2epjW1nAm
zz(JM&1YpR=lN7WP?QB@-bBn{_4z!bNQm$fXy0j&ZmKjc@CKn=P=NU?oJEU%|qYe`I
z1;=O3!k*zGvlc#07vlS=FW%~-(sc`LE^vh9gXXi}E}|Wr^6!<;|M7O|f5Xj^x2Zm-
z9kt!hJ2jgU5IxUSPk}hHo&JMGJVM#{t`pzlaT^}jZSV7wlVs2HBUe6eg>f!8KrJ8e
z2mD-X=27+$%;oJjwd<5S&UIV)T!)Z5UO)U_(Y`B`{|uS@FR#4%1#Y=xeuOs`;a9B-
zN?yWKw$$c{Qvht##`L^xfBE;qtY7!ot`j^U$6c<g;C7Z<S}MD|Sxf091PzN-e)2~w
zEi0S%2om@E8xX`!lTS!bZ}%P618qYyOG_Dqn3z`o#JZZcgN=;F^VvE6UTOW=51(Y2
z8j;JRho+|HuwJ@o5IPP@;2l#jqas~g0<&(jFEiW0-KA74wPVvleM*)+)?XfT%<AU;
zp?(Yc=i&kHP2lg3qQRJozhhsOsg)c%=)L{hwa7Eg+19(<ZD{_3Cp|sA=wHU%7{AU&
z<d023rT(2#g5`cvMV<NhGWGxbj%}@dLxU_KmwRVI!-a0oezs~kqOP6&=?_Lga$kdh
ze{XevragNARZHlFb|Tg3cGHuq$qLkU*nYzHnbDDYb4=g#7AIS2!3;OX1=t}EYs;ur
zE7j2Z*qnFp1RnBs-AVzIhpY%&X}z|gRL3wdX{}D1r{=OcS;?bW+>2&ng$Hqcbw|=7
z?A_B*dvN^&dsxHie29{F{0~xlcHOe!XI0DeULoMWz9iU?1QieTdPbr2j&<~ieFnV*
z6TR3Uweng@Syw*QinXH@&^H<7FzK^h4p)pe8AqG)sa->`-heIbi9Nc3KxdBn!w*|}
zoq6+`Sj)9PdJYzA?{5x4P2y&|bGBQ*n{r5yRP5|;e=u^lwAVR&UD#?f516vj-}u;a
zc7Bx+U=)KYX}rtlG4$<&FRkL-(ruWJypw)yH^1TdXo{xsv9RN2aJ_o_EzB-A)t<Q4
z?DE?uTo5R<SDzc^bY*JT-q$;2IZ$eHd>x~6ZweQ;3drf}?#hbd@=?Zqo>a@p_*GlN
zT1*&0e|cNJ_r()c<CJ=c<ysPB3x<A}jN13!Y#C?>JKnB0-E-E(g)E=hudz=c&@DKA
zP#2HsBDt#8F#dY38_-cMMa7gD?`Y-NcxZNAh~=8Ns&B2oOaCFev?D{|o_5ILY&saX
zQHbo|Dqf17iS8jG{fWl*wDu4{m|eOUE3T7T<Gk+43A0Eiv;R6hTyQMdr^t#~bU(5i
zwsc)(ENOqVU$wkYLdd>0-xQ`mkL+!4_jzNX3%ZFlnuHU}e8VjG6sT|*=B8U0L24!i
z)&@isYMjc(`fjDz`k)WG;MaWJyg$PBv|pT-ATx&}jB5ZB-31@{L!6aurmT&eWnbr;
zrJC~C1V++rJ>v8JIY#PgxKHr&y*VbvVQ4kRi6gg?5X#bdSEyiAGdjs(ckeor%>q#l
zF#E^yQ~TLU;LGU-JZ7y8=5XH1BeLM}UQQMoc%YQRds(ag=dgc4Ym@n)dJmSED7Z{V
zU`WizdcE&yQDs8;Peu!@<;W?!*SEX6tA=W>m&xk(y8BCBJ5&)aZnH9c#2`tZ!<j6G
z;MEsxL6H}j(QIp4;h_*3;Wd|+r&fqT%~QUmz21BGLh+!PYDAC!$OSNFXE8gy_{6!D
zH5ugt+dj*vpiH^)Jns0@VU5j=;ajuQ;u#u*YX8Q~_gjgd<O-+zuWI{usi$=lq2SCC
z>;m1JLznm<P^9jGdoCfLV-j?N{^w#$Get&A9XI8X;tO6PfG7w>@n>?yb|WUhWD`xd
zmSbeebA<?(B1FjbTt`PX)#F><iw<&NTz{vSV-N}%?a?4VLx1g?hviiNY@V*NC|?C1
zVruGZ@Grb42C53)^Q9}iF%f&O8DWK2`d$}TrK_ZC5x>l-bnhdsTq(Nh*b|J6SuKWA
z4UPoPltB8kPW!Tn)yqG%;tH8_`$MSV>cPFBK7e+>Nuz6R7|`>4)QJS(1Cg4T=NdCJ
z0E$&k-*?N{SGkQi+FG$$)z>B_X2EXLL6NnG+?8Q}%C$8y3s!TyEG|UwB#2>*a$Swg
zcNV|Q-j3pHckwUlG&-I21-HHCWJ&C_&P*75lJ8`VU+M_*<a#uz*Dd1_p)Y47vp>Am
zR=#dx_rg~Sa|=;NCti3+Q_52;;Q$HL74Nx-M(-2F2`gYm^O+u39j3qvMhaEwfS3Zy
z5!7|Z3=}}ekVHw-O*3+Ma_dAYjb<JlrL#k5I0VQwNK#dF_MVDSQ%r5Lzh7ET4X~N2
zEpVkXS-<h)fG_S%YmkSO%`#t=!x4dUQH=!ilcKHs&k8%Z`kZ{0RmWh4_sHfzcEl`n
zu6+}y;gAsAg&kW1chRFBA-iv*LPM-{(&YMso$ac!P^);Qb|=301qHzk*kG*3JE!;)
zh}-L!AyQb*>-LWyrEjelxwm21mne4@K~WU<H^sK{#;W}P09ZDeIqc`5OFmRGd|s!*
z%Z^yEru}p0tl~W*_Dx|I0U$64pwd=;1JBx9xrA*yww5&C1YXH{i_M{FH#rrmZdQeN
z#?!QkQ-Wf$WE$pmTHbqIn>xwL&NK;E=tgKX+8pw<ExmgSpHkVvIm5>jl#?2P$NND`
z*2mCwY=IuXtolKR?!F@NxYsgNtsr{z5%D2q;fltP%1}Di)#y-s^{2N>k>NmHCfk*n
zZ=F4wAmH`ri}EXhS;3}a|HnPb$~^{3Y0rEBbk$TQR~B7CB{3AAR5e@)wr*k$9{%Fs
z|IOaXTNG4$(U?fwt)p^XuUQAAWRzMLSk3WQ4pFIU*=D>GT)QHl<S}pae-1=ta!r4F
zk><PXdB5>iPUzA1>PV=(`~C^>X5Xo~eCjbm1-SSfQ@U4B#zMw)_WNL4x2$mf?95f#
zY<unC9KMl3ubg3V#MZuPY|9rKr3ngb+UC*6KYTq!%Vd8R7n~THJq5{@d)7VE9Lx6|
z+lE8j(-e;P9cSG!taQUff4K2H*49@|cE%AEnRiukzU*Tg(naDJ<gX2K6UFxb*4oN8
zv%8`-Cq|HYC;eei3K4xI3Rus<8nY%Yt<t-MLcHYOB}t^o+jE_^e|Wp%!<TQ$Co<ba
z0+6WKI-FJgN&(#dd;r^EYO{32)sFg=R&Oi2)Xwn5(Jr`^+_Iq{G(E#Qd7Z(+BJ5{e
z4&bBs5h;0En;sWr$rETcI`u7m4Ibdx5g>w2>fgfidSrhcQ9iwu=5!`wFKr+|8PaPk
z0@3eJ$qs`+AQf$;{VbcQkNcRBqB~dJegzD41x013D~1>Oj9N#e0WFJiRLP4=_;XYq
z^G%t|Q}InnreqP}OaYrjONf^r>l>=#(j|qOIPFBUtfx*34Xs7c^IpDp;;8e_UI!3$
z*t{c#RdXWB)^%5*^a!Fa!N~bj{tR2+yKl!ajr%69&q@{SxPdlygX8Por%?~!FGxW@
zcyt8mnjmhymOr(iU*I9EqQ7)08ya(&`Tf)`I8w@Du{f9MEk>f30qZ~mlZYJf8rKHY
zyRBc;>q^Z^A1>9jr(S!2BYrF=ltXw5W)IW+c!jK=c;kzPsbT9as0HLxuNkzOxYVZH
zbDzGQwql?H;O{a&2duwR(|(w1f<DxGmew8!F4ROsvI)|yi8!1-GQUY%x^)=M)r)tR
zm?~euk2B%1djJc|9y7c&yKjDKX=CX6wmyGNRqN&5T=3R!FRX_T<ML=qiH4`;x?x5q
z&L?ZRR;swTc+aA=uTMJgv!a$3ACq;*lgDs*i9rYi0@>3wG0D?m(kH$l@f+Uqg?$@l
z60URjz3^z_{owm{XSwj0>U8p3Ac9aTzXY}zXB{}{kN4qC%wT=2le06@C%1Y4X;E(O
z#y}E#-E58Je_`(}!{Q2_e!(GFf(9qJgg`=o-~oaJ2^Ks+@C0|)K@)-px8N4sb%0@j
z;O=fia35R-nVrf1efPQhY43fWySrbOFF>Dj`gC{Isj9B}RrPE|WLZ!kvfCoBCLoh3
zZ1;!nt%IDB?}sbvsokdjF99!@n3$~FPe<&d=Zv!F%~#KLG@6eWTCu*NrJ|lf+ZWpe
zi5E_J5S<6~xDzoV*M~?AV*KwhCUrD)KIH%7lk(4r0egFU08<_vj;QPqO@I68tgjc_
z^K#r0B*+`4!=;(38>-P9kK57AEj9a1YXY$e096guR#Uqv6hy?RTar>!bqOhw&j*u9
zNJgH&n6e)J0t{_#1|r*p_1l^Z`HuEbt7AyX&tI>#RsP}nXU*Xkz2y*z`of9|`^7)*
zKSqm??Nr_YTcerC8+Ue}6NjayrZPM(*8>S~b0e*AH&2o6EeWPrxqS8aPfK77b4B2{
zl-a0Wt@DK+DLf~3bGty&1j{n<lRtX#OwlCozv;!|92H0a@Wx&>QKwRS11q)xkWF|P
z@SS%jUx8*Nobwy9gUsJAG2a6PE}mt_D^%tun9Z7?;VWs2M*Qb$XlAaH(Ia`}2PS>~
z{Xa`WRGclQ_m;+O@$Ftiaqpue)^8XRWF;jan_4vpf?1HxV`|w&)C(I)9470kJzj~k
z??V6ncAe`$+JZ=I_xI+kZ%J~`V~WfuHrYvWDx&33&2ExRv5&t4<nN&&n@x3&a=(e+
zlTJ<NkD56Cdph&EwKcKTJy+YkzIk?O8@(eOnXZFmxtQM{?vqY@IGJoIVUeho)KsjP
zH(viCcP!3-7Af>oJ3#5*yB}d$qPk-ud-IRHM8yIBm?cyW6K@Q4gY>Ka@YR1a2+{va
z7x+99?3F*1pTX|kRc%jvRUYa$mx<mNCR}`;X^VN*CQ{Kzev4!nA~mU526R5a<Au}f
zi!^o83j^7VMjEo#bys^|?SD(;CIM;1^`yzUWs6=i5(tJ+y=e$M9<vD_np@2d?cB!M
zROg7Gql>oyitLFucE*}HVDDcOl+J;8^RqFUqogc`XpJkMup#rKD{(~=l60`_To!XQ
z?t3mLuxmQ+wle77{$aD;XFQYFqd1SvTCBCcsL)6bH_L7Hh5ns1Z(g)~#QMFbY$EfW
zK6(9_y7^Zb@N7ZregaXm*p{<$tfjcmWecMKQ^4t9EVULQ)w5WYF?FFiI_>Ss^gEaP
zUYE{VvTO5=ljQBnjGdyPC_{+TS!~^Rz3*xvnR$0FJnKkQeJuZU?YK`au$D)6=tZ<1
z`dVE~gm(IG4rH5+H^JsoNN#_%jj3dz$VpfDXG8+s4)UTc*x)^wm)?3YrZ8y8$Ytj4
zklqhJYVKXHW`p<mnv@LT5tH1vbd%dtee{{ixke`~(7`cTjujyM0c3wd!~yGOXY#0c
zeB4pdO>H~~D6)}rdiiR+%l~grlPHGSz?MTtrO*xL;p4E+BGX$PNt<nEdGNe}=m-cu
z-<QL+$gH>9Kd?FOr2J1O9Q+M=r{O-HpMO4*7|-EH;A=GcpGb9$OuyF{9_2J3cSjS5
zM_++4{sQ__Rr}@UeTuCEo-}_9nJ@j$?2a*VlvMxFmKJA^rY@1<c1`J%RPhUus(fC;
zU-%J90Ox<sWBd2>WWr{tu^HECJS&n_b9-&t(WrDU9U^!2s&2PM2?fOO$Xwn+XS^i|
zHHgNl&*`Q$<U;*F1y(2aKE}2K2scP!r$9p$hcNJhhjhUMqn(nt>KxSC$?l*UE@YPX
zZyZ-w-@MwehA2RBpu<>rKtBN%6NX7)GT6$@utj}R-gpz9nh$tPOS>TV^~zaX<7KwP
z;`k#W!P9`XMsecEmJeQalaDY04f9%rx4S<Wd1V*rh20Wpp40BzIbg_L9LjoK-QSv?
z3jwGCI?Tt8kG6Cda&tdosc9%aMN^6wdw|;OjLF{K_zwO1BEzv3kttAPPN@g`t016_
zD^v&FCNq9>qyKz}!_}HDEhX)*q`lbj7Yb~?NF{ujEmb|A#8;;rVscOoL1omO2WRQ0
zClZVrRCCaj74o0Dpt4<3wI#VZBKUrB8_p|$gce>e*o4a3M$6$blPliE5e;K#0I}+p
zx%o@ZtcN-8Nyw`o$)^Fg3tTw0&JJX<qqJ?etqQa*;p0RBIbp@*013oqwP6T_FYigC
zU9>&HGB$zhq4}vJ1xnu%O~(h*W~157f_m>yZniGMmLUu!uD?I69~J07kwZ&B+Sh)1
zIlXuJSqs!?-67;Z7hOE))pXC)^uzDmPhRd5itF!Na{{&l#nL_UE?LQF?)^UR+^Z(F
zAr$0@)LpVRp;2~MtDI)jAyBX1%XS-}G*Qmp-tL~BAg(#un*muUT*#65pR!}L?Bk%B
z{`l@Ln3`_B?xrJyvczs>qUgCuZQ0fZ^}OKNM8`ROZ{p?_>B{`;##n4A6Dd=Jmh38z
zs~W*afbM+uWV(8`%mc{<e5u|X^dU?DTWh-7b!Y~iytVPy;L=?kkF%QBZP$M_rGM(B
zhI*x>Z1P7BMw||w5QeWg2NgL?&iWpNWIgbKWdA%!ZBy^UeNn_!Qtl)i3kbU9bGY!$
z;l`XM6lrd?O(k!7SuICES{QWiObpQn@87MnS@pD*p9ncKh>M+m$xKny#x3^4W!4u?
zQ~&+rHM4-HMQX(-t<TqvU1X6;b-0z!&0b}{R)(8N*`|==MBrF!7PStRDu+uEeJzYY
zlTkC?U~0qsQ%E)~N@pfm6FxwSGv03!@bzx%c#Z}$VKbRI(EO%6%&+L1US{J0ED*Ep
zH(5WL*-3uHjk6R<XKzM4O70kz1+O6a@~Q1g>JHKU@X=n=m*V_U3XQ?<0ymLt2@%1E
zz({1uNH6mOwQKsjG7<_Uf`QjWL%_(C`y>{?)ytKzZ|^mNaX-+)qt5)HYDjVmp5dX3
zwTS!SE(b%_;p@#QlO3+Qm&ci>IsOBJS;3?Cm0LWOg%sAS!ft+lf-fSr?YTaM_GtOC
zw!jvZ0Au6jS!$~VFDE&D8!t1&CdJYlfa}0EtB8#^Rn9<{hpBIHek2D-7xrfn7}Wz)
zj4Z41bPH&K%C}RCAK*VGQI^Vh1amRcek-kh#m<iO@O^wiolHl(_BOvF*q5Ap@B`;;
zO4|*s?3OZ0=)5rXnOGQ}S+B3J$9%7<QCe#r9v2tKYcVoqK3ZV_76>LMK;Fibixv3a
z3N$hoTi4CkLgu_2Mul3zqL*t(JSp<$e?^7<Z_vX3w_RjE=zl10UT?xvM)BxyoHWyW
zbh%${^x36(wcoNex0z9fpBnG%Q*)~<MO@j$nuoS$Pf<;ilTV$^m$7$BN?v`^oVlq&
zJuY2TVw=kQAKO8R?4Q;3KQrOgo29TA6q{x5X+n_XfZ3Dq^AU$(1f-@eEFbnnpcb{r
zsT4`Ava-AVyC9>6htyx54Y`trP%<LX@4>-48&jL*AX(QsSav}HGCQ9S^=dU{t&B_!
z^$~w~7N+wD3+wh*uQpg!GKJ$kFViZwMc&Q{?%@riETO5!m!#q4dj5&peWFVSzO2#H
zvy-K;@KCy(#^299eRo=mr1U@!!u}8X`1q0Vik<lrCP^f*Ka|zfsOP9YXURZsKmUlI
z(wdnG+o%S_#f>1l+e^Ct5dNQWgMDus^ec)8*e(ok$KyXCh!O|MKn~CfnC=4^$^b)l
z)QsKSTFRiVghX`a8FB`rH8;HyFBWhq(3LE|Lh!2EJya4uu%bj;s;Hs#oW7Niwx1RH
zLq#;QMNS59EON@NA7rFBr0=w=KmCKNWGZ*6;V$f5_By*J$x`W${kRKp#W*v^-QW$A
z<GYfYb@}?BkT=ZP6BYWWlfA?o(1CHBdM>F|a0~GtYwCgVHp-@o#L2_wU(;AllC!^l
z6ZB;VQ#0>s*AIsr$I+INUEC+3jBP562FIx&J=tx-XS?v3g~<U6T1E%hf%b=H<#}L!
z1NLK8bWT!jB~MU^TY;(Ka~caRKg4^@8~gsh`)@D68)d-hsU}T<O*X#;LY=4Cjd=X9
z5>UF+o_4?0aLLUeyDX@q0m=g6RP+=1ap|Dxx2l=wzpewNCL-b&0vWf`i1qk(1Y@u~
zZ8J}prL3%6-*X<aU=}~SDB?CW>h0ezd7j&A8N)l)eQOb|dm}+P%~$2RBMM&*Gdv6e
zmf;SZyJ<X-EF<<KVV`F$o_V<K=uEegDMZOTlg=Rmb@{SYC1An7Uz2d8|NWw$@0uh%
zl{>6st;L`1qKPX<V47R@x#mj)MnEoRg?{o9hM`k%j+UkcuKYoSrwWpx`hI!P9_10*
zoLLA7AV!5WI)=8&@2jvGbO~s<m()w8*mrBS;^Lhy9O~)?D27iCScs-21M$YDe`93;
z7wTgkDR}A31WguRVvTT2>4;lo``srdxWPTOr1nh5ns3)hj@>299Lo2w<BpB!>p?V$
z0Q+?!m;^4@v~8;Ar(u6c32>tMU~ZWjL!Qo!68W(X8T2SSdo@VmuCK>!zA5!%usal3
z*@lubwZ-{q7EeP5Ft*CGnx5w_Shl0-)}CD>;8zt7R3$CsYujx{Yr8wOlymfru~qin
zJq8vPWbN$@+fNZX%)-0q0q@)_+C7MRYd1c)2NpIaau~ROqJeKZ)QZp>@twr`Iug#k
ztyH;qeVQIqHuBKsBeb;RB-J0sJcD7UA~zWSzPHW=Ay}wFZ|i*u)+SGnL7(I4b<5h0
z8+*A-_Yhvz==9|fVK<kh#h`oX?|o#eqNfCiDWo^Jb&;N$x4~4f;}zK!gr@9G%1{Gv
zM#^vPH!qQC!1Fhe+yZ3NCQAyBX>O;F^hR9#Z-x}<172INBm{gOXa91zBo>|GJ8Pw9
zhSQ&d5hkVg<NlS?X}PW4i!ib1DIfW-j~*&kWC^W7F~DcS$t<&^o<qqouh?<r&vkw`
z<=STHru$8srj?M#JZF(R&}H1k`eGz2uFJ$!LSIuSu3f%F>no)FV%h=fGIz_{LR0r`
zj%)?jL^@i&b**|#>KW#nU7@{YA+d&qzVKiC7Sm>n{q%1OW$s|64U&uIW9QK?nnd}k
zsoTt_?gDEb=no#EaRKu;$bJ`TGm=W5eiX((&g6EB$$ybOB-;G76OP`mt&nZE@U`!E
zG3-K6{@MzjZqN<59HOsnLtul&Ref$Q!}EZZNcdJ<E$QjcU#qK!xAC<&iMr+u1|ce^
zwDa<~eK;B17Wau2ycA9PcS5#^L}$CShe`2NU4x0~h<RtLL4u@?K$gV9gU5zsUR%a~
zLUl^Q7Z;fVZmQl&fJP$fhF9lbI_iyszD%slyB&Z#y`Q18V2e|Ow|+#9dgO&Sl!^S(
zXRAA0KikEw{2YF9#%#mDsoxlrn8<HAmK~BQ?s@zrO~B69&ThZB0yx<S%&wPFl1OQ_
zU(seP9P^Gtw8&>{R_loy*0liw?)1mLM~?4Sxl!MkCwJH}vJL>=-ONfvKU1IsZ=EH|
zR)XBm()gE0hgUl)60;CK%Jza?qj~s%yiDdTW%@4{qp^cg4h#7^_waql@P-xk43@1t
zc0fxW8a*ezNZ!sH*IcNj#d3sfpxC|e!7G5yR1Hj0c`MZ59V?z)JbATXd9#^JZSCzK
zR!o+NpE?!*G(sz08lVRIwoDHN=bEeW_fQM9DTo<yHZ3=m#M3o<Yr8eF=#a7Xk9{Wq
zNR+xvGvLzb=UjqwO9IJBqf?ZR#Bxir7@ojC9)c8iR_YZx3#>nj>)*-L_|U(8P3KLD
zly^9wkutb*XXaoky0691L8Z&Z@fOz%%OKigDgX|lgZS}8DX#_OZ&`|)YiHal1}1|9
z4jXR=Q-x4;mcZn&zWc){%>V98ezt3a<_>;_@6Bm*NyTlSP#e?YF)S<I(;vVt;s=M%
z^0FMRTp!=(WH_+M`n0{^!PW}w^<KmYSbgWSCtK;}`6d1CSEaZPQS9%X<GseK53bWq
zG_}?bAfgli20oE$K}h9KqFa3LWy8|ryFX_8#-;#OzY7IULu<RQ@OHUVl0QawG%m|a
zZVL#djI9#?udr0E!1&F8*M7sYMzFWKb3ML8jn(Mql{EOb2erd5oh8Pe{+76;XZK^@
zhcAp}25(XjhE&XD-1_)EkNjY2x-pg`B_%0&<nKILpk!!hDB^Kc*4DhIgr51WHIck#
z6}&vnL8Hx;-ilLwzbe=aD7-vU2pJh<zBh!ibUb^>`Y4Jnw3&O3bzklrzukUg+a)*!
zEn@?5<xeD}BGhdXO!X^K8!)$U;eJ&&8GGsOJ}5INV66BD67grkch+_B>JoUPCOUR1
z;4qSMG)d(c1KDi5QaCtak1wkh<Y}ffcW7y|Y^Dt`G@j{lD{ebfxOkRD;j50NWYISI
zqIuuMbFl-oMauyI<fQciY7InG=#|*ccDOP{eVg$<R1)r79#a^tmk15Q%Ej&14R3;O
zeJgc84dWF(QuR_k9O4E9XiXnCX?B(x(W?7?**whz1e_!e+C*vaRse16r}eHPr|!!K
zjy&iD*EUDOLLUcoRL%Y_CIHf6U0HK%ksgXy32jO)xVhF~NK2TDS@wwda-a>S{~+0)
z$Ti^{a<ylcLwh`8;sd$0%mK#`lQgml9Z5g1uPj81btZ~?WX1fM*oGi}f_~J*r;LnX
znEiEQakbUA@H;NacQL{?q0G2F>uSaAx59xv_+|`i%N9H_U&d+@dIUP6wt$Z0vAprV
zN3;TG$pa!j%!p7=xF5(<-&BM#V5-{h-v9YX$Z;+^P&fS2ilTz;R+wR5vfvT9Koa4I
zBbojvJI2D|rSnzQbkgPCUMjYU3sLtih#rzN<($UtVNQ>>W07$7u=YbrL^;xZ2M2Jy
z_@z&l_d}{wL9)|n2yg#O?Tt>Q)H9m%gZWw#V&Vd&H23|Pau294Mf<2Y;s6Fi^iVro
z-`>u8xLstUVOyFhpN@M!nVT?yw>%59lOZ)VU<WvQ?%IUFT0J?|Uk#i(;{a&)1*XeC
zHMnarWfEu83nr+HqAg3Rt2o>o)IUa73>kqKy891SkW+9`>3}N5JoIeXU)pbM>W4`B
zolr5jI#xBEaV{+GFx-ED*VlZ{-B)NYi_9kggdQH2|DHypa-`fDcem(EnVST`L7}3W
zfXTo18EI!mD1}44fF-G=Zz{KQ>Okt8|42cCQF}_ihO4349ux3}*P%GFt|MLl*#aP-
zF5ixt1MpNYHRX|&*X-FhS!_!g^ADU1pFbHvSnFv{AATay0Zma%W{RfACDT0llAPEK
zeOYx=!Axhy0t|I9OU?VaiJlMC+V=WQF9M$c<dhablaB!FNgvcDD%da?z)2~DQnHG*
z*u6aaE2BCh9E=CJFj{!hWrjW$9+e%tgx8^Q@FVq7<%VfQ>;B>bB@^S7wK-=AdR?ZH
zhz4LxfPWmzbojxeO1+rx`Eyfb;&83`FmfxP@hb6bdz7BrxT`0UdU}dVTSRIZWuz1$
za-nzLicTiC$s}6o;LO6Y=_W+?OK4Q92>$B^OI#YyQ%C2edoX;}Xh9Y)f4#}H{Ne~A
z8<i#G!MSNUmy)Muv26=4o7GU9@q~j*+R-CfJOZn8*H*-4q?XI1W-=ng5*PM966q42
zIeNkyqYGx5cpSYrE}5Bf3o4J>_YlDuM8f!pwKG3+P?Yc4d{jjAf)YW{TC0Cnz~Yra
zqRMV$g7~S9neH)&`f}q}BShSx45FpbM-dTSk}69NpCvJNGml@<w%AH!cmAwX?{%#j
zq1~!y1+joulZ5s6Z<{d18DD1Ie(99ejTTZH_DQKT)V{ZlDd9a2C1Mss=4}HiA(som
z_|(5AEDU+`ooq0SsD=!)-Y!s`^6CX%lA*n^UhH`slbn+nXuygM)|xoQd7S&gb?Bp8
zKuzgviFfUUI?vGqKe-H=s(zaq2B5pR-^(M@e@XT9yG_4#_sV+V>(4FcAS1Ce>#*+{
zg`=V`{Gl2#nOdUGKwvQOn_5d2ve%0sG*Sw6E^U}I3rikeRb9h4H;)|)<|$`kBASHG
zUOxL3zRebQV;Y+XgniAE{Piv2!PG~DBQcSh!9ZgSC-&=G$iiTQ8@t)bFg8Lc-bfiz
z(v_ijVr_1SCXtdBr$qp$VYiw^vl`SYh^C?i{AeJ55x~SNN)1TRW+L}Hd0<UbS(0l@
zK)3XuS~It?V(i1sO3lQKxZDa@Gq(P4vCi&q5Q~<SBoMtzgBH;7vy6Jo!RF%F?DVvw
zEa7AI)na_B{<*<*L6g)^wO@`~G{}mB#MwhW7VUQbjRjCpF6AtED^&h;tfrpZN7rsR
z6&cC!^t>*uY!!Ch8AC=SN=gM+z2>&dxLaI`FLpfOuv8B|;PTA6Z^6~ko<QB<Lkuqw
z8v9@SgjP{gf8D{a;^mo^Q~6gCdG}xqCUVYLZ%Ts|x5k4bfEK~bTE&lz(ERrUoMzRs
zHT>UrB%Zu8XLGu}LV#F$XIzG;4e(<rvh?xBD<Ts~a|;?C>kCm48E+hMPs|_u6|TIm
zvCMC2`x9hv>mX5e2puF2D7<PvRLt{7IJNG~D*^qyyZCop>F%5PUGcEpXQQH&KHpCF
z)KrA8-&$+gR6ICCYe3$!k>6NJaDLnMfcby&7lwrv#oCyeKO!~yxzZ%7w=KPai7&+<
ze$&@qrZpX39@Oi1XJ}F7wvtJ!6O)SPdWfV8y{G*mVW~noKd}cL1ao}eEc-9|{lJwC
zB0S`51pkSMwr@Fi`{~}FvANfW50&ng#byQgeR0elUHZefCMr2Op-U0HgaxiZ89fbL
zHnCP;mo6x}A<WN#Mlt&9J+n5=^8IA;8vDq^6x74?J$SNj_Vu^5UI_T7;w%F)BYE%d
zcI5|7U-8!<NUx;>EBZ#3^2=|Qiwo){(3^{g9C>WQGCaNk_i+gD&1-qah1S1^uiu%I
zXB<71aq5ktMdJPLZ7_Jp0Iu*B(R^?~%RM{j_dvco%!k*)M<wGYbQa70Ehmh}_I-Po
zGE?^M!Bv0gN_lJp?8->}V^4JJtf1`%_c*k3q3C)k>aegoXA)Y2l^w(WtryQs<RQ<?
zVXj}r{)v8_>uv*I^>!#`7CtX}SEkel5z7c<s?%a(f-i!?!z)Pt$*(4*llE4-HreH|
zqYWXmm0tpYu^L26`)()r@ivnH=dwG2d*C+K$O#YnmsPRB(ZY!L^C^(DOR`Hp4^s=G
zm_eI|1uDF<Bku;f)s=@Je`Hei6lscAly_xFSWJV%bc5;OiAyWhbiZm!1M@phdH{nv
zt$@BbqtD`asiY0aL+sbgu03yHe@yI%;3a}QQ`LTJ=OT;H&}-s(`3<`fC*}4`!A@7w
zaL$u(WvN2suHHzhdVg*=kmejGI{3%I%l)fy?fBr&j|GiEFnJAEDxRVF&ukx8K<l1I
z=w}l>zKFAnPcUW4)2QJ=f2H8VY{IsOFMTE!t!NvD18l)gHiP~{Y9RV`MAobb+Zu@D
z!LR%DI70I3uaVDz8J6W$D*V3J@ZPQBzV)k=<q(G=$O+0tvy$0%n!gbHNppIB4JR=%
z5hp0OuFh3|AsBIyX`tOHme&b|)U5s(*+(XlmAZ&(pMIPWxK_dM-{te&RbkFLr^iD^
z=(g;ktp@t~cbAJAfP<B$L!DqxN5<`2QrVG|);pj5{=qit+vt>KtivuGq@BP<cM?_f
z;Dt|(|7Cxs9u9|(&S0D_oUo+XvF`5e;e1yONq&=*kdQ9qQXt^%ez;K2jjV#ti^=L?
zA1zw%0OO~;pojIJe?$fWAL*QC{aK7R3&?p`uONL62T^8Ir>DKV1>O58*)HE?%xie>
zPptuvF2)iy;KN+zZ(}=L3h1oJv<JtODgQFy{xn_uYSsgPw99>BLY#Hlg9u4+pYvZ-
zt=@ZihGSO`_7PVRmD^Bm>J#WP^B(xI^&VBP%ny{uP8uKM|Kg{k5>+DwkR~Tgc`!<=
zsNc)h!J}>Rdj7e|LXqKNet!OtD0jg3*$^HnjX+I(b>bE=(f}!05#)t1X>}->D7e5I
z6>n5K%dV(6;-6yPteo;y3%Qh`ErB_QW=fM{R_4$}-V3azBh#vxth=VBrZC<+I#yj}
z@s}%ZM=7l)uTOmn%N@&ikwxfC($F02U(&I08LmemkYj!R_<K}TRGvn%`(YXTt5*pM
zX0$8jzlxOQo)Z^;D#^*oDbGXxFh7pGO{4oS7vM5_IkLT=prE+e3t3fRU|;~w8NNe=
zeC^cqH0JxFOh0o%lw)=}4g9Pbs1-dqI`u}Ab!%@V@<T@EGgMSL_50pirbLB(@Y7uL
z93qed${|Vw@%+E_tp0bD^?S2Xk1|uNL~fEnLZvEOBPk22gXt$>(oByZJ-_fLN!qR<
zsFQw0B>mnXqf`y$n^wz+Eh?7({qGtNy21T@z$6ORA^j=jIsYE$=e7%LNASrC(gzn>
zRBQ!!691pr`~Tkf?f>-r{<lPtcd$54TqS*zB~a5O{O_>yH=r-YF`K`g*Hx#e(7<ih
z1Xbggix5cWwtV8tQdXZ@@L^XZw2}JVS5VEI3`wBzaPM7<PpH)eZ{e)c-FeK>TmTu#
zYx)Jyjz9FHe&!}wqj9PREk$YL(|X`VX5&vDOa{uu)-@3~TdsTA1CN($fq?nCdXmF@
zH+^KL9g$k?G%7MJ0j|B>S$V-9{X>BKLQff=wlF!P-dH7FC{es?kP<M`n@=h~Y_xmj
z2=t3euwsNBu$|qEE--FAA{CMq;K0M<(YY@UIf-CL;R}l9ts9ZXYhLM95w`m7=9rg@
zlta^l$6q{(blrCze;7%in`e;W+AGX*eDQ>&ys4U9exI!nDci0tG6#SEKBpnRlQB56
zmoP2FLS-CU?`dP(Fy?fSe&e8nlgwm3^mEG3?svD*ErD4AwcBOpeF_M&bzk^O8OPwv
z#Z+O7gCniA(*h1&T=Lc&JTb#QWDYwi9E2E-e?J{4Zq)zmNocF>cLTy7>|E!f=*%`~
zb8>;6G>V^O848|EN*&&5kJ9G`{p=&WV<L6HEc^APxbJNp@Mh!}ZqS=LH-xx2RCa_3
zF<D+_6IAYf&O-r^ctiV!G25W2fe|3H^`OKq@M1~Tl2V8;MQCyv3t(Ru?AIpzidpvS
z@#&DzBzzCOyKtsbhdz-p*_zUwPM{MyE%`}$G|Q<E*f^fgn_P41hNVPV;bp6>e_8*|
z?n*`cbeAEUf%_cH5mLEQ5dZ{#)e!R;)Vei#aQ)|>F2`CzH%Lm3kN4j8zuClTH=mjk
zEW^1fUygMJ_QLNsFHH(P^%%GPZM0$i*1Ufw9SY~jY36I-{!IZ4k5#+q72GI!y#l@}
z8*hB?eo4!!eENn<8P4*q0WU@pFhVb1dvdGNj<HxXNyOe!x#Yi<dv8N-r!Y>(vmb&0
z?sPfm6T{m}7ewK1vue+~Ukm_Dv%*G$mD*a#DcreqsM%dIkL?0H7KfxtwdvzTFYsSY
zc08In9JCP>I-a~rKV?Rrm8O_FiXV5{nG`Zv{O%TetHFay8t~;y1()2ngCep&K}XQ?
zxkj&6?fEEVfF50yv_Rih^lyj~`}Y^rG%G+h?3hF7@w(I5vr_H57QYA8n-P}3^8g0T
zbd^~eisM~ET&$!Z?88ZV5%D*xE*|q087~2Gl7h4XbZ1gKYmrbdwhqt-v(oFl=Sa0<
zElG8R=Q@&U20JSD%7zL1?~5$UDAM~^UK4t7ea@Bu$9~HjLi<H<W4Zn%6s{}jWDlMW
z+paXk#sIu=JMkOt?-=0r@h5He^1P^r_&D_*8J*g1<N>iK(N+v;hsQ_qZn<8LZ>u{y
zdNhFF?K*~kbfpv?=>O3BXHdv_{G@R(p2O~_fyhSq;xLCSBgXMTD@(vBEcvULd$!Q)
zmbT?RmOaZS69;tUMDl{CE(vddry?y0lxg@8f+0ZHx*z6QhqoTR&l3n~$}}TJd%8>>
zBqtGv^APXlhWwy69**>a=63*>`CZ<WLwy4!v>orE+drDG7|_RDj~)5ZzKo3w6qOaJ
z7B|wQ8E>_Y8Da-KNJP8ucM!YuG^1P2PR;`Yio=Sh2C75E0KB~D^G2II?c)yPDhlrb
zU#x8$8n-{7eR(Jo*G5GMKUDn1vJ5mdSvj-y+Wt0H1Lt|0(<u>60M^bTp;<O4B`H6c
zXx$vV>b9U@PY58s(#1W;cSW<bj!?Ix-bEjqAq50UB7^A?dPdZM-*90rG&7zX2rv79
zDNY}Wzt7^8EI<MCw~kQ2FogC89hZm|y?mH>vfk5VG<KMnmc;vkC|JXRa5AgLt89!R
z7&Yu`xCp{XU%y0p+yO!REKDS5neCA^NjBPe*U4~Ll*6ObwLxwXEiMC^GEiUX#}_-6
zPdwb8mI(exp6Uj>&9;CQ+g|@_L<guAt5T-+B>)&g9|4f3j!9l{tD_YG7{E{K{U)mw
zy8}L{#Tboi-;91osjSq9VCroC1>y7E+v7y98fK!!2jbU5vFD1GWu->+_Xh^0%*Kjv
zpPKPX!dx+W(8<KIK~}?&^m{|1F9cqGIe2e)#~@eX*?AliuEz#qIky=H#b3`?Ex)_8
z9SK)kM9Y#r<X1i0G)7A&gpwvbhB;_m3zG%i_|gFP|HR8rqxB68060kda1zEavnwmv
zgN|%!#pqT_;P0q_FNz}X>gHSz#W=SB410@>QO|&@#}$g3&B6;cagxun@v~nGo;h^N
z8hF0k*?B_C>Qg^<``~BOUC)}XoYKJIs6F3U=|@>cxS2R+C7v{0qJW}!LGj;9iR61X
zHXfhRWyGO~_RqDhi&A5<<&}rKQne_Mv37Y>@=G!tq3lnj=7lmLJ^Eyfqy3Hg`lTlk
z#!OO#EFUVNWd67U%QQ!N&B}w-ZGjE%I4)PGJ6aUMNnD1fHVd6+{iy^MqIEo1vfYCm
zw|IQm3~icd*)4C_cl||-T`>AiIn9!xi*5DtdPK>&m(so6!NI-DR?+s`Q^TYwPQ4>g
zwpMrB{kQ<75EtvKaZ=V`4jde@SUu5116TX2Rz4|k6dY^0xdBY-{Z<3b%;|g$Q_)?#
zMpMV}VBPUzHD?e6VB@*6)vw+zrXAkg^tVa-wU6ExCPZrVxxlmITo|QFHD(<xvdy-0
zzmG0^TM7^Kuvt&G66-;&DhjrK-EHMGwb>eoTmCHq8LS6JVfx1|ua}3xyd8Az^fut=
z@rzT&K54B4W+F3pp7LLjNf|?e!{2hjT+do~E;`Hj_pdN~X$U5xxT2}Y*XbjaA4dfO
zsSd<HO^xJ7V*=h1(66v^-;J%oxbQu_Q`;`XyF+HNS>5*xYr!XjCQ#wpjpQQwWb?Ma
z`{Uf)OtJ)WcD<u%pIcpf_q?jdxMAGZ;ojf{U%tZ+ey5Bx4iD~Yf<XZczZP2GZFZi}
zqBV~GN{6h)KTAW9f6NFOr7;UTX!NHmKNQ}*Kj&907>;3QY&a5euegC!#L319dq!F}
zS^oJs8T?`<@I#b0$6;@_*)93->6>zcdX(v-6!9Aw=C0^LM!G+-k@BS2>I3CM*Atql
z8jj4Q{Z=WyRYM=%G~^iJBzp?~DNb|w4@PcE^{0w1cpli&(9po}*xK4{=A)Xrx-+t*
z;ljauz0GX!;(ySFQ-J>ywTNU&aapYu@q^0>7?X9-JvHj>`1lt8aFqYgKm?1B1tO!9
z+{O6$JSU6eole8U;T1tBiSWRoCY9%{l3d+NVtaVF2Tt-YWyIR4J1ee*ruFY2H%QV`
zrhV+MjH78p-FWQ#OEx1#r3AakqsCU1{=uE4m7-g6nfN@B1!_(l_`3kUd#3vTWlE09
zkjMe?xg}iwAtZ~6tslu(GX4kln2YrfSbz+nV@AG`P%MYE;UJiW#U8p~F5vJB17tQ7
zGV~&g@AM4ZTSK|AZqLz!tz_hOe9GeGt1X3Etzor1oUvvgQ;hHBm!<i0IOo5~q!#x~
zbucQ(;J<VPx9%e=ZZqYYmz`i(7FYN>c$@T{Ic&{(yhJ@d<-;FGPQWqR4necmWfP@t
zxrv^DR|NkPk(D2iX1|~9CSn-pj#&>hSfqyTx(}v8cE)7gN+log!3sWaBGN!V9Bglc
zyAJ34ucvy5v(Y3B87ox<QY%RQ-5f`y5%3{MpMWw=uQmjQ9}eA9M2`BIY_vff=osgn
zC(}}v2NO!g=fcN|;EWsc?@jbUIy#^k88MjjKP>7+jvA&VAO<=l2hoAb{KJ0KP8aFE
zeGpXx1vPo$UaF#YMB}yAhG@Dp*G^rqHpJTncox@gl>Re%`nCi7U>np>fN=$s*|c{Z
zDqWQ{#q2Y-MZyvh+<#73CGQu)_^DqdXICy-+xK$Xq^Bp<3&I$SeBS;ez~{&cY`9UZ
z>@f9|$%>13Wb+?SMGfqwaITU%{x>Nzm#{iT%<j?qGSrHmGx2pl+mR&}MJMdh#?5dB
z1xd}C4b(shd%6w`Z=wQwCb7qPJPtP3Cc5wX6?dKpV=3=7#-+8c4QytZX?~B&Q9OfZ
zN}@=Uz~60}?CZK*L+qs<^zLc|3&0l7<d5^Q=IqkD^JpcLVEw-El9x+K)KULv>&W?P
zcj9_jF*!`W=`=Mmm0|%8aV={E9vW`VOMdZ^9$B9*nGb`llAUiUlEsV+XUFoF6#$e4
zrAA@4b14d6V(sMqhUmos03Lz>v&-txs<+5A=Of%Pj^@j%c&3-GBTE-IoTs6Q%)_Nw
z$wqIhZXN-$>&&IdzNeBFeGkq-;tp(`Sf20Y{^nev__t^PC2on?)apzu)zpj>!agpe
z;YUMR&h0_j)sXL*!ezPYPvjWE@NxV)hr>5zCF+Kn7X1HUKKIrFqGQo<M(Svmb(T4}
z?Q?V2yV#Z~BA17=m8BQ)vlo32U`aG9b|s=1UC46)nc%CvihmH|6769#EZu`uftHXa
zOS^Kk9bvp@f-l<6C&v4DPj(e#3)SeanHJ4<n8`!@KBxVqM;xEiS<2`*t=R?Ay_n(U
zb6DJyBQ*=Mu%^oH)<#EM50twup2tGFPYgFugpE{lc{0`m=^gfkRs$D(vMUi1OG_DT
z7JhQ8aL%mglk~N;I#x!qBX<>Kfe?F&V0|z7(nu%5z~u13vl%n;4XCetNe)`VD<NhS
z@OkPpe=;Bg(huq_kbOrFvWD-M9@%pF?6KAFf5TGM2Z|n7?jt;P>p&p##A5HO7f%0?
z9kJFkqGMdCQ;o6|>k~UMb}ugso}gA+v~-IHeVKu+HjwoSzXJ9O^^xsBSMgjmUfAX2
zo2f^Ly#BYRFXxsJG*A~U?A9m@#;XCIX7r+VDRN{;T8Uf-WrZ3EscV<bTlQ^F0B?tN
zxJ~qJkL=!sS#Cb`mg(pj{QQk5*wKB;q3<yQgxQpO|C84kRoKn)8cFGybqB8hr3t$D
zk^vk9cRt(1u<&1yo5N)qx6|nIR9*|k5*m)BEsT#IAP2kbh>3$UwfDGfi)s99tI?S5
zyDxz=FOmt<#~ocjqX^$jST1`0mc3urNBZeb-K)#tDXIO|d(PLz=kgY|<A1t)p0ZG^
zt2>k!R@f^Rs)zzFt%~z2UXS*RkzDI7$$#eX8NDUL2fW!45i8(Ic&26;+b<JC@J#rA
z@DkHMlk;e-e?jv8vOh5GE`AzH%X^cN1W-+&60&s&rUCpk|4A?YkUw<av>?iH?qHU6
z&BJq)K#WzcPY%4?E8!4v;hgO%hP-#)s4Dttai5M_!_*d}XsL~^(9>d4DT&!$nQy!e
zZ^}4YiTrv@JL`}et=QFJqF~}JvVLds*PAnm5)4`AJze)$BYX{DX!ronJSSLLarf>d
z*1g4ZcF{?)7ZY!vZQ|o(x-K(sQ>z@sXH%hXVpD#Ya|z>Y9elLpWczKu44PH9<05mn
zD>XP>dv;_87^4#V(*6aqWJD-q6kymZ@SPm6aU@2WI8ibQRxTglF>WyJOYBbByy~&q
zT`+7o+lUqAdbalo5YwIh^A&&H>F%Q8eh!Is3MEBXaL%@f7G%ZVAO5MNADrpyy_cA-
zFp{v~Uh@c9{c#|zc%NW%b3-yr<Uc&XHx4jJsPj-H2CN?S(9UBERxUe>wL#zZ(ruO3
z2jrf|5cVV`4ajg9ET>%tf`JS3I?QCM<}CMgPb^?F{n#D6L%!*5ZXDS7PUM>>jNkrv
zEBtm6j$-%40t$14MR?yeS<9y+#r{Hyz;e{~F<H_eFDNu!Q65afz5!6BOH1`B$(?>)
zsAV>v+(C>>*OKgcL$8Lw9csB+YKrLh-?eIij{*#0t2thrgvzkfvx}J6*;VJed59(y
z(A~V<V_GPc#e=x;elWYapbeY$_}&Em2m4pzlMpwQu?nLhBl9pRsDNBq&_~l-&gPnD
zgcC=KM6~v!sXfWgT@zp+t5^EzmjBfICIs=<-(uEzoqVs|gf)57TYMLMrL+GU>h-(;
zY;lF=D{64Nwsp}M6w6($(sb)_a$&p~f7O_`h74Z?EGkGC;Or{uHn$JQtvLfQSug{}
zYsvpfi+6mLfcqHo&H`kmP0cO`LrNlTYyP9ND}BH_=V8#I;F)4#3@gUyqI)Ym1;=dW
z=2Z3&=y6QIdD&z9&}~vYI`-gr23#7taKZwX>x1#(W5tWVE(?w0v*NOCD6$ZLVd2j0
z5-NJQUJ9b31r{ikP-qoCI5(Y13{a?zkK;_D5}A8v^`yBh@K$3ZH*dSh@KWpWz#ETh
z6SjH&d&WEz$&^X=*BM4I3!NW2CXL{$WM448eSTpnCuVkw@9hYC%_&p+P{ZPLR#tj;
zNN*&^v^9TAe0;P4yRXDlE!E-1hKbp^BNsM6!Z60E1Ow|3+n4)G`)uF>^*e~b$#i?*
z$w}L&)8D-bl<a)RzyE9}4Ox2R(Cpm`?;9Ug_oewe^*Yakih=Xh(JjdNxT^z~5e2@N
zl`?SR^1Sfl69g{EAxTlheNX7KqEyN2wsfHBVYkTH;AxACo<{kK9dy?~n~m2VkrI2?
zN6KY4zH4x$?6IQ6Uihp$yT$Lhz`B}^4I8h2RCui;Y-YCqp)w*R1*oNB(69SXre{IH
zsKfwd@d`~%O*eimWY(2rPE5b)`h=7uP2sz<x0RP(O%)2ch4C|W{-NdipqsaUUFUX~
zXX!=2oWdhfkLe7k-g()o4n&m2p=3#vxG|ylS@nASjC})LWqCQr<L{}u8T=Xv|Dz{g
zXH<d&a8A3*D=#AWw_u{9wN~iWrO~Lbq(k_B>4$8)f2Qe_K2qv?2i4%*D`)i1$tRLw
zvaUy!HD3Q7BubqB6Mu`<*1m^)YbX^J){Z%BX}2%7<*y)8si@iU!!+Nbu7rM?B1NwY
zG`bGEPGolLPK^|PR^R<=^_nEd@31Qse>&tTzK<R4%v&K$x4LIJ%;oVVsE2kiZNkx-
zzY&Wr>Jm(;gVjH!vrbc+PZwY_qnzDp%u}|H>MA0j(K-Io-CbFsLX9GPUw&si2IO8)
zqvfa})2wo`xE@D^MH6P);scPHKs=cKXIOOf1GDS5=yi>PDz|cQbK`jpum5R=48}d(
z0<nzzOdR{O(lh(_29=<w-<(helx~DPRXSnnILO;iO6-e&wbA4u0FbC_s4WUzgk0W5
zChM=9Uid)8Ujl)@;Kxn$o(nH032BC$T|K}g0r@lQTiDma$vrX{S<?rCdlyY;o4d>u
z-HAO8hRq*84kXUnPNgf?(SyF^gRIoY<e;lVz1l3{94u@}+Cr4n{SF8Ng5e~pN5@@Y
z<e{+0Id@KyqPwb1tZ>K!0>IP~<C$J2oeJ#IYKqMD7ukM!b_ZoL29tiux^f2M4o51*
z?oBy48V7)O<FTg}YIO9(lr4qQRE6t}6BgNplW~oWxYz>7im(YtLsn8X9w*>q?)>6Z
z)t!0Dqo;fJyADW>WCDIoH4gA2t<Fe86#7Zg=!SX-M>|+szMqxQ{_#$nmsSEk?IUym
z2<_=<Ru6^Tbs~=2TpXL6a4&jQ$OqTSTUSi}PU5J3dPNrSS*MQara9YT9$od5*34h(
zfA%^>UJ8cg`0y+g9PwfAvOVUP4@6r$bD#4O8wW?C6rX?t{%?@Ijs9{6<LD@trex;R
zcMgj;dx7i;I@^O;ZyGDy2xVQW`9#HD-aesy=Imui_L|>tqJtwa*>K`JPo<<<FAViP
zgl4vxPs^yLCZ_&M$lJG^T^m`yZamwpqJH-D4J*T!y5$TA58;tYY(!LM9&lc-z81!9
znb4Lz8LyitbL(`L%yIh%I(Z((s!iHESb_nWspa4(te@&SjJvKW5#g#o)_F!kU)w*L
zy6=qIS@3%fKbIIJ#Hd{IM!Vns@xcdH?tQkEQOMibdhg^QTqX)Rs9Dq41gN5!0go-t
zzDH}%dEUU4Xa#?l8oFBpWeldOuJ#gloIg`hHhfAtXmLKgUe+^LL~h2UH=%Bh#Q(@L
zk}8jjy+P5j75U_L`>c3z8(CC2fILt8lKy!m8wX~<0s8w|LX2tm9bImo*T{OZ3;=oQ
z_n$5#&;wf7-j=gn)2l>e9Ox--I^A9tu+w{?0JcQ@48trE;=wnKu%sr^?tF5qbILuY
zR~n-)5?ha{q`fVA$>+Vv5BmK67NU%PrbPZTfI+H1$>mY!?QZz#(iB9o)u0p(cSWSW
zv+Ca$O=`J5`<J9pYk7nQglXqp`e{Nn`2=%=ld3=I=o+4^72cvOpND#LXCg-a=jd2U
zb7IqrvX%eYaRSNzuSR822$eJ_py>MA&d>d#j>q7C+<4J(={6pvU#!e(T?u5$ImC^Y
zk?;l+cs;-xOrYG{wJox8Fgp}!AfJa@f&%wCA0VZ`!*UqYKi*I~dosoWhX_Lbe@E1F
zDnuaNWZT0F2{;m<5ZHFD?3KgpBbj1Zf1PGWU;USW9pR{(>vgC5GCj*rrdiOl$@KQ3
zG)r##O?&_3guW`AWX6##Dj9DIyfhHSOlIvi9I|Ixp%$A_!^(y{4jix1_d<5Hv>EVa
zl^WPVG0@nqT^K?pTJ!46$;SW6Lr(Z<`94n-Kj+cs>-VeQ(j=0dzPb45mkqh`ZwPYH
zE;pEdb^KlpgO82BH8Qr3yhfiVkkaQP4m4MW`uufr`0M0a4ql+PNib#kEw<Yl7M*i3
z02uWUNlCNGZuz}xITRICyh*<7(|~7*v<)teMt)teDEQ&)(R<RWGbazP-%^=9ryH-L
zT~ffsEEFdYaxQ>uALY0=103(SFTU<803-(Ocjz+@D-AwYya73|a;(r_>~}<LD#(e5
zc=@gLE=Z@`TWl$I9_VH+fjh(#aqp39t_DF$apBvYW;2%4-#A`J8TbH4N|<<4mSM+M
zyLgQZuB@z@3dRP<J8`3p?cm>i7qMgp5Z?zbz&!KzgIdY$UN3a`5_tr%@KdMO+{Ab{
zZxiY1CGY&fr^$g|8O0NK>iy*j#+|HJ?_$f(@;bls4q->0ry$&P;Mdt_;3TXUi(akU
z>!00Ud%Ea{@rWGBdpyFHzMa{8&p0mTcO<qRY%f;zQm?KG)O#bU*HQC#NA%Ay?EYt<
z#wEZQH}LLWzDMln{tQIh2ke|I&$`)4i;DKa%|A&?<|K)C-sGpg8sWG9qu?<4J3F@Z
zPf9eGyce(Aa!yOSKAV#TdVuBlWLug{cQ<ncm)1^0mE~ESa6sBK*5p@u?npa8Q^a9A
zc0&<_XjOG|ph0K%zMazeQ>;KDl~1f{&RY4ic_n8u;BPsdSYCcCyg7b*3i~Z&qR^(R
z`&Zk~W?#N+h-UYN_+;Ypq29{jRAZ*QbJKx)9I+SwKbx9MO9O9AM&29r91U<}4^Rg@
zz4+<&DvEZAw4v!Sz!jTd*CAl4UNNwv)^XM0_Nh3<mERhD?~<XLP0mN?-HEs2=m3n)
zyEnheE9*6cm*|!7h#QF9f$lL}?0Lnb<j9OihKGWU2CAwbO+UA!<yA(TSnWO7rDciP
zyi)mj=X4fzxz)Ms`%_6TqA!X5#{J-ELS1cYI-JD2>88H6W)c9n={8{}w8DcGdcXFG
zt_K(9<(!zTbRa>Z=xL?N8|>xts$n&E@TjhRl%@;#L>my?(C|672_fxVfHW#`c{*@#
z>JH$|))ZO7$&K58JlIEn-n%-iL6Ao*-`F^BeTfi5;Ehp?^xDe(sEdy;&&+(OYHPOq
zzT}<Tsecx0(p8J7SJPyMB0<C{r~NQGU}+iU<^txR)ZOodszjnFdcw1Fz13aTHZR-Z
zbfNwDpL&!L0m})i;ssL&=9Xo+%jCgK3G=(j*19xDqd#tT=db9f_IDp)*`u|Amwiiu
zszY&KU4B^N<cLKFeM_yfN0u1dhT%I^7d73f73Vlv<ZWfHDM&oQFaA&}+lIO1b4|l<
z?GNperAc!--8PN)I0WB#dz@*LA3!N?ysZ1<+vpOKDYmDa9le5xsZJM*9-f{XO#oii
z;0~afl9IC{vLGVS5zPyTw-4hdA{bHx#~NerO-VlS$;FbYGm?RGgE!T~746juigh^6
zfc%5`Y)X~#N8Vv6OT-G?vl1G-@@nrfOy$Q0bMbb5=Cz5dPO9648;{MN{at5t+433n
zY3*c#3Awale;q|0p7e#0?iavr;Pw*22pzd?>nU%>^Y#50^38XlLP<>3=MO{N$^1q>
zcBSmfpbRVLKsSQynRLF()u+K>q~*;${yf?L+4)*f1XF>-_6QPn;y}b_Fr>uoZ+22y
zgdW_w#G0+#GfO}GATYUik_^RZyQQPthWX%J9anj?8)d+ad;V;QS7X6Dwtl#!dCc*7
zSn<5BGw5Y#8%5S;d+yA92kl>mHGw7+lV$3Z>&vA%!BaCe^T-lfRg{Du11^umEq;4%
z{fTd)n9e2U4h_{`y1)2FfllY2JGyS>?V?nl0YTrp<GTUVpI!RZUilx2oO@ZUbc(1b
z_!=3&50c3<S~`CPGaJGBcP1<CJm+p`Srw<<TqAusd+|gZ)ulJ?Zj58$DtMGWf4jO{
zV6E2zo#}Nz9qEd6ao=lG`-~MOzuLLKTKOJgL16l9`w9Pn7N`-r@3zT4cFUrAeCpZR
zs5YH?SRdJBq^D2Qb&dR|=BgP#ca~&zm5g_;H&N(CEla6&6En`G28z;?b=5}D8pYjb
ztkEmQHty!iT44CYdjnRXgc~^bJ@O3s*S+W@*@~k^K8-5ZRh$S5W{R^o6GZK~UZC9j
zgL6TIL&xB#JLTK8uiSTBXA*bG6w(|1&=%48{x`@Y8vl;M4Ti*t5W_cMJZm|_H-0tN
zcVn#HcwUlrY$GDo{z?_QaM5a;HUiJ;&NgJ}B(6!cPQfh<%g%57i1{&7*JvWe8L>3K
z)pLZjs|U;{S>syo7iaP_zG3f%vs#UmaNOEi*v&~_q__J+Ra<Q!A`gu*x<6<XSA`Ca
zoag6yud>O$eTT=^AY2?PR<o0|Bbscbpj(T>YXAM}4_}8z4*TD3FBBa?-H^qY0b9jR
zNQBY=)&AaeDe@$O%Gs;Y&yWR=Ir_J2Bbj)36=iX%k<0o*>ttgNW~zr7)e$RwWqYZ}
zQb8=&FRW&>#M~uL<M@xz`KTgu+4ya=7GM}Hj(<C%#aGs)?u_2Sck&2_@c2roLntzL
zH*|i*+gDi~>S>z|+*Pj<(qJG9?tqvj5X`n6+lQX}Cq_n3uG;3bo7*z3levUjR199S
z)$Xmdn8hdzaGLsOR+*eZ1SgRkc^&dJ8$o0S9idICKA$a59xaT|gza@~8&y8EltdsW
zbscF<oIOoz-ZgxaJlx$9UtQZfa(^_^M!pzlFm(O$hR_vRW-uVXv@UVhpR4m*5OeTP
z=r8T<Sh2tF_ev^IW#b4dkUeY~8(N>Pz?Ah#FFFOZG!2l90ie^LW|7ct^wE+2G=w@M
zEqmZoA;9jf|3j|)JKg$eq8wxyB~_Ucjew-{xqQU1=XDt90leL|u1A!Mx`J8K&q+h(
zY5??bOU|14Xh@os-hqXxJXG{(`lUpvo3KTF`dkBi{~l4gr;BVp4k*!5eEUg@$$7qg
zi5J;W^3e@v%x%flt?SDh{fa$F)IF;uFBIRt@*~N~=tH#L9w7szs1A9ipG!~^y!J8c
z+hgB8<2mDu%R-I7twcT`DZ=YzzvjQAI91DMP}2ZtM*XX7`0Ecbdfmc6Nr@t|tsS~1
zCI?KS%)Y0`E!rbSy$aMw7?;U{wG+yS4hsamKsH^I)hB9p#eCB==r%G7Lt7}7Une9V
zCbXSRqC}Qibo5u%)4^=8x&4!SW2i)>?Z)As7-Vm<J^lNnZM#KdS`*m=pv^q&-;e{k
znf{H%{6FWP{r|rJ{~s?w(FN!y@UXef48@`EVyvf%7|CPau!~D*OIwI^7fi?^Kb3am
ziDTwgh$I%8*^iot5fnYI=oR}?66v!m4ZtsEE41KM$hH7|Fwh@a!~%7h{a=N{FIfL?
z{R-CAG-%IAu=TIM>J|TGZ&lska$$9LfE(CB^-}XQ1#(DVV$qtv4^+&XL?TpJjCm5a
z3LYGH_J!6XY?Iqo4E3gikYCO!n)x5Jh31<8E0cvHY3Z(nT42|&{6fFE`}jHscIV6E
z2~2j--7gI`cf)A6XT1Lhckdb1)b_rMf^1<cAO=CCYY-3+5b0f|gMjoJkX}O%C6u5j
z(vc>;_b$Bz$VR&K-g^lUAoLc>UH<m}KgPXhoG*8rbMA-xX);2x)|{)%`OfEk-sfqw
z;w=r5Up`A8gwWi!C9bGfxcXMl4@Cvch=%T@&O*11PEdiQ8d$xP-K}@dwnsZkt2q8z
zN)X$P$$Utz!Gru%-U9lRB#%wejf;tsF|aq<J*{yva}r}#@<`%lWpi+4=x|zxMTagL
ziCF%8a!+!df`)?V?1w5Dy~GlaD2P`HP-J{lqt!g|#%^o^oEMfGv#94QKO-h-d3e-M
zs(@kbn=yI;{yK|(Z;V1V9aM2Q^WAtMPE?Im5*sCYpJ&yQNBwdXWYP7YKC&(UF(HhM
zZ>d}RuGXGVd%XB4ey@L|mU{nPxynE;PQu%<uc<8;oK>qHO0lP3Bhr>_S3Yq<dV$mS
zxteAJ^-S*%%#lj6K?$4q{LITY)+Jx20-ASvNB?%wqLp`O-KIDnMWs{mW%d0wnU(Z>
z!Rlya5ZxtQDR7GLjOIYouBQ5X>^1MHU$RrJS$g#6bW&4;as}K2dI(gs)~lrLR#W9f
z3qS)w&U-?aUu(<24ps=yy_gu}SsLAH_U#Tzm=Jcv!)tWk_2Je`2H#5a7e_M>)DZZ+
zG^cuzpM865OTT7kV8b_7hhE_y>M!@uuLo&5W-2UZPg7IkR6cQ5DcWy~UL^v#I=m0c
zdQScV>x{F>h@&5Nn@TZq?#Jp%CJri@K|4va(8+#L*VltV=XEyNo5k^O+7IBCsR7=r
z0+BVCnc|8|Su&VZ<RuuaKG;xJn(|UC**MAIyEfO#+*GltT1`!IUDflPl-|B(=OAQ$
zyrOjM<;jlBaXe|f%=$dr6x$vOXGO9jT9@YSdMjX}dW}(y2NqHP?e5P6)zDeJ<j!if
zo@wqIai`Yd^g(LI+UAo1ld5zW%30|eK`NuUCxsq>*6z;EFEWb%aCz-8KU@!?W|Stg
z^THJn^3bqv<RIb|)fUfJWMlHyH-$N_QS+687gMT*xZ0A%I_Toi1s29%_Z)*dYyvJs
z#^HFe4wme+dI`^0syUxf9JzinE?H(=U)q2CLG)W7Dczd6P2t#?&CXMGpe!d(A-nc5
z8~1<+tjy18@jx{=A!Ic#BJJpUxy>pE{DxK~wfl9=sk*{Mp<zIflsKz_l>xV1kBIl{
zQt2i-X+_@1G*HEamuP58lM)-t^>kRuNFcrJ`yDQ@m87@p5+ICtogn$od|x!pZMN!D
zpnHCkzLXg<>o+??wFWHM`DVB4mVe@B#AY(>+IEW(b3&_TTWjABI<|LhV8~lm`1f5^
zOqa@xgXfxY+s%0U#P?=yDej4W2qrid$kr{VHB{M4%@fz!_krRxa1X*e^waicKAu_0
zQK>-GXIj}D9e4KBoqa{FjAqy3=!}FM_8c&e2`+1#wP-cS)@j=ZYBB>74F0U4MWx#h
zGi2-ua1V|aCDB8tk&`g%i+8J;yvFffn7S*E9=hRri5cI^?zjD8;7HOGadn9s)4^Y4
zEdm96Cp2~RJkFl^v^KiCj5pQpi_x%r;&D<DaY=YPQ%DdW?Il)kA~fD%x@yg=d8W1b
z+CRRF#M-ZXoc;l{OSM-Aakxvxh%mHOr%Rzd^Mnlrbx}k~YW$~H*))@7km8bxGNWc&
zJ{oSLrYT8ihYr-Jw8Z4L2rKDlIdVF(G+C!&0~yZ+MzO@bRf`SaHyV_@+HVWV8Y|JW
z5q)i3@3b80QD%huH>3#rH>AjfmwdWWV(_*ZJ&iAF1e^-+=2#Ox{fV;r{*_Mt|DgF$
zJR(=3mK``&kf`IcV9jTQbT1w00<3NSAt;ayrwPfD4^QF;*0&i&cF8xP@}yd%GNofh
zxtF4Zf4&n?DBGXJuc?)ic3Vch8FEJSUh+@qM?PMkY1?~lV42bJdH@J^@Xlz7<r560
z{|qtV)4zlN|3kCv_h6{URW49c*nA?bsO-<si&Bjwo?Z3eJNjz5l&h>OR5g<Q9jTjW
ze~G?d9AT>k!}rj-lDbMtNF`Dqq>K;kY;lP3|1Lp*<Z~|AuDo&Rnrwc>C9(J%oTY1r
z;fI1Q4a=P*p%xNf*qGr<ef5C>+5<c09`RfqMC9&}6H>?B7l{>Sa`v%7(~Pp4>{Y<C
zv+wa@`a*j#w`by$hCtZ9&b)hMfU!K|uqb?1QxAFuA|@TW01)0t5nX%row>Oy`kbe{
zM<1>lrQ{Ct`slZf3r$8|+a!6wYr`R14SfNk9$d+>03CNXs+0q}UgkpVYf)XEw>&>m
zCBIOng%R+={4x*?(fDUcVPHkOZiE4l_SL+L`~d;$Yr{Zi#GxcZ>v9t>g>~&m2qWNT
zhJvYJaNg&fg6S%EKa_>4$E`zzdeUR6W*!HGzI)-+R?}zrDeXvy76`;+*;Rh|aol4%
zS0L?K^JmBF<JRwW-aWrbMMo=pDOpuf3`~LFyg0Nx0#R+XHu9d1I-uZ9hTDk(*zAvv
zuXTItVCEh>Dg=3QGz1WX7&9A7P+^#eMp?~&wm?Rp<Aa;+KBh01e?hW?J8*)2)t&|}
zX=<fMTRf(o=|5&xlt+m;dA^Xj-<m*wGiiMLEqBCjnPD+{{8mZv9n;kjN<qlTe03Un
zo@3%}5U9NHoi$p7SFCxF)r_RqY9Zm11j2lG4rUO!wxy*XKLKHqbF;~c!!Sj9HGRC^
z2tZQ~I<&FMT+WLp5#ae3Im0i$RHScQMCk9k3+@JgU1e$iQOkI%KbpgwzAKqucLs-#
z1qJ!fva<D#{s>Q`PR_^hy4p&+t_CY}{BV?r_G@`>PoGQ(W2B>AF@ad1)z@FTkRA^Q
z^n3-UWr8TTfE`)Hr|i6vxrgGp$=UKob7P6a2BYnQ_T5V=%E~qXr#*ZIsGW^w5cR$p
z7+r@Eq+_<Zk&;R;kvyi;nP1h^DiV{v`>l3<@uFanQHA&vRBx;7N4nm7aH92GbT|JU
z+d_-yL=lB@{4k>magBKWVL*+Zx}Q`3+&Qm<c%HN}_1Txpp?pm3dhi;vbbpw*3GLPI
z>g7~>jfs{jQ;*;veUOIHyLW0!OGd4v4%Eh_L4{8bg7VIe3!_Tc+w(f?B81%OsTQP}
zlQP~`b=?)6-?8~U`wF@cxSBMu%Ay=%Z}Q$y(AOdQ=JIbZ<jVakITFOotS8ug{>L%9
zR~|4)G3IKA%Ih8eJ|V&cijAt}52#M>w|1Jhaf-iZR!}=K<%QmnYbGBy<k>Uk;T72`
zaozu}CiU%$_2_E+fPS=T$*)HRwm*ajN+pdyyv(W>Le9<DmNrY2d%4YSWXm4x@SC{Q
zhst|utP-!1N4Lx+E(#l>aBpfA3>!&lsg{{n9OHx?^ooGM25vqJ_{EH}nL0UX#GU`h
zd(J6V4@D#*<a&(>&CSpsnX<UY<C(FF!^OUhr>93hPwv@)MC}$ojSe<YD`yS%c6X18
zANJ+I+9*J55z6nm>TDMCJ#cu;KTYUS@3U9KnLjAQBZ4;Vnet*Gb>d%E7Mc1cm7^H&
zdA!M0=-7T@AaYDuLYqnTQ}P?(Mv1}5(QuXdOW7};!S$4THx8|>Sh6^x%a9=X(X{J#
z1Qe@ZQ;q4Adj@zz^4ACUfT>MwoE&7sAi*}G%EN!T7`0V#LCt#Des<Y69hahfG_k{W
zv?*?5Xe9??>k~JAxw1_EaBf;D8@?08I-mfV54dVuASXC(rp!mLhfaBULn0^B7D&hL
zT}(F!v+$&dvu5!*c>tU%IS<v+96(NI4ZZP1`uC%S?I<VLloVdHv|;h)^PBq0t0Rjn
zm)dgZ%W>Kcr?u=BDG72=jGAV{#Y8h<<hEwD{bZ%E0ysniv+#%&7WJ+<sMHrKBTd1|
zjbH^unSwyHtofoXCO_*+OM`-}clp@aUXCv|eE$_4%Hr%a1f+1n1De5k(X_tMGRc(E
zaDC}|2Pz<p%rG$%lmT9&lkJc-+HgUujL;T?+TYfi!V)8$rC?^!yMJAjDJ$K$!BNWk
z@p%%Qv){zbT9r(0@d1p0UnDg(ha%r9O`ztm-V5JGVIosASD|-t=dK!PQnSwII&@aj
zVCZWY?c~jdTggnOh&@MCGskj}+MG|4bsR}J*f#yy5z%Ea$6l4ohu{(Cp`D0;<7u03
zEz|WcSS<U~mgGxipH~%hzsP!06={#lENESQMv6UoA|rzi2ZyAH8e2zygYtXqt!Mb^
zGGG1*={D5XHK(YVxZ(1}$9u!?#6-bXhn;-J(!twZY>iNyi~cfHz{SN5idS)zLptDC
z4u+y)SG!_NBcJbH+8qB<C}o&>`Z3BbBbo3o;b3z|gCnhllfUiRr^IiYw_;e|>!w+t
z3th?C05jvqAdnf{HsWo2NAoAeloU+J6W7=5Kj_y|<(n%AXL=ew>94&jT-g}UDU8q8
zCLyemHEY18C`Mw#!h`33nlFEG#;7FFwGjq328BBsFor+lwCPIBa@{i6kn`R5N_xiY
z_b#&gp3(!$_~PB|nHTIbW~D+k_pGx7SbQ0(aBoHe8;G-Y=wIHXI#%*r9KmK!84Yn;
zXB{i&@=B=%C1dQv`8Nq}O-u20PaWRwipO2;V&ZqjTsDg-E9Ao5-$vpj{?P$kFP#>P
z9#Qakx!pdcT|MZxtBVf`s(6KMr-r?0&j@z4EH^yTx29*4@L6joxJs;I9(WTvlYiU$
zOtOE<%X<0CTVptXVKIe8UMd$Kd*k=kW=MxXwcQb<H=@(;mE1epEi#9NIPRHK@qkq6
zHD}5Agr=SHAJTf?#(K{k>{`H-#q{>q?`CacY8ebAtjvbZ6c5oA3h4R3mnq~92IE$6
zs>|$qy%8Y=(3B>EZ_?6V>Z(B?<Um{3I+qax%IRI05I^bOVpW{1j)3P!+ha5_Yx@(*
z(t)$YWvKuPHJBGnUF~=U!l<k~RDUkhB;3?2)j=MC9KIxafxNBSKfmj}hz>kG(~$Q0
zJR{67m-q_NaJ>T(gcrK`=0yk$K<b#cuXW?hV!ppEkFd>+@{R<6z@m3vmx0trweu-D
z+QQ#tPb&o-{|0zgaQkT#m(6;o)LW@tGqm#gaf%#z!6XuR3ffq?f>uiHGA;?)=JIU~
zf%vnsvk`t$G;BSFIl1Q5E<dF|rIH(ET)ddR{Nmenc-R{rqK&4dn6dhp&q9eSj?L-d
z)I$mL@S+TN41GT1PH7*iS47Wy!bg9RNr<~ld|aL8$ts4Mjpc!F4~8{F*iE}<>6-!d
znCcw>dN{&}>|982GWwI|B2*7_c!~N4NkjD?PB#@P0ni2l(!s5MF+TV6H>^9FI@0H;
zSHQi_!G=}65<1d-SI*6MV<5swA!*#oM15Dqv7BbD_%+L5`uT*;U53H_^H=Yto6Xk)
z#cig)%63c)cL@Hx?QOooX!f%`kT<IA^z{dDWr|$Oeno@#&da~PN-j*h5b)jLPZAub
z+>P?nf&k9D|1f^Mhd%?J{LjAO$8X?|)pXNIsJeY!5f=bsWayg^(f~pAD}w)+i2QGA
zq)LmpmL9l6Z_EA*?PRWBUDbm8GBypyZ)}vz2ToWYSs@#1_V&NI0AK#VSO1&N{_jxg
zy2I#aeJu?$gV>lwOuI|OJCUb-5x__AxeG+Kh|-7RBI0^pGxw40ugQ-hHh?%Q@^NN>
z+*h0k!1amj<PKSgj@4tSfqn7~M3L_mX}U!k*L=J_+d_xaP@&400?!Vr3b%RBl|snc
z%YqfezWbHcj}=VWLYfS|$R3m0IrOk<xtoqRkqP9k6-(unFm9JODwQ9HGs*4xm~VWR
zN6pSE%RN5!MHuvOa<a>;u5H|!muEKn?(7Kw_oF_bX-e(Uk5sahO8YOUlknQUsS2}^
zG@~PZ@7YDkg@n{ZV*_+1rCP&R<)oZb&AsW-noqv#<3`H5=KcaXrD>I(=?17^VgeeP
z5s6TJA-k5<mBLR+(K#2Rf*54@xl>Yd4pi?Ix_J}sDqCC2bMte1ca!ASS%a0o7-oqX
zDe!na!wu&g%PbmP863eHi}=lWBz<4tmYD2TC>B`D-@O!Lfvd}I%~AV`6*tx+*(584
zS!CYH`b>>>Z4GWfkQsif@OmSZbK!IJQ0<_0e~RJj^)~r(<V_pksDm=?7LBtq%NMD)
zunI;{L1mJ8czIC~1_YQzQEh4IO4W60n#+a)>GsathDmXFns}U*^;F4nfZ(`A6#nJA
zU{7}%v7(rAZE5`z>~a;<!nTp^=W<#qk=?g};C)xM;OafW`qj)WV@B$^MlF}Qvv?_4
z5}SMt>76v%G1%GKm(;tNgF@OTHdn%(QpSjQEOpCAAFB8eLe)u@7MR6V<EY$GyN1sA
z`n*hok)yg8gWdY_DY~jmYhJd+4|T<H0-Z1VWU^y$;7mjm@!-nrb_pNP-`vWw;3{nw
zQpw_A<sQEuA{6Dj9ab;C2W0dp>GY9)%2!c4>cc`8ZV_}0pp540^U9Pk*9Q&*G*MT|
zqs9vWn0c|Rot#HDi#}33>f?4d-=GS%Iu8mC@Z~e@>lQ*Ut=O^x`yME-RXLljq>X+8
ze6VPpwnfr!;e{<O?^&~K#NSt=F?Nr8!31up+EOfajb6q3h81Jbjhtv+R^IWnOfJC|
zqO@=f?Wu)1ty?~Cc$&DQiu$&gcw9d#;&EXa{$-_FyPJ1%sqxw`+E9jwa&MElOaV1D
zsicsgAU3<*pFPN#_ZQDcl%$WlR;grI=@hwN>52+KCox~U-%!=e6^rwmTtuI@uik~n
zO|%IX42E9c;Q+(E7HXL}%pQ$aDusn;Px2M?61TlGEWwWWxou_ih=$6TcYb%m{KH1e
zpt_CoJ9Sm7@;1JGOcxT8l16>nbLGT(ly<+Ps-nuCldb-#DJQsdCzYpnl9dG=7gSSb
zgQR5+mS1SKAU1QS@8=MBLBm>?vFA%9xta@F-D8VlR6wys(iyaDb#IYZ9NC}j6fB!8
zP?l4yZk@w=B_*B2%B4%_#SLmAgGkO`4|#H>$$TX9(K$bVP1P7^09(ZTyw<2y+{Gja
zK#rfe4<F9=B;JKrIJ+Ee@$FwoP~L87URfP0E4oLi?XEo@%f>D_ardVq0JLHsy~WE*
zoSJmuQI<?s<u^OL|Eymo=cRaacaLg5u#xyR%^P_c78>$kOu>Dpsi*3(C|Aq1tGC8p
zp}oz}gr2m^YnO4ZWfgFb)%~!oz*Up-KD|BbDU?%t*c4>m_t(x*WmWFmjH)Mxwf$lG
zu7#sx)DW>lvo2Y5ZPLZ^tTHsrOM$VuLBJAG9QF2W)~e@+A1ISY{3d4Va46^_E6?Nj
zC(xRi<VF14+Hig2lK2&HvvoD9gsgUQhUQr2vZ(01yz+o_Uwy>PYA{Gy#K`GP2ImnS
z|H@ANeW21=uo~}1m`(X}t`xD`pc{`F9R|;W(fSLubZJsDzP%8*tA$HLQ1@2N(c|ar
zndO7$=3ZkdI#PVNA1%#dyJfqaL|kEelhV0=Md<x>=-)?j`3o4ICLU!?%uGH8u`N`2
z9;QG#1qKK8$WNBrANGIBjX^Vvg$7Zy59lR)VAxmG9AoXZdcUKGZa?%2CGQ0)_)W!X
zy`Xz$kK#E)A(AK5vrNOI+FB_e4<@`~(2PT3!dGqU#5cU9NF~di<HCw*7Lb~>#rwr3
zi3%g^G$tMz=GWrva3#kP`9vn?xy`U>#l=E%-pjB{^JTm1<h0qVfnQLxOnU;Ixc6nA
zt8!q|Y5F>E-m$Yp#oBd2`F-|XJz$Nco6h&so^w;tNBwlK#PkNhK|B^|64{>c?dOh@
zGo|DLwjVQ8Kx&4KU(OZvU1oN>;x{%@$}wA(OzPibY}{-#jdPx|BKz2K7Qa7~labDL
zb$^&W{8T+H-fv++!-LD=63H{-+gZ)UFagf(fUDWp2!OLT?{sk*JKg45DW!gDd3)Q|
zxrJq(CZnaI{>XHg{K~7ww&)Tm{53K`z0$KaFTCp1p2AKpazmnY<}df{&DCS?-X|&u
z>hzL(e%_iv<@)Wj{FP0f7m?`u%F&3r)B1CBt>WNS<oRq!kXgEOGlHgxi>so}QH~ki
zC+v(FDa=)20;@n|`)y-62f&@8b;T6QP#I2et$z5fW8UDcP|UD(H0HLOggO7rF(QKd
zr=8%?qQ3Nfci*%eM+xh>C2e;~GV$jyPff#je#QGDl2&Ny)U<ntXKoare22Eh!vVgr
zhJ(*MUNHK{o93LRyEGE7JbUXQ$jApLq}{WP7eSfpLu$>}eBc!da^aWP|BOMMyV{tN
zL%^m^4wBW$#j?_FpPq5*?5GTiarkjvPz$f0a;E=nzXAqFs6>?uS{v_VfY>e^jwbFz
zE>tmzZcDcp_WnbqLhomHv^NTYd(C;I>*C|RG}3doRBID(0Eal9ojzEt-4$76e}Cx0
zB}CL1dh<`@R*f%_U~`nU7MNwV9N}bTwO-)%j0+sdn}29;I7ipvw&qqFj&+roB<t<%
zuPYnPh>(ZNMil;VzVPlr-?8MrS9tDZkmNy4N6s(lvNoWNpLu(q6k3WTTdiUqe1mp0
z7Fup*q>W5`UE$hMbf;sWHLp5n%`##lK9<^c)~0>Hi0LxAGMVTx<&Pq}SsgUlP)!Sg
zG0xm~Y^N{)EFw@Xj=K)L;5B~onwRT(;b@qdb%eNmeq6)%x>lp>?V~Q3i`sm%c+DHJ
zYad6Wa69a{w3S#|G+P$mgX0l8JxQ<5#(Hs^i`*>d1KSl-*R#{#QMcoLMkWNmIBt%g
z2n%fcSJR4^eMy&<Cb5dh4-HL^oDUyJ+UOTkPVCYM&pJGG%oM-289UxQpO;+QQVxl!
zi|_4^%rcytb4<$!E&CK}VHGd$HL+#yY_sQkB$MUoEf5=>a*V<G3wes%9=@rqRWB1v
zk~U<3ZfQOgw6Z+T7bVM$e*y$*8)fbj;6%MG!Y&p+!T5X*WyS;b!x5Fa#zFufz9rGv
z*y24UovQ|e9iEviB+jlJhEeNT*&+pg#$U~uI=h#7xcaej3wCKvuAdT@gzz5SPfeLG
zl{s{AB^h9F0DC2Ftw%8IO^U8rtx>z}k&a~z_ObI(#Bci~ZN_-eHz%so5p?w#QHz61
zOb%*=W4dJX6V9CB{3e-zIBu}gqLDVah?(s<r)WN({f_<A_avz8dL}urlU2-{;ceF_
z<v7%=&C8)ip0j~Xe~U!f9`69`n{^#RyDpZusY!pqwwbadX=wR<S1UImZ(T*E=TGpO
zD-0>ZOJ`Et6(BR*_FLRg7Bx2uSx`P#xo<&u=*8=UD&d1+KyQ1(ggfm18LZyUI~RE6
z+|(I8YJw65c2khAS~I)aou5s{E62yvymx``e%S|PZa<PQ{(239E}eTUM9kC0|6I>j
z#)M5o+yJP~0|(eO{H|Spn;@>Zbc~(t^=3!LWODn&<qtu<32mCVwRmIW^K9+wjcIa_
zUHUUM4MWov@)hk4PUE7ngZuP+_VQM#E((r(l<nb+4?PSVAzOE&Y>|{Cco~iCzeP&R
zN4MY)MhIbN230To^4WD3e>UeU-Y=!(dBVN8nT*29yVIl8xavrqHZ;p-n5)x*ctm-T
zwF6QdosSyocC@U-Qk_*+H@2U<tZ0^rY+eYj>gO7$rZl<hME*!kk#2vUMJ|JWBr?UC
zGu-r+I3|MZ=%5)Z5na=b2XS%Qy28>*H-SnxIa*ry>#_>X%%~`6>TR8mi!7Pi=GWRc
z)<sJ{=U=d8Ro^GBOrojUsc0M&D28nm!wil~Wot%n7R+?H%uGHl%na}SxJ#R~u`E6V
z6^%`Rbv{Sk8w%{5l=K>YF=5)IY5TC@x+)r3JF6Rdeu8s~T`b+T#WVu()CvWK#OoJ^
ze`ZIlVU_i230XC<)t9OHn(MTisjLSaL}-=;%Gs%gMrlGU5JC9Z{nI|64+7a4gzJkn
zD#K5DW*N3kya5185rgY{x@bkHps<j+%hMaref5uf=MH*1Bq$c+cq901J)V@ZL9es{
z6z|xiqId$2nVPYc-fQq&XyxE@akI|ZJW?kYED24c&8?Rv^^(snpp#+^Cr0f;3^<9D
z=6UYoIY}xF3fW<|y;cFER?N^+2e$k|aU13~8DxFOXWO^Y_2^SZHy-q0c<L_C-BQ`G
z7T;DA1r_&14SyAourIsnpFn<Xr|_jz+Yqhycxvwep8$#LV>aPb$i~=+7ARLColE&!
zhvUsNp^>Ad5-P#jNE*TC-D*4(bYihqLthsV22Q%$<Pnb+8QEVdB}saHXz#`#2nS}h
zUt~c~R$>_<BwsSjB6hyW=qbyF(XQkJ*LD(H3fjx3Qe~Jxn2zB?Z*2yNv=^^Zs3aS1
z>uq@S>JSTR(djxYr?4F@@PuuRAr}YAOVvR|twTqjOjS-nRoHp8Y-Lx8HOwI1zTOU*
zUzeT2`D)XRi;EJmEm1NeG^Qr~TZNS+wZIdTH36?CW}KTJ{~iUKaH~5tP7TN^kTHf=
zwKpC2z2=D-sXSY9R~$K{RG=h&HbzR@z;=QDz1=WZply|}Jv%)e61zb^lNfER7NCv3
z?c3kqi1uU0UcQ-5WL0t`NlJ|4njz%UuW*NMvrMxU3bs}9aGrz-HF_^#U}k+v3Nwgn
zT-NZ#mxxVJ0oQMN?ni>yyzQ)C>fycpGq#iJlkQ`4k+(oa#Y;nX*|gz~>-fH+!~4FK
z4$hesZ<$hqf;_PIvYS)~>1T^^--lgC=a?3sP`Tg+C4lMEKKGONyn#R!(xO}h#5O3B
z>Nxt321ni;t+>qgUuSzSW+zzI><E|wFV<fA6+50iYra%j{6PN7#)p;nY^jLhr3+!>
zNf2x?tbSEIDG$=wk3CGb?8rSDnoj+8Ly&vD>(=Vq`279tadXdC2vTBi+q(EkhzsIU
z;3kww;M1y<p>%ss|9tIp;pLAN#vI7Q5~z|pdM=^ZfqbG+!RNi3rjI!zWB&!C;LBOB
z2`s;AjrHElLWiK={O1?wC|`o@!jMsqcAw*|!B$=?QX8YI(ZG&$h0f5ncQlj57DCD7
zbxf+e^W!pFDNg9qS=G1eJIi_PyEq_B&@rB^e3Wb&tw?c1#XI%a1ME6ugWGU4Q_JcV
z-^!D@s_{HwOtxuk(5b`rVV@L6hg0d4uFg|B;~8xBN=x_~Vaw2He&$Ksud&p7g(Ges
z+c0efqqTjiPIMF>2ER90T$GvSFD-3=vxxVGx2p=c(T*;3bSp2tzL`B{<P*To*KCQi
z_PWMA?w7X_@%)%BaKf*iR^@F~S?GYy6Uc&6PI#>zYY|V{;$VlhyeZ;zbxz}4-#(!v
zdC2hISh#vQbT%$lw*&l-39JlD++sKBFs1mcs_}%8wDgQ>^9@i;4_j*Q{{#lF@VfXO
z_nY|2$v{iaD_1k>L?0BDj8^DArp{or7P!e?NZVzox=8*aBT9U{o;4-X=!qjq80KiQ
z=r9e`zLtaO|MXnWU@%3mQHtg0OkSM{YPCzmb7|!DWUb#*Tb-aDi%^yd9C)&k-ynx9
z8*NXl^ijAv263FQbPV*DALZNw^;3c%=WE09R2?NiYRK4DvpPcA;4JO+%MVO0b*Hm7
zz>Zx^*lP8-<(@6BvBf0dQZh>Lh=?Zv_kQdi_0`;7MXye&m#Mb7Qb*bRK6PNiI_={~
zh>@wL9VCgU>2;NHMrqKOuq5pkpNse^S<dlf3ZS6n)=HLacf-?{>OozZFGG+1&1K^;
zc-XU+M!3QFQB6<~qzlALg86}vz^*e}m|~`?VJNmJ)X`(TdryR5?Tzc{+zhCk_7@?k
z$*TM3&Y(1K*14=of;rN!ACc#)W=>%M8O`wH4U9^|$E$Z7uXo?ow+M%wY-?o?7ffPs
zRwYKeq9v7qcW)?G_iUon;x9{6ydpWc{~+kRPrZ6*&hTl%Wz}Mn_&K2bhhK@QZal3*
z4GI3_zIECEi_SIiX4Nlu&V3lb%HA;lpTO<@-++KKzbIImC<Q+5<a?p2*E&@Hrrn>=
zVMe)r^cpFVASO$EjvL)_>{z>2K_3SwOvkBl{>k=#!-INl3vHv6#Gs9S9Nt}@vP2>f
zSJv_9yry{r53EGKhoeg0l@dRIOp5*dlk7eR>Ol~@k)j&jUVM~17P|{ptJwTODp1r)
zJB$%3WT6?_s+m6;w49k1a`P>`Dhm<Y=<c3&Dg$IAn{5w?ia?CAW8(D4SC`4;YP2Nm
zXA-O52u0?f+*;coPn1*<EdVy{TBnChZ;#~aCPNZNevlg6A{@Umq}PwORGDo}XMGmS
z#{L`zaYDnUMYGY^fyXi=E5l~i=0Vgp3;<OF@YbuoJ3?4nj+1&9q9(1564lMu;s6%r
z*yo)3+H<hZ*gEw4#Df$qd$)HjYf!!Dv8OKEv%E&$!{|f3(b514O6nxiG+~R=IqLG-
zK3$x}1os&q8Ftxjv>Iy%QWayEIqa(yX9k1i9w7>-D0YhEy~?WTgd7g-cmucGITwF$
z-ksfGogzu$^B%~V9(@<`qjV8+sVe!$ANTQBYHKBP+T(g$V9uHgw}qTyzyt9e)y~i$
z^E?J_MeZaK-+-V564Rdp+`t5Hytrrp0x9z{s%rh_G@F{8-Ei>4`g+MnU9E(sU5biF
ztT1k%EKN-P>QpX}8Z=_lvnuM+>l4+5U~ovjUBFdr${}x0A=>3fpI9L|h^HVn%Lg=z
z*bW9d@>A?D>rnGusu4a*s})dj_TIAq=-S$eB?knjll{xFtmC1S`dq)B)#xshdFOyJ
zBKP)c@~TFiPSn+{6T;Aq)Ck(nh7>ktX<~;=1OUOt**%@mpx>N6GdUli>#4v{-@rP_
zAN1y&dmQ%YF~%(L4NYFkCMN?mG)%Zk8R@XXd%dPrVeF})ql2uGv@+7^KF_ZwNFZ60
zb{HXB84|Bx-0N_b)za)@nKgK**?x?>0<oDYuI8-V^Qn~Op;~s(6V)8_<{YiA;PFYH
zvf@hs4^p0f*vyO5Q2<W9gbzFexwZ_)L2T3KUm{(qWN6P<3c?B!V;(`rO^Y6hfpyi`
z!~-u>jfK44K}5YBQ}gv5>!%xR<aKs`O`ECH?LwsBUmC7hSwx08UvFOWxdg~Ht8gbj
z){-zaq)LS#ALcVBi+6fLBtPuFlzTiFBA$*=+2YG8kD2-sz72!#d7C}rvkmY(rrXZC
zg#959k;VQ$2uCMy-`lY9V&89C6F<)lwjNQboX=Qw9zPTX@zAG?qmfIb*#rtbz}pEX
z{hucl5~(+d^o-`Jy_{tvKrvD~MU51Hm~o%+uAh#6RZgXMw+kp5Zyz+!f`|iWAIGBt
z0k1Ef<wwGqO3jxFDEP^Ce>uLAMz$;|s8H8k`+y(lBE_BRyA6PXC%|(<bPJy^x170K
z?KZist83}}HP<Rt!(fZ0d0pF&;iRoD(yL;jror3Kc=pC1B;?p<v+r!se$%f<+AVOs
z(QSQX;<((yYHw}~t#lh083nM!$!Pu@+?3DnC$?EBPl>>nsO8a>3VpJO76jx(gzg<c
zHDLO+dWt2c&K7=OV#c%q0y+rTH@@HkS5xSe8}ZYW?}%3!NXrlYG>6%5H$A$F2m(Hs
zwQf?cFlWT`CnCb1`E1zWl52WExJCWAY=s%#<F@rXjzbGV3>=2<PIYd9E&&8!U~e?Q
zPuOQW0B$?qf2_#=A^9JgO(FxY6_ocehR><PB&NHyqq*(!YqNL8>#i$T63LcXr12Dz
zh$K!6;E}yqH(|7%%kZw2V=S%5-1JqT>slo2rJ8$`I%~+)khR$9w((A6%l4plbh_6@
zG@sjKA?y(ShX;D@{V>Bhfa~eXg}<bS^>8ae7m0fLO5pE?Hh&33?n5c<PU;wC13|fA
z;oGf0G|U^8zcy_Z(raPEUCu~Vs!gpK*+>||!aN~T_PNd5^V#6-A@sKblmU{r>H{4k
z=K2@Lw}~$r>3oa{Rq-Zem<2;ubr#Xo{0yp1$1_Lte*6{QPR>|1(PL;=XEW$2`0|kf
z6=(Qts`f`sy5t&SM&YY_I(8t9)&)wA9|-T4n9tTJO-M1xtB%@;Z?{Jy7z0J==YEQ)
zUEt^8{5MGK=jIwwRNd9ZV|E^M7A}L+j#IM+8J1+YQRJzopM1Hc0Jy<UuBAl`Gpts1
zN5!|	KSDGkaI5oV5JKR$rl5Kv7v;v5U8Y1zU1FXUO%z*v0E%Apzq1k#slGOm?8C
zDh1ldrSr~0`RxTl0=6LXgLjb=FlnwGPhQglzeow}371iwTUP}**W_cmf|)3?sCdJ`
z@|n7ZhO4V<y5~x;aSe8=BKvIsAz-1Pr3sLr$M4x?6lWeXQeAt?T-jhwrDP*)?Yu1~
zlM0n0simbW$fL3##y+^Am~2_e`ClR)*buTG^a3F-faHON!&Jhk>6^8J2O`(OrC3Du
z$&NS!7}14vEDe%`&No`!E^x-08FTyXW)r}pO8RfT&W;$lJtf5V;>!AaBcVPBXZx0V
z7~R9Y+@Kena1umm@)>kBMb*b+<#TwCES43AnmSUO9Ssi6>sv_R1c$`wx5t8xoU<+u
z_Eh;R*hDJK7Dl9-gXE_ZOYV4ePj_t9Mv>s+m9L*4SV831dfS+!stb*|Z_X;s2tn7a
z9p%kPFGsZimFr8n>QT$x`TdP#J9QG^uvz3iILlUm*p7tx_O<McmDLch+`mb4RHy;b
z(#`^kTEI-OI8$#sUi9<lPj1vz<@Pq9$s=My*huqwrq0i=UKNUsC`}!|=$J)8Vxp5y
ztN2_g)j~I6s$q0AYwRmY2+!M*>iOWpY<<2Dn&7PJO~L14L$X(KvF*YKT@Q970alGG
zTCRJBrp}nV%-6`r%)dAxX}s$C@MqzsRm>FpOBf9<$1e0~y2y%?8|DUD*fkQi3=PoV
z%rYB|g>$BFE^(;)^$N|l%z3}v7C$)@<@OAg_t)ARqO?g~9fdb96%<J4^zr-b6nvny
z;b4ohQy)>UdjD1;IynhSK}9w>8~=go#-~g^CrSsSl4(Svg^`mQP@qrMSFA-;oR#$C
zwRIn4-=U1^qCYea7HM)l%Cz!jpaexJxkHR-r<GVQXA&0?=c^U5FQv%3h`b(Lj_VkU
z`<y$Oo11%iT@Z6OJq4%x9QGven5Fq$Zt<9PYQkUum5vN}m*vg!*BF8z&F(kvvs=w6
zVuFT0HdU;DZT#fz3z+)m7Z*oWXI<TC=6eWI8$YrA2q^NG84M~s-<=yo%K#-#;nRtC
z!68Z=<KFC(T;*XqKxHDKf!XiIDT~mo6PE1Or{IufBLnD@D%JJi7vV{bT669v`$O^*
z(<OAxLLor~bhKVGK|y1Mm<)0N-U$hkV8t~};Tk89z9sOR$hx5%`h{2gK2;Mn3RV8@
zs$!VjAU3pSo|>jZe-i~Dg9Z1R>RtZKJAGFjlws%XDH0rHokGVChG!qBN@C84;uHbt
z+3lNaTqJ{dV|DeI`D^9G*SS`MX&gFbC3-P~*}w!S_4m-Y>TuogsK8YLABN|ov<nl5
z5IpMd&)*yCe=3{Z%~@3n=(LVJcNye-P2yqCpUaut43=1|Xyb@sN}9?kNu#NmoD+lV
zt<`?h)-e|t=Y&~WSx~q4m$sIZ!M3gzy7mrcTV@e!Q-IX~ZOo%OMtbB5e=<_+yUVp>
zoJ;%zva%48`6{bH!9^bp=|&i)*0ke(+_ow<@eV+f{U)5h&C1K)_H^a)Jf^fc1(U3J
z<AJ05xqRHi%hKS-wh*4E0|IHhRn!MOX(c#ztw37ymnt4K5NT<f&6O9XeFNQ(fP@3o
z$9tRO(d3R~a#R|3md!+NKzwni>5I$x<C1#5k>Dq)seL8&sW34m?v?Fr=lD3li(MwM
z!AfR!NEuh`E~Vz6Slg()h`traG$&}SBFCb#+9Vm`2*c+nc-9$|ieKcd>FP%Xg~xxp
z#*Ux9Db_01e*eBNMpfdE9Nr0La<Zs{)&?LR|3fygo$n_u7Zt66M1@UG?L{irR8k2e
z><7;pPB>TqKUUnP?`*^#dPNW&^1H$}s7_w5<I~bRQ2&2(0puicPQzaxYs<CF8E|bs
z#^2p_G${8emQ9s1@M&1tj}Kj_u|>lzyJm6>m1kL-F*9SMK*qkqK}F1UFZmqoT|<#F
zQ^%C6XBA!(F5lC_Jz?K8w#RmB-04iZyCC4+x=??6Wia3Hb$bl~bRkc#+@TE2>>-Nm
zJEl|Pw_ZENobpz<8c%;1dT~7MBq=I<EA{)Xnzt~rsJcHL0Fk}A>KF%|yNNx|`yxnt
zWNRizmpNmReOap_HTun7M;k?DckujegQ+*S^A}K;sHxv-3bVDFRc2)bMu>b5UT=+=
zjRXR;jI{K%^%=uV8&CSKc(#zo6A^*R>HZFq2nf7J2<fZQw_FKtF>wsr^(j}-hoBLv
z*u~7Z2RAUg2?hZHjL6k>#oN<uIVL0cuYC96h4JE5Ks$Cf6^*QaVHML7q{=IR8EKZG
z&)uA=?Z@4BNRBUibliz-YfEP95-3l+z2G^3o6aH4kaMsN1L^xCyh=F{RT#&O0@@SW
zqfU*5&VY28X4FT&KDG{2*VsLi6KTHEZz#!UC8f{-gieWWvhLnY<}J?g%(@-^pIXEJ
zd99<a1u4$I-evvw*J$E}VN#hKpI;EmK<w^mc#5MMIqp*FNL7d|?bfK>(bAoB=H~A5
zD0#St5R;}jW_kh~P2-hUTPqOy28gK=@OzXd>dA(z`9iWZS19+XxD3x%Q!grrh;t=t
zVbfGy$KcZ$B!mrs|3BQ-{e@2qJ81Vf=wYUb_kX6!|8K#cUn|M6Z_fCBLjAHwqZIAU
zLgPN7B@LBlG-%^2Ui^nW@4xu*e;~umREp)m<)sJWQ_HvC`Fj_725UDN;^TP^J<Q;g
z38&$=ohX@>rFsr_+=IuEkcPrqcCM0<3lvcTjTuS&b`u3^*+m?8@Rk@mWWGGk(Js|*
z^8v>klIt*+>&G<}74_opbts+;y-JsN_b0>?^H2CxO9A{!GgiOUkimeWsTy+qkwb#+
zTW+Pg_*j|We%4Yh@DGhx{kZyIAk-eeQziE}=SP;cJ^v?$w=F6y@!YiUSu~h$(&RJL
z#|qS>a@F<p3i)Xa!b|ghWL<p<0C*+ke>&blV+~Xm0=#?1%Gws-?f^?~apQ}n2f%3b
zinTdq3bmBfbOGqW6AzTZ+1*b9;VJGq=6$IlV_K%$@D~23tA7vu$OT6fXciT50rwxz
zqjOvmX#A=F{!<|Ne`|iAN22(RPkc=MjxsL#ud}^XE)Le#CH?Gg5RV3~{ql2*uk+2X
z9qOV7C0)yohKs$+t`5El8gJe36M0Zx)n5M=G}}1E{oar7yxE%VLhkfmDM<lmxFW=#
z88PR&7BjW!r_ye6<8vMxZZ{e<lHa~iRP13CJI^;eGWC;ubIW6~Xy1>hPCY3r2b@p-
z5gozmdt2*B;7$O}#&!Ti=;ixURwZsRe(W?W#4b2U_u4ppn&30{w6)CPnUCn{d<i+U
zR4Kmn*P`ckoWK5J*oCJB6a}ZcA6hlAP9#>bM_L@G5y2oFvw)q~XFL<Z^?ms@F_XpA
zLSNf-HT3(Qary5e3syp}=TB|nt{6<D)@47k!u8b9YcrE0zS;;oV7I96t@JFO7bUSd
zW~Fwmm94r*bv8j6ez$P63wz0;ByHPximi1hhzW|_nFjiku3}WgOg8;R72)plhLf%5
z()y|{J(uRs*Y>Us{?;iqM}dwPnIZvkgTkB)%YEAUE~2S51f`(q)*!2flKIv4HQBiR
z+-)Hld_n({;f=(>I{!55fT3r>ENY^8xv=>PMXJ$al*mpN{I-c8%TmxICUo)r1vZ61
zhk?9}Io}d1OH@<a2zTk<04XW$7&5v;J+-7+!Rk&c;RgzGT!rh0lyzyhA=_BZO3Phd
z?;TpIwMp*=EHd>xHS$lU{4eWX^=QOv)ZWuYgBDKhS`}?@ylOu~%)I4jhK`|~k;u=Q
z)${fx`dyhY)((s5xl=NT3iZg!kRZ1t?sqTgMhBnXSzw(xrM!z;^Z8pWe6r85@sR1>
z)hV%KsiEP;+~Jn7S6|7KhNtT><vWYYBzBxSypJBRpp7Yaxf$gRXIxjjxd#*R2lTX)
zQ5Rdb7&+Sz3SaVzlPCw@y7B_tcf;R(jR4g;TFm{ue$1^Ec5l_T=~mJowIRd`Ym^F!
z(Tpblt$e^KRT9`|n>>^Es-ot^A|d?3Z~jV_c4l&}%%)p*Iu@E#n(#1Bwt-E0IMwaN
z@Gcu#M8ywLFt@&;tFd+BvvV+oHbgf{OyWeghKp6xF|NLX!X<To{a!g%$BRP^L|oYI
z8+c32*0zq1mqU#=DE7ZT@-Gqykh4GG{io13K;r$AipBnA%E)vhw!ax_R%HRAWi#WI
zfjkVJ_;N>1CtzgEd7uYrrAPXA<UM|;>uahifr22CbH8C#NZZ_RMc_GlVrPZFJn0WB
z_QO=2#HCnpP&js~zz6F^Sl4iG@jg%s-@YkaJYSr5%jmnZo?=WUibOmrb$R{VcsGgf
z1BTj14baNjy!eGTU;P4qOfdb~nR-aemh_P}-prIo1)Gp_B?bNP@6Oh0Qanzm6f|?Y
zrEr8Lj{sSB$03iQ+49JRiU4m2H~DaDJA3lu1H4zY@EULRB|A~EdE^87d9>CMl4+-(
z00nu?_`2^eLMB2TM0M52w^)@I{R^ox&MT4hGk9-kLuXT;LxhHM(a{U!ctf^!W+YFo
z&N7RRLs2aUkMQPReA?}xb-MHMm6Ja{-tpc@{>uaTXLMnV*Lu~JjP@pY|GX*BuKl0|
z=RL80tJ2vb2yA_sOJ{^)+ulsB$&Mfvgy&_8wYJ!nJMk!8h+R)al?4fhe*fyJURA-n
z%Nj$8fP~Rp^W)9=f7I0_%?OvG`j65aoQ7mbIkX};T*358ZF#&kI*IeQ9Z^IrjkU{d
z1pnx(y%7JiMcab$#<aqFf_r|$ek&e~o)&8iLa{BEyKTe0EWZ5pr+-`Q?MVp^&|g*{
zgfdEgkE^QQs<P6Oa%Jzf!yZZUp}c$fmrk*SrT(^>;(CH-#*ku(m}bP`XoD+13VM6?
zY+4mnKb3L$PfB?JV^e#Q-(Gn>AN`EJkM17@UUA9=>8bXFX2I!K@Yb?!5`4VaNif>}
zb~C?M(Uq6TV&PMmEuLV+MovPq$dfT|PmUMGSmp1fyF}HhlCc{1@p2LLrEX7#GB;A^
zs+YpO^yfK^Q?CxG%nb5V*io)S!^Z@d5t59!CEZ^{UF1y*FMH=w@t^2M{6ro4o{!Vw
zJzZPV#`D*x%cN5M$}*3KXW^`3!vB<(r`~6_b4MMofUCb-xv=4GrRSNWjw4>~x7RnX
zcldr<p6i)T$?B;eJ{JVl)-nz~6XycrdUmoeSD-{Sh<;YdYe%aG8OQIA)tEn!x|$__
zzG7;?bI4=--Fp`=264i*c#YG-`>=sPE?NH;N7-twna57XH2l$fVhCg!QV#Dh$EMeu
za^BZPy}y?c-p>($NV2fX`1-ZiMKa;$8b3grS+UuFX<6WnIB~U}0ZHGKBs}n^^9F?e
zGW^PEpls4u)belq=6NY2n}BdU|A<{>m5wI9`+-nA&fe)_y8!;8$eo_fB^^2k)X28j
zuL?J<xf(KL9fI3!EpA$r5L)7pJw7vsjVq0TnS4Z<T1@xdO}<>T9?uIeLxZu?og(Fg
z-Wz=pw0mH@ap?P!jW0=}c>bSyI()OgLAXEECjYecR7P84gr`ksQ^L6utDX0c8nG<D
zh$N^Z?^2_}Y2!xnlwrwxD!s_M*E~D7mhCsgj;XJ<tf^ns;N*Hed_|YSg>My(5Z=CS
zRKB#h(+36G@6h8N+_xvo<=neb)eUOUW!&LkrAS!}Z-lBJ(!RAqC-7#z9Iy@s)jZ*z
zYlIbNUKW*=X%}kV|N4vDyZ14UjdYw-ob2#sm3;Exo5I<^e{`EihR(-Gmw&A0su$|M
zbQmvcWzmR@ixa;XNcmSyI|pB7Im7DLPUshfa0tO4xhAQlzxjX`6h-*tUmb0}|2Bca
z|5tMwO#150AEjN8jsG8WXrQ2!;J<uUX#UIdWCZWO?0Ejy4#BT>H@=+D{oWt-+>?*~
zc`Vz%*L%YucYsr?iT`)!h8in~GrUvhFBeLt?wrggy9K_ypUS_VE><YQ>Gmr+f$I^<
zc*XKOXr7%sUWG&<HXP^P{~~7AAi^<4NYH3d(0cc;Bit$H1+=G~|AL{_j)0D)URO)j
z(AwHwUFGZjhqQXAo!c_(n*jJ}@0<j$Jm{xMR%yW}Vn8h@>v05rBU|*Ti}#UnXH9u~
zYCla~ihkn*DctsR24Sxf>)3A~yc8ux4p5H~gBt>VLsU5Es8^Z&3oS`2+tdDml5VC+
zNT^-NtqeI_^&e{$eIdflJo&nB#rbFAg?t>Q3p+vVlY@^{VZSQYtEf6?apihTY%$n-
z(+?>TEpJLkVHuOvdfAPN>Ju&3C{LU-e)PHWx3cZi{VVH`R%|aqJ~q_*+^=$p)75$7
zv~V;lw>*qr6v--)UkTwJjJ(0v6#JePDrzuIAZSy6=;V%$ci7F4)RlQGj8`z)vWmw>
z`!tQLTF@7`Mlw_W>T?a!vX~fLEDcs1VE>vq{uDJGGmlld>Jn5*p>^bEa%+7-za~9M
zGFJxY0IsU5mWt12QtCbG4r{yJQ|y~txLg#YW*nk$YRoy~Jqey^OzWf1CG5FS{DQ+%
z2P52dFb8|7yRV#b^2P)uFq6n#ar1HIzp)T<n_<Q0B7Cz|p^OpiSpOSbTHD<DK6Tla
zMUCF@75~CWF=V5s?+QF`@~Ekr>^AK=%1vuq;LI$2&(u&g_}m5aDO51d8p?0^yQHop
z7jaaq1Uydtbm%vN3Y0p;_wU=?a1?3cLz)+T`?EX;1L+I9JnUx-Y%ro7qj&D2pnr$=
zW5rDND%mC`$)Kdyr4Jv5c6?y&%AXBS=BtOkRXomGw-IM)S>@tTzUE=CxbyHWNs6dj
zi`^39GmEYc-C~OX``I3E{0;===9=U-c1)SxfMG%0YPE}F73qmiCbe=|@?PL|tFrVC
z!@h^=$@b~cl2iJ!z9c@}iKb$tp(*#=xmz?SM+lvB9k*5ApF5)u$qJZcY`QT|4=YP`
zEl+`l3dmxWdy!>#+5=w`RQ&zDtCW<(9p|!pwoEL>?p|`C_u!3IihHZuuaJH_DHdvm
z^Jgu1A9k)CPK+xHGwo3G)gP;W9u>b3#tYI!SJqsA-YC=M%K@{SM}ES7Udp&|2wC*V
z!<P@A^7+SlE+lAu5wTSka`{Z9Y&rgqwqlwn-6w~T`=&b0R0g<T|G-+wVsJ`*zLuWP
z2SfC#<?j|(v@X2HW674dxnY(kacj^0s-4M(<}xB|$NRXlb`cVg_|<o8LFm}^%&B6a
z@h8(pSFuirlQ&UJYZ`;N`A-+@t=UZLsLkC1+TF7E;@|VWPlcblZx-31hXvtV#tM2d
zeaH!ArU`c^=P_Z=mG%a9^ne1J-uH_KQLTNh(_{?f5c&%FJ?mQW6GgR8G`kGGUlZAa
zT@solW}3eVSEnMTX=9wST)LG+RQIQ!Ah~tz4-M?!_jN)!LZ4N+9?=T={e16yWu6vS
zTzn6Y;LMA|P{wo(Z^nJEtP_u<^yQ3JEJd-FUa$@Q{Nvf}JFlLsIMndG&i!YS)PLN+
zB@pj@n6mWa(+EO55qCb#lu}K+(@#n$?a&Uq_a)HTPNRkg-D#&7Mc{!PybHYf-A+sO
zXL9ZZUeETNZ~{WkXV3QL&EBbo?#>%Jvg*rhr19IGKJQi1vV9XSszFRba)M{A#0-|7
zrN;Yi8;T#NNE(Fq#`fu5yr@qOv>ET7%?Vc(z03Ukz48)zJB~NT9&||TUj}%eh(3UQ
zXHZm<fOv|t5j{>Dc>K>vHNCOJ_4TpVSN*&EPm#qaT%qlavA%wpY|mhNc(|;xiH@Q_
z>%AfW_Nkkb;L~z~cQ)F;B8K96+m7SmnlIWLMOKpN+v{jo1WK7<ut_7xMr0_<9)N`w
zYeK^*ZSfu|wc|Y{CwRChA^VLS73Iaz>l;N@NEB8-e8)k(nJKT~=y5ZhANz$#qb
z8*T^0Ix=@>2SWPI<*#|b!~8?jZ*IIdPupLkRZ(PavU5HtEHB30cdqf#Wcd%g*MG}&
z+|S6)TuAk3Z&c@b?tWv(a$Me%roX$lt32oN0WsgMf#{%2*Mgn6za|)vfkwRlgpRJc
zdB7a?$rW6*C!Scqk0&E@HzNQOg0bDifAwnU(OYcXmTQy9yhP-W7M?We;fr?r!m1b&
zyyt`vNLToR$I@A!qBx{5t3(%H9$%AUW8T_eF+BeN>g_Fq;^@My(Ln;ig9L&HCuj&3
z+}%BRaCdhiXo3fKcXyqa0Kwg5AOvU7!F9eS?>TkP{q8xp>i+mHMHN-eOn2|yPw%}R
zTg%iiz$FGPoBguGud8u?iblCu7|eQog$^Fq=`aU*I7<GrAIVVm_r0;oK!OlxWkkh9
zM^@fBjqj=dD6-c}F4@1jydUp8EXSJ<p=X|9N(7Z?^})_iY4F(OUlVMaCkm^<>Ch%|
zPv4;OK4ck$R6QIV>9r~MKS~LdIt#nN`~H-tf~$2OXH|BNDOKj0+&pFmmr0XZQUq|~
z5MGr105N?#(+FCQ`|vvSk8M#0Z0xb<mm%%I_isWeKVIP`YH|uK4drH|!Q!#A+tq#d
zPH>E$IS8wsm{Tg*$Zt-?*3g7Bht(-4_aE@B%@u`xG64%~r$(T{G*y!+47zs9Q+$h=
zz8z*BvK_^Ymm%g1eR~LWI54x~($QXxB^ky95zzKB5b2aqaC9gGM$d{Qlao%}x7SiL
z?PZka?d3q!?4y#}7!+I{ftg?wll`!PlOD=?8Mw^Nx9Pkf-nyZWFLJ)pcE7W$bVu(I
z`1!HDZ9(hc1DIc9*5!ALP4#ead|NZ7aiEv><E>IHm0RA&DYKF_(r6qOeyS!)o`0O3
z{38+*>WM)Mem;D~k^tH=-u~T;WGOq(CQ|c;rO*n#1c?g0?ec(?Q*LNi{{U|vuhLlf
zeFBA7JjtoFy2|W!NbU}ibr!ei3N6Z*abHgBE)aCt|A{vhW#Or%;J28&rU0!JDaTho
zxZ7T1)yf%H+pKQKG6;D$%v@yR)XxXKe5<7@VY>fEK;P3!Tdq^mlVX)Ti7m~yqq26Z
zrZ%uT!<f9zc6@5@h+ajT6?iLzVvJfmpxP1_T84&|>ZJteA;y<Utd|-jW%{<Ve3P6=
z%{^X==xarR%mzcJ_}CA(Jf1IsnVo6)t^#@C$Y;cq7}@tnyOPBIos_QbV#4vr8#3VE
zl9B*aE21wmD^~tbJO$KOht!@J;BG7~ND1O5D3g=6BLiuNJYQ$z|Dzxe7~_8fH9yTo
z8G>eM4rfv|7?jaJPb`E0^sQ<V@v^j?cbBzLNPR6vE;t0CZBVz--e)A*n6w=oxY^rc
zZ|_e2fU$~SRiCpcik-Pwmw9B~3ISkMXwB5~zRkf+(o9E8B?h6*X0h??>KEISoZX|#
zeZ*P?z;Mk9Q@HteHXb&v@xi)g!GCFP|2r@XQ4D7h5{X#~c*}P)P+fl~OY&FOBroY3
zRFoIrvd4dgg>I0FvSK+qaS*lQFDdX7H@3KnG2(#Ap$dN@WTEisXrpz;&q+a9Njz3u
z=la^efZg`=RZcomT-G7jKI%1rA+zm)`V+?1<5ym{hPg|l9HWy|eSvA1thW!7{>Me5
z0e{M9Yu)KlNXWa{pt`yF>SO1xzalIpg=WEyw?p+R<g2H{*{-{(X~f)~98b@ml^n_a
z>^0-F!Zc3Dr}L9gBDr(s5+MI0YdOgG*F>VeA+)6q+?+WVO{~&*!{bVb{qX=zOkA~%
z^^9Okaak<lowm`RQ<^wZ|9RXb*irhc9pBzON&E9B(;<x3c&~>UVdR%uA++;XVC6vw
zbAmO*d?4cx{MdG@G>p17MS7>?>Iy5He^vF@H;h5Jy)h+v<w1LsUh5mb6k0^yKuMJ3
zPfI-^uf9Cdf{fIuT<>>obo{%fEPX_+;&lCKFiHTLYbFq1=`e{tdpw<P;30EzGz}};
zjJLIu*a&9h9kViGf9M~7+Go!XoRQm}#eT<J&Gy&t{n7S@%vV`M`=L#QifTK3&{Hqw
zSW?DPWMZ(i`Cw9EH^KvpT#u&tt)GMA+*qW(DWpmHo;(Vet}J#%-f^OvY*L*>v{L!p
znj!?y{>*Om7YzqNB;)$l`eMj6@iBIMV)5~v!mFcg&E{4?KL0HyIon*-<&uE>`uU96
zM;@Q`N2e-9Es^v4IvzdK687?jmG4F+s%1IlvuYSEH{*tHf$5&C{{?#Re<KHJ<bDZK
zod?apdX{MtRt^}}Ugj)cxikRG$$t_S(<3v!9<F^)gsifeA7G3FoZj<1TvU#9h>l|A
zhXa@Fv`N|<A#?FWB!AkTo^~20$}ZuMtT6^-^3F>H@wq;K(aRL1cjEr2p@L2NT8$(x
z#9U4{n0GC0dAGG2oy)szpI!x9^ruCFiAe)d?{FE4@b=w1-+Ki9cYeuYUv57L`x@fh
zU=^b0DKFuPnomk&GFCH^{uNfqqYtK;7#ESdS~rS*7g1P9m}A8|<Yb`cvz<N3kWfE+
ziM`7CKm{b%02Z(-=mED?-^Pw;Ig`AGBMCo=zVd9BP37I^vb<~aLuBj0@ZXSZ9QL)#
z?gjRQYZlk1yXtzClN}@thowK{J{&gLhr_>9wGe6$w0~4MDOx@2kIMLyP2xvQ?#L4Z
z-5y+FS&d(oF0PNuH%XrwDknXwBAV@_o0>u#nk9<^2AQ`V1y~@%+QD&4Yu2G0RM^|Y
zP|5Gq%+IHeZvrGg%#NDfdH;`PL}g{6WM-G04pUe*V7Dc@8)VkL^peuiol!$Lj*Cfi
z3yDwf_k$4Gry?tHR-E)rytxIfzlQ>VLpup2ozc;!_<|;Jz|)YGz??W2#M={K3A%!?
z_OMVqY`OpgqaNiD6)`?Q%#WrG;?!1AU$!3Fnew^2*hAaMXj`=rjO_jCaCN>X^1c!O
zAu}&KxOc>3=llv>(=z?UWZQ<ZBRYL1Yv_5Osn!4Q^61M3oDfbcv3-0$q>)-vUb5`$
z2g&P!3g4L9wFO`Hh@jp6Gdee;in9fCbD{bMUP%;TvA&{CKi~>b*r*6#Xbf#%Bz)i>
z58CT;T|D_mMdZY@VW!=ORVZ+yj-5thn9}3dB_y-0Nop~q;M^`PxqQCcr0Nc|gUw$#
zoA?Zt&@IA19@6*cO2~K)5hRg(ipHk8)9WLd4ai&1?BYCDFJFj6Cwm^-*v#E-Pd=nu
zW!OBdw#X$2fJEhd&r=Nf5J3&;{DJq^JU)IHg-9cqWt%dO?EHHvB%zrZgfV0bGG*_5
z+9noq)7MjXIb8Tu?)ZR}Uk#%hcz@#Htu9)rv1J74b|fCh1NP^h0hDM#U@`oFj3##B
z3LZcjor$09rC;ud^|g6+ts6bVu|Be>Y2?Ae!BJKgPdl|r$}J}8Q3I2H)9V4Slh4#;
zjmFZK4&zL6%~T;zoA{FnH@S>^ooB7<C)D$MU}4)yD+}1^HFxEf&M_Bg*BguCK0a_=
z<rI}OXDz?}11bpJ?6SYmWB(>gq8NB}EBQXRaaF^VMaT`>-*{385iA!~R^bIxuUi}V
z=wnbOJMv#;s`fAJ`kK<BC^o&i_H5qhpNd)|-FqhrK3GT<jPp>z$Uz3>bOBiP(N>IV
zro`sS)*vB(Evv`3+1W9Ha;nrMx<veY=G>&d+#irz6!DA7T_&Y=ZEby)lu<cOJ5&ge
zURwA-O|H6A{74ejl~rVQDYZ4=f4jezibFc9Lrv?1hW(8dpKfm{XoJ(dphrhe4o74j
zUp;$Vjt>XKSnU9M(MXuvsO^V_{!YV8{RbjQlfEdMujt@BTA~=;$I^W0!Y`Z7s8!&o
z`FDrFva<1eH*I6P-Y*Dxsr9T>Td}$flo+HmrJ7USbztG4X`IoB_F%`#=9ns<SNUx)
zSoDu&mCvPiPs5r8Hkvm-wk!~T47H_{T0w8t_%^~88mbM8^AyW1CwUQKOAr_nc@g3y
zZS4yfKAZpkUIO8?^{nKwT_f?{{asfB)kro}(YM+flR$frxuiUJH#Pfgo{fPuT3ObA
zWE!l%o?J%RDTB2YCC?q4ZkyBiJdcOp_n*ePDS6QRa23*FR@0MUl&##W9Q~3@GvVj%
z^=kBC?5kOtj_bVe00z)S)s5$wo?0u(&xjhI<uS-=p5{(=d4<z_+gQ86B8gli8<}!Y
z<Q@)iO{L`@<|S)`jcYZ!*bl!v1d_bBInZtg|C}K?GBP7b1e9V|m0et<W<3S}2c3!A
zljN~LTd<iKj4f$TL&`>E!^g)?o6o(01y`c_7|i<pCaau+WE9+u#CQyFpk5$|_`13n
zP*ee$;m+U&x1BQpB5iyge7ilG=0%W5Cn^ICJbwTF8pqpk?mue*KJ1EAIK?S5RA*re
z^JHRzBD(t0v9W~-50A2k5kN1hcF35&m^7PUpyE85e&FrtpQk6r?GWL+nODhZX#*mM
zY6`z_cM13PMtDh4NTMi-$+#7>+{;SH4k_Ep`2`NZXG{L~pNhl42}!C(v6;6Dmu8_~
z;i2jCOj1I=*xqt73I$ao@*)lE;-lAf&KKu6dxXax(3>pg89rY40H20aBvIq>O_u(6
zTKV4Q+eZAEWE{HfndYWY{^R8qTF&M`HtZ%V_RXz5eL+t;ySOAm)vCvxs;s9??-P+D
zq-|C;KubrbT$3q8d_B3-;@iWI(ETPU;&s7>S_Nx4$;N3B+RP_?mEYc*>0xXl?(T-B
z@X5;>-r*klo6rKGVWtQm3)3KQDr%NI!4ma9fNWfA+inAtyAB#wK^G+l%Vh<Wt<_<m
zGc=w0o$G;vX5d?M(rHd$s)hkka@G&E;x-fY^Y2OH^n4zyr*a#KC_Du6^eA`+=?;js
zWuEX2J`z{s$Kn{7m@OnQU<tCE1|ffS@SY;C<3#QMl+X;WeV<L3;UOuQzufp4A0vsZ
zCud8V=0(ME-rS^r{QJdJK9saA52X}ng$gfGdn-E4`I>mK&p%wbd?kLWoce)-Fq51(
z_h~CzG!1q{IL|=TkvWJ~kQI)v5uvBHu82Yg(I!<tlj^0T?UfoaCP<3SAmbUt1DW?A
z>Bt<a$SMoB2$;sjJeY;nT(I1|=fi4<6S^IwHbs)z!zin}uXc44uh!0Od<452TMuA7
zX@B^JdgHI3Nj>iT(y|aQQ)jHO0R{I?{ZdRNs9#@6<WY9IiMe-{-tWet*7qCD;+vAr
z>~sq1>Rdia1F_Vd>%Z7sYZkQeTX=IQwpu-gT{c3|&Q<zfK$cKu@0`;lZx($imDxiN
zjKU~Ua%%nA5A^1P?@MUBPMYHFUy@#VZ%$(ZV-8PaLfPF>klU}SECmI(p{U{sjPuqR
zyouYjE=<QJJ-5^$RfxzMe2q$8;FQLD2X#;X33TZ5fIjlrYZ^zycF?_NX;S=AU<Z#H
zkB!4NrlYg?uNVvuDUzrGZZXva(*xqkyeoA(PndQ571H^ciYd4Mua$q)JP+x(Ib*7A
z_C&{3RS<I-*-1q&`=}9kK(x}*zSOcPW8q6e`P;wc^DiqYg+H*+vIfoq_zYcDt6VF%
zpw0X+b=VZiO-5A95E4xEq<47E0_^lxv^@`2-j{Roa5`@V@wmruzIq5PXlQu&ne2D-
zBGD!rqWooz_h0k!T)DsEo18Uewg=RxX9iWla5JI0{7b{MTZ@CGFqx5o7hlVpKUU33
zqiTgZEbWR0XqDRjF8})owXc)U3G)O+gy<SY$5)F2MxmPpZizL-qy*=3suSrv+<se!
zYw7f|2Qt1m4UIK*9%S1>Jw5Ac8i{mGffzt_28UU}AdN~Dlalrd9yC4B+>v5JjFfjc
zp4oA>V|H~X{p;q}(N9SR$xqgvh6X&OtQz)%bVFkA(}eIt_}L7=JY(r*v{^UXUT4BL
z)k81BX9(mJXBJK1nM9Y#b>(3}zuN=zZ+C~M>l3lmdaAy)qB5H}E;M~<v$r}b1n*O%
zvc_9SyjEMY4o-O5T7>X3exBarzoXuX`sVNKcgud((TpT|#|!pxNy%XW<fU%9Vq-2t
z1a0P3xKK$zU*l`e=uB|zlg=BsU!uwRd0Lc1g}y(%VuQdQRcjt-T;<9nC(l0VN_I%A
zR-7%*8nn$VYk#-YoZQd0L>09CS4qWJ9`K5^eI~gV+I+C45}t?bwRh<?iJe{SJ@Qap
zl<Sa#eJ^)_js$97-=`1WRE>9f1*|S;HE`jvlGDVsb*SGQggr^Alzcj&7tgb@KB++i
zcR=^@*A_g0K}}AZ1qXI5Jd-Aud$g>`DrlN~&Mg~?+DFIWgwbGAkhr%LgP{OWa#_=r
zI#_#m{9iEAoA$xWzlbuG-*-kNs8Pt^7oFmjzl3}7leAgXCyn>vS-G9<b66|03r~ug
zlWRcy4zGdo{P8ofStiScs!@D435V0|wmZl-`teM}_e`q%l2HzR)}Q!|mo5=0IP0N>
z&+Q&Xw`pE|XuL1*LC$%FyW#4N-ZE4}&%Iy@XwgsA9;}iw+dllfH4tNo8toiw^JdGY
zmP(A-YwP3nPWu;`U4-D=pkCadl7!DP{x5XZowVM8vA|<B3J@>VahvcrYzH3%Ilb4o
zbDE7$7=)Dx-wCm<>uqN*cj=LN{u~I>=uLmGLtifm6K;htGF1MEwW0iKC3t{GAw6Cf
zQyHhN`xtR9BgA`3<!(eF2<yyxmrBSqTm?_9F>~=P)D_9D{2~wm%2|dhWj+Qm-o0_v
zII##{0vG_iY?2dPWruGImHAr&{l}6d7}}%06FcOif|9`yg4SA0kh{I~F~#EHR0yYh
zYGq=HyVHuwH+Ic3s{O6Eu3hzowR(>-M(G?p<k3fZ0yLR_byT=<pVs>So6G6BVWmh?
z5JW8qxc#P<PVAG(Ao07nvt$%(8Qb$BYYR%1>>yMzVb9AW*G^owu6yeOBa{8E!<`?Q
zWGwB(R8^OY%$+iPhcPQKkJP|s9z<Fo#m)Z8PS5@AI~Exp`-<_;>`Zn2VHtM;7AM5%
zamRNHI%L=wDoh%~2^1H!&Z4Gvdc<{GIVw5nF>AXg0qI+Kocj71-ykG!!a8@pu79H3
zKFG$ykX<4rJXGR_x%kyuFL&L~OJh^gVt_4;kLi9egjE~R$*~gHl6sA8HSdzDB+SIt
zKAQO8u*(Io2AJK?eikoLn+Cn+Abp#koeKMzyG8WF_i&WI*#_&k-q>W~KK8?1Ym0pK
zk)S*M*>==-sMjq=LrtTS2w_qck7KzulI=~Z(;qgkW4?v*=?5z=r+MFv$>~Z|fsTU}
ztGke|^@q0sf-UJGFc{_H{$msQzNM{!aFBb{AImZl9lIwPm6=z7cgapy+TK)z2-+tJ
zeh#9&m2MmAx#N`yO$G(8#;UQCPzUr3#g_OVw41ckO$<83nqRH2(}XtbScQ%I1Z};^
zJz5}1jXM)I)a87^RGWQh`KGmreKSZu{>Q*O*XJZ0yL9ETv0rxwHrFp7g)g`E{F*~V
z0%tU3BaFzq^3z9#NBakQH4$5#ty7&8eOe^}5ja}n_kuuSgfs@|D@GVNVjf0P;Pswq
zZpxt`KtDgs;3pfEnep`@-OZ34DT$hn(Q2G4@l)tPvJ$~st`N^+b(O{nHUm-(6k>qg
zdXSS6>DcVmPQR(WGOCPCe($9-lv!YudNrNekvx(?i8(>MgV&|-sigQzV^<fNs;$YQ
zVS%vcdGpPiL?lOLy$w~jVUxjG3=xB8pc(F`r4RS5XfwzrZq2?qo72+#cV675pN&0G
zksEW3GBrOMw2z#0_E$faAWI~BV$}iqXfv>bk)=1-URFQz>~AuYrEh(M*H3bc!{!}q
zooK~EL)~Z`lakT?QOe<|7&Z`2fj=@b)GsYl&g$uLM=e=JmLqUCNa|(ogOLr|;be_j
z_pK2ZWa)0_%bdTC7cbM-7o9?HZ&!sT&!&ed9-v|t7B=1Zo@|V>6L^k)F2g=fNMooD
zRqG%QykXP&V&@60W880mMK)Nk>sSFEP`<SMK057w@cTNxztMMDC8js{!3Pd!JoNLD
zMi!^7u0M>K317$S>dC3{A{r9m&#JEOHFQ*vsUGXMy6cQ;AkS{y*rbiKbj9@Az`y|+
z-|M_8jhfhH>?XiFe!~7(-}7$S*KyBT$PX>zVF#Nt#VJUJO*D?s=m-AJ5&Pm6oWQ}p
z_2P4h{@|q(<Lof-ne|KFAHkm@x(IW)rg?vxJ{hPICXzeG1ccqY%tG1KH?S3%S`-uv
z`_dl2>P5meVx_v3ePbIieWWa1yiG3r2JUv1Js*mBb>p9C<j>E)IQ%X-poXn8OE~0*
zVOU+jug={)wFZ$+aZ}p*S`BF>IeFCJyga;|>6+7op|Qka9C#hOenLYTvU5EnRMNLA
zuK5rtf&54t$Vmv^gCZ)|K5NBfBN@VLGc&q&8Ae;&Z(yT5)F9s3#?ueFd72WmXRmfY
ze(<H)5WnTH=p+xXV6`X5($n8<Mkx@oCtI!Rh)c~3Z0j;Sb7kAYKAKsxIA8Hhyu>C8
z1R^uGwt%}89GT}TL^=K@e+imnkVW!v@hbpP^;PFC_;Ba`Zgd?V@#3|?uv{cW7v=ZT
zQQw*3S7IluEC1=-j^73cM|olHOa)b$LMmK-u;=V>6TDo>z$01juD0#W-Ec$YV;stx
z$M13bv?k5;2zs*UaQ-RJHl5$0;k=v)byWy;VaNBe3fD3viHV;Z=1IShV@mDELw!WZ
z_*2#Il<!Yz*qfni{evE$p}@ARzysG#a_a}X;N_V#<LBq7?Jd~S76;=OsMZ%3GzvJ4
znIbvqGUMf8b=7HJ&=VEImrvLu>c96-7~X$A;{EAkZI&#mBnlZJwkvj7Yv1jcslHQD
zHk$`b0L$L%&!=B(xw<6TZB#3+9e~>2x4ud}?gdVS;UTV9p&QS+)DotTI_Du3RmMXE
z?kG!MFG}5%35C0#cJlM@fHxqb*zY#`c=P25jDMte4m3wI+#jZ6XKV0cFgN}>-`}AY
zx6oZxak=vn^yP4PLLz`z?H;9etJBtxgQzPfEkcWTLL!=rD(y}8GykFiiMOJ>KJn{f
z9Njb?LtA^3!<JQo25__5^g7sqMyX28Qz47m*~CZA>b-1g+7RU1@l`h7{lkqtYMTRF
zU>N}--atmQ+8`_Lc4ysfD|UC!`oDy(-EuV%U%33uOq9d{v3neGHNf3ABsc!SA^udG
z!VLg=OKMKvjp{|;o^81A?)+jj<|Hs$$*9nBXD<9Ywbgu97bgGJwuKokHqeukHDe6~
z-cchIEt$Goh4ekiTjv%UpCIAi7`<Y61Bmfi^iwJUm-`*c?soTpxFxdKiyu*j&z}aO
z(Eo-^Y4wl+mjrPhn^L$N_bEV-C;bZq*+i40qP%r#)ukPeOXd{$djg(+N0zj-!2NUu
zHLS5u|BqBdIw8=W`M+l<X!^f99^e6!vrE~ZeLYHo<US4CMmEN&*7=VF2&#{F=j}G~
z+TR3-&bqa0(Rk|C5eIB0A^|a50B{Y?{p0@k9Lk$IC?o-(3IcwV@Qa<F?&$wSX^(qy
z#%`)vQm+B(j7@IWqXJGTMVpn;`3T21)5t6v4<#{toQbj-?s~!g`{R#VqtJMo<zy5^
zawtb&#dwBP?%=ci<#gt8sgRM=i>vb!N?seeT}oJ3P-c3|l#ttl5K`V5g+Bv>Z&4Wh
zes?O2To<o%z-^>Vk~>EkBf#%|<hhTKfMHDf@jCcCmj0!MWA;7=H<wg`1O=5DR5Ru@
zi-zKQ+)P>05-IaDu!j{U$f%GW-*^txmbEu+Nsgc2u60K;@Eav2Yviy)Z9(BIg4<)6
zn~Z^*S=*V*Jd(4c^3Y#wztuFY^1Gtg3G+2Zp&7e$Vy9EhtA-pu5f}Zs3`t;GVTHp+
zylfFzy60wv%ilvNFDBUDxA@!)X|)j!`?vGDo~rcy(>KcI?(?%-QN_62Z*^cPJC?3C
zoqyr?X+XGQm~xu6lgahDmbqg#F)gzFD=TKi?-~9`O3P_N0aiFKmhY6Wjy%?y^A;rM
zf{TG5ux&T;&9m0%T*jNL>#4_l+xRa`48{Kp<ker|d&GK)vAMgv#YdRnfLc6+3soD$
zVi@{*;&LmlkILd>PwcN4i{tV8VZVg?UtFT}X}tmq&W+D^BL`1@sQ%=aRA8vt>F8f5
z-*54`8UE1?M4y!<;l;+6tQL8s63d-Vu_vlyb*P2<XY5W7a&fE`ApDqPurxnh2uV0M
z`FK~iyjCg}mzof^Bxv{X=sxmhZSPPl6hd}zC)6EiD|&vCtP%)lud02EPflQU^`36$
z5~LS)`mu8;R?~q&WWq6^h+KjZBX$3RB0XLQp)>+AjBtF*4<SlrVz)4MurgtKh8}2i
ze*A!KTzxuo>ofTSd?0*~csBf)@!9l)4@w~apfb9a=jE)Y<#s4&Cd4m^1%sX9-4!R!
zVD4x-bxanky4X}x7<8fZ(-{3YWPGcLH0LZ23^$x-_6|3-aR^T0_Zf37^8=sz)|TaK
zp>lk@^UZO9Y?n=$hD1k1D4YFQdEriOV2FuLq5Ph=Z>j0XczN+F7~TCA3}p;qV)ld<
zWyg;VDQHoX*Bh}3f7%F5fe56PD`Q;fyB;N4F#B5sGeMg#az$vZk|LIMu}&^K{Zg7A
zt6)6isU%dW>f7GEODHVH+s@AW4cDs*b13gu+@3c?Rg#5Wqj)bhBjw0rqJOB$dU0=h
zRCMyS{uxum$e5j8PRy4g<7czo<A~a3KUdgLb>JChBE0snSt$)_B@ut{1v@hiqfy$O
zLk@SOI`zC%UuG<kX7|L%QlC{GT;bj6VJSUle8x_6TV0@AUeiwGi}6r0E<m=}R+xZ~
zZ(hmwGN@I;b_T~!+3)rWQ8hJH*Z$9I{QP&^=8N&up7lv#{KK(Cowln}7r&q)o?ySP
z%9%k_IGM&=&z#=~7@Ka}AQl+0Xj-6K2?=AanzN9hp<zY}zx_3qUn$6rlbNYRHE_kE
zOA*-PU@}os^=y(;;*31G;=_uB44sO>!&-O=O|*s~1wUFrs%@ED4#ppzhp+QU5Q<A?
zg>K5V5M%d~(>5pPhVu`*IQ=Xgf_L0&KsWd5=wJckn<H<Cq@$Ltfx6f-!cnxT*3ev`
z9p2jm$nS}*wJJ=q&jqvDQdXsuOUX<Y(5YB+Obmlslhb>&x|vb1RoSs`c~{lQs$R?W
zOS6;~)@v&FZsuQJSK6@tG9SD60-9CBTARc9>?n@m2&0C#{3=+Yn7Eodo}t<MkE>}D
zhjADW{24JHS~pBWO25h{=Cs|3%pANS{FXBmarY289oCKUaDWi^D)PIr=i2%8@lTbt
znqX()gK4ceS37V{&M`0Rz4LRtq@Y^<Ts)AZX{}z|tJD?GKmFbHh5|gjI!{X(-%z`=
zu00hehx5s+???g(FF`YWx<q~2+V2K%B<~SoZ16KIOhxT^hGr>tG{)Eb{G}cX^RTrE
z`9;?Y$r5#&m4Uw<^7!*Ek5#`+MVUAqfc`&F*=DMgL#4Tn8DRi!2!~j9)P5P3<`2f#
zbKDaMuao%3ml`f_6vmZ2k=xFHw~?dAs0fY*`yLgSkKFQ^@2Ql{69o$P?pBR{_8*6B
ztv?&f4&1h!%YduDKH7q@C$zLY*dQoln}Wobx@ijOt0WHSL~)LPD;b&MBfSB=y7OK<
zyk<GnL}(K>M?76@`HGmIOR40_g^xg=4-lqua=fqHX2Cg>m(d}85mAW3KjkMZeM2dr
z{xvY6*hfGXA*BUHaZpjOg<-qGN|YTGyfh^A&!Qq}aBF+I#{z6+MBTm8YAk}uMed)4
zJGMm|*p*n7I*2-FVS?LPGYAQ!8lF?8{=rAt`IrGEM}7gH!3kRH`X}}XG_mFdgUZ!6
z9VjxoxNs66FiNpI1<j*mIg10}qC#_fi@@t9`Pu6xO3ngEg%D~anb2#nrscjpn$*;w
zV!)l8kS%`YbJck)v)Q5HPTKg^G=!gh7_Q`;7-l6JbujmXwYqXX#Vq3-hndCa10!7p
zj+IO27W-Po7NiEFw4h+4eEL>4V|<_@a&j=Bp#4sC(d|`sx@E97t>jmtmO%dIRa#A7
zmd)YWepZGcKA!<dY3(2X&7WE>w?-JrEgk`NXfUPZfu(>H7Jh!=)}P(FL}i;jXoYo?
zj&q>bYKAM6xU~Xw^*QPuciHW-MFbRcYU^}9bZsf~5ByYzjt=x?XcHu!&os9zx4P|R
zy=)FqT)fKJ!ofduBaKi%uj?!BHv8K6@d&i$z^@_~0;dd&!~A&U+?AkhAtOt$qt*}9
z8l>fEPMsa+1|hv=VNwvkUp$Z~tuR;iGLz>ZQw4$5NC3XDrt>pEO_#@<h(W<2<uX?(
zDX&`nVphK0Zm&A1#Tp}O6i0g?nZxcC_OZvV9#2>X<BWN0n`Tg4VeDu{M})zG4D~|`
zkUGn-&-SgaNoRBsrIe36awVDEYDVRRob@d9&#r>Zc8G_`0;c|W9Y>&L5uL&MnGp}N
zz?cwZqy{Dr6<0Be?aoeApqx%B(YA4Irog7V-XN}ReR!5QV4IE7&d=)?o@+i)6~FbR
z@(E@?xb{*K-*kK1mh`2^Z`r~#1=-c)yc(EuJ!0_ZY#r7mgMGonjn=BU&?V8SUlACb
z6sx17kxbzi9>?Yy4yBF`8a-7Yv0PONojYZ#iMjYlRn<ZeCP);ylA)cyhi$G&h~lxS
zNz(O7A?`ytPcnuUy0yYF1yQnfvvi`m+L?R>UEpJv1P~hJQp-p$eCt|HZ2!)gc;iJE
z8;{YC>fLv}@?W7#rq7uy4!fQO6>bvqDYjoV<$fcA(ODjmBWM{ZXLVJSBWUixj`hlw
z6B7fpY)u>yGumU>U3?h4lgx@Pi_fUBy)WE2OFI*dS?b-g&3Bd@W_x3M>opDz($8js
zeYv~&CQSQvnY-2+sA;+0({g$DSvgwb3BVJx!N+;|@)3G>>E`aiell7%a%z8nOVLH=
zVxY~MEge@)+>y4;B8%_Bl#)j*tZ`_MMameJ_+l&Syxh1Ef~U-aGQ)aOu4HscZIOcI
z)hfI-*()1qRZE$U4m5I09zJp%qQ}Y>Qfq2L8g)X%b3=~|Z#r@XS;7?nx(Ic~qg#ap
z)xu!SrIVLWZofwAqRvv9{w#Ki9BLcROL8nYD>y%~kl?Lb9W;d)OjAlAI=Hvns1_29
zFXPq807)_$D(Bjx$4BxZ+H8hL2W*K~P4qQ*R<@P<@RhM86^Ytt8x=-GwZ1ad&sGz9
zXXZtwlgs5&x|T8VRs1C=_w7xJL2Rl>kb*PUD6Vz52Not&TE4u%H15OvfGFUCfYmX|
z&}l3cqe_-%f4VvB#%jp5mSwEm;G05uNW0!$-Pw4Kcfmr<-p-7&vC!W9L*>GBKtIa@
zuh2vbj&nQ&IoRAEoiPcTj&wR$rD7}Z0NR*-VlnacHa@l~f^s@ItMFon)gHt_8)EbU
zM^x?EoA2M=QrKP`Bw=vXb0nju>hd{P>29{aeXuWGm|EHQxgP@}{=Vowi>`^fYXYfS
z=7++066f?jF^=y*yGKG+db3N3oc&2+wx+yXzeP3-k01D|#s-J*y)O5h=S@A!%slL7
zAz4$pIn#?np#6plL6;p~eo*kF>T$9ukyNh_E9I5|-Ny38*_u(_XUYDNRgWWk-UO?A
zTtR$52Yjt(#H}wnt;pdY*lzHxr*3`U8L`gActRVdE2bgXfpg*tvb2>Q<<Lf2{^zPU
z<LF(3p^f?`PJ}eJrR?AkqvpVOC{)5;#6H;M{*w}^FN*g-Y%&3bhNi%WyOOHjr6tC$
z*tB?N?nCE!V-ItQPO@g!wbpH`4Y{hK*z9n<?27#@p<CPp4vIWlp_>IHH`an8&!(96
zQPG24;U$)vD{lSvF=wcWGbiWvokQxcqin3dO%#(3mQK$c0zN97>w8r9TC%GcUBWiQ
zDA-+7NQiy?#;Lyj3<ZHgS)MXqO=rad83-UxjiBe1(7C`R*kN-zyOP2ERBvco27UP;
z>Mo(e{A9pyuLwVmUPvw5>!n-e%hBZ)hsz39lz06)^nuq&CgN&(3u#hN+U|=$=J3qb
zEP+C5E++GBr?<5vo8<4M-}!MOzkD4isZ$@?%Gd7@ZE)SkaSUexxT$%2k`cdrtxOLD
z_`R_bC%BI|oL4>v7hgB3C*E$9&7d}UW;*+=@5{u0xC<0E>|nE<u4q9-2qpB)-x)pi
zux+vn1pHdHv-6*o`pqO|)%*LliSmW2jQ4fT_O;nls*ooccw7jNu!ls;mUpQp6X7@g
zM%$X@o1vkhEdL#PZ~UjiGF-LkK9JIr8(Q%Hcc;nI)&IZsyC{uZwA@f^SUoa=>!m0J
z`pxd|*W@YPK5G3@&yF>--F#@V4*YS?Az($%u+1&m_%te39Kc;SGp~4`5nEX0lh`a$
zx-f7(7{lXd*KO*wn140M-$FyR<23t}z?(5`bUZ-ZMQHPUz*7EY_5E-ONp*+fUZEKL
zB@bx0j<50X*nF0V{CR1B^~BJNx%SWXWnnJEWcS2GnF9ytwbNNgwd5yee*tr;u&+mK
zA(Ag7lZ5LT1kz_NgZTN+V^)~u;NM#IQkviNS&W`jp#<OhFZ`ff8ut>pvym7}l?Uj8
zX5}QsH2s&8qnN7*h=#N-HHz*or`5Ll!m9XEP&ts@FVe_<mx-kT_@CPM5vZv{d*@6s
zweD?@hA#SR-JC{71_>l;^QWyQeo_pB5S9J8uL3haR}~1h#!Kso{h{Uk?#9*O51kn=
zFLeW!^Na@b?z%)V%8TLXg;c+tOrtELOMao%#|5v2*H?i=S7c1jf~V2?1==vViSn5!
zALvKYu3RPv7C$NZ!BktUlrqM?whn*ZVY?e?e18!3<>mP8##0THt@?XJ2*F+(X5Dv1
z#mYLuV-=|2O1XnC3ux0kgLRC>sD%+PST8uoP&F}KYoavBivwh%BEYP+WEjxkP@YbC
zvjv}!{{A`Mm02oa2lwh~my#l0^(0ciySrhGrUNSuB~B`a!W3l6d^YyXCb^8Q$kL#*
z!9)&dY)6i3X#q_HXj3Bpwd)=bgw{r&<uW`{MRt<kVUJ%9b&or}(Og1U??{)I2ua*j
z5mHiryGr4jH-GOu?KIl|fTfDpY3_R|p*#Z_)oQpE4Xt>e-+o6x4tfDO>p~75_<2^}
zdW3@I<?&=%qr^b5tJ0rGN6+NI@S%fsdqAypG|z87?*|wL5>3P<BFrqu8yrz&E6&zJ
zP%S7jU(L)_c!`cgV}>Le%W$8VuU>w1WQdq!`R#N9H#CB3QWsm|c1<`gHo;f#nWzWb
zS^P*{y(f`h`F-zKpkq+>8)npaJA3I<Fstz`(Em~9+j_2DTo$?*0d0Eq9xTG@cN6b}
z)`nLS6^erW@>{Qw#w|N~DsS-@ljWm#%n{-x%dKHh>o2huoKxSI)7pJ~QUb_drhUZy
zt<L#<r8UMwd%<eB9MLK&o*3Jcd$A@TiV00aqAQZs1#`8P{4QHyJ#oO_^;RTJZ-fn}
zx~NA4S2-#2;6sexJk9nu*#EQ)O^L|Iy?AGpY&b!!BLUjqEEEn4lUDY!lz%Gxqqp(j
z4|N_sRWH?KA#Apt{h09P@A707E!u1jOBvVhBUru}bK|!Ew;(qS17$Z!al6(zwI4z%
z8J+#Ox!`^A6g%Ta>WGMa3Si120W+iLs3KQgRaIq&&&|!=ae^4UJU!;v3;;4c0+e0)
z&ACeb+1c5hY4-a%)?4>|VzE-+&tJl`xFeEUk^{!)SI--o_U6j8m@R>LqOA=Opp0DJ
z<J+*8p6Dq2{LikUQgV(axeC7z|JF!Hj!OI0?iePpfU;sCx#PQP6yEyiH@q%cffzh6
z+>q=-c|D~hFBn;wF_sBx8Q30o940B@UZIi-<+aRzBf8%BCK_r_Rpt;y0S`jZG$*$O
z%I)oAf<Hn*CV#m)q(jIe8}KK$J_b9AJFa&4_`y(s&$u+hBhWwZZ;z%&8Djift_smy
z$wGnv<&HK*ZEb18eE`XgLeKxavbR~3%U_FByEx)^3FM;0&-?j(Kf9(brMmOy|2fFs
z(eL9QN6V!t_hjc-VNg*GR$WSVN~8}%S=$SFBEqS7i!Q67y3xVC{sW{&+x!rLh^(gg
z&l%r%C;HUs<JR{SfWcAUTD=9nn3`}bpseC$?czE`j6m)Levyhzd3@%Dj_X>_UgiP#
z=b<C#rT>0D3<zH<M4kmz+|h4;)Xo(*pK$mm1*h0|LGDv;W7ao(+N0xZ1#Fq#9fPn_
z(D9Y<X>Ag9(A~MpoQ1AR+Tzvy<y!QR)>KuG@bz`(`W4mzef5=5jq&N9kreoQ1l5c?
zGsv%$FFP1orW;vbgo?WaMhr*+vZ5P^SNdh<AnTWzg1Zv0)d0BE2EK97$>4Dz$du^&
z@*VK?)H1lA-(mJGdr<3MW*7ByJ~R^(@PSZ*amC!8HKZR(4zCsR2)++5&9)yp<a8*V
z4soKn+SZnD@4D{pKVD_q`}3^z_5K9Jz~4zO(MI6soK$v)swP^giwe<ruveJJG)gdY
zL>!d*GP^~y43E?c3f;fUnir+Xv4;l*%v0{|pA~uy&PCmg6MSobe>akOQ`cJH(q*nB
zDJ?A>82DIY(sQ)j6$F1A%M{Sp*XLCSD03u7(SU9{2`z^Chc&NS-6e_pVr4(It3RJk
zLP*D-gL?HqkvR8t)uZ7y)5g&9O!$tMaY&{rf@wI&LwWO3A)p^sk(5m%<8C9U9Nq#8
z*C056n?63B2x;x)?1)*o-tM8lJb^&;D7qSay=R^}YgaE!1}WbkxrA57um$%iYzS5M
z1-Desw^M?r9<l->@w%?v4=**fu5bg7!ILt)%qD=s;PM$LypcATUtm8Sc`%2gdTE~^
zdl_tN_8Aex#J)|K7gd@%C?td?^OF$J?bY2TIXU)1GQfK0SqTT%a3bc&8o^JA1RhzA
z4tU1Ky=ugcvg6<nPTpz2Nqeb9yZjEvUj_gK<~a^qAxOA(X6W!#cDZ_7a&jTx^IcZ`
zrj<^Yv+Yp|3JL+QBm0i0BJDK%XkgOHnvm9f=9R&B3P?(H&*=QFLW(Uiz~8gBgOODS
zLX|QPOtDjlGTzsn-gkffZW93Ldw_Za`fvRBp*i69tW@tW6{q6zl7$K{0K$Nn6dLrD
zyAF8v>9*?CK}q}B*S70Ak~Txb;!!e_)%m`$=ZDI07ju<gsb@^%M25FR;`!s>1TIN=
zRwzo^%Cm(8;4BjTI`D@Zzd2Aw1B@ZaD^TX(ruLW^xG2-8kd?CAeD^n5jOQu>*>UBb
zwGx5SS?HFAqsN)z0S~ZQ)134RQC=^*QtOYD^W|^j<y70Ql0~XZJVI46g+_HTF>Q5D
z)?xUk0@0l|^Qa)_9_N{UjsBsWiE+NRKbxry2HnFgbTMK<=aVuF${Ej}KQAdO^F8jo
z0{Pz^Hgj5zcpo;-TaKhmF3dhH!Z?@{qp>rp8QBD#bf%+ti8<P0SS83>hw()5V@a7H
z5V-|;!Fyu^)e=!F&<l^6qY5NYJT^HT+<Av%3+vhdJt}7j=Dx5@qWJpS^aVaUmypaD
z<>4$P?*baq%k$kaXm7hG`8?(Pw5#2GZu)M=zV@Dj4n*tNmx8M#%!OtE%h99Ki&WhO
zQj?KuTLYU`Hy;*{aP)b86w{9;n-gV5&viU6vgrfcOjl`H5pojt2ahKpw>bIpJV(Zv
zP*>Rjy)GImzd|-!olAxR^nl)_4<8_L5@7)dgU6_^Z;RV!LT9F3$X_TC+rXMQgbcq_
zJysb}o`YWRDq(DZUQ?Z#Ae<-|gHA3kF~yq~tW(}6nGB+*|AP4Dbxf3U>s1VETR6P?
z_Waz_UH-*Xg(WU1hr1X$!9M}v1o4TE%NeI2gVJa_QBLHh0^oCC3S_aG<-@+dzU3wd
zQVI%eWJJJ7S(up0%F5K4Zs3f-=2`s}!T0ji-`V>r0wd2u;$~d?m18EPxn~jg;H?NP
z+N*g7a$>(%prTI6P?6o$;JX2KW>S%PE2oD&O9g}W&im0K)w5mjCp4$ZB+m4=RbyFI
zY$8)r+mO4dnT!V~c5A_arY*B%sQTGp)Akj6l6Ds!Zy#xdS0MTy0#r$MJ_(|iFAo=L
zk^TXQzL=PqpRIRQrvgzo0*?i^v;clU?+xkK%hs4wjd-M0u*w0#ok-^j`9GP3-tfZ?
zMA45qkN|v;zv0n1h>C;n&B89|^_a>mlKOZf6!c=3zqQyOs#2zZTW$D2Hu2%CZuFPt
z<nhhaIZIL6Hllj}ma<PfG=YusBUh0MhZ{0TFf-s`VoYUvwSMh*&+b@F<Z))YJ+OA|
z^eE;G@3&2-Gwzw94K-o_TeHD;Knwxovh5B@o+X^sWJ>H=9~d1qZ1+4o-RRe1dZYrj
zastGx_g2~FUnovI?@PPX@YmG6=%i6G+aCS9*mWJ7e8;-9aN(KHcu6t?UYwVMJD<0_
z0iT$TR%2r=nhIArwLNQeShR(Fy&2j_b)8$-XV!<}97gF{90<Fe_Xv*;tw=?<pkV!W
zo8?Pyce>A=%-1l>*;q;Sw2P+a!9K|<uN1zi)_SJ!>la6rF1YUKqehRDXQ`Y0&n=BH
zVe1N&Do(`JQenfLS)=E`pstRNtL`r5@R5qR)6u~fN|=w80ncsSBGo2@^=e?&%c(f4
zfg9`4;jYPmZOQZk9w(ND2o3kiJ?uukLwEijL!b$CvZ5FJ{J`wm@$^jLBJb`zmn7L`
zxV$=O91sr6j0R&Of@V^oyw>{U+)5Br`OEskaouBO%ZVK!8)y*RD|#+HwC`qF!L7({
zYHW1z;_T0X58R$lJD@?Uu8OskF+jX{Y~@~jj>b(;$<uG+BvQvHh@V~S0AABH$*Oxc
zw~Qwl18q24`R8kw`%nDkt0V$FspR_Gf1C{8T0K}h*{uG^bOIsi2z1KIawzYsrFX$$
zm!GAkWVoHQ$pnAzzDTxb3}RgaSyM2Vdb0*u_#c-J4dstEe_!l->Bp1up7L+EnG->?
z(^^((t+b2`ogD1Ozi<BFvQH$V)Fi)mU|=BDYqyn^9l^S!x;2}M-e|yw%n4G?PS)}R
zHuC8qox#JCMsK+LCuCGTRz-3>861co+;jQGt-<X*+E;*BBZbxBSd)DrZ_-*)Eu;J8
ziG+lN@x#ZgOGfb<gJbeij~h^?XIbLsCnRO^&l@s=+^!b)rrObRIm62@h;}V@Q~**U
z>A^mqADF_Ek&vrlXb8EBc`1DD`^X!b2f>nBX9E%n;nsMb{}Mxp{|7My0ph>J5P2`&
zipnJQ_9BB=ci<#P;^9R!K~h`Q%m5~DSf~Ceo2$zBL%z_#XWI`9-#8L-A|TxC?^ki_
zx67*`rnsEVv;}?C&jO+YFVUr1{zB56S2;A{@`Xc#<G1}$-7#avu}J7@y?SkeoD3r0
znpLT&^B8**j0;qm5^G&*Zwm^njQzJyXAgCRTbbk@Q`?njCr4BnUq|js5o1)w2<Ju2
zmzbGap0KF`<F7|Va;KHoe=FisMfKwO$nU7R2+ObHxi65Z=%vYlTMrNa8H&KKKH!$K
z6}T!<TT4Sjlb@fz&KAk|9H7!rFO^g)#FKhT+XJ@%A{RTdv`%D1{CJm2osf~Tl}f5O
z4!pY|!0mq{lR*}H?nU)9=W1n5O`fo^C{o_lfRTUkFc&=yjoDgPz{VB8$`Q4;3G;bE
zt9cxR-z@x1*_fH@Kd@}z{0FN>+Hc3utc)zae@nj^pMUF9*V1}<{^tMXX*@Y-xFP>R
e)4_-gM@TPG+UoTPv<3*hKyp&bl2zg#KmRXVZWEjU
literal 78949
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
diff --git a/docs/en/docs/img/tutorial/sql-databases/image02.png b/docs/en/docs/img/tutorial/sql-databases/image02.png
index ee59fc9398a4607872d7aae1d439fdb71c0a706c..7bcad83783af805276cb25bde4d3a4b384f92600 100644
GIT binary patch
literal 69197
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
Z9cFKG87|Wef&>XxWh4~9Men|N{Tq)QW9$F`
literal 83482
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
KzDn-xr~eO~3Q%MK
diff --git a/docs/en/docs/tutorial/sql-databases.md b/docs/en/docs/tutorial/sql-databases.md
index 7836efae1..972eb9308 100644
--- a/docs/en/docs/tutorial/sql-databases.md
+++ b/docs/en/docs/tutorial/sql-databases.md
@@ -1,22 +1,18 @@
# SQL (Relational) Databases
-/// info
+**FastAPI** doesn't require you to use a SQL (relational) database. But you can use **any database** that you want.
-These docs are about to be updated. 🎉
+Here we'll see an example using <a href="https://sqlmodel.tiangolo.com/" class="external-link" target="_blank">SQLModel</a>.
-The current version assumes Pydantic v1, and SQLAlchemy versions less than 2.0.
+**SQLModel** is built on top of <a href="https://www.sqlalchemy.org/" class="external-link" target="_blank">SQLAlchemy</a> and Pydantic. It was made by the same author of **FastAPI** to be the perfect match for FastAPI applications that need to use **SQL databases**.
-The new docs will include Pydantic v2 and will use <a href="https://sqlmodel.tiangolo.com/" class="external-link" target="_blank">SQLModel</a> (which is also based on SQLAlchemy) once it is updated to use Pydantic v2 as well.
-
-///
-
-**FastAPI** doesn't require you to use a SQL (relational) database.
+/// tip
-But you can use any relational database that you want.
+You could use any other SQL or NoSQL database library you want (in some cases called <abbr title="Object Relational Mapper, a fancy term for a library where some classes represent SQL tables and instances represent rows in those tables">"ORMs"</abbr>), FastAPI doesn't force you to use anything. 😎
-Here we'll see an example using <a href="https://www.sqlalchemy.org/" class="external-link" target="_blank">SQLAlchemy</a>.
+///
-You can easily adapt it to any database supported by SQLAlchemy, like:
+As SQLModel is based on SQLAlchemy, you can easily use **any database supported** by SQLAlchemy (which makes them also supported by SQLModel), like:
* PostgreSQL
* MySQL
@@ -30,891 +26,335 @@ Later, for your production application, you might want to use a database server
/// tip
-There is an official project generator with **FastAPI** and **PostgreSQL**, all based on **Docker**, including a frontend and more tools: <a href="https://github.com/tiangolo/full-stack-fastapi-postgresql" class="external-link" target="_blank">https://github.com/tiangolo/full-stack-fastapi-postgresql</a>
-
-///
-
-/// note
-
-Notice that most of the code is the standard `SQLAlchemy` code you would use with any framework.
-
-The **FastAPI** specific code is as small as always.
-
-///
-
-## ORMs
-
-**FastAPI** works with any database and any style of library to talk to the database.
-
-A common pattern is to use an "ORM": an "object-relational mapping" library.
-
-An ORM has tools to convert ("*map*") between *objects* in code and database tables ("*relations*").
-
-With an ORM, you normally create a class that represents a table in a SQL database, each attribute of the class represents a column, with a name and a type.
-
-For example a class `Pet` could represent a SQL table `pets`.
-
-And each *instance* object of that class represents a row in the database.
-
-For example an object `orion_cat` (an instance of `Pet`) could have an attribute `orion_cat.type`, for the column `type`. And the value of that attribute could be, e.g. `"cat"`.
-
-These ORMs also have tools to make the connections or relations between tables or entities.
-
-This way, you could also have an attribute `orion_cat.owner` and the owner would contain the data for this pet's owner, taken from the table *owners*.
-
-So, `orion_cat.owner.name` could be the name (from the `name` column in the `owners` table) of this pet's owner.
-
-It could have a value like `"Arquilian"`.
-
-And the ORM will do all the work to get the information from the corresponding table *owners* when you try to access it from your pet object.
-
-Common ORMs are for example: Django-ORM (part of the Django framework), SQLAlchemy ORM (part of SQLAlchemy, independent of framework) and Peewee (independent of framework), among others.
-
-Here we will see how to work with **SQLAlchemy ORM**.
-
-In a similar way you could use any other ORM.
-
-/// tip
-
-There's an equivalent article using Peewee here in the docs.
+There is an official project generator with **FastAPI** and **PostgreSQL** including a frontend and more tools: <a href="https://github.com/fastapi/full-stack-fastapi-template" class="external-link" target="_blank">https://github.com/fastapi/full-stack-fastapi-template</a>
///
-## File structure
-
-For these examples, let's say you have a directory named `my_super_project` that contains a sub-directory called `sql_app` with a structure like this:
-
-```
-.
-└── sql_app
- ├── __init__.py
- ├── crud.py
- ├── database.py
- ├── main.py
- ├── models.py
- └── schemas.py
-```
-
-The file `__init__.py` is just an empty file, but it tells Python that `sql_app` with all its modules (Python files) is a package.
-
-Now let's see what each file/module does.
-
-## Install `SQLAlchemy`
+This is a very simple and short tutorial, if you want to learn about databases in general, about SQL, or more advanced features, go to the <a href="https://sqlmodel.tiangolo.com/" class="external-link" target="_blank">SQLModel docs</a>.
-First you need to install `SQLAlchemy`.
+## Install `SQLModel`
-Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install it, for example:
+First, make sure you create your [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install `sqlmodel`:
<div class="termy">
```console
-$ pip install sqlalchemy
-
+$ pip install sqlmodel
---> 100%
```
</div>
-## Create the SQLAlchemy parts
-
-Let's refer to the file `sql_app/database.py`.
+## Create the App with a Single Model
-### Import the SQLAlchemy parts
+We'll create the simplest first version of the app with a single **SQLModel** model first.
-```Python hl_lines="1-3"
-{!../../docs_src/sql_databases/sql_app/database.py!}
-```
-
-### Create a database URL for SQLAlchemy
-
-```Python hl_lines="5-6"
-{!../../docs_src/sql_databases/sql_app/database.py!}
-```
-
-In this example, we are "connecting" to a SQLite database (opening a file with the SQLite database).
-
-The file will be located at the same directory in the file `sql_app.db`.
-
-That's why the last part is `./sql_app.db`.
-
-If you were using a **PostgreSQL** database instead, you would just have to uncomment the line:
-
-```Python
-SQLALCHEMY_DATABASE_URL = "postgresql://user:password@postgresserver/db"
-```
+Later we'll improve it increasing security and versatility with **multiple models** below. 🤓
-...and adapt it with your database data and credentials (equivalently for MySQL, MariaDB or any other).
+### Create Models
-/// tip
-
-This is the main line that you would have to modify if you wanted to use a different database.
-
-///
-
-### Create the SQLAlchemy `engine`
+Import `SQLModel` and create a database model:
-The first step is to create a SQLAlchemy "engine".
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[1:11] hl[7:11] *}
-We will later use this `engine` in other places.
+The `Hero` class is very similar to a Pydantic model (in fact, underneath, it actually *is a Pydantic model*).
-```Python hl_lines="8-10"
-{!../../docs_src/sql_databases/sql_app/database.py!}
-```
+There are a few differences:
-#### Note
+* `table=True` tells SQLModel that this is a *table model*, it should represent a **table** in the SQL database, it's not just a *data model* (as would be any other regular Pydantic class).
-The argument:
+* `Field(primary_key=True)` tells SQLModel that the `id` is the **primary key** in the SQL database (you can learn more about SQL primary keys in the SQLModel docs).
-```Python
-connect_args={"check_same_thread": False}
-```
+ By having the type as `int | None`, SQLModel will know that this column should be an `INTEGER` in the SQL database and that it should be `NULLABLE`.
-...is needed only for `SQLite`. It's not needed for other databases.
+* `Field(index=True)` tells SQLModel that it should create a **SQL index** for this column, that would allow faster lookups in the database when reading data filtered by this column.
-/// info | "Technical Details"
+ SQLModel will know that something declared as `str` will be a SQL column of type `TEXT` (or `VARCHAR`, depending on the database).
-By default SQLite will only allow one thread to communicate with it, assuming that each thread would handle an independent request.
+### Create an Engine
-This is to prevent accidentally sharing the same connection for different things (for different requests).
+A SQLModel `engine` (underneath it's actually a SQLAlchemy `engine`) is what **holds the connections** to the database.
-But in FastAPI, using normal functions (`def`) more than one thread could interact with the database for the same request, so we need to make SQLite know that it should allow that with `connect_args={"check_same_thread": False}`.
+You would have **one single `engine` object** for all your code to connect to the same database.
-Also, we will make sure each request gets its own database connection session in a dependency, so there's no need for that default mechanism.
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[14:18] hl[14:15,17:18] *}
-///
+Using `check_same_thread=False` allows FastAPI to use the same SQLite database in different threads. This is necessary as **one single request** could use **more than one thread** (for example in dependencies).
-### Create a `SessionLocal` class
+Don't worry, with the way the code is structured, we'll make sure we use **a single SQLModel *session* per request** later, this is actually what the `check_same_thread` is trying to achieve.
-Each instance of the `SessionLocal` class will be a database session. The class itself is not a database session yet.
+### Create the Tables
-But once we create an instance of the `SessionLocal` class, this instance will be the actual database session.
+We then add a function that uses `SQLModel.metadata.create_all(engine)` to **create the tables** for all the *table models*.
-We name it `SessionLocal` to distinguish it from the `Session` we are importing from SQLAlchemy.
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[21:22] hl[21:22] *}
-We will use `Session` (the one imported from SQLAlchemy) later.
+### Create a Session Dependency
-To create the `SessionLocal` class, use the function `sessionmaker`:
-
-```Python hl_lines="11"
-{!../../docs_src/sql_databases/sql_app/database.py!}
-```
+A **`Session`** is what stores the **objects in memory** and keeps track of any changes needed in the data, then it **uses the `engine`** to communicate with the database.
-### Create a `Base` class
+We will create a FastAPI **dependency** with `yield` that will provide a new `Session` for each request. This is what ensures that we use a single session per request. 🤓
-Now we will use the function `declarative_base()` that returns a class.
+Then we create an `Annotated` dependency `SessionDep` to simplify the rest of the code that will use this dependency.
-Later we will inherit from this class to create each of the database models or classes (the ORM models):
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[25:30] hl[25:27,30] *}
-```Python hl_lines="13"
-{!../../docs_src/sql_databases/sql_app/database.py!}
-```
+### Create Database Tables on Startup
-## Create the database models
+We will create the database tables when the application starts.
-Let's now see the file `sql_app/models.py`.
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[32:37] hl[35:37] *}
-### Create SQLAlchemy models from the `Base` class
+Here we create the tables on an application startup event.
-We will use this `Base` class we created before to create the SQLAlchemy models.
+For production you would probably use a migration script that runs before you start your app. 🤓
/// tip
-SQLAlchemy uses the term "**model**" to refer to these classes and instances that interact with the database.
-
-But Pydantic also uses the term "**model**" to refer to something different, the data validation, conversion, and documentation classes and instances.
+SQLModel will have migration utilities wrapping Alembic, but for now, you can use <a href="https://alembic.sqlalchemy.org/en/latest/" class="external-link" target="_blank">Alembic</a> directly.
///
-Import `Base` from `database` (the file `database.py` from above).
-
-Create classes that inherit from it.
-
-These classes are the SQLAlchemy models.
-
-```Python hl_lines="4 7-8 18-19"
-{!../../docs_src/sql_databases/sql_app/models.py!}
-```
-
-The `__tablename__` attribute tells SQLAlchemy the name of the table to use in the database for each of these models.
-
-### Create model attributes/columns
-
-Now create all the model (class) attributes.
-
-Each of these attributes represents a column in its corresponding database table.
+### Create a Hero
-We use `Column` from SQLAlchemy as the default value.
+Because each SQLModel model is also a Pydantic model, you can use it in the same **type annotations** that you could use Pydantic models.
-And we pass a SQLAlchemy class "type", as `Integer`, `String`, and `Boolean`, that defines the type in the database, as an argument.
+For example, if you declare a parameter of type `Hero`, it will be read from the **JSON body**.
-```Python hl_lines="1 10-13 21-24"
-{!../../docs_src/sql_databases/sql_app/models.py!}
-```
-
-### Create the relationships
-
-Now create the relationships.
-
-For this, we use `relationship` provided by SQLAlchemy ORM.
-
-This will become, more or less, a "magic" attribute that will contain the values from other tables related to this one.
+The same way, you can declare it as the function's **return type**, and then the shape of the data will show up in the automatic API docs UI.
-```Python hl_lines="2 15 26"
-{!../../docs_src/sql_databases/sql_app/models.py!}
-```
-
-When accessing the attribute `items` in a `User`, as in `my_user.items`, it will have a list of `Item` SQLAlchemy models (from the `items` table) that have a foreign key pointing to this record in the `users` table.
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[40:45] hl[40:45] *}
-When you access `my_user.items`, SQLAlchemy will actually go and fetch the items from the database in the `items` table and populate them here.
+</details>
-And when accessing the attribute `owner` in an `Item`, it will contain a `User` SQLAlchemy model from the `users` table. It will use the `owner_id` attribute/column with its foreign key to know which record to get from the `users` table.
+Here we use the `SessionDep` dependency (a `Session`) to add the new `Hero` to the `Session` instance, commit the changes to the database, refresh the data in the `hero`, and then return it.
-## Create the Pydantic models
+### Read Heroes
-Now let's check the file `sql_app/schemas.py`.
+We can **read** `Hero`s from the database using a `select()`. We can include a `limit` and `offset` to paginate the results.
-/// tip
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[48:55] hl[51:52,54] *}
-To avoid confusion between the SQLAlchemy *models* and the Pydantic *models*, we will have the file `models.py` with the SQLAlchemy models, and the file `schemas.py` with the Pydantic models.
+### Read One Hero
-These Pydantic models define more or less a "schema" (a valid data shape).
+We can **read** a single `Hero`.
-So this will help us avoiding confusion while using both.
-
-///
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[58:63] hl[60] *}
-### Create initial Pydantic *models* / schemas
+### Delete a Hero
-Create an `ItemBase` and `UserBase` Pydantic *models* (or let's say "schemas") to have common attributes while creating or reading data.
+We can also **delete** a `Hero`.
-And create an `ItemCreate` and `UserCreate` that inherit from them (so they will have the same attributes), plus any additional data (attributes) needed for creation.
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[66:73] hl[71] *}
-So, the user will also have a `password` when creating it.
+### Run the App
-But for security, the `password` won't be in other Pydantic *models*, for example, it won't be sent from the API when reading a user.
+You can run the app:
-//// tab | Python 3.10+
-
-```Python hl_lines="1 4-6 9-10 21-22 25-26"
-{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="3 6-8 11-12 23-24 27-28"
-{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="3 6-8 11-12 23-24 27-28"
-{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
-```
-
-////
-
-#### SQLAlchemy style and Pydantic style
-
-Notice that SQLAlchemy *models* define attributes using `=`, and pass the type as a parameter to `Column`, like in:
-
-```Python
-name = Column(String)
-```
+<div class="termy">
-while Pydantic *models* declare the types using `:`, the new type annotation syntax/type hints:
+```console
+$ fastapi dev main.py
-```Python
-name: str
+<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
```
-Keep these in mind, so you don't get confused when using `=` and `:` with them.
-
-### Create Pydantic *models* / schemas for reading / returning
-
-Now create Pydantic *models* (schemas) that will be used when reading data, when returning it from the API.
-
-For example, before creating an item, we don't know what will be the ID assigned to it, but when reading it (when returning it from the API) we will already know its ID.
+</div>
-The same way, when reading a user, we can now declare that `items` will contain the items that belong to this user.
+Then go to the `/docs` UI, you will see that **FastAPI** is using these **models** to **document** the API, and it will use them to **serialize** and **validate** the data too.
-Not only the IDs of those items, but all the data that we defined in the Pydantic *model* for reading items: `Item`.
+<div class="screenshot">
+<img src="/img/tutorial/sql-databases/image01.png">
+</div>
-//// tab | Python 3.10+
+## Update the App with Multiple Models
-```Python hl_lines="13-15 29-32"
-{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
-```
+Now let's **refactor** this app a bit to increase **security** and **versatility**.
-////
+If you check the previous app, in the UI you can see that, up to now, it lets the client decide the `id` of the `Hero` to create. 😱
-//// tab | Python 3.9+
+We shouldn't let that happen, they could overwrite an `id` we already have assigned in the DB. Deciding the `id` should be done by the **backend** or the **database**, **not by the client**.
-```Python hl_lines="15-17 31-34"
-{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
-```
+Additionally, we create a `secret_name` for the hero, but so far, we are returning it everywhere, that's not very **secret**... 😅
-////
+We'll fix these things by adding a few **extra models**. Here's where SQLModel will shine. ✨
-//// tab | Python 3.8+
+### Create Multiple Models
-```Python hl_lines="15-17 31-34"
-{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
-```
+In **SQLModel**, any model class that has `table=True` is a **table model**.
-////
+And any model class that doesn't have `table=True` is a **data model**, these ones are actually just Pydantic models (with a couple of small extra features). 🤓
-/// tip
+With SQLModel, we can use **inheritance** to **avoid duplicating** all the fields in all the cases.
-Notice that the `User`, the Pydantic *model* that will be used when reading a user (returning it from the API) doesn't include the `password`.
+#### `HeroBase` - the base class
-///
+Let's start with a `HeroBase` model that has all the **fields that are shared** by all the models:
-### Use Pydantic's `orm_mode`
+* `name`
+* `age`
-Now, in the Pydantic *models* for reading, `Item` and `User`, add an internal `Config` class.
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[7:9] hl[7:9] *}
-This <a href="https://docs.pydantic.dev/latest/api/config/" class="external-link" target="_blank">`Config`</a> class is used to provide configurations to Pydantic.
+#### `Hero` - the *table model*
-In the `Config` class, set the attribute `orm_mode = True`.
+Then let's create `Hero`, the actual *table model*, with the **extra fields** that are not always in the other models:
-//// tab | Python 3.10+
+* `id`
+* `secret_name`
-```Python hl_lines="13 17-18 29 34-35"
-{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
-```
+Because `Hero` inherits form `HeroBase`, it **also** has the **fields** declared in `HeroBase`, so all the fields for `Hero` are:
-////
+* `id`
+* `name`
+* `age`
+* `secret_name`
-//// tab | Python 3.9+
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[7:14] hl[12:14] *}
-```Python hl_lines="15 19-20 31 36-37"
-{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
-```
+#### `HeroPublic` - the public *data model*
-////
+Next, we create a `HeroPublic` model, this is the one that will be **returned** to the clients of the API.
-//// tab | Python 3.8+
+It has the same fields as `HeroBase`, so it won't include `secret_name`.
-```Python hl_lines="15 19-20 31 36-37"
-{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
-```
+Finally, the identity of our heroes is protected! 🥷
-////
+It also re-declares `id: int`. By doing this, we are making a **contract** with the API clients, so that they can always expect the `id` to be there and to be an `int` (it will never be `None`).
/// tip
-Notice it's assigning a value with `=`, like:
-
-`orm_mode = True`
+Having the return model ensure that a value is always available and always `int` (not `None`) is very useful for the API clients, they can write much simpler code having this certainty.
-It doesn't use `:` as for the type declarations before.
-
-This is setting a config value, not declaring a type.
+Also, **automatically generated clients** will have simpler interfaces, so that the developers communicating with your API can have a much better time working with your API. 😎
///
-Pydantic's `orm_mode` will tell the Pydantic *model* to read the data even if it is not a `dict`, but an ORM model (or any other arbitrary object with attributes).
-
-This way, instead of only trying to get the `id` value from a `dict`, as in:
-
-```Python
-id = data["id"]
-```
-
-it will also try to get it from an attribute, as in:
-
-```Python
-id = data.id
-```
+All the fields in `HeroPublic` are the same as in `HeroBase`, with `id` declared as `int` (not `None`):
-And with this, the Pydantic *model* is compatible with ORMs, and you can just declare it in the `response_model` argument in your *path operations*.
+* `id`
+* `name`
+* `age`
+* `secret_name`
-You will be able to return a database model and it will read the data from it.
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[7:18] hl[17:18] *}
-#### Technical Details about ORM mode
+#### `HeroCreate` - the *data model* to create a hero
-SQLAlchemy and many others are by default "lazy loading".
+Now we create a `HeroCreate` model, this is the one that will **validate** the data from the clients.
-That means, for example, that they don't fetch the data for relationships from the database unless you try to access the attribute that would contain that data.
+It has the same fields as `HeroBase`, and it also has `secret_name`.
-For example, accessing the attribute `items`:
-
-```Python
-current_user.items
-```
-
-would make SQLAlchemy go to the `items` table and get the items for this user, but not before.
-
-Without `orm_mode`, if you returned a SQLAlchemy model from your *path operation*, it wouldn't include the relationship data.
-
-Even if you declared those relationships in your Pydantic models.
-
-But with ORM mode, as Pydantic itself will try to access the data it needs from attributes (instead of assuming a `dict`), you can declare the specific data you want to return and it will be able to go and get it, even from ORMs.
-
-## CRUD utils
-
-Now let's see the file `sql_app/crud.py`.
-
-In this file we will have reusable functions to interact with the data in the database.
-
-**CRUD** comes from: **C**reate, **R**ead, **U**pdate, and **D**elete.
-
-...although in this example we are only creating and reading.
-
-### Read data
-
-Import `Session` from `sqlalchemy.orm`, this will allow you to declare the type of the `db` parameters and have better type checks and completion in your functions.
-
-Import `models` (the SQLAlchemy models) and `schemas` (the Pydantic *models* / schemas).
-
-Create utility functions to:
-
-* Read a single user by ID and by email.
-* Read multiple users.
-* Read multiple items.
-
-```Python hl_lines="1 3 6-7 10-11 14-15 27-28"
-{!../../docs_src/sql_databases/sql_app/crud.py!}
-```
+Now, when the clients **create a new hero**, they will send the `secret_name`, it will be stored in the database, but those secret names won't be returned in the API to the clients.
/// tip
-By creating functions that are only dedicated to interacting with the database (get a user or an item) independent of your *path operation function*, you can more easily reuse them in multiple parts and also add <abbr title="Automated tests, written in code, that check if another piece of code is working correctly.">unit tests</abbr> for them.
-
-///
+This is how you would handle **passwords**. Receive them, but don't return them in the API.
-### Create data
-
-Now create utility functions to create data.
-
-The steps are:
-
-* Create a SQLAlchemy model *instance* with your data.
-* `add` that instance object to your database session.
-* `commit` the changes to the database (so that they are saved).
-* `refresh` your instance (so that it contains any new data from the database, like the generated ID).
-
-```Python hl_lines="18-24 31-36"
-{!../../docs_src/sql_databases/sql_app/crud.py!}
-```
-
-/// info
-
-In Pydantic v1 the method was called `.dict()`, it was deprecated (but still supported) in Pydantic v2, and renamed to `.model_dump()`.
-
-The examples here use `.dict()` for compatibility with Pydantic v1, but you should use `.model_dump()` instead if you can use Pydantic v2.
+You would also **hash** the values of the passwords before storing them, **never store them in plain text**.
///
-/// tip
+The fields of `HeroCreate` are:
-The SQLAlchemy model for `User` contains a `hashed_password` that should contain a secure hashed version of the password.
+* `name`
+* `age`
+* `secret_name`
-But as what the API client provides is the original password, you need to extract it and generate the hashed password in your application.
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[7:22] hl[21:22] *}
-And then pass the `hashed_password` argument with the value to save.
+#### `HeroUpdate` - the *data model* to update a hero
-///
+We didn't have a way to **update a hero** in the previous version of the app, but now with **multiple models**, we can do it. 🎉
-/// warning
+The `HeroUpdate` *data model* is somewhat special, it has **all the same fields** that would be needed to create a new hero, but all the fields are **optional** (they all have a default value). This way, when you update a hero, you can send just the fields that you want to update.
-This example is not secure, the password is not hashed.
+Because all the **fields actually change** (the type now includes `None` and they now have a default value of `None`), we need to **re-declare** them.
-In a real life application you would need to hash the password and never save them in plaintext.
+We don't really need to inherit from `HeroBase` because we are re-declaring all the fields. I'll leave it inheriting just for consistency, but this is not necessary. It's more a matter of personal taste. 🤷
-For more details, go back to the Security section in the tutorial.
+The fields of `HeroUpdate` are:
-Here we are focusing only on the tools and mechanics of databases.
+* `name`
+* `age`
+* `secret_name`
-///
-
-/// tip
-
-Instead of passing each of the keyword arguments to `Item` and reading each one of them from the Pydantic *model*, we are generating a `dict` with the Pydantic *model*'s data with:
-
-`item.dict()`
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[7:28] hl[25:28] *}
-and then we are passing the `dict`'s key-value pairs as the keyword arguments to the SQLAlchemy `Item`, with:
+### Create with `HeroCreate` and return a `HeroPublic`
-`Item(**item.dict())`
-
-And then we pass the extra keyword argument `owner_id` that is not provided by the Pydantic *model*, with:
-
-`Item(**item.dict(), owner_id=user_id)`
-
-///
+Now that we have **multiple models**, we can update the parts of the app that use them.
-## Main **FastAPI** app
+We receive in the request a `HeroCreate` *data model*, and from it, we create a `Hero` *table model*.
-And now in the file `sql_app/main.py` let's integrate and use all the other parts we created before.
+This new *table model* `Hero` will have the fields sent by the client, and will also have an `id` generated by the database.
-### Create the database tables
+Then we return the same *table model* `Hero` as is from the function. But as we declare the `response_model` with the `HeroPublic` *data model*, **FastAPI** will use `HeroPublic` to validate and serialize the data.
-In a very simplistic way create the database tables:
-
-//// tab | Python 3.9+
-
-```Python hl_lines="7"
-{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9"
-{!> ../../docs_src/sql_databases/sql_app/main.py!}
-```
-
-////
-
-#### Alembic Note
-
-Normally you would probably initialize your database (create tables, etc) with <a href="https://alembic.sqlalchemy.org/en/latest/" class="external-link" target="_blank">Alembic</a>.
-
-And you would also use Alembic for "migrations" (that's its main job).
-
-A "migration" is the set of steps needed whenever you change the structure of your SQLAlchemy models, add a new attribute, etc. to replicate those changes in the database, add a new column, a new table, etc.
-
-You can find an example of Alembic in a FastAPI project in the [Full Stack FastAPI Template](../project-generation.md){.internal-link target=_blank}. Specifically in <a href="https://github.com/tiangolo/full-stack-fastapi-template/tree/master/backend/app/alembic" class="external-link" target="_blank">the `alembic` directory in the source code</a>.
-
-### Create a dependency
-
-Now use the `SessionLocal` class we created in the `sql_app/database.py` file to create a dependency.
-
-We need to have an independent database session/connection (`SessionLocal`) per request, use the same session through all the request and then close it after the request is finished.
-
-And then a new session will be created for the next request.
-
-For that, we will create a new dependency with `yield`, as explained before in the section about [Dependencies with `yield`](dependencies/dependencies-with-yield.md){.internal-link target=_blank}.
-
-Our dependency will create a new SQLAlchemy `SessionLocal` that will be used in a single request, and then close it once the request is finished.
-
-//// tab | Python 3.9+
-
-```Python hl_lines="13-18"
-{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="15-20"
-{!> ../../docs_src/sql_databases/sql_app/main.py!}
-```
-
-////
-
-/// info
-
-We put the creation of the `SessionLocal()` and handling of the requests in a `try` block.
-
-And then we close it in the `finally` block.
-
-This way we make sure the database session is always closed after the request. Even if there was an exception while processing the request.
-
-But you can't raise another exception from the exit code (after `yield`). See more in [Dependencies with `yield` and `HTTPException`](dependencies/dependencies-with-yield.md#dependencies-with-yield-and-httpexception){.internal-link target=_blank}
-
-///
-
-And then, when using the dependency in a *path operation function*, we declare it with the type `Session` we imported directly from SQLAlchemy.
-
-This will then give us better editor support inside the *path operation function*, because the editor will know that the `db` parameter is of type `Session`:
-
-//// tab | Python 3.9+
-
-```Python hl_lines="22 30 36 45 51"
-{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="24 32 38 47 53"
-{!> ../../docs_src/sql_databases/sql_app/main.py!}
-```
-
-////
-
-/// info | "Technical Details"
-
-The parameter `db` is actually of type `SessionLocal`, but this class (created with `sessionmaker()`) is a "proxy" of a SQLAlchemy `Session`, so, the editor doesn't really know what methods are provided.
-
-But by declaring the type as `Session`, the editor now can know the available methods (`.add()`, `.query()`, `.commit()`, etc) and can provide better support (like completion). The type declaration doesn't affect the actual object.
-
-///
-
-### Create your **FastAPI** *path operations*
-
-Now, finally, here's the standard **FastAPI** *path operations* code.
-
-//// tab | Python 3.9+
-
-```Python hl_lines="21-26 29-32 35-40 43-47 50-53"
-{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="23-28 31-34 37-42 45-49 52-55"
-{!> ../../docs_src/sql_databases/sql_app/main.py!}
-```
-
-////
-
-We are creating the database session before each request in the dependency with `yield`, and then closing it afterwards.
-
-And then we can create the required dependency in the *path operation function*, to get that session directly.
-
-With that, we can just call `crud.get_user` directly from inside of the *path operation function* and use that session.
-
-/// tip
-
-Notice that the values you return are SQLAlchemy models, or lists of SQLAlchemy models.
-
-But as all the *path operations* have a `response_model` with Pydantic *models* / schemas using `orm_mode`, the data declared in your Pydantic models will be extracted from them and returned to the client, with all the normal filtering and validation.
-
-///
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[56:62] hl[56:58] *}
/// tip
-Also notice that there are `response_models` that have standard Python types like `List[schemas.Item]`.
-
-But as the content/parameter of that `List` is a Pydantic *model* with `orm_mode`, the data will be retrieved and returned to the client as normally, without problems.
-
-///
-
-### About `def` vs `async def`
-
-Here we are using SQLAlchemy code inside of the *path operation function* and in the dependency, and, in turn, it will go and communicate with an external database.
-
-That could potentially require some "waiting".
-
-But as SQLAlchemy doesn't have compatibility for using `await` directly, as would be with something like:
-
-```Python
-user = await db.query(User).first()
-```
-
-...and instead we are using:
-
-```Python
-user = db.query(User).first()
-```
-
-Then we should declare the *path operation functions* and the dependency without `async def`, just with a normal `def`, as:
-
-```Python hl_lines="2"
-@app.get("/users/{user_id}", response_model=schemas.User)
-def read_user(user_id: int, db: Session = Depends(get_db)):
- db_user = crud.get_user(db, user_id=user_id)
- ...
-```
-
-/// info
+Now we use `response_model=HeroPublic` instead of the **return type annotation** `-> HeroPublic` because the value that we are returning is actually *not* a `HeroPublic`.
-If you need to connect to your relational database asynchronously, see [Async SQL (Relational) Databases](../how-to/async-sql-encode-databases.md){.internal-link target=_blank}.
+If we had declared `-> HeroPublic`, your editor and linter would complain (rightfully so) that you are returning a `Hero` instead of a `HeroPublic`.
-///
-
-/// note | "Very Technical Details"
-
-If you are curious and have a deep technical knowledge, you can check the very technical details of how this `async def` vs `def` is handled in the [Async](../async.md#very-technical-details){.internal-link target=_blank} docs.
+By declaring it in `response_model` we are telling **FastAPI** to do its thing, without interfering with the type annotations and the help from your editor and other tools.
///
-## Migrations
-
-Because we are using SQLAlchemy directly and we don't require any kind of plug-in for it to work with **FastAPI**, we could integrate database <abbr title="Automatically updating the database to have any new column we define in our models.">migrations</abbr> with <a href="https://alembic.sqlalchemy.org" class="external-link" target="_blank">Alembic</a> directly.
-
-And as the code related to SQLAlchemy and the SQLAlchemy models lives in separate independent files, you would even be able to perform the migrations with Alembic without having to install FastAPI, Pydantic, or anything else.
-
-The same way, you would be able to use the same SQLAlchemy models and utilities in other parts of your code that are not related to **FastAPI**.
-
-For example, in a background task worker with <a href="https://docs.celeryq.dev" class="external-link" target="_blank">Celery</a>, <a href="https://python-rq.org/" class="external-link" target="_blank">RQ</a>, or <a href="https://arq-docs.helpmanual.io/" class="external-link" target="_blank">ARQ</a>.
-
-## Review all the files
-
- Remember you should have a directory named `my_super_project` that contains a sub-directory called `sql_app`.
-
-`sql_app` should have the following files:
-
-* `sql_app/__init__.py`: is an empty file.
-
-* `sql_app/database.py`:
-
-```Python
-{!../../docs_src/sql_databases/sql_app/database.py!}
-```
-
-* `sql_app/models.py`:
+### Read Heroes with `HeroPublic`
-```Python
-{!../../docs_src/sql_databases/sql_app/models.py!}
-```
-
-* `sql_app/schemas.py`:
-
-//// tab | Python 3.10+
-
-```Python
-{!> ../../docs_src/sql_databases/sql_app_py310/schemas.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python
-{!> ../../docs_src/sql_databases/sql_app_py39/schemas.py!}
-```
-
-////
+We can do the same as before to **read** `Hero`s, again, we use `response_model=list[HeroPublic]` to ensure that the data is validated and serialized correctly.
-//// tab | Python 3.8+
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[65:72] hl[65] *}
-```Python
-{!> ../../docs_src/sql_databases/sql_app/schemas.py!}
-```
-
-////
-
-* `sql_app/crud.py`:
-
-```Python
-{!../../docs_src/sql_databases/sql_app/crud.py!}
-```
+### Read One Hero with `HeroPublic`
-* `sql_app/main.py`:
+We can **read** a single hero:
-//// tab | Python 3.9+
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[75:80] hl[77] *}
-```Python
-{!> ../../docs_src/sql_databases/sql_app_py39/main.py!}
-```
+### Update a Hero with `HeroUpdate`
-////
+We can **update a hero**. For this we use an HTTP `PATCH` operation.
-//// tab | Python 3.8+
+And in the code, we get a `dict` with all the data sent by the client, **only the data sent by the client**, excluding any values that would be there just for being the default values. To do it we use `exclude_unset=True`. This is the main trick. 🪄
-```Python
-{!> ../../docs_src/sql_databases/sql_app/main.py!}
-```
+Then we use `hero_db.sqlmodel_update(hero_data)` to update the `hero_db` with the data from `hero_data`.
-////
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[83:93] hl[83:84,88:89] *}
-## Check it
+### Delete a Hero Again
-You can copy this code and use it as is.
+**Deleting** a hero stays pretty much the same.
-/// info
+We won't satisfy the desire to refactor everything in this one. 😅
-In fact, the code shown here is part of the tests. As most of the code in these docs.
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[96:103] hl[101] *}
-///
-
-Then you can run it with Uvicorn:
+### Run the App Again
+You can run the app again:
<div class="termy">
```console
-$ uvicorn sql_app.main:app --reload
+$ fastapi dev main.py
<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
```
</div>
-And then, you can open your browser at <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
-
-And you will be able to interact with your **FastAPI** application, reading data from a real database:
-
-<img src="/img/tutorial/sql-databases/image01.png">
-
-## Interact with the database directly
-
-If you want to explore the SQLite database (file) directly, independently of FastAPI, to debug its contents, add tables, columns, records, modify data, etc. you can use <a href="https://sqlitebrowser.org/" class="external-link" target="_blank">DB Browser for SQLite</a>.
-
-It will look like this:
+If you go to the `/docs` API UI, you will see that it is now updated, and it won't expect to receive the `id` from the client when creating a hero, etc.
+<div class="screenshot">
<img src="/img/tutorial/sql-databases/image02.png">
+</div>
-You can also use an online SQLite browser like <a href="https://inloop.github.io/sqlite-viewer/" class="external-link" target="_blank">SQLite Viewer</a> or <a href="https://extendsclass.com/sqlite-browser.html" class="external-link" target="_blank">ExtendsClass</a>.
-
-## Alternative DB session with middleware
-
-If you can't use dependencies with `yield` -- for example, if you are not using **Python 3.7** and can't install the "backports" mentioned above for **Python 3.6** -- you can set up the session in a "middleware" in a similar way.
-
-A "middleware" is basically a function that is always executed for each request, with some code executed before, and some code executed after the endpoint function.
-
-### Create a middleware
-
-The middleware we'll add (just a function) will create a new SQLAlchemy `SessionLocal` for each request, add it to the request and then close it once the request is finished.
-
-//// tab | Python 3.9+
-
-```Python hl_lines="12-20"
-{!> ../../docs_src/sql_databases/sql_app_py39/alt_main.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="14-22"
-{!> ../../docs_src/sql_databases/sql_app/alt_main.py!}
-```
-
-////
-
-/// info
-
-We put the creation of the `SessionLocal()` and handling of the requests in a `try` block.
-
-And then we close it in the `finally` block.
-
-This way we make sure the database session is always closed after the request. Even if there was an exception while processing the request.
-
-///
-
-### About `request.state`
-
-`request.state` is a property of each `Request` object. It is there to store arbitrary objects attached to the request itself, like the database session in this case. You can read more about it in <a href="https://www.starlette.io/requests/#other-state" class="external-link" target="_blank">Starlette's docs about `Request` state</a>.
-
-For us in this case, it helps us ensure a single database session is used through all the request, and then closed afterwards (in the middleware).
-
-### Dependencies with `yield` or middleware
-
-Adding a **middleware** here is similar to what a dependency with `yield` does, with some differences:
-
-* It requires more code and is a bit more complex.
-* The middleware has to be an `async` function.
- * If there is code in it that has to "wait" for the network, it could "block" your application there and degrade performance a bit.
- * Although it's probably not very problematic here with the way `SQLAlchemy` works.
- * But if you added more code to the middleware that had a lot of <abbr title="input and output">I/O</abbr> waiting, it could then be problematic.
-* A middleware is run for *every* request.
- * So, a connection will be created for every request.
- * Even when the *path operation* that handles that request didn't need the DB.
-
-/// tip
-
-It's probably better to use dependencies with `yield` when they are enough for the use case.
-
-///
-
-/// info
-
-Dependencies with `yield` were added recently to **FastAPI**.
+## Recap
-A previous version of this tutorial only had the examples with a middleware and there are probably several applications using the middleware for database session management.
+You can use <a href="https://sqlmodel.tiangolo.com/" class="external-link" target="_blank">**SQLModel**</a> to interact with a SQL database and simplify the code with *data models* and *table models*.
-///
+You can learn a lot more at the **SQLModel** docs, there's a longer mini <a href="https://sqlmodel.tiangolo.com/tutorial/fastapi/" class="external-link" target="_blank">tutorial on using SQLModel with **FastAPI**</a>. 🚀
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index e55c6f176..8e0f6765d 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -71,13 +71,11 @@ plugins:
redirects:
redirect_maps:
deployment/deta.md: deployment/cloud.md
- advanced/sql-databases-peewee.md: how-to/sql-databases-peewee.md
- advanced/async-sql-databases.md: how-to/async-sql-encode-databases.md
- advanced/nosql-databases.md: how-to/nosql-databases-couchbase.md
advanced/graphql.md: how-to/graphql.md
advanced/custom-request-and-route.md: how-to/custom-request-and-route.md
advanced/conditional-openapi.md: how-to/conditional-openapi.md
advanced/extending-openapi.md: how-to/extending-openapi.md
+ advanced/testing-database.md: how-to/testing-database.md
mkdocstrings:
handlers:
python:
@@ -187,7 +185,6 @@ nav:
- advanced/testing-websockets.md
- advanced/testing-events.md
- advanced/testing-dependencies.md
- - advanced/testing-database.md
- advanced/async-tests.md
- advanced/settings.md
- advanced/openapi-callbacks.md
@@ -214,9 +211,7 @@ nav:
- how-to/separate-openapi-schemas.md
- how-to/custom-docs-ui-assets.md
- how-to/configure-swagger-ui.md
- - how-to/sql-databases-peewee.md
- - how-to/async-sql-encode-databases.md
- - how-to/nosql-databases-couchbase.md
+ - how-to/testing-database.md
- Reference (Code API):
- reference/index.md
- reference/fastapi.md
diff --git a/docs/zh/docs/advanced/testing-database.md b/docs/zh/docs/advanced/testing-database.md
deleted file mode 100644
index ecab4f65b..000000000
--- a/docs/zh/docs/advanced/testing-database.md
+++ /dev/null
@@ -1,101 +0,0 @@
-# 测试数据库
-
-您还可以使用[测试依赖项](testing-dependencies.md){.internal-link target=_blank}中的覆盖依赖项方法变更测试的数据库。
-
-实现设置其它测试数据库、在测试后回滚数据、或预填测试数据等操作。
-
-本章的主要思路与上一章完全相同。
-
-## 为 SQL 应用添加测试
-
-为了使用测试数据库，我们要升级 [SQL 关系型数据库](../tutorial/sql-databases.md){.internal-link target=_blank} 一章中的示例。
-
-应用的所有代码都一样，直接查看那一章的示例代码即可。
-
-本章只是新添加了测试文件。
-
-正常的依赖项 `get_db()` 返回数据库会话。
-
-测试时使用覆盖依赖项返回自定义数据库会话代替正常的依赖项。
-
-本例中，要创建仅用于测试的临时数据库。
-
-## 文件架构
-
-创建新文件 `sql_app/tests/test_sql_app.py`。
-
-因此，新的文件架构如下：
-
-``` hl_lines="9-11"
-.
-└── sql_app
- ├── __init__.py
- ├── crud.py
- ├── database.py
- ├── main.py
- ├── models.py
- ├── schemas.py
- └── tests
- ├── __init__.py
- └── test_sql_app.py
-```
-
-## 创建新的数据库会话
-
-首先，为新建数据库创建新的数据库会话。
-
-测试时，使用 `test.db` 替代 `sql_app.db`。
-
-但其余的会话代码基本上都是一样的，只要复制就可以了。
-
-```Python hl_lines="8-13"
-{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
-```
-
-/// tip | "提示"
-
-为减少代码重复，最好把这段代码写成函数，在 `database.py` 与 `tests/test_sql_app.py`中使用。
-
-为了把注意力集中在测试代码上，本例只是复制了这段代码。
-
-///
-
-## 创建数据库
-
-因为现在是想在新文件中使用新数据库，所以要使用以下代码创建数据库：
-
-```Python
-Base.metadata.create_all(bind=engine)
-```
-
-一般是在 `main.py` 中调用这行代码，但在 `main.py` 里，这行代码用于创建 `sql_app.db`，但是现在要为测试创建 `test.db`。
-
-因此，要在测试代码中添加这行代码创建新的数据库文件。
-
-```Python hl_lines="16"
-{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
-```
-
-## 覆盖依赖项
-
-接下来，创建覆盖依赖项，并为应用添加覆盖内容。
-
-```Python hl_lines="19-24 27"
-{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
-```
-
-/// tip | "提示"
-
-`overrider_get_db()` 与 `get_db` 的代码几乎完全一样，只是 `overrider_get_db` 中使用测试数据库的 `TestingSessionLocal`。
-
-///
-
-## 测试应用
-
-然后，就可以正常测试了。
-
-```Python hl_lines="32-47"
-{!../../docs_src/sql_databases/sql_app/tests/test_sql_app.py!}
-```
-
-测试期间，所有在数据库中所做的修改都在 `test.db` 里，不会影响主应用的 `sql_app.db`。
diff --git a/docs_src/async_sql_databases/tutorial001.py b/docs_src/async_sql_databases/tutorial001.py
deleted file mode 100644
index cbf43d790..000000000
--- a/docs_src/async_sql_databases/tutorial001.py
+++ /dev/null
@@ -1,65 +0,0 @@
-from typing import List
-
-import databases
-import sqlalchemy
-from fastapi import FastAPI
-from pydantic import BaseModel
-
-# SQLAlchemy specific code, as with any other app
-DATABASE_URL = "sqlite:///./test.db"
-# DATABASE_URL = "postgresql://user:password@postgresserver/db"
-
-database = databases.Database(DATABASE_URL)
-
-metadata = sqlalchemy.MetaData()
-
-notes = sqlalchemy.Table(
- "notes",
- metadata,
- sqlalchemy.Column("id", sqlalchemy.Integer, primary_key=True),
- sqlalchemy.Column("text", sqlalchemy.String),
- sqlalchemy.Column("completed", sqlalchemy.Boolean),
-)
-
-
-engine = sqlalchemy.create_engine(
- DATABASE_URL, connect_args={"check_same_thread": False}
-)
-metadata.create_all(engine)
-
-
-class NoteIn(BaseModel):
- text: str
- completed: bool
-
-
-class Note(BaseModel):
- id: int
- text: str
- completed: bool
-
-
-app = FastAPI()
-
-
-@app.on_event("startup")
-async def startup():
- await database.connect()
-
-
-@app.on_event("shutdown")
-async def shutdown():
- await database.disconnect()
-
-
-@app.get("/notes/", response_model=List[Note])
-async def read_notes():
- query = notes.select()
- return await database.fetch_all(query)
-
-
-@app.post("/notes/", response_model=Note)
-async def create_note(note: NoteIn):
- query = notes.insert().values(text=note.text, completed=note.completed)
- last_record_id = await database.execute(query)
- return {**note.dict(), "id": last_record_id}
diff --git a/docs_src/nosql_databases/tutorial001.py b/docs_src/nosql_databases/tutorial001.py
deleted file mode 100644
index 91893e528..000000000
--- a/docs_src/nosql_databases/tutorial001.py
+++ /dev/null
@@ -1,53 +0,0 @@
-from typing import Union
-
-from couchbase import LOCKMODE_WAIT
-from couchbase.bucket import Bucket
-from couchbase.cluster import Cluster, PasswordAuthenticator
-from fastapi import FastAPI
-from pydantic import BaseModel
-
-USERPROFILE_DOC_TYPE = "userprofile"
-
-
-def get_bucket():
- cluster = Cluster(
- "couchbase://couchbasehost:8091?fetch_mutation_tokens=1&operation_timeout=30&n1ql_timeout=300"
- )
- authenticator = PasswordAuthenticator("username", "password")
- cluster.authenticate(authenticator)
- bucket: Bucket = cluster.open_bucket("bucket_name", lockmode=LOCKMODE_WAIT)
- bucket.timeout = 30
- bucket.n1ql_timeout = 300
- return bucket
-
-
-class User(BaseModel):
- username: str
- email: Union[str, None] = None
- full_name: Union[str, None] = None
- disabled: Union[bool, None] = None
-
-
-class UserInDB(User):
- type: str = USERPROFILE_DOC_TYPE
- hashed_password: str
-
-
-def get_user(bucket: Bucket, username: str):
- doc_id = f"userprofile::{username}"
- result = bucket.get(doc_id, quiet=True)
- if not result.value:
- return None
- user = UserInDB(**result.value)
- return user
-
-
-# FastAPI specific code
-app = FastAPI()
-
-
-@app.get("/users/{username}", response_model=User)
-def read_user(username: str):
- bucket = get_bucket()
- user = get_user(bucket=bucket, username=username)
- return user
diff --git a/docs_src/sql_databases/sql_app/__init__.py b/docs_src/sql_databases/sql_app/__init__.py
deleted file mode 100644
index e69de29bb..000000000
diff --git a/docs_src/sql_databases/sql_app/alt_main.py b/docs_src/sql_databases/sql_app/alt_main.py
deleted file mode 100644
index f7206bcb4..000000000
--- a/docs_src/sql_databases/sql_app/alt_main.py
+++ /dev/null
@@ -1,62 +0,0 @@
-from typing import List
-
-from fastapi import Depends, FastAPI, HTTPException, Request, Response
-from sqlalchemy.orm import Session
-
-from . import crud, models, schemas
-from .database import SessionLocal, engine
-
-models.Base.metadata.create_all(bind=engine)
-
-app = FastAPI()
-
-
-@app.middleware("http")
-async def db_session_middleware(request: Request, call_next):
- response = Response("Internal server error", status_code=500)
- try:
- request.state.db = SessionLocal()
- response = await call_next(request)
- finally:
- request.state.db.close()
- return response
-
-
-# Dependency
-def get_db(request: Request):
- return request.state.db
-
-
-@app.post("/users/", response_model=schemas.User)
-def create_user(user: schemas.UserCreate, db: Session = Depends(get_db)):
- db_user = crud.get_user_by_email(db, email=user.email)
- if db_user:
- raise HTTPException(status_code=400, detail="Email already registered")
- return crud.create_user(db=db, user=user)
-
-
-@app.get("/users/", response_model=List[schemas.User])
-def read_users(skip: int = 0, limit: int = 100, db: Session = Depends(get_db)):
- users = crud.get_users(db, skip=skip, limit=limit)
- return users
-
-
-@app.get("/users/{user_id}", response_model=schemas.User)
-def read_user(user_id: int, db: Session = Depends(get_db)):
- db_user = crud.get_user(db, user_id=user_id)
- if db_user is None:
- raise HTTPException(status_code=404, detail="User not found")
- return db_user
-
-
-@app.post("/users/{user_id}/items/", response_model=schemas.Item)
-def create_item_for_user(
- user_id: int, item: schemas.ItemCreate, db: Session = Depends(get_db)
-):
- return crud.create_user_item(db=db, item=item, user_id=user_id)
-
-
-@app.get("/items/", response_model=List[schemas.Item])
-def read_items(skip: int = 0, limit: int = 100, db: Session = Depends(get_db)):
- items = crud.get_items(db, skip=skip, limit=limit)
- return items
diff --git a/docs_src/sql_databases/sql_app/crud.py b/docs_src/sql_databases/sql_app/crud.py
deleted file mode 100644
index 679acdb5c..000000000
--- a/docs_src/sql_databases/sql_app/crud.py
+++ /dev/null
@@ -1,36 +0,0 @@
-from sqlalchemy.orm import Session
-
-from . import models, schemas
-
-
-def get_user(db: Session, user_id: int):
- return db.query(models.User).filter(models.User.id == user_id).first()
-
-
-def get_user_by_email(db: Session, email: str):
- return db.query(models.User).filter(models.User.email == email).first()
-
-
-def get_users(db: Session, skip: int = 0, limit: int = 100):
- return db.query(models.User).offset(skip).limit(limit).all()
-
-
-def create_user(db: Session, user: schemas.UserCreate):
- fake_hashed_password = user.password + "notreallyhashed"
- db_user = models.User(email=user.email, hashed_password=fake_hashed_password)
- db.add(db_user)
- db.commit()
- db.refresh(db_user)
- return db_user
-
-
-def get_items(db: Session, skip: int = 0, limit: int = 100):
- return db.query(models.Item).offset(skip).limit(limit).all()
-
-
-def create_user_item(db: Session, item: schemas.ItemCreate, user_id: int):
- db_item = models.Item(**item.dict(), owner_id=user_id)
- db.add(db_item)
- db.commit()
- db.refresh(db_item)
- return db_item
diff --git a/docs_src/sql_databases/sql_app/database.py b/docs_src/sql_databases/sql_app/database.py
deleted file mode 100644
index 45a8b9f69..000000000
--- a/docs_src/sql_databases/sql_app/database.py
+++ /dev/null
@@ -1,13 +0,0 @@
-from sqlalchemy import create_engine
-from sqlalchemy.ext.declarative import declarative_base
-from sqlalchemy.orm import sessionmaker
-
-SQLALCHEMY_DATABASE_URL = "sqlite:///./sql_app.db"
-# SQLALCHEMY_DATABASE_URL = "postgresql://user:password@postgresserver/db"
-
-engine = create_engine(
- SQLALCHEMY_DATABASE_URL, connect_args={"check_same_thread": False}
-)
-SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
-
-Base = declarative_base()
diff --git a/docs_src/sql_databases/sql_app/main.py b/docs_src/sql_databases/sql_app/main.py
deleted file mode 100644
index e7508c59d..000000000
--- a/docs_src/sql_databases/sql_app/main.py
+++ /dev/null
@@ -1,55 +0,0 @@
-from typing import List
-
-from fastapi import Depends, FastAPI, HTTPException
-from sqlalchemy.orm import Session
-
-from . import crud, models, schemas
-from .database import SessionLocal, engine
-
-models.Base.metadata.create_all(bind=engine)
-
-app = FastAPI()
-
-
-# Dependency
-def get_db():
- db = SessionLocal()
- try:
- yield db
- finally:
- db.close()
-
-
-@app.post("/users/", response_model=schemas.User)
-def create_user(user: schemas.UserCreate, db: Session = Depends(get_db)):
- db_user = crud.get_user_by_email(db, email=user.email)
- if db_user:
- raise HTTPException(status_code=400, detail="Email already registered")
- return crud.create_user(db=db, user=user)
-
-
-@app.get("/users/", response_model=List[schemas.User])
-def read_users(skip: int = 0, limit: int = 100, db: Session = Depends(get_db)):
- users = crud.get_users(db, skip=skip, limit=limit)
- return users
-
-
-@app.get("/users/{user_id}", response_model=schemas.User)
-def read_user(user_id: int, db: Session = Depends(get_db)):
- db_user = crud.get_user(db, user_id=user_id)
- if db_user is None:
- raise HTTPException(status_code=404, detail="User not found")
- return db_user
-
-
-@app.post("/users/{user_id}/items/", response_model=schemas.Item)
-def create_item_for_user(
- user_id: int, item: schemas.ItemCreate, db: Session = Depends(get_db)
-):
- return crud.create_user_item(db=db, item=item, user_id=user_id)
-
-
-@app.get("/items/", response_model=List[schemas.Item])
-def read_items(skip: int = 0, limit: int = 100, db: Session = Depends(get_db)):
- items = crud.get_items(db, skip=skip, limit=limit)
- return items
diff --git a/docs_src/sql_databases/sql_app/models.py b/docs_src/sql_databases/sql_app/models.py
deleted file mode 100644
index 09ae2a807..000000000
--- a/docs_src/sql_databases/sql_app/models.py
+++ /dev/null
@@ -1,26 +0,0 @@
-from sqlalchemy import Boolean, Column, ForeignKey, Integer, String
-from sqlalchemy.orm import relationship
-
-from .database import Base
-
-
-class User(Base):
- __tablename__ = "users"
-
- id = Column(Integer, primary_key=True)
- email = Column(String, unique=True, index=True)
- hashed_password = Column(String)
- is_active = Column(Boolean, default=True)
-
- items = relationship("Item", back_populates="owner")
-
-
-class Item(Base):
- __tablename__ = "items"
-
- id = Column(Integer, primary_key=True)
- title = Column(String, index=True)
- description = Column(String, index=True)
- owner_id = Column(Integer, ForeignKey("users.id"))
-
- owner = relationship("User", back_populates="items")
diff --git a/docs_src/sql_databases/sql_app/schemas.py b/docs_src/sql_databases/sql_app/schemas.py
deleted file mode 100644
index c49beba88..000000000
--- a/docs_src/sql_databases/sql_app/schemas.py
+++ /dev/null
@@ -1,37 +0,0 @@
-from typing import List, Union
-
-from pydantic import BaseModel
-
-
-class ItemBase(BaseModel):
- title: str
- description: Union[str, None] = None
-
-
-class ItemCreate(ItemBase):
- pass
-
-
-class Item(ItemBase):
- id: int
- owner_id: int
-
- class Config:
- orm_mode = True
-
-
-class UserBase(BaseModel):
- email: str
-
-
-class UserCreate(UserBase):
- password: str
-
-
-class User(UserBase):
- id: int
- is_active: bool
- items: List[Item] = []
-
- class Config:
- orm_mode = True
diff --git a/docs_src/sql_databases/sql_app/tests/__init__.py b/docs_src/sql_databases/sql_app/tests/__init__.py
deleted file mode 100644
index e69de29bb..000000000
diff --git a/docs_src/sql_databases/sql_app/tests/test_sql_app.py b/docs_src/sql_databases/sql_app/tests/test_sql_app.py
deleted file mode 100644
index 5f55add0a..000000000
--- a/docs_src/sql_databases/sql_app/tests/test_sql_app.py
+++ /dev/null
@@ -1,50 +0,0 @@
-from fastapi.testclient import TestClient
-from sqlalchemy import create_engine
-from sqlalchemy.orm import sessionmaker
-from sqlalchemy.pool import StaticPool
-
-from ..database import Base
-from ..main import app, get_db
-
-SQLALCHEMY_DATABASE_URL = "sqlite://"
-
-engine = create_engine(
- SQLALCHEMY_DATABASE_URL,
- connect_args={"check_same_thread": False},
- poolclass=StaticPool,
-)
-TestingSessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
-
-
-Base.metadata.create_all(bind=engine)
-
-
-def override_get_db():
- try:
- db = TestingSessionLocal()
- yield db
- finally:
- db.close()
-
-
-app.dependency_overrides[get_db] = override_get_db
-
-client = TestClient(app)
-
-
-def test_create_user():
- response = client.post(
- "/users/",
- json={"email": "deadpool@example.com", "password": "chimichangas4life"},
- )
- assert response.status_code == 200, response.text
- data = response.json()
- assert data["email"] == "deadpool@example.com"
- assert "id" in data
- user_id = data["id"]
-
- response = client.get(f"/users/{user_id}")
- assert response.status_code == 200, response.text
- data = response.json()
- assert data["email"] == "deadpool@example.com"
- assert data["id"] == user_id
diff --git a/docs_src/sql_databases/sql_app_py310/__init__.py b/docs_src/sql_databases/sql_app_py310/__init__.py
deleted file mode 100644
index e69de29bb..000000000
diff --git a/docs_src/sql_databases/sql_app_py310/alt_main.py b/docs_src/sql_databases/sql_app_py310/alt_main.py
deleted file mode 100644
index 5de88ec3a..000000000
--- a/docs_src/sql_databases/sql_app_py310/alt_main.py
+++ /dev/null
@@ -1,60 +0,0 @@
-from fastapi import Depends, FastAPI, HTTPException, Request, Response
-from sqlalchemy.orm import Session
-
-from . import crud, models, schemas
-from .database import SessionLocal, engine
-
-models.Base.metadata.create_all(bind=engine)
-
-app = FastAPI()
-
-
-@app.middleware("http")
-async def db_session_middleware(request: Request, call_next):
- response = Response("Internal server error", status_code=500)
- try:
- request.state.db = SessionLocal()
- response = await call_next(request)
- finally:
- request.state.db.close()
- return response
-
-
-# Dependency
-def get_db(request: Request):
- return request.state.db
-
-
-@app.post("/users/", response_model=schemas.User)
-def create_user(user: schemas.UserCreate, db: Session = Depends(get_db)):
- db_user = crud.get_user_by_email(db, email=user.email)
- if db_user:
- raise HTTPException(status_code=400, detail="Email already registered")
- return crud.create_user(db=db, user=user)
-
-
-@app.get("/users/", response_model=list[schemas.User])
-def read_users(skip: int = 0, limit: int = 100, db: Session = Depends(get_db)):
- users = crud.get_users(db, skip=skip, limit=limit)
- return users
-
-
-@app.get("/users/{user_id}", response_model=schemas.User)
-def read_user(user_id: int, db: Session = Depends(get_db)):
- db_user = crud.get_user(db, user_id=user_id)
- if db_user is None:
- raise HTTPException(status_code=404, detail="User not found")
- return db_user
-
-
-@app.post("/users/{user_id}/items/", response_model=schemas.Item)
-def create_item_for_user(
- user_id: int, item: schemas.ItemCreate, db: Session = Depends(get_db)
-):
- return crud.create_user_item(db=db, item=item, user_id=user_id)
-
-
-@app.get("/items/", response_model=list[schemas.Item])
-def read_items(skip: int = 0, limit: int = 100, db: Session = Depends(get_db)):
- items = crud.get_items(db, skip=skip, limit=limit)
- return items
diff --git a/docs_src/sql_databases/sql_app_py310/crud.py b/docs_src/sql_databases/sql_app_py310/crud.py
deleted file mode 100644
index 679acdb5c..000000000
--- a/docs_src/sql_databases/sql_app_py310/crud.py
+++ /dev/null
@@ -1,36 +0,0 @@
-from sqlalchemy.orm import Session
-
-from . import models, schemas
-
-
-def get_user(db: Session, user_id: int):
- return db.query(models.User).filter(models.User.id == user_id).first()
-
-
-def get_user_by_email(db: Session, email: str):
- return db.query(models.User).filter(models.User.email == email).first()
-
-
-def get_users(db: Session, skip: int = 0, limit: int = 100):
- return db.query(models.User).offset(skip).limit(limit).all()
-
-
-def create_user(db: Session, user: schemas.UserCreate):
- fake_hashed_password = user.password + "notreallyhashed"
- db_user = models.User(email=user.email, hashed_password=fake_hashed_password)
- db.add(db_user)
- db.commit()
- db.refresh(db_user)
- return db_user
-
-
-def get_items(db: Session, skip: int = 0, limit: int = 100):
- return db.query(models.Item).offset(skip).limit(limit).all()
-
-
-def create_user_item(db: Session, item: schemas.ItemCreate, user_id: int):
- db_item = models.Item(**item.dict(), owner_id=user_id)
- db.add(db_item)
- db.commit()
- db.refresh(db_item)
- return db_item
diff --git a/docs_src/sql_databases/sql_app_py310/database.py b/docs_src/sql_databases/sql_app_py310/database.py
deleted file mode 100644
index 45a8b9f69..000000000
--- a/docs_src/sql_databases/sql_app_py310/database.py
+++ /dev/null
@@ -1,13 +0,0 @@
-from sqlalchemy import create_engine
-from sqlalchemy.ext.declarative import declarative_base
-from sqlalchemy.orm import sessionmaker
-
-SQLALCHEMY_DATABASE_URL = "sqlite:///./sql_app.db"
-# SQLALCHEMY_DATABASE_URL = "postgresql://user:password@postgresserver/db"
-
-engine = create_engine(
- SQLALCHEMY_DATABASE_URL, connect_args={"check_same_thread": False}
-)
-SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
-
-Base = declarative_base()
diff --git a/docs_src/sql_databases/sql_app_py310/main.py b/docs_src/sql_databases/sql_app_py310/main.py
deleted file mode 100644
index a9856d0b6..000000000
--- a/docs_src/sql_databases/sql_app_py310/main.py
+++ /dev/null
@@ -1,53 +0,0 @@
-from fastapi import Depends, FastAPI, HTTPException
-from sqlalchemy.orm import Session
-
-from . import crud, models, schemas
-from .database import SessionLocal, engine
-
-models.Base.metadata.create_all(bind=engine)
-
-app = FastAPI()
-
-
-# Dependency
-def get_db():
- db = SessionLocal()
- try:
- yield db
- finally:
- db.close()
-
-
-@app.post("/users/", response_model=schemas.User)
-def create_user(user: schemas.UserCreate, db: Session = Depends(get_db)):
- db_user = crud.get_user_by_email(db, email=user.email)
- if db_user:
- raise HTTPException(status_code=400, detail="Email already registered")
- return crud.create_user(db=db, user=user)
-
-
-@app.get("/users/", response_model=list[schemas.User])
-def read_users(skip: int = 0, limit: int = 100, db: Session = Depends(get_db)):
- users = crud.get_users(db, skip=skip, limit=limit)
- return users
-
-
-@app.get("/users/{user_id}", response_model=schemas.User)
-def read_user(user_id: int, db: Session = Depends(get_db)):
- db_user = crud.get_user(db, user_id=user_id)
- if db_user is None:
- raise HTTPException(status_code=404, detail="User not found")
- return db_user
-
-
-@app.post("/users/{user_id}/items/", response_model=schemas.Item)
-def create_item_for_user(
- user_id: int, item: schemas.ItemCreate, db: Session = Depends(get_db)
-):
- return crud.create_user_item(db=db, item=item, user_id=user_id)
-
-
-@app.get("/items/", response_model=list[schemas.Item])
-def read_items(skip: int = 0, limit: int = 100, db: Session = Depends(get_db)):
- items = crud.get_items(db, skip=skip, limit=limit)
- return items
diff --git a/docs_src/sql_databases/sql_app_py310/models.py b/docs_src/sql_databases/sql_app_py310/models.py
deleted file mode 100644
index 09ae2a807..000000000
--- a/docs_src/sql_databases/sql_app_py310/models.py
+++ /dev/null
@@ -1,26 +0,0 @@
-from sqlalchemy import Boolean, Column, ForeignKey, Integer, String
-from sqlalchemy.orm import relationship
-
-from .database import Base
-
-
-class User(Base):
- __tablename__ = "users"
-
- id = Column(Integer, primary_key=True)
- email = Column(String, unique=True, index=True)
- hashed_password = Column(String)
- is_active = Column(Boolean, default=True)
-
- items = relationship("Item", back_populates="owner")
-
-
-class Item(Base):
- __tablename__ = "items"
-
- id = Column(Integer, primary_key=True)
- title = Column(String, index=True)
- description = Column(String, index=True)
- owner_id = Column(Integer, ForeignKey("users.id"))
-
- owner = relationship("User", back_populates="items")
diff --git a/docs_src/sql_databases/sql_app_py310/schemas.py b/docs_src/sql_databases/sql_app_py310/schemas.py
deleted file mode 100644
index aea2e3f10..000000000
--- a/docs_src/sql_databases/sql_app_py310/schemas.py
+++ /dev/null
@@ -1,35 +0,0 @@
-from pydantic import BaseModel
-
-
-class ItemBase(BaseModel):
- title: str
- description: str | None = None
-
-
-class ItemCreate(ItemBase):
- pass
-
-
-class Item(ItemBase):
- id: int
- owner_id: int
-
- class Config:
- orm_mode = True
-
-
-class UserBase(BaseModel):
- email: str
-
-
-class UserCreate(UserBase):
- password: str
-
-
-class User(UserBase):
- id: int
- is_active: bool
- items: list[Item] = []
-
- class Config:
- orm_mode = True
diff --git a/docs_src/sql_databases/sql_app_py310/tests/__init__.py b/docs_src/sql_databases/sql_app_py310/tests/__init__.py
deleted file mode 100644
index e69de29bb..000000000
diff --git a/docs_src/sql_databases/sql_app_py310/tests/test_sql_app.py b/docs_src/sql_databases/sql_app_py310/tests/test_sql_app.py
deleted file mode 100644
index c60c3356f..000000000
--- a/docs_src/sql_databases/sql_app_py310/tests/test_sql_app.py
+++ /dev/null
@@ -1,47 +0,0 @@
-from fastapi.testclient import TestClient
-from sqlalchemy import create_engine
-from sqlalchemy.orm import sessionmaker
-
-from ..database import Base
-from ..main import app, get_db
-
-SQLALCHEMY_DATABASE_URL = "sqlite:///./test.db"
-
-engine = create_engine(
- SQLALCHEMY_DATABASE_URL, connect_args={"check_same_thread": False}
-)
-TestingSessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
-
-
-Base.metadata.create_all(bind=engine)
-
-
-def override_get_db():
- try:
- db = TestingSessionLocal()
- yield db
- finally:
- db.close()
-
-
-app.dependency_overrides[get_db] = override_get_db
-
-client = TestClient(app)
-
-
-def test_create_user():
- response = client.post(
- "/users/",
- json={"email": "deadpool@example.com", "password": "chimichangas4life"},
- )
- assert response.status_code == 200, response.text
- data = response.json()
- assert data["email"] == "deadpool@example.com"
- assert "id" in data
- user_id = data["id"]
-
- response = client.get(f"/users/{user_id}")
- assert response.status_code == 200, response.text
- data = response.json()
- assert data["email"] == "deadpool@example.com"
- assert data["id"] == user_id
diff --git a/docs_src/sql_databases/sql_app_py39/__init__.py b/docs_src/sql_databases/sql_app_py39/__init__.py
deleted file mode 100644
index e69de29bb..000000000
diff --git a/docs_src/sql_databases/sql_app_py39/alt_main.py b/docs_src/sql_databases/sql_app_py39/alt_main.py
deleted file mode 100644
index 5de88ec3a..000000000
--- a/docs_src/sql_databases/sql_app_py39/alt_main.py
+++ /dev/null
@@ -1,60 +0,0 @@
-from fastapi import Depends, FastAPI, HTTPException, Request, Response
-from sqlalchemy.orm import Session
-
-from . import crud, models, schemas
-from .database import SessionLocal, engine
-
-models.Base.metadata.create_all(bind=engine)
-
-app = FastAPI()
-
-
-@app.middleware("http")
-async def db_session_middleware(request: Request, call_next):
- response = Response("Internal server error", status_code=500)
- try:
- request.state.db = SessionLocal()
- response = await call_next(request)
- finally:
- request.state.db.close()
- return response
-
-
-# Dependency
-def get_db(request: Request):
- return request.state.db
-
-
-@app.post("/users/", response_model=schemas.User)
-def create_user(user: schemas.UserCreate, db: Session = Depends(get_db)):
- db_user = crud.get_user_by_email(db, email=user.email)
- if db_user:
- raise HTTPException(status_code=400, detail="Email already registered")
- return crud.create_user(db=db, user=user)
-
-
-@app.get("/users/", response_model=list[schemas.User])
-def read_users(skip: int = 0, limit: int = 100, db: Session = Depends(get_db)):
- users = crud.get_users(db, skip=skip, limit=limit)
- return users
-
-
-@app.get("/users/{user_id}", response_model=schemas.User)
-def read_user(user_id: int, db: Session = Depends(get_db)):
- db_user = crud.get_user(db, user_id=user_id)
- if db_user is None:
- raise HTTPException(status_code=404, detail="User not found")
- return db_user
-
-
-@app.post("/users/{user_id}/items/", response_model=schemas.Item)
-def create_item_for_user(
- user_id: int, item: schemas.ItemCreate, db: Session = Depends(get_db)
-):
- return crud.create_user_item(db=db, item=item, user_id=user_id)
-
-
-@app.get("/items/", response_model=list[schemas.Item])
-def read_items(skip: int = 0, limit: int = 100, db: Session = Depends(get_db)):
- items = crud.get_items(db, skip=skip, limit=limit)
- return items
diff --git a/docs_src/sql_databases/sql_app_py39/crud.py b/docs_src/sql_databases/sql_app_py39/crud.py
deleted file mode 100644
index 679acdb5c..000000000
--- a/docs_src/sql_databases/sql_app_py39/crud.py
+++ /dev/null
@@ -1,36 +0,0 @@
-from sqlalchemy.orm import Session
-
-from . import models, schemas
-
-
-def get_user(db: Session, user_id: int):
- return db.query(models.User).filter(models.User.id == user_id).first()
-
-
-def get_user_by_email(db: Session, email: str):
- return db.query(models.User).filter(models.User.email == email).first()
-
-
-def get_users(db: Session, skip: int = 0, limit: int = 100):
- return db.query(models.User).offset(skip).limit(limit).all()
-
-
-def create_user(db: Session, user: schemas.UserCreate):
- fake_hashed_password = user.password + "notreallyhashed"
- db_user = models.User(email=user.email, hashed_password=fake_hashed_password)
- db.add(db_user)
- db.commit()
- db.refresh(db_user)
- return db_user
-
-
-def get_items(db: Session, skip: int = 0, limit: int = 100):
- return db.query(models.Item).offset(skip).limit(limit).all()
-
-
-def create_user_item(db: Session, item: schemas.ItemCreate, user_id: int):
- db_item = models.Item(**item.dict(), owner_id=user_id)
- db.add(db_item)
- db.commit()
- db.refresh(db_item)
- return db_item
diff --git a/docs_src/sql_databases/sql_app_py39/database.py b/docs_src/sql_databases/sql_app_py39/database.py
deleted file mode 100644
index 45a8b9f69..000000000
--- a/docs_src/sql_databases/sql_app_py39/database.py
+++ /dev/null
@@ -1,13 +0,0 @@
-from sqlalchemy import create_engine
-from sqlalchemy.ext.declarative import declarative_base
-from sqlalchemy.orm import sessionmaker
-
-SQLALCHEMY_DATABASE_URL = "sqlite:///./sql_app.db"
-# SQLALCHEMY_DATABASE_URL = "postgresql://user:password@postgresserver/db"
-
-engine = create_engine(
- SQLALCHEMY_DATABASE_URL, connect_args={"check_same_thread": False}
-)
-SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
-
-Base = declarative_base()
diff --git a/docs_src/sql_databases/sql_app_py39/main.py b/docs_src/sql_databases/sql_app_py39/main.py
deleted file mode 100644
index a9856d0b6..000000000
--- a/docs_src/sql_databases/sql_app_py39/main.py
+++ /dev/null
@@ -1,53 +0,0 @@
-from fastapi import Depends, FastAPI, HTTPException
-from sqlalchemy.orm import Session
-
-from . import crud, models, schemas
-from .database import SessionLocal, engine
-
-models.Base.metadata.create_all(bind=engine)
-
-app = FastAPI()
-
-
-# Dependency
-def get_db():
- db = SessionLocal()
- try:
- yield db
- finally:
- db.close()
-
-
-@app.post("/users/", response_model=schemas.User)
-def create_user(user: schemas.UserCreate, db: Session = Depends(get_db)):
- db_user = crud.get_user_by_email(db, email=user.email)
- if db_user:
- raise HTTPException(status_code=400, detail="Email already registered")
- return crud.create_user(db=db, user=user)
-
-
-@app.get("/users/", response_model=list[schemas.User])
-def read_users(skip: int = 0, limit: int = 100, db: Session = Depends(get_db)):
- users = crud.get_users(db, skip=skip, limit=limit)
- return users
-
-
-@app.get("/users/{user_id}", response_model=schemas.User)
-def read_user(user_id: int, db: Session = Depends(get_db)):
- db_user = crud.get_user(db, user_id=user_id)
- if db_user is None:
- raise HTTPException(status_code=404, detail="User not found")
- return db_user
-
-
-@app.post("/users/{user_id}/items/", response_model=schemas.Item)
-def create_item_for_user(
- user_id: int, item: schemas.ItemCreate, db: Session = Depends(get_db)
-):
- return crud.create_user_item(db=db, item=item, user_id=user_id)
-
-
-@app.get("/items/", response_model=list[schemas.Item])
-def read_items(skip: int = 0, limit: int = 100, db: Session = Depends(get_db)):
- items = crud.get_items(db, skip=skip, limit=limit)
- return items
diff --git a/docs_src/sql_databases/sql_app_py39/models.py b/docs_src/sql_databases/sql_app_py39/models.py
deleted file mode 100644
index 09ae2a807..000000000
--- a/docs_src/sql_databases/sql_app_py39/models.py
+++ /dev/null
@@ -1,26 +0,0 @@
-from sqlalchemy import Boolean, Column, ForeignKey, Integer, String
-from sqlalchemy.orm import relationship
-
-from .database import Base
-
-
-class User(Base):
- __tablename__ = "users"
-
- id = Column(Integer, primary_key=True)
- email = Column(String, unique=True, index=True)
- hashed_password = Column(String)
- is_active = Column(Boolean, default=True)
-
- items = relationship("Item", back_populates="owner")
-
-
-class Item(Base):
- __tablename__ = "items"
-
- id = Column(Integer, primary_key=True)
- title = Column(String, index=True)
- description = Column(String, index=True)
- owner_id = Column(Integer, ForeignKey("users.id"))
-
- owner = relationship("User", back_populates="items")
diff --git a/docs_src/sql_databases/sql_app_py39/schemas.py b/docs_src/sql_databases/sql_app_py39/schemas.py
deleted file mode 100644
index dadc403d9..000000000
--- a/docs_src/sql_databases/sql_app_py39/schemas.py
+++ /dev/null
@@ -1,37 +0,0 @@
-from typing import Union
-
-from pydantic import BaseModel
-
-
-class ItemBase(BaseModel):
- title: str
- description: Union[str, None] = None
-
-
-class ItemCreate(ItemBase):
- pass
-
-
-class Item(ItemBase):
- id: int
- owner_id: int
-
- class Config:
- orm_mode = True
-
-
-class UserBase(BaseModel):
- email: str
-
-
-class UserCreate(UserBase):
- password: str
-
-
-class User(UserBase):
- id: int
- is_active: bool
- items: list[Item] = []
-
- class Config:
- orm_mode = True
diff --git a/docs_src/sql_databases/sql_app_py39/tests/__init__.py b/docs_src/sql_databases/sql_app_py39/tests/__init__.py
deleted file mode 100644
index e69de29bb..000000000
diff --git a/docs_src/sql_databases/sql_app_py39/tests/test_sql_app.py b/docs_src/sql_databases/sql_app_py39/tests/test_sql_app.py
deleted file mode 100644
index c60c3356f..000000000
--- a/docs_src/sql_databases/sql_app_py39/tests/test_sql_app.py
+++ /dev/null
@@ -1,47 +0,0 @@
-from fastapi.testclient import TestClient
-from sqlalchemy import create_engine
-from sqlalchemy.orm import sessionmaker
-
-from ..database import Base
-from ..main import app, get_db
-
-SQLALCHEMY_DATABASE_URL = "sqlite:///./test.db"
-
-engine = create_engine(
- SQLALCHEMY_DATABASE_URL, connect_args={"check_same_thread": False}
-)
-TestingSessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
-
-
-Base.metadata.create_all(bind=engine)
-
-
-def override_get_db():
- try:
- db = TestingSessionLocal()
- yield db
- finally:
- db.close()
-
-
-app.dependency_overrides[get_db] = override_get_db
-
-client = TestClient(app)
-
-
-def test_create_user():
- response = client.post(
- "/users/",
- json={"email": "deadpool@example.com", "password": "chimichangas4life"},
- )
- assert response.status_code == 200, response.text
- data = response.json()
- assert data["email"] == "deadpool@example.com"
- assert "id" in data
- user_id = data["id"]
-
- response = client.get(f"/users/{user_id}")
- assert response.status_code == 200, response.text
- data = response.json()
- assert data["email"] == "deadpool@example.com"
- assert data["id"] == user_id
diff --git a/docs_src/sql_databases/tutorial001.py b/docs_src/sql_databases/tutorial001.py
new file mode 100644
index 000000000..be86ec0ee
--- /dev/null
+++ b/docs_src/sql_databases/tutorial001.py
@@ -0,0 +1,71 @@
+from typing import List, Union
+
+from fastapi import Depends, FastAPI, HTTPException, Query
+from sqlmodel import Field, Session, SQLModel, create_engine, select
+
+
+class Hero(SQLModel, table=True):
+ id: Union[int, None] = Field(default=None, primary_key=True)
+ name: str = Field(index=True)
+ age: Union[int, None] = Field(default=None, index=True)
+ secret_name: str
+
+
+sqlite_file_name = "database.db"
+sqlite_url = f"sqlite:///{sqlite_file_name}"
+
+connect_args = {"check_same_thread": False}
+engine = create_engine(sqlite_url, connect_args=connect_args)
+
+
+def create_db_and_tables():
+ SQLModel.metadata.create_all(engine)
+
+
+def get_session():
+ with Session(engine) as session:
+ yield session
+
+
+app = FastAPI()
+
+
+@app.on_event("startup")
+def on_startup():
+ create_db_and_tables()
+
+
+@app.post("/heroes/")
+def create_hero(hero: Hero, session: Session = Depends(get_session)) -> Hero:
+ session.add(hero)
+ session.commit()
+ session.refresh(hero)
+ return hero
+
+
+@app.get("/heroes/")
+def read_heroes(
+ session: Session = Depends(get_session),
+ offset: int = 0,
+ limit: int = Query(default=100, le=100),
+) -> List[Hero]:
+ heroes = session.exec(select(Hero).offset(offset).limit(limit)).all()
+ return heroes
+
+
+@app.get("/heroes/{hero_id}")
+def read_hero(hero_id: int, session: Session = Depends(get_session)) -> Hero:
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ return hero
+
+
+@app.delete("/heroes/{hero_id}")
+def delete_hero(hero_id: int, session: Session = Depends(get_session)):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ session.delete(hero)
+ session.commit()
+ return {"ok": True}
diff --git a/docs_src/sql_databases/tutorial001_an.py b/docs_src/sql_databases/tutorial001_an.py
new file mode 100644
index 000000000..8c000d31c
--- /dev/null
+++ b/docs_src/sql_databases/tutorial001_an.py
@@ -0,0 +1,74 @@
+from typing import List, Union
+
+from fastapi import Depends, FastAPI, HTTPException, Query
+from sqlmodel import Field, Session, SQLModel, create_engine, select
+from typing_extensions import Annotated
+
+
+class Hero(SQLModel, table=True):
+ id: Union[int, None] = Field(default=None, primary_key=True)
+ name: str = Field(index=True)
+ age: Union[int, None] = Field(default=None, index=True)
+ secret_name: str
+
+
+sqlite_file_name = "database.db"
+sqlite_url = f"sqlite:///{sqlite_file_name}"
+
+connect_args = {"check_same_thread": False}
+engine = create_engine(sqlite_url, connect_args=connect_args)
+
+
+def create_db_and_tables():
+ SQLModel.metadata.create_all(engine)
+
+
+def get_session():
+ with Session(engine) as session:
+ yield session
+
+
+SessionDep = Annotated[Session, Depends(get_session)]
+
+app = FastAPI()
+
+
+@app.on_event("startup")
+def on_startup():
+ create_db_and_tables()
+
+
+@app.post("/heroes/")
+def create_hero(hero: Hero, session: SessionDep) -> Hero:
+ session.add(hero)
+ session.commit()
+ session.refresh(hero)
+ return hero
+
+
+@app.get("/heroes/")
+def read_heroes(
+ session: SessionDep,
+ offset: int = 0,
+ limit: Annotated[int, Query(le=100)] = 100,
+) -> List[Hero]:
+ heroes = session.exec(select(Hero).offset(offset).limit(limit)).all()
+ return heroes
+
+
+@app.get("/heroes/{hero_id}")
+def read_hero(hero_id: int, session: SessionDep) -> Hero:
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ return hero
+
+
+@app.delete("/heroes/{hero_id}")
+def delete_hero(hero_id: int, session: SessionDep):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ session.delete(hero)
+ session.commit()
+ return {"ok": True}
diff --git a/docs_src/sql_databases/tutorial001_an_py310.py b/docs_src/sql_databases/tutorial001_an_py310.py
new file mode 100644
index 000000000..de1fb81fa
--- /dev/null
+++ b/docs_src/sql_databases/tutorial001_an_py310.py
@@ -0,0 +1,73 @@
+from typing import Annotated
+
+from fastapi import Depends, FastAPI, HTTPException, Query
+from sqlmodel import Field, Session, SQLModel, create_engine, select
+
+
+class Hero(SQLModel, table=True):
+ id: int | None = Field(default=None, primary_key=True)
+ name: str = Field(index=True)
+ age: int | None = Field(default=None, index=True)
+ secret_name: str
+
+
+sqlite_file_name = "database.db"
+sqlite_url = f"sqlite:///{sqlite_file_name}"
+
+connect_args = {"check_same_thread": False}
+engine = create_engine(sqlite_url, connect_args=connect_args)
+
+
+def create_db_and_tables():
+ SQLModel.metadata.create_all(engine)
+
+
+def get_session():
+ with Session(engine) as session:
+ yield session
+
+
+SessionDep = Annotated[Session, Depends(get_session)]
+
+app = FastAPI()
+
+
+@app.on_event("startup")
+def on_startup():
+ create_db_and_tables()
+
+
+@app.post("/heroes/")
+def create_hero(hero: Hero, session: SessionDep) -> Hero:
+ session.add(hero)
+ session.commit()
+ session.refresh(hero)
+ return hero
+
+
+@app.get("/heroes/")
+def read_heroes(
+ session: SessionDep,
+ offset: int = 0,
+ limit: Annotated[int, Query(le=100)] = 100,
+) -> list[Hero]:
+ heroes = session.exec(select(Hero).offset(offset).limit(limit)).all()
+ return heroes
+
+
+@app.get("/heroes/{hero_id}")
+def read_hero(hero_id: int, session: SessionDep) -> Hero:
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ return hero
+
+
+@app.delete("/heroes/{hero_id}")
+def delete_hero(hero_id: int, session: SessionDep):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ session.delete(hero)
+ session.commit()
+ return {"ok": True}
diff --git a/docs_src/sql_databases/tutorial001_an_py39.py b/docs_src/sql_databases/tutorial001_an_py39.py
new file mode 100644
index 000000000..595892746
--- /dev/null
+++ b/docs_src/sql_databases/tutorial001_an_py39.py
@@ -0,0 +1,73 @@
+from typing import Annotated, Union
+
+from fastapi import Depends, FastAPI, HTTPException, Query
+from sqlmodel import Field, Session, SQLModel, create_engine, select
+
+
+class Hero(SQLModel, table=True):
+ id: Union[int, None] = Field(default=None, primary_key=True)
+ name: str = Field(index=True)
+ age: Union[int, None] = Field(default=None, index=True)
+ secret_name: str
+
+
+sqlite_file_name = "database.db"
+sqlite_url = f"sqlite:///{sqlite_file_name}"
+
+connect_args = {"check_same_thread": False}
+engine = create_engine(sqlite_url, connect_args=connect_args)
+
+
+def create_db_and_tables():
+ SQLModel.metadata.create_all(engine)
+
+
+def get_session():
+ with Session(engine) as session:
+ yield session
+
+
+SessionDep = Annotated[Session, Depends(get_session)]
+
+app = FastAPI()
+
+
+@app.on_event("startup")
+def on_startup():
+ create_db_and_tables()
+
+
+@app.post("/heroes/")
+def create_hero(hero: Hero, session: SessionDep) -> Hero:
+ session.add(hero)
+ session.commit()
+ session.refresh(hero)
+ return hero
+
+
+@app.get("/heroes/")
+def read_heroes(
+ session: SessionDep,
+ offset: int = 0,
+ limit: Annotated[int, Query(le=100)] = 100,
+) -> list[Hero]:
+ heroes = session.exec(select(Hero).offset(offset).limit(limit)).all()
+ return heroes
+
+
+@app.get("/heroes/{hero_id}")
+def read_hero(hero_id: int, session: SessionDep) -> Hero:
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ return hero
+
+
+@app.delete("/heroes/{hero_id}")
+def delete_hero(hero_id: int, session: SessionDep):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ session.delete(hero)
+ session.commit()
+ return {"ok": True}
diff --git a/docs_src/sql_databases/tutorial001_py310.py b/docs_src/sql_databases/tutorial001_py310.py
new file mode 100644
index 000000000..b58462e6a
--- /dev/null
+++ b/docs_src/sql_databases/tutorial001_py310.py
@@ -0,0 +1,69 @@
+from fastapi import Depends, FastAPI, HTTPException, Query
+from sqlmodel import Field, Session, SQLModel, create_engine, select
+
+
+class Hero(SQLModel, table=True):
+ id: int | None = Field(default=None, primary_key=True)
+ name: str = Field(index=True)
+ age: int | None = Field(default=None, index=True)
+ secret_name: str
+
+
+sqlite_file_name = "database.db"
+sqlite_url = f"sqlite:///{sqlite_file_name}"
+
+connect_args = {"check_same_thread": False}
+engine = create_engine(sqlite_url, connect_args=connect_args)
+
+
+def create_db_and_tables():
+ SQLModel.metadata.create_all(engine)
+
+
+def get_session():
+ with Session(engine) as session:
+ yield session
+
+
+app = FastAPI()
+
+
+@app.on_event("startup")
+def on_startup():
+ create_db_and_tables()
+
+
+@app.post("/heroes/")
+def create_hero(hero: Hero, session: Session = Depends(get_session)) -> Hero:
+ session.add(hero)
+ session.commit()
+ session.refresh(hero)
+ return hero
+
+
+@app.get("/heroes/")
+def read_heroes(
+ session: Session = Depends(get_session),
+ offset: int = 0,
+ limit: int = Query(default=100, le=100),
+) -> list[Hero]:
+ heroes = session.exec(select(Hero).offset(offset).limit(limit)).all()
+ return heroes
+
+
+@app.get("/heroes/{hero_id}")
+def read_hero(hero_id: int, session: Session = Depends(get_session)) -> Hero:
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ return hero
+
+
+@app.delete("/heroes/{hero_id}")
+def delete_hero(hero_id: int, session: Session = Depends(get_session)):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ session.delete(hero)
+ session.commit()
+ return {"ok": True}
diff --git a/docs_src/sql_databases/tutorial001_py39.py b/docs_src/sql_databases/tutorial001_py39.py
new file mode 100644
index 000000000..410a52d0c
--- /dev/null
+++ b/docs_src/sql_databases/tutorial001_py39.py
@@ -0,0 +1,71 @@
+from typing import Union
+
+from fastapi import Depends, FastAPI, HTTPException, Query
+from sqlmodel import Field, Session, SQLModel, create_engine, select
+
+
+class Hero(SQLModel, table=True):
+ id: Union[int, None] = Field(default=None, primary_key=True)
+ name: str = Field(index=True)
+ age: Union[int, None] = Field(default=None, index=True)
+ secret_name: str
+
+
+sqlite_file_name = "database.db"
+sqlite_url = f"sqlite:///{sqlite_file_name}"
+
+connect_args = {"check_same_thread": False}
+engine = create_engine(sqlite_url, connect_args=connect_args)
+
+
+def create_db_and_tables():
+ SQLModel.metadata.create_all(engine)
+
+
+def get_session():
+ with Session(engine) as session:
+ yield session
+
+
+app = FastAPI()
+
+
+@app.on_event("startup")
+def on_startup():
+ create_db_and_tables()
+
+
+@app.post("/heroes/")
+def create_hero(hero: Hero, session: Session = Depends(get_session)) -> Hero:
+ session.add(hero)
+ session.commit()
+ session.refresh(hero)
+ return hero
+
+
+@app.get("/heroes/")
+def read_heroes(
+ session: Session = Depends(get_session),
+ offset: int = 0,
+ limit: int = Query(default=100, le=100),
+) -> list[Hero]:
+ heroes = session.exec(select(Hero).offset(offset).limit(limit)).all()
+ return heroes
+
+
+@app.get("/heroes/{hero_id}")
+def read_hero(hero_id: int, session: Session = Depends(get_session)) -> Hero:
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ return hero
+
+
+@app.delete("/heroes/{hero_id}")
+def delete_hero(hero_id: int, session: Session = Depends(get_session)):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ session.delete(hero)
+ session.commit()
+ return {"ok": True}
diff --git a/docs_src/sql_databases/tutorial002.py b/docs_src/sql_databases/tutorial002.py
new file mode 100644
index 000000000..4350d19c6
--- /dev/null
+++ b/docs_src/sql_databases/tutorial002.py
@@ -0,0 +1,104 @@
+from typing import List, Union
+
+from fastapi import Depends, FastAPI, HTTPException, Query
+from sqlmodel import Field, Session, SQLModel, create_engine, select
+
+
+class HeroBase(SQLModel):
+ name: str = Field(index=True)
+ age: Union[int, None] = Field(default=None, index=True)
+
+
+class Hero(HeroBase, table=True):
+ id: Union[int, None] = Field(default=None, primary_key=True)
+ secret_name: str
+
+
+class HeroPublic(HeroBase):
+ id: int
+
+
+class HeroCreate(HeroBase):
+ secret_name: str
+
+
+class HeroUpdate(HeroBase):
+ name: Union[str, None] = None
+ age: Union[int, None] = None
+ secret_name: Union[str, None] = None
+
+
+sqlite_file_name = "database.db"
+sqlite_url = f"sqlite:///{sqlite_file_name}"
+
+connect_args = {"check_same_thread": False}
+engine = create_engine(sqlite_url, connect_args=connect_args)
+
+
+def create_db_and_tables():
+ SQLModel.metadata.create_all(engine)
+
+
+def get_session():
+ with Session(engine) as session:
+ yield session
+
+
+app = FastAPI()
+
+
+@app.on_event("startup")
+def on_startup():
+ create_db_and_tables()
+
+
+@app.post("/heroes/", response_model=HeroPublic)
+def create_hero(hero: HeroCreate, session: Session = Depends(get_session)):
+ db_hero = Hero.model_validate(hero)
+ session.add(db_hero)
+ session.commit()
+ session.refresh(db_hero)
+ return db_hero
+
+
+@app.get("/heroes/", response_model=List[HeroPublic])
+def read_heroes(
+ session: Session = Depends(get_session),
+ offset: int = 0,
+ limit: int = Query(default=100, le=100),
+):
+ heroes = session.exec(select(Hero).offset(offset).limit(limit)).all()
+ return heroes
+
+
+@app.get("/heroes/{hero_id}", response_model=HeroPublic)
+def read_hero(hero_id: int, session: Session = Depends(get_session)):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ return hero
+
+
+@app.patch("/heroes/{hero_id}", response_model=HeroPublic)
+def update_hero(
+ hero_id: int, hero: HeroUpdate, session: Session = Depends(get_session)
+):
+ hero_db = session.get(Hero, hero_id)
+ if not hero_db:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ hero_data = hero.model_dump(exclude_unset=True)
+ hero_db.sqlmodel_update(hero_data)
+ session.add(hero_db)
+ session.commit()
+ session.refresh(hero_db)
+ return hero_db
+
+
+@app.delete("/heroes/{hero_id}")
+def delete_hero(hero_id: int, session: Session = Depends(get_session)):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ session.delete(hero)
+ session.commit()
+ return {"ok": True}
diff --git a/docs_src/sql_databases/tutorial002_an.py b/docs_src/sql_databases/tutorial002_an.py
new file mode 100644
index 000000000..15e3d7c3a
--- /dev/null
+++ b/docs_src/sql_databases/tutorial002_an.py
@@ -0,0 +1,104 @@
+from typing import List, Union
+
+from fastapi import Depends, FastAPI, HTTPException, Query
+from sqlmodel import Field, Session, SQLModel, create_engine, select
+from typing_extensions import Annotated
+
+
+class HeroBase(SQLModel):
+ name: str = Field(index=True)
+ age: Union[int, None] = Field(default=None, index=True)
+
+
+class Hero(HeroBase, table=True):
+ id: Union[int, None] = Field(default=None, primary_key=True)
+ secret_name: str
+
+
+class HeroPublic(HeroBase):
+ id: int
+
+
+class HeroCreate(HeroBase):
+ secret_name: str
+
+
+class HeroUpdate(HeroBase):
+ name: Union[str, None] = None
+ age: Union[int, None] = None
+ secret_name: Union[str, None] = None
+
+
+sqlite_file_name = "database.db"
+sqlite_url = f"sqlite:///{sqlite_file_name}"
+
+connect_args = {"check_same_thread": False}
+engine = create_engine(sqlite_url, connect_args=connect_args)
+
+
+def create_db_and_tables():
+ SQLModel.metadata.create_all(engine)
+
+
+def get_session():
+ with Session(engine) as session:
+ yield session
+
+
+SessionDep = Annotated[Session, Depends(get_session)]
+app = FastAPI()
+
+
+@app.on_event("startup")
+def on_startup():
+ create_db_and_tables()
+
+
+@app.post("/heroes/", response_model=HeroPublic)
+def create_hero(hero: HeroCreate, session: SessionDep):
+ db_hero = Hero.model_validate(hero)
+ session.add(db_hero)
+ session.commit()
+ session.refresh(db_hero)
+ return db_hero
+
+
+@app.get("/heroes/", response_model=List[HeroPublic])
+def read_heroes(
+ session: SessionDep,
+ offset: int = 0,
+ limit: Annotated[int, Query(le=100)] = 100,
+):
+ heroes = session.exec(select(Hero).offset(offset).limit(limit)).all()
+ return heroes
+
+
+@app.get("/heroes/{hero_id}", response_model=HeroPublic)
+def read_hero(hero_id: int, session: SessionDep):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ return hero
+
+
+@app.patch("/heroes/{hero_id}", response_model=HeroPublic)
+def update_hero(hero_id: int, hero: HeroUpdate, session: SessionDep):
+ hero_db = session.get(Hero, hero_id)
+ if not hero_db:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ hero_data = hero.model_dump(exclude_unset=True)
+ hero_db.sqlmodel_update(hero_data)
+ session.add(hero_db)
+ session.commit()
+ session.refresh(hero_db)
+ return hero_db
+
+
+@app.delete("/heroes/{hero_id}")
+def delete_hero(hero_id: int, session: SessionDep):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ session.delete(hero)
+ session.commit()
+ return {"ok": True}
diff --git a/docs_src/sql_databases/tutorial002_an_py310.py b/docs_src/sql_databases/tutorial002_an_py310.py
new file mode 100644
index 000000000..64c554b8a
--- /dev/null
+++ b/docs_src/sql_databases/tutorial002_an_py310.py
@@ -0,0 +1,103 @@
+from typing import Annotated
+
+from fastapi import Depends, FastAPI, HTTPException, Query
+from sqlmodel import Field, Session, SQLModel, create_engine, select
+
+
+class HeroBase(SQLModel):
+ name: str = Field(index=True)
+ age: int | None = Field(default=None, index=True)
+
+
+class Hero(HeroBase, table=True):
+ id: int | None = Field(default=None, primary_key=True)
+ secret_name: str
+
+
+class HeroPublic(HeroBase):
+ id: int
+
+
+class HeroCreate(HeroBase):
+ secret_name: str
+
+
+class HeroUpdate(HeroBase):
+ name: str | None = None
+ age: int | None = None
+ secret_name: str | None = None
+
+
+sqlite_file_name = "database.db"
+sqlite_url = f"sqlite:///{sqlite_file_name}"
+
+connect_args = {"check_same_thread": False}
+engine = create_engine(sqlite_url, connect_args=connect_args)
+
+
+def create_db_and_tables():
+ SQLModel.metadata.create_all(engine)
+
+
+def get_session():
+ with Session(engine) as session:
+ yield session
+
+
+SessionDep = Annotated[Session, Depends(get_session)]
+app = FastAPI()
+
+
+@app.on_event("startup")
+def on_startup():
+ create_db_and_tables()
+
+
+@app.post("/heroes/", response_model=HeroPublic)
+def create_hero(hero: HeroCreate, session: SessionDep):
+ db_hero = Hero.model_validate(hero)
+ session.add(db_hero)
+ session.commit()
+ session.refresh(db_hero)
+ return db_hero
+
+
+@app.get("/heroes/", response_model=list[HeroPublic])
+def read_heroes(
+ session: SessionDep,
+ offset: int = 0,
+ limit: Annotated[int, Query(le=100)] = 100,
+):
+ heroes = session.exec(select(Hero).offset(offset).limit(limit)).all()
+ return heroes
+
+
+@app.get("/heroes/{hero_id}", response_model=HeroPublic)
+def read_hero(hero_id: int, session: SessionDep):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ return hero
+
+
+@app.patch("/heroes/{hero_id}", response_model=HeroPublic)
+def update_hero(hero_id: int, hero: HeroUpdate, session: SessionDep):
+ hero_db = session.get(Hero, hero_id)
+ if not hero_db:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ hero_data = hero.model_dump(exclude_unset=True)
+ hero_db.sqlmodel_update(hero_data)
+ session.add(hero_db)
+ session.commit()
+ session.refresh(hero_db)
+ return hero_db
+
+
+@app.delete("/heroes/{hero_id}")
+def delete_hero(hero_id: int, session: SessionDep):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ session.delete(hero)
+ session.commit()
+ return {"ok": True}
diff --git a/docs_src/sql_databases/tutorial002_an_py39.py b/docs_src/sql_databases/tutorial002_an_py39.py
new file mode 100644
index 000000000..a8a0721ff
--- /dev/null
+++ b/docs_src/sql_databases/tutorial002_an_py39.py
@@ -0,0 +1,103 @@
+from typing import Annotated, Union
+
+from fastapi import Depends, FastAPI, HTTPException, Query
+from sqlmodel import Field, Session, SQLModel, create_engine, select
+
+
+class HeroBase(SQLModel):
+ name: str = Field(index=True)
+ age: Union[int, None] = Field(default=None, index=True)
+
+
+class Hero(HeroBase, table=True):
+ id: Union[int, None] = Field(default=None, primary_key=True)
+ secret_name: str
+
+
+class HeroPublic(HeroBase):
+ id: int
+
+
+class HeroCreate(HeroBase):
+ secret_name: str
+
+
+class HeroUpdate(HeroBase):
+ name: Union[str, None] = None
+ age: Union[int, None] = None
+ secret_name: Union[str, None] = None
+
+
+sqlite_file_name = "database.db"
+sqlite_url = f"sqlite:///{sqlite_file_name}"
+
+connect_args = {"check_same_thread": False}
+engine = create_engine(sqlite_url, connect_args=connect_args)
+
+
+def create_db_and_tables():
+ SQLModel.metadata.create_all(engine)
+
+
+def get_session():
+ with Session(engine) as session:
+ yield session
+
+
+SessionDep = Annotated[Session, Depends(get_session)]
+app = FastAPI()
+
+
+@app.on_event("startup")
+def on_startup():
+ create_db_and_tables()
+
+
+@app.post("/heroes/", response_model=HeroPublic)
+def create_hero(hero: HeroCreate, session: SessionDep):
+ db_hero = Hero.model_validate(hero)
+ session.add(db_hero)
+ session.commit()
+ session.refresh(db_hero)
+ return db_hero
+
+
+@app.get("/heroes/", response_model=list[HeroPublic])
+def read_heroes(
+ session: SessionDep,
+ offset: int = 0,
+ limit: Annotated[int, Query(le=100)] = 100,
+):
+ heroes = session.exec(select(Hero).offset(offset).limit(limit)).all()
+ return heroes
+
+
+@app.get("/heroes/{hero_id}", response_model=HeroPublic)
+def read_hero(hero_id: int, session: SessionDep):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ return hero
+
+
+@app.patch("/heroes/{hero_id}", response_model=HeroPublic)
+def update_hero(hero_id: int, hero: HeroUpdate, session: SessionDep):
+ hero_db = session.get(Hero, hero_id)
+ if not hero_db:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ hero_data = hero.model_dump(exclude_unset=True)
+ hero_db.sqlmodel_update(hero_data)
+ session.add(hero_db)
+ session.commit()
+ session.refresh(hero_db)
+ return hero_db
+
+
+@app.delete("/heroes/{hero_id}")
+def delete_hero(hero_id: int, session: SessionDep):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ session.delete(hero)
+ session.commit()
+ return {"ok": True}
diff --git a/docs_src/sql_databases/tutorial002_py310.py b/docs_src/sql_databases/tutorial002_py310.py
new file mode 100644
index 000000000..ec3d68db5
--- /dev/null
+++ b/docs_src/sql_databases/tutorial002_py310.py
@@ -0,0 +1,102 @@
+from fastapi import Depends, FastAPI, HTTPException, Query
+from sqlmodel import Field, Session, SQLModel, create_engine, select
+
+
+class HeroBase(SQLModel):
+ name: str = Field(index=True)
+ age: int | None = Field(default=None, index=True)
+
+
+class Hero(HeroBase, table=True):
+ id: int | None = Field(default=None, primary_key=True)
+ secret_name: str
+
+
+class HeroPublic(HeroBase):
+ id: int
+
+
+class HeroCreate(HeroBase):
+ secret_name: str
+
+
+class HeroUpdate(HeroBase):
+ name: str | None = None
+ age: int | None = None
+ secret_name: str | None = None
+
+
+sqlite_file_name = "database.db"
+sqlite_url = f"sqlite:///{sqlite_file_name}"
+
+connect_args = {"check_same_thread": False}
+engine = create_engine(sqlite_url, connect_args=connect_args)
+
+
+def create_db_and_tables():
+ SQLModel.metadata.create_all(engine)
+
+
+def get_session():
+ with Session(engine) as session:
+ yield session
+
+
+app = FastAPI()
+
+
+@app.on_event("startup")
+def on_startup():
+ create_db_and_tables()
+
+
+@app.post("/heroes/", response_model=HeroPublic)
+def create_hero(hero: HeroCreate, session: Session = Depends(get_session)):
+ db_hero = Hero.model_validate(hero)
+ session.add(db_hero)
+ session.commit()
+ session.refresh(db_hero)
+ return db_hero
+
+
+@app.get("/heroes/", response_model=list[HeroPublic])
+def read_heroes(
+ session: Session = Depends(get_session),
+ offset: int = 0,
+ limit: int = Query(default=100, le=100),
+):
+ heroes = session.exec(select(Hero).offset(offset).limit(limit)).all()
+ return heroes
+
+
+@app.get("/heroes/{hero_id}", response_model=HeroPublic)
+def read_hero(hero_id: int, session: Session = Depends(get_session)):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ return hero
+
+
+@app.patch("/heroes/{hero_id}", response_model=HeroPublic)
+def update_hero(
+ hero_id: int, hero: HeroUpdate, session: Session = Depends(get_session)
+):
+ hero_db = session.get(Hero, hero_id)
+ if not hero_db:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ hero_data = hero.model_dump(exclude_unset=True)
+ hero_db.sqlmodel_update(hero_data)
+ session.add(hero_db)
+ session.commit()
+ session.refresh(hero_db)
+ return hero_db
+
+
+@app.delete("/heroes/{hero_id}")
+def delete_hero(hero_id: int, session: Session = Depends(get_session)):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ session.delete(hero)
+ session.commit()
+ return {"ok": True}
diff --git a/docs_src/sql_databases/tutorial002_py39.py b/docs_src/sql_databases/tutorial002_py39.py
new file mode 100644
index 000000000..d8f5dd090
--- /dev/null
+++ b/docs_src/sql_databases/tutorial002_py39.py
@@ -0,0 +1,104 @@
+from typing import Union
+
+from fastapi import Depends, FastAPI, HTTPException, Query
+from sqlmodel import Field, Session, SQLModel, create_engine, select
+
+
+class HeroBase(SQLModel):
+ name: str = Field(index=True)
+ age: Union[int, None] = Field(default=None, index=True)
+
+
+class Hero(HeroBase, table=True):
+ id: Union[int, None] = Field(default=None, primary_key=True)
+ secret_name: str
+
+
+class HeroPublic(HeroBase):
+ id: int
+
+
+class HeroCreate(HeroBase):
+ secret_name: str
+
+
+class HeroUpdate(HeroBase):
+ name: Union[str, None] = None
+ age: Union[int, None] = None
+ secret_name: Union[str, None] = None
+
+
+sqlite_file_name = "database.db"
+sqlite_url = f"sqlite:///{sqlite_file_name}"
+
+connect_args = {"check_same_thread": False}
+engine = create_engine(sqlite_url, connect_args=connect_args)
+
+
+def create_db_and_tables():
+ SQLModel.metadata.create_all(engine)
+
+
+def get_session():
+ with Session(engine) as session:
+ yield session
+
+
+app = FastAPI()
+
+
+@app.on_event("startup")
+def on_startup():
+ create_db_and_tables()
+
+
+@app.post("/heroes/", response_model=HeroPublic)
+def create_hero(hero: HeroCreate, session: Session = Depends(get_session)):
+ db_hero = Hero.model_validate(hero)
+ session.add(db_hero)
+ session.commit()
+ session.refresh(db_hero)
+ return db_hero
+
+
+@app.get("/heroes/", response_model=list[HeroPublic])
+def read_heroes(
+ session: Session = Depends(get_session),
+ offset: int = 0,
+ limit: int = Query(default=100, le=100),
+):
+ heroes = session.exec(select(Hero).offset(offset).limit(limit)).all()
+ return heroes
+
+
+@app.get("/heroes/{hero_id}", response_model=HeroPublic)
+def read_hero(hero_id: int, session: Session = Depends(get_session)):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ return hero
+
+
+@app.patch("/heroes/{hero_id}", response_model=HeroPublic)
+def update_hero(
+ hero_id: int, hero: HeroUpdate, session: Session = Depends(get_session)
+):
+ hero_db = session.get(Hero, hero_id)
+ if not hero_db:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ hero_data = hero.model_dump(exclude_unset=True)
+ hero_db.sqlmodel_update(hero_data)
+ session.add(hero_db)
+ session.commit()
+ session.refresh(hero_db)
+ return hero_db
+
+
+@app.delete("/heroes/{hero_id}")
+def delete_hero(hero_id: int, session: Session = Depends(get_session)):
+ hero = session.get(Hero, hero_id)
+ if not hero:
+ raise HTTPException(status_code=404, detail="Hero not found")
+ session.delete(hero)
+ session.commit()
+ return {"ok": True}
diff --git a/requirements-docs.txt b/requirements-docs.txt
index c05bd51e3..1639159af 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -16,4 +16,4 @@ griffe-typingdoc==0.2.7
# For griffe, it formats with black
black==24.3.0
mkdocs-macros-plugin==1.0.5
-markdown-include-variants==0.0.1
+markdown-include-variants==0.0.3
diff --git a/requirements-tests.txt b/requirements-tests.txt
index 7b1f7ea1a..189fcaf7e 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -4,10 +4,7 @@ pytest >=7.1.3,<8.0.0
coverage[toml] >= 6.5.0,< 8.0
mypy ==1.8.0
dirty-equals ==0.6.0
-# TODO: once removing databases from tutorial, upgrade SQLAlchemy
-# probably when including SQLModel
-sqlalchemy >=1.3.18,<2.0.33
-databases[sqlite] >=0.3.2,<0.7.0
+sqlmodel==0.0.22
flask >=1.1.2,<3.0.0
anyio[trio] >=3.2.1,<4.0.0
PyJWT==2.8.0
diff --git a/scripts/playwright/sql_databases/image01.py b/scripts/playwright/sql_databases/image01.py
new file mode 100644
index 000000000..0dd6f2514
--- /dev/null
+++ b/scripts/playwright/sql_databases/image01.py
@@ -0,0 +1,37 @@
+import subprocess
+import time
+
+import httpx
+from playwright.sync_api import Playwright, sync_playwright
+
+
+# Run playwright codegen to generate the code below, copy paste the sections in run()
+def run(playwright: Playwright) -> None:
+ browser = playwright.chromium.launch(headless=False)
+ # Update the viewport manually
+ context = browser.new_context(viewport={"width": 960, "height": 1080})
+ page = context.new_page()
+ page.goto("http://localhost:8000/docs")
+ page.get_by_label("post /heroes/").click()
+ # Manually add the screenshot
+ page.screenshot(path="docs/en/docs/img/tutorial/sql-databases/image01.png")
+
+ # ---------------------
+ context.close()
+ browser.close()
+
+
+process = subprocess.Popen(
+ ["fastapi", "run", "docs_src/sql_databases/tutorial001.py"],
+)
+try:
+ for _ in range(3):
+ try:
+ response = httpx.get("http://localhost:8000/docs")
+ except httpx.ConnectError:
+ time.sleep(1)
+ break
+ with sync_playwright() as playwright:
+ run(playwright)
+finally:
+ process.terminate()
diff --git a/scripts/playwright/sql_databases/image02.py b/scripts/playwright/sql_databases/image02.py
new file mode 100644
index 000000000..6c4f685e8
--- /dev/null
+++ b/scripts/playwright/sql_databases/image02.py
@@ -0,0 +1,37 @@
+import subprocess
+import time
+
+import httpx
+from playwright.sync_api import Playwright, sync_playwright
+
+
+# Run playwright codegen to generate the code below, copy paste the sections in run()
+def run(playwright: Playwright) -> None:
+ browser = playwright.chromium.launch(headless=False)
+ # Update the viewport manually
+ context = browser.new_context(viewport={"width": 960, "height": 1080})
+ page = context.new_page()
+ page.goto("http://localhost:8000/docs")
+ page.get_by_label("post /heroes/").click()
+ # Manually add the screenshot
+ page.screenshot(path="docs/en/docs/img/tutorial/sql-databases/image02.png")
+
+ # ---------------------
+ context.close()
+ browser.close()
+
+
+process = subprocess.Popen(
+ ["fastapi", "run", "docs_src/sql_databases/tutorial002.py"],
+)
+try:
+ for _ in range(3):
+ try:
+ response = httpx.get("http://localhost:8000/docs")
+ except httpx.ConnectError:
+ time.sleep(1)
+ break
+ with sync_playwright() as playwright:
+ run(playwright)
+finally:
+ process.terminate()
diff --git a/tests/test_tutorial/test_async_sql_databases/__init__.py b/tests/test_tutorial/test_async_sql_databases/__init__.py
deleted file mode 100644
index e69de29bb..000000000
diff --git a/tests/test_tutorial/test_async_sql_databases/test_tutorial001.py b/tests/test_tutorial/test_async_sql_databases/test_tutorial001.py
deleted file mode 100644
index 13568a532..000000000
--- a/tests/test_tutorial/test_async_sql_databases/test_tutorial001.py
+++ /dev/null
@@ -1,146 +0,0 @@
-import pytest
-from fastapi import FastAPI
-from fastapi.testclient import TestClient
-
-from ...utils import needs_pydanticv1
-
-
-@pytest.fixture(name="app", scope="module")
-def get_app():
- with pytest.warns(DeprecationWarning):
- from docs_src.async_sql_databases.tutorial001 import app
- yield app
-
-
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_create_read(app: FastAPI):
- with TestClient(app) as client:
- note = {"text": "Foo bar", "completed": False}
- response = client.post("/notes/", json=note)
- assert response.status_code == 200, response.text
- data = response.json()
- assert data["text"] == note["text"]
- assert data["completed"] == note["completed"]
- assert "id" in data
- response = client.get("/notes/")
- assert response.status_code == 200, response.text
- assert data in response.json()
-
-
-def test_openapi_schema(app: FastAPI):
- with TestClient(app) as client:
- 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": {
- "/notes/": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "title": "Response Read Notes Notes Get",
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Note"
- },
- }
- }
- },
- }
- },
- "summary": "Read Notes",
- "operationId": "read_notes_notes__get",
- },
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/Note"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Create Note",
- "operationId": "create_note_notes__post",
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/NoteIn"}
- }
- },
- "required": True,
- },
- },
- }
- },
- "components": {
- "schemas": {
- "NoteIn": {
- "title": "NoteIn",
- "required": ["text", "completed"],
- "type": "object",
- "properties": {
- "text": {"title": "Text", "type": "string"},
- "completed": {"title": "Completed", "type": "boolean"},
- },
- },
- "Note": {
- "title": "Note",
- "required": ["id", "text", "completed"],
- "type": "object",
- "properties": {
- "id": {"title": "Id", "type": "integer"},
- "text": {"title": "Text", "type": "string"},
- "completed": {"title": "Completed", "type": "boolean"},
- },
- },
- "ValidationError": {
- "title": "ValidationError",
- "required": ["loc", "msg", "type"],
- "type": "object",
- "properties": {
- "loc": {
- "title": "Location",
- "type": "array",
- "items": {
- "anyOf": [{"type": "string"}, {"type": "integer"}]
- },
- },
- "msg": {"title": "Message", "type": "string"},
- "type": {"title": "Error Type", "type": "string"},
- },
- },
- "HTTPValidationError": {
- "title": "HTTPValidationError",
- "type": "object",
- "properties": {
- "detail": {
- "title": "Detail",
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/ValidationError"
- },
- }
- },
- },
- }
- },
- }
diff --git a/tests/test_tutorial/test_sql_databases/test_sql_databases.py b/tests/test_tutorial/test_sql_databases/test_sql_databases.py
deleted file mode 100644
index e3e2b36a8..000000000
--- a/tests/test_tutorial/test_sql_databases/test_sql_databases.py
+++ /dev/null
@@ -1,419 +0,0 @@
-import importlib
-import os
-from pathlib import Path
-
-import pytest
-from dirty_equals import IsDict
-from fastapi.testclient import TestClient
-
-from ...utils import needs_pydanticv1
-
-
-@pytest.fixture(scope="module")
-def client(tmp_path_factory: pytest.TempPathFactory):
- tmp_path = tmp_path_factory.mktemp("data")
- cwd = os.getcwd()
- os.chdir(tmp_path)
- test_db = Path("./sql_app.db")
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- # Import while creating the client to create the DB after starting the test session
- from docs_src.sql_databases.sql_app import main
-
- # Ensure import side effects are re-executed
- importlib.reload(main)
- with TestClient(main.app) as c:
- yield c
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- os.chdir(cwd)
-
-
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_create_user(client):
- test_user = {"email": "johndoe@example.com", "password": "secret"}
- response = client.post("/users/", json=test_user)
- assert response.status_code == 200, response.text
- data = response.json()
- assert test_user["email"] == data["email"]
- assert "id" in data
- response = client.post("/users/", json=test_user)
- assert response.status_code == 400, response.text
-
-
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_get_user(client):
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- data = response.json()
- assert "email" in data
- assert "id" in data
-
-
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_nonexistent_user(client):
- response = client.get("/users/999")
- assert response.status_code == 404, response.text
-
-
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_get_users(client):
- response = client.get("/users/")
- assert response.status_code == 200, response.text
- data = response.json()
- assert "email" in data[0]
- assert "id" in data[0]
-
-
-# TODO: pv2 add Pydantic v2 version
-@needs_pydanticv1
-def test_create_item(client):
- item = {"title": "Foo", "description": "Something that fights"}
- response = client.post("/users/1/items/", json=item)
- assert response.status_code == 200, response.text
- item_data = response.json()
- assert item["title"] == item_data["title"]
- assert item["description"] == item_data["description"]
- assert "id" in item_data
- assert "owner_id" in item_data
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- user_data = response.json()
- item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
- assert item_to_check["title"] == item["title"]
- assert item_to_check["description"] == item["description"]
-
-
-# TODO: pv2 add Pydantic v2 version
-@needs_pydanticv1
-def test_read_items(client):
- response = client.get("/items/")
- assert response.status_code == 200, response.text
- data = response.json()
- assert data
- first_item = data[0]
- assert "title" in first_item
- assert "description" in first_item
-
-
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_openapi_schema(client: TestClient):
- 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": {
- "/users/": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "title": "Response Read Users Users Get",
- "type": "array",
- "items": {"$ref": "#/components/schemas/User"},
- }
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read Users",
- "operationId": "read_users_users__get",
- "parameters": [
- {
- "required": False,
- "schema": {
- "title": "Skip",
- "type": "integer",
- "default": 0,
- },
- "name": "skip",
- "in": "query",
- },
- {
- "required": False,
- "schema": {
- "title": "Limit",
- "type": "integer",
- "default": 100,
- },
- "name": "limit",
- "in": "query",
- },
- ],
- },
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/User"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Create User",
- "operationId": "create_user_users__post",
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/UserCreate"}
- }
- },
- "required": True,
- },
- },
- },
- "/users/{user_id}": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/User"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read User",
- "operationId": "read_user_users__user_id__get",
- "parameters": [
- {
- "required": True,
- "schema": {"title": "User Id", "type": "integer"},
- "name": "user_id",
- "in": "path",
- }
- ],
- }
- },
- "/users/{user_id}/items/": {
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/Item"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Create Item For User",
- "operationId": "create_item_for_user_users__user_id__items__post",
- "parameters": [
- {
- "required": True,
- "schema": {"title": "User Id", "type": "integer"},
- "name": "user_id",
- "in": "path",
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/ItemCreate"}
- }
- },
- "required": True,
- },
- }
- },
- "/items/": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "title": "Response Read Items Items Get",
- "type": "array",
- "items": {"$ref": "#/components/schemas/Item"},
- }
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read Items",
- "operationId": "read_items_items__get",
- "parameters": [
- {
- "required": False,
- "schema": {
- "title": "Skip",
- "type": "integer",
- "default": 0,
- },
- "name": "skip",
- "in": "query",
- },
- {
- "required": False,
- "schema": {
- "title": "Limit",
- "type": "integer",
- "default": 100,
- },
- "name": "limit",
- "in": "query",
- },
- ],
- }
- },
- },
- "components": {
- "schemas": {
- "ItemCreate": {
- "title": "ItemCreate",
- "required": ["title"],
- "type": "object",
- "properties": {
- "title": {"title": "Title", "type": "string"},
- "description": IsDict(
- {
- "title": "Description",
- "anyOf": [{"type": "string"}, {"type": "null"}],
- }
- )
- | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {"title": "Description", "type": "string"}
- ),
- },
- },
- "Item": {
- "title": "Item",
- "required": ["title", "id", "owner_id"],
- "type": "object",
- "properties": {
- "title": {"title": "Title", "type": "string"},
- "description": IsDict(
- {
- "title": "Description",
- "anyOf": [{"type": "string"}, {"type": "null"}],
- }
- )
- | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {"title": "Description", "type": "string"},
- ),
- "id": {"title": "Id", "type": "integer"},
- "owner_id": {"title": "Owner Id", "type": "integer"},
- },
- },
- "User": {
- "title": "User",
- "required": ["email", "id", "is_active"],
- "type": "object",
- "properties": {
- "email": {"title": "Email", "type": "string"},
- "id": {"title": "Id", "type": "integer"},
- "is_active": {"title": "Is Active", "type": "boolean"},
- "items": {
- "title": "Items",
- "type": "array",
- "items": {"$ref": "#/components/schemas/Item"},
- "default": [],
- },
- },
- },
- "UserCreate": {
- "title": "UserCreate",
- "required": ["email", "password"],
- "type": "object",
- "properties": {
- "email": {"title": "Email", "type": "string"},
- "password": {"title": "Password", "type": "string"},
- },
- },
- "ValidationError": {
- "title": "ValidationError",
- "required": ["loc", "msg", "type"],
- "type": "object",
- "properties": {
- "loc": {
- "title": "Location",
- "type": "array",
- "items": {
- "anyOf": [{"type": "string"}, {"type": "integer"}]
- },
- },
- "msg": {"title": "Message", "type": "string"},
- "type": {"title": "Error Type", "type": "string"},
- },
- },
- "HTTPValidationError": {
- "title": "HTTPValidationError",
- "type": "object",
- "properties": {
- "detail": {
- "title": "Detail",
- "type": "array",
- "items": {"$ref": "#/components/schemas/ValidationError"},
- }
- },
- },
- }
- },
- }
diff --git a/tests/test_tutorial/test_sql_databases/test_sql_databases_middleware.py b/tests/test_tutorial/test_sql_databases/test_sql_databases_middleware.py
deleted file mode 100644
index 73b97e09d..000000000
--- a/tests/test_tutorial/test_sql_databases/test_sql_databases_middleware.py
+++ /dev/null
@@ -1,421 +0,0 @@
-import importlib
-from pathlib import Path
-
-import pytest
-from dirty_equals import IsDict
-from fastapi.testclient import TestClient
-
-from ...utils import needs_pydanticv1
-
-
-@pytest.fixture(scope="module")
-def client():
- test_db = Path("./sql_app.db")
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- # Import while creating the client to create the DB after starting the test session
- from docs_src.sql_databases.sql_app import alt_main
-
- # Ensure import side effects are re-executed
- importlib.reload(alt_main)
-
- with TestClient(alt_main.app) as c:
- yield c
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
-
-
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_create_user(client):
- test_user = {"email": "johndoe@example.com", "password": "secret"}
- response = client.post("/users/", json=test_user)
- assert response.status_code == 200, response.text
- data = response.json()
- assert test_user["email"] == data["email"]
- assert "id" in data
- response = client.post("/users/", json=test_user)
- assert response.status_code == 400, response.text
-
-
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_get_user(client):
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- data = response.json()
- assert "email" in data
- assert "id" in data
-
-
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_nonexistent_user(client):
- response = client.get("/users/999")
- assert response.status_code == 404, response.text
-
-
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_get_users(client):
- response = client.get("/users/")
- assert response.status_code == 200, response.text
- data = response.json()
- assert "email" in data[0]
- assert "id" in data[0]
-
-
-# TODO: pv2 add Pydantic v2 version
-@needs_pydanticv1
-def test_create_item(client):
- item = {"title": "Foo", "description": "Something that fights"}
- response = client.post("/users/1/items/", json=item)
- assert response.status_code == 200, response.text
- item_data = response.json()
- assert item["title"] == item_data["title"]
- assert item["description"] == item_data["description"]
- assert "id" in item_data
- assert "owner_id" in item_data
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- user_data = response.json()
- item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
- assert item_to_check["title"] == item["title"]
- assert item_to_check["description"] == item["description"]
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- user_data = response.json()
- item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
- assert item_to_check["title"] == item["title"]
- assert item_to_check["description"] == item["description"]
-
-
-# TODO: pv2 add Pydantic v2 version
-@needs_pydanticv1
-def test_read_items(client):
- response = client.get("/items/")
- assert response.status_code == 200, response.text
- data = response.json()
- assert data
- first_item = data[0]
- assert "title" in first_item
- assert "description" in first_item
-
-
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_openapi_schema(client: TestClient):
- 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": {
- "/users/": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "title": "Response Read Users Users Get",
- "type": "array",
- "items": {"$ref": "#/components/schemas/User"},
- }
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read Users",
- "operationId": "read_users_users__get",
- "parameters": [
- {
- "required": False,
- "schema": {
- "title": "Skip",
- "type": "integer",
- "default": 0,
- },
- "name": "skip",
- "in": "query",
- },
- {
- "required": False,
- "schema": {
- "title": "Limit",
- "type": "integer",
- "default": 100,
- },
- "name": "limit",
- "in": "query",
- },
- ],
- },
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/User"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Create User",
- "operationId": "create_user_users__post",
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/UserCreate"}
- }
- },
- "required": True,
- },
- },
- },
- "/users/{user_id}": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/User"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read User",
- "operationId": "read_user_users__user_id__get",
- "parameters": [
- {
- "required": True,
- "schema": {"title": "User Id", "type": "integer"},
- "name": "user_id",
- "in": "path",
- }
- ],
- }
- },
- "/users/{user_id}/items/": {
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/Item"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Create Item For User",
- "operationId": "create_item_for_user_users__user_id__items__post",
- "parameters": [
- {
- "required": True,
- "schema": {"title": "User Id", "type": "integer"},
- "name": "user_id",
- "in": "path",
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/ItemCreate"}
- }
- },
- "required": True,
- },
- }
- },
- "/items/": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "title": "Response Read Items Items Get",
- "type": "array",
- "items": {"$ref": "#/components/schemas/Item"},
- }
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read Items",
- "operationId": "read_items_items__get",
- "parameters": [
- {
- "required": False,
- "schema": {
- "title": "Skip",
- "type": "integer",
- "default": 0,
- },
- "name": "skip",
- "in": "query",
- },
- {
- "required": False,
- "schema": {
- "title": "Limit",
- "type": "integer",
- "default": 100,
- },
- "name": "limit",
- "in": "query",
- },
- ],
- }
- },
- },
- "components": {
- "schemas": {
- "ItemCreate": {
- "title": "ItemCreate",
- "required": ["title"],
- "type": "object",
- "properties": {
- "title": {"title": "Title", "type": "string"},
- "description": IsDict(
- {
- "title": "Description",
- "anyOf": [{"type": "string"}, {"type": "null"}],
- }
- )
- | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {"title": "Description", "type": "string"}
- ),
- },
- },
- "Item": {
- "title": "Item",
- "required": ["title", "id", "owner_id"],
- "type": "object",
- "properties": {
- "title": {"title": "Title", "type": "string"},
- "description": IsDict(
- {
- "title": "Description",
- "anyOf": [{"type": "string"}, {"type": "null"}],
- }
- )
- | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {"title": "Description", "type": "string"},
- ),
- "id": {"title": "Id", "type": "integer"},
- "owner_id": {"title": "Owner Id", "type": "integer"},
- },
- },
- "User": {
- "title": "User",
- "required": ["email", "id", "is_active"],
- "type": "object",
- "properties": {
- "email": {"title": "Email", "type": "string"},
- "id": {"title": "Id", "type": "integer"},
- "is_active": {"title": "Is Active", "type": "boolean"},
- "items": {
- "title": "Items",
- "type": "array",
- "items": {"$ref": "#/components/schemas/Item"},
- "default": [],
- },
- },
- },
- "UserCreate": {
- "title": "UserCreate",
- "required": ["email", "password"],
- "type": "object",
- "properties": {
- "email": {"title": "Email", "type": "string"},
- "password": {"title": "Password", "type": "string"},
- },
- },
- "ValidationError": {
- "title": "ValidationError",
- "required": ["loc", "msg", "type"],
- "type": "object",
- "properties": {
- "loc": {
- "title": "Location",
- "type": "array",
- "items": {
- "anyOf": [{"type": "string"}, {"type": "integer"}]
- },
- },
- "msg": {"title": "Message", "type": "string"},
- "type": {"title": "Error Type", "type": "string"},
- },
- },
- "HTTPValidationError": {
- "title": "HTTPValidationError",
- "type": "object",
- "properties": {
- "detail": {
- "title": "Detail",
- "type": "array",
- "items": {"$ref": "#/components/schemas/ValidationError"},
- }
- },
- },
- }
- },
- }
diff --git a/tests/test_tutorial/test_sql_databases/test_sql_databases_middleware_py310.py b/tests/test_tutorial/test_sql_databases/test_sql_databases_middleware_py310.py
deleted file mode 100644
index a078f012a..000000000
--- a/tests/test_tutorial/test_sql_databases/test_sql_databases_middleware_py310.py
+++ /dev/null
@@ -1,433 +0,0 @@
-import importlib
-import os
-from pathlib import Path
-
-import pytest
-from dirty_equals import IsDict
-from fastapi.testclient import TestClient
-
-from ...utils import needs_py310, needs_pydanticv1
-
-
-@pytest.fixture(scope="module")
-def client(tmp_path_factory: pytest.TempPathFactory):
- tmp_path = tmp_path_factory.mktemp("data")
- cwd = os.getcwd()
- os.chdir(tmp_path)
- test_db = Path("./sql_app.db")
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- # Import while creating the client to create the DB after starting the test session
- from docs_src.sql_databases.sql_app_py310 import alt_main
-
- # Ensure import side effects are re-executed
- importlib.reload(alt_main)
-
- with TestClient(alt_main.app) as c:
- yield c
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- os.chdir(cwd)
-
-
-@needs_py310
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_create_user(client):
- test_user = {"email": "johndoe@example.com", "password": "secret"}
- response = client.post("/users/", json=test_user)
- assert response.status_code == 200, response.text
- data = response.json()
- assert test_user["email"] == data["email"]
- assert "id" in data
- response = client.post("/users/", json=test_user)
- assert response.status_code == 400, response.text
-
-
-@needs_py310
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_get_user(client):
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- data = response.json()
- assert "email" in data
- assert "id" in data
-
-
-@needs_py310
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_nonexistent_user(client):
- response = client.get("/users/999")
- assert response.status_code == 404, response.text
-
-
-@needs_py310
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_get_users(client):
- response = client.get("/users/")
- assert response.status_code == 200, response.text
- data = response.json()
- assert "email" in data[0]
- assert "id" in data[0]
-
-
-@needs_py310
-# TODO: pv2 add Pydantic v2 version
-@needs_pydanticv1
-def test_create_item(client):
- item = {"title": "Foo", "description": "Something that fights"}
- response = client.post("/users/1/items/", json=item)
- assert response.status_code == 200, response.text
- item_data = response.json()
- assert item["title"] == item_data["title"]
- assert item["description"] == item_data["description"]
- assert "id" in item_data
- assert "owner_id" in item_data
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- user_data = response.json()
- item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
- assert item_to_check["title"] == item["title"]
- assert item_to_check["description"] == item["description"]
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- user_data = response.json()
- item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
- assert item_to_check["title"] == item["title"]
- assert item_to_check["description"] == item["description"]
-
-
-@needs_py310
-# TODO: pv2 add Pydantic v2 version
-@needs_pydanticv1
-def test_read_items(client):
- response = client.get("/items/")
- assert response.status_code == 200, response.text
- data = response.json()
- assert data
- first_item = data[0]
- assert "title" in first_item
- assert "description" in first_item
-
-
-@needs_py310
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_openapi_schema(client: TestClient):
- 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": {
- "/users/": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "title": "Response Read Users Users Get",
- "type": "array",
- "items": {"$ref": "#/components/schemas/User"},
- }
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read Users",
- "operationId": "read_users_users__get",
- "parameters": [
- {
- "required": False,
- "schema": {
- "title": "Skip",
- "type": "integer",
- "default": 0,
- },
- "name": "skip",
- "in": "query",
- },
- {
- "required": False,
- "schema": {
- "title": "Limit",
- "type": "integer",
- "default": 100,
- },
- "name": "limit",
- "in": "query",
- },
- ],
- },
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/User"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Create User",
- "operationId": "create_user_users__post",
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/UserCreate"}
- }
- },
- "required": True,
- },
- },
- },
- "/users/{user_id}": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/User"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read User",
- "operationId": "read_user_users__user_id__get",
- "parameters": [
- {
- "required": True,
- "schema": {"title": "User Id", "type": "integer"},
- "name": "user_id",
- "in": "path",
- }
- ],
- }
- },
- "/users/{user_id}/items/": {
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/Item"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Create Item For User",
- "operationId": "create_item_for_user_users__user_id__items__post",
- "parameters": [
- {
- "required": True,
- "schema": {"title": "User Id", "type": "integer"},
- "name": "user_id",
- "in": "path",
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/ItemCreate"}
- }
- },
- "required": True,
- },
- }
- },
- "/items/": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "title": "Response Read Items Items Get",
- "type": "array",
- "items": {"$ref": "#/components/schemas/Item"},
- }
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read Items",
- "operationId": "read_items_items__get",
- "parameters": [
- {
- "required": False,
- "schema": {
- "title": "Skip",
- "type": "integer",
- "default": 0,
- },
- "name": "skip",
- "in": "query",
- },
- {
- "required": False,
- "schema": {
- "title": "Limit",
- "type": "integer",
- "default": 100,
- },
- "name": "limit",
- "in": "query",
- },
- ],
- }
- },
- },
- "components": {
- "schemas": {
- "ItemCreate": {
- "title": "ItemCreate",
- "required": ["title"],
- "type": "object",
- "properties": {
- "title": {"title": "Title", "type": "string"},
- "description": IsDict(
- {
- "title": "Description",
- "anyOf": [{"type": "string"}, {"type": "null"}],
- }
- )
- | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {"title": "Description", "type": "string"}
- ),
- },
- },
- "Item": {
- "title": "Item",
- "required": ["title", "id", "owner_id"],
- "type": "object",
- "properties": {
- "title": {"title": "Title", "type": "string"},
- "description": IsDict(
- {
- "title": "Description",
- "anyOf": [{"type": "string"}, {"type": "null"}],
- }
- )
- | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {"title": "Description", "type": "string"},
- ),
- "id": {"title": "Id", "type": "integer"},
- "owner_id": {"title": "Owner Id", "type": "integer"},
- },
- },
- "User": {
- "title": "User",
- "required": ["email", "id", "is_active"],
- "type": "object",
- "properties": {
- "email": {"title": "Email", "type": "string"},
- "id": {"title": "Id", "type": "integer"},
- "is_active": {"title": "Is Active", "type": "boolean"},
- "items": {
- "title": "Items",
- "type": "array",
- "items": {"$ref": "#/components/schemas/Item"},
- "default": [],
- },
- },
- },
- "UserCreate": {
- "title": "UserCreate",
- "required": ["email", "password"],
- "type": "object",
- "properties": {
- "email": {"title": "Email", "type": "string"},
- "password": {"title": "Password", "type": "string"},
- },
- },
- "ValidationError": {
- "title": "ValidationError",
- "required": ["loc", "msg", "type"],
- "type": "object",
- "properties": {
- "loc": {
- "title": "Location",
- "type": "array",
- "items": {
- "anyOf": [{"type": "string"}, {"type": "integer"}]
- },
- },
- "msg": {"title": "Message", "type": "string"},
- "type": {"title": "Error Type", "type": "string"},
- },
- },
- "HTTPValidationError": {
- "title": "HTTPValidationError",
- "type": "object",
- "properties": {
- "detail": {
- "title": "Detail",
- "type": "array",
- "items": {"$ref": "#/components/schemas/ValidationError"},
- }
- },
- },
- }
- },
- }
diff --git a/tests/test_tutorial/test_sql_databases/test_sql_databases_middleware_py39.py b/tests/test_tutorial/test_sql_databases/test_sql_databases_middleware_py39.py
deleted file mode 100644
index a5da07ac6..000000000
--- a/tests/test_tutorial/test_sql_databases/test_sql_databases_middleware_py39.py
+++ /dev/null
@@ -1,433 +0,0 @@
-import importlib
-import os
-from pathlib import Path
-
-import pytest
-from dirty_equals import IsDict
-from fastapi.testclient import TestClient
-
-from ...utils import needs_py39, needs_pydanticv1
-
-
-@pytest.fixture(scope="module")
-def client(tmp_path_factory: pytest.TempPathFactory):
- tmp_path = tmp_path_factory.mktemp("data")
- cwd = os.getcwd()
- os.chdir(tmp_path)
- test_db = Path("./sql_app.db")
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- # Import while creating the client to create the DB after starting the test session
- from docs_src.sql_databases.sql_app_py39 import alt_main
-
- # Ensure import side effects are re-executed
- importlib.reload(alt_main)
-
- with TestClient(alt_main.app) as c:
- yield c
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- os.chdir(cwd)
-
-
-@needs_py39
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_create_user(client):
- test_user = {"email": "johndoe@example.com", "password": "secret"}
- response = client.post("/users/", json=test_user)
- assert response.status_code == 200, response.text
- data = response.json()
- assert test_user["email"] == data["email"]
- assert "id" in data
- response = client.post("/users/", json=test_user)
- assert response.status_code == 400, response.text
-
-
-@needs_py39
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_get_user(client):
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- data = response.json()
- assert "email" in data
- assert "id" in data
-
-
-@needs_py39
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_nonexistent_user(client):
- response = client.get("/users/999")
- assert response.status_code == 404, response.text
-
-
-@needs_py39
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_get_users(client):
- response = client.get("/users/")
- assert response.status_code == 200, response.text
- data = response.json()
- assert "email" in data[0]
- assert "id" in data[0]
-
-
-@needs_py39
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_create_item(client):
- item = {"title": "Foo", "description": "Something that fights"}
- response = client.post("/users/1/items/", json=item)
- assert response.status_code == 200, response.text
- item_data = response.json()
- assert item["title"] == item_data["title"]
- assert item["description"] == item_data["description"]
- assert "id" in item_data
- assert "owner_id" in item_data
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- user_data = response.json()
- item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
- assert item_to_check["title"] == item["title"]
- assert item_to_check["description"] == item["description"]
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- user_data = response.json()
- item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
- assert item_to_check["title"] == item["title"]
- assert item_to_check["description"] == item["description"]
-
-
-@needs_py39
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_read_items(client):
- response = client.get("/items/")
- assert response.status_code == 200, response.text
- data = response.json()
- assert data
- first_item = data[0]
- assert "title" in first_item
- assert "description" in first_item
-
-
-@needs_py39
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_openapi_schema(client: TestClient):
- 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": {
- "/users/": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "title": "Response Read Users Users Get",
- "type": "array",
- "items": {"$ref": "#/components/schemas/User"},
- }
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read Users",
- "operationId": "read_users_users__get",
- "parameters": [
- {
- "required": False,
- "schema": {
- "title": "Skip",
- "type": "integer",
- "default": 0,
- },
- "name": "skip",
- "in": "query",
- },
- {
- "required": False,
- "schema": {
- "title": "Limit",
- "type": "integer",
- "default": 100,
- },
- "name": "limit",
- "in": "query",
- },
- ],
- },
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/User"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Create User",
- "operationId": "create_user_users__post",
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/UserCreate"}
- }
- },
- "required": True,
- },
- },
- },
- "/users/{user_id}": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/User"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read User",
- "operationId": "read_user_users__user_id__get",
- "parameters": [
- {
- "required": True,
- "schema": {"title": "User Id", "type": "integer"},
- "name": "user_id",
- "in": "path",
- }
- ],
- }
- },
- "/users/{user_id}/items/": {
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/Item"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Create Item For User",
- "operationId": "create_item_for_user_users__user_id__items__post",
- "parameters": [
- {
- "required": True,
- "schema": {"title": "User Id", "type": "integer"},
- "name": "user_id",
- "in": "path",
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/ItemCreate"}
- }
- },
- "required": True,
- },
- }
- },
- "/items/": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "title": "Response Read Items Items Get",
- "type": "array",
- "items": {"$ref": "#/components/schemas/Item"},
- }
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read Items",
- "operationId": "read_items_items__get",
- "parameters": [
- {
- "required": False,
- "schema": {
- "title": "Skip",
- "type": "integer",
- "default": 0,
- },
- "name": "skip",
- "in": "query",
- },
- {
- "required": False,
- "schema": {
- "title": "Limit",
- "type": "integer",
- "default": 100,
- },
- "name": "limit",
- "in": "query",
- },
- ],
- }
- },
- },
- "components": {
- "schemas": {
- "ItemCreate": {
- "title": "ItemCreate",
- "required": ["title"],
- "type": "object",
- "properties": {
- "title": {"title": "Title", "type": "string"},
- "description": IsDict(
- {
- "title": "Description",
- "anyOf": [{"type": "string"}, {"type": "null"}],
- }
- )
- | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {"title": "Description", "type": "string"}
- ),
- },
- },
- "Item": {
- "title": "Item",
- "required": ["title", "id", "owner_id"],
- "type": "object",
- "properties": {
- "title": {"title": "Title", "type": "string"},
- "description": IsDict(
- {
- "title": "Description",
- "anyOf": [{"type": "string"}, {"type": "null"}],
- }
- )
- | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {"title": "Description", "type": "string"},
- ),
- "id": {"title": "Id", "type": "integer"},
- "owner_id": {"title": "Owner Id", "type": "integer"},
- },
- },
- "User": {
- "title": "User",
- "required": ["email", "id", "is_active"],
- "type": "object",
- "properties": {
- "email": {"title": "Email", "type": "string"},
- "id": {"title": "Id", "type": "integer"},
- "is_active": {"title": "Is Active", "type": "boolean"},
- "items": {
- "title": "Items",
- "type": "array",
- "items": {"$ref": "#/components/schemas/Item"},
- "default": [],
- },
- },
- },
- "UserCreate": {
- "title": "UserCreate",
- "required": ["email", "password"],
- "type": "object",
- "properties": {
- "email": {"title": "Email", "type": "string"},
- "password": {"title": "Password", "type": "string"},
- },
- },
- "ValidationError": {
- "title": "ValidationError",
- "required": ["loc", "msg", "type"],
- "type": "object",
- "properties": {
- "loc": {
- "title": "Location",
- "type": "array",
- "items": {
- "anyOf": [{"type": "string"}, {"type": "integer"}]
- },
- },
- "msg": {"title": "Message", "type": "string"},
- "type": {"title": "Error Type", "type": "string"},
- },
- },
- "HTTPValidationError": {
- "title": "HTTPValidationError",
- "type": "object",
- "properties": {
- "detail": {
- "title": "Detail",
- "type": "array",
- "items": {"$ref": "#/components/schemas/ValidationError"},
- }
- },
- },
- }
- },
- }
diff --git a/tests/test_tutorial/test_sql_databases/test_sql_databases_py310.py b/tests/test_tutorial/test_sql_databases/test_sql_databases_py310.py
deleted file mode 100644
index 5a9106598..000000000
--- a/tests/test_tutorial/test_sql_databases/test_sql_databases_py310.py
+++ /dev/null
@@ -1,432 +0,0 @@
-import importlib
-import os
-from pathlib import Path
-
-import pytest
-from dirty_equals import IsDict
-from fastapi.testclient import TestClient
-
-from ...utils import needs_py310, needs_pydanticv1
-
-
-@pytest.fixture(scope="module", name="client")
-def get_client(tmp_path_factory: pytest.TempPathFactory):
- tmp_path = tmp_path_factory.mktemp("data")
- cwd = os.getcwd()
- os.chdir(tmp_path)
- test_db = Path("./sql_app.db")
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- # Import while creating the client to create the DB after starting the test session
- from docs_src.sql_databases.sql_app_py310 import main
-
- # Ensure import side effects are re-executed
- importlib.reload(main)
- with TestClient(main.app) as c:
- yield c
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- os.chdir(cwd)
-
-
-@needs_py310
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_create_user(client):
- test_user = {"email": "johndoe@example.com", "password": "secret"}
- response = client.post("/users/", json=test_user)
- assert response.status_code == 200, response.text
- data = response.json()
- assert test_user["email"] == data["email"]
- assert "id" in data
- response = client.post("/users/", json=test_user)
- assert response.status_code == 400, response.text
-
-
-@needs_py310
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_get_user(client):
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- data = response.json()
- assert "email" in data
- assert "id" in data
-
-
-@needs_py310
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_nonexistent_user(client):
- response = client.get("/users/999")
- assert response.status_code == 404, response.text
-
-
-@needs_py310
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_get_users(client):
- response = client.get("/users/")
- assert response.status_code == 200, response.text
- data = response.json()
- assert "email" in data[0]
- assert "id" in data[0]
-
-
-@needs_py310
-# TODO: pv2 add Pydantic v2 version
-@needs_pydanticv1
-def test_create_item(client):
- item = {"title": "Foo", "description": "Something that fights"}
- response = client.post("/users/1/items/", json=item)
- assert response.status_code == 200, response.text
- item_data = response.json()
- assert item["title"] == item_data["title"]
- assert item["description"] == item_data["description"]
- assert "id" in item_data
- assert "owner_id" in item_data
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- user_data = response.json()
- item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
- assert item_to_check["title"] == item["title"]
- assert item_to_check["description"] == item["description"]
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- user_data = response.json()
- item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
- assert item_to_check["title"] == item["title"]
- assert item_to_check["description"] == item["description"]
-
-
-@needs_py310
-# TODO: pv2 add Pydantic v2 version
-@needs_pydanticv1
-def test_read_items(client):
- response = client.get("/items/")
- assert response.status_code == 200, response.text
- data = response.json()
- assert data
- first_item = data[0]
- assert "title" in first_item
- assert "description" in first_item
-
-
-@needs_py310
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_openapi_schema(client: TestClient):
- 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": {
- "/users/": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "title": "Response Read Users Users Get",
- "type": "array",
- "items": {"$ref": "#/components/schemas/User"},
- }
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read Users",
- "operationId": "read_users_users__get",
- "parameters": [
- {
- "required": False,
- "schema": {
- "title": "Skip",
- "type": "integer",
- "default": 0,
- },
- "name": "skip",
- "in": "query",
- },
- {
- "required": False,
- "schema": {
- "title": "Limit",
- "type": "integer",
- "default": 100,
- },
- "name": "limit",
- "in": "query",
- },
- ],
- },
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/User"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Create User",
- "operationId": "create_user_users__post",
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/UserCreate"}
- }
- },
- "required": True,
- },
- },
- },
- "/users/{user_id}": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/User"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read User",
- "operationId": "read_user_users__user_id__get",
- "parameters": [
- {
- "required": True,
- "schema": {"title": "User Id", "type": "integer"},
- "name": "user_id",
- "in": "path",
- }
- ],
- }
- },
- "/users/{user_id}/items/": {
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/Item"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Create Item For User",
- "operationId": "create_item_for_user_users__user_id__items__post",
- "parameters": [
- {
- "required": True,
- "schema": {"title": "User Id", "type": "integer"},
- "name": "user_id",
- "in": "path",
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/ItemCreate"}
- }
- },
- "required": True,
- },
- }
- },
- "/items/": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "title": "Response Read Items Items Get",
- "type": "array",
- "items": {"$ref": "#/components/schemas/Item"},
- }
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read Items",
- "operationId": "read_items_items__get",
- "parameters": [
- {
- "required": False,
- "schema": {
- "title": "Skip",
- "type": "integer",
- "default": 0,
- },
- "name": "skip",
- "in": "query",
- },
- {
- "required": False,
- "schema": {
- "title": "Limit",
- "type": "integer",
- "default": 100,
- },
- "name": "limit",
- "in": "query",
- },
- ],
- }
- },
- },
- "components": {
- "schemas": {
- "ItemCreate": {
- "title": "ItemCreate",
- "required": ["title"],
- "type": "object",
- "properties": {
- "title": {"title": "Title", "type": "string"},
- "description": IsDict(
- {
- "title": "Description",
- "anyOf": [{"type": "string"}, {"type": "null"}],
- }
- )
- | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {"title": "Description", "type": "string"}
- ),
- },
- },
- "Item": {
- "title": "Item",
- "required": ["title", "id", "owner_id"],
- "type": "object",
- "properties": {
- "title": {"title": "Title", "type": "string"},
- "description": IsDict(
- {
- "title": "Description",
- "anyOf": [{"type": "string"}, {"type": "null"}],
- }
- )
- | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {"title": "Description", "type": "string"},
- ),
- "id": {"title": "Id", "type": "integer"},
- "owner_id": {"title": "Owner Id", "type": "integer"},
- },
- },
- "User": {
- "title": "User",
- "required": ["email", "id", "is_active"],
- "type": "object",
- "properties": {
- "email": {"title": "Email", "type": "string"},
- "id": {"title": "Id", "type": "integer"},
- "is_active": {"title": "Is Active", "type": "boolean"},
- "items": {
- "title": "Items",
- "type": "array",
- "items": {"$ref": "#/components/schemas/Item"},
- "default": [],
- },
- },
- },
- "UserCreate": {
- "title": "UserCreate",
- "required": ["email", "password"],
- "type": "object",
- "properties": {
- "email": {"title": "Email", "type": "string"},
- "password": {"title": "Password", "type": "string"},
- },
- },
- "ValidationError": {
- "title": "ValidationError",
- "required": ["loc", "msg", "type"],
- "type": "object",
- "properties": {
- "loc": {
- "title": "Location",
- "type": "array",
- "items": {
- "anyOf": [{"type": "string"}, {"type": "integer"}]
- },
- },
- "msg": {"title": "Message", "type": "string"},
- "type": {"title": "Error Type", "type": "string"},
- },
- },
- "HTTPValidationError": {
- "title": "HTTPValidationError",
- "type": "object",
- "properties": {
- "detail": {
- "title": "Detail",
- "type": "array",
- "items": {"$ref": "#/components/schemas/ValidationError"},
- }
- },
- },
- }
- },
- }
diff --git a/tests/test_tutorial/test_sql_databases/test_sql_databases_py39.py b/tests/test_tutorial/test_sql_databases/test_sql_databases_py39.py
deleted file mode 100644
index a354ba905..000000000
--- a/tests/test_tutorial/test_sql_databases/test_sql_databases_py39.py
+++ /dev/null
@@ -1,432 +0,0 @@
-import importlib
-import os
-from pathlib import Path
-
-import pytest
-from dirty_equals import IsDict
-from fastapi.testclient import TestClient
-
-from ...utils import needs_py39, needs_pydanticv1
-
-
-@pytest.fixture(scope="module", name="client")
-def get_client(tmp_path_factory: pytest.TempPathFactory):
- tmp_path = tmp_path_factory.mktemp("data")
- cwd = os.getcwd()
- os.chdir(tmp_path)
- test_db = Path("./sql_app.db")
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- # Import while creating the client to create the DB after starting the test session
- from docs_src.sql_databases.sql_app_py39 import main
-
- # Ensure import side effects are re-executed
- importlib.reload(main)
- with TestClient(main.app) as c:
- yield c
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- os.chdir(cwd)
-
-
-@needs_py39
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_create_user(client):
- test_user = {"email": "johndoe@example.com", "password": "secret"}
- response = client.post("/users/", json=test_user)
- assert response.status_code == 200, response.text
- data = response.json()
- assert test_user["email"] == data["email"]
- assert "id" in data
- response = client.post("/users/", json=test_user)
- assert response.status_code == 400, response.text
-
-
-@needs_py39
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_get_user(client):
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- data = response.json()
- assert "email" in data
- assert "id" in data
-
-
-@needs_py39
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_nonexistent_user(client):
- response = client.get("/users/999")
- assert response.status_code == 404, response.text
-
-
-@needs_py39
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_get_users(client):
- response = client.get("/users/")
- assert response.status_code == 200, response.text
- data = response.json()
- assert "email" in data[0]
- assert "id" in data[0]
-
-
-@needs_py39
-# TODO: pv2 add Pydantic v2 version
-@needs_pydanticv1
-def test_create_item(client):
- item = {"title": "Foo", "description": "Something that fights"}
- response = client.post("/users/1/items/", json=item)
- assert response.status_code == 200, response.text
- item_data = response.json()
- assert item["title"] == item_data["title"]
- assert item["description"] == item_data["description"]
- assert "id" in item_data
- assert "owner_id" in item_data
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- user_data = response.json()
- item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
- assert item_to_check["title"] == item["title"]
- assert item_to_check["description"] == item["description"]
- response = client.get("/users/1")
- assert response.status_code == 200, response.text
- user_data = response.json()
- item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
- assert item_to_check["title"] == item["title"]
- assert item_to_check["description"] == item["description"]
-
-
-@needs_py39
-# TODO: pv2 add Pydantic v2 version
-@needs_pydanticv1
-def test_read_items(client):
- response = client.get("/items/")
- assert response.status_code == 200, response.text
- data = response.json()
- assert data
- first_item = data[0]
- assert "title" in first_item
- assert "description" in first_item
-
-
-@needs_py39
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_openapi_schema(client: TestClient):
- 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": {
- "/users/": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "title": "Response Read Users Users Get",
- "type": "array",
- "items": {"$ref": "#/components/schemas/User"},
- }
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read Users",
- "operationId": "read_users_users__get",
- "parameters": [
- {
- "required": False,
- "schema": {
- "title": "Skip",
- "type": "integer",
- "default": 0,
- },
- "name": "skip",
- "in": "query",
- },
- {
- "required": False,
- "schema": {
- "title": "Limit",
- "type": "integer",
- "default": 100,
- },
- "name": "limit",
- "in": "query",
- },
- ],
- },
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/User"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Create User",
- "operationId": "create_user_users__post",
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/UserCreate"}
- }
- },
- "required": True,
- },
- },
- },
- "/users/{user_id}": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/User"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read User",
- "operationId": "read_user_users__user_id__get",
- "parameters": [
- {
- "required": True,
- "schema": {"title": "User Id", "type": "integer"},
- "name": "user_id",
- "in": "path",
- }
- ],
- }
- },
- "/users/{user_id}/items/": {
- "post": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/Item"}
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Create Item For User",
- "operationId": "create_item_for_user_users__user_id__items__post",
- "parameters": [
- {
- "required": True,
- "schema": {"title": "User Id", "type": "integer"},
- "name": "user_id",
- "in": "path",
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {"$ref": "#/components/schemas/ItemCreate"}
- }
- },
- "required": True,
- },
- }
- },
- "/items/": {
- "get": {
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "title": "Response Read Items Items Get",
- "type": "array",
- "items": {"$ref": "#/components/schemas/Item"},
- }
- }
- },
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- },
- },
- },
- "summary": "Read Items",
- "operationId": "read_items_items__get",
- "parameters": [
- {
- "required": False,
- "schema": {
- "title": "Skip",
- "type": "integer",
- "default": 0,
- },
- "name": "skip",
- "in": "query",
- },
- {
- "required": False,
- "schema": {
- "title": "Limit",
- "type": "integer",
- "default": 100,
- },
- "name": "limit",
- "in": "query",
- },
- ],
- }
- },
- },
- "components": {
- "schemas": {
- "ItemCreate": {
- "title": "ItemCreate",
- "required": ["title"],
- "type": "object",
- "properties": {
- "title": {"title": "Title", "type": "string"},
- "description": IsDict(
- {
- "title": "Description",
- "anyOf": [{"type": "string"}, {"type": "null"}],
- }
- )
- | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {"title": "Description", "type": "string"}
- ),
- },
- },
- "Item": {
- "title": "Item",
- "required": ["title", "id", "owner_id"],
- "type": "object",
- "properties": {
- "title": {"title": "Title", "type": "string"},
- "description": IsDict(
- {
- "title": "Description",
- "anyOf": [{"type": "string"}, {"type": "null"}],
- }
- )
- | IsDict(
- # TODO: remove when deprecating Pydantic v1
- {"title": "Description", "type": "string"},
- ),
- "id": {"title": "Id", "type": "integer"},
- "owner_id": {"title": "Owner Id", "type": "integer"},
- },
- },
- "User": {
- "title": "User",
- "required": ["email", "id", "is_active"],
- "type": "object",
- "properties": {
- "email": {"title": "Email", "type": "string"},
- "id": {"title": "Id", "type": "integer"},
- "is_active": {"title": "Is Active", "type": "boolean"},
- "items": {
- "title": "Items",
- "type": "array",
- "items": {"$ref": "#/components/schemas/Item"},
- "default": [],
- },
- },
- },
- "UserCreate": {
- "title": "UserCreate",
- "required": ["email", "password"],
- "type": "object",
- "properties": {
- "email": {"title": "Email", "type": "string"},
- "password": {"title": "Password", "type": "string"},
- },
- },
- "ValidationError": {
- "title": "ValidationError",
- "required": ["loc", "msg", "type"],
- "type": "object",
- "properties": {
- "loc": {
- "title": "Location",
- "type": "array",
- "items": {
- "anyOf": [{"type": "string"}, {"type": "integer"}]
- },
- },
- "msg": {"title": "Message", "type": "string"},
- "type": {"title": "Error Type", "type": "string"},
- },
- },
- "HTTPValidationError": {
- "title": "HTTPValidationError",
- "type": "object",
- "properties": {
- "detail": {
- "title": "Detail",
- "type": "array",
- "items": {"$ref": "#/components/schemas/ValidationError"},
- }
- },
- },
- }
- },
- }
diff --git a/tests/test_tutorial/test_sql_databases/test_testing_databases.py b/tests/test_tutorial/test_sql_databases/test_testing_databases.py
deleted file mode 100644
index ce6ce230c..000000000
--- a/tests/test_tutorial/test_sql_databases/test_testing_databases.py
+++ /dev/null
@@ -1,27 +0,0 @@
-import importlib
-import os
-from pathlib import Path
-
-import pytest
-
-from ...utils import needs_pydanticv1
-
-
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_testing_dbs(tmp_path_factory: pytest.TempPathFactory):
- tmp_path = tmp_path_factory.mktemp("data")
- cwd = os.getcwd()
- os.chdir(tmp_path)
- test_db = Path("./test.db")
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- # Import while creating the client to create the DB after starting the test session
- from docs_src.sql_databases.sql_app.tests import test_sql_app
-
- # Ensure import side effects are re-executed
- importlib.reload(test_sql_app)
- test_sql_app.test_create_user()
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- os.chdir(cwd)
diff --git a/tests/test_tutorial/test_sql_databases/test_testing_databases_py310.py b/tests/test_tutorial/test_sql_databases/test_testing_databases_py310.py
deleted file mode 100644
index 545d63c2a..000000000
--- a/tests/test_tutorial/test_sql_databases/test_testing_databases_py310.py
+++ /dev/null
@@ -1,28 +0,0 @@
-import importlib
-import os
-from pathlib import Path
-
-import pytest
-
-from ...utils import needs_py310, needs_pydanticv1
-
-
-@needs_py310
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_testing_dbs_py39(tmp_path_factory: pytest.TempPathFactory):
- tmp_path = tmp_path_factory.mktemp("data")
- cwd = os.getcwd()
- os.chdir(tmp_path)
- test_db = Path("./test.db")
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- # Import while creating the client to create the DB after starting the test session
- from docs_src.sql_databases.sql_app_py310.tests import test_sql_app
-
- # Ensure import side effects are re-executed
- importlib.reload(test_sql_app)
- test_sql_app.test_create_user()
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- os.chdir(cwd)
diff --git a/tests/test_tutorial/test_sql_databases/test_testing_databases_py39.py b/tests/test_tutorial/test_sql_databases/test_testing_databases_py39.py
deleted file mode 100644
index 99bfd3fa8..000000000
--- a/tests/test_tutorial/test_sql_databases/test_testing_databases_py39.py
+++ /dev/null
@@ -1,28 +0,0 @@
-import importlib
-import os
-from pathlib import Path
-
-import pytest
-
-from ...utils import needs_py39, needs_pydanticv1
-
-
-@needs_py39
-# TODO: pv2 add version with Pydantic v2
-@needs_pydanticv1
-def test_testing_dbs_py39(tmp_path_factory: pytest.TempPathFactory):
- tmp_path = tmp_path_factory.mktemp("data")
- cwd = os.getcwd()
- os.chdir(tmp_path)
- test_db = Path("./test.db")
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- # Import while creating the client to create the DB after starting the test session
- from docs_src.sql_databases.sql_app_py39.tests import test_sql_app
-
- # Ensure import side effects are re-executed
- importlib.reload(test_sql_app)
- test_sql_app.test_create_user()
- if test_db.is_file(): # pragma: nocover
- test_db.unlink()
- os.chdir(cwd)
diff --git a/tests/test_tutorial/test_sql_databases/test_tutorial001.py b/tests/test_tutorial/test_sql_databases/test_tutorial001.py
new file mode 100644
index 000000000..cc7e590df
--- /dev/null
+++ b/tests/test_tutorial/test_sql_databases/test_tutorial001.py
@@ -0,0 +1,373 @@
+import importlib
+import warnings
+
+import pytest
+from dirty_equals import IsDict, IsInt
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+from sqlalchemy import StaticPool
+from sqlmodel import SQLModel, create_engine
+from sqlmodel.main import default_registry
+
+from tests.utils import needs_py39, needs_py310
+
+
+def clear_sqlmodel():
+ # Clear the tables in the metadata for the default base model
+ SQLModel.metadata.clear()
+ # Clear the Models associated with the registry, to avoid warnings
+ default_registry.dispose()
+
+
+@pytest.fixture(
+ name="client",
+ params=[
+ "tutorial001",
+ pytest.param("tutorial001_py39", marks=needs_py39),
+ pytest.param("tutorial001_py310", marks=needs_py310),
+ "tutorial001_an",
+ pytest.param("tutorial001_an_py39", marks=needs_py39),
+ pytest.param("tutorial001_an_py310", marks=needs_py310),
+ ],
+)
+def get_client(request: pytest.FixtureRequest):
+ clear_sqlmodel()
+ # TODO: remove when updating SQL tutorial to use new lifespan API
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ mod = importlib.import_module(f"docs_src.sql_databases.{request.param}")
+ clear_sqlmodel()
+ importlib.reload(mod)
+ mod.sqlite_url = "sqlite://"
+ mod.engine = create_engine(
+ mod.sqlite_url, connect_args={"check_same_thread": False}, poolclass=StaticPool
+ )
+
+ with TestClient(mod.app) as c:
+ yield c
+
+
+def test_crud_app(client: TestClient):
+ # TODO: this warns that SQLModel.from_orm is deprecated in Pydantic v1, refactor
+ # this if using obj.model_validate becomes independent of Pydantic v2
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ # No heroes before creating
+ response = client.get("heroes/")
+ assert response.status_code == 200, response.text
+ assert response.json() == []
+
+ # Create a hero
+ response = client.post(
+ "/heroes/",
+ json={
+ "id": 999,
+ "name": "Dead Pond",
+ "age": 30,
+ "secret_name": "Dive Wilson",
+ },
+ )
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {"age": 30, "secret_name": "Dive Wilson", "id": 999, "name": "Dead Pond"}
+ )
+
+ # Read a hero
+ hero_id = response.json()["id"]
+ response = client.get(f"/heroes/{hero_id}")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {"name": "Dead Pond", "age": 30, "id": 999, "secret_name": "Dive Wilson"}
+ )
+
+ # Read all heroes
+ # Create more heroes first
+ response = client.post(
+ "/heroes/",
+ json={"name": "Spider-Boy", "age": 18, "secret_name": "Pedro Parqueador"},
+ )
+ assert response.status_code == 200, response.text
+ response = client.post(
+ "/heroes/", json={"name": "Rusty-Man", "secret_name": "Tommy Sharp"}
+ )
+ assert response.status_code == 200, response.text
+
+ response = client.get("/heroes/")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ [
+ {
+ "name": "Dead Pond",
+ "age": 30,
+ "id": IsInt(),
+ "secret_name": "Dive Wilson",
+ },
+ {
+ "name": "Spider-Boy",
+ "age": 18,
+ "id": IsInt(),
+ "secret_name": "Pedro Parqueador",
+ },
+ {
+ "name": "Rusty-Man",
+ "age": None,
+ "id": IsInt(),
+ "secret_name": "Tommy Sharp",
+ },
+ ]
+ )
+
+ response = client.get("/heroes/?offset=1&limit=1")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ [
+ {
+ "name": "Spider-Boy",
+ "age": 18,
+ "id": IsInt(),
+ "secret_name": "Pedro Parqueador",
+ }
+ ]
+ )
+
+ # Delete a hero
+ response = client.delete(f"/heroes/{hero_id}")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot({"ok": True})
+
+ response = client.get(f"/heroes/{hero_id}")
+ assert response.status_code == 404, response.text
+
+ response = client.delete(f"/heroes/{hero_id}")
+ assert response.status_code == 404, response.text
+ assert response.json() == snapshot({"detail": "Hero not found"})
+
+
+def test_openapi_schema(client: TestClient):
+ response = client.get("/openapi.json")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {
+ "openapi": "3.1.0",
+ "info": {"title": "FastAPI", "version": "0.1.0"},
+ "paths": {
+ "/heroes/": {
+ "post": {
+ "summary": "Create Hero",
+ "operationId": "create_hero_heroes__post",
+ "requestBody": {
+ "required": True,
+ "content": {
+ "application/json": {
+ "schema": {"$ref": "#/components/schemas/Hero"}
+ }
+ },
+ },
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {
+ "application/json": {
+ "schema": {"$ref": "#/components/schemas/Hero"}
+ }
+ },
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ },
+ "get": {
+ "summary": "Read Heroes",
+ "operationId": "read_heroes_heroes__get",
+ "parameters": [
+ {
+ "name": "offset",
+ "in": "query",
+ "required": False,
+ "schema": {
+ "type": "integer",
+ "default": 0,
+ "title": "Offset",
+ },
+ },
+ {
+ "name": "limit",
+ "in": "query",
+ "required": False,
+ "schema": {
+ "type": "integer",
+ "maximum": 100,
+ "default": 100,
+ "title": "Limit",
+ },
+ },
+ ],
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Hero"
+ },
+ "title": "Response Read Heroes Heroes Get",
+ }
+ }
+ },
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ },
+ },
+ "/heroes/{hero_id}": {
+ "get": {
+ "summary": "Read Hero",
+ "operationId": "read_hero_heroes__hero_id__get",
+ "parameters": [
+ {
+ "name": "hero_id",
+ "in": "path",
+ "required": True,
+ "schema": {"type": "integer", "title": "Hero Id"},
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {
+ "application/json": {
+ "schema": {"$ref": "#/components/schemas/Hero"}
+ }
+ },
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ },
+ "delete": {
+ "summary": "Delete Hero",
+ "operationId": "delete_hero_heroes__hero_id__delete",
+ "parameters": [
+ {
+ "name": "hero_id",
+ "in": "path",
+ "required": True,
+ "schema": {"type": "integer", "title": "Hero Id"},
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ },
+ },
+ },
+ "components": {
+ "schemas": {
+ "HTTPValidationError": {
+ "properties": {
+ "detail": {
+ "items": {
+ "$ref": "#/components/schemas/ValidationError"
+ },
+ "type": "array",
+ "title": "Detail",
+ }
+ },
+ "type": "object",
+ "title": "HTTPValidationError",
+ },
+ "Hero": {
+ "properties": {
+ "id": IsDict(
+ {
+ "anyOf": [{"type": "integer"}, {"type": "null"}],
+ "title": "Id",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "integer",
+ "title": "Id",
+ }
+ ),
+ "name": {"type": "string", "title": "Name"},
+ "age": IsDict(
+ {
+ "anyOf": [{"type": "integer"}, {"type": "null"}],
+ "title": "Age",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "integer",
+ "title": "Age",
+ }
+ ),
+ "secret_name": {"type": "string", "title": "Secret Name"},
+ },
+ "type": "object",
+ "required": ["name", "secret_name"],
+ "title": "Hero",
+ },
+ "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",
+ },
+ }
+ },
+ }
+ )
diff --git a/tests/test_tutorial/test_sql_databases/test_tutorial002.py b/tests/test_tutorial/test_sql_databases/test_tutorial002.py
new file mode 100644
index 000000000..68c1966f5
--- /dev/null
+++ b/tests/test_tutorial/test_sql_databases/test_tutorial002.py
@@ -0,0 +1,481 @@
+import importlib
+import warnings
+
+import pytest
+from dirty_equals import IsDict, IsInt
+from fastapi.testclient import TestClient
+from inline_snapshot import snapshot
+from sqlalchemy import StaticPool
+from sqlmodel import SQLModel, create_engine
+from sqlmodel.main import default_registry
+
+from tests.utils import needs_py39, needs_py310
+
+
+def clear_sqlmodel():
+ # Clear the tables in the metadata for the default base model
+ SQLModel.metadata.clear()
+ # Clear the Models associated with the registry, to avoid warnings
+ default_registry.dispose()
+
+
+@pytest.fixture(
+ name="client",
+ params=[
+ "tutorial002",
+ pytest.param("tutorial002_py39", marks=needs_py39),
+ pytest.param("tutorial002_py310", marks=needs_py310),
+ "tutorial002_an",
+ pytest.param("tutorial002_an_py39", marks=needs_py39),
+ pytest.param("tutorial002_an_py310", marks=needs_py310),
+ ],
+)
+def get_client(request: pytest.FixtureRequest):
+ clear_sqlmodel()
+ # TODO: remove when updating SQL tutorial to use new lifespan API
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ mod = importlib.import_module(f"docs_src.sql_databases.{request.param}")
+ clear_sqlmodel()
+ importlib.reload(mod)
+ mod.sqlite_url = "sqlite://"
+ mod.engine = create_engine(
+ mod.sqlite_url, connect_args={"check_same_thread": False}, poolclass=StaticPool
+ )
+
+ with TestClient(mod.app) as c:
+ yield c
+
+
+def test_crud_app(client: TestClient):
+ # TODO: this warns that SQLModel.from_orm is deprecated in Pydantic v1, refactor
+ # this if using obj.model_validate becomes independent of Pydantic v2
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ # No heroes before creating
+ response = client.get("heroes/")
+ assert response.status_code == 200, response.text
+ assert response.json() == []
+
+ # Create a hero
+ response = client.post(
+ "/heroes/",
+ json={
+ "id": 9000,
+ "name": "Dead Pond",
+ "age": 30,
+ "secret_name": "Dive Wilson",
+ },
+ )
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {"age": 30, "id": IsInt(), "name": "Dead Pond"}
+ )
+ assert (
+ response.json()["id"] != 9000
+ ), "The ID should be generated by the database"
+
+ # Read a hero
+ hero_id = response.json()["id"]
+ response = client.get(f"/heroes/{hero_id}")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {"name": "Dead Pond", "age": 30, "id": IsInt()}
+ )
+
+ # Read all heroes
+ # Create more heroes first
+ response = client.post(
+ "/heroes/",
+ json={"name": "Spider-Boy", "age": 18, "secret_name": "Pedro Parqueador"},
+ )
+ assert response.status_code == 200, response.text
+ response = client.post(
+ "/heroes/", json={"name": "Rusty-Man", "secret_name": "Tommy Sharp"}
+ )
+ assert response.status_code == 200, response.text
+
+ response = client.get("/heroes/")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ [
+ {"name": "Dead Pond", "age": 30, "id": IsInt()},
+ {"name": "Spider-Boy", "age": 18, "id": IsInt()},
+ {"name": "Rusty-Man", "age": None, "id": IsInt()},
+ ]
+ )
+
+ response = client.get("/heroes/?offset=1&limit=1")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ [{"name": "Spider-Boy", "age": 18, "id": IsInt()}]
+ )
+
+ # Update a hero
+ response = client.patch(
+ f"/heroes/{hero_id}", json={"name": "Dog Pond", "age": None}
+ )
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {"name": "Dog Pond", "age": None, "id": hero_id}
+ )
+
+ # Get updated hero
+ response = client.get(f"/heroes/{hero_id}")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {"name": "Dog Pond", "age": None, "id": hero_id}
+ )
+
+ # Delete a hero
+ response = client.delete(f"/heroes/{hero_id}")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot({"ok": True})
+
+ # The hero is no longer found
+ response = client.get(f"/heroes/{hero_id}")
+ assert response.status_code == 404, response.text
+
+ # Delete a hero that does not exist
+ response = client.delete(f"/heroes/{hero_id}")
+ assert response.status_code == 404, response.text
+ assert response.json() == snapshot({"detail": "Hero not found"})
+
+ # Update a hero that does not exist
+ response = client.patch(f"/heroes/{hero_id}", json={"name": "Dog Pond"})
+ assert response.status_code == 404, response.text
+ assert response.json() == snapshot({"detail": "Hero not found"})
+
+
+def test_openapi_schema(client: TestClient):
+ response = client.get("/openapi.json")
+ assert response.status_code == 200, response.text
+ assert response.json() == snapshot(
+ {
+ "openapi": "3.1.0",
+ "info": {"title": "FastAPI", "version": "0.1.0"},
+ "paths": {
+ "/heroes/": {
+ "post": {
+ "summary": "Create Hero",
+ "operationId": "create_hero_heroes__post",
+ "requestBody": {
+ "required": True,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HeroCreate"
+ }
+ }
+ },
+ },
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HeroPublic"
+ }
+ }
+ },
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ },
+ "get": {
+ "summary": "Read Heroes",
+ "operationId": "read_heroes_heroes__get",
+ "parameters": [
+ {
+ "name": "offset",
+ "in": "query",
+ "required": False,
+ "schema": {
+ "type": "integer",
+ "default": 0,
+ "title": "Offset",
+ },
+ },
+ {
+ "name": "limit",
+ "in": "query",
+ "required": False,
+ "schema": {
+ "type": "integer",
+ "maximum": 100,
+ "default": 100,
+ "title": "Limit",
+ },
+ },
+ ],
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/HeroPublic"
+ },
+ "title": "Response Read Heroes Heroes Get",
+ }
+ }
+ },
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ },
+ },
+ "/heroes/{hero_id}": {
+ "get": {
+ "summary": "Read Hero",
+ "operationId": "read_hero_heroes__hero_id__get",
+ "parameters": [
+ {
+ "name": "hero_id",
+ "in": "path",
+ "required": True,
+ "schema": {"type": "integer", "title": "Hero Id"},
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HeroPublic"
+ }
+ }
+ },
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ },
+ "patch": {
+ "summary": "Update Hero",
+ "operationId": "update_hero_heroes__hero_id__patch",
+ "parameters": [
+ {
+ "name": "hero_id",
+ "in": "path",
+ "required": True,
+ "schema": {"type": "integer", "title": "Hero Id"},
+ }
+ ],
+ "requestBody": {
+ "required": True,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HeroUpdate"
+ }
+ }
+ },
+ },
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HeroPublic"
+ }
+ }
+ },
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ },
+ "delete": {
+ "summary": "Delete Hero",
+ "operationId": "delete_hero_heroes__hero_id__delete",
+ "parameters": [
+ {
+ "name": "hero_id",
+ "in": "path",
+ "required": True,
+ "schema": {"type": "integer", "title": "Hero Id"},
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {"application/json": {"schema": {}}},
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ },
+ },
+ },
+ },
+ },
+ },
+ "components": {
+ "schemas": {
+ "HTTPValidationError": {
+ "properties": {
+ "detail": {
+ "items": {
+ "$ref": "#/components/schemas/ValidationError"
+ },
+ "type": "array",
+ "title": "Detail",
+ }
+ },
+ "type": "object",
+ "title": "HTTPValidationError",
+ },
+ "HeroCreate": {
+ "properties": {
+ "name": {"type": "string", "title": "Name"},
+ "age": IsDict(
+ {
+ "anyOf": [{"type": "integer"}, {"type": "null"}],
+ "title": "Age",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "integer",
+ "title": "Age",
+ }
+ ),
+ "secret_name": {"type": "string", "title": "Secret Name"},
+ },
+ "type": "object",
+ "required": ["name", "secret_name"],
+ "title": "HeroCreate",
+ },
+ "HeroPublic": {
+ "properties": {
+ "name": {"type": "string", "title": "Name"},
+ "age": IsDict(
+ {
+ "anyOf": [{"type": "integer"}, {"type": "null"}],
+ "title": "Age",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "integer",
+ "title": "Age",
+ }
+ ),
+ "id": {"type": "integer", "title": "Id"},
+ },
+ "type": "object",
+ "required": ["name", "id"],
+ "title": "HeroPublic",
+ },
+ "HeroUpdate": {
+ "properties": {
+ "name": IsDict(
+ {
+ "anyOf": [{"type": "string"}, {"type": "null"}],
+ "title": "Name",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "string",
+ "title": "Name",
+ }
+ ),
+ "age": IsDict(
+ {
+ "anyOf": [{"type": "integer"}, {"type": "null"}],
+ "title": "Age",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "integer",
+ "title": "Age",
+ }
+ ),
+ "secret_name": IsDict(
+ {
+ "anyOf": [{"type": "string"}, {"type": "null"}],
+ "title": "Secret Name",
+ }
+ )
+ | IsDict(
+ # TODO: remove when deprecating Pydantic v1
+ {
+ "type": "string",
+ "title": "Secret Name",
+ }
+ ),
+ },
+ "type": "object",
+ "title": "HeroUpdate",
+ },
+ "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",
+ },
+ }
+ },
+ }
+ )
From dbb4a91e121317da6e53e1c06aa02170c40cf78c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 9 Oct 2024 19:45:08 +0000
Subject: [PATCH 142/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e34fd0df9..819d4b327 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Docs
+* ✨ Add new tutorial for SQL databases with SQLModel. PR [#12285](https://github.com/fastapi/fastapi/pull/12285) by [@tiangolo](https://github.com/tiangolo).
* 📝 Add External Link: How to profile a FastAPI asynchronous request. PR [#12389](https://github.com/fastapi/fastapi/pull/12389) by [@brouberol](https://github.com/brouberol).
* 🔧 Remove `base_path` for `mdx_include` Markdown extension in MkDocs. PR [#12391](https://github.com/fastapi/fastapi/pull/12391) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update link to Swagger UI configuration docs. PR [#12264](https://github.com/fastapi/fastapi/pull/12264) by [@makisukurisu](https://github.com/makisukurisu).
From 104dc0b8d86cb57165da919bc8cec2e225f6b61c Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
<66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Wed, 9 Oct 2024 22:11:46 +0200
Subject: [PATCH 143/504] =?UTF-8?q?=E2=AC=86=20[pre-commit.ci]=20pre-commi?=
=?UTF-8?q?t=20autoupdate=20(#12396)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
updates:
- [github.com/pre-commit/pre-commit-hooks: v4.6.0 → v5.0.0](https://github.com/pre-commit/pre-commit-hooks/compare/v4.6.0...v5.0.0)
- [github.com/astral-sh/ruff-pre-commit: v0.6.8 → v0.6.9](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.8...v0.6.9)
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
.pre-commit-config.yaml | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 48a7d495c..a62acccfe 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -4,7 +4,7 @@ default_language_version:
python: python3.10
repos:
- repo: https://github.com/pre-commit/pre-commit-hooks
- rev: v4.6.0
+ rev: v5.0.0
hooks:
- id: check-added-large-files
- id: check-toml
@@ -14,7 +14,7 @@ repos:
- id: end-of-file-fixer
- id: trailing-whitespace
- repo: https://github.com/astral-sh/ruff-pre-commit
- rev: v0.6.8
+ rev: v0.6.9
hooks:
- id: ruff
args:
From 529155e72e196f82e0289f173a185e8ddb2888ce Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 9 Oct 2024 20:12:15 +0000
Subject: [PATCH 144/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 819d4b327..4fe600ed4 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -40,6 +40,7 @@ hide:
### Internal
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12396](https://github.com/fastapi/fastapi/pull/12396) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* 🔨 Add script to generate variants of files. PR [#12405](https://github.com/fastapi/fastapi/pull/12405) by [@tiangolo](https://github.com/tiangolo).
* 🔧 Add speakeasy-api to `sponsors_badge.yml`. PR [#12404](https://github.com/fastapi/fastapi/pull/12404) by [@tiangolo](https://github.com/tiangolo).
* ➕ Add docs dependency: markdown-include-variants. PR [#12399](https://github.com/fastapi/fastapi/pull/12399) by [@tiangolo](https://github.com/tiangolo).
From 8ae4603d680f86ae1e5f96e58546dee4f543171f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jos=C3=A9=20Pacheco?= <pachewise@gmail.com>
Date: Sat, 12 Oct 2024 05:36:32 -0400
Subject: [PATCH 145/504] =?UTF-8?q?=F0=9F=90=9B=20Remove=20`Required`=20sh?=
=?UTF-8?q?adowing=20from=20fastapi=20using=20Pydantic=20v2=20(#12197)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Sofie Van Landeghem <svlandeg@users.noreply.github.com>
---
.../query_params_str_validations/tutorial006d.py | 3 +--
.../tutorial006d_an.py | 3 +--
.../tutorial006d_an_py39.py | 3 +--
fastapi/_compat.py | 9 +++++----
fastapi/dependencies/utils.py | 14 ++++++++------
5 files changed, 16 insertions(+), 16 deletions(-)
diff --git a/docs_src/query_params_str_validations/tutorial006d.py b/docs_src/query_params_str_validations/tutorial006d.py
index 42c5bf4eb..a8d69c889 100644
--- a/docs_src/query_params_str_validations/tutorial006d.py
+++ b/docs_src/query_params_str_validations/tutorial006d.py
@@ -1,11 +1,10 @@
from fastapi import FastAPI, Query
-from pydantic import Required
app = FastAPI()
@app.get("/items/")
-async def read_items(q: str = Query(default=Required, min_length=3)):
+async def read_items(q: str = Query(default=..., min_length=3)):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
diff --git a/docs_src/query_params_str_validations/tutorial006d_an.py b/docs_src/query_params_str_validations/tutorial006d_an.py
index bc8283e15..ea3b02583 100644
--- a/docs_src/query_params_str_validations/tutorial006d_an.py
+++ b/docs_src/query_params_str_validations/tutorial006d_an.py
@@ -1,12 +1,11 @@
from fastapi import FastAPI, Query
-from pydantic import Required
from typing_extensions import Annotated
app = FastAPI()
@app.get("/items/")
-async def read_items(q: Annotated[str, Query(min_length=3)] = Required):
+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})
diff --git a/docs_src/query_params_str_validations/tutorial006d_an_py39.py b/docs_src/query_params_str_validations/tutorial006d_an_py39.py
index 035d9e3bd..687a9f544 100644
--- a/docs_src/query_params_str_validations/tutorial006d_an_py39.py
+++ b/docs_src/query_params_str_validations/tutorial006d_an_py39.py
@@ -1,13 +1,12 @@
from typing import Annotated
from fastapi import FastAPI, Query
-from pydantic import Required
app = FastAPI()
@app.get("/items/")
-async def read_items(q: Annotated[str, Query(min_length=3)] = Required):
+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})
diff --git a/fastapi/_compat.py b/fastapi/_compat.py
index 4b07b44fa..56c5d744e 100644
--- a/fastapi/_compat.py
+++ b/fastapi/_compat.py
@@ -71,7 +71,7 @@ if PYDANTIC_V2:
general_plain_validator_function as with_info_plain_validator_function, # noqa: F401
)
- Required = PydanticUndefined
+ RequiredParam = PydanticUndefined
Undefined = PydanticUndefined
UndefinedType = PydanticUndefinedType
evaluate_forwardref = eval_type_lenient
@@ -313,9 +313,10 @@ else:
from pydantic.fields import ( # type: ignore[no-redef,attr-defined]
ModelField as ModelField, # noqa: F401
)
- from pydantic.fields import ( # type: ignore[no-redef,attr-defined]
- Required as Required, # noqa: F401
- )
+
+ # Keeping old "Required" functionality from Pydantic V1, without
+ # shadowing typing.Required.
+ RequiredParam: Any = Ellipsis # type: ignore[no-redef]
from pydantic.fields import ( # type: ignore[no-redef,attr-defined]
Undefined as Undefined,
)
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 813c74620..87653c80d 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -24,7 +24,7 @@ from fastapi._compat import (
PYDANTIC_V2,
ErrorWrapper,
ModelField,
- Required,
+ RequiredParam,
Undefined,
_regenerate_error_with_loc,
copy_field_info,
@@ -377,7 +377,9 @@ def analyze_param(
field_info = copy_field_info(
field_info=fastapi_annotation, annotation=use_annotation
)
- assert field_info.default is Undefined or field_info.default is Required, (
+ assert (
+ field_info.default is Undefined or field_info.default is RequiredParam
+ ), (
f"`{field_info.__class__.__name__}` default value cannot be set in"
f" `Annotated` for {param_name!r}. Set the default value with `=` instead."
)
@@ -385,7 +387,7 @@ def analyze_param(
assert not is_path_param, "Path parameters cannot have default values"
field_info.default = value
else:
- field_info.default = Required
+ field_info.default = RequiredParam
# Get Annotated Depends
elif isinstance(fastapi_annotation, params.Depends):
depends = fastapi_annotation
@@ -434,9 +436,9 @@ def analyze_param(
), f"Cannot specify FastAPI annotation for type {type_annotation!r}"
# Handle default assignations, neither field_info nor depends was not found in Annotated nor default value
elif field_info is None and depends is None:
- default_value = value if value is not inspect.Signature.empty else Required
+ default_value = value if value is not inspect.Signature.empty else RequiredParam
if is_path_param:
- # We might check here that `default_value is Required`, but the fact is that the same
+ # We might check here that `default_value is RequiredParam`, but the fact is that the same
# parameter might sometimes be a path parameter and sometimes not. See
# `tests/test_infer_param_optionality.py` for an example.
field_info = params.Path(annotation=use_annotation)
@@ -480,7 +482,7 @@ def analyze_param(
type_=use_annotation_from_field_info,
default=field_info.default,
alias=alias,
- required=field_info.default in (Required, Undefined),
+ required=field_info.default in (RequiredParam, Undefined),
field_info=field_info,
)
if is_path_param:
From b29cf1621a9b9046ff68cf21c67f96953bc8feeb Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 12 Oct 2024 09:36:55 +0000
Subject: [PATCH 146/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4fe600ed4..d070a84a3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Fixes
+
+* 🐛 Remove `Required` shadowing from fastapi using Pydantic v2. PR [#12197](https://github.com/fastapi/fastapi/pull/12197) by [@pachewise](https://github.com/pachewise).
+
### Refactors
* ♻️ Update type annotations for improved `python-multipart`. PR [#12407](https://github.com/fastapi/fastapi/pull/12407) by [@tiangolo](https://github.com/tiangolo).
From e049fc4ea15a7b844326efa545a7e370713f6612 Mon Sep 17 00:00:00 2001
From: Felix Fanghaenel <35657654+flxdot@users.noreply.github.com>
Date: Sat, 12 Oct 2024 11:44:57 +0200
Subject: [PATCH 147/504] =?UTF-8?q?=F0=9F=90=9B=20Fix=20openapi=20generati?=
=?UTF-8?q?on=20with=20responses=20kwarg=20(#10895)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Co-authored-by: flxdot <felix.fanghaenel@nitrex.com>
Co-authored-by: Sofie Van Landeghem <svlandeg@users.noreply.github.com>
Co-authored-by: Sławek Ehlert <slawomir.ehlert@gmail.com>
---
fastapi/routing.py | 4 ++-
tests/test_computed_fields.py | 27 ++++++++++++--
...t_openapi_separate_input_output_schemas.py | 36 ++++++++++++++++---
3 files changed, 59 insertions(+), 8 deletions(-)
diff --git a/fastapi/routing.py b/fastapi/routing.py
index 86e303602..8ea4bb219 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -541,7 +541,9 @@ class APIRoute(routing.Route):
additional_status_code
), f"Status code {additional_status_code} must not have a response body"
response_name = f"Response_{additional_status_code}_{self.unique_id}"
- response_field = create_model_field(name=response_name, type_=model)
+ response_field = create_model_field(
+ name=response_name, type_=model, mode="serialization"
+ )
response_fields[additional_status_code] = response_field
if response_fields:
self.response_fields: Dict[Union[int, str], ModelField] = response_fields
diff --git a/tests/test_computed_fields.py b/tests/test_computed_fields.py
index 5286507b2..a1b412168 100644
--- a/tests/test_computed_fields.py
+++ b/tests/test_computed_fields.py
@@ -24,13 +24,18 @@ def get_client():
def read_root() -> Rectangle:
return Rectangle(width=3, length=4)
+ @app.get("/responses", responses={200: {"model": Rectangle}})
+ def read_responses() -> Rectangle:
+ return Rectangle(width=3, length=4)
+
client = TestClient(app)
return client
+@pytest.mark.parametrize("path", ["/", "/responses"])
@needs_pydanticv2
-def test_get(client: TestClient):
- response = client.get("/")
+def test_get(client: TestClient, path: str):
+ response = client.get(path)
assert response.status_code == 200, response.text
assert response.json() == {"width": 3, "length": 4, "area": 12}
@@ -58,7 +63,23 @@ def test_openapi_schema(client: TestClient):
}
},
}
- }
+ },
+ "/responses": {
+ "get": {
+ "summary": "Read Responses",
+ "operationId": "read_responses_responses_get",
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {
+ "application/json": {
+ "schema": {"$ref": "#/components/schemas/Rectangle"}
+ }
+ },
+ }
+ },
+ }
+ },
},
"components": {
"schemas": {
diff --git a/tests/test_openapi_separate_input_output_schemas.py b/tests/test_openapi_separate_input_output_schemas.py
index aeb85f735..f7e045259 100644
--- a/tests/test_openapi_separate_input_output_schemas.py
+++ b/tests/test_openapi_separate_input_output_schemas.py
@@ -26,8 +26,8 @@ class Item(BaseModel):
def get_app_client(separate_input_output_schemas: bool = True) -> TestClient:
app = FastAPI(separate_input_output_schemas=separate_input_output_schemas)
- @app.post("/items/")
- def create_item(item: Item):
+ @app.post("/items/", responses={402: {"model": Item}})
+ def create_item(item: Item) -> Item:
return item
@app.post("/items-list/")
@@ -174,7 +174,23 @@ def test_openapi_schema():
"responses": {
"200": {
"description": "Successful Response",
- "content": {"application/json": {"schema": {}}},
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Item-Output"
+ }
+ }
+ },
+ },
+ "402": {
+ "description": "Payment Required",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Item-Output"
+ }
+ }
+ },
},
"422": {
"description": "Validation Error",
@@ -374,7 +390,19 @@ def test_openapi_schema_no_separate():
"responses": {
"200": {
"description": "Successful Response",
- "content": {"application/json": {"schema": {}}},
+ "content": {
+ "application/json": {
+ "schema": {"$ref": "#/components/schemas/Item"}
+ }
+ },
+ },
+ "402": {
+ "description": "Payment Required",
+ "content": {
+ "application/json": {
+ "schema": {"$ref": "#/components/schemas/Item"}
+ }
+ },
},
"422": {
"description": "Validation Error",
From f0be7686468229a7c9aa49c0c2cfff754c81dbdc Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 12 Oct 2024 09:45:17 +0000
Subject: [PATCH 148/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d070a84a3..07035bf94 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Fixes
+* 🐛 Fix openapi generation with responses kwarg. PR [#10895](https://github.com/fastapi/fastapi/pull/10895) by [@flxdot](https://github.com/flxdot).
* 🐛 Remove `Required` shadowing from fastapi using Pydantic v2. PR [#12197](https://github.com/fastapi/fastapi/pull/12197) by [@pachewise](https://github.com/pachewise).
### Refactors
From 113da5b0a7f33be300b7fea8dddbe51ee7b96157 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 12 Oct 2024 11:51:09 +0200
Subject: [PATCH 149/504] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
=?UTF-8?q?5.1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 2 ++
fastapi/__init__.py | 2 +-
2 files changed, 3 insertions(+), 1 deletion(-)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 07035bf94..4843370e7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
## Latest Changes
+## 0.115.1
+
### Fixes
* 🐛 Fix openapi generation with responses kwarg. PR [#10895](https://github.com/fastapi/fastapi/pull/10895) by [@flxdot](https://github.com/flxdot).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 7dd74c28f..09c8074ed 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
"""FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
-__version__ = "0.115.0"
+__version__ = "0.115.1"
from starlette import status as status
From b77f2351d1561c0e9599205c3faaaed7b52c24fc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 12 Oct 2024 11:59:01 +0200
Subject: [PATCH 150/504] =?UTF-8?q?=E2=AC=86=EF=B8=8F=20Upgrade=20Starlett?=
=?UTF-8?q?e=20to=20`>=3D0.37.2,<0.41.0`=20(#12431)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
pyproject.toml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/pyproject.toml b/pyproject.toml
index 1be2817a1..c934356d8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -41,7 +41,7 @@ classifiers = [
"Topic :: Internet :: WWW/HTTP",
]
dependencies = [
- "starlette>=0.37.2,<0.39.0",
+ "starlette>=0.37.2,<0.41.0",
"pydantic>=1.7.4,!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0",
"typing-extensions>=4.8.0",
]
From 63c428fbf9363aaad0e967d30f8b199f5dc23e39 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 12 Oct 2024 09:59:23 +0000
Subject: [PATCH 151/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4843370e7..780f41ed3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Upgrades
+
+* ⬆️ Upgrade Starlette to `>=0.37.2,<0.41.0`. PR [#12431](https://github.com/fastapi/fastapi/pull/12431) by [@tiangolo](https://github.com/tiangolo).
+
## 0.115.1
### Fixes
From 07684aea793d042fb5a12dde46dfe6d1e2196725 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 12 Oct 2024 12:00:47 +0200
Subject: [PATCH 152/504] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
=?UTF-8?q?5.2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 2 ++
fastapi/__init__.py | 2 +-
2 files changed, 3 insertions(+), 1 deletion(-)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 780f41ed3..3ba765b08 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
## Latest Changes
+## 0.115.2
+
### Upgrades
* ⬆️ Upgrade Starlette to `>=0.37.2,<0.41.0`. PR [#12431](https://github.com/fastapi/fastapi/pull/12431) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 09c8074ed..77b52f35b 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
"""FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
-__version__ = "0.115.1"
+__version__ = "0.115.2"
from starlette import status as status
From 91672fb9edf4a504a0106b5396f9be16ffbf40b1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Oct 2024 12:29:31 +0200
Subject: [PATCH 153/504] =?UTF-8?q?=E2=AC=86=20Update=20httpx=20requiremen?=
=?UTF-8?q?t=20from=20<0.25.0,>=3D0.23.0=20to=20>=3D0.23.0,<0.28.0=20(#115?=
=?UTF-8?q?09)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Updates the requirements on [httpx](https://github.com/encode/httpx) to permit the latest version.
- [Release notes](https://github.com/encode/httpx/releases)
- [Changelog](https://github.com/encode/httpx/blob/master/CHANGELOG.md)
- [Commits](https://github.com/encode/httpx/compare/0.23.0...0.27.0)
---
updated-dependencies:
- dependency-name: httpx
dependency-type: direct:production
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
requirements-docs-tests.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/requirements-docs-tests.txt b/requirements-docs-tests.txt
index 40b956e51..331d2a5b3 100644
--- a/requirements-docs-tests.txt
+++ b/requirements-docs-tests.txt
@@ -1,4 +1,4 @@
# For mkdocstrings and tests
-httpx >=0.23.0,<0.25.0
+httpx >=0.23.0,<0.28.0
# For linting and generating docs versions
ruff ==0.6.4
From 3347f0dde58899e9d934b9f25fcd4f0120a002da Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 12 Oct 2024 10:29:52 +0000
Subject: [PATCH 154/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3ba765b08..90e45367b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Internal
+
+* ⬆ Update httpx requirement from <0.25.0,>=0.23.0 to >=0.23.0,<0.28.0. PR [#11509](https://github.com/fastapi/fastapi/pull/11509) by [@dependabot[bot]](https://github.com/apps/dependabot).
+
## 0.115.2
### Upgrades
From a30eb6f5179974f8e6a809a94094f04a787d5aa7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 12 Oct 2024 14:27:19 +0200
Subject: [PATCH 155/504] =?UTF-8?q?=F0=9F=91=B7=20Use=20uv=20in=20CI=20(#1?=
=?UTF-8?q?2281)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/workflows/build-docs.yml | 40 +++++++++-------
.github/workflows/deploy-docs.yml | 18 ++++---
.github/workflows/label-approved.yml | 21 ++++++++-
.github/workflows/notify-translations.yml | 16 +++++++
.github/workflows/smokeshow.yml | 16 +++++--
.github/workflows/test.yml | 57 +++++++++++++----------
requirements-github-actions.txt | 1 +
7 files changed, 115 insertions(+), 54 deletions(-)
diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
index 52c34a49e..dd11727c7 100644
--- a/.github/workflows/build-docs.yml
+++ b/.github/workflows/build-docs.yml
@@ -7,6 +7,10 @@ on:
types:
- opened
- synchronize
+
+env:
+ UV_SYSTEM_PYTHON: 1
+
jobs:
changes:
runs-on: ubuntu-latest
@@ -48,18 +52,20 @@ jobs:
uses: actions/setup-python@v5
with:
python-version: "3.11"
- - uses: actions/cache@v4
- id: cache
+ - name: Setup uv
+ uses: astral-sh/setup-uv@v3
with:
- path: ${{ env.pythonLocation }}
- key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt', 'requirements-docs-insiders.txt', 'requirements-docs-tests.txt') }}-v08
+ version: "0.4.15"
+ enable-cache: true
+ cache-dependency-glob: |
+ requirements**.txt
+ pyproject.toml
- name: Install docs extras
- if: steps.cache.outputs.cache-hit != 'true'
- run: pip install -r requirements-docs.txt
+ run: uv pip install -r requirements-docs.txt
# Install MkDocs Material Insiders here just to put it in the cache for the rest of the steps
- name: Install Material for MkDocs Insiders
- if: ( github.event_name != 'pull_request' || github.secret_source == 'Actions' ) && steps.cache.outputs.cache-hit != 'true'
- run: pip install -r requirements-docs-insiders.txt
+ if: ( github.event_name != 'pull_request' || github.secret_source == 'Actions' )
+ run: uv pip install -r requirements-docs-insiders.txt
env:
TOKEN: ${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}
- name: Verify Docs
@@ -88,17 +94,19 @@ jobs:
uses: actions/setup-python@v5
with:
python-version: "3.11"
- - uses: actions/cache@v4
- id: cache
+ - name: Setup uv
+ uses: astral-sh/setup-uv@v3
with:
- path: ${{ env.pythonLocation }}
- key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt', 'requirements-docs-insiders.txt', 'requirements-docs-tests.txt') }}-v08
+ version: "0.4.15"
+ enable-cache: true
+ cache-dependency-glob: |
+ requirements**.txt
+ pyproject.toml
- name: Install docs extras
- if: steps.cache.outputs.cache-hit != 'true'
- run: pip install -r requirements-docs.txt
+ run: uv pip install -r requirements-docs.txt
- name: Install Material for MkDocs Insiders
- if: ( github.event_name != 'pull_request' || github.secret_source == 'Actions' ) && steps.cache.outputs.cache-hit != 'true'
- run: pip install -r requirements-docs-insiders.txt
+ if: ( github.event_name != 'pull_request' || github.secret_source == 'Actions' )
+ run: uv pip install -r requirements-docs-insiders.txt
env:
TOKEN: ${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}
- name: Update Languages
diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index 22dc89dff..2fd46df6b 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -12,6 +12,9 @@ permissions:
pull-requests: write
statuses: write
+env:
+ UV_SYSTEM_PYTHON: 1
+
jobs:
deploy-docs:
runs-on: ubuntu-latest
@@ -25,21 +28,22 @@ jobs:
uses: actions/setup-python@v5
with:
python-version: "3.11"
- - uses: actions/cache@v4
- id: cache
+ - name: Setup uv
+ uses: astral-sh/setup-uv@v3
with:
- path: ${{ env.pythonLocation }}
- key: ${{ runner.os }}-python-github-actions-${{ env.pythonLocation }}-${{ hashFiles('requirements-github-actions.txt') }}-v01
+ version: "0.4.15"
+ enable-cache: true
+ cache-dependency-glob: |
+ requirements**.txt
+ pyproject.toml
- name: Install GitHub Actions dependencies
- if: steps.cache.outputs.cache-hit != 'true'
- run: pip install -r requirements-github-actions.txt
+ run: uv pip install -r requirements-github-actions.txt
- name: Deploy Docs Status Pending
run: python ./scripts/deploy_docs_status.py
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
COMMIT_SHA: ${{ github.event.workflow_run.head_sha }}
RUN_ID: ${{ github.run_id }}
-
- name: Clean site
run: |
rm -rf ./site
diff --git a/.github/workflows/label-approved.yml b/.github/workflows/label-approved.yml
index 0470fb606..e44584cf1 100644
--- a/.github/workflows/label-approved.yml
+++ b/.github/workflows/label-approved.yml
@@ -8,6 +8,9 @@ on:
permissions:
pull-requests: write
+env:
+ UV_SYSTEM_PYTHON: 1
+
jobs:
label-approved:
if: github.repository_owner == 'fastapi'
@@ -19,8 +22,22 @@ jobs:
run: echo "$GITHUB_CONTEXT"
- uses: docker://tiangolo/label-approved:0.0.4
with:
- token: ${{ secrets.GITHUB_TOKEN }}
- config: >
+ python-version: "3.11"
+ - name: Setup uv
+ uses: astral-sh/setup-uv@v3
+ with:
+ version: "0.4.15"
+ enable-cache: true
+ cache-dependency-glob: |
+ requirements**.txt
+ pyproject.toml
+ - name: Install GitHub Actions dependencies
+ run: uv pip install -r requirements-github-actions.txt
+ - name: Label Approved
+ run: python ./scripts/label_approved.py
+ env:
+ TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ CONFIG: >
{
"approved-1":
{
diff --git a/.github/workflows/notify-translations.yml b/.github/workflows/notify-translations.yml
index 4787f3ddd..98aa41e5a 100644
--- a/.github/workflows/notify-translations.yml
+++ b/.github/workflows/notify-translations.yml
@@ -18,6 +18,9 @@ on:
permissions:
discussions: write
+env:
+ UV_SYSTEM_PYTHON: 1
+
jobs:
notify-translations:
runs-on: ubuntu-latest
@@ -27,6 +30,19 @@ jobs:
GITHUB_CONTEXT: ${{ toJson(github) }}
run: echo "$GITHUB_CONTEXT"
- uses: actions/checkout@v4
+ - uses: actions/checkout@v4
+ - name: Set up Python
+ uses: actions/setup-python@v5
+ with:
+ python-version: "3.11"
+ - name: Setup uv
+ uses: astral-sh/setup-uv@v3
+ with:
+ version: "0.4.15"
+ enable-cache: true
+ cache-dependency-glob: |
+ requirements**.txt
+ pyproject.toml
# Allow debugging with tmate
- name: Setup tmate session
uses: mxschmitt/action-tmate@v3
diff --git a/.github/workflows/smokeshow.yml b/.github/workflows/smokeshow.yml
index d3a975df5..e9aa1093f 100644
--- a/.github/workflows/smokeshow.yml
+++ b/.github/workflows/smokeshow.yml
@@ -8,6 +8,9 @@ on:
permissions:
statuses: write
+env:
+ UV_SYSTEM_PYTHON: 1
+
jobs:
smokeshow:
if: ${{ github.event.workflow_run.conclusion == 'success' }}
@@ -21,16 +24,21 @@ jobs:
- uses: actions/setup-python@v5
with:
python-version: '3.9'
-
- - run: pip install smokeshow
-
+ - name: Setup uv
+ uses: astral-sh/setup-uv@v3
+ with:
+ version: "0.4.15"
+ enable-cache: true
+ cache-dependency-glob: |
+ requirements**.txt
+ pyproject.toml
+ - run: uv pip install -r requirements-github-actions.txt
- uses: actions/download-artifact@v4
with:
name: coverage-html
path: htmlcov
github-token: ${{ secrets.GITHUB_TOKEN }}
run-id: ${{ github.event.workflow_run.id }}
-
- run: smokeshow upload htmlcov
env:
SMOKESHOW_GITHUB_STATUS_DESCRIPTION: Coverage {coverage-percentage}
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index fb4b083c4..643037a12 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -12,6 +12,9 @@ on:
# cron every week on monday
- cron: "0 0 * * 1"
+env:
+ UV_SYSTEM_PYTHON: 1
+
jobs:
lint:
runs-on: ubuntu-latest
@@ -25,19 +28,18 @@ jobs:
uses: actions/setup-python@v5
with:
python-version: "3.11"
- # Issue ref: https://github.com/actions/setup-python/issues/436
- # cache: "pip"
- # cache-dependency-path: pyproject.toml
- - uses: actions/cache@v4
- id: cache
+ - name: Setup uv
+ uses: astral-sh/setup-uv@v3
with:
- path: ${{ env.pythonLocation }}
- key: ${{ runner.os }}-python-${{ env.pythonLocation }}-pydantic-v2-${{ hashFiles('pyproject.toml', 'requirements-tests.txt', 'requirements-docs-tests.txt') }}-test-v08
+ version: "0.4.15"
+ enable-cache: true
+ cache-dependency-glob: |
+ requirements**.txt
+ pyproject.toml
- name: Install Dependencies
- if: steps.cache.outputs.cache-hit != 'true'
- run: pip install -r requirements-tests.txt
+ run: uv pip install -r requirements-tests.txt
- name: Install Pydantic v2
- run: pip install --upgrade "pydantic>=2.0.2,<3.0.0"
+ run: uv pip install --upgrade "pydantic>=2.0.2,<3.0.0"
- name: Lint
run: bash scripts/lint.sh
@@ -63,23 +65,22 @@ jobs:
uses: actions/setup-python@v5
with:
python-version: ${{ matrix.python-version }}
- # Issue ref: https://github.com/actions/setup-python/issues/436
- # cache: "pip"
- # cache-dependency-path: pyproject.toml
- - uses: actions/cache@v4
- id: cache
+ - name: Setup uv
+ uses: astral-sh/setup-uv@v3
with:
- path: ${{ env.pythonLocation }}
- key: ${{ runner.os }}-python-${{ env.pythonLocation }}-${{ matrix.pydantic-version }}-${{ hashFiles('pyproject.toml', 'requirements-tests.txt', 'requirements-docs-tests.txt') }}-test-v08
+ version: "0.4.15"
+ enable-cache: true
+ cache-dependency-glob: |
+ requirements**.txt
+ pyproject.toml
- name: Install Dependencies
- if: steps.cache.outputs.cache-hit != 'true'
- run: pip install -r requirements-tests.txt
+ run: uv pip install -r requirements-tests.txt
- name: Install Pydantic v1
if: matrix.pydantic-version == 'pydantic-v1'
- run: pip install "pydantic>=1.10.0,<2.0.0"
+ run: uv pip install "pydantic>=1.10.0,<2.0.0"
- name: Install Pydantic v2
if: matrix.pydantic-version == 'pydantic-v2'
- run: pip install --upgrade "pydantic>=2.0.2,<3.0.0"
+ run: uv pip install --upgrade "pydantic>=2.0.2,<3.0.0"
- run: mkdir coverage
- name: Test
run: bash scripts/test.sh
@@ -105,16 +106,22 @@ jobs:
- uses: actions/setup-python@v5
with:
python-version: '3.8'
- # Issue ref: https://github.com/actions/setup-python/issues/436
- # cache: "pip"
- # cache-dependency-path: pyproject.toml
+ - name: Setup uv
+ uses: astral-sh/setup-uv@v3
+ with:
+ version: "0.4.15"
+ enable-cache: true
+ cache-dependency-glob: |
+ requirements**.txt
+ pyproject.toml
+ - name: Install Dependencies
+ run: uv pip install -r requirements-tests.txt
- name: Get coverage files
uses: actions/download-artifact@v4
with:
pattern: coverage-*
path: coverage
merge-multiple: true
- - run: pip install coverage[toml]
- run: ls -la coverage
- run: coverage combine coverage
- run: coverage report
diff --git a/requirements-github-actions.txt b/requirements-github-actions.txt
index 559dc06fb..a6dace544 100644
--- a/requirements-github-actions.txt
+++ b/requirements-github-actions.txt
@@ -2,3 +2,4 @@ PyGithub>=2.3.0,<3.0.0
pydantic>=2.5.3,<3.0.0
pydantic-settings>=2.1.0,<3.0.0
httpx>=0.27.0,<0.28.0
+smokeshow
From ac6c08c71f816cfa60502bd410deca75f0b580ae Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 12 Oct 2024 12:28:10 +0000
Subject: [PATCH 156/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 90e45367b..30f98970a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Internal
+* 👷 Use uv in CI. PR [#12281](https://github.com/fastapi/fastapi/pull/12281) by [@tiangolo](https://github.com/tiangolo).
* ⬆ Update httpx requirement from <0.25.0,>=0.23.0 to >=0.23.0,<0.28.0. PR [#11509](https://github.com/fastapi/fastapi/pull/11509) by [@dependabot[bot]](https://github.com/apps/dependabot).
## 0.115.2
From 495d90161bae81d7e037b6c7998a9ab6e89d58a6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 12 Oct 2024 15:47:46 +0200
Subject: [PATCH 157/504] =?UTF-8?q?=F0=9F=91=B7=20Fix=20smokeshow,=20check?=
=?UTF-8?q?out=20files=20on=20CI=20(#12434)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/workflows/smokeshow.yml | 1 +
1 file changed, 1 insertion(+)
diff --git a/.github/workflows/smokeshow.yml b/.github/workflows/smokeshow.yml
index e9aa1093f..daff8e244 100644
--- a/.github/workflows/smokeshow.yml
+++ b/.github/workflows/smokeshow.yml
@@ -21,6 +21,7 @@ jobs:
env:
GITHUB_CONTEXT: ${{ toJson(github) }}
run: echo "$GITHUB_CONTEXT"
+ - uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: '3.9'
From 84ef149f838ab932f4ade3f1adbe566cece1b4fb Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 12 Oct 2024 13:49:27 +0000
Subject: [PATCH 158/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 30f98970a..e0988f461 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Internal
+* 👷 Fix smokeshow, checkout files on CI. PR [#12434](https://github.com/fastapi/fastapi/pull/12434) by [@tiangolo](https://github.com/tiangolo).
* 👷 Use uv in CI. PR [#12281](https://github.com/fastapi/fastapi/pull/12281) by [@tiangolo](https://github.com/tiangolo).
* ⬆ Update httpx requirement from <0.25.0,>=0.23.0 to >=0.23.0,<0.28.0. PR [#11509](https://github.com/fastapi/fastapi/pull/11509) by [@dependabot[bot]](https://github.com/apps/dependabot).
From 6384f730f7e672d4cea8c951dfa9c9e8bb3481f9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 12 Oct 2024 15:58:30 +0200
Subject: [PATCH 159/504] =?UTF-8?q?=F0=9F=91=B7=20Refactor=20label-approve?=
=?UTF-8?q?d,=20make=20it=20an=20internal=20script=20instead=20of=20an=20e?=
=?UTF-8?q?xternal=20GitHub=20Action=20(#12280)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/workflows/label-approved.yml | 4 +-
scripts/label_approved.py | 60 ++++++++++++++++++++++++++++
2 files changed, 63 insertions(+), 1 deletion(-)
create mode 100644 scripts/label_approved.py
diff --git a/.github/workflows/label-approved.yml b/.github/workflows/label-approved.yml
index e44584cf1..11176bed8 100644
--- a/.github/workflows/label-approved.yml
+++ b/.github/workflows/label-approved.yml
@@ -20,7 +20,9 @@ jobs:
env:
GITHUB_CONTEXT: ${{ toJson(github) }}
run: echo "$GITHUB_CONTEXT"
- - uses: docker://tiangolo/label-approved:0.0.4
+ - uses: actions/checkout@v4
+ - name: Set up Python
+ uses: actions/setup-python@v5
with:
python-version: "3.11"
- name: Setup uv
diff --git a/scripts/label_approved.py b/scripts/label_approved.py
new file mode 100644
index 000000000..271444504
--- /dev/null
+++ b/scripts/label_approved.py
@@ -0,0 +1,60 @@
+import logging
+from typing import Literal
+
+from github import Github
+from github.PullRequestReview import PullRequestReview
+from pydantic import BaseModel, SecretStr
+from pydantic_settings import BaseSettings
+
+
+class LabelSettings(BaseModel):
+ await_label: str | None = None
+ number: int
+
+
+default_config = {"approved-2": LabelSettings(await_label="awaiting-review", number=2)}
+
+
+class Settings(BaseSettings):
+ github_repository: str
+ token: SecretStr
+ debug: bool | None = False
+ config: dict[str, LabelSettings] | Literal[""] = default_config
+
+
+settings = Settings()
+if settings.debug:
+ logging.basicConfig(level=logging.DEBUG)
+else:
+ logging.basicConfig(level=logging.INFO)
+logging.debug(f"Using config: {settings.json()}")
+g = Github(settings.token.get_secret_value())
+repo = g.get_repo(settings.github_repository)
+for pr in repo.get_pulls(state="open"):
+ logging.info(f"Checking PR: #{pr.number}")
+ pr_labels = list(pr.get_labels())
+ pr_label_by_name = {label.name: label for label in pr_labels}
+ reviews = list(pr.get_reviews())
+ review_by_user: dict[str, PullRequestReview] = {}
+ for review in reviews:
+ if review.user.login in review_by_user:
+ stored_review = review_by_user[review.user.login]
+ if review.submitted_at >= stored_review.submitted_at:
+ review_by_user[review.user.login] = review
+ else:
+ review_by_user[review.user.login] = review
+ approved_reviews = [
+ review for review in review_by_user.values() if review.state == "APPROVED"
+ ]
+ config = settings.config or default_config
+ for approved_label, conf in config.items():
+ logging.debug(f"Processing config: {conf.json()}")
+ if conf.await_label is None or (conf.await_label in pr_label_by_name):
+ logging.debug(f"Processable PR: {pr.number}")
+ if len(approved_reviews) >= conf.number:
+ logging.info(f"Adding label to PR: {pr.number}")
+ pr.add_to_labels(approved_label)
+ if conf.await_label:
+ logging.info(f"Removing label from PR: {pr.number}")
+ pr.remove_from_labels(conf.await_label)
+logging.info("Finished")
From 766a14ddff6d710d483ba8cd06c3e7d05bd459f0 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 12 Oct 2024 13:59:03 +0000
Subject: [PATCH 160/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e0988f461..f94faf4b7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Internal
+* 👷 Refactor label-approved, make it an internal script instead of an external GitHub Action. PR [#12280](https://github.com/fastapi/fastapi/pull/12280) by [@tiangolo](https://github.com/tiangolo).
* 👷 Fix smokeshow, checkout files on CI. PR [#12434](https://github.com/fastapi/fastapi/pull/12434) by [@tiangolo](https://github.com/tiangolo).
* 👷 Use uv in CI. PR [#12281](https://github.com/fastapi/fastapi/pull/12281) by [@tiangolo](https://github.com/tiangolo).
* ⬆ Update httpx requirement from <0.25.0,>=0.23.0 to >=0.23.0,<0.28.0. PR [#11509](https://github.com/fastapi/fastapi/pull/11509) by [@dependabot[bot]](https://github.com/apps/dependabot).
From b887d434dbe760db1f1989dd410c9624cb904d43 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Paulo=20Falc=C3=A3o?=
<72179636+Paulofalcao2002@users.noreply.github.com>
Date: Mon, 14 Oct 2024 06:15:24 -0300
Subject: [PATCH 161/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/response-cookies.md`=20(#?=
=?UTF-8?q?12417)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/advanced/response-cookies.md | 55 +++++++++++++++++++++++
1 file changed, 55 insertions(+)
create mode 100644 docs/pt/docs/advanced/response-cookies.md
diff --git a/docs/pt/docs/advanced/response-cookies.md b/docs/pt/docs/advanced/response-cookies.md
new file mode 100644
index 000000000..d0821b5b2
--- /dev/null
+++ b/docs/pt/docs/advanced/response-cookies.md
@@ -0,0 +1,55 @@
+# Cookies de Resposta
+
+## Usando um parâmetro `Response`
+
+Você pode declarar um parâmetro do tipo `Response` na sua *função de operação de rota*.
+
+E então você pode definir cookies nesse objeto de resposta *temporário*.
+
+```Python hl_lines="1 8-9"
+{!../../docs_src/response_cookies/tutorial002.py!}
+```
+
+Em seguida, você pode retornar qualquer objeto que precise, como normalmente faria (um `dict`, um modelo de banco de dados, etc).
+
+E se você declarou um `response_model`, ele ainda será usado para filtrar e converter o objeto que você retornou.
+
+**FastAPI** usará essa resposta *temporária* para extrair os cookies (também os cabeçalhos e código de status) e os colocará na resposta final que contém o valor que você retornou, filtrado por qualquer `response_model`.
+
+Você também pode declarar o parâmetro `Response` em dependências e definir cookies (e cabeçalhos) nelas.
+
+## Retornando uma `Response` diretamente
+
+Você também pode criar cookies ao retornar uma `Response` diretamente no seu código.
+
+Para fazer isso, você pode criar uma resposta como descrito em [Retornando uma Resposta Diretamente](response-directly.md){.internal-link target=_blank}.
+
+Então, defina os cookies nela e a retorne:
+
+```Python hl_lines="10-12"
+{!../../docs_src/response_cookies/tutorial001.py!}
+```
+
+/// tip | Dica
+
+Lembre-se de que se você retornar uma resposta diretamente em vez de usar o parâmetro `Response`, FastAPI a retornará diretamente.
+
+Portanto, você terá que garantir que seus dados sejam do tipo correto. E.g. será compatível com JSON se você estiver retornando um `JSONResponse`.
+
+E também que você não esteja enviando nenhum dado que deveria ter sido filtrado por um `response_model`.
+
+///
+
+### Mais informações
+
+/// note | "Detalhes Técnicos"
+
+Você também poderia usar `from starlette.responses import Response` ou `from starlette.responses import JSONResponse`.
+
+**FastAPI** fornece as mesmas `starlette.responses` em `fastapi.responses` apenas como uma conveniência para você, o desenvolvedor. Mas a maioria das respostas disponíveis vem diretamente do Starlette.
+
+E como o `Response` pode ser usado frequentemente para definir cabeçalhos e cookies, o **FastAPI** também o fornece em `fastapi.Response`.
+
+///
+
+Para ver todos os parâmetros e opções disponíveis, verifique a <a href="https://www.starlette.io/responses/#set-cookie" class="external-link" target="_blank">documentação no Starlette</a>.
From 0e4dc88bd7487c05d8269b6ae3bb0330614c5549 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 14 Oct 2024 09:15:46 +0000
Subject: [PATCH 162/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f94faf4b7..5e33cb95d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Translations
+
+* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/response-cookies.md`. PR [#12417](https://github.com/fastapi/fastapi/pull/12417) by [@Paulofalcao2002](https://github.com/Paulofalcao2002).
+
### Internal
* 👷 Refactor label-approved, make it an internal script instead of an external GitHub Action. PR [#12280](https://github.com/fastapi/fastapi/pull/12280) by [@tiangolo](https://github.com/tiangolo).
From d4e183da3f6a1476131cbd91948172fdfad8a993 Mon Sep 17 00:00:00 2001
From: Anderson Rocha <anderson-rocha@outlook.com>
Date: Mon, 14 Oct 2024 10:16:06 +0100
Subject: [PATCH 163/504] =?UTF-8?q?=20=F0=9F=8C=90=20Add=20Portuguese=20tr?=
=?UTF-8?q?anslation=20for=20`docs/pt/docs/tutorial/body-updates.md`=20(#1?=
=?UTF-8?q?2381)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/tutorial/body-updates.md | 204 ++++++++++++++++++++++++++
1 file changed, 204 insertions(+)
create mode 100644 docs/pt/docs/tutorial/body-updates.md
diff --git a/docs/pt/docs/tutorial/body-updates.md b/docs/pt/docs/tutorial/body-updates.md
new file mode 100644
index 000000000..1a0455c1c
--- /dev/null
+++ b/docs/pt/docs/tutorial/body-updates.md
@@ -0,0 +1,204 @@
+# Corpo - Atualizações
+
+## Atualização de dados existentes com `PUT`
+
+Para atualizar um item, você pode usar a operação <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT" class="external-link" target="_blank">HTTP `PUT`</a>.
+
+Você pode usar `jsonable_encoder` para converter os dados de entrada em dados que podem ser armazenados como JSON (por exemplo, com um banco de dados NoSQL). Por exemplo, convertendo `datetime` em `str`.
+
+//// tab | Python 3.10+
+
+```Python hl_lines="28-33"
+{!> ../../../docs_src/body_updates/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="30-35"
+{!> ../../../docs_src/body_updates/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="30-35"
+{!> ../../../docs_src/body_updates/tutorial001.py!}
+```
+
+////
+
+`PUT` é usado para receber dados que devem substituir os dados existentes.
+
+### Aviso sobre a substituição
+
+Isso significa que, se você quiser atualizar o item `bar` usando `PUT` com um corpo contendo:
+
+```Python
+{
+ "name": "Barz",
+ "price": 3,
+ "description": None,
+}
+```
+
+Como ele não inclui o atributo já armazenado `"tax": 20.2`, o modelo de entrada assumiria o valor padrão de `"tax": 10.5`.
+
+E os dados seriam salvos com esse "novo" `tax` de `10.5`.
+
+## Atualizações parciais com `PATCH`
+
+Você também pode usar a operação <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PATCH" class="external-link" target="_blank">HTTP `PATCH`</a> para *atualizar* parcialmente os dados.
+
+Isso significa que você pode enviar apenas os dados que deseja atualizar, deixando o restante intacto.
+
+/// note | Nota
+
+`PATCH` é menos comumente usado e conhecido do que `PUT`.
+
+E muitas equipes usam apenas `PUT`, mesmo para atualizações parciais.
+
+Você é **livre** para usá-los como preferir, **FastAPI** não impõe restrições.
+
+Mas este guia te dá uma ideia de como eles são destinados a serem usados.
+
+///
+
+### Usando o parâmetro `exclude_unset` do Pydantic
+
+Se você quiser receber atualizações parciais, é muito útil usar o parâmetro `exclude_unset` no método `.model_dump()` do modelo do Pydantic.
+
+Como `item.model_dump(exclude_unset=True)`.
+
+/// info | Informação
+
+No Pydantic v1, o método que era chamado `.dict()` e foi depreciado (mas ainda suportado) no Pydantic v2. Agora, deve-se usar o método `.model_dump()`.
+
+Os exemplos aqui usam `.dict()` para compatibilidade com o Pydantic v1, mas você deve usar `.model_dump()` a partir do Pydantic v2.
+
+///
+
+Isso gera um `dict` com apenas os dados definidos ao criar o modelo `item`, excluindo os valores padrão.
+
+Então, você pode usar isso para gerar um `dict` com apenas os dados definidos (enviados na solicitação), omitindo valores padrão:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="32"
+{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="34"
+{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="34"
+{!> ../../../docs_src/body_updates/tutorial002.py!}
+```
+
+////
+
+### Usando o parâmetro `update` do Pydantic
+
+Agora, você pode criar uma cópia do modelo existente usando `.model_copy()`, e passar o parâmetro `update` com um `dict` contendo os dados para atualizar.
+
+/// info | Informação
+
+No Pydantic v1, o método era chamado `.copy()`, ele foi depreciado (mas ainda suportado) no Pydantic v2, e renomeado para `.model_copy()`.
+
+Os exemplos aqui usam `.copy()` para compatibilidade com o Pydantic v1, mas você deve usar `.model_copy()` com o Pydantic v2.
+
+///
+
+Como `stored_item_model.model_copy(update=update_data)`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="33"
+{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="35"
+{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="35"
+{!> ../../../docs_src/body_updates/tutorial002.py!}
+```
+
+////
+
+### Recapitulando as atualizações parciais
+
+Resumindo, para aplicar atualizações parciais você pode:
+
+* (Opcionalmente) usar `PATCH` em vez de `PUT`.
+* Recuperar os dados armazenados.
+* Colocar esses dados em um modelo do Pydantic.
+* Gerar um `dict` sem valores padrão a partir do modelo de entrada (usando `exclude_unset`).
+ * Dessa forma, você pode atualizar apenas os valores definidos pelo usuário, em vez de substituir os valores já armazenados com valores padrão em seu modelo.
+* Criar uma cópia do modelo armazenado, atualizando seus atributos com as atualizações parciais recebidas (usando o parâmetro `update`).
+* Converter o modelo copiado em algo que possa ser armazenado no seu banco de dados (por exemplo, usando o `jsonable_encoder`).
+ * Isso é comparável ao uso do método `.model_dump()`, mas garante (e converte) os valores para tipos de dados que possam ser convertidos em JSON, por exemplo, `datetime` para `str`.
+* Salvar os dados no seu banco de dados.
+* Retornar o modelo atualizado.
+
+//// tab | Python 3.10+
+
+```Python hl_lines="28-35"
+{!> ../../../docs_src/body_updates/tutorial002_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="30-37"
+{!> ../../../docs_src/body_updates/tutorial002_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="30-37"
+{!> ../../../docs_src/body_updates/tutorial002.py!}
+```
+
+////
+
+/// tip | Dica
+
+Você pode realmente usar essa mesma técnica com uma operação HTTP `PUT`.
+
+Mas o exemplo aqui usa `PATCH` porque foi criado para esses casos de uso.
+
+///
+
+/// note | Nota
+
+Observe que o modelo de entrada ainda é validado.
+
+Portanto, se você quiser receber atualizações parciais que possam omitir todos os atributos, precisará ter um modelo com todos os atributos marcados como opcionais (com valores padrão ou `None`).
+
+Para distinguir os modelos com todos os valores opcionais para **atualizações** e modelos com valores obrigatórios para **criação**, você pode usar as ideias descritas em [Modelos Adicionais](extra-models.md){.internal-link target=_blank}.
+
+///
From 7358ed246e1dd722f5b6b376c6ba64883a4bd039 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 14 Oct 2024 09:17:01 +0000
Subject: [PATCH 164/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 5e33cb95d..75166bcd5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/body-updates.md`. PR [#12381](https://github.com/fastapi/fastapi/pull/12381) by [@andersonrocha0](https://github.com/andersonrocha0).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/response-cookies.md`. PR [#12417](https://github.com/fastapi/fastapi/pull/12417) by [@Paulofalcao2002](https://github.com/Paulofalcao2002).
### Internal
From 5f998ee55acbd344509a2775968d6bc703f141f6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 14 Oct 2024 12:51:58 +0200
Subject: [PATCH 165/504] =?UTF-8?q?=F0=9F=94=A7=20Update=20team,=20include?=
=?UTF-8?q?=20YuriiMotov=20=F0=9F=9A=80=20(#12453)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/data/members.yml | 3 +++
1 file changed, 3 insertions(+)
diff --git a/docs/en/data/members.yml b/docs/en/data/members.yml
index 0069f8c75..a3a6b912d 100644
--- a/docs/en/data/members.yml
+++ b/docs/en/data/members.yml
@@ -11,6 +11,9 @@ members:
- login: svlandeg
avatar_url: https://avatars.githubusercontent.com/u/8796347
url: https://github.com/svlandeg
+- login: YuriiMotov
+ avatar_url: https://avatars.githubusercontent.com/u/109919500
+ url: https://github.com/YuriiMotov
- login: estebanx64
avatar_url: https://avatars.githubusercontent.com/u/10840422
url: https://github.com/estebanx64
From 38f65c033f779b7f355661ea83c395d66c1bed7b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 14 Oct 2024 10:52:26 +0000
Subject: [PATCH 166/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 75166bcd5..08f1652f5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
### Internal
+* 🔧 Update team, include YuriiMotov 🚀. PR [#12453](https://github.com/fastapi/fastapi/pull/12453) by [@tiangolo](https://github.com/tiangolo).
* 👷 Refactor label-approved, make it an internal script instead of an external GitHub Action. PR [#12280](https://github.com/fastapi/fastapi/pull/12280) by [@tiangolo](https://github.com/tiangolo).
* 👷 Fix smokeshow, checkout files on CI. PR [#12434](https://github.com/fastapi/fastapi/pull/12434) by [@tiangolo](https://github.com/tiangolo).
* 👷 Use uv in CI. PR [#12281](https://github.com/fastapi/fastapi/pull/12281) by [@tiangolo](https://github.com/tiangolo).
From 7148584ac47697d50988a1cd0dad27991a29c036 Mon Sep 17 00:00:00 2001
From: Rafael de Oliveira Marques <rafaelomarques@gmail.com>
Date: Mon, 14 Oct 2024 11:57:32 -0300
Subject: [PATCH 167/504] =?UTF-8?q?=F0=9F=8C=90=20Remove=20Portuguese=20tr?=
=?UTF-8?q?anslation=20for=20`docs/pt/docs/deployment.md`=20(#12427)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/deployment.md | 414 -------------------------------------
1 file changed, 414 deletions(-)
delete mode 100644 docs/pt/docs/deployment.md
diff --git a/docs/pt/docs/deployment.md b/docs/pt/docs/deployment.md
deleted file mode 100644
index 6874a2529..000000000
--- a/docs/pt/docs/deployment.md
+++ /dev/null
@@ -1,414 +0,0 @@
-# Implantação
-
-Implantar uma aplicação **FastAPI** é relativamente fácil.
-
-Existem vários modos de realizar o _deploy_ dependendo de seu caso de uso específico e as ferramentas que você utiliza.
-
-Você verá mais sobre alguns modos de fazer o _deploy_ nas próximas seções.
-
-## Versões do FastAPI
-
-**FastAPI** já está sendo utilizado em produção em muitas aplicações e sistemas. E a cobertura de teste é mantida a 100%. Mas seu desenvolvimento continua andando rapidamente.
-
-Novos recursos são adicionados frequentemente, _bugs_ são corrigidos regularmente, e o código está continuamente melhorando.
-
-É por isso que as versões atuais estão ainda no `0.x.x`, isso reflete que cada versão poderia ter potencialmente alterações que podem quebrar. Isso segue as convenções de <a href="https://semver.org/" class="external-link" target="_blank">Versionamento Semântico</a>.
-
-Você pode criar aplicações para produção com **FastAPI** bem agora (e você provavelmente já faça isso por um tempo), você tem que ter certeza de utilizar uma versão que funcione corretamente com o resto do seu código.
-
-### Anote sua versão `fastapi`
-
-A primeira coisa que você deve fazer é "fixar" a versão do **FastAPI** que está utilizando para a última versão específica que você sabe que funciona corretamente para a sua aplicação.
-
-Por exemplo, vamos dizer que você esteja utilizando a versão `0.45.0` no seu _app_.
-
-Se você usa um arquivo `requirements.txt`, dá para especificar a versão assim:
-
-```txt
-fastapi==0.45.0
-```
-
-isso significa que você pode usar exatamente a versão `0.45.0`.
-
-Ou você poderia fixar assim:
-
-```txt
-fastapi>=0.45.0,<0.46.0
-```
-
-o que significa que você pode usar as versões `0.45.0` ou acima, mas menor que `0.46.0`. Por exemplo, a versão `0.45.2` poderia ser aceita.
-
-Se você usa qualquer outra ferramenta para gerenciar suas instalações, como Poetry, Pipenv ou outro, todos terão um modo que você possa usar para definir versões específicas para seus pacotes.
-
-### Versões disponíveis
-
-Você pode ver as versões disponíveis (por exemplo, para verificar qual é a versão atual) nas [Notas de Lançamento](release-notes.md){.internal-link target=_blank}.
-
-### Sobre as versões
-
-Seguindo as convenções do Versionamento Semântico, qualquer versão abaixo de `1.0.0` pode potencialmente adicionar mudanças que quebrem.
-
-FastAPI também segue a convenção que qualquer versão de _"PATCH"_ seja para ajustes de _bugs_ e mudanças que não quebrem a aplicação.
-
-/// tip
-
-O _"PATCH"_ é o último número, por exemplo, em `0.2.3`, a versão do _PATCH_ é `3`.
-
-///
-
-Então, você poderia ser capaz de fixar para uma versão como:
-
-```txt
-fastapi>=0.45.0,<0.46.0
-```
-
-Mudanças que quebram e novos recursos são adicionados em versões _"MINOR"_.
-
-/// tip
-
-O _"MINOR"_ é o número do meio, por exemplo, em `0.2.3`, a versão _MINOR_ é `2`.
-
-///
-
-### Atualizando as versões FastAPI
-
-Você pode adicionar testes em sua aplicação.
-
-Com o **FastAPI** é muito fácil (graças ao Starlette), verifique a documentação: [Testando](tutorial/testing.md){.internal-link target=_blank}
-
-Após você ter os testes, então você pode fazer o _upgrade_ da versão **FastAPI** para uma mais recente, e ter certeza que todo seu código esteja funcionando corretamente rodando seus testes.
-
-Se tudo estiver funcionando, ou após você fazer as alterações necessárias, e todos seus testes estiverem passando, então você poderá fixar o `fastapi` para a versão mais recente.
-
-### Sobre Starlette
-
-Você não deve fixar a versão do `starlette`.
-
-Versões diferentes do **FastAPI** irão utilizar uma versão mais nova específica do Starlette.
-
-Então, você pode deixar que o **FastAPI** use a versão correta do Starlette.
-
-### Sobre Pydantic
-
-Pydantic inclui os testes para **FastAPI** em seus próprios testes, então novas versões do Pydantic (acima de `1.0.0`) são sempre compatíveis com FastAPI.
-
-Você pode fixar o Pydantic para qualquer versão acima de `1.0.0` e abaixo de `2.0.0` que funcionará.
-
-Por exemplo:
-
-```txt
-pydantic>=1.2.0,<2.0.0
-```
-
-## Docker
-
-Nessa seção você verá instruções e _links_ para guias de saber como:
-
-* Fazer uma imagem/container da sua aplicação **FastAPI** com máxima performance. Em aproximadamente **5 min**.
-* (Opcionalmente) entender o que você, como desenvolvedor, precisa saber sobre HTTPS.
-* Inicializar um _cluster_ Docker Swarm Mode com HTTPS automático, mesmo em um simples servidor de $5 dólares/mês. Em aproximadamente **20 min**.
-* Gere e implante uma aplicação **FastAPI** completa, usando seu _cluster_ Docker Swarm, com HTTPS etc. Em aproxiamadamente **10 min**.
-
-Você pode usar <a href="https://www.docker.com/" class="external-link" target="_blank">**Docker**</a> para implantação. Ele tem várias vantagens como segurança, replicabilidade, desenvolvimento simplificado etc.
-
-Se você está usando Docker, você pode utilizar a imagem Docker oficial:
-
-### <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>
-
-Essa imagem tem um mecanismo incluído de "auto-ajuste", para que você possa apenas adicionar seu código e ter uma alta performance automaticamente. E sem fazer sacrifícios.
-
-Mas você pode ainda mudar e atualizar todas as configurações com variáveis de ambiente ou arquivos de configuração.
-
-/// tip
-
-Para ver todas as configurações e opções, vá para a página da imagem do Docker: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
-
-///
-
-### Crie um `Dockerfile`
-
-* Vá para o diretório de seu projeto.
-* Crie um `Dockerfile` com:
-
-```Dockerfile
-FROM tiangolo/uvicorn-gunicorn-fastapi:python3.7
-
-COPY ./app /app
-```
-
-#### Grandes aplicações
-
-Se você seguiu a seção sobre criação de [Grandes Aplicações com Múltiplos Arquivos](tutorial/bigger-applications.md){.internal-link target=_blank}, seu `Dockerfile` poderia parecer como:
-
-```Dockerfile
-FROM tiangolo/uvicorn-gunicorn-fastapi:python3.7
-
-COPY ./app /app/app
-```
-
-#### Raspberry Pi e outras arquiteturas
-
-Se você estiver rodando Docker em um Raspberry Pi (que possui um processador ARM) ou qualquer outra arquitetura, você pode criar um `Dockerfile` do zero, baseado em uma imagem base Python (que é multi-arquitetural) e utilizar Uvicorn sozinho.
-
-Nesse caso, seu `Dockerfile` poderia parecer assim:
-
-```Dockerfile
-FROM python:3.7
-
-RUN pip install fastapi uvicorn
-
-EXPOSE 80
-
-COPY ./app /app
-
-CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
-```
-
-### Crie o código **FastAPI**
-
-* Crie um diretório `app` e entre nele.
-* Crie um arquivo `main.py` com:
-
-```Python
-from fastapi import FastAPI
-
-app = FastAPI()
-
-
-@app.get("/")
-def read_root():
- return {"Hello": "World"}
-
-
-@app.get("/items/{item_id}")
-def read_item(item_id: int, q: str = None):
- return {"item_id": item_id, "q": q}
-```
-
-* Você deve ter uma estrutura de diretórios assim:
-
-```
-.
-├── app
-│ └── main.py
-└── Dockerfile
-```
-
-### Construa a imagem Docker
-
-* Vá para o diretório do projeto (onde seu `Dockerfile` está, contendo seu diretório `app`.
-* Construa sua imagem FastAPI:
-
-<div class="termy">
-
-```console
-$ docker build -t myimage .
-
----> 100%
-```
-
-</div>
-
-### Inicie o container Docker
-
-* Rode um container baseado em sua imagem:
-
-<div class="termy">
-
-```console
-$ docker run -d --name mycontainer -p 80:80 myimage
-```
-
-</div>
-
-Agora você tem um servidor FastAPI otimizado em um container Docker. Auto-ajustado para seu servidor atual (e número de núcleos de CPU).
-
-### Verifique
-
-Você deve ser capaz de verificar na URL de seu container Docker, por exemplo: <a href="http://192.168.99.100/items/5?q=somequery" class="external-link" target="_blank">http://192.168.99.100/items/5?q=somequery</a> ou <a href="http://127.0.0.1/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1/items/5?q=somequery</a> (ou equivalente, usando seu _host_ Docker).
-
-Você verá algo como:
-
-```JSON
-{"item_id": 5, "q": "somequery"}
-```
-
-### API interativa de documetação
-
-Agora você pode ir para <a href="http://192.168.99.100/docs" class="external-link" target="_blank">http://192.168.99.100/docs</a> ou <a href="http://127.0.0.1/docs" class="external-link" target="_blank">http://127.0.0.1/docs</a> (ou equivalente, usando seu _host_ Docker).
-
-Você verá a API interativa de documentação (fornecida por <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>):
-
-
-
-### APIs alternativas de documentação
-
-E você pode também ir para <a href="http://192.168.99.100/redoc" class="external-link" target="_blank">http://192.168.99.100/redoc</a> ou <a href="http://127.0.0.1/redoc" class="external-link" target="_blank">http://127.0.0.1/redoc</a> (ou equivalente, usando seu _host_ Docker).
-
-Você verá a documentação automática alternativa (fornecida por <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>):
-
-
-
-## HTTPS
-
-### Sobre HTTPS
-
-É fácil assumir que HTTPS seja algo que esteja apenas "habilitado" ou não.
-
-Mas ele é um pouquinho mais complexo do que isso.
-
-/// tip
-
-Se você está com pressa ou não se importa, continue na próxima seção com instruções passo a passo para configurar tudo.
-
-///
-
-Para aprender o básico de HTTPS, pela perspectiva de um consumidor, verifique <a href="https://howhttps.works/" class="external-link" target="_blank">https://howhttps.works/</a>.
-
-Agora, pela perspectiva de um desenvolvedor, aqui estão algumas coisas para se ter em mente enquanto se pensa sobre HTTPS:
-
-* Para HTTPS, o servidor precisa ter "certificados" gerados por terceiros.
- * Esses certificados são na verdade adquiridos por terceiros, não "gerados".
-* Certificados tem um prazo de uso.
- * Eles expiram.
- * E então eles precisam ser renovados, adquiridos novamente por terceiros.
-* A encriptação da conexão acontece no nível TCP.
- * TCP é uma camada abaixo do HTTP.
- * Então, o controle de certificado e encriptação é feito antes do HTTP.
-* TCP não conhece nada sobre "domínios". Somente sobre endereços IP.
- * A informação sobre o domínio requisitado vai nos dados HTTP.
-* Os certificados HTTPS "certificam" um certo domínio, mas o protocolo e a encriptação acontecem no nível TCP, antes de saber qual domínio está sendo lidado.
-* Por padrão, isso significa que você pode ter somente um certificado HTTPS por endereço IP.
- * Não importa quão grande é seu servidor ou quão pequena cada aplicação que você tenha possar ser.
- * No entanto, existe uma solução para isso.
-* Existe uma extensão para o protocolo TLS (o que controla a encriptação no nível TCP, antes do HTTP) chamada <a href="https://en.wikipedia.org/wiki/Server_Name_Indication" class="external-link" target="_blank"><abbr title="Server Name Indication">SNI</abbr></a>.
- * Essa extensão SNI permite um único servidor (com um único endereço IP) a ter vários certificados HTTPS e servir múltiplas aplicações/domínios HTTPS.
- * Para que isso funcione, um único componente (programa) rodando no servidor, ouvindo no endereço IP público, deve ter todos os certificados HTTPS no servidor.
-* Após obter uma conexão segura, o protocolo de comunicação ainda é HTTP.
- * O conteúdo está encriptado, mesmo embora ele esteja sendo enviado com o protocolo HTTP.
-
-É uma prática comum ter um servidor HTTP/programa rodando no servidor (a máquina, _host_ etc.) e gerenciar todas as partes HTTP: enviar as requisições HTTP decriptadas para a aplicação HTTP rodando no mesmo servidor (a aplicação **FastAPI**, nesse caso), pega a resposta HTTP da aplicação, encripta utilizando o certificado apropriado e enviando de volta para o cliente usando HTTPS. Esse servidor é frequentemente chamado <a href="https://en.wikipedia.org/wiki/TLS_termination_proxy" class="external-link" target="_blank">TLS _Termination Proxy_</a>.
-
-### Vamos encriptar
-
-Antes de encriptar, esses certificados HTTPS foram vendidos por terceiros de confiança.
-
-O processo para adquirir um desses certificados costumava ser chato, exigia muita papelada e eram bem caros.
-
-Mas então <a href="https://letsencrypt.org/" class="external-link" target="_blank">_Let's Encrypt_</a> foi criado.
-
-É um projeto da Fundação Linux.Ele fornece certificados HTTPS de graça. De um jeito automatizado. Esses certificados utilizam todos os padrões de segurança criptográfica, e tem vida curta (cerca de 3 meses), para que a segurança seja melhor devido ao seu curto período de vida.
-
-Os domínios são seguramente verificados e os certificados são gerados automaticamente. Isso também permite automatizar a renovação desses certificados.
-
-A idéia é automatizar a aquisição e renovação desses certificados, para que você possa ter um HTTPS seguro, grátis, para sempre.
-
-### Traefik
-
-<a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a> é um _proxy_ reverso / _load balancer_ de alta performance. Ele pode fazer o trabalho do _"TLS Termination Proxy"_ (à parte de outros recursos).
-
-Ele tem integração com _Let's Encrypt_. Assim, ele pode controlar todas as partes HTTPS, incluindo a aquisição e renovação de certificados.
-
-Ele também tem integrações com Docker. Assim, você pode declarar seus domínios em cada configuração de aplicação e leitura dessas configurações, gerando os certificados HTTPS e servindo o HTTPS para sua aplicação automaticamente, sem exigir qualquer mudança em sua configuração.
-
----
-
-Com essas ferramentas e informações, continue com a próxima seção para combinar tudo.
-
-## _Cluster_ de Docker Swarm Mode com Traefik e HTTPS
-
-Você pode ter um _cluster_ de Docker Swarm Mode configurado em minutos (cerca de 20) com o Traefik controlando HTTPS (incluindo aquisição e renovação de certificados).
-
-Utilizando o Docker Swarm Mode, você pode iniciar com um _"cluster"_ de apenas uma máquina (que pode até ser um servidor por 5 dólares / mês) e então você pode aumentar conforme a necessidade adicionando mais servidores.
-
-Para configurar um _cluster_ Docker Swarm Mode com Traefik controlando HTTPS, siga essa orientação:
-
-### <a href="https://medium.com/@tiangolo/docker-swarm-mode-and-traefik-for-a-https-cluster-20328dba6232" class="external-link" target="_blank">Docker Swarm Mode and Traefik for an HTTPS cluster</a>
-
-### Faça o _deploy_ de uma aplicação FastAPI
-
-O jeito mais fácil de configurar tudo pode ser utilizando o [Gerador de Projetos **FastAPI**](project-generation.md){.internal-link target=_blank}.
-
-Ele é designado para ser integrado com esse _cluster_ Docker Swarm com Traefik e HTTPS descrito acima.
-
-Você pode gerar um projeto em cerca de 2 minutos.
-
-O projeto gerado tem instruções para fazer o _deploy_, fazendo isso leva outros 2 minutos.
-
-## Alternativamente, faça o _deploy_ **FastAPI** sem Docker
-
-Você pode fazer o _deploy_ do **FastAPI** diretamente sem o Docker também.
-
-Você apenas precisa instalar um servidor ASGI compatível como:
-
-//// tab | Uvicorn
-
-* <a href="https://www.uvicorn.org/" class="external-link" target="_blank">Uvicorn</a>, um servidor ASGI peso leve, construído sobre uvloop e httptools.
-
-<div class="termy">
-
-```console
-$ pip install "uvicorn[standard]"
-
----> 100%
-```
-
-</div>
-
-////
-
-//// tab | Hypercorn
-
-* <a href="https://github.com/pgjones/hypercorn" class="external-link" target="_blank">Hypercorn</a>, um servidor ASGI também compatível com HTTP/2.
-
-<div class="termy">
-
-```console
-$ pip install hypercorn
-
----> 100%
-```
-
-</div>
-
-...ou qualquer outro servidor ASGI.
-
-////
-
-E rode sua applicação do mesmo modo que você tem feito nos tutoriais, mas sem a opção `--reload`, por exemplo:
-
-//// tab | Uvicorn
-
-<div class="termy">
-
-```console
-$ uvicorn main:app --host 0.0.0.0 --port 80
-
-<span style="color: green;">INFO</span>: Uvicorn running on http://0.0.0.0:80 (Press CTRL+C to quit)
-```
-
-</div>
-
-////
-
-//// tab | Hypercorn
-
-<div class="termy">
-
-```console
-$ hypercorn main:app --bind 0.0.0.0:80
-
-Running on 0.0.0.0:8080 over http (CTRL + C to quit)
-```
-
-</div>
-
-////
-
-Você deve querer configurar mais algumas ferramentas para ter certeza que ele seja reinicializado automaticamante se ele parar.
-
-Você também deve querer instalar <a href="https://gunicorn.org/" class="external-link" target="_blank">Gunicorn</a> e <a href="https://www.uvicorn.org/#running-with-gunicorn" class="external-link" target="_blank">utilizar ele como um gerenciador para o Uvicorn</a>, ou usar Hypercorn com múltiplos _workers_.
-
-Tenha certeza de ajustar o número de _workers_ etc.
-
-Mas se você estiver fazendo tudo isso, você pode apenas usar uma imagem Docker que fará isso automaticamente.
From 923d44de356e4dd6ea5cea996deb454ba3139ada Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 14 Oct 2024 14:57:54 +0000
Subject: [PATCH 168/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 08f1652f5..2c2a9a649 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Remove Portuguese translation for `docs/pt/docs/deployment.md`. PR [#12427](https://github.com/fastapi/fastapi/pull/12427) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/body-updates.md`. PR [#12381](https://github.com/fastapi/fastapi/pull/12381) by [@andersonrocha0](https://github.com/andersonrocha0).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/response-cookies.md`. PR [#12417](https://github.com/fastapi/fastapi/pull/12417) by [@Paulofalcao2002](https://github.com/Paulofalcao2002).
From e58c185526d3a4c39e16d05ec9fc3abd4febc3d5 Mon Sep 17 00:00:00 2001
From: Rafael de Oliveira Marques <rafaelomarques@gmail.com>
Date: Tue, 15 Oct 2024 06:53:14 -0300
Subject: [PATCH 169/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/query-param-models.md`=20?=
=?UTF-8?q?(#12414)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/tutorial/query-param-models.md | 197 ++++++++++++++++++++
1 file changed, 197 insertions(+)
create mode 100644 docs/pt/docs/tutorial/query-param-models.md
diff --git a/docs/pt/docs/tutorial/query-param-models.md b/docs/pt/docs/tutorial/query-param-models.md
new file mode 100644
index 000000000..854183fb4
--- /dev/null
+++ b/docs/pt/docs/tutorial/query-param-models.md
@@ -0,0 +1,197 @@
+# Modelos de Parâmetros de Consulta
+
+Se você possui um grupo de **parâmetros de consultas** que são relacionados, você pode criar um **modelo Pydantic** para declará-los.
+
+Isso permitiria que você **reutilizasse o modelo** em **diversos lugares**, e também declarasse validações e metadados de todos os parâmetros de uma única vez. 😎
+
+/// note | Nota
+
+Isso é suportado desde o FastAPI versão `0.115.0`. 🤓
+
+///
+
+## Parâmetros de Consulta com um Modelo Pydantic
+
+Declare os **parâmetros de consulta** que você precisa em um **modelo Pydantic**, e então declare o parâmetro como `Query`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="9-13 17"
+{!> ../../docs_src/query_param_models/tutorial001_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="8-12 16"
+{!> ../../docs_src/query_param_models/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="10-14 18"
+{!> ../../docs_src/query_param_models/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="9-13 17"
+{!> ../../docs_src/query_param_models/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="8-12 16"
+{!> ../../docs_src/query_param_models/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="9-13 17"
+{!> ../../docs_src/query_param_models/tutorial001_py310.py!}
+```
+
+////
+
+O **FastAPI** **extrairá** os dados para **cada campo** dos **parâmetros de consulta** presentes na requisição, e fornecerá o modelo Pydantic que você definiu.
+
+
+## Verifique os Documentos
+
+Você pode ver os parâmetros de consulta nos documentos de IU em `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/query-param-models/image01.png">
+</div>
+
+## Restrinja Parâmetros de Consulta Extras
+
+Em alguns casos especiais (provavelmente não muito comuns), você queira **restrinjir** os parâmetros de consulta que deseja receber.
+
+Você pode usar a configuração do modelo Pydantic para `forbid` (proibir) qualquer campo `extra`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="10"
+{!> ../../docs_src/query_param_models/tutorial002_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9"
+{!> ../../docs_src/query_param_models/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../docs_src/query_param_models/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="10"
+{!> ../../docs_src/query_param_models/tutorial002_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="9"
+{!> ../../docs_src/query_param_models/tutorial002_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira utilizar a versão `Annotated` se possível.
+
+///
+
+```Python hl_lines="11"
+{!> ../../docs_src/query_param_models/tutorial002.py!}
+```
+
+////
+
+Caso um cliente tente enviar alguns dados **extras** nos **parâmetros de consulta**, eles receberão um retorno de **erro**.
+
+Por exemplo, se o cliente tentar enviar um parâmetro de consulta `tool` com o valor `plumbus`, como:
+
+```http
+https://example.com/items/?limit=10&tool=plumbus
+```
+
+Eles receberão um retorno de **erro** informando-os que o parâmentro de consulta `tool` não é permitido:
+
+```json
+{
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["query", "tool"],
+ "msg": "Extra inputs are not permitted",
+ "input": "plumbus"
+ }
+ ]
+}
+```
+
+## Resumo
+
+Você pode utilizar **modelos Pydantic** para declarar **parâmetros de consulta** no **FastAPI**. 😎
+
+/// tip | Dica
+
+Alerta de spoiler: você também pode utilizar modelos Pydantic para declarar cookies e cabeçalhos, mas você irá ler sobre isso mais a frente no tutorial. 🤫
+
+///
From c9f11c2b732de9876dc942da640a521aeb6c1f2d Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 15 Oct 2024 09:53:37 +0000
Subject: [PATCH 170/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2c2a9a649..1f794f2ef 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/query-param-models.md`. PR [#12414](https://github.com/fastapi/fastapi/pull/12414) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Remove Portuguese translation for `docs/pt/docs/deployment.md`. PR [#12427](https://github.com/fastapi/fastapi/pull/12427) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/body-updates.md`. PR [#12381](https://github.com/fastapi/fastapi/pull/12381) by [@andersonrocha0](https://github.com/andersonrocha0).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/response-cookies.md`. PR [#12417](https://github.com/fastapi/fastapi/pull/12417) by [@Paulofalcao2002](https://github.com/Paulofalcao2002).
From 73546a68e6cc08dc9dc5de2efabceb638035e4ab Mon Sep 17 00:00:00 2001
From: YungYueh ChanLee <polo80456@gmail.com>
Date: Tue, 15 Oct 2024 17:57:21 +0800
Subject: [PATCH 171/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Traditional=20Chin?=
=?UTF-8?q?ese=20translation=20for=20`docs/zh-hant/docs/about/index.md`=20?=
=?UTF-8?q?(#12438)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh-hant/docs/about/index.md | 3 +++
1 file changed, 3 insertions(+)
create mode 100644 docs/zh-hant/docs/about/index.md
diff --git a/docs/zh-hant/docs/about/index.md b/docs/zh-hant/docs/about/index.md
new file mode 100644
index 000000000..5dcee68f2
--- /dev/null
+++ b/docs/zh-hant/docs/about/index.md
@@ -0,0 +1,3 @@
+# 關於 FastAPI
+
+關於 FastAPI、其設計、靈感來源等更多資訊。 🤓
From 33cd8bbcc59971776deda01207bc0692033f549a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 15 Oct 2024 09:58:11 +0000
Subject: [PATCH 172/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 1f794f2ef..6289f3603 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/about/index.md`. PR [#12438](https://github.com/fastapi/fastapi/pull/12438) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/query-param-models.md`. PR [#12414](https://github.com/fastapi/fastapi/pull/12414) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Remove Portuguese translation for `docs/pt/docs/deployment.md`. PR [#12427](https://github.com/fastapi/fastapi/pull/12427) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/body-updates.md`. PR [#12381](https://github.com/fastapi/fastapi/pull/12381) by [@andersonrocha0](https://github.com/andersonrocha0).
From 4d8d092925a8c8f129039eebdde8e395c56a01f3 Mon Sep 17 00:00:00 2001
From: YungYueh ChanLee <polo80456@gmail.com>
Date: Tue, 15 Oct 2024 18:00:33 +0800
Subject: [PATCH 173/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Traditional=20Chin?=
=?UTF-8?q?ese=20translation=20for=20`docs/zh-hant/docs/resources/index.md?=
=?UTF-8?q?`=20(#12443)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh-hant/docs/resources/index.md | 3 +++
1 file changed, 3 insertions(+)
create mode 100644 docs/zh-hant/docs/resources/index.md
diff --git a/docs/zh-hant/docs/resources/index.md b/docs/zh-hant/docs/resources/index.md
new file mode 100644
index 000000000..f4c70a3a0
--- /dev/null
+++ b/docs/zh-hant/docs/resources/index.md
@@ -0,0 +1,3 @@
+# 資源
+
+額外的資源、外部連結、文章等。 ✈️
From d63f0d60ba32a3a04cb275b10fb25450f1a7c764 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 15 Oct 2024 10:03:32 +0000
Subject: [PATCH 174/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6289f3603..6194277be 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/resources/index.md`. PR [#12443](https://github.com/fastapi/fastapi/pull/12443) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/about/index.md`. PR [#12438](https://github.com/fastapi/fastapi/pull/12438) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/query-param-models.md`. PR [#12414](https://github.com/fastapi/fastapi/pull/12414) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Remove Portuguese translation for `docs/pt/docs/deployment.md`. PR [#12427](https://github.com/fastapi/fastapi/pull/12427) by [@ceb10n](https://github.com/ceb10n).
From 111ced53af4fa89b7f636e9d6b8179996c69d563 Mon Sep 17 00:00:00 2001
From: Alejandra <90076947+alejsdev@users.noreply.github.com>
Date: Tue, 15 Oct 2024 12:38:53 +0200
Subject: [PATCH 175/504] =?UTF-8?q?=F0=9F=91=B7=20Update=20issue=20manager?=
=?UTF-8?q?=20workflow=20(#12457)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
.github/workflows/issue-manager.yml | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/.github/workflows/issue-manager.yml b/.github/workflows/issue-manager.yml
index 439084434..6a7e6143e 100644
--- a/.github/workflows/issue-manager.yml
+++ b/.github/workflows/issue-manager.yml
@@ -39,5 +39,9 @@ jobs:
"waiting": {
"delay": 2628000,
"message": "As this PR has been waiting for the original user for a while but seems to be inactive, it's now going to be closed. But if there's anyone interested, feel free to create a new PR."
+ },
+ "invalid": {
+ "delay": 0,
+ "message": "This was marked as invalid and will be closed now. If this is an error, please provide additional details."
}
}
From be03a7313e9e2e0a5d247129ac68afc42928ffa3 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 15 Oct 2024 10:39:19 +0000
Subject: [PATCH 176/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6194277be..fa0861e33 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -18,6 +18,7 @@ hide:
### Internal
+* 👷 Update issue manager workflow . PR [#12457](https://github.com/fastapi/fastapi/pull/12457) by [@alejsdev](https://github.com/alejsdev).
* 🔧 Update team, include YuriiMotov 🚀. PR [#12453](https://github.com/fastapi/fastapi/pull/12453) by [@tiangolo](https://github.com/tiangolo).
* 👷 Refactor label-approved, make it an internal script instead of an external GitHub Action. PR [#12280](https://github.com/fastapi/fastapi/pull/12280) by [@tiangolo](https://github.com/tiangolo).
* 👷 Fix smokeshow, checkout files on CI. PR [#12434](https://github.com/fastapi/fastapi/pull/12434) by [@tiangolo](https://github.com/tiangolo).
From 05074585044756077ab1ff56b3279d5f462ce625 Mon Sep 17 00:00:00 2001
From: WISDERFIN <77553770+wisderfin@users.noreply.github.com>
Date: Tue, 15 Oct 2024 15:38:57 +0400
Subject: [PATCH 177/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Russian=20translat?=
=?UTF-8?q?ion=20for=20`docs/ru/docs/environment-variables.md`=20(#12436)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ru/docs/environment-variables.md | 297 ++++++++++++++++++++++++++
1 file changed, 297 insertions(+)
create mode 100644 docs/ru/docs/environment-variables.md
diff --git a/docs/ru/docs/environment-variables.md b/docs/ru/docs/environment-variables.md
new file mode 100644
index 000000000..a6c7b0c77
--- /dev/null
+++ b/docs/ru/docs/environment-variables.md
@@ -0,0 +1,297 @@
+# Переменные окружения
+
+/// tip
+
+Если вы уже знаете, что такое «переменные окружения» и как их использовать, можете пропустить это.
+
+///
+
+Переменная окружения (также известная как «**env var**») - это переменная, которая живет **вне** кода Python, в **операционной системе**, и может быть прочитана вашим кодом Python (или другими программами).
+
+Переменные окружения могут быть полезны для работы с **настройками** приложений, как часть **установки** Python и т.д.
+
+## Создание и использование переменных окружения
+
+Можно **создавать** и использовать переменные окружения в **оболочке (терминале)**, не прибегая к помощи Python:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// Вы можете создать переменную окружения MY_NAME с помощью
+$ export MY_NAME="Wade Wilson"
+
+// Затем её можно использовать в других программах, например
+$ echo "Hello $MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// Создайте переменную окружения MY_NAME
+$ $Env:MY_NAME = "Wade Wilson"
+
+// Используйте её с другими программами, например
+$ echo "Hello $Env:MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+## Чтение переменных окружения в python
+
+Так же существует возможность создания переменных окружения **вне** Python, в терминале (или любым другим способом), а затем **чтения их в Python**.
+
+Например, у вас есть файл `main.py`:
+
+```Python hl_lines="3"
+import os
+
+name = os.getenv("MY_NAME", "World")
+print(f"Hello {name} from Python")
+```
+
+/// tip
+
+Второй аргумент <a href=«https://docs.python.org/3.8/library/os.html#os.getenv» class=«external-link» target=«_blank»>`os.getenv()`</a> - это возвращаемое по умолчанию значение.
+
+Если значение не указано, то по умолчанию оно равно `None`. В данном случае мы указываем `«World»` в качестве значения по умолчанию.
+///
+
+Затем можно запустить эту программу на Python:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// Здесь мы еще не устанавливаем переменную окружения
+$ python main.py
+
+// Поскольку мы не задали переменную окружения, мы получим значение по умолчанию
+
+Hello World from Python
+
+// Но если мы сначала создадим переменную окружения
+$ export MY_NAME="Wade Wilson"
+
+// А затем снова запустим программу
+$ python main.py
+
+// Теперь она прочитает переменную окружения
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// Здесь мы еще не устанавливаем переменную окружения
+$ python main.py
+
+// Поскольку мы не задали переменную окружения, мы получим значение по умолчанию
+
+Hello World from Python
+
+// Но если мы сначала создадим переменную окружения
+$ $Env:MY_NAME = "Wade Wilson"
+
+// А затем снова запустим программу
+$ python main.py
+
+// Теперь она может прочитать переменную окружения
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+Поскольку переменные окружения могут быть установлены вне кода, но могут быть прочитаны кодом, и их не нужно хранить (фиксировать в `git`) вместе с остальными файлами, их принято использовать для конфигураций или **настроек**.
+
+Вы также можете создать переменную окружения только для **конкретного вызова программы**, которая будет доступна только для этой программы и только на время ее выполнения.
+
+Для этого создайте её непосредственно перед самой программой, в той же строке:
+
+<div class="termy">
+
+```console
+// Создайте переменную окружения MY_NAME в строке для этого вызова программы
+$ MY_NAME="Wade Wilson" python main.py
+
+// Теперь она может прочитать переменную окружения
+
+Hello Wade Wilson from Python
+
+// После этого переменная окружения больше не существует
+$ python main.py
+
+Hello World from Python
+```
+
+</div>
+
+/// tip
+
+Подробнее об этом можно прочитать на сайте <a href="https://12factor.net/config" class="external-link" target="_blank">The Twelve-Factor App: Config</a>.
+
+///
+
+## Типизация и Валидация
+
+Эти переменные окружения могут работать только с **текстовыми строками**, поскольку они являются внешними по отношению к Python и должны быть совместимы с другими программами и остальной системой (и даже с различными операционными системами, такими как Linux, Windows, macOS).
+
+Это означает, что **любое значение**, считанное в Python из переменной окружения, **будет `str`**, и любое преобразование к другому типу или любая проверка должны быть выполнены в коде.
+
+Подробнее об использовании переменных окружения для работы с **настройками приложения** вы узнаете в [Расширенное руководство пользователя - Настройки и переменные среды](./advanced/settings.md){.internal-link target=_blank}.
+
+## Переменная окружения `PATH`
+
+Существует **специальная** переменная окружения **`PATH`**, которая используется операционными системами (Linux, macOS, Windows) для поиска программ для запуска.
+
+Значение переменной `PATH` - это длинная строка, состоящая из каталогов, разделенных двоеточием `:` в Linux и macOS, и точкой с запятой `;` в Windows.
+
+Например, переменная окружения `PATH` может выглядеть следующим образом:
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+Это означает, что система должна искать программы в каталогах:
+
+* `/usr/local/bin`
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32
+```
+
+Это означает, что система должна искать программы в каталогах:
+
+* `C:\Program Files\Python312\Scripts`
+* `C:\Program Files\Python312`
+* `C:\Windows\System32`
+
+////
+
+Когда вы вводите **команду** в терминале, операционная система **ищет** программу в **каждой из тех директорий**, которые перечислены в переменной окружения `PATH`.
+
+Например, когда вы вводите `python` в терминале, операционная система ищет программу под названием `python` в **первой директории** в этом списке.
+
+Если она ее находит, то **использует ее**. В противном случае она продолжает искать в **других каталогах**.
+
+### Установка Python и обновление `PATH`
+
+При установке Python вас могут спросить, нужно ли обновить переменную окружения `PATH`.
+
+//// tab | Linux, macOS
+
+Допустим, вы устанавливаете Python, и он оказывается в каталоге `/opt/custompython/bin`.
+
+Если вы скажете «да», чтобы обновить переменную окружения `PATH`, то программа установки добавит `/opt/custompython/bin` в переменную окружения `PATH`.
+
+Это может выглядеть следующим образом:
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin
+```
+
+Таким образом, когда вы набираете `python` в терминале, система найдет программу Python в `/opt/custompython/bin` (последний каталог) и использует ее.
+
+////
+
+//// tab | Windows
+
+Допустим, вы устанавливаете Python, и он оказывается в каталоге `C:\opt\custompython\bin`.
+
+Если вы согласитесь обновить переменную окружения `PATH`, то программа установки добавит `C:\opt\custompython\bin` в переменную окружения `PATH`.
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin
+```
+
+Таким образом, когда вы набираете `python` в терминале, система найдет программу Python в `C:\opt\custompython\bin` (последний каталог) и использует ее.
+
+////
+
+Итак, если вы напечатаете:
+
+<div class="termy">
+
+```console
+$ python
+```
+
+</div>
+
+//// tab | Linux, macOS
+
+Система **найдет** программу `python` в `/opt/custompython/bin` и запустит ее.
+
+Это примерно эквивалентно набору текста:
+
+<div class="termy">
+
+```console
+$ /opt/custompython/bin/python
+```
+
+</div>
+
+////
+
+//// tab | Windows
+
+Система **найдет** программу `python` в каталоге `C:\opt\custompython\bin\python` и запустит ее.
+
+Это примерно эквивалентно набору текста:
+
+<div class="termy">
+
+```console
+$ C:\opt\custompython\bin\python
+```
+
+</div>
+
+////
+
+Эта информация будет полезна при изучении [Виртуальных окружений](virtual-environments.md){.internal-link target=_blank}.
+
+## Вывод
+
+Благодаря этому вы должны иметь базовое представление о том, что такое **переменные окружения** и как использовать их в Python.
+
+Подробнее о них вы также можете прочитать в <a href="https://en.wikipedia.org/wiki/Environment_variable" class="external-link" target="_blank">статье о переменных окружения на википедии</a>.
+
+Во многих случаях не всегда очевидно, как переменные окружения могут быть полезны и применимы. Но они постоянно появляются в различных сценариях разработки, поэтому знать о них полезно.
+
+Например, эта информация понадобится вам в следующем разделе, посвященном [Виртуальным окружениям](virtual-environments.md).
From 9b09974cfc358692712375f899381a159038bb8f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 15 Oct 2024 11:39:19 +0000
Subject: [PATCH 178/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fa0861e33..b8aa738c5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Russian translation for `docs/ru/docs/environment-variables.md`. PR [#12436](https://github.com/fastapi/fastapi/pull/12436) by [@wisderfin](https://github.com/wisderfin).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/resources/index.md`. PR [#12443](https://github.com/fastapi/fastapi/pull/12443) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/about/index.md`. PR [#12438](https://github.com/fastapi/fastapi/pull/12438) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/query-param-models.md`. PR [#12414](https://github.com/fastapi/fastapi/pull/12414) by [@ceb10n](https://github.com/ceb10n).
From 12c188b311f97bb3e133c51057d52f9df9efb034 Mon Sep 17 00:00:00 2001
From: Rafael de Oliveira Marques <rafaelomarques@gmail.com>
Date: Tue, 15 Oct 2024 09:32:27 -0300
Subject: [PATCH 179/504] =?UTF-8?q?=F0=9F=8C=90=20Update=20Portuguese=20tr?=
=?UTF-8?q?anslation=20for=20`docs/pt/docs/python-types.md`=20(#12428)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/python-types.md | 379 ++++++++++++++++++++++++++++++-----
1 file changed, 326 insertions(+), 53 deletions(-)
diff --git a/docs/pt/docs/python-types.md b/docs/pt/docs/python-types.md
index 05faa860c..a0938259f 100644
--- a/docs/pt/docs/python-types.md
+++ b/docs/pt/docs/python-types.md
@@ -1,18 +1,18 @@
# Introdução aos tipos Python
-**Python 3.6 +** tem suporte para "type hints" opcionais.
+O Python possui suporte para "dicas de tipo" ou "type hints" (também chamado de "anotações de tipo" ou "type annotations")
-Esses **"type hints"** são uma nova sintaxe (desde Python 3.6+) que permite declarar o <abbr title = "por exemplo: str, int, float, bool"> tipo </abbr> de uma variável.
+Esses **"type hints"** são uma sintaxe especial que permite declarar o <abbr title = "por exemplo: str, int, float, bool">tipo</abbr> de uma variável.
Ao declarar tipos para suas variáveis, editores e ferramentas podem oferecer um melhor suporte.
-Este é apenas um **tutorial rápido / atualização** sobre type hints Python. Ele cobre apenas o mínimo necessário para usá-los com o **FastAPI** ... que é realmente muito pouco.
+Este é apenas um **tutorial rápido / atualização** sobre type hints do Python. Ele cobre apenas o mínimo necessário para usá-los com o **FastAPI**... que é realmente muito pouco.
O **FastAPI** é baseado nesses type hints, eles oferecem muitas vantagens e benefícios.
Mas mesmo que você nunca use o **FastAPI**, você se beneficiaria de aprender um pouco sobre eles.
-/// note | "Nota"
+/// note | Nota
Se você é um especialista em Python e já sabe tudo sobre type hints, pule para o próximo capítulo.
@@ -35,8 +35,8 @@ John Doe
A função faz o seguinte:
* Pega um `first_name` e `last_name`.
-* Converte a primeira letra de cada uma em maiúsculas com `title ()`.
-* <abbr title = "Agrupa-os, como um. Com o conteúdo de um após o outro."> Concatena </abbr> com um espaço no meio.
+* Converte a primeira letra de cada uma em maiúsculas com `title()`.
+* <abbr title = "Agrupa-os, como um. Com o conteúdo de um após o outro.">Concatena</abbr> com um espaço no meio.
```Python hl_lines="2"
{!../../docs_src/python_types/tutorial001.py!}
@@ -48,7 +48,7 @@ A função faz o seguinte:
Mas agora imagine que você estava escrevendo do zero.
-Em algum momento você teria iniciado a definição da função, já tinha os parâmetros prontos ...
+Em algum momento você teria iniciado a definição da função, já tinha os parâmetros prontos...
Mas então você deve chamar "esse método que converte a primeira letra em maiúscula".
@@ -96,37 +96,37 @@ Isso não é o mesmo que declarar valores padrão como seria com:
Estamos usando dois pontos (`:`), não é igual a (`=`).
-E adicionar type hints normalmente não muda o que acontece do que aconteceria sem elas.
+E adicionar type hints normalmente não muda o que acontece do que aconteceria sem eles.
Mas agora, imagine que você está novamente no meio da criação dessa função, mas com type hints.
-No mesmo ponto, você tenta acionar o preenchimento automático com o `Ctrl Space` e vê:
+No mesmo ponto, você tenta acionar o preenchimento automático com o `Ctrl+Space` e vê:
<img src="/img/python-types/image02.png">
-Com isso, você pode rolar, vendo as opções, até encontrar o que "toca uma campainha":
+Com isso, você pode rolar, vendo as opções, até encontrar o que "soa familiar":
<img src="/img/python-types/image03.png">
## Mais motivação
-Marque esta função, ela já possui type hints:
+Verifique esta função, ela já possui type hints:
```Python hl_lines="1"
{!../../docs_src/python_types/tutorial003.py!}
```
-Como o editor conhece os tipos de variáveis, você não apenas obtém a conclusão, mas também as verificações de erro:
+Como o editor conhece os tipos de variáveis, você não obtém apenas o preenchimento automático, mas também as verificações de erro:
<img src="/img/python-types/image04.png">
-Agora você sabe que precisa corrigí-lo, converta `age` em uma string com `str (age)`:
+Agora você sabe que precisa corrigí-lo, converta `age` em uma string com `str(age)`:
```Python hl_lines="2"
{!../../docs_src/python_types/tutorial004.py!}
```
-## Tipos de declaração
+## Declarando Tipos
Você acabou de ver o local principal para declarar type hints. Como parâmetros de função.
@@ -151,39 +151,77 @@ Você pode usar, por exemplo:
Existem algumas estruturas de dados que podem conter outros valores, como `dict`, `list`, `set` e `tuple`. E os valores internos também podem ter seu próprio tipo.
-Para declarar esses tipos e os tipos internos, você pode usar o módulo Python padrão `typing`.
+Estes tipos que possuem tipos internos são chamados de tipos "**genéricos**". E é possível declará-los mesmo com os seus tipos internos.
-Ele existe especificamente para suportar esses type hints.
+Para declarar esses tipos e os tipos internos, você pode usar o módulo Python padrão `typing`. Ele existe especificamente para suportar esses type hints.
-#### `List`
+#### Versões mais recentes do Python
-Por exemplo, vamos definir uma variável para ser uma `lista` de `str`.
+A sintaxe utilizando `typing` é **compatível** com todas as versões, desde o Python 3.6 até as últimas, incluindo o Python 3.9, 3.10, etc.
-Em `typing`, importe `List` (com um `L` maiúsculo):
+Conforme o Python evolui, **novas versões** chegam com suporte melhorado para esses type annotations, e em muitos casos, você não precisará nem importar e utilizar o módulo `typing` para declarar os type annotations.
+
+Se você pode escolher uma versão mais recente do Python para o seu projeto, você poderá aproveitar isso ao seu favor.
+
+Em todos os documentos existem exemplos compatíveis com cada versão do Python (quando existem diferenças).
+
+Por exemplo, "**Python 3.6+**" significa que é compatível com o Python 3.6 ou superior (incluindo o 3.7, 3.8, 3.9, 3.10, etc). E "**Python 3.9+**" significa que é compatível com o Python 3.9 ou mais recente (incluindo o 3.10, etc).
+
+Se você pode utilizar a **versão mais recente do Python**, utilize os exemplos para as últimas versões. Eles terão as **melhores e mais simples sintaxes**, como por exemplo, "**Python 3.10+**".
+
+#### List
+
+Por exemplo, vamos definir uma variável para ser uma `list` de `str`.
+
+//// tab | Python 3.9+
+
+Declare uma variável com a mesma sintaxe com dois pontos (`:`)
+
+Como tipo, coloque `list`.
+
+Como a lista é o tipo que contém algum tipo interno, você coloca o tipo dentro de colchetes:
```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006_py39.py!}
```
-Declare a variável com a mesma sintaxe de dois pontos (`:`).
+////
-Como o tipo, coloque a `List`.
+//// tab | Python 3.8+
-Como a lista é um tipo que contém alguns tipos internos, você os coloca entre colchetes:
+De `typing`, importe `List` (com o `L` maiúsculo):
+
+```Python hl_lines="1"
+{!> ../../docs_src/python_types/tutorial006.py!}
+```
+
+Declare uma variável com a mesma sintaxe com dois pontos (`:`)
+
+Como tipo, coloque o `List` que você importou de `typing`.
+
+Como a lista é o tipo que contém algum tipo interno, você coloca o tipo dentro de colchetes:
```Python hl_lines="4"
-{!../../docs_src/python_types/tutorial006.py!}
+{!> ../../docs_src/python_types/tutorial006.py!}
```
-/// tip | "Dica"
+////
+
+/// info | Informação
-Esses tipos internos entre colchetes são chamados de "parâmetros de tipo".
+Estes tipos internos dentro dos colchetes são chamados "parâmetros de tipo" (type parameters).
-Nesse caso, `str` é o parâmetro de tipo passado para `List`.
+Neste caso, `str` é o parâmetro de tipo passado para `List` (ou `list` no Python 3.9 ou superior).
///
-Isso significa que: "a variável `items` é uma `list`, e cada um dos itens desta lista é uma `str`".
+Isso significa: "a variável `items` é uma `list`, e cada um dos itens desta lista é uma `str`".
+
+/// tip | Dica
+
+Se você usa o Python 3.9 ou superior, você não precisa importar `List` de `typing`. Você pode utilizar o mesmo tipo `list` no lugar.
+
+///
Ao fazer isso, seu editor pode fornecer suporte mesmo durante o processamento de itens da lista:
@@ -195,20 +233,32 @@ Observe que a variável `item` é um dos elementos da lista `items`.
E, ainda assim, o editor sabe que é um `str` e fornece suporte para isso.
-#### `Tuple` e `Set`
+#### Tuple e Set
Você faria o mesmo para declarar `tuple`s e `set`s:
-```Python hl_lines="1 4"
-{!../../docs_src/python_types/tutorial007.py!}
+//// tab | Python 3.9+
+
+```Python hl_lines="1"
+{!> ../../docs_src/python_types/tutorial007_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial007.py!}
```
+////
+
Isso significa que:
* A variável `items_t` é uma `tuple` com 3 itens, um `int`, outro `int` e uma `str`.
* A variável `items_s` é um `set`, e cada um de seus itens é do tipo `bytes`.
-#### `Dict`
+#### Dict
Para definir um `dict`, você passa 2 parâmetros de tipo, separados por vírgulas.
@@ -216,38 +266,185 @@ O primeiro parâmetro de tipo é para as chaves do `dict`.
O segundo parâmetro de tipo é para os valores do `dict`:
-```Python hl_lines="1 4"
-{!../../docs_src/python_types/tutorial008.py!}
+//// tab | Python 3.9+
+
+```Python hl_lines="1"
+{!> ../../docs_src/python_types/tutorial008_py39.py!}
```
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial008.py!}
+```
+
+////
+
Isso significa que:
* A variável `prices` é um dict`:
* As chaves deste `dict` são do tipo `str` (digamos, o nome de cada item).
* Os valores deste `dict` são do tipo `float` (digamos, o preço de cada item).
-#### `Opcional`
+#### Union
-Você também pode usar o `Opcional` para declarar que uma variável tem um tipo, como `str`, mas que é "opcional", o que significa que também pode ser `None`:
+Você pode declarar que uma variável pode ser de qualquer um dentre **diversos tipos**. Por exemplo, um `int` ou um `str`.
+
+No Python 3.6 e superior (incluindo o Python 3.10), você pode utilizar o tipo `Union` de `typing`, e colocar dentro dos colchetes os possíveis tipos aceitáveis.
+
+No Python 3.10 também existe uma **nova sintaxe** onde você pode colocar os possívels tipos separados por uma <abbr title='também chamado de "bitwise ou operador", mas o significado é irrelevante aqui'>barra vertical (`|`)</abbr>.
+
+//// tab | Python 3.10+
+
+```Python hl_lines="1"
+{!> ../../docs_src/python_types/tutorial008b_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial008b.py!}
+```
+
+////
+
+Em ambos os casos, isso significa que `item` poderia ser um `int` ou um `str`.
+
+
+#### Possívelmente `None`
+
+Você pode declarar que um valor pode ter um tipo, como `str`, mas que ele também pode ser `None`.
+
+No Python 3.6 e superior (incluindo o Python 3.10) você pode declará-lo importando e utilizando `Optional` do módulo `typing`.
```Python hl_lines="1 4"
{!../../docs_src/python_types/tutorial009.py!}
```
-O uso de `Opcional [str]` em vez de apenas `str` permitirá que o editor o ajude a detectar erros, onde você pode estar assumindo que um valor é sempre um `str`, quando na verdade também pode ser `None`.
+O uso de `Optional[str]` em vez de apenas `str` permitirá que o editor o ajude a detectar erros, onde você pode estar assumindo que um valor é sempre um `str`, quando na verdade também pode ser `None`.
+
+`Optional[Something]` é na verdade um atalho para `Union[Something, None]`, eles são equivalentes.
+
+Isso também significa que no Python 3.10, você pode utilizar `Something | None`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="1"
+{!> ../../docs_src/python_types/tutorial009_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial009.py!}
+```
+
+////
+
+//// tab | Python 3.8+ alternative
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial009b.py!}
+```
+
+////
+
+#### Utilizando `Union` ou `Optional`
+
+Se você está utilizando uma versão do Python abaixo da 3.10, aqui vai uma dica do meu ponto de vista bem **subjetivo**:
+
+* 🚨 Evite utilizar `Optional[SomeType]`
+* No lugar, ✨ **use `Union[SomeType, None]`** ✨.
+
+Ambos são equivalentes, e no final das contas, eles são o mesmo. Mas eu recomendaria o `Union` ao invés de `Optional` porque a palavra **Optional** parece implicar que o valor é opcional, quando na verdade significa "isso pode ser `None`", mesmo que ele não seja opcional e ainda seja obrigatório.
+
+Eu penso que `Union[SomeType, None]` é mais explícito sobre o que ele significa.
+
+Isso é apenas sobre palavras e nomes. Mas estas palavras podem afetar como os seus colegas de trabalho pensam sobre o código.
+
+Por exemplo, vamos pegar esta função:
+
+```Python hl_lines="1 4"
+{!../../docs_src/python_types/tutorial009c.py!}
+```
+
+O paâmetro `name` é definido como `Optional[str]`, mas ele **não é opcional**, você não pode chamar a função sem o parâmetro:
+
+```Python
+say_hi() # Oh, no, this throws an error! 😱
+```
+
+O parâmetro `name` **ainda é obrigatório** (não *opicional*) porque ele não possui um valor padrão. Mesmo assim, `name` aceita `None` como valor:
+
+```Python
+say_hi(name=None) # This works, None is valid 🎉
+```
+
+A boa notícia é, quando você estiver no Python 3.10 você não precisará se preocupar mais com isso, pois você poderá simplesmente utilizar o `|` para definir uniões de tipos:
+
+```Python hl_lines="1 4"
+{!../../docs_src/python_types/tutorial009c_py310.py!}
+```
+
+E então você não precisará mais se preocupar com nomes como `Optional` e `Union`. 😎
#### Tipos genéricos
-Esses tipos que usam parâmetros de tipo entre colchetes, como:
+Esses tipos que usam parâmetros de tipo entre colchetes são chamados **tipos genéricos** ou **genéricos**. Por exemplo:
+
+//// tab | Python 3.10+
+
+Você pode utilizar os mesmos tipos internos como genéricos (com colchetes e tipos dentro):
+
+* `list`
+* `tuple`
+* `set`
+* `dict`
+
+E o mesmo como no Python 3.8, do módulo `typing`:
+
+* `Union`
+* `Optional` (o mesmo que com o 3.8)
+* ...entro outros.
+
+No Python 3.10, como uma alternativa para a utilização dos genéricos `Union` e `Optional`, você pode usar a <abbr title='também chamado de "bitwise ou operador", mas o significado não é relevante aqui'>barra vertical (`|`)</abbr> para declarar uniões de tipos. Isso é muito melhor e mais simples.
+
+////
+
+//// tab | Python 3.9+
+
+Você pode utilizar os mesmos tipos internos como genéricos (com colchetes e tipos dentro):
+
+* `list`
+* `tuple`
+* `set`
+* `dict`
+
+E o mesmo como no Python 3.8, do módulo `typing`:
+
+* `Union`
+* `Optional`
+* ...entro outros.
+
+////
+
+//// tab | Python 3.8+
* `List`
* `Tuple`
* `Set`
* `Dict`
-* `Opcional`
-* ...e outros.
+* `Union`
+* `Optional`
+* ...entro outros.
-são chamados **tipos genéricos** ou **genéricos**.
+////
### Classes como tipos
@@ -255,7 +452,7 @@ Você também pode declarar uma classe como o tipo de uma variável.
Digamos que você tenha uma classe `Person`, com um nome:
-```Python hl_lines="1 2 3"
+```Python hl_lines="1-3"
{!../../docs_src/python_types/tutorial010.py!}
```
@@ -269,9 +466,13 @@ E então, novamente, você recebe todo o suporte do editor:
<img src="/img/python-types/image06.png">
+Perceba que isso significa que "`one_person` é uma **instância** da classe `Person`".
+
+Isso não significa que "`one_person` é a **classe** chamada `Person`".
+
## Modelos Pydantic
-<a href="https://docs.pydantic.dev/" class="external-link" target="_blank"> Pydantic </a> é uma biblioteca Python para executar a validação de dados.
+O <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic</a> é uma biblioteca Python para executar a validação de dados.
Você declara a "forma" dos dados como classes com atributos.
@@ -283,21 +484,93 @@ E você recebe todo o suporte do editor com esse objeto resultante.
Retirado dos documentos oficiais dos Pydantic:
+//// tab | Python 3.10+
+
```Python
-{!../../docs_src/python_types/tutorial011.py!}
+{!> ../../docs_src/python_types/tutorial011_py310.py!}
```
-/// info | "Informação"
+////
+
+//// tab | Python 3.9+
+
+```Python
+{!> ../../docs_src/python_types/tutorial011_py39.py!}
+```
-Para saber mais sobre o <a href="https://docs.pydantic.dev/" class="external-link" target="_blank"> Pydantic, verifique seus documentos </a>.
+////
+
+//// tab | Python 3.8+
+
+```Python
+{!> ../../docs_src/python_types/tutorial011.py!}
+```
+
+////
+
+/// info | Informação
+
+Para saber mais sobre o <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic, verifique a sua documentação</a>.
///
-**FastAPI** é todo baseado em Pydantic.
+O **FastAPI** é todo baseado em Pydantic.
Você verá muito mais disso na prática no [Tutorial - Guia do usuário](tutorial/index.md){.internal-link target=_blank}.
-## Type hints em **FastAPI**
+/// tip | Dica
+
+O Pydantic tem um comportamento especial quando você usa `Optional` ou `Union[Something, None]` sem um valor padrão. Você pode ler mais sobre isso na documentação do Pydantic sobre <a href="https://docs.pydantic.dev/2.3/usage/models/#required-fields" class="external-link" target="_blank">campos Opcionais Obrigatórios</a>.
+
+///
+
+
+## Type Hints com Metadados de Anotações
+
+O Python possui uma funcionalidade que nos permite incluir **<abbr title="Informação sobre a informação, neste caso, informação sobre o tipo, e.g. uma descrição.">metadados</abbr> adicionais** nos type hints utilizando `Annotated`.
+
+//// tab | Python 3.9+
+
+No Python 3.9, `Annotated` é parte da biblioteca padrão, então você pode importá-lo de `typing`.
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial013_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+Em versões abaixo do Python 3.9, você importa `Annotated` de `typing_extensions`.
+
+Ele já estará instalado com o **FastAPI**.
+
+```Python hl_lines="1 4"
+{!> ../../docs_src/python_types/tutorial013.py!}
+```
+
+////
+
+O Python em si não faz nada com este `Annotated`. E para editores e outras ferramentas, o tipo ainda é `str`.
+
+Mas você pode utilizar este espaço dentro do `Annotated` para fornecer ao **FastAPI** metadata adicional sobre como você deseja que a sua aplicação se comporte.
+
+O importante aqui de se lembrar é que **o primeiro *type parameter*** que você informar ao `Annotated` é o **tipo de fato**. O resto é apenas metadado para outras ferramentas.
+
+Por hora, você precisa apenas saber que o `Annotated` existe, e que ele é Python padrão. 😎
+
+Mais tarde você verá o quão **poderoso** ele pode ser.
+
+/// tip | Dica
+
+O fato de que isso é **Python padrão** significa que você ainda obtém a **melhor experiência de desenvolvedor possível** no seu editor, com as ferramentas que você utiliza para analisar e refatorar o seu código, etc. ✨
+
+E também que o seu código será muito compatível com diversas outras ferramentas e bibliotecas Python. 🚀
+
+///
+
+
+## Type hints no **FastAPI**
O **FastAPI** aproveita esses type hints para fazer várias coisas.
@@ -306,20 +579,20 @@ Com o **FastAPI**, você declara parâmetros com type hints e obtém:
* **Suporte ao editor**.
* **Verificações de tipo**.
-... e **FastAPI** usa as mesmas declarações para:
+... e o **FastAPI** usa as mesmas declarações para:
-* **Definir requisitos**: dos parâmetros do caminho da solicitação, parâmetros da consulta, cabeçalhos, corpos, dependências, etc.
+* **Definir requisitos**: dos parâmetros de rota, parâmetros da consulta, cabeçalhos, corpos, dependências, etc.
* **Converter dados**: da solicitação para o tipo necessário.
* **Validar dados**: provenientes de cada solicitação:
- * A geração de **erros automáticos** retornou ao cliente quando os dados são inválidos.
-* **Documente** a API usando OpenAPI:
+ * Gerando **erros automáticos** retornados ao cliente quando os dados são inválidos.
+* **Documentar** a API usando OpenAPI:
* que é usado pelas interfaces de usuário da documentação interativa automática.
Tudo isso pode parecer abstrato. Não se preocupe. Você verá tudo isso em ação no [Tutorial - Guia do usuário](tutorial/index.md){.internal-link target=_blank}.
O importante é que, usando tipos padrão de Python, em um único local (em vez de adicionar mais classes, decoradores, etc.), o **FastAPI** fará muito trabalho para você.
-/// info | "Informação"
+/// info | Informação
Se você já passou por todo o tutorial e voltou para ver mais sobre os tipos, um bom recurso é <a href = "https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html" class = "external-link "target =" _ blank "> a "cheat sheet" do `mypy` </a>.
From d7942aea2dd81f03aa85f41b7f04ae76226f287b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 15 Oct 2024 12:32:58 +0000
Subject: [PATCH 180/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b8aa738c5..02773b769 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Update Portuguese translation for `docs/pt/docs/python-types.md`. PR [#12428](https://github.com/fastapi/fastapi/pull/12428) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Add Russian translation for `docs/ru/docs/environment-variables.md`. PR [#12436](https://github.com/fastapi/fastapi/pull/12436) by [@wisderfin](https://github.com/wisderfin).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/resources/index.md`. PR [#12443](https://github.com/fastapi/fastapi/pull/12443) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/about/index.md`. PR [#12438](https://github.com/fastapi/fastapi/pull/12438) by [@codingjenny](https://github.com/codingjenny).
From 80ba3fc5db3234770d09166d1dffc70fbf1e5e20 Mon Sep 17 00:00:00 2001
From: YungYueh ChanLee <polo80456@gmail.com>
Date: Tue, 15 Oct 2024 20:33:07 +0800
Subject: [PATCH 181/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Traditional=20Chin?=
=?UTF-8?q?ese=20translation=20for=20`docs/zh-hant/docs/deployment/cloud.m?=
=?UTF-8?q?d`=20(#12440)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh-hant/docs/deployment/cloud.md | 17 +++++++++++++++++
1 file changed, 17 insertions(+)
create mode 100644 docs/zh-hant/docs/deployment/cloud.md
diff --git a/docs/zh-hant/docs/deployment/cloud.md b/docs/zh-hant/docs/deployment/cloud.md
new file mode 100644
index 000000000..5d645b6c2
--- /dev/null
+++ b/docs/zh-hant/docs/deployment/cloud.md
@@ -0,0 +1,17 @@
+# 在雲端部署 FastAPI
+
+你幾乎可以使用 **任何雲端供應商** 來部署你的 FastAPI 應用程式。
+
+在大多數情況下，主要的雲端供應商都有部署 FastAPI 的指南。
+
+## 雲端供應商 - 贊助商
+
+一些雲端供應商 ✨ [**贊助 FastAPI**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨，這確保了 FastAPI 及其 **生態系統** 持續健康地 **發展**。
+
+這也展現了他們對 FastAPI 和其 **社群**（包括你）的真正承諾，他們不僅希望為你提供 **優質的服務**，還希望確保你擁有一個 **良好且健康的框架**：FastAPI。🙇
+
+你可能會想嘗試他們的服務，以下有他們的指南：
+
+* <a href="https://docs.platform.sh/languages/python.html?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" class="external-link" target="_blank" >Platform.sh</a>
+* <a href="https://docs.porter.run/language-specific-guides/fastapi" class="external-link" target="_blank">Porter</a>
+* <a href="https://docs.withcoherence.com/" class="external-link" target="_blank">Coherence</a>
From 50639525bf0518a285544cae05eb4ad0b1fadb2e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 15 Oct 2024 12:34:11 +0000
Subject: [PATCH 182/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 02773b769..ebdf8820c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/deployment/cloud.md`. PR [#12440](https://github.com/fastapi/fastapi/pull/12440) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Update Portuguese translation for `docs/pt/docs/python-types.md`. PR [#12428](https://github.com/fastapi/fastapi/pull/12428) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Add Russian translation for `docs/ru/docs/environment-variables.md`. PR [#12436](https://github.com/fastapi/fastapi/pull/12436) by [@wisderfin](https://github.com/wisderfin).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/resources/index.md`. PR [#12443](https://github.com/fastapi/fastapi/pull/12443) by [@codingjenny](https://github.com/codingjenny).
From 71f2be23871ac1e368ae03f4ba40859b0e87071d Mon Sep 17 00:00:00 2001
From: leonardopaloschi <103431559+leonardopaloschi@users.noreply.github.com>
Date: Wed, 16 Oct 2024 04:44:45 -0300
Subject: [PATCH 183/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/response-headers.md`=20(#?=
=?UTF-8?q?12458)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/advanced/response-headers.md | 45 +++++++++++++++++++++++
1 file changed, 45 insertions(+)
create mode 100644 docs/pt/docs/advanced/response-headers.md
diff --git a/docs/pt/docs/advanced/response-headers.md b/docs/pt/docs/advanced/response-headers.md
new file mode 100644
index 000000000..d1958e46b
--- /dev/null
+++ b/docs/pt/docs/advanced/response-headers.md
@@ -0,0 +1,45 @@
+# Cabeçalhos de resposta
+
+## Usando um parâmetro `Response`
+
+Você pode declarar um parâmetro do tipo `Response` na sua *função de operação de rota* (assim como você pode fazer para cookies).
+
+Então você pode definir os cabeçalhos nesse objeto de resposta *temporário*.
+
+```Python hl_lines="1 7-8"
+{!../../docs_src/response_headers/tutorial002.py!}
+```
+
+Em seguida você pode retornar qualquer objeto que precisar, da maneira que faria normalmente (um `dict`, um modelo de banco de dados, etc.).
+
+Se você declarou um `response_model`, ele ainda será utilizado para filtrar e converter o objeto que você retornou.
+
+**FastAPI** usará essa resposta *temporária* para extrair os cabeçalhos (cookies e código de status também) e os colocará na resposta final que contém o valor que você retornou, filtrado por qualquer `response_model`.
+
+Você também pode declarar o parâmetro `Response` em dependências e definir cabeçalhos (e cookies) nelas.
+
+## Retornar uma `Response` diretamente
+
+Você também pode adicionar cabeçalhos quando retornar uma `Response` diretamente.
+
+Crie uma resposta conforme descrito em [Retornar uma resposta diretamente](response-directly.md){.internal-link target=_blank} e passe os cabeçalhos como um parâmetro adicional:
+
+```Python hl_lines="10-12"
+{!../../docs_src/response_headers/tutorial001.py!}
+```
+
+/// note | "Detalhes técnicos"
+
+Você também pode usar `from starlette.responses import Response` ou `from starlette.responses import JSONResponse`.
+
+**FastAPI** fornece as mesmas `starlette.responses` como `fastapi.responses` apenas como uma conveniência para você, desenvolvedor. Mas a maioria das respostas disponíveis vem diretamente do Starlette.
+
+E como a `Response` pode ser usada frequentemente para definir cabeçalhos e cookies, **FastAPI** também a fornece em `fastapi.Response`.
+
+///
+
+## Cabeçalhos personalizados
+
+Tenha em mente que cabeçalhos personalizados proprietários podem ser adicionados <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers" class="external-link" target="_blank">usando o prefixo 'X-'</a>.
+
+Porém, se voce tiver cabeçalhos personalizados que deseja que um cliente no navegador possa ver, você precisa adicioná-los às suas configurações de CORS (saiba mais em [CORS (Cross-Origin Resource Sharing)](../tutorial/cors.md){.internal-link target=_blank}), usando o parâmetro `expose_headers` descrito na <a href="https://www.starlette.io/middleware/#corsmiddleware" class="external-link" target="_blank">documentação de CORS do Starlette</a>.
From febf6b6a52e36e0d64920fb54670ad7fc29b2eaa Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 16 Oct 2024 07:45:07 +0000
Subject: [PATCH 184/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ebdf8820c..165e1dea6 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/response-headers.md`. PR [#12458](https://github.com/fastapi/fastapi/pull/12458) by [@leonardopaloschi](https://github.com/leonardopaloschi).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/deployment/cloud.md`. PR [#12440](https://github.com/fastapi/fastapi/pull/12440) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Update Portuguese translation for `docs/pt/docs/python-types.md`. PR [#12428](https://github.com/fastapi/fastapi/pull/12428) by [@ceb10n](https://github.com/ceb10n).
* 🌐 Add Russian translation for `docs/ru/docs/environment-variables.md`. PR [#12436](https://github.com/fastapi/fastapi/pull/12436) by [@wisderfin](https://github.com/wisderfin).
From ac3c2dd96522ca2ec653d95829f7166c96794a5e Mon Sep 17 00:00:00 2001
From: Luis Rodrigues <103431660+devluisrodrigues@users.noreply.github.com>
Date: Fri, 18 Oct 2024 09:02:35 -0300
Subject: [PATCH 185/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/how-to/custom-docs-ui-assets.md`?=
=?UTF-8?q?=20(#12473)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/how-to/custom-docs-ui-assets.md | 205 +++++++++++++++++++
1 file changed, 205 insertions(+)
create mode 100644 docs/pt/docs/how-to/custom-docs-ui-assets.md
diff --git a/docs/pt/docs/how-to/custom-docs-ui-assets.md b/docs/pt/docs/how-to/custom-docs-ui-assets.md
new file mode 100644
index 000000000..00dd144c9
--- /dev/null
+++ b/docs/pt/docs/how-to/custom-docs-ui-assets.md
@@ -0,0 +1,205 @@
+# Recursos Estáticos Personalizados para a UI de Documentação (Hospedagem Própria)
+
+A documentação da API usa **Swagger UI** e **ReDoc**, e cada um deles precisa de alguns arquivos JavaScript e CSS.
+
+Por padrão, esses arquivos são fornecidos por um <abbr title="Content Delivery Network: Um serviço, normalmente composto por vários servidores, que fornece arquivos estáticos, como JavaScript e CSS. É comumente usado para providenciar esses arquivos do servidor mais próximo do cliente, melhorando o desempenho.">CDN</abbr>.
+
+Mas é possível personalizá-los, você pode definir um CDN específico ou providenciar os arquivos você mesmo.
+
+## CDN Personalizado para JavaScript e CSS
+
+Vamos supor que você deseja usar um <abbr title="Content Delivery Network">CDN</abbr> diferente, por exemplo, você deseja usar `https://unpkg.com/`.
+
+Isso pode ser útil se, por exemplo, você mora em um país que restringe algumas URLs.
+
+### Desativar a documentação automática
+
+O primeiro passo é desativar a documentação automática, pois por padrão, ela usa o CDN padrão.
+
+Para desativá-los, defina suas URLs como `None` ao criar seu aplicativo `FastAPI`:
+
+```Python hl_lines="8"
+{!../../docs_src/custom_docs_ui/tutorial001.py!}
+```
+
+### Incluir a documentação personalizada
+
+Agora você pode criar as *operações de rota* para a documentação personalizada.
+
+Você pode reutilizar as funções internas do FastAPI para criar as páginas HTML para a documentação e passar os argumentos necessários:
+
+* `openapi_url`: a URL onde a página HTML para a documentação pode obter o esquema OpenAPI para a sua API. Você pode usar aqui o atributo `app.openapi_url`.
+* `title`: o título da sua API.
+* `oauth2_redirect_url`: você pode usar `app.swagger_ui_oauth2_redirect_url` aqui para usar o padrão.
+* `swagger_js_url`: a URL onde a página HTML para a sua documentação do Swagger UI pode obter o arquivo **JavaScript**. Este é o URL do CDN personalizado.
+* `swagger_css_url`: a URL onde a página HTML para a sua documentação do Swagger UI pode obter o arquivo **CSS**. Este é o URL do CDN personalizado.
+
+E de forma semelhante para o ReDoc...
+
+```Python hl_lines="2-6 11-19 22-24 27-33"
+{!../../docs_src/custom_docs_ui/tutorial001.py!}
+```
+
+/// tip | Dica
+
+A *operação de rota* para `swagger_ui_redirect` é um auxiliar para quando você usa OAuth2.
+
+Se você integrar sua API com um provedor OAuth2, você poderá autenticar e voltar para a documentação da API com as credenciais adquiridas. E interagir com ela usando a autenticação OAuth2 real.
+
+Swagger UI lidará com isso nos bastidores para você, mas ele precisa desse auxiliar de "redirecionamento".
+
+///
+
+### Criar uma *operação de rota* para testar
+
+Agora, para poder testar se tudo funciona, crie uma *operação de rota*:
+
+```Python hl_lines="36-38"
+{!../../docs_src/custom_docs_ui/tutorial001.py!}
+```
+
+### Teste
+
+Agora, você deve ser capaz de ir para a documentação em <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>, e recarregar a página, ela carregará esses recursos do novo CDN.
+
+## Hospedagem Própria de JavaScript e CSS para a documentação
+
+Hospedar o JavaScript e o CSS pode ser útil se, por exemplo, você precisa que seu aplicativo continue funcionando mesmo offline, sem acesso aberto à Internet, ou em uma rede local.
+
+Aqui você verá como providenciar esses arquivos você mesmo, no mesmo aplicativo FastAPI, e configurar a documentação para usá-los.
+
+### Estrutura de Arquivos do Projeto
+
+Vamos supor que a estrutura de arquivos do seu projeto se pareça com isso:
+
+```
+.
+├── app
+│ ├── __init__.py
+│ ├── main.py
+```
+
+Agora crie um diretório para armazenar esses arquivos estáticos.
+
+Sua nova estrutura de arquivos poderia se parecer com isso:
+
+```
+.
+├── app
+│ ├── __init__.py
+│ ├── main.py
+└── static/
+```
+
+### Baixe os arquivos
+
+Baixe os arquivos estáticos necessários para a documentação e coloque-os no diretório `static/`.
+
+Você provavelmente pode clicar com o botão direito em cada link e selecionar uma opção semelhante a `Salvar link como...`.
+
+**Swagger UI** usa os arquivos:
+
+* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js" class="external-link" target="_blank">`swagger-ui-bundle.js`</a>
+* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css" class="external-link" target="_blank">`swagger-ui.css`</a>
+
+E o **ReDoc** usa os arquivos:
+
+* <a href="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js" class="external-link" target="_blank">`redoc.standalone.js`</a>
+
+Depois disso, sua estrutura de arquivos deve se parecer com:
+
+```
+.
+├── app
+│ ├── __init__.py
+│ ├── main.py
+└── static
+ ├── redoc.standalone.js
+ ├── swagger-ui-bundle.js
+ └── swagger-ui.css
+```
+
+### Prover os arquivos estáticos
+
+* Importe `StaticFiles`.
+* "Monte" a instância `StaticFiles()` em um caminho específico.
+
+```Python hl_lines="7 11"
+{!../../docs_src/custom_docs_ui/tutorial002.py!}
+```
+
+### Teste os arquivos estáticos
+
+Inicialize seu aplicativo e vá para <a href="http://127.0.0.1:8000/static/redoc.standalone.js" class="external-link" target="_blank">http://127.0.0.1:8000/static/redoc.standalone.js</a>.
+
+Você deverá ver um arquivo JavaScript muito longo para o **ReDoc**.
+
+Esse arquivo pode começar com algo como:
+
+```JavaScript
+/*!
+ * ReDoc - OpenAPI/Swagger-generated API Reference Documentation
+ * -------------------------------------------------------------
+ * Version: "2.0.0-rc.18"
+ * Repo: https://github.com/Redocly/redoc
+ */
+!function(e,t){"object"==typeof exports&&"object"==typeof m
+
+...
+```
+
+Isso confirma que você está conseguindo fornecer arquivos estáticos do seu aplicativo e que você colocou os arquivos estáticos para a documentação no local correto.
+
+Agora, podemos configurar o aplicativo para usar esses arquivos estáticos para a documentação.
+
+### Desativar a documentação automática para arquivos estáticos
+
+Da mesma forma que ao usar um CDN personalizado, o primeiro passo é desativar a documentação automática, pois ela usa o CDN padrão.
+
+Para desativá-los, defina suas URLs como `None` ao criar seu aplicativo `FastAPI`:
+
+```Python hl_lines="9"
+{!../../docs_src/custom_docs_ui/tutorial002.py!}
+```
+
+### Incluir a documentação personalizada para arquivos estáticos
+
+E da mesma forma que com um CDN personalizado, agora você pode criar as *operações de rota* para a documentação personalizada.
+
+Novamente, você pode reutilizar as funções internas do FastAPI para criar as páginas HTML para a documentação e passar os argumentos necessários:
+
+* `openapi_url`: a URL onde a página HTML para a documentação pode obter o esquema OpenAPI para a sua API. Você pode usar aqui o atributo `app.openapi_url`.
+* `title`: o título da sua API.
+* `oauth2_redirect_url`: Você pode usar `app.swagger_ui_oauth2_redirect_url` aqui para usar o padrão.
+* `swagger_js_url`: a URL onde a página HTML para a sua documentação do Swagger UI pode obter o arquivo **JavaScript**. Este é o URL do CDN personalizado. **Este é o URL que seu aplicativo está fornecendo**.
+* `swagger_css_url`: a URL onde a página HTML para a sua documentação do Swagger UI pode obter o arquivo **CSS**. **Esse é o que seu aplicativo está fornecendo**.
+
+E de forma semelhante para o ReDoc...
+
+```Python hl_lines="2-6 14-22 25-27 30-36"
+{!../../docs_src/custom_docs_ui/tutorial002.py!}
+```
+
+/// tip | Dica
+
+A *operação de rota* para `swagger_ui_redirect` é um auxiliar para quando você usa OAuth2.
+
+Se você integrar sua API com um provedor OAuth2, você poderá autenticar e voltar para a documentação da API com as credenciais adquiridas. E, então, interagir com ela usando a autenticação OAuth2 real.
+
+Swagger UI lidará com isso nos bastidores para você, mas ele precisa desse auxiliar de "redirect".
+
+///
+
+### Criar uma *operação de rota* para testar arquivos estáticos
+
+Agora, para poder testar se tudo funciona, crie uma *operação de rota*:
+
+```Python hl_lines="39-41"
+{!../../docs_src/custom_docs_ui/tutorial002.py!}
+```
+
+### Teste a UI de Arquivos Estáticos
+
+Agora, você deve ser capaz de desconectar o WiFi, ir para a documentação em <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>, e recarregar a página.
+
+E mesmo sem Internet, você será capaz de ver a documentação da sua API e interagir com ela.
From b7fb8eb65626e53b151a40c9ef423333dd2e0db7 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 18 Oct 2024 12:03:01 +0000
Subject: [PATCH 186/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 165e1dea6..df35e653f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/custom-docs-ui-assets.md`. PR [#12473](https://github.com/fastapi/fastapi/pull/12473) by [@devluisrodrigues](https://github.com/devluisrodrigues).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/response-headers.md`. PR [#12458](https://github.com/fastapi/fastapi/pull/12458) by [@leonardopaloschi](https://github.com/leonardopaloschi).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/deployment/cloud.md`. PR [#12440](https://github.com/fastapi/fastapi/pull/12440) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Update Portuguese translation for `docs/pt/docs/python-types.md`. PR [#12428](https://github.com/fastapi/fastapi/pull/12428) by [@ceb10n](https://github.com/ceb10n).
From 48849f8a11ad82e9dfbc5c399cc2687465f111ae Mon Sep 17 00:00:00 2001
From: Guilherme Rameh <62567654+GuilhermeRameh@users.noreply.github.com>
Date: Fri, 18 Oct 2024 09:04:04 -0300
Subject: [PATCH 187/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/how-to/testing-database.md`=20(#12?=
=?UTF-8?q?472)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/how-to/testing-database.md | 7 +++++++
1 file changed, 7 insertions(+)
create mode 100644 docs/pt/docs/how-to/testing-database.md
diff --git a/docs/pt/docs/how-to/testing-database.md b/docs/pt/docs/how-to/testing-database.md
new file mode 100644
index 000000000..02f909f24
--- /dev/null
+++ b/docs/pt/docs/how-to/testing-database.md
@@ -0,0 +1,7 @@
+# Testando a Base de Dados
+
+Você pode estudar sobre bases de dados, SQL e SQLModel na <a href="https://sqlmodel.tiangolo.com/" class="external-link" target="_blank">documentação de SQLModel</a>. 🤓
+
+Aqui tem um mini <a href="https://sqlmodel.tiangolo.com/tutorial/fastapi/" class="external-link" target="_blank">tutorial de como usar SQLModel com FastAPI</a>. ✨
+
+Esse tutorial inclui uma sessão sobre <a href="https://sqlmodel.tiangolo.com/tutorial/fastapi/tests/" class="external-link" target="_blank">testar bases de dados SQL</a>. 😎
From 7038bedc5dad0adfa578d0d2983defabf7d7da57 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 18 Oct 2024 12:05:45 +0000
Subject: [PATCH 188/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index df35e653f..d795d59ad 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/testing-database.md`. PR [#12472](https://github.com/fastapi/fastapi/pull/12472) by [@GuilhermeRameh](https://github.com/GuilhermeRameh).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/custom-docs-ui-assets.md`. PR [#12473](https://github.com/fastapi/fastapi/pull/12473) by [@devluisrodrigues](https://github.com/devluisrodrigues).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/response-headers.md`. PR [#12458](https://github.com/fastapi/fastapi/pull/12458) by [@leonardopaloschi](https://github.com/leonardopaloschi).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/deployment/cloud.md`. PR [#12440](https://github.com/fastapi/fastapi/pull/12440) by [@codingjenny](https://github.com/codingjenny).
From 53d90074e5996ed0a3c42d352d6d7edab299a43b Mon Sep 17 00:00:00 2001
From: YungYueh ChanLee <polo80456@gmail.com>
Date: Fri, 18 Oct 2024 20:10:00 +0800
Subject: [PATCH 189/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Traditional=20Chin?=
=?UTF-8?q?ese=20translation=20for=20`docs/zh-hant/docs/deployment/index.m?=
=?UTF-8?q?d`=20(#12439)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh-hant/docs/deployment/index.md | 21 +++++++++++++++++++++
1 file changed, 21 insertions(+)
create mode 100644 docs/zh-hant/docs/deployment/index.md
diff --git a/docs/zh-hant/docs/deployment/index.md b/docs/zh-hant/docs/deployment/index.md
new file mode 100644
index 000000000..e760b3d16
--- /dev/null
+++ b/docs/zh-hant/docs/deployment/index.md
@@ -0,0 +1,21 @@
+# 部署
+
+部署 **FastAPI** 應用程式相對容易。
+
+## 部署是什麼意思
+
+**部署** 應用程式指的是執行一系列必要的步驟，使其能夠 **讓使用者存取和使用**。
+
+對於一個 **Web API**，部署通常涉及將其放置在 **遠端伺服器** 上，並使用性能優良且穩定的 **伺服器程式**，確保使用者能夠高效、無中斷地存取應用程式，且不會遇到問題。
+
+這與 **開發** 階段形成鮮明對比，在 **開發** 階段，你會不斷更改程式碼、破壞程式碼、修復程式碼，然後停止和重新啟動伺服器等。
+
+## 部署策略
+
+根據你的使用場景和使用工具，有多種方法可以實現此目的。
+
+你可以使用一些工具自行 **部署伺服器**，你也可以使用能為你完成部分工作的 **雲端服務**，或其他可能的選項。
+
+我將向你展示在部署 **FastAPI** 應用程式時你可能應該記住的一些主要概念（儘管其中大部分適用於任何其他類型的 Web 應用程式）。
+
+在接下來的部分中，你將看到更多需要記住的細節以及一些技巧。 ✨
From b0761c2552c630a503cf21016ace3f6cc919c049 Mon Sep 17 00:00:00 2001
From: YungYueh ChanLee <polo80456@gmail.com>
Date: Fri, 18 Oct 2024 20:12:01 +0800
Subject: [PATCH 190/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Traditional=20Chin?=
=?UTF-8?q?ese=20translation=20for=20`docs/zh-hant/docs/fastapi-cli.md`=20?=
=?UTF-8?q?(#12444)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh-hant/docs/fastapi-cli.md | 83 ++++++++++++++++++++++++++++++++
1 file changed, 83 insertions(+)
create mode 100644 docs/zh-hant/docs/fastapi-cli.md
diff --git a/docs/zh-hant/docs/fastapi-cli.md b/docs/zh-hant/docs/fastapi-cli.md
new file mode 100644
index 000000000..3c644ce46
--- /dev/null
+++ b/docs/zh-hant/docs/fastapi-cli.md
@@ -0,0 +1,83 @@
+# FastAPI CLI
+
+**FastAPI CLI** 是一個命令列程式，能用來運行你的 FastAPI 應用程式、管理你的 FastAPI 專案等。
+
+當你安裝 FastAPI（例如使用 `pip install "fastapi[standard]"`），它會包含一個叫做 `fastapi-cli` 的套件，這個套件提供了 `fastapi` 命令。
+
+要運行你的 FastAPI 應用程式來進行開發，你可以使用 `fastapi dev` 命令：
+
+<div class="termy">
+
+```console
+$ <font color="#4E9A06">fastapi</font> dev <u style="text-decoration-style:single">main.py</u>
+<font color="#3465A4">INFO </font> Using path <font color="#3465A4">main.py</font>
+<font color="#3465A4">INFO </font> Resolved absolute path <font color="#75507B">/home/user/code/awesomeapp/</font><font color="#AD7FA8">main.py</font>
+<font color="#3465A4">INFO </font> Searching for package file structure from directories with <font color="#3465A4">__init__.py</font> files
+<font color="#3465A4">INFO </font> Importing from <font color="#75507B">/home/user/code/</font><font color="#AD7FA8">awesomeapp</font>
+
+ ╭─ <font color="#8AE234"><b>Python module file</b></font> ─╮
+ │ │
+ │ 🐍 main.py │
+ │ │
+ ╰──────────────────────╯
+
+<font color="#3465A4">INFO </font> Importing module <font color="#4E9A06">main</font>
+<font color="#3465A4">INFO </font> Found importable FastAPI app
+
+ ╭─ <font color="#8AE234"><b>Importable FastAPI app</b></font> ─╮
+ │ │
+ │ <span style="background-color:#272822"><font color="#FF4689">from</font></span><span style="background-color:#272822"><font color="#F8F8F2"> main </font></span><span style="background-color:#272822"><font color="#FF4689">import</font></span><span style="background-color:#272822"><font color="#F8F8F2"> app</font></span><span style="background-color:#272822"> </span> │
+ │ │
+ ╰──────────────────────────╯
+
+<font color="#3465A4">INFO </font> Using import string <font color="#8AE234"><b>main:app</b></font>
+
+ <span style="background-color:#C4A000"><font color="#2E3436">╭────────── FastAPI CLI - Development mode ───────────╮</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ Serving at: http://127.0.0.1:8000 │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ API docs: http://127.0.0.1:8000/docs │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ Running in development mode, for production use: │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ </font></span><span style="background-color:#C4A000"><font color="#555753"><b>fastapi run</b></font></span><span style="background-color:#C4A000"><font color="#2E3436"> │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">╰─────────────────────────────────────────────────────╯</font></span>
+
+<font color="#4E9A06">INFO</font>: Will watch for changes in these directories: ['/home/user/code/awesomeapp']
+<font color="#4E9A06">INFO</font>: Uvicorn running on <b>http://127.0.0.1:8000</b> (Press CTRL+C to quit)
+<font color="#4E9A06">INFO</font>: Started reloader process [<font color="#34E2E2"><b>2265862</b></font>] using <font color="#34E2E2"><b>WatchFiles</b></font>
+<font color="#4E9A06">INFO</font>: Started server process [<font color="#06989A">2265873</font>]
+<font color="#4E9A06">INFO</font>: Waiting for application startup.
+<font color="#4E9A06">INFO</font>: Application startup complete.
+```
+
+</div>
+
+`fastapi` 命令列程式就是 **FastAPI CLI**。
+
+FastAPI CLI 接收你的 Python 程式路徑（例如 `main.py`），並自動檢測 FastAPI 實例（通常命名為 `app`），確定正確的引入模組流程，然後運行該應用程式。
+
+在生產環境，你應該使用 `fastapi run` 命令。 🚀
+
+**FastAPI CLI** 內部使用了 <a href="https://www.uvicorn.org" class="external-link" target="_blank">Uvicorn</a>，這是一個高效能、適合生產環境的 ASGI 伺服器。 😎
+
+## `fastapi dev`
+
+執行 `fastapi dev` 會啟動開發模式。
+
+預設情況下，**auto-reload** 功能是啟用的，當你對程式碼進行修改時，伺服器會自動重新載入。這會消耗較多資源，並且可能比禁用時更不穩定。因此，你應該只在開發環境中使用此功能。它也會在 IP 位址 `127.0.0.1` 上監聽，這是用於你的機器與自身通訊的 IP 位址（`localhost`）。
+
+## `fastapi run`
+
+執行 `fastapi run` 會以生產模式啟動 FastAPI。
+
+預設情況下，**auto-reload** 功能是禁用的。它也會在 IP 位址 `0.0.0.0` 上監聽，表示會監聽所有可用的 IP 地址，這樣任何能與該機器通訊的人都可以公開存取它。這通常是你在生產環境中運行應用程式的方式，例如在容器中運行時。
+
+在大多數情況下，你會（也應該）有一個「終止代理」來處理 HTTPS，這取決於你如何部署你的應用程式，你的服務供應商可能會為你做這件事，或者你需要自己設置它。
+
+/// tip
+
+你可以在[部署文件](deployment/index.md){.internal-link target=_blank}中了解更多相關資訊。
+
+///
From f0b5f8adf785e7c36dbcad407d8c47655494f31b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 18 Oct 2024 12:12:24 +0000
Subject: [PATCH 191/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d795d59ad..fe056d237 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/deployment/index.md`. PR [#12439](https://github.com/fastapi/fastapi/pull/12439) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/testing-database.md`. PR [#12472](https://github.com/fastapi/fastapi/pull/12472) by [@GuilhermeRameh](https://github.com/GuilhermeRameh).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/custom-docs-ui-assets.md`. PR [#12473](https://github.com/fastapi/fastapi/pull/12473) by [@devluisrodrigues](https://github.com/devluisrodrigues).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/response-headers.md`. PR [#12458](https://github.com/fastapi/fastapi/pull/12458) by [@leonardopaloschi](https://github.com/leonardopaloschi).
From 5afa6d70666e4f6afee6eab91453d725f4b637a3 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 18 Oct 2024 12:13:10 +0000
Subject: [PATCH 192/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fe056d237..0afecc6d4 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/fastapi-cli.md`. PR [#12444](https://github.com/fastapi/fastapi/pull/12444) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/deployment/index.md`. PR [#12439](https://github.com/fastapi/fastapi/pull/12439) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/testing-database.md`. PR [#12472](https://github.com/fastapi/fastapi/pull/12472) by [@GuilhermeRameh](https://github.com/GuilhermeRameh).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/custom-docs-ui-assets.md`. PR [#12473](https://github.com/fastapi/fastapi/pull/12473) by [@devluisrodrigues](https://github.com/devluisrodrigues).
From 4c1a1938bc8d4440bd0014aca2576cd3374f401b Mon Sep 17 00:00:00 2001
From: Elton Jefferson <eltonjncorreia@gmail.com>
Date: Sun, 20 Oct 2024 16:20:23 -0300
Subject: [PATCH 193/504] =?UTF-8?q?=F0=9F=93=9D=20Fix=20broken=20link=20in?=
=?UTF-8?q?=20docs=20(#12495)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
README.md | 2 +-
docs/az/docs/index.md | 2 +-
docs/bn/docs/index.md | 2 +-
docs/de/docs/alternatives.md | 2 +-
docs/de/docs/index.md | 2 +-
docs/em/docs/alternatives.md | 2 +-
docs/em/docs/index.md | 2 +-
docs/en/docs/alternatives.md | 2 +-
docs/en/docs/index.md | 2 +-
docs/es/docs/index.md | 2 +-
docs/fa/docs/index.md | 2 +-
docs/fr/docs/alternatives.md | 2 +-
docs/fr/docs/index.md | 2 +-
docs/he/docs/index.md | 2 +-
docs/hu/docs/index.md | 2 +-
docs/it/docs/index.md | 2 +-
docs/ja/docs/index.md | 2 +-
docs/nl/docs/index.md | 2 +-
docs/pl/docs/index.md | 2 +-
docs/pt/docs/alternatives.md | 2 +-
docs/pt/docs/index.md | 2 +-
docs/ru/docs/alternatives.md | 2 +-
docs/ru/docs/index.md | 2 +-
docs/tr/docs/alternatives.md | 2 +-
docs/uk/docs/alternatives.md | 2 +-
docs/uk/docs/index.md | 2 +-
docs/vi/docs/index.md | 2 +-
docs/yo/docs/index.md | 2 +-
docs/zh-hant/docs/index.md | 2 +-
docs/zh/docs/index.md | 2 +-
30 files changed, 30 insertions(+), 30 deletions(-)
diff --git a/README.md b/README.md
index f274265de..a12e740f7 100644
--- a/README.md
+++ b/README.md
@@ -95,7 +95,7 @@ The key features are:
"_Honestly, what you've built looks super solid and polished. In many ways, it's what I wanted **Hug** to be - it's really inspiring to see someone build that._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/az/docs/index.md b/docs/az/docs/index.md
index b5d7f8f92..ad78d7d06 100644
--- a/docs/az/docs/index.md
+++ b/docs/az/docs/index.md
@@ -87,7 +87,7 @@ FastAPI Python ilə API yaratmaq üçün standart Python <abbr title="Tip Məsl
"_Düzünü desəm, sizin qurduğunuz şey həqiqətən möhkəm və peşəkar görünür. Bir çox cəhətdən **Hug**-un olmasını istədiyim kimdir - kiminsə belə bir şey qurduğunu görmək həqiqətən ruhlandırıcıdır._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/bn/docs/index.md b/docs/bn/docs/index.md
index c882506ff..678ac9ca9 100644
--- a/docs/bn/docs/index.md
+++ b/docs/bn/docs/index.md
@@ -85,7 +85,7 @@ FastAPI একটি আধুনিক, দ্রুত ( বেশি ক্
"\_সত্যিই, আপনি যা তৈরি করেছেন তা খুব মজবুত এবং পরিপূর্ন৷ অনেক উপায়ে, আমি যা **Hug** এ করতে চেয়েছিলাম - তা কাউকে তৈরি করতে দেখে আমি সত্যিই অনুপ্রানিত৷\_"
-<div style="text-align: right; margin-right: 10%;">টিমোথি ক্রসলে - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> স্রষ্টা</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">টিমোথি ক্রসলে - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> স্রষ্টা</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/de/docs/alternatives.md b/docs/de/docs/alternatives.md
index 286ef1723..49e1cc6f0 100644
--- a/docs/de/docs/alternatives.md
+++ b/docs/de/docs/alternatives.md
@@ -321,7 +321,7 @@ Das hat tatsächlich dazu geführt, dass Teile von Pydantic aktualisiert wurden,
///
-### <a href="https://www.hug.rest/" class="external-link" target="_blank">Hug</a>
+### <a href="https://github.com/hugapi/hug" class="external-link" target="_blank">Hug</a>
Hug war eines der ersten Frameworks, welches die Deklaration von API-Parametertypen mithilfe von Python-Typhinweisen implementierte. Das war eine großartige Idee, die andere Tools dazu inspirierte, dasselbe zu tun.
diff --git a/docs/de/docs/index.md b/docs/de/docs/index.md
index af024d18d..411c8e969 100644
--- a/docs/de/docs/index.md
+++ b/docs/de/docs/index.md
@@ -94,7 +94,7 @@ Seine Schlüssel-Merkmale sind:
„_Ehrlich, was Du gebaut hast, sieht super solide und poliert aus. In vielerlei Hinsicht ist es so, wie ich **Hug** haben wollte – es ist wirklich inspirierend, jemanden so etwas bauen zu sehen._“
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong>Autor von <a href="https://www.hug.rest/" target="_blank">Hug</a></strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(Ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong>Autor von <a href="https://github.com/hugapi/hug" target="_blank">Hug</a></strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(Ref)</small></a></div>
---
diff --git a/docs/em/docs/alternatives.md b/docs/em/docs/alternatives.md
index 334c0de73..5309de51f 100644
--- a/docs/em/docs/alternatives.md
+++ b/docs/em/docs/alternatives.md
@@ -321,7 +321,7 @@ APISpec ✍ 🎏 🍭 👩💻.
///
-### <a href="https://www.hug.rest/" class="external-link" target="_blank">🤗</a>
+### <a href="https://github.com/hugapi/hug" class="external-link" target="_blank">🤗</a>
🤗 🕐 🥇 🛠️ 🛠️ 📄 🛠️ 🔢 🆎 ⚙️ 🐍 🆎 🔑. 👉 👑 💭 👈 😮 🎏 🧰 🎏.
diff --git a/docs/em/docs/index.md b/docs/em/docs/index.md
index aa7542366..16b2019d3 100644
--- a/docs/em/docs/index.md
+++ b/docs/em/docs/index.md
@@ -93,7 +93,7 @@ FastAPI 🏛, ⏩ (↕-🎭), 🕸 🛠️ 🏗 🛠️ ⏮️ 🐍 3️⃣.8️
"_🤙, ⚫️❔ 👆 ✔️ 🏗 👀 💎 💠 & 🇵🇱. 📚 🌌, ⚫️ ⚫️❔ 👤 💚 **🤗** - ⚫️ 🤙 😍 👀 👱 🏗 👈._"
-<div style="text-align: right; margin-right: 10%;">✡ 🗄 - <strong><a href="https://www.hug.rest/" target="_blank">🤗</a> 👼</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(🇦🇪)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">✡ 🗄 - <strong><a href="https://github.com/hugapi/hug" target="_blank">🤗</a> 👼</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(🇦🇪)</small></a></div>
---
diff --git a/docs/en/docs/alternatives.md b/docs/en/docs/alternatives.md
index e98c0475a..f596232d3 100644
--- a/docs/en/docs/alternatives.md
+++ b/docs/en/docs/alternatives.md
@@ -321,7 +321,7 @@ This actually inspired updating parts of Pydantic, to support the same validatio
///
-### <a href="https://www.hug.rest/" class="external-link" target="_blank">Hug</a>
+### <a href="https://github.com/hugapi/hug" class="external-link" target="_blank">Hug</a>
Hug was one of the first frameworks to implement the declaration of API parameter types using Python type hints. This was a great idea that inspired other tools to do the same.
diff --git a/docs/en/docs/index.md b/docs/en/docs/index.md
index 3ed3d7bf6..4d0514241 100644
--- a/docs/en/docs/index.md
+++ b/docs/en/docs/index.md
@@ -93,7 +93,7 @@ The key features are:
"_Honestly, what you've built looks super solid and polished. In many ways, it's what I wanted **Hug** to be - it's really inspiring to see someone build that._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/es/docs/index.md b/docs/es/docs/index.md
index fe4912253..73d9b679e 100644
--- a/docs/es/docs/index.md
+++ b/docs/es/docs/index.md
@@ -90,7 +90,7 @@ Sus características principales son:
"_Honestly, what you've built looks super solid and polished. In many ways, it's what I wanted **Hug** to be - it's really inspiring to see someone build that._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/fa/docs/index.md b/docs/fa/docs/index.md
index 1ae566a9f..6addce763 100644
--- a/docs/fa/docs/index.md
+++ b/docs/fa/docs/index.md
@@ -90,7 +90,7 @@ FastAPI یک وب فریمورک مدرن و سریع (با کارایی با
<div style="text-align: left; direction: ltr;">"<em>Honestly, what you've built looks super solid and polished. In many ways, it's what I wanted <strong>Hug</strong> to be - it's really inspiring to see someone build that."</em></div>
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/fr/docs/alternatives.md b/docs/fr/docs/alternatives.md
index 059a60b69..d2438dc36 100644
--- a/docs/fr/docs/alternatives.md
+++ b/docs/fr/docs/alternatives.md
@@ -351,7 +351,7 @@ Cela a en fait inspiré la mise à jour de certaines parties de Pydantic, afin d
///
-### <a href="https://www.hug.rest/" class="external-link" target="_blank">Hug</a>
+### <a href="https://github.com/hugapi/hug" class="external-link" target="_blank">Hug</a>
Hug a été l'un des premiers frameworks à implémenter la déclaration des types de paramètres d'API en utilisant les type hints Python. C'était une excellente idée qui a inspiré d'autres outils à faire de même.
diff --git a/docs/fr/docs/index.md b/docs/fr/docs/index.md
index dccefdd5a..695429008 100644
--- a/docs/fr/docs/index.md
+++ b/docs/fr/docs/index.md
@@ -93,7 +93,7 @@ Les principales fonctionnalités sont :
"_Honnêtement, ce que vous avez construit a l'air super solide et élégant. A bien des égards, c'est comme ça que je voulais que **Hug** soit - c'est vraiment inspirant de voir quelqu'un construire ça._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong> Créateur de <a href="https://www.hug.rest/" target="_blank">Hug</a></strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong> Créateur de <a href="https://github.com/hugapi/hug" target="_blank">Hug</a></strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/he/docs/index.md b/docs/he/docs/index.md
index 23a2eb824..6498d15e1 100644
--- a/docs/he/docs/index.md
+++ b/docs/he/docs/index.md
@@ -94,7 +94,7 @@ FastAPI היא תשתית רשת מודרנית ומהירה (ביצועים ג
"_Honestly, what you've built looks super solid and polished. In many ways, it's what I wanted **Hug** to be - it's really inspiring to see someone build that._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/hu/docs/index.md b/docs/hu/docs/index.md
index 8e326a78b..c6f596650 100644
--- a/docs/hu/docs/index.md
+++ b/docs/hu/docs/index.md
@@ -87,7 +87,7 @@ Kulcs funkciók:
"_Honestly, what you've built looks super solid and polished. In many ways, it's what I wanted **Hug** to be - it's really inspiring to see someone build that._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/it/docs/index.md b/docs/it/docs/index.md
index 3bfff82f1..8a1039bc5 100644
--- a/docs/it/docs/index.md
+++ b/docs/it/docs/index.md
@@ -84,7 +84,7 @@ Le sue caratteristiche principali sono:
"_Honestly, what you've built looks super solid and polished. In many ways, it's what I wanted **Hug** to be - it's really inspiring to see someone build that._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/ja/docs/index.md b/docs/ja/docs/index.md
index 72a0e98bc..682c94e83 100644
--- a/docs/ja/docs/index.md
+++ b/docs/ja/docs/index.md
@@ -91,7 +91,7 @@ FastAPI は、Pythonの標準である型ヒントに基づいてPython 以降
"_正直、超堅実で洗練されているように見えます。いろんな意味で、それは私がハグしたかったものです。_"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/nl/docs/index.md b/docs/nl/docs/index.md
index 8edc3ba0c..d88bb7771 100644
--- a/docs/nl/docs/index.md
+++ b/docs/nl/docs/index.md
@@ -93,7 +93,7 @@ De belangrijkste kenmerken zijn:
"_Wat je hebt gebouwd ziet er echt super solide en gepolijst uit. In veel opzichten is het wat ik wilde dat **Hug** kon zijn - het is echt inspirerend om iemand dit te zien bouwen._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/pl/docs/index.md b/docs/pl/docs/index.md
index e591e1c9d..9a96c6553 100644
--- a/docs/pl/docs/index.md
+++ b/docs/pl/docs/index.md
@@ -90,7 +90,7 @@ Kluczowe cechy:
"_Honestly, what you've built looks super solid and polished. In many ways, it's what I wanted **Hug** to be - it's really inspiring to see someone build that._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/pt/docs/alternatives.md b/docs/pt/docs/alternatives.md
index d3a304fa7..2a2632bbc 100644
--- a/docs/pt/docs/alternatives.md
+++ b/docs/pt/docs/alternatives.md
@@ -323,7 +323,7 @@ Isso na verdade inspirou a atualização de partes do Pydantic, para dar suporte
///
-### <a href="https://www.hug.rest/" class="external-link" target="_blank">Hug</a>
+### <a href="https://github.com/hugapi/hug" class="external-link" target="_blank">Hug</a>
Hug foi um dos primeiros frameworks a implementar a declaração de tipos de parâmetros usando Python _type hints_. Isso foi uma ótima idéia que inspirou outras ferramentas a fazer o mesmo.
diff --git a/docs/pt/docs/index.md b/docs/pt/docs/index.md
index f99144617..bc23114dc 100644
--- a/docs/pt/docs/index.md
+++ b/docs/pt/docs/index.md
@@ -78,7 +78,7 @@ Os recursos chave são:
"*Honestamente, o que você construiu parece super sólido e rebuscado. De muitas formas, eu queria que o **Hug** fosse assim - é realmente inspirador ver alguém que construiu ele.*"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong>criador do<a href="https://www.hug.rest/" target="_blank">Hug</a></strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong>criador do<a href="https://github.com/hugapi/hug" target="_blank">Hug</a></strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/ru/docs/alternatives.md b/docs/ru/docs/alternatives.md
index 413bf70b2..f83024ad9 100644
--- a/docs/ru/docs/alternatives.md
+++ b/docs/ru/docs/alternatives.md
@@ -357,7 +357,7 @@ Molten мне попался на начальной стадии написан
///
-### <a href="https://www.hug.rest/" class="external-link" target="_blank">Hug</a>
+### <a href="https://github.com/hugapi/hug" class="external-link" target="_blank">Hug</a>
Hug был одним из первых фреймворков, реализовавших объявление параметров API с использованием подсказок типов Python.
Эта отличная идея была использована и другими инструментами.
diff --git a/docs/ru/docs/index.md b/docs/ru/docs/index.md
index 3aa4d82d0..5ebe1494b 100644
--- a/docs/ru/docs/index.md
+++ b/docs/ru/docs/index.md
@@ -93,7 +93,7 @@ FastAPI — это современный, быстрый (высокопрои
"_Честно говоря, то, что вы создали, выглядит очень солидно и отполировано. Во многих смыслах я хотел, чтобы **Hug** был именно таким — это действительно вдохновляет, когда кто-то создаёт такое._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/tr/docs/alternatives.md b/docs/tr/docs/alternatives.md
index bd668ca45..286b7897a 100644
--- a/docs/tr/docs/alternatives.md
+++ b/docs/tr/docs/alternatives.md
@@ -319,7 +319,7 @@ Bu aslında Pydantic'in de aynı doğrulama stiline geçmesinde ilham kaynağı
///
-### <a href="https://www.hug.rest/" class="external-link" target="_blank">Hug</a>
+### <a href="https://github.com/hugapi/hug" class="external-link" target="_blank">Hug</a>
Hug, Python tip belirteçlerini kullanarak API parametrelerinin tipini belirlemeyi uygulayan ilk framework'lerdendi. Bu, diğer araçlara da ilham kaynağı olan harika bir fikirdi.
diff --git a/docs/uk/docs/alternatives.md b/docs/uk/docs/alternatives.md
index eb48d6be7..6821ffe70 100644
--- a/docs/uk/docs/alternatives.md
+++ b/docs/uk/docs/alternatives.md
@@ -321,7 +321,7 @@ Falcon — ще один високопродуктивний фреймворк
///
-### <a href="https://www.hug.rest/" class="external-link" target="_blank">Hug</a>
+### <a href="https://github.com/hugapi/hug" class="external-link" target="_blank">Hug</a>
Hug був одним із перших фреймворків, який реалізував оголошення типів параметрів API за допомогою підказок типу Python. Це була чудова ідея, яка надихнула інші інструменти зробити те саме.
diff --git a/docs/uk/docs/index.md b/docs/uk/docs/index.md
index 4c8c54af2..012bac2e2 100644
--- a/docs/uk/docs/index.md
+++ b/docs/uk/docs/index.md
@@ -88,7 +88,7 @@ FastAPI - це сучасний, швидкий (високопродуктив
"_Honestly, what you've built looks super solid and polished. In many ways, it's what I wanted **Hug** to be - it's really inspiring to see someone build that._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/vi/docs/index.md b/docs/vi/docs/index.md
index 09deac6f2..5e346ded8 100644
--- a/docs/vi/docs/index.md
+++ b/docs/vi/docs/index.md
@@ -93,7 +93,7 @@ Những tính năng như:
"_Thành thật, những gì bạn đã xây dựng nhìn siêu chắc chắn và bóng bẩy. Theo nhiều cách, nó là những gì tôi đã muốn Hug trở thành - thật sự truyền cảm hứng để thấy ai đó xây dựng nó._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - người tạo ra <strong><a href="https://www.hug.rest/" target="_blank">Hug</a></strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - người tạo ra <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a></strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/yo/docs/index.md b/docs/yo/docs/index.md
index ee7f56220..3ad1483de 100644
--- a/docs/yo/docs/index.md
+++ b/docs/yo/docs/index.md
@@ -93,7 +93,7 @@ FastAPI jẹ́ ìgbàlódé, tí ó yára (iṣẹ-giga), ìlànà wẹ́ẹ́b
"_Ní tòótọ́, ohun tí o kọ dára ó sì tún dán. Ní ọ̀pọ̀lọpọ̀ ọ̀nà, ohun tí mo fẹ́ kí **Hug** jẹ́ nìyẹn - ó wúni lórí gan-an láti rí ẹnìkan tí ó kọ́ nǹkan bí èyí._"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/zh-hant/docs/index.md b/docs/zh-hant/docs/index.md
index d260b5b79..137a17284 100644
--- a/docs/zh-hant/docs/index.md
+++ b/docs/zh-hant/docs/index.md
@@ -87,7 +87,7 @@ FastAPI 是一個現代、快速（高效能）的 web 框架，用於 Python
"_老實說，你建造的東西看起來非常堅固和精緻。在很多方面，這就是我想要的，看到有人建造它真的很鼓舞人心。_"
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
diff --git a/docs/zh/docs/index.md b/docs/zh/docs/index.md
index 777240ec2..d3e9e3112 100644
--- a/docs/zh/docs/index.md
+++ b/docs/zh/docs/index.md
@@ -94,7 +94,7 @@ FastAPI 是一个用于构建 API 的现代、快速（高性能）的 web 框
「_老实说，你的作品看起来非常可靠和优美。在很多方面，这就是我想让 **Hug** 成为的样子 - 看到有人实现了它真的很鼓舞人心。_」
-<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> 作者</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://github.com/hugapi/hug" target="_blank">Hug</a> 作者</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
---
From 45822d31f265861dff27e9d2a935c87aafb101b3 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 20 Oct 2024 19:20:44 +0000
Subject: [PATCH 194/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 0afecc6d4..1279ac3f1 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Docs
+
+* 📝 Fix broken link in docs. PR [#12495](https://github.com/fastapi/fastapi/pull/12495) by [@eltonjncorreia](https://github.com/eltonjncorreia).
+
### Translations
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/fastapi-cli.md`. PR [#12444](https://github.com/fastapi/fastapi/pull/12444) by [@codingjenny](https://github.com/codingjenny).
From c4f8143dea31699bf015ad3c885f91c68788abfb Mon Sep 17 00:00:00 2001
From: Marcel Hellkamp <marc@gsites.de>
Date: Tue, 22 Oct 2024 16:19:56 +0200
Subject: [PATCH 195/504] =?UTF-8?q?=E2=AC=86=EF=B8=8F=20Upgrade=20Starlett?=
=?UTF-8?q?e=20to=20`>=3D0.40.0,<0.42.0`=20(#12469)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
pyproject.toml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/pyproject.toml b/pyproject.toml
index c934356d8..edfa81522 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -41,7 +41,7 @@ classifiers = [
"Topic :: Internet :: WWW/HTTP",
]
dependencies = [
- "starlette>=0.37.2,<0.41.0",
+ "starlette>=0.40.0,<0.42.0",
"pydantic>=1.7.4,!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0",
"typing-extensions>=4.8.0",
]
From 9c794c9c0d0a10e3bc3516624d30ccaca22f1e18 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 22 Oct 2024 14:20:24 +0000
Subject: [PATCH 196/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 1279ac3f1..9cd739cf1 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Upgrades
+
+* ⬆️ Upgrade Starlette to `>=0.40.0,<0.42.0`. PR [#12469](https://github.com/fastapi/fastapi/pull/12469) by [@defnull](https://github.com/defnull).
+
### Docs
* 📝 Fix broken link in docs. PR [#12495](https://github.com/fastapi/fastapi/pull/12495) by [@eltonjncorreia](https://github.com/eltonjncorreia).
From c519614b45009e7d51f010e82b0ddf77a327e327 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 22 Oct 2024 15:26:52 +0100
Subject: [PATCH 197/504] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
=?UTF-8?q?5.3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 2 ++
fastapi/__init__.py | 2 +-
2 files changed, 3 insertions(+), 1 deletion(-)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9cd739cf1..be8f67ad6 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
## Latest Changes
+## 0.115.3
+
### Upgrades
* ⬆️ Upgrade Starlette to `>=0.40.0,<0.42.0`. PR [#12469](https://github.com/fastapi/fastapi/pull/12469) by [@defnull](https://github.com/defnull).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 77b52f35b..64d5dd39b 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
"""FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
-__version__ = "0.115.2"
+__version__ = "0.115.3"
from starlette import status as status
From 94fafa5030e0c1c036359e5b3d7b3db7b4b2114d Mon Sep 17 00:00:00 2001
From: Fernando Alzueta <fefealzueta@gmail.com>
Date: Tue, 22 Oct 2024 14:33:00 -0300
Subject: [PATCH 198/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/how-to/custom-request-and-route.md?=
=?UTF-8?q?`=20(#12483)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../docs/how-to/custom-request-and-route.md | 121 ++++++++++++++++++
1 file changed, 121 insertions(+)
create mode 100644 docs/pt/docs/how-to/custom-request-and-route.md
diff --git a/docs/pt/docs/how-to/custom-request-and-route.md b/docs/pt/docs/how-to/custom-request-and-route.md
new file mode 100644
index 000000000..64325eed9
--- /dev/null
+++ b/docs/pt/docs/how-to/custom-request-and-route.md
@@ -0,0 +1,121 @@
+# Requisições Personalizadas e Classes da APIRoute
+
+Em algum casos, você pode querer sobreescrever a lógica usada pelas classes `Request`e `APIRoute`.
+
+Em particular, isso pode ser uma boa alternativa para uma lógica em um middleware
+
+Por exemplo, se você quiser ler ou manipular o corpo da requisição antes que ele seja processado pela sua aplicação.
+
+/// danger | Perigo
+
+Isso é um recurso "avançado".
+
+Se você for um iniciante em **FastAPI** você deve considerar pular essa seção.
+
+///
+
+## Casos de Uso
+
+Alguns casos de uso incluem:
+
+* Converter requisições não-JSON para JSON (por exemplo, <a href="https://msgpack.org/index.html" class="external-link" target="_blank">`msgpack`</a>).
+* Descomprimir corpos de requisição comprimidos com gzip.
+* Registrar automaticamente todos os corpos de requisição.
+
+## Manipulando codificações de corpo de requisição personalizadas
+
+Vamos ver como usar uma subclasse personalizada de `Request` para descomprimir requisições gzip.
+
+E uma subclasse de `APIRoute` para usar essa classe de requisição personalizada.
+
+### Criar uma classe `GzipRequest` personalizada
+
+/// tip | Dica
+
+Isso é um exemplo de brincadeira para demonstrar como funciona, se você precisar de suporte para Gzip, você pode usar o [`GzipMiddleware`](../advanced/middleware.md#gzipmiddleware){.internal-link target=_blank} fornecido.
+
+///
+
+Primeiro, criamos uma classe `GzipRequest`, que irá sobrescrever o método `Request.body()` para descomprimir o corpo na presença de um cabeçalho apropriado.
+
+Se não houver `gzip` no cabeçalho, ele não tentará descomprimir o corpo.
+
+Dessa forma, a mesma classe de rota pode lidar com requisições comprimidas ou não comprimidas.
+
+```Python hl_lines="8-15"
+{!../../docs_src/custom_request_and_route/tutorial001.py!}
+```
+
+### Criar uma classe `GzipRoute` personalizada
+
+Em seguida, criamos uma subclasse personalizada de `fastapi.routing.APIRoute` que fará uso do `GzipRequest`.
+
+Dessa vez, ele irá sobrescrever o método `APIRoute.get_route_handler()`.
+
+Esse método retorna uma função. E essa função é o que irá receber uma requisição e retornar uma resposta.
+
+Aqui nós usamos para criar um `GzipRequest` a partir da requisição original.
+
+```Python hl_lines="18-26"
+{!../../docs_src/custom_request_and_route/tutorial001.py!}
+```
+
+/// note | Detalhes Técnicos
+
+Um `Request` também tem um `request.receive`, que é uma função para "receber" o corpo da requisição.
+
+Um `Request` também tem um `request.receive`, que é uma função para "receber" o corpo da requisição.
+
+O dicionário `scope` e a função `receive` são ambos parte da especificação ASGI.
+
+E essas duas coisas, `scope` e `receive`, são o que é necessário para criar uma nova instância de `Request`.
+
+Para aprender mais sobre o `Request` confira a <a href="https://www.starlette.io/requests/" class="external-link" target="_blank">documentação do Starlette sobre Requests</a>.
+
+///
+
+A única coisa que a função retornada por `GzipRequest.get_route_handler` faz de diferente é converter o `Request` para um `GzipRequest`.
+
+Fazendo isso, nosso `GzipRequest` irá cuidar de descomprimir os dados (se necessário) antes de passá-los para nossas *operações de rota*.
+
+Depois disso, toda a lógica de processamento é a mesma.
+
+Mas por causa das nossas mudanças em `GzipRequest.body`, o corpo da requisição será automaticamente descomprimido quando for carregado pelo **FastAPI** quando necessário.
+
+## Acessando o corpo da requisição em um manipulador de exceção
+
+/// tip | Dica
+
+Para resolver esse mesmo problema, é provavelmente muito mais fácil usar o `body` em um manipulador personalizado para `RequestValidationError` ([Tratando Erros](../tutorial/handling-errors.md#use-the-requestvalidationerror-body){.internal-link target=_blank}).
+
+Mas esse exemplo ainda é valido e mostra como interagir com os componentes internos.
+
+///
+
+Também podemos usar essa mesma abordagem para acessar o corpo da requisição em um manipulador de exceção.
+
+Tudo que precisamos fazer é manipular a requisição dentro de um bloco `try`/`except`:
+
+```Python hl_lines="13 15"
+{!../../docs_src/custom_request_and_route/tutorial002.py!}
+```
+
+Se uma exceção ocorrer, a instância `Request` ainda estará em escopo, então podemos ler e fazer uso do corpo da requisição ao lidar com o erro:
+
+```Python hl_lines="16-18"
+{!../../docs_src/custom_request_and_route/tutorial002.py!}
+```
+
+## Classe `APIRoute` personalizada em um router
+
+você também pode definir o parametro `route_class` de uma `APIRouter`;
+
+```Python hl_lines="26"
+{!../../docs_src/custom_request_and_route/tutorial003.py!}
+```
+
+Nesse exemplo, as *operações de rota* sob o `router` irão usar a classe `TimedRoute` personalizada, e terão um cabeçalho extra `X-Response-Time` na resposta com o tempo que levou para gerar a resposta:
+
+```Python hl_lines="13-20"
+{!../../docs_src/custom_request_and_route/tutorial003.py!}
+```
From cb74448bd9ce310ac63ef35e0bee320d80b112d8 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 22 Oct 2024 17:33:23 +0000
Subject: [PATCH 199/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index be8f67ad6..10977949d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Translations
+
+* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/custom-request-and-route.md`. PR [#12483](https://github.com/fastapi/fastapi/pull/12483) by [@devfernandoa](https://github.com/devfernandoa).
+
## 0.115.3
### Upgrades
From bbcee4db19cc54bcac3dbbab020c2f247bdac639 Mon Sep 17 00:00:00 2001
From: Leonardo Scarlato <101352133+leoscarlato@users.noreply.github.com>
Date: Tue, 22 Oct 2024 14:33:53 -0300
Subject: [PATCH 200/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/dataclasses.md`=20(#12475?=
=?UTF-8?q?)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/advanced/dataclasses.md | 101 +++++++++++++++++++++++++++
1 file changed, 101 insertions(+)
create mode 100644 docs/pt/docs/advanced/dataclasses.md
diff --git a/docs/pt/docs/advanced/dataclasses.md b/docs/pt/docs/advanced/dataclasses.md
new file mode 100644
index 000000000..af603ada7
--- /dev/null
+++ b/docs/pt/docs/advanced/dataclasses.md
@@ -0,0 +1,101 @@
+# Usando Dataclasses
+
+FastAPI é construído em cima do **Pydantic**, e eu tenho mostrado como usar modelos Pydantic para declarar requisições e respostas.
+
+Mas o FastAPI também suporta o uso de <a href="https://docs.python.org/3/library/dataclasses.html" class="external-link" target="_blank">`dataclasses`</a> da mesma forma:
+
+```Python hl_lines="1 7-12 19-20"
+{!../../docs_src/dataclasses/tutorial001.py!}
+```
+
+Isso ainda é suportado graças ao **Pydantic**, pois ele tem <a href="https://docs.pydantic.dev/latest/concepts/dataclasses/#use-of-stdlib-dataclasses-with-basemodel" class="external-link" target="_blank">suporte interno para `dataclasses`</a>.
+
+Então, mesmo com o código acima que não usa Pydantic explicitamente, o FastAPI está usando Pydantic para converter essas dataclasses padrão para a versão do Pydantic.
+
+E claro, ele suporta o mesmo:
+
+* validação de dados
+* serialização de dados
+* documentação de dados, etc.
+
+Isso funciona da mesma forma que com os modelos Pydantic. E na verdade é alcançado da mesma maneira por baixo dos panos, usando Pydantic.
+
+/// info | Informação
+
+Lembre-se de que dataclasses não podem fazer tudo o que os modelos Pydantic podem fazer.
+
+Então, você ainda pode precisar usar modelos Pydantic.
+
+Mas se você tem um monte de dataclasses por aí, este é um truque legal para usá-las para alimentar uma API web usando FastAPI. 🤓
+
+///
+
+## Dataclasses em `response_model`
+
+Você também pode usar `dataclasses` no parâmetro `response_model`:
+
+```Python hl_lines="1 7-13 19"
+{!../../docs_src/dataclasses/tutorial002.py!}
+```
+
+A dataclass será automaticamente convertida para uma dataclass Pydantic.
+
+Dessa forma, seu esquema aparecerá na interface de documentação da API:
+
+<img src="/img/tutorial/dataclasses/image01.png">
+
+## Dataclasses em Estruturas de Dados Aninhadas
+
+Você também pode combinar `dataclasses` com outras anotações de tipo para criar estruturas de dados aninhadas.
+
+Em alguns casos, você ainda pode ter que usar a versão do Pydantic das `dataclasses`. Por exemplo, se você tiver erros com a documentação da API gerada automaticamente.
+
+Nesse caso, você pode simplesmente trocar as `dataclasses` padrão por `pydantic.dataclasses`, que é um substituto direto:
+
+```{ .python .annotate hl_lines="1 5 8-11 14-17 23-25 28" }
+{!../../docs_src/dataclasses/tutorial003.py!}
+```
+
+1. Ainda importamos `field` das `dataclasses` padrão.
+
+2. `pydantic.dataclasses` é um substituto direto para `dataclasses`.
+
+3. A dataclass `Author` inclui uma lista de dataclasses `Item`.
+
+4. A dataclass `Author` é usada como o parâmetro `response_model`.
+
+5. Você pode usar outras anotações de tipo padrão com dataclasses como o corpo da requisição.
+
+ Neste caso, é uma lista de dataclasses `Item`.
+
+6. Aqui estamos retornando um dicionário que contém `items`, que é uma lista de dataclasses.
+
+ O FastAPI ainda é capaz de <abbr title="converter os dados para um formato que pode ser transmitido">serializar</abbr> os dados para JSON.
+
+7. Aqui o `response_model` está usando uma anotação de tipo de uma lista de dataclasses `Author`.
+
+ Novamente, você pode combinar `dataclasses` com anotações de tipo padrão.
+
+8. Note que esta *função de operação de rota* usa `def` regular em vez de `async def`.
+
+ Como sempre, no FastAPI você pode combinar `def` e `async def` conforme necessário.
+
+ Se você precisar de uma atualização sobre quando usar qual, confira a seção _"Com pressa?"_ na documentação sobre [`async` e `await`](../async.md#in-a-hurry){.internal-link target=_blank}.
+
+9. Esta *função de operação de rota* não está retornando dataclasses (embora pudesse), mas uma lista de dicionários com dados internos.
+
+ O FastAPI usará o parâmetro `response_model` (que inclui dataclasses) para converter a resposta.
+
+Você pode combinar `dataclasses` com outras anotações de tipo em muitas combinações diferentes para formar estruturas de dados complexas.
+
+Confira as dicas de anotação no código acima para ver mais detalhes específicos.
+
+## Saiba Mais
+
+Você também pode combinar `dataclasses` com outros modelos Pydantic, herdar deles, incluí-los em seus próprios modelos, etc.
+
+Para saber mais, confira a <a href="https://docs.pydantic.dev/latest/concepts/dataclasses/" class="external-link" target="_blank">documentação do Pydantic sobre dataclasses</a>.
+
+## Versão
+
+Isso está disponível desde a versão `0.67.0` do FastAPI. 🔖
From 396c0f6aab738c9ace0c4efc6ff923ff09e82a0e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 22 Oct 2024 17:36:16 +0000
Subject: [PATCH 201/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 10977949d..c29c2bebf 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/dataclasses.md`. PR [#12475](https://github.com/fastapi/fastapi/pull/12475) by [@leoscarlato](https://github.com/leoscarlato).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/custom-request-and-route.md`. PR [#12483](https://github.com/fastapi/fastapi/pull/12483) by [@devfernandoa](https://github.com/devfernandoa).
## 0.115.3
From d5a045608477aaf1750ba38823c82da0722e529d Mon Sep 17 00:00:00 2001
From: ilacftemp <159066669+ilacftemp@users.noreply.github.com>
Date: Tue, 22 Oct 2024 14:40:08 -0300
Subject: [PATCH 202/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/how-to/extending-openapi.md`=20(#1?=
=?UTF-8?q?2470)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/how-to/extending-openapi.md | 91 ++++++++++++++++++++++++
1 file changed, 91 insertions(+)
create mode 100644 docs/pt/docs/how-to/extending-openapi.md
diff --git a/docs/pt/docs/how-to/extending-openapi.md b/docs/pt/docs/how-to/extending-openapi.md
new file mode 100644
index 000000000..40917325b
--- /dev/null
+++ b/docs/pt/docs/how-to/extending-openapi.md
@@ -0,0 +1,91 @@
+
+# Extendendo o OpenAPI
+
+Existem alguns casos em que pode ser necessário modificar o esquema OpenAPI gerado.
+
+Nesta seção, você verá como fazer isso.
+
+## O processo normal
+
+O processo normal (padrão) é o seguinte:
+
+Uma aplicação (instância) do `FastAPI` possui um método `.openapi()` que deve retornar o esquema OpenAPI.
+
+Como parte da criação do objeto de aplicação, uma *operação de rota* para `/openapi.json` (ou para o que você definir como `openapi_url`) é registrada.
+
+Ela apenas retorna uma resposta JSON com o resultado do método `.openapi()` da aplicação.
+
+Por padrão, o que o método `.openapi()` faz é verificar se a propriedade `.openapi_schema` tem conteúdo e retorná-lo.
+
+Se não tiver, ele gera o conteúdo usando a função utilitária em `fastapi.openapi.utils.get_openapi`.
+
+E essa função `get_openapi()` recebe como parâmetros:
+
+* `title`: O título do OpenAPI, exibido na documentação.
+* `version`: A versão da sua API, por exemplo, `2.5.0`.
+* `openapi_version`: A versão da especificação OpenAPI utilizada. Por padrão, a mais recente: `3.1.0`.
+* `summary`: Um resumo curto da API.
+* `description`: A descrição da sua API, que pode incluir markdown e será exibida na documentação.
+* `routes`: Uma lista de rotas, que são cada uma das *operações de rota* registradas. Elas são obtidas de `app.routes`.
+
+/// info | Informação
+
+O parâmetro `summary` está disponível no OpenAPI 3.1.0 e superior, suportado pelo FastAPI 0.99.0 e superior.
+
+///
+
+## Sobrescrevendo os padrões
+
+Com as informações acima, você pode usar a mesma função utilitária para gerar o esquema OpenAPI e sobrescrever cada parte que precisar.
+
+Por exemplo, vamos adicionar <a href="https://github.com/Rebilly/ReDoc/blob/master/docs/redoc-vendor-extensions.md#x-logo" class="external-link" target="_blank">Extensão OpenAPI do ReDoc para incluir um logo personalizado</a>.
+
+### **FastAPI** Normal
+
+Primeiro, escreva toda a sua aplicação **FastAPI** normalmente:
+
+```Python hl_lines="1 4 7-9"
+{!../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Gerar o esquema OpenAPI
+
+Em seguida, use a mesma função utilitária para gerar o esquema OpenAPI, dentro de uma função `custom_openapi()`:
+
+```Python hl_lines="2 15-21"
+{!../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Modificar o esquema OpenAPI
+
+Agora, você pode adicionar a extensão do ReDoc, incluindo um `x-logo` personalizado ao "objeto" `info` no esquema OpenAPI:
+
+```Python hl_lines="22-24"
+{!../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Armazenar em cache o esquema OpenAPI
+
+Você pode usar a propriedade `.openapi_schema` como um "cache" para armazenar o esquema gerado.
+
+Dessa forma, sua aplicação não precisará gerar o esquema toda vez que um usuário abrir a documentação da sua API.
+
+Ele será gerado apenas uma vez, e o mesmo esquema armazenado em cache será utilizado nas próximas requisições.
+
+```Python hl_lines="13-14 25-26"
+{!../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Sobrescrever o método
+
+Agora, você pode substituir o método `.openapi()` pela sua nova função.
+
+```Python hl_lines="29"
+{!../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Verificar
+
+Uma vez que você acessar <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>, verá que está usando seu logo personalizado (neste exemplo, o logo do **FastAPI**):
+
+<img src="/docs/en/docs/img/tutorial/extending-openapi/image01.png">
From 180e72b1930e390e4e72b7351f916e46925637b5 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 22 Oct 2024 17:41:57 +0000
Subject: [PATCH 203/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c29c2bebf..82b78ae5f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/extending-openapi.md`. PR [#12470](https://github.com/fastapi/fastapi/pull/12470) by [@ilacftemp](https://github.com/ilacftemp).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/dataclasses.md`. PR [#12475](https://github.com/fastapi/fastapi/pull/12475) by [@leoscarlato](https://github.com/leoscarlato).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/custom-request-and-route.md`. PR [#12483](https://github.com/fastapi/fastapi/pull/12483) by [@devfernandoa](https://github.com/devfernandoa).
From c1f91a0403f33e986480f09ecb46ab97e18446ce Mon Sep 17 00:00:00 2001
From: Alejandra <90076947+alejsdev@users.noreply.github.com>
Date: Tue, 22 Oct 2024 21:28:02 +0100
Subject: [PATCH 204/504] =?UTF-8?q?=F0=9F=8C=90=20Fix=20rendering=20issue?=
=?UTF-8?q?=20in=20translations=20(#12509)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/mkdocs.yml | 1 -
1 file changed, 1 deletion(-)
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 8e0f6765d..6443b290a 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -266,7 +266,6 @@ markdown_extensions:
# Python Markdown Extensions
pymdownx.betterem:
- smart_enable: all
pymdownx.caret:
pymdownx.highlight:
line_spans: __span
From 92df4e7903c9d980527f33968845ed8b330f9bc2 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 22 Oct 2024 20:28:24 +0000
Subject: [PATCH 205/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 82b78ae5f..3b3454d2f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Docs
+
+* 🌐 Fix rendering issue in translations. PR [#12509](https://github.com/fastapi/fastapi/pull/12509) by [@alejsdev](https://github.com/alejsdev).
+
### Translations
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/extending-openapi.md`. PR [#12470](https://github.com/fastapi/fastapi/pull/12470) by [@ilacftemp](https://github.com/ilacftemp).
From 13c57834a550ce8999f28b17bc117419362472b6 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
<66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 22 Oct 2024 21:40:52 +0100
Subject: [PATCH 206/504] =?UTF-8?q?=E2=AC=86=20[pre-commit.ci]=20pre-commi?=
=?UTF-8?q?t=20autoupdate=20(#12505)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
updates:
- [github.com/astral-sh/ruff-pre-commit: v0.6.9 → v0.7.0](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.9...v0.7.0)
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
.pre-commit-config.yaml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index a62acccfe..779018ff9 100644
--- a/.pre-commit-config.yaml
+++ b/.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.6.9
+ rev: v0.7.0
hooks:
- id: ruff
args:
From 69cc3161fc1d18e45fd9c7a9c0b2db87c14b4d34 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 22 Oct 2024 20:41:15 +0000
Subject: [PATCH 207/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3b3454d2f..c02b6ac75 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -17,6 +17,10 @@ hide:
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/dataclasses.md`. PR [#12475](https://github.com/fastapi/fastapi/pull/12475) by [@leoscarlato](https://github.com/leoscarlato).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/custom-request-and-route.md`. PR [#12483](https://github.com/fastapi/fastapi/pull/12483) by [@devfernandoa](https://github.com/devfernandoa).
+### Internal
+
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12505](https://github.com/fastapi/fastapi/pull/12505) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+
## 0.115.3
### Upgrades
From c9337b54f0dc07a86b542f22c6fab01968dd7969 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Pedro=20Pereira=20Holanda?=
<joaopedroph09@gmail.com>
Date: Tue, 22 Oct 2024 17:41:28 -0300
Subject: [PATCH 208/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/header-param-models.md`?=
=?UTF-8?q?=20(#12437)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/tutorial/header-param-models.md | 184 +++++++++++++++++++
1 file changed, 184 insertions(+)
create mode 100644 docs/pt/docs/tutorial/header-param-models.md
diff --git a/docs/pt/docs/tutorial/header-param-models.md b/docs/pt/docs/tutorial/header-param-models.md
new file mode 100644
index 000000000..a42f77a2d
--- /dev/null
+++ b/docs/pt/docs/tutorial/header-param-models.md
@@ -0,0 +1,184 @@
+# Modelos de Parâmetros do Cabeçalho
+
+Se você possui um grupo de **parâmetros de cabeçalho** relacionados, você pode criar um **modelo do Pydantic** para declará-los.
+
+Isso vai lhe permitir **reusar o modelo** em **múltiplos lugares** e também declarar validações e metadadados para todos os parâmetros de uma vez. 😎
+
+/// note | Nota
+
+Isso é possível desde a versão `0.115.0` do FastAPI. 🤓
+
+///
+
+## Parâmetros do Cabeçalho com um Modelo Pydantic
+
+Declare os **parâmetros de cabeçalho** que você precisa em um **modelo do Pydantic**, e então declare o parâmetro como `Header`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="9-14 18"
+{!> ../../docs_src/header_param_models/tutorial001_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9-14 18"
+{!> ../../docs_src/header_param_models/tutorial001_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="10-15 19"
+{!> ../../docs_src/header_param_models/tutorial001_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível.
+
+///
+
+```Python hl_lines="7-12 16"
+{!> ../../docs_src/header_param_models/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível.
+
+///
+
+```Python hl_lines="9-14 18"
+{!> ../../docs_src/header_param_models/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível.
+
+///
+
+```Python hl_lines="7-12 16"
+{!> ../../docs_src/header_param_models/tutorial001_py310.py!}
+```
+
+////
+
+O **FastAPI** irá **extrair** os dados de **cada campo** a partir dos **cabeçalhos** da requisição e te retornará o modelo do Pydantic que você definiu.
+
+### Checando a documentação
+
+Você pode ver os headers necessários na interface gráfica da documentação em `/docs`:
+
+<div class="screenshot">
+<img src="/img/tutorial/header-param-models/image01.png">
+</div>
+
+### Proibindo Cabeçalhos adicionais
+
+Em alguns casos de uso especiais (provavelmente não muito comuns), você pode querer **restringir** os cabeçalhos que você quer receber.
+
+Você pode usar a configuração dos modelos do Pydantic para proibir (`forbid`) quaisquer campos `extra`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="10"
+{!> ../../docs_src/header_param_models/tutorial002_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="10"
+{!> ../../docs_src/header_param_models/tutorial002_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../docs_src/header_param_models/tutorial002_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível.
+
+///
+
+```Python hl_lines="8"
+{!> ../../docs_src/header_param_models/tutorial002_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível.
+
+///
+
+```Python hl_lines="10"
+{!> ../../docs_src/header_param_models/tutorial002_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Utilize a versão com `Annotated` se possível.
+
+///
+
+```Python hl_lines="10"
+{!> ../../docs_src/header_param_models/tutorial002.py!}
+```
+
+////
+
+Se um cliente tentar enviar alguns **cabeçalhos extra**, eles irão receber uma resposta de **erro**.
+
+Por exemplo, se o cliente tentar enviar um cabeçalho `tool` com o valor `plumbus`, ele irá receber uma resposta de **erro** informando que o parâmetro do cabeçalho `tool` não é permitido:
+
+```json
+{
+ "detail": [
+ {
+ "type": "extra_forbidden",
+ "loc": ["header", "tool"],
+ "msg": "Extra inputs are not permitted",
+ "input": "plumbus",
+ }
+ ]
+}
+```
+
+## Resumo
+
+Você pode utilizar **modelos do Pydantic** para declarar **cabeçalhos** no **FastAPI**. 😎
From fb4b6b7cbeccd9d9abbfabbb80dc63fcdfe0b379 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 22 Oct 2024 20:42:37 +0000
Subject: [PATCH 209/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c02b6ac75..c36d08554 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/header-param-models.md`. PR [#12437](https://github.com/fastapi/fastapi/pull/12437) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/extending-openapi.md`. PR [#12470](https://github.com/fastapi/fastapi/pull/12470) by [@ilacftemp](https://github.com/ilacftemp).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/dataclasses.md`. PR [#12475](https://github.com/fastapi/fastapi/pull/12475) by [@leoscarlato](https://github.com/leoscarlato).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/custom-request-and-route.md`. PR [#12483](https://github.com/fastapi/fastapi/pull/12483) by [@devfernandoa](https://github.com/devfernandoa).
From 136c48bda6151a468346f87c5534f6d6e0e28a0f Mon Sep 17 00:00:00 2001
From: YungYueh ChanLee <polo80456@gmail.com>
Date: Wed, 23 Oct 2024 04:44:51 +0800
Subject: [PATCH 210/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Traditional=20Chin?=
=?UTF-8?q?ese=20translation=20for=20`docs/zh-hant/docs/tutorial/index.md`?=
=?UTF-8?q?=20(#12466)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh-hant/docs/tutorial/index.md | 102 ++++++++++++++++++++++++++++
1 file changed, 102 insertions(+)
create mode 100644 docs/zh-hant/docs/tutorial/index.md
diff --git a/docs/zh-hant/docs/tutorial/index.md b/docs/zh-hant/docs/tutorial/index.md
new file mode 100644
index 000000000..34f504851
--- /dev/null
+++ b/docs/zh-hant/docs/tutorial/index.md
@@ -0,0 +1,102 @@
+# 教學 - 使用者指南
+
+本教學將一步一步展示如何使用 **FastAPI** 及其大多數功能。
+
+每個部分都是在前一部分的基礎上逐步建置的，但內容結構是按主題分開的，因此你可以直接跳到任何特定的部分，解決你具體的 API 需求。
+
+它也被設計成可作為未來的參考，讓你隨時回來查看所需的內容。
+
+## 運行程式碼
+
+所有程式碼區塊都可以直接複製和使用（它們實際上是經過測試的 Python 檔案）。
+
+要運行任何範例，請將程式碼複製到 `main.py` 檔案，並使用以下命令啟動 `fastapi dev`：
+
+<div class="termy">
+
+```console
+$ <font color="#4E9A06">fastapi</font> dev <u style="text-decoration-style:single">main.py</u>
+<font color="#3465A4">INFO </font> Using path <font color="#3465A4">main.py</font>
+<font color="#3465A4">INFO </font> Resolved absolute path <font color="#75507B">/home/user/code/awesomeapp/</font><font color="#AD7FA8">main.py</font>
+<font color="#3465A4">INFO </font> Searching for package file structure from directories with <font color="#3465A4">__init__.py</font> files
+<font color="#3465A4">INFO </font> Importing from <font color="#75507B">/home/user/code/</font><font color="#AD7FA8">awesomeapp</font>
+
+ ╭─ <font color="#8AE234"><b>Python module file</b></font> ─╮
+ │ │
+ │ 🐍 main.py │
+ │ │
+ ╰──────────────────────╯
+
+<font color="#3465A4">INFO </font> Importing module <font color="#4E9A06">main</font>
+<font color="#3465A4">INFO </font> Found importable FastAPI app
+
+ ╭─ <font color="#8AE234"><b>Importable FastAPI app</b></font> ─╮
+ │ │
+ │ <span style="background-color:#272822"><font color="#FF4689">from</font></span><span style="background-color:#272822"><font color="#F8F8F2"> main </font></span><span style="background-color:#272822"><font color="#FF4689">import</font></span><span style="background-color:#272822"><font color="#F8F8F2"> app</font></span><span style="background-color:#272822"> </span> │
+ │ │
+ ╰──────────────────────────╯
+
+<font color="#3465A4">INFO </font> Using import string <font color="#8AE234"><b>main:app</b></font>
+
+ <span style="background-color:#C4A000"><font color="#2E3436">╭────────── FastAPI CLI - Development mode ───────────╮</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ Serving at: http://127.0.0.1:8000 │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ API docs: http://127.0.0.1:8000/docs │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ Running in development mode, for production use: │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ </font></span><span style="background-color:#C4A000"><font color="#555753"><b>fastapi run</b></font></span><span style="background-color:#C4A000"><font color="#2E3436"> │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">╰─────────────────────────────────────────────────────╯</font></span>
+
+<font color="#4E9A06">INFO</font>: Will watch for changes in these directories: ['/home/user/code/awesomeapp']
+<font color="#4E9A06">INFO</font>: Uvicorn running on <b>http://127.0.0.1:8000</b> (Press CTRL+C to quit)
+<font color="#4E9A06">INFO</font>: Started reloader process [<font color="#34E2E2"><b>2265862</b></font>] using <font color="#34E2E2"><b>WatchFiles</b></font>
+<font color="#4E9A06">INFO</font>: Started server process [<font color="#06989A">2265873</font>]
+<font color="#4E9A06">INFO</font>: Waiting for application startup.
+<font color="#4E9A06">INFO</font>: Application startup complete.
+</pre>
+```
+
+</div>
+
+**強烈建議** 你編寫或複製程式碼、進行修改並在本地端運行。
+
+在編輯器中使用它，才能真正體會到 FastAPI 的好處，可以看到你只需編寫少量程式碼，以及所有的型別檢查、自動補齊等功能。
+
+---
+
+## 安裝 FastAPI
+
+第一步是安裝 FastAPI。
+
+確保你建立一個[虛擬環境](../virtual-environments.md){.internal-link target=_blank}，啟用它，然後 **安裝 FastAPI**：
+
+<div class="termy">
+
+```console
+$ pip install "fastapi[standard]"
+
+---> 100%
+```
+
+</div>
+
+/// note
+
+當你使用 `pip install "fastapi[standard]"` 安裝時，會包含一些預設的可選標準相依項。
+
+如果你不想包含那些可選的相依項，你可以使用 `pip install fastapi` 來安裝。
+
+///
+
+## 進階使用者指南
+
+還有一個 **進階使用者指南** 你可以稍後閱讀。
+
+**進階使用者指南** 建立在這個教學之上，使用相同的概念，並教你一些額外的功能。
+
+但首先你應該閱讀 **教學 - 使用者指南**（你正在閱讀的內容）。
+
+它被設計成你可以使用 **教學 - 使用者指南** 來建立一個完整的應用程式，然後根據你的需求，使用一些額外的想法來擴展它。
From 59efc69becd330fc92b103be2ac21a94b6450043 Mon Sep 17 00:00:00 2001
From: YungYueh ChanLee <polo80456@gmail.com>
Date: Wed, 23 Oct 2024 04:45:13 +0800
Subject: [PATCH 211/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Traditional=20Chin?=
=?UTF-8?q?ese=20translation=20for=20`docs/zh-hant/docs/how-to/index.md`?=
=?UTF-8?q?=20(#12468)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh-hant/docs/how-to/index.md | 13 +++++++++++++
1 file changed, 13 insertions(+)
create mode 100644 docs/zh-hant/docs/how-to/index.md
diff --git a/docs/zh-hant/docs/how-to/index.md b/docs/zh-hant/docs/how-to/index.md
new file mode 100644
index 000000000..d668b5b7a
--- /dev/null
+++ b/docs/zh-hant/docs/how-to/index.md
@@ -0,0 +1,13 @@
+# 使用指南 - 範例集
+
+在這裡，你將會看到 **不同主題** 的範例或「如何使用」的指南。
+
+大多數這些想法都是 **獨立** 的，在大多數情況下，你只需要研究那些直接適用於 **你的專案** 的東西。
+
+如果有些東西看起來很有趣且對你的專案很有用的話再去讀它，否則你可能可以跳過它們。
+
+/// tip
+
+如果你想要以結構化的方式 **學習 FastAPI**（推薦），請前往[教學 - 使用者指南](../tutorial/index.md){.internal-link target=_blank}逐章閱讀。
+
+///
From 21fc89976d54d828d4201ec3370eadf2218dc695 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 22 Oct 2024 20:47:24 +0000
Subject: [PATCH 212/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c36d08554..f488bf7b4 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/tutorial/index.md`. PR [#12466](https://github.com/fastapi/fastapi/pull/12466) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/header-param-models.md`. PR [#12437](https://github.com/fastapi/fastapi/pull/12437) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/extending-openapi.md`. PR [#12470](https://github.com/fastapi/fastapi/pull/12470) by [@ilacftemp](https://github.com/ilacftemp).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/dataclasses.md`. PR [#12475](https://github.com/fastapi/fastapi/pull/12475) by [@leoscarlato](https://github.com/leoscarlato).
From 2d43a8a2a3389934890bb60f0e4979074745cbdc Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 22 Oct 2024 20:48:21 +0000
Subject: [PATCH 213/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f488bf7b4..daaaa9c99 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
### Translations
+* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/how-to/index.md`. PR [#12468](https://github.com/fastapi/fastapi/pull/12468) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/tutorial/index.md`. PR [#12466](https://github.com/fastapi/fastapi/pull/12466) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/header-param-models.md`. PR [#12437](https://github.com/fastapi/fastapi/pull/12437) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/extending-openapi.md`. PR [#12470](https://github.com/fastapi/fastapi/pull/12470) by [@ilacftemp](https://github.com/ilacftemp).
From 8081d2302ec5cffd5d2a35a6e22980d3f03bb395 Mon Sep 17 00:00:00 2001
From: Kevin Kirsche <swaps.jury0u@icloud.com>
Date: Wed, 23 Oct 2024 14:30:18 -0400
Subject: [PATCH 214/504] =?UTF-8?q?=F0=9F=93=9D=20Fix=20minor=20typos=20(#?=
=?UTF-8?q?12516)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
fastapi/param_functions.py | 2 +-
fastapi/security/oauth2.py | 4 ++--
2 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/fastapi/param_functions.py b/fastapi/param_functions.py
index 7ddaace25..b3621626c 100644
--- a/fastapi/param_functions.py
+++ b/fastapi/param_functions.py
@@ -2298,7 +2298,7 @@ def Security( # noqa: N802
dependency.
The term "scope" comes from the OAuth2 specification, it seems to be
- intentionaly vague and interpretable. It normally refers to permissions,
+ intentionally vague and interpretable. It normally refers to permissions,
in cases to roles.
These scopes are integrated with OpenAPI (and the API docs at `/docs`).
diff --git a/fastapi/security/oauth2.py b/fastapi/security/oauth2.py
index 9720cace0..6adc55bfe 100644
--- a/fastapi/security/oauth2.py
+++ b/fastapi/security/oauth2.py
@@ -52,7 +52,7 @@ class OAuth2PasswordRequestForm:
```
Note that for OAuth2 the scope `items:read` is a single scope in an opaque string.
- You could have custom internal logic to separate it by colon caracters (`:`) or
+ You could have custom internal logic to separate it by colon characters (`:`) or
similar, and get the two parts `items` and `read`. Many applications do that to
group and organize permissions, you could do it as well in your application, just
know that that it is application specific, it's not part of the specification.
@@ -194,7 +194,7 @@ class OAuth2PasswordRequestFormStrict(OAuth2PasswordRequestForm):
```
Note that for OAuth2 the scope `items:read` is a single scope in an opaque string.
- You could have custom internal logic to separate it by colon caracters (`:`) or
+ You could have custom internal logic to separate it by colon characters (`:`) or
similar, and get the two parts `items` and `read`. Many applications do that to
group and organize permissions, you could do it as well in your application, just
know that that it is application specific, it's not part of the specification.
From 593385d1c3bac8173905c28e07ffda9fd5ac4ea6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 23 Oct 2024 18:30:47 +0000
Subject: [PATCH 215/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index daaaa9c99..93a5a8f56 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Fix minor typos. PR [#12516](https://github.com/fastapi/fastapi/pull/12516) by [@kkirsche](https://github.com/kkirsche).
* 🌐 Fix rendering issue in translations. PR [#12509](https://github.com/fastapi/fastapi/pull/12509) by [@alejsdev](https://github.com/alejsdev).
### Translations
From e7533b92b3ad2a9f50a19342fde0967aa4601fd2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 24 Oct 2024 14:38:34 +0200
Subject: [PATCH 216/504] =?UTF-8?q?=F0=9F=91=B7=20Update=20GitHub=20Action?=
=?UTF-8?q?=20to=20deploy=20docs=20previews=20to=20handle=20missing=20depl?=
=?UTF-8?q?oy=20comments=20(#12527)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/workflows/deploy-docs.yml | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index 2fd46df6b..39ea7de52 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -62,7 +62,10 @@ jobs:
env:
PROJECT_NAME: fastapitiangolo
BRANCH: ${{ ( github.event.workflow_run.head_repository.full_name == github.repository && github.event.workflow_run.head_branch == 'master' && 'main' ) || ( github.event.workflow_run.head_sha ) }}
- uses: cloudflare/wrangler-action@v3
+ # TODO: Use v3 when it's fixed, probably in v3.11
+ # https://github.com/cloudflare/wrangler-action/issues/307
+ uses: cloudflare/wrangler-action@v3.9
+ # uses: cloudflare/wrangler-action@v3
with:
apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
From 6ede04f876acc00e2cf688d39e8d6c79dcac0230 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 24 Oct 2024 12:39:00 +0000
Subject: [PATCH 217/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 93a5a8f56..243ac4006 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -23,6 +23,7 @@ hide:
### Internal
+* 👷 Update GitHub Action to deploy docs previews to handle missing deploy comments. PR [#12527](https://github.com/fastapi/fastapi/pull/12527) by [@tiangolo](https://github.com/tiangolo).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12505](https://github.com/fastapi/fastapi/pull/12505) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
## 0.115.3
From 2f2c877d51e827ed1a468ed16bdbe79469b15261 Mon Sep 17 00:00:00 2001
From: YungYueh ChanLee <polo80456@gmail.com>
Date: Fri, 25 Oct 2024 02:28:00 +0800
Subject: [PATCH 218/504] =?UTF-8?q?=F0=9F=8C=90=20Update=20Traditional=20C?=
=?UTF-8?q?hinese=20translation=20for=20`docs/zh-hant/docs/tutorial/index.?=
=?UTF-8?q?md`=20(#12524)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh-hant/docs/tutorial/index.md | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/docs/zh-hant/docs/tutorial/index.md b/docs/zh-hant/docs/tutorial/index.md
index 34f504851..2aaa78b22 100644
--- a/docs/zh-hant/docs/tutorial/index.md
+++ b/docs/zh-hant/docs/tutorial/index.md
@@ -61,7 +61,7 @@ $ <font color="#4E9A06">fastapi</font> dev <u style="text-decoration-style:singl
</div>
-**強烈建議** 你編寫或複製程式碼、進行修改並在本地端運行。
+**強烈建議**你編寫或複製程式碼、進行修改並在本地端運行。
在編輯器中使用它，才能真正體會到 FastAPI 的好處，可以看到你只需編寫少量程式碼，以及所有的型別檢查、自動補齊等功能。
@@ -71,7 +71,7 @@ $ <font color="#4E9A06">fastapi</font> dev <u style="text-decoration-style:singl
第一步是安裝 FastAPI。
-確保你建立一個[虛擬環境](../virtual-environments.md){.internal-link target=_blank}，啟用它，然後 **安裝 FastAPI**：
+確保你建立一個[虛擬環境](../virtual-environments.md){.internal-link target=_blank}，啟用它，然後**安裝 FastAPI**：
<div class="termy">
@@ -93,10 +93,10 @@ $ pip install "fastapi[standard]"
## 進階使用者指南
-還有一個 **進階使用者指南** 你可以稍後閱讀。
+還有一個**進階使用者指南**你可以稍後閱讀。
-**進階使用者指南** 建立在這個教學之上，使用相同的概念，並教你一些額外的功能。
+**進階使用者指南**建立在這個教學之上，使用相同的概念，並教你一些額外的功能。
-但首先你應該閱讀 **教學 - 使用者指南**（你正在閱讀的內容）。
+但首先你應該閱讀**教學 - 使用者指南**（你正在閱讀的內容）。
-它被設計成你可以使用 **教學 - 使用者指南** 來建立一個完整的應用程式，然後根據你的需求，使用一些額外的想法來擴展它。
+它被設計成你可以使用**教學 - 使用者指南**來建立一個完整的應用程式，然後根據你的需求，使用一些額外的想法來擴展它。
From 7b03fa7e0c489204fa268d0f9c2c1f17dbb73645 Mon Sep 17 00:00:00 2001
From: YungYueh ChanLee <polo80456@gmail.com>
Date: Fri, 25 Oct 2024 02:28:16 +0800
Subject: [PATCH 219/504] =?UTF-8?q?=F0=9F=8C=90=20Update=20Traditional=20C?=
=?UTF-8?q?hinese=20translation=20for=20`docs/zh-hant/docs/how-to/index.md?=
=?UTF-8?q?`=20(#12523)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh-hant/docs/how-to/index.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/docs/zh-hant/docs/how-to/index.md b/docs/zh-hant/docs/how-to/index.md
index d668b5b7a..db740140d 100644
--- a/docs/zh-hant/docs/how-to/index.md
+++ b/docs/zh-hant/docs/how-to/index.md
@@ -1,13 +1,13 @@
# 使用指南 - 範例集
-在這裡，你將會看到 **不同主題** 的範例或「如何使用」的指南。
+在這裡，你將會看到**不同主題**的範例或「如何使用」的指南。
-大多數這些想法都是 **獨立** 的，在大多數情況下，你只需要研究那些直接適用於 **你的專案** 的東西。
+大多數這些想法都是**獨立**的，在大多數情況下，你只需要研究那些直接適用於**你的專案**的東西。
如果有些東西看起來很有趣且對你的專案很有用的話再去讀它，否則你可能可以跳過它們。
/// tip
-如果你想要以結構化的方式 **學習 FastAPI**（推薦），請前往[教學 - 使用者指南](../tutorial/index.md){.internal-link target=_blank}逐章閱讀。
+如果你想要以結構化的方式**學習 FastAPI**（推薦），請前往[教學 - 使用者指南](../tutorial/index.md){.internal-link target=_blank}逐章閱讀。
///
From b144221ad538899fedb15c56f052d94febe96d21 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 24 Oct 2024 18:28:22 +0000
Subject: [PATCH 220/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 243ac4006..616e92308 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
### Translations
+* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/tutorial/index.md`. PR [#12524](https://github.com/fastapi/fastapi/pull/12524) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/how-to/index.md`. PR [#12468](https://github.com/fastapi/fastapi/pull/12468) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/tutorial/index.md`. PR [#12466](https://github.com/fastapi/fastapi/pull/12466) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/header-param-models.md`. PR [#12437](https://github.com/fastapi/fastapi/pull/12437) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
From ff5f076011d752e91861e4e48c32560cc5386ba1 Mon Sep 17 00:00:00 2001
From: YungYueh ChanLee <polo80456@gmail.com>
Date: Fri, 25 Oct 2024 02:28:55 +0800
Subject: [PATCH 221/504] =?UTF-8?q?=F0=9F=8C=90=20Update=20Traditional=20C?=
=?UTF-8?q?hinese=20translation=20for=20`docs/zh-hant/docs/deployment/clou?=
=?UTF-8?q?d.md`=20(#12522)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh-hant/docs/deployment/cloud.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/docs/zh-hant/docs/deployment/cloud.md b/docs/zh-hant/docs/deployment/cloud.md
index 5d645b6c2..29ebe3ff5 100644
--- a/docs/zh-hant/docs/deployment/cloud.md
+++ b/docs/zh-hant/docs/deployment/cloud.md
@@ -1,14 +1,14 @@
# 在雲端部署 FastAPI
-你幾乎可以使用 **任何雲端供應商** 來部署你的 FastAPI 應用程式。
+你幾乎可以使用**任何雲端供應商**來部署你的 FastAPI 應用程式。
在大多數情況下，主要的雲端供應商都有部署 FastAPI 的指南。
## 雲端供應商 - 贊助商
-一些雲端供應商 ✨ [**贊助 FastAPI**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨，這確保了 FastAPI 及其 **生態系統** 持續健康地 **發展**。
+一些雲端供應商 ✨ [**贊助 FastAPI**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨，這確保了 FastAPI 及其**生態系統**持續健康地**發展**。
-這也展現了他們對 FastAPI 和其 **社群**（包括你）的真正承諾，他們不僅希望為你提供 **優質的服務**，還希望確保你擁有一個 **良好且健康的框架**：FastAPI。🙇
+這也展現了他們對 FastAPI 和其**社群**（包括你）的真正承諾，他們不僅希望為你提供**優質的服務**，還希望確保你擁有一個**良好且健康的框架**：FastAPI。🙇
你可能會想嘗試他們的服務，以下有他們的指南：
From b5021a4c84c59f0b0e2354e0116fc6f65055804b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 24 Oct 2024 18:29:27 +0000
Subject: [PATCH 222/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 616e92308..20841620b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
### Translations
+* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/how-to/index.md`. PR [#12523](https://github.com/fastapi/fastapi/pull/12523) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/tutorial/index.md`. PR [#12524](https://github.com/fastapi/fastapi/pull/12524) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/how-to/index.md`. PR [#12468](https://github.com/fastapi/fastapi/pull/12468) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/tutorial/index.md`. PR [#12466](https://github.com/fastapi/fastapi/pull/12466) by [@codingjenny](https://github.com/codingjenny).
From 86fe2515072fece41cbab7f50ffcd6d445b6d358 Mon Sep 17 00:00:00 2001
From: YungYueh ChanLee <polo80456@gmail.com>
Date: Fri, 25 Oct 2024 02:30:54 +0800
Subject: [PATCH 223/504] =?UTF-8?q?=F0=9F=8C=90=20Update=20Traditional=20C?=
=?UTF-8?q?hinese=20translation=20for=20`docs/zh-hant/docs/deployment/inde?=
=?UTF-8?q?x.md`=20(#12521)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh-hant/docs/deployment/index.md | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/docs/zh-hant/docs/deployment/index.md b/docs/zh-hant/docs/deployment/index.md
index e760b3d16..1726562b4 100644
--- a/docs/zh-hant/docs/deployment/index.md
+++ b/docs/zh-hant/docs/deployment/index.md
@@ -4,17 +4,17 @@
## 部署是什麼意思
-**部署** 應用程式指的是執行一系列必要的步驟，使其能夠 **讓使用者存取和使用**。
+**部署**應用程式指的是執行一系列必要的步驟，使其能夠**讓使用者存取和使用**。
-對於一個 **Web API**，部署通常涉及將其放置在 **遠端伺服器** 上，並使用性能優良且穩定的 **伺服器程式**，確保使用者能夠高效、無中斷地存取應用程式，且不會遇到問題。
+對於一個 **Web API**，部署通常涉及將其放置在**遠端伺服器**上，並使用性能優良且穩定的**伺服器程式**，確保使用者能夠高效、無中斷地存取應用程式，且不會遇到問題。
-這與 **開發** 階段形成鮮明對比，在 **開發** 階段，你會不斷更改程式碼、破壞程式碼、修復程式碼，然後停止和重新啟動伺服器等。
+這與**開發**階段形成鮮明對比，在**開發**階段，你會不斷更改程式碼、破壞程式碼、修復程式碼，然後停止和重新啟動伺服器等。
## 部署策略
根據你的使用場景和使用工具，有多種方法可以實現此目的。
-你可以使用一些工具自行 **部署伺服器**，你也可以使用能為你完成部分工作的 **雲端服務**，或其他可能的選項。
+你可以使用一些工具自行**部署伺服器**，你也可以使用能為你完成部分工作的**雲端服務**，或其他可能的選項。
我將向你展示在部署 **FastAPI** 應用程式時你可能應該記住的一些主要概念（儘管其中大部分適用於任何其他類型的 Web 應用程式）。
From e2d77a9e425bcba3ef2a8189b62196351bd3677f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 24 Oct 2024 18:32:39 +0000
Subject: [PATCH 224/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 20841620b..039d94c76 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
### Translations
+* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/deployment/cloud.md`. PR [#12522](https://github.com/fastapi/fastapi/pull/12522) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/how-to/index.md`. PR [#12523](https://github.com/fastapi/fastapi/pull/12523) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/tutorial/index.md`. PR [#12524](https://github.com/fastapi/fastapi/pull/12524) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/how-to/index.md`. PR [#12468](https://github.com/fastapi/fastapi/pull/12468) by [@codingjenny](https://github.com/codingjenny).
From cf65c423d1e59077bf39533788486c0da7339d07 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 24 Oct 2024 18:35:26 +0000
Subject: [PATCH 225/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 039d94c76..fd5bb0eb9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
### Translations
+* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/deployment/index.md`. PR [#12521](https://github.com/fastapi/fastapi/pull/12521) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/deployment/cloud.md`. PR [#12522](https://github.com/fastapi/fastapi/pull/12522) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/how-to/index.md`. PR [#12523](https://github.com/fastapi/fastapi/pull/12523) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/tutorial/index.md`. PR [#12524](https://github.com/fastapi/fastapi/pull/12524) by [@codingjenny](https://github.com/codingjenny).
From ec9b066e0bb3577eca3f2f02c5043a398ca28746 Mon Sep 17 00:00:00 2001
From: Renne Rocha <renne@rocha.dev.br>
Date: Thu, 24 Oct 2024 15:39:34 -0300
Subject: [PATCH 226/504] =?UTF-8?q?=F0=9F=93=9D=20Add=20External=20Link:?=
=?UTF-8?q?=20FastAPI=20do=20Zero=20(#12533)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/data/external_links.yml | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/data/external_links.yml b/docs/en/data/external_links.yml
index dedbe87f4..9e411a631 100644
--- a/docs/en/data/external_links.yml
+++ b/docs/en/data/external_links.yml
@@ -339,6 +339,10 @@ Articles:
link: https://qiita.com/mtitg/items/47770e9a562dd150631d
title: FastAPI｜DB接続してCRUDするPython製APIサーバーを構築
Portuguese:
+ - author: Eduardo Mendes
+ author_link: https://bolha.us/@dunossauro
+ link: https://fastapidozero.dunossauro.com/
+ title: FastAPI do ZERO
- author: Jessica Temporal
author_link: https://jtemporal.com/socials
link: https://jtemporal.com/dicas-para-migrar-de-flask-para-fastapi-e-vice-versa/
From 548f938280598ceed36decb361e2188b5a5f806b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 24 Oct 2024 18:43:50 +0000
Subject: [PATCH 227/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fd5bb0eb9..1c3cbf011 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Add External Link: FastAPI do Zero. PR [#12533](https://github.com/fastapi/fastapi/pull/12533) by [@rennerocha](https://github.com/rennerocha).
* 📝 Fix minor typos. PR [#12516](https://github.com/fastapi/fastapi/pull/12516) by [@kkirsche](https://github.com/kkirsche).
* 🌐 Fix rendering issue in translations. PR [#12509](https://github.com/fastapi/fastapi/pull/12509) by [@alejsdev](https://github.com/alejsdev).
From 55bcab6d75b2b1f1780f56f989fbfba1498b96d0 Mon Sep 17 00:00:00 2001
From: ilacftemp <159066669+ilacftemp@users.noreply.github.com>
Date: Thu, 24 Oct 2024 15:52:36 -0300
Subject: [PATCH 228/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/how-to/separate-openapi-schemas.md?=
=?UTF-8?q?`=20(#12518)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../docs/how-to/separate-openapi-schemas.md | 258 ++++++++++++++++++
1 file changed, 258 insertions(+)
create mode 100644 docs/pt/docs/how-to/separate-openapi-schemas.md
diff --git a/docs/pt/docs/how-to/separate-openapi-schemas.md b/docs/pt/docs/how-to/separate-openapi-schemas.md
new file mode 100644
index 000000000..50d321d4c
--- /dev/null
+++ b/docs/pt/docs/how-to/separate-openapi-schemas.md
@@ -0,0 +1,258 @@
+# Esquemas OpenAPI Separados para Entrada e Saída ou Não
+
+Ao usar **Pydantic v2**, o OpenAPI gerado é um pouco mais exato e **correto** do que antes. 😎
+
+Inclusive, em alguns casos, ele terá até **dois JSON Schemas** no OpenAPI para o mesmo modelo Pydantic, para entrada e saída, dependendo se eles possuem **valores padrão**.
+
+Vamos ver como isso funciona e como alterar se for necessário.
+
+## Modelos Pydantic para Entrada e Saída
+
+Digamos que você tenha um modelo Pydantic com valores padrão, como este:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="7"
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-7]!}
+
+# Code below omitted 👇
+```
+
+<details>
+<summary>👀 Visualização completa do arquivo</summary>
+
+```Python
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+```
+
+</details>
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9"
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-9]!}
+
+# Code below omitted 👇
+```
+
+<details>
+<summary>👀 Visualização completa do arquivo</summary>
+
+```Python
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+```
+
+</details>
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="9"
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-9]!}
+
+# Code below omitted 👇
+```
+
+<details>
+<summary>👀 Visualização completa do arquivo</summary>
+
+```Python
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py!}
+```
+
+</details>
+
+////
+
+### Modelo para Entrada
+
+Se você usar esse modelo como entrada, como aqui:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="14"
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-15]!}
+
+# Code below omitted 👇
+```
+
+<details>
+<summary>👀 Visualização completa do arquivo</summary>
+
+```Python
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+```
+
+</details>
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="16"
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-17]!}
+
+# Code below omitted 👇
+```
+
+<details>
+<summary>👀 Visualização completa do arquivo</summary>
+
+```Python
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+```
+
+</details>
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="16"
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-17]!}
+
+# Code below omitted 👇
+```
+
+<details>
+<summary>👀 Visualização completa do arquivo</summary>
+
+```Python
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py!}
+```
+
+</details>
+
+////
+
+... então o campo `description` não será obrigatório. Porque ele tem um valor padrão de `None`.
+
+### Modelo de Entrada na Documentação
+
+Você pode confirmar que na documentação, o campo `description` não tem um **asterisco vermelho**, não é marcado como obrigatório:
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image01.png">
+</div>
+
+### Modelo para Saída
+
+Mas se você usar o mesmo modelo como saída, como aqui:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="19"
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="21"
+{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="21"
+{!> ../../docs_src/separate_openapi_schemas/tutorial001.py!}
+```
+
+////
+
+... então, como `description` tem um valor padrão, se você **não retornar nada** para esse campo, ele ainda terá o **valor padrão**.
+
+### Modelo para Dados de Resposta de Saída
+
+Se você interagir com a documentação e verificar a resposta, mesmo que o código não tenha adicionado nada em um dos campos `description`, a resposta JSON contém o valor padrão (`null`):
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image02.png">
+</div>
+
+Isso significa que ele **sempre terá um valor**, só que às vezes o valor pode ser `None` (ou `null` em termos de JSON).
+
+Isso quer dizer que, os clientes que usam sua API não precisam verificar se o valor existe ou não, eles podem **assumir que o campo sempre estará lá**, mas que em alguns casos terá o valor padrão de `None`.
+
+A maneira de descrever isso no OpenAPI é marcar esse campo como **obrigatório**, porque ele sempre estará lá.
+
+Por causa disso, o JSON Schema para um modelo pode ser diferente dependendo se ele é usado para **entrada ou saída**:
+
+* para **entrada**, o `description` **não será obrigatório**
+* para **saída**, ele será **obrigatório** (e possivelmente `None`, ou em termos de JSON, `null`)
+
+### Modelo para Saída na Documentação
+
+Você pode verificar o modelo de saída na documentação também, ambos `name` e `description` são marcados como **obrigatórios** com um **asterisco vermelho**:
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image03.png">
+</div>
+
+### Modelo para Entrada e Saída na Documentação
+
+E se você verificar todos os Schemas disponíveis (JSON Schemas) no OpenAPI, verá que há dois, um `Item-Input` e um `Item-Output`.
+
+Para `Item-Input`, `description` **não é obrigatório**, não tem um asterisco vermelho.
+
+Mas para `Item-Output`, `description` **é obrigatório**, tem um asterisco vermelho.
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image04.png">
+</div>
+
+Com esse recurso do **Pydantic v2**, sua documentação da API fica mais **precisa**, e se você tiver clientes e SDKs gerados automaticamente, eles serão mais precisos também, proporcionando uma melhor **experiência para desenvolvedores** e consistência. 🎉
+
+## Não Separe Schemas
+
+Agora, há alguns casos em que você pode querer ter o **mesmo esquema para entrada e saída**.
+
+Provavelmente, o principal caso de uso para isso é se você já tem algum código de cliente/SDK gerado automaticamente e não quer atualizar todo o código de cliente/SDK gerado ainda, você provavelmente vai querer fazer isso em algum momento, mas talvez não agora.
+
+Nesse caso, você pode desativar esse recurso no **FastAPI**, com o parâmetro `separate_input_output_schemas=False`.
+
+/// info | Informação
+
+O suporte para `separate_input_output_schemas` foi adicionado no FastAPI `0.102.0`. 🤓
+
+///
+
+//// tab | Python 3.10+
+
+```Python hl_lines="10"
+{!> ../../docs_src/separate_openapi_schemas/tutorial002_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="12"
+{!> ../../docs_src/separate_openapi_schemas/tutorial002_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="12"
+{!> ../../docs_src/separate_openapi_schemas/tutorial002.py!}
+```
+
+////
+
+### Mesmo Esquema para Modelos de Entrada e Saída na Documentação
+
+E agora haverá um único esquema para entrada e saída para o modelo, apenas `Item`, e `description` **não será obrigatório**:
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image05.png">
+</div>
+
+Esse é o mesmo comportamento do Pydantic v1. 🤓
From a498582bb46811203b0a172759667c646bc0059c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 24 Oct 2024 18:54:28 +0000
Subject: [PATCH 229/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 1c3cbf011..1720110ec 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -15,6 +15,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/separate-openapi-schemas.md`. PR [#12518](https://github.com/fastapi/fastapi/pull/12518) by [@ilacftemp](https://github.com/ilacftemp).
* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/deployment/index.md`. PR [#12521](https://github.com/fastapi/fastapi/pull/12521) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/deployment/cloud.md`. PR [#12522](https://github.com/fastapi/fastapi/pull/12522) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/how-to/index.md`. PR [#12523](https://github.com/fastapi/fastapi/pull/12523) by [@codingjenny](https://github.com/codingjenny).
From fd95b4ae6522909baf64364f8fdadf985db130fc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 26 Oct 2024 10:37:59 +0100
Subject: [PATCH 230/504] =?UTF-8?q?=E2=AC=86=20Bump=20cloudflare/wrangler-?=
=?UTF-8?q?action=20from=203.9=20to=203.11=20(#12544)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Bumps [cloudflare/wrangler-action](https://github.com/cloudflare/wrangler-action) from 3.9 to 3.11.
- [Release notes](https://github.com/cloudflare/wrangler-action/releases)
- [Changelog](https://github.com/cloudflare/wrangler-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/cloudflare/wrangler-action/compare/v3.9...v3.11)
---
updated-dependencies:
- dependency-name: cloudflare/wrangler-action
dependency-type: direct:production
update-type: version-update:semver-minor
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
.github/workflows/deploy-docs.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index 39ea7de52..e46786a53 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -64,7 +64,7 @@ jobs:
BRANCH: ${{ ( github.event.workflow_run.head_repository.full_name == github.repository && github.event.workflow_run.head_branch == 'master' && 'main' ) || ( github.event.workflow_run.head_sha ) }}
# TODO: Use v3 when it's fixed, probably in v3.11
# https://github.com/cloudflare/wrangler-action/issues/307
- uses: cloudflare/wrangler-action@v3.9
+ uses: cloudflare/wrangler-action@v3.11
# uses: cloudflare/wrangler-action@v3
with:
apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
From d60c52bc32b655e23809fa488864098cb3809ce4 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 26 Oct 2024 09:38:20 +0000
Subject: [PATCH 231/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 1720110ec..064d94d98 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -29,6 +29,7 @@ hide:
### Internal
+* ⬆ Bump cloudflare/wrangler-action from 3.9 to 3.11. PR [#12544](https://github.com/fastapi/fastapi/pull/12544) by [@dependabot[bot]](https://github.com/apps/dependabot).
* 👷 Update GitHub Action to deploy docs previews to handle missing deploy comments. PR [#12527](https://github.com/fastapi/fastapi/pull/12527) by [@tiangolo](https://github.com/tiangolo).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12505](https://github.com/fastapi/fastapi/pull/12505) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
From 89f06da526974646a6232115e15c7a05813f932f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 26 Oct 2024 13:45:10 +0200
Subject: [PATCH 232/504] =?UTF-8?q?=F0=9F=93=9D=20Fix=20link=20in=20OAuth2?=
=?UTF-8?q?=20docs=20(#12550)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/security/oauth2-jwt.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/en/docs/tutorial/security/oauth2-jwt.md b/docs/en/docs/tutorial/security/oauth2-jwt.md
index f454a8b28..6ae1507dc 100644
--- a/docs/en/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/en/docs/tutorial/security/oauth2-jwt.md
@@ -72,7 +72,7 @@ It supports many secure hashing algorithms and utilities to work with them.
The recommended algorithm is "Bcrypt".
-Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install PassLib with Bcrypt:
+Make sure you create a [virtual environment](../../virtual-environments.md){.internal-link target=_blank}, activate it, and then install PassLib with Bcrypt:
<div class="termy">
From ea88ab6cf1796bf0542c3f4f6227c8f6aa3cd776 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 26 Oct 2024 11:46:28 +0000
Subject: [PATCH 233/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 064d94d98..770e1a97e 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Fix link in OAuth2 docs. PR [#12550](https://github.com/fastapi/fastapi/pull/12550) by [@tiangolo](https://github.com/tiangolo).
* 📝 Add External Link: FastAPI do Zero. PR [#12533](https://github.com/fastapi/fastapi/pull/12533) by [@rennerocha](https://github.com/rennerocha).
* 📝 Fix minor typos. PR [#12516](https://github.com/fastapi/fastapi/pull/12516) by [@kkirsche](https://github.com/kkirsche).
* 🌐 Fix rendering issue in translations. PR [#12509](https://github.com/fastapi/fastapi/pull/12509) by [@alejsdev](https://github.com/alejsdev).
From 71fcafd13c29fab216a432d4fdfd77555b14483e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 26 Oct 2024 13:47:53 +0200
Subject: [PATCH 234/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/python-types.md`=20(#12551)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/python-types.md | 40 +++++++++---------------------------
1 file changed, 10 insertions(+), 30 deletions(-)
diff --git a/docs/en/docs/python-types.md b/docs/en/docs/python-types.md
index ee192d8cb..6c28577cc 100644
--- a/docs/en/docs/python-types.md
+++ b/docs/en/docs/python-types.md
@@ -22,9 +22,7 @@ If you are a Python expert, and you already know everything about type hints, sk
Let's start with a simple example:
-```Python
-{!../../docs_src/python_types/tutorial001.py!}
-```
+{* ../../docs_src/python_types/tutorial001.py *}
Calling this program outputs:
@@ -38,9 +36,7 @@ The function does the following:
* Converts the first letter of each one to upper case with `title()`.
* <abbr title="Puts them together, as one. With the contents of one after the other.">Concatenates</abbr> them with a space in the middle.
-```Python hl_lines="2"
-{!../../docs_src/python_types/tutorial001.py!}
-```
+{* ../../docs_src/python_types/tutorial001.py hl[2] *}
### Edit it
@@ -82,9 +78,7 @@ That's it.
Those are the "type hints":
-```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial002.py!}
-```
+{* ../../docs_src/python_types/tutorial002.py hl[1] *}
That is not the same as declaring default values like would be with:
@@ -112,9 +106,7 @@ With that, you can scroll, seeing the options, until you find the one that "ring
Check this function, it already has type hints:
-```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial003.py!}
-```
+{* ../../docs_src/python_types/tutorial003.py hl[1] *}
Because the editor knows the types of the variables, you don't only get completion, you also get error checks:
@@ -122,9 +114,7 @@ Because the editor knows the types of the variables, you don't only get completi
Now you know that you have to fix it, convert `age` to a string with `str(age)`:
-```Python hl_lines="2"
-{!../../docs_src/python_types/tutorial004.py!}
-```
+{* ../../docs_src/python_types/tutorial004.py hl[2] *}
## Declaring types
@@ -143,9 +133,7 @@ You can use, for example:
* `bool`
* `bytes`
-```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial005.py!}
-```
+{* ../../docs_src/python_types/tutorial005.py hl[1] *}
### Generic types with type parameters
@@ -369,9 +357,7 @@ It's just about the words and names. But those words can affect how you and your
As an example, let's take this function:
-```Python hl_lines="1 4"
-{!../../docs_src/python_types/tutorial009c.py!}
-```
+{* ../../docs_src/python_types/tutorial009c.py hl[1,4] *}
The parameter `name` is defined as `Optional[str]`, but it is **not optional**, you cannot call the function without the parameter:
@@ -387,9 +373,7 @@ say_hi(name=None) # This works, None is valid 🎉
The good news is, once you are on Python 3.10 you won't have to worry about that, as you will be able to simply use `|` to define unions of types:
-```Python hl_lines="1 4"
-{!../../docs_src/python_types/tutorial009c_py310.py!}
-```
+{* ../../docs_src/python_types/tutorial009c_py310.py hl[1,4] *}
And then you won't have to worry about names like `Optional` and `Union`. 😎
@@ -451,15 +435,11 @@ You can also declare a class as the type of a variable.
Let's say you have a class `Person`, with a name:
-```Python hl_lines="1-3"
-{!../../docs_src/python_types/tutorial010.py!}
-```
+{* ../../docs_src/python_types/tutorial010.py hl[1:3] *}
Then you can declare a variable to be of type `Person`:
-```Python hl_lines="6"
-{!../../docs_src/python_types/tutorial010.py!}
-```
+{* ../../docs_src/python_types/tutorial010.py hl[6] *}
And then, again, you get all the editor support:
From 56bc9a5eb4e150656518fdad689988539c339a74 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 26 Oct 2024 13:48:16 +0200
Subject: [PATCH 235/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/first-steps.md`=20(#12552)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/first-steps.md | 28 +++++++---------------------
1 file changed, 7 insertions(+), 21 deletions(-)
diff --git a/docs/en/docs/tutorial/first-steps.md b/docs/en/docs/tutorial/first-steps.md
index 77728cebe..1c20b945a 100644
--- a/docs/en/docs/tutorial/first-steps.md
+++ b/docs/en/docs/tutorial/first-steps.md
@@ -2,9 +2,7 @@
The simplest FastAPI file could look like this:
-```Python
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py *}
Copy that to a file `main.py`.
@@ -157,9 +155,7 @@ You could also use it to generate code automatically, for clients that communica
### Step 1: import `FastAPI`
-```Python hl_lines="1"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[1] *}
`FastAPI` is a Python class that provides all the functionality for your API.
@@ -173,9 +169,7 @@ You can use all the <a href="https://www.starlette.io/" class="external-link" ta
### Step 2: create a `FastAPI` "instance"
-```Python hl_lines="3"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[3] *}
Here the `app` variable will be an "instance" of the class `FastAPI`.
@@ -244,9 +238,7 @@ We are going to call them "**operations**" too.
#### Define a *path operation decorator*
-```Python hl_lines="6"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[6] *}
The `@app.get("/")` tells **FastAPI** that the function right below is in charge of handling requests that go to:
@@ -300,9 +292,7 @@ This is our "**path operation function**":
* **operation**: is `get`.
* **function**: is the function below the "decorator" (below `@app.get("/")`).
-```Python hl_lines="7"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[7] *}
This is a Python function.
@@ -314,9 +304,7 @@ In this case, it is an `async` function.
You could also define it as a normal function instead of `async def`:
-```Python hl_lines="7"
-{!../../docs_src/first_steps/tutorial003.py!}
-```
+{* ../../docs_src/first_steps/tutorial003.py hl[7] *}
/// note
@@ -326,9 +314,7 @@ If you don't know the difference, check the [Async: *"In a hurry?"*](../async.md
### Step 5: return the content
-```Python hl_lines="8"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[8] *}
You can return a `dict`, `list`, singular values as `str`, `int`, etc.
From 442692fef4df987071637caa4a3a761a20b265f4 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 26 Oct 2024 11:49:36 +0000
Subject: [PATCH 236/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 770e1a97e..9e47695bd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/python-types.md`. PR [#12551](https://github.com/fastapi/fastapi/pull/12551) by [@tiangolo](https://github.com/tiangolo).
* 📝 Fix link in OAuth2 docs. PR [#12550](https://github.com/fastapi/fastapi/pull/12550) by [@tiangolo](https://github.com/tiangolo).
* 📝 Add External Link: FastAPI do Zero. PR [#12533](https://github.com/fastapi/fastapi/pull/12533) by [@rennerocha](https://github.com/rennerocha).
* 📝 Fix minor typos. PR [#12516](https://github.com/fastapi/fastapi/pull/12516) by [@kkirsche](https://github.com/kkirsche).
From 63c3eacf43fc39127d86d69baf5a8caa5f9507f9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 26 Oct 2024 11:51:54 +0000
Subject: [PATCH 237/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9e47695bd..98c6bcb82 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/first-steps.md`. PR [#12552](https://github.com/fastapi/fastapi/pull/12552) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes in `docs/en/docs/python-types.md`. PR [#12551](https://github.com/fastapi/fastapi/pull/12551) by [@tiangolo](https://github.com/tiangolo).
* 📝 Fix link in OAuth2 docs. PR [#12550](https://github.com/fastapi/fastapi/pull/12550) by [@tiangolo](https://github.com/tiangolo).
* 📝 Add External Link: FastAPI do Zero. PR [#12533](https://github.com/fastapi/fastapi/pull/12533) by [@rennerocha](https://github.com/rennerocha).
From 68d0a0412ec7c4ec7e3fe1840fd32d05fcebb338 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 26 Oct 2024 18:01:27 +0200
Subject: [PATCH 238/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/advanced/security/http-basic-auth.md`=20(#1255?=
=?UTF-8?q?3)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../docs/advanced/security/http-basic-auth.md | 90 +------------------
1 file changed, 3 insertions(+), 87 deletions(-)
diff --git a/docs/en/docs/advanced/security/http-basic-auth.md b/docs/en/docs/advanced/security/http-basic-auth.md
index fa652c52b..234e2f940 100644
--- a/docs/en/docs/advanced/security/http-basic-auth.md
+++ b/docs/en/docs/advanced/security/http-basic-auth.md
@@ -20,35 +20,7 @@ Then, when you type that username and password, the browser sends them in the he
* It returns an object of type `HTTPBasicCredentials`:
* It contains the `username` and `password` sent.
-//// tab | Python 3.9+
-
-```Python hl_lines="4 8 12"
-{!> ../../docs_src/security/tutorial006_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="2 7 11"
-{!> ../../docs_src/security/tutorial006_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="2 6 10"
-{!> ../../docs_src/security/tutorial006.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial006_an_py39.py hl[4,8,12] *}
When you try to open the URL for the first time (or click the "Execute" button in the docs) the browser will ask you for your username and password:
@@ -68,35 +40,7 @@ To handle that, we first convert the `username` and `password` to `bytes` encodi
Then we can use `secrets.compare_digest()` to ensure that `credentials.username` is `"stanleyjobson"`, and that `credentials.password` is `"swordfish"`.
-//// tab | Python 3.9+
-
-```Python hl_lines="1 12-24"
-{!> ../../docs_src/security/tutorial007_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="1 12-24"
-{!> ../../docs_src/security/tutorial007_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="1 11-21"
-{!> ../../docs_src/security/tutorial007.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial007_an_py39.py hl[1,12:24] *}
This would be similar to:
@@ -160,32 +104,4 @@ That way, using `secrets.compare_digest()` in your application code, it will be
After detecting that the credentials are incorrect, return an `HTTPException` with a status code 401 (the same returned when no credentials are provided) and add the header `WWW-Authenticate` to make the browser show the login prompt again:
-//// tab | Python 3.9+
-
-```Python hl_lines="26-30"
-{!> ../../docs_src/security/tutorial007_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="26-30"
-{!> ../../docs_src/security/tutorial007_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="23-27"
-{!> ../../docs_src/security/tutorial007.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial007_an_py39.py hl[26:30] *}
From 6e85909311bfa43c7251bc6f2304333b3be36994 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 26 Oct 2024 16:01:48 +0000
Subject: [PATCH 239/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 98c6bcb82..4146331ee 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/advanced/security/http-basic-auth.md`. PR [#12553](https://github.com/fastapi/fastapi/pull/12553) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes in `docs/en/docs/tutorial/first-steps.md`. PR [#12552](https://github.com/fastapi/fastapi/pull/12552) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes in `docs/en/docs/python-types.md`. PR [#12551](https://github.com/fastapi/fastapi/pull/12551) by [@tiangolo](https://github.com/tiangolo).
* 📝 Fix link in OAuth2 docs. PR [#12550](https://github.com/fastapi/fastapi/pull/12550) by [@tiangolo](https://github.com/tiangolo).
From 28e97b2651327acea331442449401f2f3e3c7973 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 26 Oct 2024 18:43:54 +0200
Subject: [PATCH 240/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/how-to/separate-openapi-schemas.md`=20(#12555)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../docs/how-to/separate-openapi-schemas.md | 162 +-----------------
1 file changed, 4 insertions(+), 158 deletions(-)
diff --git a/docs/en/docs/how-to/separate-openapi-schemas.md b/docs/en/docs/how-to/separate-openapi-schemas.md
index 75fd3f9b6..9a27638fe 100644
--- a/docs/en/docs/how-to/separate-openapi-schemas.md
+++ b/docs/en/docs/how-to/separate-openapi-schemas.md
@@ -10,123 +10,13 @@ Let's see how that works and how to change it if you need to do that.
Let's say you have a Pydantic model with default values, like this one:
-//// tab | Python 3.10+
-
-```Python hl_lines="7"
-{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-7]!}
-
-# Code below omitted 👇
-```
-
-<details>
-<summary>👀 Full file preview</summary>
-
-```Python
-{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
-```
-
-</details>
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="9"
-{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-9]!}
-
-# Code below omitted 👇
-```
-
-<details>
-<summary>👀 Full file preview</summary>
-
-```Python
-{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
-```
-
-</details>
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9"
-{!> ../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-9]!}
-
-# Code below omitted 👇
-```
-
-<details>
-<summary>👀 Full file preview</summary>
-
-```Python
-{!> ../../docs_src/separate_openapi_schemas/tutorial001.py!}
-```
-
-</details>
-
-////
+{* ../../docs_src/separate_openapi_schemas/tutorial001_py310.py ln[1:7] hl[7] *}
### Model for Input
If you use this model as an input like here:
-//// tab | Python 3.10+
-
-```Python hl_lines="14"
-{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-15]!}
-
-# Code below omitted 👇
-```
-
-<details>
-<summary>👀 Full file preview</summary>
-
-```Python
-{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
-```
-
-</details>
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="16"
-{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-17]!}
-
-# Code below omitted 👇
-```
-
-<details>
-<summary>👀 Full file preview</summary>
-
-```Python
-{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
-```
-
-</details>
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="16"
-{!> ../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-17]!}
-
-# Code below omitted 👇
-```
-
-<details>
-<summary>👀 Full file preview</summary>
-
-```Python
-{!> ../../docs_src/separate_openapi_schemas/tutorial001.py!}
-```
-
-</details>
-
-////
+{* ../../docs_src/separate_openapi_schemas/tutorial001_py310.py ln[1:15] hl[14] *}
...then the `description` field will **not be required**. Because it has a default value of `None`.
@@ -142,29 +32,7 @@ You can confirm that in the docs, the `description` field doesn't have a **red a
But if you use the same model as an output, like here:
-//// tab | Python 3.10+
-
-```Python hl_lines="19"
-{!> ../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="21"
-{!> ../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="21"
-{!> ../../docs_src/separate_openapi_schemas/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/separate_openapi_schemas/tutorial001_py310.py hl[19] *}
...then because `description` has a default value, if you **don't return anything** for that field, it will still have that **default value**.
@@ -223,29 +91,7 @@ Support for `separate_input_output_schemas` was added in FastAPI `0.102.0`. 🤓
///
-//// tab | Python 3.10+
-
-```Python hl_lines="10"
-{!> ../../docs_src/separate_openapi_schemas/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="12"
-{!> ../../docs_src/separate_openapi_schemas/tutorial002_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="12"
-{!> ../../docs_src/separate_openapi_schemas/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/separate_openapi_schemas/tutorial002_py310.py hl[10] *}
### Same Schema for Input and Output Models in Docs
From d93e431505363fb0f37322136b5d78bf46335f2b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 26 Oct 2024 16:44:15 +0000
Subject: [PATCH 241/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4146331ee..fd56925c9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/how-to/separate-openapi-schemas.md`. PR [#12555](https://github.com/fastapi/fastapi/pull/12555) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes for `docs/en/docs/advanced/security/http-basic-auth.md`. PR [#12553](https://github.com/fastapi/fastapi/pull/12553) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes in `docs/en/docs/tutorial/first-steps.md`. PR [#12552](https://github.com/fastapi/fastapi/pull/12552) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes in `docs/en/docs/python-types.md`. PR [#12551](https://github.com/fastapi/fastapi/pull/12551) by [@tiangolo](https://github.com/tiangolo).
From 162a32cc2f1099838bb1b3876b43964e3f987670 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 26 Oct 2024 18:50:52 +0200
Subject: [PATCH 242/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/how-to/configure-swagger-ui.md`=20(#12556)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/how-to/configure-swagger-ui.md | 16 ++++------------
1 file changed, 4 insertions(+), 12 deletions(-)
diff --git a/docs/en/docs/how-to/configure-swagger-ui.md b/docs/en/docs/how-to/configure-swagger-ui.md
index 2c649c152..a8a8de48f 100644
--- a/docs/en/docs/how-to/configure-swagger-ui.md
+++ b/docs/en/docs/how-to/configure-swagger-ui.md
@@ -18,9 +18,7 @@ Without changing the settings, syntax highlighting is enabled by default:
But you can disable it by setting `syntaxHighlight` to `False`:
-```Python hl_lines="3"
-{!../../docs_src/configure_swagger_ui/tutorial001.py!}
-```
+{* ../../docs_src/configure_swagger_ui/tutorial001.py hl[3] *}
...and then Swagger UI won't show the syntax highlighting anymore:
@@ -30,9 +28,7 @@ But you can disable it by setting `syntaxHighlight` to `False`:
The same way you could set the syntax highlighting theme with the key `"syntaxHighlight.theme"` (notice that it has a dot in the middle):
-```Python hl_lines="3"
-{!../../docs_src/configure_swagger_ui/tutorial002.py!}
-```
+{* ../../docs_src/configure_swagger_ui/tutorial002.py hl[3] *}
That configuration would change the syntax highlighting color theme:
@@ -44,17 +40,13 @@ FastAPI includes some default configuration parameters appropriate for most of t
It includes these default configurations:
-```Python
-{!../../fastapi/openapi/docs.py[ln:7-23]!}
-```
+{* ../../fastapi/openapi/docs.py ln[8:23] hl[17:23] *}
You can override any of them by setting a different value in the argument `swagger_ui_parameters`.
For example, to disable `deepLinking` you could pass these settings to `swagger_ui_parameters`:
-```Python hl_lines="3"
-{!../../docs_src/configure_swagger_ui/tutorial003.py!}
-```
+{* ../../docs_src/configure_swagger_ui/tutorial003.py hl[3] *}
## Other Swagger UI Parameters
From 44cfb2f4f5be67499e17a9e7ec0b2faadeb51af4 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 26 Oct 2024 16:51:17 +0000
Subject: [PATCH 243/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fd56925c9..d0bb66ee6 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/how-to/configure-swagger-ui.md`. PR [#12556](https://github.com/fastapi/fastapi/pull/12556) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes for `docs/en/docs/how-to/separate-openapi-schemas.md`. PR [#12555](https://github.com/fastapi/fastapi/pull/12555) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes for `docs/en/docs/advanced/security/http-basic-auth.md`. PR [#12553](https://github.com/fastapi/fastapi/pull/12553) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes in `docs/en/docs/tutorial/first-steps.md`. PR [#12552](https://github.com/fastapi/fastapi/pull/12552) by [@tiangolo](https://github.com/tiangolo).
From 8d928def2e3e5def8b4ffcd01e9c6efc17c10afe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EC=9E=84=EC=84=A0=EC=98=A4?= <vhtmxj154@naver.com>
Date: Mon, 28 Oct 2024 00:01:38 +0900
Subject: [PATCH 244/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/benchmarks.md`=20(#12540)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/benchmarks.md | 34 ++++++++++++++++++++++++++++++++++
1 file changed, 34 insertions(+)
create mode 100644 docs/ko/docs/benchmarks.md
diff --git a/docs/ko/docs/benchmarks.md b/docs/ko/docs/benchmarks.md
new file mode 100644
index 000000000..aff8ae70e
--- /dev/null
+++ b/docs/ko/docs/benchmarks.md
@@ -0,0 +1,34 @@
+# 벤치마크
+
+독립적인 TechEmpower 벤치마크에 따르면 **FastAPI** 애플리케이션이 Uvicorn을 사용하여 <a href="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class="external-link" target="_blank">가장 빠른 Python 프레임워크 중 하나</a>로 실행되며, Starlette와 Uvicorn 자체(내부적으로 FastAPI가 사용하는 도구)보다 조금 아래에 위치합니다.
+
+그러나 벤치마크와 비교를 확인할 때 다음 사항을 염두에 두어야 합니다.
+
+## 벤치마크와 속도
+
+벤치마크를 확인할 때, 일반적으로 여러 가지 유형의 도구가 동등한 것으로 비교되는 것을 볼 수 있습니다.
+
+특히, Uvicorn, Starlette, FastAPI가 함께 비교되는 경우가 많습니다(다른 여러 도구와 함께).
+
+도구가 해결하는 문제가 단순할수록 성능이 더 좋아집니다. 그리고 대부분의 벤치마크는 도구가 제공하는 추가 기능을 테스트하지 않습니다.
+
+계층 구조는 다음과 같습니다:
+
+* **Uvicorn**: ASGI 서버
+ * **Starlette**: (Uvicorn 사용) 웹 마이크로 프레임워크
+ * **FastAPI**: (Starlette 사용) API 구축을 위한 데이터 검증 등 여러 추가 기능이 포함된 API 마이크로 프레임워크
+
+* **Uvicorn**:
+ * 서버 자체 외에는 많은 추가 코드가 없기 때문에 최고의 성능을 발휘합니다.
+ * 직접 Uvicorn으로 응용 프로그램을 작성하지는 않을 것입니다. 즉, 사용자의 코드에는 적어도 Starlette(또는 **FastAPI**)에서 제공하는 모든 코드가 포함되어야 합니다. 그렇게 하면 최종 응용 프로그램은 프레임워크를 사용하고 앱 코드와 버그를 최소화하는 것과 동일한 오버헤드를 갖게 됩니다.
+ * Uvicorn을 비교할 때는 Daphne, Hypercorn, uWSGI 등의 응용 프로그램 서버와 비교하세요.
+* **Starlette**:
+ * Uvicorn 다음으로 좋은 성능을 발휘합니다. 사실 Starlette는 Uvicorn을 사용하여 실행됩니다. 따라서 더 많은 코드를 실행해야 하기 때문에 Uvicorn보다 "느려질" 수밖에 없습니다.
+ * 하지만 경로 기반 라우팅 등 간단한 웹 응용 프로그램을 구축할 수 있는 도구를 제공합니다.
+ * Starlette를 비교할 때는 Sanic, Flask, Django 등의 웹 프레임워크(또는 마이크로 프레임워크)와 비교하세요.
+* **FastAPI**:
+ * Starlette가 Uvicorn을 사용하므로 Uvicorn보다 빨라질 수 없는 것과 마찬가지로, **FastAPI**는 Starlette를 사용하므로 더 빠를 수 없습니다.
+ * FastAPI는 Starlette에 추가적으로 더 많은 기능을 제공합니다. API를 구축할 때 거의 항상 필요한 데이터 검증 및 직렬화와 같은 기능들이 포함되어 있습니다. 그리고 이를 사용하면 문서 자동화 기능도 제공됩니다(문서 자동화는 응용 프로그램 실행 시 오버헤드를 추가하지 않고 시작 시 생성됩니다).
+ * FastAPI를 사용하지 않고 직접 Starlette(또는 Sanic, Flask, Responder 등)를 사용했다면 데이터 검증 및 직렬화를 직접 구현해야 합니다. 따라서 최종 응용 프로그램은 FastAPI를 사용한 것과 동일한 오버헤드를 가지게 될 것입니다. 많은 경우 데이터 검증 및 직렬화가 응용 프로그램에서 작성된 코드 중 가장 많은 부분을 차지합니다.
+ * 따라서 FastAPI를 사용함으로써 개발 시간, 버그, 코드 라인을 줄일 수 있으며, FastAPI를 사용하지 않았을 때와 동일하거나 더 나은 성능을 얻을 수 있습니다(코드에서 모두 구현해야 하기 때문에).
+ * FastAPI를 비교할 때는 Flask-apispec, NestJS, Molten 등 데이터 검증, 직렬화 및 문서화가 통합된 자동 데이터 검증, 직렬화 및 문서화를 제공하는 웹 응용 프로그램 프레임워크(또는 도구 집합)와 비교하세요.
From 128c96dc9a9785013206fe878014ebb589fe32da Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 15:02:00 +0000
Subject: [PATCH 245/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d0bb66ee6..757ed7023 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -21,6 +21,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `docs/ko/docs/benchmarks.md`. PR [#12540](https://github.com/fastapi/fastapi/pull/12540) by [@Limsunoh](https://github.com/Limsunoh).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/separate-openapi-schemas.md`. PR [#12518](https://github.com/fastapi/fastapi/pull/12518) by [@ilacftemp](https://github.com/ilacftemp).
* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/deployment/index.md`. PR [#12521](https://github.com/fastapi/fastapi/pull/12521) by [@codingjenny](https://github.com/codingjenny).
* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/deployment/cloud.md`. PR [#12522](https://github.com/fastapi/fastapi/pull/12522) by [@codingjenny](https://github.com/codingjenny).
From 092da9a8a303dc1bc71bc644f75266ff8f94fbe3 Mon Sep 17 00:00:00 2001
From: Philip Okiokio <55271518+philipokiokio@users.noreply.github.com>
Date: Sun, 27 Oct 2024 16:15:05 +0100
Subject: [PATCH 246/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/how-to/extending-openapi.md`=20(#12562)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/how-to/extending-openapi.md | 30 ++++++++++++------------
1 file changed, 15 insertions(+), 15 deletions(-)
diff --git a/docs/en/docs/how-to/extending-openapi.md b/docs/en/docs/how-to/extending-openapi.md
index 2b0367952..8c7790725 100644
--- a/docs/en/docs/how-to/extending-openapi.md
+++ b/docs/en/docs/how-to/extending-openapi.md
@@ -43,25 +43,24 @@ For example, let's add <a href="https://github.com/Rebilly/ReDoc/blob/master/doc
First, write all your **FastAPI** application as normally:
-```Python hl_lines="1 4 7-9"
-{!../../docs_src/extending_openapi/tutorial001.py!}
-```
+{* ../../docs_src/extending_openapi/tutorial001.py hl[1,4,7:9] *}
+
### Generate the OpenAPI schema
Then, use the same utility function to generate the OpenAPI schema, inside a `custom_openapi()` function:
-```Python hl_lines="2 15-21"
-{!../../docs_src/extending_openapi/tutorial001.py!}
-```
+
+
+{* ../../docs_src/extending_openapi/tutorial001.py hl[2,15:21] *}
+
### Modify the OpenAPI schema
Now you can add the ReDoc extension, adding a custom `x-logo` to the `info` "object" in the OpenAPI schema:
-```Python hl_lines="22-24"
-{!../../docs_src/extending_openapi/tutorial001.py!}
-```
+{* ../../docs_src/extending_openapi/tutorial001.py hl[22:24] *}
+
### Cache the OpenAPI schema
@@ -71,17 +70,18 @@ That way, your application won't have to generate the schema every time a user o
It will be generated only once, and then the same cached schema will be used for the next requests.
-```Python hl_lines="13-14 25-26"
-{!../../docs_src/extending_openapi/tutorial001.py!}
-```
+
+{* ../../docs_src/extending_openapi/tutorial001.py hl[13:14,25:26] *}
+
### Override the method
Now you can replace the `.openapi()` method with your new function.
-```Python hl_lines="29"
-{!../../docs_src/extending_openapi/tutorial001.py!}
-```
+
+
+{* ../../docs_src/extending_openapi/tutorial001.py hl[29] *}
+
### Check it
From aec5219fe068a139f63e34255c54c968b00897ac Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 15:15:30 +0000
Subject: [PATCH 247/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 757ed7023..d9f5e1b4f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/how-to/extending-openapi.md`. PR [#12562](https://github.com/fastapi/fastapi/pull/12562) by [@philipokiokio](https://github.com/philipokiokio).
* 📝 Update includes for `docs/en/docs/how-to/configure-swagger-ui.md`. PR [#12556](https://github.com/fastapi/fastapi/pull/12556) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes for `docs/en/docs/how-to/separate-openapi-schemas.md`. PR [#12555](https://github.com/fastapi/fastapi/pull/12555) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes for `docs/en/docs/advanced/security/http-basic-auth.md`. PR [#12553](https://github.com/fastapi/fastapi/pull/12553) by [@tiangolo](https://github.com/tiangolo).
From 50c6f801170ef991bc6df0095932314bf2f67d9a Mon Sep 17 00:00:00 2001
From: Philip Okiokio <55271518+philipokiokio@users.noreply.github.com>
Date: Sun, 27 Oct 2024 16:18:53 +0100
Subject: [PATCH 248/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/how-to/graphql.md`=20(#12564)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/how-to/graphql.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/docs/en/docs/how-to/graphql.md b/docs/en/docs/how-to/graphql.md
index 2a4377d16..5d8f879d1 100644
--- a/docs/en/docs/how-to/graphql.md
+++ b/docs/en/docs/how-to/graphql.md
@@ -35,9 +35,9 @@ Depending on your use case, you might prefer to use a different library, but if
Here's a small preview of how you could integrate Strawberry with FastAPI:
-```Python hl_lines="3 22 25-26"
-{!../../docs_src/graphql/tutorial001.py!}
-```
+
+{* ../../docs_src/graphql/tutorial001.py hl[3,22,25:26] *}
+
You can learn more about Strawberry in the <a href="https://strawberry.rocks/" class="external-link" target="_blank">Strawberry documentation</a>.
From a1572b52de098cc48c7306d9bdb5d791e554cd6e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 15:19:49 +0000
Subject: [PATCH 249/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d9f5e1b4f..2f299f4e3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/how-to/graphql.md`. PR [#12564](https://github.com/fastapi/fastapi/pull/12564) by [@philipokiokio](https://github.com/philipokiokio).
* 📝 Update includes in `docs/en/docs/how-to/extending-openapi.md`. PR [#12562](https://github.com/fastapi/fastapi/pull/12562) by [@philipokiokio](https://github.com/philipokiokio).
* 📝 Update includes for `docs/en/docs/how-to/configure-swagger-ui.md`. PR [#12556](https://github.com/fastapi/fastapi/pull/12556) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes for `docs/en/docs/how-to/separate-openapi-schemas.md`. PR [#12555](https://github.com/fastapi/fastapi/pull/12555) by [@tiangolo](https://github.com/tiangolo).
From 1fbbf9ca6c71e011d9761cbe9cd21747e6101ae1 Mon Sep 17 00:00:00 2001
From: Ismail Tlemcani <ismail.tlemcani.91@gmail.com>
Date: Sun, 27 Oct 2024 16:21:34 +0100
Subject: [PATCH 250/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/fr/docs/python-types.md`=20(#12558)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/fr/docs/python-types.md | 57 ++++++++++--------------------------
1 file changed, 15 insertions(+), 42 deletions(-)
diff --git a/docs/fr/docs/python-types.md b/docs/fr/docs/python-types.md
index 2992347be..8a0f1f3f4 100644
--- a/docs/fr/docs/python-types.md
+++ b/docs/fr/docs/python-types.md
@@ -23,9 +23,7 @@ Si vous êtes un expert Python, et que vous savez déjà **tout** sur les annota
Prenons un exemple simple :
-```Python
-{!../../docs_src/python_types/tutorial001.py!}
-```
+{*../../docs_src/python_types/tutorial001.py*}
Exécuter ce programe affiche :
@@ -39,9 +37,7 @@ La fonction :
* Convertit la première lettre de chaque paramètre en majuscules grâce à `title()`.
* Concatène les résultats avec un espace entre les deux.
-```Python hl_lines="2"
-{!../../docs_src/python_types/tutorial001.py!}
-```
+{*../../docs_src/python_types/tutorial001.py hl[2] *}
### Limitations
@@ -84,9 +80,7 @@ C'est tout.
Ce sont des annotations de types :
-```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial002.py!}
-```
+{*../../docs_src/python_types/tutorial002.py hl[1] *}
À ne pas confondre avec la déclaration de valeurs par défaut comme ici :
@@ -114,9 +108,7 @@ Vous pouvez donc dérouler les options jusqu'à trouver la méthode à laquelle
Cette fonction possède déjà des annotations de type :
-```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial003.py!}
-```
+{*../../docs_src/python_types/tutorial003.py hl[1] *}
Comme l'éditeur connaît le type des variables, vous n'avez pas seulement l'auto-complétion, mais aussi de la détection d'erreurs :
@@ -124,9 +116,7 @@ Comme l'éditeur connaît le type des variables, vous n'avez pas seulement l'aut
Maintenant que vous avez connaissance du problème, convertissez `age` en <abbr title="string">chaîne de caractères</abbr> grâce à `str(age)` :
-```Python hl_lines="2"
-{!../../docs_src/python_types/tutorial004.py!}
-```
+{*../../docs_src/python_types/tutorial004.py hl[2] *}
## Déclarer des types
@@ -145,9 +135,7 @@ Comme par exemple :
* `bool`
* `bytes`
-```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial005.py!}
-```
+{*../../docs_src/python_types/tutorial005.py hl[1] *}
### Types génériques avec des paramètres de types
@@ -163,9 +151,7 @@ Par exemple, définissons une variable comme `list` de `str`.
Importez `List` (avec un `L` majuscule) depuis `typing`.
-```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial006.py!}
-```
+{*../../docs_src/python_types/tutorial006.py hl[1] *}
Déclarez la variable, en utilisant la syntaxe des deux-points (`:`).
@@ -173,9 +159,7 @@ Et comme type, mettez `List`.
Les listes étant un type contenant des types internes, mettez ces derniers entre crochets (`[`, `]`) :
-```Python hl_lines="4"
-{!../../docs_src/python_types/tutorial006.py!}
-```
+{*../../docs_src/python_types/tutorial006.py hl[4] *}
/// tip | "Astuce"
@@ -201,9 +185,7 @@ Et pourtant, l'éditeur sait qu'elle est de type `str` et pourra donc vous aider
C'est le même fonctionnement pour déclarer un `tuple` ou un `set` :
-```Python hl_lines="1 4"
-{!../../docs_src/python_types/tutorial007.py!}
-```
+{*../../docs_src/python_types/tutorial007.py hl[1,4] *}
Dans cet exemple :
@@ -216,9 +198,7 @@ Pour définir un `dict`, il faut lui passer 2 paramètres, séparés par une vir
Le premier paramètre de type est pour les clés et le second pour les valeurs du dictionnaire (`dict`).
-```Python hl_lines="1 4"
-{!../../docs_src/python_types/tutorial008.py!}
-```
+{*../../docs_src/python_types/tutorial008.py hl[1,4] *}
Dans cet exemple :
@@ -230,9 +210,7 @@ Dans cet exemple :
Vous pouvez aussi utiliser `Optional` pour déclarer qu'une variable a un type, comme `str` mais qu'il est "optionnel" signifiant qu'il pourrait aussi être `None`.
-```Python hl_lines="1 4"
-{!../../docs_src/python_types/tutorial009.py!}
-```
+{*../../docs_src/python_types/tutorial009.py hl[1,4] *}
Utiliser `Optional[str]` plutôt que `str` permettra à l'éditeur de vous aider à détecter les erreurs où vous supposeriez qu'une valeur est toujours de type `str`, alors qu'elle pourrait aussi être `None`.
@@ -255,15 +233,12 @@ Vous pouvez aussi déclarer une classe comme type d'une variable.
Disons que vous avez une classe `Person`, avec une variable `name` :
-```Python hl_lines="1-3"
-{!../../docs_src/python_types/tutorial010.py!}
-```
+{*../../docs_src/python_types/tutorial010.py hl[1:3] *}
+
Vous pouvez ensuite déclarer une variable de type `Person` :
-```Python hl_lines="6"
-{!../../docs_src/python_types/tutorial010.py!}
-```
+{*../../docs_src/python_types/tutorial010.py hl[6] *}
Et vous aurez accès, encore une fois, au support complet offert par l'éditeur :
@@ -283,9 +258,7 @@ Ainsi, votre éditeur vous offrira un support adapté pour l'objet résultant.
Extrait de la documentation officielle de **Pydantic** :
-```Python
-{!../../docs_src/python_types/tutorial011.py!}
-```
+{*../../docs_src/python_types/tutorial011.py*}
/// info
From 4ae5fab050d40025541c26e9122f8ab862aca8ce Mon Sep 17 00:00:00 2001
From: Farhan Ali Raza <62690310+FarhanAliRaza@users.noreply.github.com>
Date: Sun, 27 Oct 2024 20:22:48 +0500
Subject: [PATCH 251/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/background-tasks.md`=20(#12559)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/background-tasks.md | 62 ++---------------------
1 file changed, 4 insertions(+), 58 deletions(-)
diff --git a/docs/en/docs/tutorial/background-tasks.md b/docs/en/docs/tutorial/background-tasks.md
index 1cd460b07..92427e36e 100644
--- a/docs/en/docs/tutorial/background-tasks.md
+++ b/docs/en/docs/tutorial/background-tasks.md
@@ -15,9 +15,7 @@ This includes, for example:
First, import `BackgroundTasks` and define a parameter in your *path operation function* with a type declaration of `BackgroundTasks`:
-```Python hl_lines="1 13"
-{!../../docs_src/background_tasks/tutorial001.py!}
-```
+{* ../../docs_src/background_tasks/tutorial001.py hl[1,13] *}
**FastAPI** will create the object of type `BackgroundTasks` for you and pass it as that parameter.
@@ -33,17 +31,13 @@ In this case, the task function will write to a file (simulating sending an emai
And as the write operation doesn't use `async` and `await`, we define the function with normal `def`:
-```Python hl_lines="6-9"
-{!../../docs_src/background_tasks/tutorial001.py!}
-```
+{* ../../docs_src/background_tasks/tutorial001.py hl[6:9] *}
## Add the background task
Inside of your *path operation function*, pass your task function to the *background tasks* object with the method `.add_task()`:
-```Python hl_lines="14"
-{!../../docs_src/background_tasks/tutorial001.py!}
-```
+{* ../../docs_src/background_tasks/tutorial001.py hl[14] *}
`.add_task()` receives as arguments:
@@ -57,57 +51,9 @@ Using `BackgroundTasks` also works with the dependency injection system, you can
**FastAPI** knows what to do in each case and how to reuse the same object, so that all the background tasks are merged together and are run in the background afterwards:
-//// tab | Python 3.10+
-```Python hl_lines="13 15 22 25"
-{!> ../../docs_src/background_tasks/tutorial002_an_py310.py!}
-```
+{* ../../docs_src/background_tasks/tutorial002_an_py310.py hl[13,15,22,25] *}
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="13 15 22 25"
-{!> ../../docs_src/background_tasks/tutorial002_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="14 16 23 26"
-{!> ../../docs_src/background_tasks/tutorial002_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="11 13 20 23"
-{!> ../../docs_src/background_tasks/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="13 15 22 25"
-{!> ../../docs_src/background_tasks/tutorial002.py!}
-```
-
-////
In this example, the messages will be written to the `log.txt` file *after* the response is sent.
From 4f5349445d234b224ecdb9cb7c562d21919e77b1 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 15:24:00 +0000
Subject: [PATCH 252/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2f299f4e3..cd9b6872a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/fr/docs/python-types.md`. PR [#12558](https://github.com/fastapi/fastapi/pull/12558) by [@Ismailtlem](https://github.com/Ismailtlem).
* 📝 Update includes in `docs/en/docs/how-to/graphql.md`. PR [#12564](https://github.com/fastapi/fastapi/pull/12564) by [@philipokiokio](https://github.com/philipokiokio).
* 📝 Update includes in `docs/en/docs/how-to/extending-openapi.md`. PR [#12562](https://github.com/fastapi/fastapi/pull/12562) by [@philipokiokio](https://github.com/philipokiokio).
* 📝 Update includes for `docs/en/docs/how-to/configure-swagger-ui.md`. PR [#12556](https://github.com/fastapi/fastapi/pull/12556) by [@tiangolo](https://github.com/tiangolo).
From 13f3dd2111cb1bdcb1a31dfc191a4e3738db64c8 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 15:24:07 +0000
Subject: [PATCH 253/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index cd9b6872a..e27571ea0 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/background-tasks.md`. PR [#12559](https://github.com/fastapi/fastapi/pull/12559) by [@FarhanAliRaza](https://github.com/FarhanAliRaza).
* 📝 Update includes in `docs/fr/docs/python-types.md`. PR [#12558](https://github.com/fastapi/fastapi/pull/12558) by [@Ismailtlem](https://github.com/Ismailtlem).
* 📝 Update includes in `docs/en/docs/how-to/graphql.md`. PR [#12564](https://github.com/fastapi/fastapi/pull/12564) by [@philipokiokio](https://github.com/philipokiokio).
* 📝 Update includes in `docs/en/docs/how-to/extending-openapi.md`. PR [#12562](https://github.com/fastapi/fastapi/pull/12562) by [@philipokiokio](https://github.com/philipokiokio).
From 92bc3d7e0c73876f3fb9b01d9ee69a7cf8c4e971 Mon Sep 17 00:00:00 2001
From: ilacftemp <159066669+ilacftemp@users.noreply.github.com>
Date: Sun, 27 Oct 2024 12:25:29 -0300
Subject: [PATCH 254/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/sql-databases.md`=20(#125?=
=?UTF-8?q?30)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/tutorial/sql-databases.md | 359 +++++++++++++++++++++++++
1 file changed, 359 insertions(+)
create mode 100644 docs/pt/docs/tutorial/sql-databases.md
diff --git a/docs/pt/docs/tutorial/sql-databases.md b/docs/pt/docs/tutorial/sql-databases.md
new file mode 100644
index 000000000..3d76a532c
--- /dev/null
+++ b/docs/pt/docs/tutorial/sql-databases.md
@@ -0,0 +1,359 @@
+# Bancos de Dados SQL (Relacionais)
+
+**FastAPI** não exige que você use um banco de dados SQL (relacional). Mas você pode usar **qualquer banco de dados** que quiser.
+
+Aqui veremos um exemplo usando <a href="https://sqlmodel.tiangolo.com/" class="external-link" target="_blank">SQLModel</a>.
+
+**SQLModel** é construído sobre <a href="https://www.sqlalchemy.org/" class="external-link" target="_blank">SQLAlchemy</a> e Pydantic. Ele foi criado pelo mesmo autor do **FastAPI** para ser o par perfeito para aplicações **FastAPI** que precisam usar **bancos de dados SQL**.
+
+/// tip | Dica
+
+Você pode usar qualquer outra biblioteca de banco de dados SQL ou NoSQL que quiser (em alguns casos chamadas de <abbr title="Object Relational Mapper, um termo sofisticado para uma biblioteca onde algumas classes representam tabelas SQL e instâncias representam linhas nessas tabelas">"ORMs"</abbr>), o FastAPI não obriga você a usar nada. 😎
+
+///
+
+Como o SQLModel é baseado no SQLAlchemy, você pode facilmente usar **qualquer banco de dados suportado** pelo SQLAlchemy (o que também os torna suportados pelo SQLModel), como:
+
+* PostgreSQL
+* MySQL
+* SQLite
+* Oracle
+* Microsoft SQL Server, etc.
+
+Neste exemplo, usaremos **SQLite**, porque ele usa um único arquivo e o Python tem suporte integrado. Assim, você pode copiar este exemplo e executá-lo como está.
+
+Mais tarde, para sua aplicação em produção, você pode querer usar um servidor de banco de dados como o **PostgreSQL**.
+
+/// tip | Dica
+
+Existe um gerador de projetos oficial com **FastAPI** e **PostgreSQL** incluindo um frontend e mais ferramentas: <a href="https://github.com/fastapi/full-stack-fastapi-template" class="external-link" target="_blank">https://github.com/fastapi/full-stack-fastapi-template</a>
+
+///
+
+Este é um tutorial muito simples e curto, se você quiser aprender sobre bancos de dados em geral, sobre SQL ou recursos mais avançados, acesse a <a href="https://sqlmodel.tiangolo.com/" class="external-link" target="_blank">documentação do SQLModel</a>.
+
+## Instalar o `SQLModel`
+
+Primeiro, certifique-se de criar seu [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, ativá-lo e, em seguida, instalar o `sqlmodel`:
+
+<div class="termy">
+
+```console
+$ pip install sqlmodel
+---> 100%
+```
+
+</div>
+
+## Criar o App com um Único Modelo
+
+Vamos criar a primeira versão mais simples do app com um único modelo **SQLModel**.
+
+Depois, vamos melhorá-lo aumentando a segurança e versatilidade com **múltiplos modelos** abaixo. 🤓
+
+### Criar Modelos
+
+Importe o `SQLModel` e crie um modelo de banco de dados:
+
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[1:11] hl[7:11] *}
+
+A classe `Hero` é muito semelhante a um modelo Pydantic (na verdade, por baixo dos panos, ela *é um modelo Pydantic*).
+
+Existem algumas diferenças:
+
+* `table=True` informa ao SQLModel que este é um *modelo de tabela*, ele deve representar uma **tabela** no banco de dados SQL, não é apenas um *modelo de dados* (como seria qualquer outra classe Pydantic comum).
+
+* `Field(primary_key=True)` informa ao SQLModel que o `id` é a **chave primária** no banco de dados SQL (você pode aprender mais sobre chaves primárias SQL na documentação do SQLModel).
+
+ Ao ter o tipo como `int | None`, o SQLModel saberá que essa coluna deve ser um `INTEGER` no banco de dados SQL e que ela deve ser `NULLABLE`.
+
+* `Field(index=True)` informa ao SQLModel que ele deve criar um **índice SQL** para essa coluna, o que permitirá buscas mais rápidas no banco de dados ao ler dados filtrados por essa coluna.
+
+ O SQLModel saberá que algo declarado como `str` será uma coluna SQL do tipo `TEXT` (ou `VARCHAR`, dependendo do banco de dados).
+
+### Criar um Engine
+Um `engine` SQLModel (por baixo dos panos, ele é na verdade um `engine` do SQLAlchemy) é o que **mantém as conexões** com o banco de dados.
+
+Você teria **um único objeto `engine`** para todo o seu código se conectar ao mesmo banco de dados.
+
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[14:18] hl[14:15,17:18] *}
+
+Usar `check_same_thread=False` permite que o FastAPI use o mesmo banco de dados SQLite em diferentes threads. Isso é necessário, pois **uma única requisição** pode usar **mais de uma thread** (por exemplo, em dependências).
+
+Não se preocupe, com a forma como o código está estruturado, garantiremos que usamos **uma única *sessão* SQLModel por requisição** mais tarde, isso é realmente o que o `check_same_thread` está tentando conseguir.
+
+### Criar as Tabelas
+
+Em seguida, adicionamos uma função que usa `SQLModel.metadata.create_all(engine)` para **criar as tabelas** para todos os *modelos de tabela*.
+
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[21:22] hl[21:22] *}
+
+### Criar uma Dependência de Sessão
+
+Uma **`Session`** é o que armazena os **objetos na memória** e acompanha as alterações necessárias nos dados, para então **usar o `engine`** para se comunicar com o banco de dados.
+
+Vamos criar uma **dependência** do FastAPI com `yield` que fornecerá uma nova `Session` para cada requisição. Isso é o que garante que usamos uma única sessão por requisição. 🤓
+
+Então, criamos uma dependência `Annotated` chamada `SessionDep` para simplificar o restante do código que usará essa dependência.
+
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[25:30] hl[25:27,30] *}
+
+### Criar Tabelas de Banco de Dados na Inicialização
+
+Vamos criar as tabelas do banco de dados quando o aplicativo for iniciado.
+
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[32:37] hl[35:37] *}
+
+Aqui, criamos as tabelas em um evento de inicialização do aplicativo.
+
+Para produção, você provavelmente usaria um script de migração que é executado antes de iniciar seu app. 🤓
+
+/// tip | Dica
+
+O SQLModel terá utilitários de migração envolvendo o Alembic, mas por enquanto, você pode usar o <a href="https://alembic.sqlalchemy.org/en/latest/" class="external-link" target="_blank">Alembic</a> diretamente.
+
+///
+
+### Criar um Hero
+
+Como cada modelo SQLModel também é um modelo Pydantic, você pode usá-lo nas mesmas **anotações de tipo** que usaria para modelos Pydantic.
+
+Por exemplo, se você declarar um parâmetro do tipo `Hero`, ele será lido do **corpo JSON**.
+
+Da mesma forma, você pode declará-lo como o **tipo de retorno** da função, e então o formato dos dados aparecerá na interface de documentação automática da API.
+
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[40:45] hl[40:45] *}
+
+</details>
+
+Aqui, usamos a dependência `SessionDep` (uma `Session`) para adicionar o novo `Hero` à instância `Session`, fazer commit das alterações no banco de dados, atualizar os dados no `hero` e então retorná-lo.
+
+### Ler Heroes
+
+Podemos **ler** `Hero`s do banco de dados usando um `select()`. Podemos incluir um `limit` e `offset` para paginar os resultados.
+
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[48:55] hl[51:52,54] *}
+
+### Ler um Único Hero
+
+Podemos **ler** um único `Hero`.
+
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[58:63] hl[60] *}
+
+### Deletar um Hero
+
+Também podemos **deletar** um `Hero`.
+
+{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[66:73] hl[71] *}
+
+### Executar o App
+
+Você pode executar o app:
+
+<div class="termy">
+
+```console
+$ fastapi dev main.py
+
+<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+</div>
+
+Então, vá para a interface `/docs`, você verá que o **FastAPI** está usando esses **modelos** para **documentar** a API, e ele também os usará para **serializar** e **validar** os dados.
+
+<div class="screenshot">
+<img src="/img/tutorial/sql-databases/image01.png">
+</div>
+
+## Atualizar o App com Múltiplos Modelos
+
+Agora vamos **refatorar** este app um pouco para aumentar a **segurança** e **versatilidade**.
+
+Se você verificar o app anterior, na interface você pode ver que, até agora, ele permite que o cliente decida o `id` do `Hero` a ser criado. 😱
+
+Não deveríamos deixar isso acontecer, eles poderiam sobrescrever um `id` que já atribuimos na base de dados. Decidir o `id` deve ser feito pelo **backend** ou pelo **banco de dados**, **não pelo cliente**.
+
+Além disso, criamos um `secret_name` para o hero, mas até agora estamos retornando ele em todos os lugares, isso não é muito **secreto**... 😅
+
+Vamos corrigir essas coisas adicionando alguns **modelos extras**. Aqui é onde o SQLModel vai brilhar. ✨
+
+### Criar Múltiplos Modelos
+
+No **SQLModel**, qualquer classe de modelo que tenha `table=True` é um **modelo de tabela**.
+
+E qualquer classe de modelo que não tenha `table=True` é um **modelo de dados**, esses são na verdade apenas modelos Pydantic (com alguns recursos extras pequenos). 🤓
+
+Com o SQLModel, podemos usar a **herança** para **evitar duplicação** de todos os campos em todos os casos.
+
+#### `HeroBase` - a classe base
+
+Vamos começar com um modelo `HeroBase` que tem todos os **campos compartilhados** por todos os modelos:
+
+* `name`
+* `age`
+
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[7:9] hl[7:9] *}
+
+#### `Hero` - o *modelo de tabela*
+
+Em seguida, vamos criar `Hero`, o verdadeiro *modelo de tabela*, com os **campos extras** que nem sempre estão nos outros modelos:
+
+* `id`
+* `secret_name`
+
+Como `Hero` herda de `HeroBase`, ele **também** tem os **campos** declarados em `HeroBase`, então todos os campos para `Hero` são:
+
+* `id`
+* `name`
+* `age`
+* `secret_name`
+
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[7:14] hl[12:14] *}
+
+#### `HeroPublic` - o *modelo de dados* público
+
+Em seguida, criamos um modelo `HeroPublic`, que será **retornado** para os clientes da API.
+
+Ele tem os mesmos campos que `HeroBase`, então não incluirá `secret_name`.
+
+Finalmente, a identidade dos nossos heróis está protegida! 🥷
+
+Ele também declara novamente `id: int`. Ao fazer isso, estamos fazendo um **contrato** com os clientes da API, para que eles possam sempre esperar que o `id` estará lá e será um `int` (nunca será `None`).
+
+/// tip | Dica
+
+Fazer com que o modelo de retorno garanta que um valor esteja sempre disponível e sempre seja um `int` (não `None`) é muito útil para os clientes da API, eles podem escrever código muito mais simples com essa certeza.
+
+Além disso, **clientes gerados automaticamente** terão interfaces mais simples, para que os desenvolvedores que se comunicam com sua API possam ter uma experiência muito melhor trabalhando com sua API. 😎
+
+///
+
+Todos os campos em `HeroPublic` são os mesmos que em `HeroBase`, com `id` declarado como `int` (não `None`):
+
+* `id`
+* `name`
+* `age`
+* `secret_name`
+
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[7:18] hl[17:18] *}
+
+#### `HeroCreate` - o *modelo de dados* para criar um hero
+
+Agora criamos um modelo `HeroCreate`, este é o que **validará** os dados dos clientes.
+
+Ele tem os mesmos campos que `HeroBase`, e também tem `secret_name`.
+
+Agora, quando os clientes **criarem um novo hero**, eles enviarão o `secret_name`, ele será armazenado no banco de dados, mas esses nomes secretos não serão retornados na API para os clientes.
+
+/// tip | Dica
+
+É assim que você trataria **senhas**. Receba-as, mas não as retorne na API.
+
+Você também faria um **hash** com os valores das senhas antes de armazená-los, **nunca os armazene em texto simples**.
+
+///
+
+Os campos de `HeroCreate` são:
+
+* `name`
+* `age`
+* `secret_name`
+
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[7:22] hl[21:22] *}
+
+#### `HeroUpdate` - o *modelo de dados* para atualizar um hero
+
+Não tínhamos uma maneira de **atualizar um hero** na versão anterior do app, mas agora com **múltiplos modelos**, podemos fazer isso. 🎉
+
+O *modelo de dados* `HeroUpdate` é um pouco especial, ele tem **todos os mesmos campos** que seriam necessários para criar um novo hero, mas todos os campos são **opcionais** (todos têm um valor padrão). Dessa forma, quando você atualizar um hero, poderá enviar apenas os campos que deseja atualizar.
+
+Como todos os **campos realmente mudam** (o tipo agora inclui `None` e eles agora têm um valor padrão de `None`), precisamos **declarar novamente** todos eles.
+
+Não precisamos herdar de `HeroBase`, pois estamos redeclarando todos os campos. Vou deixá-lo herdando apenas por consistência, mas isso não é necessário. É mais uma questão de gosto pessoal. 🤷
+
+Os campos de `HeroUpdate` são:
+
+* `name`
+* `age`
+* `secret_name`
+
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[7:28] hl[25:28] *}
+
+### Criar com `HeroCreate` e retornar um `HeroPublic`
+
+Agora que temos **múltiplos modelos**, podemos atualizar as partes do app que os utilizam.
+
+Recebemos na requisição um *modelo de dados* `HeroCreate`, e a partir dele, criamos um *modelo de tabela* `Hero`.
+
+Esse novo *modelo de tabela* `Hero` terá os campos enviados pelo cliente, e também terá um `id` gerado pelo banco de dados.
+
+Em seguida, retornamos o mesmo *modelo de tabela* `Hero` como está na função. Mas como declaramos o `response_model` com o *modelo de dados* `HeroPublic`, o **FastAPI** usará `HeroPublic` para validar e serializar os dados.
+
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[56:62] hl[56:58] *}
+
+/// tip | Dica
+
+Agora usamos `response_model=HeroPublic` em vez da **anotação de tipo de retorno** `-> HeroPublic` porque o valor que estamos retornando na verdade *não* é um `HeroPublic`.
+
+Se tivéssemos declarado `-> HeroPublic`, seu editor e o linter reclamariam (com razão) que você está retornando um `Hero` em vez de um `HeroPublic`.
+
+Ao declará-lo no `response_model`, estamos dizendo ao **FastAPI** para fazer o seu trabalho, sem interferir nas anotações de tipo e na ajuda do seu editor e de outras ferramentas.
+
+///
+
+### Ler Heroes com `HeroPublic`
+
+Podemos fazer o mesmo que antes para **ler** `Hero`s, novamente, usamos `response_model=list[HeroPublic]` para garantir que os dados sejam validados e serializados corretamente.
+
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[65:72] hl[65] *}
+
+### Ler Um Hero com `HeroPublic`
+
+Podemos **ler** um único herói:
+
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[75:80] hl[77] *}
+
+### Atualizar um Hero com `HeroUpdate`
+
+Podemos **atualizar um hero**. Para isso, usamos uma operação HTTP `PATCH`.
+
+E no código, obtemos um `dict` com todos os dados enviados pelo cliente, **apenas os dados enviados pelo cliente**, excluindo quaisquer valores que estariam lá apenas por serem os valores padrão. Para fazer isso, usamos `exclude_unset=True`. Este é o truque principal. 🪄
+
+Em seguida, usamos `hero_db.sqlmodel_update(hero_data)` para atualizar o `hero_db` com os dados de `hero_data`.
+
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[83:93] hl[83:84,88:89] *}
+
+### Deletar um Hero Novamente
+
+**Deletar** um hero permanece praticamente o mesmo.
+
+Não vamos satisfazer o desejo de refatorar tudo neste aqui. 😅
+
+{* ../../docs_src/sql_databases/tutorial002_an_py310.py ln[96:103] hl[101] *}
+
+### Executar o App Novamente
+
+Você pode executar o app novamente:
+
+<div class="termy">
+
+```console
+$ fastapi dev main.py
+
+<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+</div>
+
+If you go to the `/docs` API UI, you will see that it is now updated, and it won't expect to receive the `id` from the client when creating a hero, etc.
+
+<div class="screenshot">
+<img src="/img/tutorial/sql-databases/image02.png">
+</div>
+
+## Recapitulando
+
+Você pode usar <a href="https://sqlmodel.tiangolo.com/" class="external-link" target="_blank">**SQLModel**</a> para interagir com um banco de dados SQL e simplificar o código com *modelos de dados* e *modelos de tabela*.
+
+Você pode aprender muito mais na documentação do **SQLModel**, há um mini <a href="https://sqlmodel.tiangolo.com/tutorial/fastapi/" class="external-link" target="_blank">tutorial sobre como usar SQLModel com **FastAPI**</a> mais longo. 🚀
From b87eb8a0e1698e5fdb59d13de8aa091d7a1b9f69 Mon Sep 17 00:00:00 2001
From: Nimitha J <58389915+Nimitha-jagadeesha@users.noreply.github.com>
Date: Sun, 27 Oct 2024 20:55:54 +0530
Subject: [PATCH 255/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/de/docs/advanced/security/http-basic-auth.md`=20(#1256?=
=?UTF-8?q?1)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../docs/advanced/security/http-basic-auth.md | 91 +------------------
1 file changed, 3 insertions(+), 88 deletions(-)
diff --git a/docs/de/docs/advanced/security/http-basic-auth.md b/docs/de/docs/advanced/security/http-basic-auth.md
index 4e607e6a1..36498c01d 100644
--- a/docs/de/docs/advanced/security/http-basic-auth.md
+++ b/docs/de/docs/advanced/security/http-basic-auth.md
@@ -20,36 +20,7 @@ Wenn Sie dann den Benutzernamen und das Passwort eingeben, sendet der Browser di
* Diese gibt ein Objekt vom Typ `HTTPBasicCredentials` zurück:
* Es enthält den gesendeten `username` und das gesendete `password`.
-//// tab | Python 3.9+
-
-```Python hl_lines="4 8 12"
-{!> ../../docs_src/security/tutorial006_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="2 7 11"
-{!> ../../docs_src/security/tutorial006_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="2 6 10"
-{!> ../../docs_src/security/tutorial006.py!}
-```
-
-////
-
+{* ../../docs_src/security/tutorial006_an_py39.py hl[4,8,12] *}
Wenn Sie versuchen, die URL zum ersten Mal zu öffnen (oder in der Dokumentation auf den Button „Execute“ zu klicken), wird der Browser Sie nach Ihrem Benutzernamen und Passwort fragen:
<img src="/img/tutorial/security/image12.png">
@@ -68,35 +39,7 @@ Um dies zu lösen, konvertieren wir zunächst den `username` und das `password`
Dann können wir `secrets.compare_digest()` verwenden, um sicherzustellen, dass `credentials.username` `"stanleyjobson"` und `credentials.password` `"swordfish"` ist.
-//// tab | Python 3.9+
-
-```Python hl_lines="1 12-24"
-{!> ../../docs_src/security/tutorial007_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="1 12-24"
-{!> ../../docs_src/security/tutorial007_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="1 11-21"
-{!> ../../docs_src/security/tutorial007.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial007_an_py39.py hl[1,12:24] *}
Dies wäre das gleiche wie:
@@ -160,32 +103,4 @@ So ist Ihr Anwendungscode, dank der Verwendung von `secrets.compare_digest()`, v
Nachdem Sie festgestellt haben, dass die Anmeldeinformationen falsch sind, geben Sie eine `HTTPException` mit dem Statuscode 401 zurück (derselbe, der auch zurückgegeben wird, wenn keine Anmeldeinformationen angegeben werden) und fügen den Header `WWW-Authenticate` hinzu, damit der Browser die Anmeldeaufforderung erneut anzeigt:
-//// tab | Python 3.9+
-
-```Python hl_lines="26-30"
-{!> ../../docs_src/security/tutorial007_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="26-30"
-{!> ../../docs_src/security/tutorial007_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="23-27"
-{!> ../../docs_src/security/tutorial007.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial007_an_py39.py hl[26:30] *}
From 909204ec5452e9f2f9fe542802386c9b8802efc2 Mon Sep 17 00:00:00 2001
From: Alexandros Mioglou <asmioglou@gmail.com>
Date: Sun, 27 Oct 2024 17:28:18 +0200
Subject: [PATCH 256/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/pt/docs/advanced/behind-a-proxy.md`=20(#12563)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/advanced/behind-a-proxy.md | 20 +++++---------------
1 file changed, 5 insertions(+), 15 deletions(-)
diff --git a/docs/pt/docs/advanced/behind-a-proxy.md b/docs/pt/docs/advanced/behind-a-proxy.md
index 3c65b5a0a..12fd83f3d 100644
--- a/docs/pt/docs/advanced/behind-a-proxy.md
+++ b/docs/pt/docs/advanced/behind-a-proxy.md
@@ -18,9 +18,7 @@ Nesse caso, o caminho original `/app` seria servido em `/api/v1/app`.
Embora todo o seu código esteja escrito assumindo que existe apenas `/app`.
-```Python hl_lines="6"
-{!../../docs_src/behind_a_proxy/tutorial001.py!}
-```
+{* ../../docs_src/behind_a_proxy/tutorial001.py hl[6] *}
E o proxy estaria **"removendo"** o **prefixo do caminho** dinamicamente antes de transmitir a solicitação para o servidor da aplicação (provavelmente Uvicorn via CLI do FastAPI), mantendo sua aplicação convencida de que está sendo servida em `/app`, para que você não precise atualizar todo o seu código para incluir o prefixo `/api/v1`.
@@ -98,9 +96,7 @@ Você pode obter o `root_path` atual usado pela sua aplicação para cada solici
Aqui estamos incluindo ele na mensagem apenas para fins de demonstração.
-```Python hl_lines="8"
-{!../../docs_src/behind_a_proxy/tutorial001.py!}
-```
+{* ../../docs_src/behind_a_proxy/tutorial001.py hl[8] *}
Então, se você iniciar o Uvicorn com:
@@ -127,9 +123,7 @@ A resposta seria algo como:
Alternativamente, se você não tiver uma maneira de fornecer uma opção de linha de comando como `--root-path` ou equivalente, você pode definir o parâmetro `--root-path` ao criar sua aplicação FastAPI:
-```Python hl_lines="3"
-{!../../docs_src/behind_a_proxy/tutorial002.py!}
-```
+{* ../../docs_src/behind_a_proxy/tutorial002.py hl[3] *}
Passar o `root_path`h para `FastAPI` seria o equivalente a passar a opção de linha de comando `--root-path` para Uvicorn ou Hypercorn.
@@ -309,9 +303,7 @@ Se você passar uma lista personalizada de `servers` e houver um `root_path` (po
Por exemplo:
-```Python hl_lines="4-7"
-{!../../docs_src/behind_a_proxy/tutorial003.py!}
-```
+{* ../../docs_src/behind_a_proxy/tutorial003.py hl[4:7] *}
Gerará um OpenAPI schema como:
@@ -358,9 +350,7 @@ A interface de documentação interagirá com o servidor que você selecionar.
Se você não quiser que o **FastAPI** inclua um servidor automático usando o `root_path`, você pode usar o parâmetro `root_path_in_servers=False`:
-```Python hl_lines="9"
-{!../../docs_src/behind_a_proxy/tutorial004.py!}
-```
+{* ../../docs_src/behind_a_proxy/tutorial004.py hl[9] *}
e então ele não será incluído no OpenAPI schema.
From e00efb55691fd3d2b5c8f7759ff72329291e161f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 15:29:12 +0000
Subject: [PATCH 257/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e27571ea0..0e8328b86 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -25,6 +25,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/sql-databases.md`. PR [#12530](https://github.com/fastapi/fastapi/pull/12530) by [@ilacftemp](https://github.com/ilacftemp).
* 🌐 Add Korean translation for `docs/ko/docs/benchmarks.md`. PR [#12540](https://github.com/fastapi/fastapi/pull/12540) by [@Limsunoh](https://github.com/Limsunoh).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/separate-openapi-schemas.md`. PR [#12518](https://github.com/fastapi/fastapi/pull/12518) by [@ilacftemp](https://github.com/ilacftemp).
* 🌐 Update Traditional Chinese translation for `docs/zh-hant/docs/deployment/index.md`. PR [#12521](https://github.com/fastapi/fastapi/pull/12521) by [@codingjenny](https://github.com/codingjenny).
From 91eb00854bf71c62eaa320971cd97a1305831dfb Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 15:30:02 +0000
Subject: [PATCH 258/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 0e8328b86..d4486a2db 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/de/docs/advanced/security/http-basic-auth.md`. PR [#12561](https://github.com/fastapi/fastapi/pull/12561) by [@Nimitha-jagadeesha](https://github.com/Nimitha-jagadeesha).
* 📝 Update includes in `docs/en/docs/tutorial/background-tasks.md`. PR [#12559](https://github.com/fastapi/fastapi/pull/12559) by [@FarhanAliRaza](https://github.com/FarhanAliRaza).
* 📝 Update includes in `docs/fr/docs/python-types.md`. PR [#12558](https://github.com/fastapi/fastapi/pull/12558) by [@Ismailtlem](https://github.com/Ismailtlem).
* 📝 Update includes in `docs/en/docs/how-to/graphql.md`. PR [#12564](https://github.com/fastapi/fastapi/pull/12564) by [@philipokiokio](https://github.com/philipokiokio).
From 48f88edf0dc5ffa22829966e0640a57cd192aac2 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 15:33:12 +0000
Subject: [PATCH 259/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d4486a2db..cb005d696 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/pt/docs/advanced/behind-a-proxy.md`. PR [#12563](https://github.com/fastapi/fastapi/pull/12563) by [@asmioglou](https://github.com/asmioglou).
* 📝 Update includes in `docs/de/docs/advanced/security/http-basic-auth.md`. PR [#12561](https://github.com/fastapi/fastapi/pull/12561) by [@Nimitha-jagadeesha](https://github.com/Nimitha-jagadeesha).
* 📝 Update includes in `docs/en/docs/tutorial/background-tasks.md`. PR [#12559](https://github.com/fastapi/fastapi/pull/12559) by [@FarhanAliRaza](https://github.com/FarhanAliRaza).
* 📝 Update includes in `docs/fr/docs/python-types.md`. PR [#12558](https://github.com/fastapi/fastapi/pull/12558) by [@Ismailtlem](https://github.com/Ismailtlem).
From 27e7fcefe858024a3b47c07fdfae916a228b6615 Mon Sep 17 00:00:00 2001
From: Julio Anthony Leonard <JulioAnthonyLeonard@gmail.com>
Date: Sun, 27 Oct 2024 16:34:47 +0100
Subject: [PATCH 260/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/de/docs/advanced/async-tests.md`=20(#12567)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/de/docs/advanced/async-tests.md | 8 ++------
1 file changed, 2 insertions(+), 6 deletions(-)
diff --git a/docs/de/docs/advanced/async-tests.md b/docs/de/docs/advanced/async-tests.md
index 93ff84b8a..6c1981e25 100644
--- a/docs/de/docs/advanced/async-tests.md
+++ b/docs/de/docs/advanced/async-tests.md
@@ -60,9 +60,7 @@ $ pytest
Der Marker `@pytest.mark.anyio` teilt pytest mit, dass diese Testfunktion asynchron aufgerufen werden soll:
-```Python hl_lines="7"
-{!../../docs_src/async_tests/test_main.py!}
-```
+{* ../../docs_src/async_tests/test_main.py hl[7] *}
/// tip | "Tipp"
@@ -72,9 +70,7 @@ Beachten Sie, dass die Testfunktion jetzt `async def` ist und nicht nur `def` wi
Dann können wir einen `AsyncClient` mit der App erstellen und mit `await` asynchrone Requests an ihn senden.
-```Python hl_lines="9-12"
-{!../../docs_src/async_tests/test_main.py!}
-```
+{* ../../docs_src/async_tests/test_main.py hl[9:12] *}
Das ist das Äquivalent zu:
From 4b9e76bde26bec5a7b783b4d0043b2fc0d6ebfe0 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 15:39:25 +0000
Subject: [PATCH 261/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index cb005d696..cd35be4d5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 📝 Update includes in `docs/de/docs/advanced/async-tests.md`. PR [#12567](https://github.com/fastapi/fastapi/pull/12567) by [@imjuanleonard](https://github.com/imjuanleonard).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/sql-databases.md`. PR [#12530](https://github.com/fastapi/fastapi/pull/12530) by [@ilacftemp](https://github.com/ilacftemp).
* 🌐 Add Korean translation for `docs/ko/docs/benchmarks.md`. PR [#12540](https://github.com/fastapi/fastapi/pull/12540) by [@Limsunoh](https://github.com/Limsunoh).
* 🌐 Add Portuguese translation for `docs/pt/docs/how-to/separate-openapi-schemas.md`. PR [#12518](https://github.com/fastapi/fastapi/pull/12518) by [@ilacftemp](https://github.com/ilacftemp).
From dfdecfd9c93e8cfb07e46709e5a6966ff9c36bdc Mon Sep 17 00:00:00 2001
From: Krishna Madhavan <krishnamadhavan07@gmail.com>
Date: Sun, 27 Oct 2024 21:13:29 +0530
Subject: [PATCH 262/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/async-tests.md`=20(#12568)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/async-tests.md | 16 ++++------------
1 file changed, 4 insertions(+), 12 deletions(-)
diff --git a/docs/en/docs/advanced/async-tests.md b/docs/en/docs/advanced/async-tests.md
index 232cd6e57..8d6929222 100644
--- a/docs/en/docs/advanced/async-tests.md
+++ b/docs/en/docs/advanced/async-tests.md
@@ -32,15 +32,11 @@ For a simple example, let's consider a file structure similar to the one describ
The file `main.py` would have:
-```Python
-{!../../docs_src/async_tests/main.py!}
-```
+{* ../../docs_src/async_tests/main.py *}
The file `test_main.py` would have the tests for `main.py`, it could look like this now:
-```Python
-{!../../docs_src/async_tests/test_main.py!}
-```
+{* ../../docs_src/async_tests/test_main.py *}
## Run it
@@ -60,9 +56,7 @@ $ pytest
The marker `@pytest.mark.anyio` tells pytest that this test function should be called asynchronously:
-```Python hl_lines="7"
-{!../../docs_src/async_tests/test_main.py!}
-```
+{* ../../docs_src/async_tests/test_main.py hl[7] *}
/// tip
@@ -72,9 +66,7 @@ Note that the test function is now `async def` instead of just `def` as before w
Then we can create an `AsyncClient` with the app, and send async requests to it, using `await`.
-```Python hl_lines="9-12"
-{!../../docs_src/async_tests/test_main.py!}
-```
+{* ../../docs_src/async_tests/test_main.py hl[9:12] *}
This is the equivalent to:
From b24b4fd6a810dad86c470e072e0603ebc0f223f4 Mon Sep 17 00:00:00 2001
From: Nomad Monad <38782977+lucaromagnoli@users.noreply.github.com>
Date: Sun, 27 Oct 2024 15:45:40 +0000
Subject: [PATCH 263/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/static-files.md`=20(#12575)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/static-files.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
diff --git a/docs/en/docs/tutorial/static-files.md b/docs/en/docs/tutorial/static-files.md
index 2e93bd60b..46affd4f2 100644
--- a/docs/en/docs/tutorial/static-files.md
+++ b/docs/en/docs/tutorial/static-files.md
@@ -7,9 +7,7 @@ You can serve static files automatically from a directory using `StaticFiles`.
* Import `StaticFiles`.
* "Mount" a `StaticFiles()` instance in a specific path.
-```Python hl_lines="2 6"
-{!../../docs_src/static_files/tutorial001.py!}
-```
+{* ../../docs_src/static_files/tutorial001.py hl[2,6] *}
/// note | "Technical Details"
From ed45eca1a886791ccfa0f32c7a7805ad4a78c826 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 15:50:02 +0000
Subject: [PATCH 264/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index cd35be4d5..793f34b99 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/async-tests.md`. PR [#12568](https://github.com/fastapi/fastapi/pull/12568) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes in `docs/pt/docs/advanced/behind-a-proxy.md`. PR [#12563](https://github.com/fastapi/fastapi/pull/12563) by [@asmioglou](https://github.com/asmioglou).
* 📝 Update includes in `docs/de/docs/advanced/security/http-basic-auth.md`. PR [#12561](https://github.com/fastapi/fastapi/pull/12561) by [@Nimitha-jagadeesha](https://github.com/Nimitha-jagadeesha).
* 📝 Update includes in `docs/en/docs/tutorial/background-tasks.md`. PR [#12559](https://github.com/fastapi/fastapi/pull/12559) by [@FarhanAliRaza](https://github.com/FarhanAliRaza).
From 55aa76faad5834b017282ed0e44b60f0ee61e184 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 15:51:51 +0000
Subject: [PATCH 265/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 793f34b99..95e5b5f18 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/static-files.md`. PR [#12575](https://github.com/fastapi/fastapi/pull/12575) by [@lucaromagnoli](https://github.com/lucaromagnoli).
* 📝 Update includes in `docs/en/docs/advanced/async-tests.md`. PR [#12568](https://github.com/fastapi/fastapi/pull/12568) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes in `docs/pt/docs/advanced/behind-a-proxy.md`. PR [#12563](https://github.com/fastapi/fastapi/pull/12563) by [@asmioglou](https://github.com/asmioglou).
* 📝 Update includes in `docs/de/docs/advanced/security/http-basic-auth.md`. PR [#12561](https://github.com/fastapi/fastapi/pull/12561) by [@Nimitha-jagadeesha](https://github.com/Nimitha-jagadeesha).
From 0f8d03ef854a3e57bf7beba8f7a2bacd1926919d Mon Sep 17 00:00:00 2001
From: Krishna Madhavan <krishnamadhavan07@gmail.com>
Date: Sun, 27 Oct 2024 21:37:07 +0530
Subject: [PATCH 266/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/additional-responses.md`=20(#12576)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/additional-responses.md | 16 ++++------------
1 file changed, 4 insertions(+), 12 deletions(-)
diff --git a/docs/en/docs/advanced/additional-responses.md b/docs/en/docs/advanced/additional-responses.md
index c038096f9..03d48c2a7 100644
--- a/docs/en/docs/advanced/additional-responses.md
+++ b/docs/en/docs/advanced/additional-responses.md
@@ -26,9 +26,7 @@ Each of those response `dict`s can have a key `model`, containing a Pydantic mod
For example, to declare another response with a status code `404` and a Pydantic model `Message`, you can write:
-```Python hl_lines="18 22"
-{!../../docs_src/additional_responses/tutorial001.py!}
-```
+{* ../../docs_src/additional_responses/tutorial001.py hl[18,22] *}
/// note
@@ -177,9 +175,7 @@ You can use this same `responses` parameter to add different media types for the
For example, you can add an additional media type of `image/png`, declaring that your *path operation* can return a JSON object (with media type `application/json`) or a PNG image:
-```Python hl_lines="19-24 28"
-{!../../docs_src/additional_responses/tutorial002.py!}
-```
+{* ../../docs_src/additional_responses/tutorial002.py hl[19:24,28] *}
/// note
@@ -207,9 +203,7 @@ For example, you can declare a response with a status code `404` that uses a Pyd
And a response with a status code `200` that uses your `response_model`, but includes a custom `example`:
-```Python hl_lines="20-31"
-{!../../docs_src/additional_responses/tutorial003.py!}
-```
+{* ../../docs_src/additional_responses/tutorial003.py hl[20:31] *}
It will all be combined and included in your OpenAPI, and shown in the API docs:
@@ -243,9 +237,7 @@ You can use that technique to reuse some predefined responses in your *path oper
For example:
-```Python hl_lines="13-17 26"
-{!../../docs_src/additional_responses/tutorial004.py!}
-```
+{* ../../docs_src/additional_responses/tutorial004.py hl[13:17,26] *}
## More information about OpenAPI responses
From dc22bdf5a4ba019543eaba0b00cf3a037f6bdb5c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 16:08:49 +0000
Subject: [PATCH 267/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 95e5b5f18..c4c7f98af 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/additional-responses.md`. PR [#12576](https://github.com/fastapi/fastapi/pull/12576) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes in `docs/en/docs/tutorial/static-files.md`. PR [#12575](https://github.com/fastapi/fastapi/pull/12575) by [@lucaromagnoli](https://github.com/lucaromagnoli).
* 📝 Update includes in `docs/en/docs/advanced/async-tests.md`. PR [#12568](https://github.com/fastapi/fastapi/pull/12568) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes in `docs/pt/docs/advanced/behind-a-proxy.md`. PR [#12563](https://github.com/fastapi/fastapi/pull/12563) by [@asmioglou](https://github.com/asmioglou).
From 9106cae8a8cc0c46069cf2885f1bce9fdc200ee2 Mon Sep 17 00:00:00 2001
From: Krishna Madhavan <krishnamadhavan07@gmail.com>
Date: Sun, 27 Oct 2024 21:40:15 +0530
Subject: [PATCH 268/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/advanced-dependencies.md`=20(#12578)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../en/docs/advanced/advanced-dependencies.md | 120 +-----------------
1 file changed, 4 insertions(+), 116 deletions(-)
diff --git a/docs/en/docs/advanced/advanced-dependencies.md b/docs/en/docs/advanced/advanced-dependencies.md
index b15a4fe3d..f933fd264 100644
--- a/docs/en/docs/advanced/advanced-dependencies.md
+++ b/docs/en/docs/advanced/advanced-dependencies.md
@@ -18,35 +18,7 @@ Not the class itself (which is already a callable), but an instance of that clas
To do that, we declare a method `__call__`:
-//// tab | Python 3.9+
-
-```Python hl_lines="12"
-{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="11"
-{!> ../../docs_src/dependencies/tutorial011_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="10"
-{!> ../../docs_src/dependencies/tutorial011.py!}
-```
-
-////
+{* ../../docs_src/dependencies/tutorial011_an_py39.py hl[12] *}
In this case, this `__call__` is what **FastAPI** will use to check for additional parameters and sub-dependencies, and this is what will be called to pass a value to the parameter in your *path operation function* later.
@@ -54,35 +26,7 @@ In this case, this `__call__` is what **FastAPI** will use to check for addition
And now, we can use `__init__` to declare the parameters of the instance that we can use to "parameterize" the dependency:
-//// tab | Python 3.9+
-
-```Python hl_lines="9"
-{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="8"
-{!> ../../docs_src/dependencies/tutorial011_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="7"
-{!> ../../docs_src/dependencies/tutorial011.py!}
-```
-
-////
+{* ../../docs_src/dependencies/tutorial011_an_py39.py hl[9] *}
In this case, **FastAPI** won't ever touch or care about `__init__`, we will use it directly in our code.
@@ -90,35 +34,7 @@ In this case, **FastAPI** won't ever touch or care about `__init__`, we will use
We could create an instance of this class with:
-//// tab | Python 3.9+
-
-```Python hl_lines="18"
-{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="17"
-{!> ../../docs_src/dependencies/tutorial011_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="16"
-{!> ../../docs_src/dependencies/tutorial011.py!}
-```
-
-////
+{* ../../docs_src/dependencies/tutorial011_an_py39.py hl[18] *}
And that way we are able to "parameterize" our dependency, that now has `"bar"` inside of it, as the attribute `checker.fixed_content`.
@@ -134,35 +50,7 @@ checker(q="somequery")
...and pass whatever that returns as the value of the dependency in our *path operation function* as the parameter `fixed_content_included`:
-//// tab | Python 3.9+
-
-```Python hl_lines="22"
-{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="21"
-{!> ../../docs_src/dependencies/tutorial011_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="20"
-{!> ../../docs_src/dependencies/tutorial011.py!}
-```
-
-////
+{* ../../docs_src/dependencies/tutorial011_an_py39.py hl[22] *}
/// tip
From dc7cf0f14f1059082310995b2369e5e2a4d8cf1b Mon Sep 17 00:00:00 2001
From: Krishna Madhavan <krishnamadhavan07@gmail.com>
Date: Sun, 27 Oct 2024 21:42:23 +0530
Subject: [PATCH 269/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/additional-status-codes.md`=20(#12577?=
=?UTF-8?q?)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../docs/advanced/additional-status-codes.md | 52 +------------------
1 file changed, 1 insertion(+), 51 deletions(-)
diff --git a/docs/en/docs/advanced/additional-status-codes.md b/docs/en/docs/advanced/additional-status-codes.md
index 6105a301c..e39249467 100644
--- a/docs/en/docs/advanced/additional-status-codes.md
+++ b/docs/en/docs/advanced/additional-status-codes.md
@@ -14,57 +14,7 @@ But you also want it to accept new items. And when the items didn't exist before
To achieve that, import `JSONResponse`, and return your content there directly, setting the `status_code` that you want:
-//// tab | Python 3.10+
-
-```Python hl_lines="4 25"
-{!> ../../docs_src/additional_status_codes/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="4 25"
-{!> ../../docs_src/additional_status_codes/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="4 26"
-{!> ../../docs_src/additional_status_codes/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="2 23"
-{!> ../../docs_src/additional_status_codes/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="4 25"
-{!> ../../docs_src/additional_status_codes/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/additional_status_codes/tutorial001_an_py310.py hl[4,25] *}
/// warning
From fe60afff0e043d78c3dc686c2d91efdceaf590cb Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 16:13:50 +0000
Subject: [PATCH 270/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c4c7f98af..492003f3d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/advanced-dependencies.md`. PR [#12578](https://github.com/fastapi/fastapi/pull/12578) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes in `docs/en/docs/advanced/additional-responses.md`. PR [#12576](https://github.com/fastapi/fastapi/pull/12576) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes in `docs/en/docs/tutorial/static-files.md`. PR [#12575](https://github.com/fastapi/fastapi/pull/12575) by [@lucaromagnoli](https://github.com/lucaromagnoli).
* 📝 Update includes in `docs/en/docs/advanced/async-tests.md`. PR [#12568](https://github.com/fastapi/fastapi/pull/12568) by [@krishnamadhavan](https://github.com/krishnamadhavan).
From f5a10c1c7d666013520a4300fae5bb3af4e4769f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 16:17:51 +0000
Subject: [PATCH 271/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 492003f3d..27d870468 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/additional-status-codes.md`. PR [#12577](https://github.com/fastapi/fastapi/pull/12577) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes in `docs/en/docs/advanced/advanced-dependencies.md`. PR [#12578](https://github.com/fastapi/fastapi/pull/12578) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes in `docs/en/docs/advanced/additional-responses.md`. PR [#12576](https://github.com/fastapi/fastapi/pull/12576) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes in `docs/en/docs/tutorial/static-files.md`. PR [#12575](https://github.com/fastapi/fastapi/pull/12575) by [@lucaromagnoli](https://github.com/lucaromagnoli).
From 5d99a42688ab50053db42e89c021cf604cf7f83c Mon Sep 17 00:00:00 2001
From: Graziano Montanaro <40232320+montanarograziano@users.noreply.github.com>
Date: Sun, 27 Oct 2024 17:45:50 +0100
Subject: [PATCH 272/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/middleware.md`=20(#12582)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/middleware.md | 12 +++---------
1 file changed, 3 insertions(+), 9 deletions(-)
diff --git a/docs/en/docs/advanced/middleware.md b/docs/en/docs/advanced/middleware.md
index 07deac716..3faf3fbf9 100644
--- a/docs/en/docs/advanced/middleware.md
+++ b/docs/en/docs/advanced/middleware.md
@@ -57,17 +57,13 @@ Enforces that all incoming requests must either be `https` or `wss`.
Any incoming request to `http` or `ws` will be redirected to the secure scheme instead.
-```Python hl_lines="2 6"
-{!../../docs_src/advanced_middleware/tutorial001.py!}
-```
+{* ../../docs_src/advanced_middleware/tutorial001.py hl[2,6] *}
## `TrustedHostMiddleware`
Enforces that all incoming requests have a correctly set `Host` header, in order to guard against HTTP Host Header attacks.
-```Python hl_lines="2 6-8"
-{!../../docs_src/advanced_middleware/tutorial002.py!}
-```
+{* ../../docs_src/advanced_middleware/tutorial002.py hl[2,6:8] *}
The following arguments are supported:
@@ -81,9 +77,7 @@ Handles GZip responses for any request that includes `"gzip"` in the `Accept-Enc
The middleware will handle both standard and streaming responses.
-```Python hl_lines="2 6"
-{!../../docs_src/advanced_middleware/tutorial003.py!}
-```
+{* ../../docs_src/advanced_middleware/tutorial003.py hl[2,6] *}
The following arguments are supported:
From 5b1963db4911b27d335c5c2e2944ad113173e44f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 16:46:14 +0000
Subject: [PATCH 273/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 27d870468..e2b3eff3d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/middleware.md`. PR [#12582](https://github.com/fastapi/fastapi/pull/12582) by [@montanarograziano](https://github.com/montanarograziano).
* 📝 Update includes in `docs/en/docs/advanced/additional-status-codes.md`. PR [#12577](https://github.com/fastapi/fastapi/pull/12577) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes in `docs/en/docs/advanced/advanced-dependencies.md`. PR [#12578](https://github.com/fastapi/fastapi/pull/12578) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes in `docs/en/docs/advanced/additional-responses.md`. PR [#12576](https://github.com/fastapi/fastapi/pull/12576) by [@krishnamadhavan](https://github.com/krishnamadhavan).
From f0ad433e01cd074eb2e9575df59ea0eac15dedfb Mon Sep 17 00:00:00 2001
From: Julio Anthony Leonard <JulioAnthonyLeonard@gmail.com>
Date: Sun, 27 Oct 2024 17:49:49 +0100
Subject: [PATCH 274/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/behind-a-proxy.md`=20(#12583)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/behind-a-proxy.md | 20 +++++---------------
1 file changed, 5 insertions(+), 15 deletions(-)
diff --git a/docs/en/docs/advanced/behind-a-proxy.md b/docs/en/docs/advanced/behind-a-proxy.md
index 67718a27b..87a62e88b 100644
--- a/docs/en/docs/advanced/behind-a-proxy.md
+++ b/docs/en/docs/advanced/behind-a-proxy.md
@@ -18,9 +18,7 @@ In this case, the original path `/app` would actually be served at `/api/v1/app`
Even though all your code is written assuming there's just `/app`.
-```Python hl_lines="6"
-{!../../docs_src/behind_a_proxy/tutorial001.py!}
-```
+{* ../../docs_src/behind_a_proxy/tutorial001.py hl[6] *}
And the proxy would be **"stripping"** the **path prefix** on the fly before transmitting the request to the app server (probably Uvicorn via FastAPI CLI), keeping your application convinced that it is being served at `/app`, so that you don't have to update all your code to include the prefix `/api/v1`.
@@ -98,9 +96,7 @@ You can get the current `root_path` used by your application for each request, i
Here we are including it in the message just for demonstration purposes.
-```Python hl_lines="8"
-{!../../docs_src/behind_a_proxy/tutorial001.py!}
-```
+{* ../../docs_src/behind_a_proxy/tutorial001.py hl[8] *}
Then, if you start Uvicorn with:
@@ -127,9 +123,7 @@ The response would be something like:
Alternatively, if you don't have a way to provide a command line option like `--root-path` or equivalent, you can set the `root_path` parameter when creating your FastAPI app:
-```Python hl_lines="3"
-{!../../docs_src/behind_a_proxy/tutorial002.py!}
-```
+{* ../../docs_src/behind_a_proxy/tutorial002.py hl[3] *}
Passing the `root_path` to `FastAPI` would be the equivalent of passing the `--root-path` command line option to Uvicorn or Hypercorn.
@@ -309,9 +303,7 @@ If you pass a custom list of `servers` and there's a `root_path` (because your A
For example:
-```Python hl_lines="4-7"
-{!../../docs_src/behind_a_proxy/tutorial003.py!}
-```
+{* ../../docs_src/behind_a_proxy/tutorial003.py hl[4:7] *}
Will generate an OpenAPI schema like:
@@ -358,9 +350,7 @@ The docs UI will interact with the server that you select.
If you don't want **FastAPI** to include an automatic server using the `root_path`, you can use the parameter `root_path_in_servers=False`:
-```Python hl_lines="9"
-{!../../docs_src/behind_a_proxy/tutorial004.py!}
-```
+{* ../../docs_src/behind_a_proxy/tutorial004.py hl[9] *}
and then it won't include it in the OpenAPI schema.
From 3783341eb8b900899ca3ec09f100c8fe4e719f8a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebastian=20Koz=C5=82owski?=
<82809231+sebkozlo@users.noreply.github.com>
Date: Sun, 27 Oct 2024 17:51:30 +0100
Subject: [PATCH 275/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20synt?=
=?UTF-8?q?ax=20for=20`docs/pl/docs/tutorial/first-steps.md`=20(#12584)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pl/docs/tutorial/first-steps.md | 32 +++++++---------------------
1 file changed, 8 insertions(+), 24 deletions(-)
diff --git a/docs/pl/docs/tutorial/first-steps.md b/docs/pl/docs/tutorial/first-steps.md
index 99c425f12..9466ca84d 100644
--- a/docs/pl/docs/tutorial/first-steps.md
+++ b/docs/pl/docs/tutorial/first-steps.md
@@ -2,9 +2,7 @@
Najprostszy plik FastAPI może wyglądać tak:
-```Python
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py *}
Skopiuj to do pliku `main.py`.
@@ -133,9 +131,7 @@ Możesz go również użyć do automatycznego generowania kodu dla klientów, kt
### Krok 1: zaimportuj `FastAPI`
-```Python hl_lines="1"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[1] *}
`FastAPI` jest klasą, która zapewnia wszystkie funkcjonalności Twojego API.
@@ -149,9 +145,7 @@ Oznacza to, że możesz korzystać ze wszystkich funkcjonalności <a href="https
### Krok 2: utwórz instancję `FastAPI`
-```Python hl_lines="3"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{*../../docs_src/first_steps/tutorial001.py hl[3] *}
Zmienna `app` będzie tutaj "instancją" klasy `FastAPI`.
@@ -171,9 +165,7 @@ $ uvicorn main:app --reload
Jeśli stworzysz swoją aplikację, np.:
-```Python hl_lines="3"
-{!../../docs_src/first_steps/tutorial002.py!}
-```
+{* ../../docs_src/first_steps/tutorial002.py hl[3] *}
I umieścisz to w pliku `main.py`, to będziesz mógł tak wywołać `uvicorn`:
@@ -250,9 +242,7 @@ Będziemy je również nazywali "**operacjami**".
#### Zdefiniuj *dekorator operacji na ścieżce*
-```Python hl_lines="6"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[6] *}
`@app.get("/")` mówi **FastAPI** że funkcja poniżej odpowiada za obsługę żądań, które trafiają do:
@@ -306,9 +296,7 @@ To jest nasza "**funkcja obsługująca ścieżkę**":
* **operacja**: to `get`.
* **funkcja**: to funkcja poniżej "dekoratora" (poniżej `@app.get("/")`).
-```Python hl_lines="7"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[7] *}
Jest to funkcja Python.
@@ -320,9 +308,7 @@ W tym przypadku jest to funkcja "asynchroniczna".
Możesz również zdefiniować to jako normalną funkcję zamiast `async def`:
-```Python hl_lines="7"
-{!../../docs_src/first_steps/tutorial003.py!}
-```
+{* ../../docs_src/first_steps/tutorial003.py hl[7] *}
/// note
@@ -332,9 +318,7 @@ Jeśli nie znasz różnicy, sprawdź [Async: *"In a hurry?"*](../async.md#in-a-h
### Krok 5: zwróć zawartość
-```Python hl_lines="8"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[8] *}
Możesz zwrócić `dict`, `list`, pojedynczą wartość jako `str`, `int`, itp.
From 083fbc8a736956b1e66d6fb6a7fbd238bfce7c90 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 16:52:28 +0000
Subject: [PATCH 276/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e2b3eff3d..7052d97b0 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes syntax for `docs/pl/docs/tutorial/first-steps.md`. PR [#12584](https://github.com/fastapi/fastapi/pull/12584) by [@sebkozlo](https://github.com/sebkozlo).
* 📝 Update includes in `docs/en/docs/advanced/middleware.md`. PR [#12582](https://github.com/fastapi/fastapi/pull/12582) by [@montanarograziano](https://github.com/montanarograziano).
* 📝 Update includes in `docs/en/docs/advanced/additional-status-codes.md`. PR [#12577](https://github.com/fastapi/fastapi/pull/12577) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes in `docs/en/docs/advanced/advanced-dependencies.md`. PR [#12578](https://github.com/fastapi/fastapi/pull/12578) by [@krishnamadhavan](https://github.com/krishnamadhavan).
From 75af54babd74ae99d3ecfdc012ef005a940e3727 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 16:52:29 +0000
Subject: [PATCH 277/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 7052d97b0..72febff86 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/behind-a-proxy.md`. PR [#12583](https://github.com/fastapi/fastapi/pull/12583) by [@imjuanleonard](https://github.com/imjuanleonard).
* 📝 Update includes syntax for `docs/pl/docs/tutorial/first-steps.md`. PR [#12584](https://github.com/fastapi/fastapi/pull/12584) by [@sebkozlo](https://github.com/sebkozlo).
* 📝 Update includes in `docs/en/docs/advanced/middleware.md`. PR [#12582](https://github.com/fastapi/fastapi/pull/12582) by [@montanarograziano](https://github.com/montanarograziano).
* 📝 Update includes in `docs/en/docs/advanced/additional-status-codes.md`. PR [#12577](https://github.com/fastapi/fastapi/pull/12577) by [@krishnamadhavan](https://github.com/krishnamadhavan).
From 5a0e13794b5f5c1dd3180d9cdd42341fed4bb1c3 Mon Sep 17 00:00:00 2001
From: Nomad Monad <38782977+lucaromagnoli@users.noreply.github.com>
Date: Sun, 27 Oct 2024 16:58:19 +0000
Subject: [PATCH 278/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/body.md`=20(#12586)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/body.md | 92 ++---------------------------------
1 file changed, 5 insertions(+), 87 deletions(-)
diff --git a/docs/en/docs/tutorial/body.md b/docs/en/docs/tutorial/body.md
index 14d621418..9c97f64cb 100644
--- a/docs/en/docs/tutorial/body.md
+++ b/docs/en/docs/tutorial/body.md
@@ -22,21 +22,7 @@ As it is discouraged, the interactive docs with Swagger UI won't show the docume
First, you need to import `BaseModel` from `pydantic`:
-//// tab | Python 3.10+
-
-```Python hl_lines="2"
-{!> ../../docs_src/body/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="4"
-{!> ../../docs_src/body/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/body/tutorial001_py310.py hl[2] *}
## Create your data model
@@ -44,21 +30,8 @@ Then you declare your data model as a class that inherits from `BaseModel`.
Use standard Python types for all the attributes:
-//// tab | Python 3.10+
-
-```Python hl_lines="5-9"
-{!> ../../docs_src/body/tutorial001_py310.py!}
-```
-
-////
+{* ../../docs_src/body/tutorial001_py310.py hl[5:9] *}
-//// tab | Python 3.8+
-
-```Python hl_lines="7-11"
-{!> ../../docs_src/body/tutorial001.py!}
-```
-
-////
The same as when declaring query parameters, when a model attribute has a default value, it is not required. Otherwise, it is required. Use `None` to make it just optional.
@@ -86,21 +59,7 @@ For example, this model above declares a JSON "`object`" (or Python `dict`) like
To add it to your *path operation*, declare it the same way you declared path and query parameters:
-//// tab | Python 3.10+
-
-```Python hl_lines="16"
-{!> ../../docs_src/body/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="18"
-{!> ../../docs_src/body/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/body/tutorial001_py310.py hl[16] *}
...and declare its type as the model you created, `Item`.
@@ -167,21 +126,7 @@ It improves editor support for Pydantic models, with:
Inside of the function, you can access all the attributes of the model object directly:
-//// tab | Python 3.10+
-
-```Python hl_lines="19"
{!> ../../docs_src/body/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="21"
-{!> ../../docs_src/body/tutorial002.py!}
-```
-
-////
## Request body + path parameters
@@ -189,21 +134,8 @@ You can declare path parameters and request body at the same time.
**FastAPI** will recognize that the function parameters that match path parameters should be **taken from the path**, and that function parameters that are declared to be Pydantic models should be **taken from the request body**.
-//// tab | Python 3.10+
-
-```Python hl_lines="15-16"
-{!> ../../docs_src/body/tutorial003_py310.py!}
-```
-
-////
+{* ../../docs_src/body/tutorial003_py310.py hl[15:16] *}
-//// tab | Python 3.8+
-
-```Python hl_lines="17-18"
-{!> ../../docs_src/body/tutorial003.py!}
-```
-
-////
## Request body + path + query parameters
@@ -211,21 +143,7 @@ You can also declare **body**, **path** and **query** parameters, all at the sam
**FastAPI** will recognize each of them and take the data from the correct place.
-//// tab | Python 3.10+
-
-```Python hl_lines="16"
-{!> ../../docs_src/body/tutorial004_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="18"
-{!> ../../docs_src/body/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/body/tutorial004_py310.py hl[16] *}
The function parameters will be recognized as follows:
From 503ece76d6eabc2357b86a98455ebb8fbc83ff9d Mon Sep 17 00:00:00 2001
From: Alexander Bejarano <abhieud@yahoo.es>
Date: Sun, 27 Oct 2024 17:59:43 +0100
Subject: [PATCH 279/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/de/docs/tutorial/response-status-code.md`=20(#12585)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/de/docs/tutorial/response-status-code.md | 12 +++---------
1 file changed, 3 insertions(+), 9 deletions(-)
diff --git a/docs/de/docs/tutorial/response-status-code.md b/docs/de/docs/tutorial/response-status-code.md
index 872007a12..5f017355b 100644
--- a/docs/de/docs/tutorial/response-status-code.md
+++ b/docs/de/docs/tutorial/response-status-code.md
@@ -8,9 +8,7 @@ So wie ein Responsemodell, können Sie auch einen HTTP-Statuscode für die Respo
* `@app.delete()`
* usw.
-```Python hl_lines="6"
-{!../../docs_src/response_status_code/tutorial001.py!}
-```
+{* ../../docs_src/response_status_code/tutorial001.py hl[6] *}
/// note | "Hinweis"
@@ -76,9 +74,7 @@ Um mehr über Statuscodes zu lernen, und welcher wofür verwendet wird, lesen Si
Schauen wir uns das vorherige Beispiel noch einmal an:
-```Python hl_lines="6"
-{!../../docs_src/response_status_code/tutorial001.py!}
-```
+{* ../../docs_src/response_status_code/tutorial001.py hl[6] *}
`201` ist der Statuscode für „Created“ („Erzeugt“).
@@ -86,9 +82,7 @@ Aber Sie müssen sich nicht daran erinnern, welcher dieser Codes was bedeutet.
Sie können die Hilfsvariablen von `fastapi.status` verwenden.
-```Python hl_lines="1 6"
-{!../../docs_src/response_status_code/tutorial002.py!}
-```
+{* ../../docs_src/response_status_code/tutorial002.py hl[1,6] *}
Diese sind nur eine Annehmlichkeit und enthalten dieselbe Nummer, aber auf diese Weise können Sie die Autovervollständigung Ihres Editors verwenden, um sie zu finden:
From 47b4e1a517534d442a9e2983fc4d777a2d59d306 Mon Sep 17 00:00:00 2001
From: Nomad Monad <38782977+lucaromagnoli@users.noreply.github.com>
Date: Sun, 27 Oct 2024 17:01:18 +0000
Subject: [PATCH 280/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/tutorial/body-fields.md`=20(#12588)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/body-fields.md | 103 +--------------------------
1 file changed, 2 insertions(+), 101 deletions(-)
diff --git a/docs/en/docs/tutorial/body-fields.md b/docs/en/docs/tutorial/body-fields.md
index 30a5c623f..7f7e34fcc 100644
--- a/docs/en/docs/tutorial/body-fields.md
+++ b/docs/en/docs/tutorial/body-fields.md
@@ -6,57 +6,8 @@ The same way you can declare additional validation and metadata in *path operati
First, you have to import it:
-//// tab | Python 3.10+
+{* ../../docs_src/body_fields/tutorial001_an_py310.py hl[4] *}
-```Python hl_lines="4"
-{!> ../../docs_src/body_fields/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="4"
-{!> ../../docs_src/body_fields/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="4"
-{!> ../../docs_src/body_fields/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="2"
-{!> ../../docs_src/body_fields/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="4"
-{!> ../../docs_src/body_fields/tutorial001.py!}
-```
-
-////
/// warning
@@ -68,57 +19,7 @@ Notice that `Field` is imported directly from `pydantic`, not from `fastapi` as
You can then use `Field` with model attributes:
-//// tab | Python 3.10+
-
-```Python hl_lines="11-14"
-{!> ../../docs_src/body_fields/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="11-14"
-{!> ../../docs_src/body_fields/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="12-15"
-{!> ../../docs_src/body_fields/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9-12"
-{!> ../../docs_src/body_fields/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="11-14"
-{!> ../../docs_src/body_fields/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/body_fields/tutorial001_an_py310.py hl[11:14] *}
`Field` works the same way as `Query`, `Path` and `Body`, it has all the same parameters, etc.
From cd37dfe533c5409d6ec5b24476ec6b581421022f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 17:01:22 +0000
Subject: [PATCH 281/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 72febff86..9bee45856 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/body.md`. PR [#12586](https://github.com/fastapi/fastapi/pull/12586) by [@lucaromagnoli](https://github.com/lucaromagnoli).
* 📝 Update includes in `docs/en/docs/advanced/behind-a-proxy.md`. PR [#12583](https://github.com/fastapi/fastapi/pull/12583) by [@imjuanleonard](https://github.com/imjuanleonard).
* 📝 Update includes syntax for `docs/pl/docs/tutorial/first-steps.md`. PR [#12584](https://github.com/fastapi/fastapi/pull/12584) by [@sebkozlo](https://github.com/sebkozlo).
* 📝 Update includes in `docs/en/docs/advanced/middleware.md`. PR [#12582](https://github.com/fastapi/fastapi/pull/12582) by [@montanarograziano](https://github.com/montanarograziano).
From ba77d114f61719abf1610e800386c2818071577f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 17:02:19 +0000
Subject: [PATCH 282/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9bee45856..5482f88dc 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/de/docs/tutorial/response-status-code.md`. PR [#12585](https://github.com/fastapi/fastapi/pull/12585) by [@abejaranoh](https://github.com/abejaranoh).
* 📝 Update includes in `docs/en/docs/tutorial/body.md`. PR [#12586](https://github.com/fastapi/fastapi/pull/12586) by [@lucaromagnoli](https://github.com/lucaromagnoli).
* 📝 Update includes in `docs/en/docs/advanced/behind-a-proxy.md`. PR [#12583](https://github.com/fastapi/fastapi/pull/12583) by [@imjuanleonard](https://github.com/imjuanleonard).
* 📝 Update includes syntax for `docs/pl/docs/tutorial/first-steps.md`. PR [#12584](https://github.com/fastapi/fastapi/pull/12584) by [@sebkozlo](https://github.com/sebkozlo).
From 9f44a5dd369e5d9883f2071ab571dd4d4cfb0fc2 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 17:02:42 +0000
Subject: [PATCH 283/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 5482f88dc..56f12f331 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/tutorial/body-fields.md`. PR [#12588](https://github.com/fastapi/fastapi/pull/12588) by [@lucaromagnoli](https://github.com/lucaromagnoli).
* 📝 Update includes in `docs/de/docs/tutorial/response-status-code.md`. PR [#12585](https://github.com/fastapi/fastapi/pull/12585) by [@abejaranoh](https://github.com/abejaranoh).
* 📝 Update includes in `docs/en/docs/tutorial/body.md`. PR [#12586](https://github.com/fastapi/fastapi/pull/12586) by [@lucaromagnoli](https://github.com/lucaromagnoli).
* 📝 Update includes in `docs/en/docs/advanced/behind-a-proxy.md`. PR [#12583](https://github.com/fastapi/fastapi/pull/12583) by [@imjuanleonard](https://github.com/imjuanleonard).
From 5e8f1f96ebbaf0a7b9a06ef403d28c327caa746b Mon Sep 17 00:00:00 2001
From: Quentin Takeda <quentin.vadon@gmail.com>
Date: Sun, 27 Oct 2024 18:06:01 +0100
Subject: [PATCH 284/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/fr/docs/tutorial/query-params.md`=20(#12589)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/fr/docs/tutorial/query-params.md | 24 ++++++------------------
1 file changed, 6 insertions(+), 18 deletions(-)
diff --git a/docs/fr/docs/tutorial/query-params.md b/docs/fr/docs/tutorial/query-params.md
index c847a8f5b..798f84fa3 100644
--- a/docs/fr/docs/tutorial/query-params.md
+++ b/docs/fr/docs/tutorial/query-params.md
@@ -2,9 +2,7 @@
Quand vous déclarez des paramètres dans votre fonction de chemin qui ne font pas partie des paramètres indiqués dans le chemin associé, ces paramètres sont automatiquement considérés comme des paramètres de "requête".
-```Python hl_lines="9"
-{!../../docs_src/query_params/tutorial001.py!}
-```
+{* ../../docs_src/query_params/tutorial001.py hl[9] *}
La partie appelée requête (ou **query**) dans une URL est l'ensemble des paires clés-valeurs placées après le `?` , séparées par des `&`.
@@ -63,9 +61,7 @@ Les valeurs des paramètres de votre fonction seront :
De la même façon, vous pouvez définir des paramètres de requête comme optionnels, en leur donnant comme valeur par défaut `None` :
-```Python hl_lines="9"
-{!../../docs_src/query_params/tutorial002.py!}
-```
+{* ../../docs_src/query_params/tutorial002.py hl[9] *}
Ici, le paramètre `q` sera optionnel, et aura `None` comme valeur par défaut.
@@ -87,9 +83,7 @@ Le `Optional` dans `Optional[str]` n'est pas utilisé par **FastAPI** (**FastAPI
Vous pouvez aussi déclarer des paramètres de requête comme booléens (`bool`), **FastAPI** les convertira :
-```Python hl_lines="9"
-{!../../docs_src/query_params/tutorial003.py!}
-```
+{* ../../docs_src/query_params/tutorial003.py hl[9] *}
Avec ce code, en allant sur :
@@ -131,9 +125,7 @@ Et vous n'avez pas besoin de les déclarer dans un ordre spécifique.
Ils seront détectés par leurs noms :
-```Python hl_lines="8 10"
-{!../../docs_src/query_params/tutorial004.py!}
-```
+{* ../../docs_src/query_params/tutorial004.py hl[8,10] *}
## Paramètres de requête requis
@@ -143,9 +135,7 @@ Si vous ne voulez pas leur donner de valeur par défaut mais juste les rendre op
Mais si vous voulez rendre un paramètre de requête obligatoire, vous pouvez juste ne pas y affecter de valeur par défaut :
-```Python hl_lines="6-7"
-{!../../docs_src/query_params/tutorial005.py!}
-```
+{* ../../docs_src/query_params/tutorial005.py hl[6:7] *}
Ici le paramètre `needy` est un paramètre requis (ou obligatoire) de type `str`.
@@ -189,9 +179,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
Et bien sur, vous pouvez définir certains paramètres comme requis, certains avec des valeurs par défaut et certains entièrement optionnels :
-```Python hl_lines="10"
-{!../../docs_src/query_params/tutorial006.py!}
-```
+{* ../../docs_src/query_params/tutorial006.py hl[10] *}
Ici, on a donc 3 paramètres de requête :
From af269cd1317ea52522b23c80501b47917d3af0ac Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 17:09:22 +0000
Subject: [PATCH 285/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 56f12f331..45d334c1e 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/fr/docs/tutorial/query-params.md`. PR [#12589](https://github.com/fastapi/fastapi/pull/12589) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/tutorial/body-fields.md`. PR [#12588](https://github.com/fastapi/fastapi/pull/12588) by [@lucaromagnoli](https://github.com/lucaromagnoli).
* 📝 Update includes in `docs/de/docs/tutorial/response-status-code.md`. PR [#12585](https://github.com/fastapi/fastapi/pull/12585) by [@abejaranoh](https://github.com/abejaranoh).
* 📝 Update includes in `docs/en/docs/tutorial/body.md`. PR [#12586](https://github.com/fastapi/fastapi/pull/12586) by [@lucaromagnoli](https://github.com/lucaromagnoli).
From 453f559934362cd8372bb5fda0fe550572a2611e Mon Sep 17 00:00:00 2001
From: Quentin Takeda <quentin.vadon@gmail.com>
Date: Sun, 27 Oct 2024 18:14:38 +0100
Subject: [PATCH 286/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/fr/docs/tutorial/query-params-str-validations.md`=20(#?=
=?UTF-8?q?12591)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../tutorial/query-params-str-validations.md | 56 +++++--------------
1 file changed, 14 insertions(+), 42 deletions(-)
diff --git a/docs/fr/docs/tutorial/query-params-str-validations.md b/docs/fr/docs/tutorial/query-params-str-validations.md
index b71d1548a..a3cf76302 100644
--- a/docs/fr/docs/tutorial/query-params-str-validations.md
+++ b/docs/fr/docs/tutorial/query-params-str-validations.md
@@ -4,9 +4,7 @@
Commençons avec cette application pour exemple :
-```Python hl_lines="9"
-{!../../docs_src/query_params_str_validations/tutorial001.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial001.py hl[9] *}
Le paramètre de requête `q` a pour type `Union[str, None]` (ou `str | None` en Python 3.10), signifiant qu'il est de type `str` mais pourrait aussi être égal à `None`, et bien sûr, la valeur par défaut est `None`, donc **FastAPI** saura qu'il n'est pas requis.
@@ -26,17 +24,13 @@ Nous allons imposer que bien que `q` soit un paramètre optionnel, dès qu'il es
Pour cela, importez d'abord `Query` depuis `fastapi` :
-```Python hl_lines="3"
-{!../../docs_src/query_params_str_validations/tutorial002.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial002.py hl[3] *}
## Utiliser `Query` comme valeur par défaut
Construisez ensuite la valeur par défaut de votre paramètre avec `Query`, en choisissant 50 comme `max_length` :
-```Python hl_lines="9"
-{!../../docs_src/query_params_str_validations/tutorial002.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial002.py hl[9] *}
Comme nous devons remplacer la valeur par défaut `None` dans la fonction par `Query()`, nous pouvons maintenant définir la valeur par défaut avec le paramètre `Query(default=None)`, il sert le même objectif qui est de définir cette valeur par défaut.
@@ -86,17 +80,13 @@ Cela va valider les données, montrer une erreur claire si ces dernières ne son
Vous pouvez aussi rajouter un second paramètre `min_length` :
-```Python hl_lines="9"
-{!../../docs_src/query_params_str_validations/tutorial003.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial003.py hl[9] *}
## Ajouter des validations par expressions régulières
On peut définir une <abbr title="Une expression régulière, regex ou regexp est une suite de caractères qui définit un pattern de correspondance pour les chaînes de caractères.">expression régulière</abbr> à laquelle le paramètre doit correspondre :
-```Python hl_lines="10"
-{!../../docs_src/query_params_str_validations/tutorial004.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial004.py hl[10] *}
Cette expression régulière vérifie que la valeur passée comme paramètre :
@@ -114,9 +104,7 @@ De la même façon que vous pouvez passer `None` comme premier argument pour l'u
Disons que vous déclarez le paramètre `q` comme ayant une longueur minimale de `3`, et une valeur par défaut étant `"fixedquery"` :
-```Python hl_lines="7"
-{!../../docs_src/query_params_str_validations/tutorial005.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial005.py hl[7] *}
/// note | "Rappel"
@@ -146,9 +134,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
Donc pour déclarer une valeur comme requise tout en utilisant `Query`, il faut utiliser `...` comme premier argument :
-```Python hl_lines="7"
-{!../../docs_src/query_params_str_validations/tutorial006.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial006.py hl[7] *}
/// info
@@ -164,9 +150,7 @@ Quand on définit un paramètre de requête explicitement avec `Query` on peut a
Par exemple, pour déclarer un paramètre de requête `q` qui peut apparaître plusieurs fois dans une URL, on écrit :
-```Python hl_lines="9"
-{!../../docs_src/query_params_str_validations/tutorial011.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial011.py hl[9] *}
Ce qui fait qu'avec une URL comme :
@@ -201,9 +185,7 @@ La documentation sera donc mise à jour automatiquement pour autoriser plusieurs
Et l'on peut aussi définir une liste de valeurs par défaut si aucune n'est fournie :
-```Python hl_lines="9"
-{!../../docs_src/query_params_str_validations/tutorial012.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial012.py hl[9] *}
Si vous allez à :
@@ -228,9 +210,7 @@ et la réponse sera :
Il est aussi possible d'utiliser directement `list` plutôt que `List[str]` :
-```Python hl_lines="7"
-{!../../docs_src/query_params_str_validations/tutorial013.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial013.py hl[7] *}
/// note
@@ -256,15 +236,11 @@ Il se peut donc que certains d'entre eux n'utilisent pas toutes les métadonnée
Vous pouvez ajouter un `title` :
-```Python hl_lines="10"
-{!../../docs_src/query_params_str_validations/tutorial007.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial007.py hl[10] *}
Et une `description` :
-```Python hl_lines="13"
-{!../../docs_src/query_params_str_validations/tutorial008.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial008.py hl[13] *}
## Alias de paramètres
@@ -284,9 +260,7 @@ Mais vous avez vraiment envie que ce soit exactement `item-query`...
Pour cela vous pouvez déclarer un `alias`, et cet alias est ce qui sera utilisé pour trouver la valeur du paramètre :
-```Python hl_lines="9"
-{!../../docs_src/query_params_str_validations/tutorial009.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial009.py hl[9] *}
## Déprécier des paramètres
@@ -296,9 +270,7 @@ Il faut qu'il continue à exister pendant un certain temps car vos clients l'uti
On utilise alors l'argument `deprecated=True` de `Query` :
-```Python hl_lines="18"
-{!../../docs_src/query_params_str_validations/tutorial010.py!}
-```
+{* ../../docs_src/query_params_str_validations/tutorial010.py hl[18] *}
La documentation le présentera comme il suit :
From 2a4cf1736da0c6f004a0ea3d20b224cc2d4cf5d3 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 17:16:01 +0000
Subject: [PATCH 287/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 45d334c1e..47093e6ca 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/fr/docs/tutorial/query-params-str-validations.md`. PR [#12591](https://github.com/fastapi/fastapi/pull/12591) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/fr/docs/tutorial/query-params.md`. PR [#12589](https://github.com/fastapi/fastapi/pull/12589) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/tutorial/body-fields.md`. PR [#12588](https://github.com/fastapi/fastapi/pull/12588) by [@lucaromagnoli](https://github.com/lucaromagnoli).
* 📝 Update includes in `docs/de/docs/tutorial/response-status-code.md`. PR [#12585](https://github.com/fastapi/fastapi/pull/12585) by [@abejaranoh](https://github.com/abejaranoh).
From 60aba0261cb0d7a418acfc46527a152805e72007 Mon Sep 17 00:00:00 2001
From: Quentin Takeda <quentin.vadon@gmail.com>
Date: Sun, 27 Oct 2024 18:31:14 +0100
Subject: [PATCH 288/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/fr/docs/tutorial/debugging.md`=20(#12595)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/fr/docs/tutorial/debugging.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
diff --git a/docs/fr/docs/tutorial/debugging.md b/docs/fr/docs/tutorial/debugging.md
index 914277699..ab00fbdeb 100644
--- a/docs/fr/docs/tutorial/debugging.md
+++ b/docs/fr/docs/tutorial/debugging.md
@@ -6,9 +6,7 @@ Vous pouvez connecter le <abbr title="En anglais: debugger">débogueur</abbr> da
Dans votre application FastAPI, importez et exécutez directement `uvicorn` :
-```Python hl_lines="1 15"
-{!../../docs_src/debugging/tutorial001.py!}
-```
+{* ../../docs_src/debugging/tutorial001.py hl[1,15] *}
### À propos de `__name__ == "__main__"`
From 9b1e5f29e61975bfec0c35d1c2ec46620fbbc714 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 17:31:38 +0000
Subject: [PATCH 289/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 47093e6ca..0ca14b122 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/fr/docs/tutorial/debugging.md`. PR [#12595](https://github.com/fastapi/fastapi/pull/12595) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/fr/docs/tutorial/query-params-str-validations.md`. PR [#12591](https://github.com/fastapi/fastapi/pull/12591) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/fr/docs/tutorial/query-params.md`. PR [#12589](https://github.com/fastapi/fastapi/pull/12589) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/tutorial/body-fields.md`. PR [#12588](https://github.com/fastapi/fastapi/pull/12588) by [@lucaromagnoli](https://github.com/lucaromagnoli).
From 4e6b1acccd136c3d19562b57ff844afbac31efe2 Mon Sep 17 00:00:00 2001
From: Quentin Takeda <quentin.vadon@gmail.com>
Date: Sun, 27 Oct 2024 18:34:41 +0100
Subject: [PATCH 290/504] =?UTF-8?q?=F0=9F=93=9D=20=20Update=20includes=20i?=
=?UTF-8?q?n=20`docs/fr/docs/tutorial/body.md`=20(#12596)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/fr/docs/tutorial/body.md | 24 ++++++------------------
1 file changed, 6 insertions(+), 18 deletions(-)
diff --git a/docs/fr/docs/tutorial/body.md b/docs/fr/docs/tutorial/body.md
index 96fff2ca6..c4d493a45 100644
--- a/docs/fr/docs/tutorial/body.md
+++ b/docs/fr/docs/tutorial/body.md
@@ -22,9 +22,7 @@ Ceci étant découragé, la documentation interactive générée par Swagger UI
Commencez par importer la classe `BaseModel` du module `pydantic` :
-```Python hl_lines="4"
-{!../../docs_src/body/tutorial001.py!}
-```
+{* ../../docs_src/body/tutorial001.py hl[4] *}
## Créez votre modèle de données
@@ -32,9 +30,7 @@ Déclarez ensuite votre modèle de données en tant que classe qui hérite de `B
Utilisez les types Python standard pour tous les attributs :
-```Python hl_lines="7-11"
-{!../../docs_src/body/tutorial001.py!}
-```
+{* ../../docs_src/body/tutorial001.py hl[7:11] *}
Tout comme pour la déclaration de paramètres de requête, quand un attribut de modèle a une valeur par défaut, il n'est pas nécessaire. Sinon, cet attribut doit être renseigné dans le corps de la requête. Pour rendre ce champ optionnel simplement, utilisez `None` comme valeur par défaut.
@@ -62,9 +58,7 @@ Par exemple, le modèle ci-dessus déclare un "objet" JSON (ou `dict` Python) te
Pour l'ajouter à votre *opération de chemin*, déclarez-le comme vous déclareriez des paramètres de chemin ou de requête :
-```Python hl_lines="18"
-{!../../docs_src/body/tutorial001.py!}
-```
+{* ../../docs_src/body/tutorial001.py hl[18] *}
...et déclarez que son type est le modèle que vous avez créé : `Item`.
@@ -131,9 +125,7 @@ Ce qui améliore le support pour les modèles Pydantic avec :
Dans la fonction, vous pouvez accéder à tous les attributs de l'objet du modèle directement :
-```Python hl_lines="21"
-{!../../docs_src/body/tutorial002.py!}
-```
+{* ../../docs_src/body/tutorial002.py hl[21] *}
## Corps de la requête + paramètres de chemin
@@ -141,9 +133,7 @@ Vous pouvez déclarer des paramètres de chemin et un corps de requête pour la
**FastAPI** est capable de reconnaître que les paramètres de la fonction qui correspondent aux paramètres de chemin doivent être **récupérés depuis le chemin**, et que les paramètres de fonctions déclarés comme modèles Pydantic devraient être **récupérés depuis le corps de la requête**.
-```Python hl_lines="17-18"
-{!../../docs_src/body/tutorial003.py!}
-```
+{* ../../docs_src/body/tutorial003.py hl[17:18] *}
## Corps de la requête + paramètres de chemin et de requête
@@ -151,9 +141,7 @@ Vous pouvez aussi déclarer un **corps**, et des paramètres de **chemin** et de
**FastAPI** saura reconnaître chacun d'entre eux et récupérer la bonne donnée au bon endroit.
-```Python hl_lines="18"
-{!../../docs_src/body/tutorial004.py!}
-```
+{* ../../docs_src/body/tutorial004.py hl[18] *}
Les paramètres de la fonction seront reconnus comme tel :
From aee7674ed24037c4a7fbc17e2390653ba2055348 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 17:35:05 +0000
Subject: [PATCH 291/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 0ca14b122..bedd3e5f2 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/fr/docs/tutorial/body.md`. PR [#12596](https://github.com/fastapi/fastapi/pull/12596) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/fr/docs/tutorial/debugging.md`. PR [#12595](https://github.com/fastapi/fastapi/pull/12595) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/fr/docs/tutorial/query-params-str-validations.md`. PR [#12591](https://github.com/fastapi/fastapi/pull/12591) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/fr/docs/tutorial/query-params.md`. PR [#12589](https://github.com/fastapi/fastapi/pull/12589) by [@kantandane](https://github.com/kantandane).
From b31cbbf5f5f7680f27c50339ff9fddafadcc3d7a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 27 Oct 2024 22:46:26 +0100
Subject: [PATCH 292/504] =?UTF-8?q?=E2=99=BB=EF=B8=8F=20Update=20logic=20t?=
=?UTF-8?q?o=20import=20and=20check=20`python-multipart`=20for=20compatibi?=
=?UTF-8?q?lity=20with=20newer=20version=20(#12627)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
fastapi/dependencies/utils.py | 30 +++++---
tests/test_multipart_installation.py | 107 +++++++++++++++++++--------
2 files changed, 94 insertions(+), 43 deletions(-)
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 87653c80d..e2866b488 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -90,21 +90,29 @@ multipart_incorrect_install_error = (
def ensure_multipart_is_installed() -> None:
try:
- # __version__ is available in both multiparts, and can be mocked
- from multipart import __version__
+ from python_multipart import __version__
- assert __version__
+ # Import an attribute that can be mocked/deleted in testing
+ assert __version__ > "0.0.12"
+ except (ImportError, AssertionError):
try:
- # parse_options_header is only available in the right multipart
- from multipart.multipart import parse_options_header
+ # __version__ is available in both multiparts, and can be mocked
+ from multipart import __version__ # type: ignore[no-redef,import-untyped]
- assert parse_options_header # type: ignore[truthy-function]
+ assert __version__
+ try:
+ # parse_options_header is only available in the right multipart
+ from multipart.multipart import ( # type: ignore[import-untyped]
+ parse_options_header,
+ )
+
+ assert parse_options_header
+ except ImportError:
+ logger.error(multipart_incorrect_install_error)
+ raise RuntimeError(multipart_incorrect_install_error) from None
except ImportError:
- logger.error(multipart_incorrect_install_error)
- raise RuntimeError(multipart_incorrect_install_error) from None
- except ImportError:
- logger.error(multipart_not_installed_error)
- raise RuntimeError(multipart_not_installed_error) from None
+ logger.error(multipart_not_installed_error)
+ raise RuntimeError(multipart_not_installed_error) from None
def get_param_sub_dependant(
diff --git a/tests/test_multipart_installation.py b/tests/test_multipart_installation.py
index 788d9ef5a..9c3e47c49 100644
--- a/tests/test_multipart_installation.py
+++ b/tests/test_multipart_installation.py
@@ -1,3 +1,5 @@
+import warnings
+
import pytest
from fastapi import FastAPI, File, Form, UploadFile
from fastapi.dependencies.utils import (
@@ -7,7 +9,10 @@ from fastapi.dependencies.utils import (
def test_incorrect_multipart_installed_form(monkeypatch):
- monkeypatch.delattr("multipart.multipart.parse_options_header", raising=False)
+ monkeypatch.setattr("python_multipart.__version__", "0.0.12")
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ monkeypatch.delattr("multipart.multipart.parse_options_header", raising=False)
with pytest.raises(RuntimeError, match=multipart_incorrect_install_error):
app = FastAPI()
@@ -17,7 +22,10 @@ def test_incorrect_multipart_installed_form(monkeypatch):
def test_incorrect_multipart_installed_file_upload(monkeypatch):
- monkeypatch.delattr("multipart.multipart.parse_options_header", raising=False)
+ monkeypatch.setattr("python_multipart.__version__", "0.0.12")
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ monkeypatch.delattr("multipart.multipart.parse_options_header", raising=False)
with pytest.raises(RuntimeError, match=multipart_incorrect_install_error):
app = FastAPI()
@@ -27,7 +35,10 @@ def test_incorrect_multipart_installed_file_upload(monkeypatch):
def test_incorrect_multipart_installed_file_bytes(monkeypatch):
- monkeypatch.delattr("multipart.multipart.parse_options_header", raising=False)
+ monkeypatch.setattr("python_multipart.__version__", "0.0.12")
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ monkeypatch.delattr("multipart.multipart.parse_options_header", raising=False)
with pytest.raises(RuntimeError, match=multipart_incorrect_install_error):
app = FastAPI()
@@ -37,7 +48,10 @@ def test_incorrect_multipart_installed_file_bytes(monkeypatch):
def test_incorrect_multipart_installed_multi_form(monkeypatch):
- monkeypatch.delattr("multipart.multipart.parse_options_header", raising=False)
+ monkeypatch.setattr("python_multipart.__version__", "0.0.12")
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ monkeypatch.delattr("multipart.multipart.parse_options_header", raising=False)
with pytest.raises(RuntimeError, match=multipart_incorrect_install_error):
app = FastAPI()
@@ -47,7 +61,10 @@ def test_incorrect_multipart_installed_multi_form(monkeypatch):
def test_incorrect_multipart_installed_form_file(monkeypatch):
- monkeypatch.delattr("multipart.multipart.parse_options_header", raising=False)
+ monkeypatch.setattr("python_multipart.__version__", "0.0.12")
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ monkeypatch.delattr("multipart.multipart.parse_options_header", raising=False)
with pytest.raises(RuntimeError, match=multipart_incorrect_install_error):
app = FastAPI()
@@ -57,50 +74,76 @@ def test_incorrect_multipart_installed_form_file(monkeypatch):
def test_no_multipart_installed(monkeypatch):
- monkeypatch.delattr("multipart.__version__", raising=False)
- with pytest.raises(RuntimeError, match=multipart_not_installed_error):
- app = FastAPI()
+ monkeypatch.setattr("python_multipart.__version__", "0.0.12")
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ monkeypatch.delattr("multipart.__version__", raising=False)
+ with pytest.raises(RuntimeError, match=multipart_not_installed_error):
+ app = FastAPI()
- @app.post("/")
- async def root(username: str = Form()):
- return username # pragma: nocover
+ @app.post("/")
+ async def root(username: str = Form()):
+ return username # pragma: nocover
def test_no_multipart_installed_file(monkeypatch):
- monkeypatch.delattr("multipart.__version__", raising=False)
- with pytest.raises(RuntimeError, match=multipart_not_installed_error):
- app = FastAPI()
+ monkeypatch.setattr("python_multipart.__version__", "0.0.12")
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ monkeypatch.delattr("multipart.__version__", raising=False)
+ with pytest.raises(RuntimeError, match=multipart_not_installed_error):
+ app = FastAPI()
- @app.post("/")
- async def root(f: UploadFile = File()):
- return f # pragma: nocover
+ @app.post("/")
+ async def root(f: UploadFile = File()):
+ return f # pragma: nocover
def test_no_multipart_installed_file_bytes(monkeypatch):
- monkeypatch.delattr("multipart.__version__", raising=False)
- with pytest.raises(RuntimeError, match=multipart_not_installed_error):
- app = FastAPI()
+ monkeypatch.setattr("python_multipart.__version__", "0.0.12")
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ monkeypatch.delattr("multipart.__version__", raising=False)
+ with pytest.raises(RuntimeError, match=multipart_not_installed_error):
+ app = FastAPI()
- @app.post("/")
- async def root(f: bytes = File()):
- return f # pragma: nocover
+ @app.post("/")
+ async def root(f: bytes = File()):
+ return f # pragma: nocover
def test_no_multipart_installed_multi_form(monkeypatch):
- monkeypatch.delattr("multipart.__version__", raising=False)
- with pytest.raises(RuntimeError, match=multipart_not_installed_error):
- app = FastAPI()
+ monkeypatch.setattr("python_multipart.__version__", "0.0.12")
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ monkeypatch.delattr("multipart.__version__", raising=False)
+ with pytest.raises(RuntimeError, match=multipart_not_installed_error):
+ app = FastAPI()
- @app.post("/")
- async def root(username: str = Form(), password: str = Form()):
- return username # pragma: nocover
+ @app.post("/")
+ async def root(username: str = Form(), password: str = Form()):
+ return username # pragma: nocover
def test_no_multipart_installed_form_file(monkeypatch):
- monkeypatch.delattr("multipart.__version__", raising=False)
- with pytest.raises(RuntimeError, match=multipart_not_installed_error):
+ monkeypatch.setattr("python_multipart.__version__", "0.0.12")
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
+ monkeypatch.delattr("multipart.__version__", raising=False)
+ with pytest.raises(RuntimeError, match=multipart_not_installed_error):
+ app = FastAPI()
+
+ @app.post("/")
+ async def root(username: str = Form(), f: UploadFile = File()):
+ return username # pragma: nocover
+
+
+def test_old_multipart_installed(monkeypatch):
+ monkeypatch.setattr("python_multipart.__version__", "0.0.12")
+ with warnings.catch_warnings(record=True):
+ warnings.simplefilter("always")
app = FastAPI()
@app.post("/")
- async def root(username: str = Form(), f: UploadFile = File()):
+ async def root(username: str = Form()):
return username # pragma: nocover
From b270ff1e5eb00bb497078dc3da6ec5f8326ee726 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 21:46:51 +0000
Subject: [PATCH 293/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index bedd3e5f2..4445419e5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Refactors
+
+* ♻️ Update logic to import and check `python-multipart` for compatibility with newer version. PR [#12627](https://github.com/fastapi/fastapi/pull/12627) by [@tiangolo](https://github.com/tiangolo).
+
### Docs
* 📝 Update includes in `docs/fr/docs/tutorial/body.md`. PR [#12596](https://github.com/fastapi/fastapi/pull/12596) by [@kantandane](https://github.com/kantandane).
From 31887b1cc6fb45373b615448627c63410bd37333 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 27 Oct 2024 21:51:55 +0000
Subject: [PATCH 294/504] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.11?=
=?UTF-8?q?5.4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 2 ++
fastapi/__init__.py | 2 +-
2 files changed, 3 insertions(+), 1 deletion(-)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4445419e5..ea6896f22 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
## Latest Changes
+## 0.115.4
+
### Refactors
* ♻️ Update logic to import and check `python-multipart` for compatibility with newer version. PR [#12627](https://github.com/fastapi/fastapi/pull/12627) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 64d5dd39b..51e3ca510 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
"""FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
-__version__ = "0.115.3"
+__version__ = "0.115.4"
from starlette import status as status
From 2c27cae742afdf811c25e4e79c4e83406bbd6723 Mon Sep 17 00:00:00 2001
From: namjimin_43 <mimi3123832@gmail.com>
Date: Mon, 28 Oct 2024 07:01:39 +0900
Subject: [PATCH 295/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20Translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/advanced/response-change-status-code.m?=
=?UTF-8?q?d`=20(#12547)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../advanced/response-change-status-code.md | 33 +++++++++++++++++++
1 file changed, 33 insertions(+)
create mode 100644 docs/ko/docs/advanced/response-change-status-code.md
diff --git a/docs/ko/docs/advanced/response-change-status-code.md b/docs/ko/docs/advanced/response-change-status-code.md
new file mode 100644
index 000000000..f3cdd2ba5
--- /dev/null
+++ b/docs/ko/docs/advanced/response-change-status-code.md
@@ -0,0 +1,33 @@
+# 응답 - 상태 코드 변경
+
+기본 [응답 상태 코드 설정](../tutorial/response-status-code.md){.internal-link target=_blank}이 가능하다는 걸 이미 알고 계실 겁니다.
+
+하지만 경우에 따라 기본 설정과 다른 상태 코드를 반환해야 할 때가 있습니다.
+
+## 사용 예
+
+예를 들어 기본적으로 HTTP 상태 코드 "OK" `200`을 반환하고 싶다고 가정해 봅시다.
+
+하지만 데이터가 존재하지 않으면 이를 새로 생성하고, HTTP 상태 코드 "CREATED" `201`을 반환하고자 할 때가 있을 수 있습니다.
+
+이때도 여전히 `response_model`을 사용하여 반환하는 데이터를 필터링하고 변환하고 싶을 수 있습니다.
+
+이런 경우에는 `Response` 파라미터를 사용할 수 있습니다.
+
+## `Response` 파라미터 사용하기
+
+*경로 작동 함수*에 `Response` 타입의 파라미터를 선언할 수 있습니다. (쿠키와 헤더에 대해 선언하는 것과 유사하게)
+
+그리고 이 *임시* 응답 객체에서 `status_code`를 설정할 수 있습니다.
+
+```Python hl_lines="1 9 12"
+{!../../docs_src/response_change_status_code/tutorial001.py!}
+```
+
+그리고 평소처럼 원하는 객체(`dict`, 데이터베이스 모델 등)를 반환할 수 있습니다.
+
+`response_model`을 선언했다면 반환된 객체는 여전히 필터링되고 변환됩니다.
+
+**FastAPI**는 이 *임시* 응답 객체에서 상태 코드(쿠키와 헤더 포함)를 추출하여, `response_model`로 필터링된 반환 값을 최종 응답에 넣습니다.
+
+또한, 의존성에서도 `Response` 파라미터를 선언하고 그 안에서 상태 코드를 설정할 수 있습니다. 단, 마지막으로 설정된 상태 코드가 우선 적용된다는 점을 유의하세요.
From d92fc89eb8faac9992de534843f57119034ce326 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 22:02:27 +0000
Subject: [PATCH 296/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ea6896f22..160116c0d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Translations
+
+* 🌐 Add Korean Translation for `docs/ko/docs/advanced/response-change-status-code.md`. PR [#12547](https://github.com/fastapi/fastapi/pull/12547) by [@9zimin9](https://github.com/9zimin9).
+
## 0.115.4
### Refactors
From 78f295609fb27db455e60c5da019bdd73150f5f2 Mon Sep 17 00:00:00 2001
From: Philip Okiokio <55271518+philipokiokio@users.noreply.github.com>
Date: Sun, 27 Oct 2024 23:12:32 +0100
Subject: [PATCH 297/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/how-to/custom-request-and-route.md`=20(#12560)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../docs/how-to/custom-request-and-route.md | 34 +++++++++----------
1 file changed, 16 insertions(+), 18 deletions(-)
diff --git a/docs/en/docs/how-to/custom-request-and-route.md b/docs/en/docs/how-to/custom-request-and-route.md
index a62ebf1d5..f80887c0d 100644
--- a/docs/en/docs/how-to/custom-request-and-route.md
+++ b/docs/en/docs/how-to/custom-request-and-route.md
@@ -42,9 +42,8 @@ If there's no `gzip` in the header, it will not try to decompress the body.
That way, the same route class can handle gzip compressed or uncompressed requests.
-```Python hl_lines="8-15"
-{!../../docs_src/custom_request_and_route/tutorial001.py!}
-```
+{* ../../docs_src/custom_request_and_route/tutorial001.py hl[8:15] *}
+
### Create a custom `GzipRoute` class
@@ -56,9 +55,9 @@ This method returns a function. And that function is what will receive a request
Here we use it to create a `GzipRequest` from the original request.
-```Python hl_lines="18-26"
-{!../../docs_src/custom_request_and_route/tutorial001.py!}
-```
+
+{* ../../docs_src/custom_request_and_route/tutorial001.py hl[18:26] *}
+
/// note | "Technical Details"
@@ -96,26 +95,25 @@ We can also use this same approach to access the request body in an exception ha
All we need to do is handle the request inside a `try`/`except` block:
-```Python hl_lines="13 15"
-{!../../docs_src/custom_request_and_route/tutorial002.py!}
-```
+
+{* ../../docs_src/custom_request_and_route/tutorial002.py hl[13,15] *}
+
If an exception occurs, the`Request` instance will still be in scope, so we can read and make use of the request body when handling the error:
-```Python hl_lines="16-18"
-{!../../docs_src/custom_request_and_route/tutorial002.py!}
-```
+
+{* ../../docs_src/custom_request_and_route/tutorial002.py hl[16:18] *}
+
+
## Custom `APIRoute` class in a router
You can also set the `route_class` parameter of an `APIRouter`:
-```Python hl_lines="26"
-{!../../docs_src/custom_request_and_route/tutorial003.py!}
-```
+{* ../../docs_src/custom_request_and_route/tutorial003.py hl[26] *}
+
In this example, the *path operations* under the `router` will use the custom `TimedRoute` class, and will have an extra `X-Response-Time` header in the response with the time it took to generate the response:
-```Python hl_lines="13-20"
-{!../../docs_src/custom_request_and_route/tutorial003.py!}
-```
+
+{* ../../docs_src/custom_request_and_route/tutorial003.py hl[13:20] *}
From 5db8b491db1cec45640ec0bd1df9a534bfc525a3 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 22:12:53 +0000
Subject: [PATCH 298/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 160116c0d..2e5ff95dc 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
## Latest Changes
+### Docs
+
+* 📝 Update includes in `docs/en/docs/how-to/custom-request-and-route.md`. PR [#12560](https://github.com/fastapi/fastapi/pull/12560) by [@philipokiokio](https://github.com/philipokiokio).
+
### Translations
* 🌐 Add Korean Translation for `docs/ko/docs/advanced/response-change-status-code.md`. PR [#12547](https://github.com/fastapi/fastapi/pull/12547) by [@9zimin9](https://github.com/9zimin9).
From eea2d8e67cab83e7136bc4a8328f0f791181215f Mon Sep 17 00:00:00 2001
From: Alejandra <90076947+alejsdev@users.noreply.github.com>
Date: Sun, 27 Oct 2024 22:39:38 +0000
Subject: [PATCH 299/504] =?UTF-8?q?=F0=9F=8E=A8=20Adjust=20spacing=20(#126?=
=?UTF-8?q?35)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/how-to/custom-request-and-route.md | 10 ----------
docs/en/docs/how-to/extending-openapi.md | 10 ----------
docs/en/docs/how-to/graphql.md | 2 --
3 files changed, 22 deletions(-)
diff --git a/docs/en/docs/how-to/custom-request-and-route.md b/docs/en/docs/how-to/custom-request-and-route.md
index f80887c0d..25ec0a335 100644
--- a/docs/en/docs/how-to/custom-request-and-route.md
+++ b/docs/en/docs/how-to/custom-request-and-route.md
@@ -44,7 +44,6 @@ That way, the same route class can handle gzip compressed or uncompressed reques
{* ../../docs_src/custom_request_and_route/tutorial001.py hl[8:15] *}
-
### Create a custom `GzipRoute` class
Next, we create a custom subclass of `fastapi.routing.APIRoute` that will make use of the `GzipRequest`.
@@ -55,10 +54,8 @@ This method returns a function. And that function is what will receive a request
Here we use it to create a `GzipRequest` from the original request.
-
{* ../../docs_src/custom_request_and_route/tutorial001.py hl[18:26] *}
-
/// note | "Technical Details"
A `Request` has a `request.scope` attribute, that's just a Python `dict` containing the metadata related to the request.
@@ -95,25 +92,18 @@ We can also use this same approach to access the request body in an exception ha
All we need to do is handle the request inside a `try`/`except` block:
-
{* ../../docs_src/custom_request_and_route/tutorial002.py hl[13,15] *}
-
If an exception occurs, the`Request` instance will still be in scope, so we can read and make use of the request body when handling the error:
-
{* ../../docs_src/custom_request_and_route/tutorial002.py hl[16:18] *}
-
-
## Custom `APIRoute` class in a router
You can also set the `route_class` parameter of an `APIRouter`:
{* ../../docs_src/custom_request_and_route/tutorial003.py hl[26] *}
-
In this example, the *path operations* under the `router` will use the custom `TimedRoute` class, and will have an extra `X-Response-Time` header in the response with the time it took to generate the response:
-
{* ../../docs_src/custom_request_and_route/tutorial003.py hl[13:20] *}
diff --git a/docs/en/docs/how-to/extending-openapi.md b/docs/en/docs/how-to/extending-openapi.md
index 8c7790725..26c742c20 100644
--- a/docs/en/docs/how-to/extending-openapi.md
+++ b/docs/en/docs/how-to/extending-openapi.md
@@ -45,23 +45,18 @@ First, write all your **FastAPI** application as normally:
{* ../../docs_src/extending_openapi/tutorial001.py hl[1,4,7:9] *}
-
### Generate the OpenAPI schema
Then, use the same utility function to generate the OpenAPI schema, inside a `custom_openapi()` function:
-
-
{* ../../docs_src/extending_openapi/tutorial001.py hl[2,15:21] *}
-
### Modify the OpenAPI schema
Now you can add the ReDoc extension, adding a custom `x-logo` to the `info` "object" in the OpenAPI schema:
{* ../../docs_src/extending_openapi/tutorial001.py hl[22:24] *}
-
### Cache the OpenAPI schema
You can use the property `.openapi_schema` as a "cache", to store your generated schema.
@@ -70,19 +65,14 @@ That way, your application won't have to generate the schema every time a user o
It will be generated only once, and then the same cached schema will be used for the next requests.
-
{* ../../docs_src/extending_openapi/tutorial001.py hl[13:14,25:26] *}
-
### Override the method
Now you can replace the `.openapi()` method with your new function.
-
-
{* ../../docs_src/extending_openapi/tutorial001.py hl[29] *}
-
### Check it
Once you go to <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a> you will see that you are using your custom logo (in this example, **FastAPI**'s logo):
diff --git a/docs/en/docs/how-to/graphql.md b/docs/en/docs/how-to/graphql.md
index 5d8f879d1..a6219e481 100644
--- a/docs/en/docs/how-to/graphql.md
+++ b/docs/en/docs/how-to/graphql.md
@@ -35,10 +35,8 @@ Depending on your use case, you might prefer to use a different library, but if
Here's a small preview of how you could integrate Strawberry with FastAPI:
-
{* ../../docs_src/graphql/tutorial001.py hl[3,22,25:26] *}
-
You can learn more about Strawberry in the <a href="https://strawberry.rocks/" class="external-link" target="_blank">Strawberry documentation</a>.
And also the docs about <a href="https://strawberry.rocks/docs/integrations/fastapi" class="external-link" target="_blank">Strawberry with FastAPI</a>.
From 04194dc191c0818b1f75e7fe89d9206f96e112a1 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 22:39:58 +0000
Subject: [PATCH 300/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2e5ff95dc..8816c511f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 🎨 Adjust spacing. PR [#12635](https://github.com/fastapi/fastapi/pull/12635) by [@alejsdev](https://github.com/alejsdev).
* 📝 Update includes in `docs/en/docs/how-to/custom-request-and-route.md`. PR [#12560](https://github.com/fastapi/fastapi/pull/12560) by [@philipokiokio](https://github.com/philipokiokio).
### Translations
From 95ebac1a89a8f729ef78a72dfd44d4335faf7c86 Mon Sep 17 00:00:00 2001
From: Philip Okiokio <55271518+philipokiokio@users.noreply.github.com>
Date: Sun, 27 Oct 2024 23:53:46 +0100
Subject: [PATCH 301/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/how-to/custom-docs-ui-assets.md`=20(#12557)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/how-to/custom-docs-ui-assets.md | 24 +++++---------------
1 file changed, 6 insertions(+), 18 deletions(-)
diff --git a/docs/en/docs/how-to/custom-docs-ui-assets.md b/docs/en/docs/how-to/custom-docs-ui-assets.md
index 16c873d11..abcccb499 100644
--- a/docs/en/docs/how-to/custom-docs-ui-assets.md
+++ b/docs/en/docs/how-to/custom-docs-ui-assets.md
@@ -18,9 +18,7 @@ The first step is to disable the automatic docs, as by default, those use the de
To disable them, set their URLs to `None` when creating your `FastAPI` app:
-```Python hl_lines="8"
-{!../../docs_src/custom_docs_ui/tutorial001.py!}
-```
+{* ../../docs_src/custom_docs_ui/tutorial001.py hl[8] *}
### Include the custom docs
@@ -36,9 +34,7 @@ You can reuse FastAPI's internal functions to create the HTML pages for the docs
And similarly for ReDoc...
-```Python hl_lines="2-6 11-19 22-24 27-33"
-{!../../docs_src/custom_docs_ui/tutorial001.py!}
-```
+{* ../../docs_src/custom_docs_ui/tutorial001.py hl[2:6,11:19,22:24,27:33] *}
/// tip
@@ -54,9 +50,7 @@ Swagger UI will handle it behind the scenes for you, but it needs this "redirect
Now, to be able to test that everything works, create a *path operation*:
-```Python hl_lines="36-38"
-{!../../docs_src/custom_docs_ui/tutorial001.py!}
-```
+{* ../../docs_src/custom_docs_ui/tutorial001.py hl[36:38] *}
### Test it
@@ -158,9 +152,7 @@ The same as when using a custom CDN, the first step is to disable the automatic
To disable them, set their URLs to `None` when creating your `FastAPI` app:
-```Python hl_lines="9"
-{!../../docs_src/custom_docs_ui/tutorial002.py!}
-```
+{* ../../docs_src/custom_docs_ui/tutorial002.py hl[9] *}
### Include the custom docs for static files
@@ -176,9 +168,7 @@ Again, you can reuse FastAPI's internal functions to create the HTML pages for t
And similarly for ReDoc...
-```Python hl_lines="2-6 14-22 25-27 30-36"
-{!../../docs_src/custom_docs_ui/tutorial002.py!}
-```
+{* ../../docs_src/custom_docs_ui/tutorial002.py hl[2:6,14:22,25:27,30:36] *}
/// tip
@@ -194,9 +184,7 @@ Swagger UI will handle it behind the scenes for you, but it needs this "redirect
Now, to be able to test that everything works, create a *path operation*:
-```Python hl_lines="39-41"
-{!../../docs_src/custom_docs_ui/tutorial002.py!}
-```
+{* ../../docs_src/custom_docs_ui/tutorial002.py hl[39:41] *}
### Test Static Files UI
From dbc3008f5a3418271c31e7e3fe1051a7649f7289 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 22:54:10 +0000
Subject: [PATCH 302/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8816c511f..40fe191a7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/how-to/custom-docs-ui-assets.md`. PR [#12557](https://github.com/fastapi/fastapi/pull/12557) by [@philipokiokio](https://github.com/philipokiokio).
* 🎨 Adjust spacing. PR [#12635](https://github.com/fastapi/fastapi/pull/12635) by [@alejsdev](https://github.com/alejsdev).
* 📝 Update includes in `docs/en/docs/how-to/custom-request-and-route.md`. PR [#12560](https://github.com/fastapi/fastapi/pull/12560) by [@philipokiokio](https://github.com/philipokiokio).
From 96a6d469e917076749b36603f509a8adc39a050c Mon Sep 17 00:00:00 2001
From: Tony Ly <15992943+tonyjly@users.noreply.github.com>
Date: Sun, 27 Oct 2024 16:31:16 -0700
Subject: [PATCH 303/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/encoder.md`=20(#12597)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/encoder.md | 16 +---------------
1 file changed, 1 insertion(+), 15 deletions(-)
diff --git a/docs/en/docs/tutorial/encoder.md b/docs/en/docs/tutorial/encoder.md
index 039ac6714..e2eceafcc 100644
--- a/docs/en/docs/tutorial/encoder.md
+++ b/docs/en/docs/tutorial/encoder.md
@@ -20,21 +20,7 @@ You can use `jsonable_encoder` for that.
It receives an object, like a Pydantic model, and returns a JSON compatible version:
-//// tab | Python 3.10+
-
-```Python hl_lines="4 21"
-{!> ../../docs_src/encoder/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="5 22"
-{!> ../../docs_src/encoder/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/encoder/tutorial001_py310.py hl[4,21] *}
In this example, it would convert the Pydantic model to a `dict`, and the `datetime` to a `str`.
From adf89d1d9fdc8ea03bc0f3361b3d5e4b6835cf6c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 27 Oct 2024 23:31:38 +0000
Subject: [PATCH 304/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 40fe191a7..c687c7e0f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/encoder.md`. PR [#12597](https://github.com/fastapi/fastapi/pull/12597) by [@tonyjly](https://github.com/tonyjly).
* 📝 Update includes in `docs/en/docs/how-to/custom-docs-ui-assets.md`. PR [#12557](https://github.com/fastapi/fastapi/pull/12557) by [@philipokiokio](https://github.com/philipokiokio).
* 🎨 Adjust spacing. PR [#12635](https://github.com/fastapi/fastapi/pull/12635) by [@alejsdev](https://github.com/alejsdev).
* 📝 Update includes in `docs/en/docs/how-to/custom-request-and-route.md`. PR [#12560](https://github.com/fastapi/fastapi/pull/12560) by [@philipokiokio](https://github.com/philipokiokio).
From 269a22454443c6d977f702fb41d3d40cff149123 Mon Sep 17 00:00:00 2001
From: Quentin Takeda <quentin.vadon@gmail.com>
Date: Mon, 28 Oct 2024 11:29:51 +0100
Subject: [PATCH 305/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/fr/docs/tutorial/background-tasks.md`=20(#12600)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/fr/docs/tutorial/background-tasks.md | 16 ++++------------
1 file changed, 4 insertions(+), 12 deletions(-)
diff --git a/docs/fr/docs/tutorial/background-tasks.md b/docs/fr/docs/tutorial/background-tasks.md
index d971d293d..e14d5a8e8 100644
--- a/docs/fr/docs/tutorial/background-tasks.md
+++ b/docs/fr/docs/tutorial/background-tasks.md
@@ -16,9 +16,7 @@ Cela comprend, par exemple :
Pour commencer, importez `BackgroundTasks` et définissez un paramètre dans votre *fonction de chemin* avec `BackgroundTasks` comme type déclaré.
-```Python hl_lines="1 13"
-{!../../docs_src/background_tasks/tutorial001.py!}
-```
+{* ../../docs_src/background_tasks/tutorial001.py hl[1,13] *}
**FastAPI** créera l'objet de type `BackgroundTasks` pour vous et le passera comme paramètre.
@@ -32,18 +30,14 @@ Dans cet exemple, la fonction de tâche écrira dans un fichier (afin de simuler
L'opération d'écriture n'utilisant ni `async` ni `await`, on définit la fonction avec un `def` normal.
-```Python hl_lines="6-9"
-{!../../docs_src/background_tasks/tutorial001.py!}
-```
+{* ../../docs_src/background_tasks/tutorial001.py hl[6:9] *}
## Ajouter une tâche d'arrière-plan
Dans votre *fonction de chemin*, passez votre fonction de tâche à l'objet de type `BackgroundTasks` (`background_tasks` ici) grâce à la méthode `.add_task()` :
-```Python hl_lines="14"
-{!../../docs_src/background_tasks/tutorial001.py!}
-```
+{* ../../docs_src/background_tasks/tutorial001.py hl[14] *}
`.add_task()` reçoit comme arguments :
@@ -57,9 +51,7 @@ Utiliser `BackgroundTasks` fonctionne aussi avec le système d'injection de dép
**FastAPI** sait quoi faire dans chaque cas et comment réutiliser le même objet, afin que tous les paramètres de type `BackgroundTasks` soient fusionnés et que les tâches soient exécutées en arrière-plan :
-```Python hl_lines="13 15 22 25"
-{!../../docs_src/background_tasks/tutorial002.py!}
-```
+{* ../../docs_src/background_tasks/tutorial002.py hl[13,15,22,25] *}
Dans cet exemple, les messages seront écrits dans le fichier `log.txt` après que la réponse soit envoyée.
From 0279f6dd5fc5613308d4dabd5af477a3ac8d42e9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 28 Oct 2024 10:30:19 +0000
Subject: [PATCH 306/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c687c7e0f..d2e40bf39 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/fr/docs/tutorial/background-tasks.md`. PR [#12600](https://github.com/fastapi/fastapi/pull/12600) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/tutorial/encoder.md`. PR [#12597](https://github.com/fastapi/fastapi/pull/12597) by [@tonyjly](https://github.com/tonyjly).
* 📝 Update includes in `docs/en/docs/how-to/custom-docs-ui-assets.md`. PR [#12557](https://github.com/fastapi/fastapi/pull/12557) by [@philipokiokio](https://github.com/philipokiokio).
* 🎨 Adjust spacing. PR [#12635](https://github.com/fastapi/fastapi/pull/12635) by [@alejsdev](https://github.com/alejsdev).
From 218d3c352429674d18dad0a42747dcbcbb9fb36a Mon Sep 17 00:00:00 2001
From: Quentin Takeda <quentin.vadon@gmail.com>
Date: Mon, 28 Oct 2024 11:32:37 +0100
Subject: [PATCH 307/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/fr/docs/tutorial/path-params-numeric-validations.md`?=
=?UTF-8?q?=20(#12601)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../path-params-numeric-validations.md | 274 +-----------------
1 file changed, 10 insertions(+), 264 deletions(-)
diff --git a/docs/fr/docs/tutorial/path-params-numeric-validations.md b/docs/fr/docs/tutorial/path-params-numeric-validations.md
index 82e317ff7..b3635fb86 100644
--- a/docs/fr/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/fr/docs/tutorial/path-params-numeric-validations.md
@@ -6,57 +6,7 @@ De la même façon que vous pouvez déclarer plus de validations et de métadonn
Tout d'abord, importez `Path` de `fastapi`, et importez `Annotated` :
-//// tab | Python 3.10+
-
-```Python hl_lines="1 3"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="1 3"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="3-4"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="1"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="3"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[1,3] *}
/// info
@@ -74,57 +24,7 @@ Vous pouvez déclarer les mêmes paramètres que pour `Query`.
Par exemple, pour déclarer une valeur de métadonnée `title` pour le paramètre de chemin `item_id`, vous pouvez écrire :
-//// tab | Python 3.10+
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="11"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="8"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[10] *}
/// note
@@ -154,37 +54,11 @@ Cela n'a pas d'importance pour **FastAPI**. Il détectera les paramètres par le
Ainsi, vous pouvez déclarer votre fonction comme suit :
-//// tab | Python 3.8 non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="7"
-{!> ../../docs_src/path_params_numeric_validations/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial002.py hl[7] *}
Mais gardez à l'esprit que si vous utilisez `Annotated`, vous n'aurez pas ce problème, cela n'aura pas d'importance car vous n'utilisez pas les valeurs par défaut des paramètres de fonction pour `Query()` ou `Path()`.
-//// tab | Python 3.9+
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9"
-{!> ../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py hl[10] *}
## Ordonnez les paramètres comme vous le souhaitez (astuces)
@@ -209,29 +83,13 @@ Passez `*`, comme premier paramètre de la fonction.
Python ne fera rien avec ce `*`, mais il saura que tous les paramètres suivants doivent être appelés comme arguments "mots-clés" (paires clé-valeur), également connus sous le nom de <abbr title="De : K-ey W-ord Arg-uments"><code>kwargs</code></abbr>. Même s'ils n'ont pas de valeur par défaut.
-```Python hl_lines="7"
-{!../../docs_src/path_params_numeric_validations/tutorial003.py!}
-```
+{* ../../docs_src/path_params_numeric_validations/tutorial003.py hl[7] *}
# Avec `Annotated`
Gardez à l'esprit que si vous utilisez `Annotated`, comme vous n'utilisez pas les valeurs par défaut des paramètres de fonction, vous n'aurez pas ce problème, et vous n'aurez probablement pas besoin d'utiliser `*`.
-//// tab | Python 3.9+
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9"
-{!> ../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py hl[10] *}
## Validations numériques : supérieur ou égal
@@ -239,35 +97,7 @@ Avec `Query` et `Path` (et d'autres que vous verrez plus tard) vous pouvez décl
Ici, avec `ge=1`, `item_id` devra être un nombre entier "`g`reater than or `e`qual" à `1`.
-//// tab | Python 3.9+
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9"
-{!> ../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="8"
-{!> ../../docs_src/path_params_numeric_validations/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py hl[10] *}
## Validations numériques : supérieur ou égal et inférieur ou égal
@@ -276,35 +106,7 @@ La même chose s'applique pour :
* `gt` : `g`reater `t`han
* `le` : `l`ess than or `e`qual
-//// tab | Python 3.9+
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9"
-{!> ../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="8"
-{!> ../../docs_src/path_params_numeric_validations/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py hl[10] *}
## Validations numériques : supérieur et inférieur ou égal
@@ -313,35 +115,7 @@ La même chose s'applique pour :
* `gt` : `g`reater `t`han
* `le` : `l`ess than or `e`qual
-//// tab | Python 3.9+
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9"
-{!> ../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="9"
-{!> ../../docs_src/path_params_numeric_validations/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py hl[10] *}
## Validations numériques : flottants, supérieur et inférieur
@@ -353,35 +127,7 @@ Ainsi, `0.5` serait une valeur valide. Mais `0.0` ou `0` ne le serait pas.
Et la même chose pour <abbr title="less than"><code>lt</code></abbr>.
-//// tab | Python 3.9+
-
-```Python hl_lines="13"
-{!> ../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="12"
-{!> ../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="11"
-{!> ../../docs_src/path_params_numeric_validations/tutorial006.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py hl[13] *}
## Pour résumer
From 96c5566a5b31422965e0e1b383ef0128b0acde7c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Antony=20Ar=C3=A9valo?= <antonyare_93@hotmail.com>
Date: Mon, 28 Oct 2024 05:33:43 -0500
Subject: [PATCH 308/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/es/docs/tutorial/cookie-params.md`=20(#12602)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/es/docs/tutorial/cookie-params.md | 104 +------------------------
1 file changed, 2 insertions(+), 102 deletions(-)
diff --git a/docs/es/docs/tutorial/cookie-params.md b/docs/es/docs/tutorial/cookie-params.md
index e858e34e8..db3fc092e 100644
--- a/docs/es/docs/tutorial/cookie-params.md
+++ b/docs/es/docs/tutorial/cookie-params.md
@@ -6,57 +6,7 @@ Puedes definir parámetros de Cookie de la misma manera que defines parámetros
Primero importa `Cookie`:
-//// tab | Python 3.10+
-
-```Python hl_lines="3"
-{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="3"
-{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="3"
-{!> ../../docs_src/cookie_params/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip | Consejo
-
-Es preferible utilizar la versión `Annotated` si es posible.
-
-///
-
-```Python hl_lines="1"
-{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip | Consejo
-
-Es preferible utilizar la versión `Annotated` si es posible.
-
-///
-
-```Python hl_lines="3"
-{!> ../../docs_src/cookie_params/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/cookie_params/tutorial001_an_py310.py hl[3]*}
## Declarar parámetros de `Cookie`
@@ -64,57 +14,7 @@ Luego declara los parámetros de cookie usando la misma estructura que con `Path
El primer valor es el valor por defecto, puedes pasar todos los parámetros adicionales de validación o anotación:
-//// tab | Python 3.10+
-
-```Python hl_lines="9"
-{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="9"
-{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="10"
-{!> ../../docs_src/cookie_params/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip | Consejo
-
-Es preferible utilizar la versión `Annotated` si es posible.
-
-///
-
-```Python hl_lines="7"
-{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip | Consejo
-
-Es preferible utilizar la versión `Annotated` si es posible.
-
-///
-
-```Python hl_lines="9"
-{!> ../../docs_src/cookie_params/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/cookie_params/tutorial001_an_py310.py hl[9]*}
/// note | "Detalles Técnicos"
From fe3922311f255a7ae0092c21e5c916b8d5ad0081 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 28 Oct 2024 10:34:51 +0000
Subject: [PATCH 309/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d2e40bf39..e381ba3b7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/fr/docs/tutorial/path-params-numeric-validations.md`. PR [#12601](https://github.com/fastapi/fastapi/pull/12601) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/fr/docs/tutorial/background-tasks.md`. PR [#12600](https://github.com/fastapi/fastapi/pull/12600) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/tutorial/encoder.md`. PR [#12597](https://github.com/fastapi/fastapi/pull/12597) by [@tonyjly](https://github.com/tonyjly).
* 📝 Update includes in `docs/en/docs/how-to/custom-docs-ui-assets.md`. PR [#12557](https://github.com/fastapi/fastapi/pull/12557) by [@philipokiokio](https://github.com/philipokiokio).
From 76126c45e7d03c87bf0f4ad928d5861e229e8b91 Mon Sep 17 00:00:00 2001
From: Mohamed Salman <mohamed.akj@gmail.com>
Date: Mon, 28 Oct 2024 16:05:06 +0530
Subject: [PATCH 310/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/dataclasses.md`=20(#12603)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/dataclasses.md | 12 +++---------
1 file changed, 3 insertions(+), 9 deletions(-)
diff --git a/docs/en/docs/advanced/dataclasses.md b/docs/en/docs/advanced/dataclasses.md
index efc07eab2..2936c6d5d 100644
--- a/docs/en/docs/advanced/dataclasses.md
+++ b/docs/en/docs/advanced/dataclasses.md
@@ -4,9 +4,7 @@ FastAPI is built on top of **Pydantic**, and I have been showing you how to use
But FastAPI also supports using <a href="https://docs.python.org/3/library/dataclasses.html" class="external-link" target="_blank">`dataclasses`</a> the same way:
-```Python hl_lines="1 7-12 19-20"
-{!../../docs_src/dataclasses/tutorial001.py!}
-```
+{* ../../docs_src/dataclasses/tutorial001.py hl[1,7:12,19:20] *}
This is still supported thanks to **Pydantic**, as it has <a href="https://docs.pydantic.dev/latest/concepts/dataclasses/#use-of-stdlib-dataclasses-with-basemodel" class="external-link" target="_blank">internal support for `dataclasses`</a>.
@@ -34,9 +32,7 @@ But if you have a bunch of dataclasses laying around, this is a nice trick to us
You can also use `dataclasses` in the `response_model` parameter:
-```Python hl_lines="1 7-13 19"
-{!../../docs_src/dataclasses/tutorial002.py!}
-```
+{* ../../docs_src/dataclasses/tutorial002.py hl[1,7:13,19] *}
The dataclass will be automatically converted to a Pydantic dataclass.
@@ -52,9 +48,7 @@ In some cases, you might still have to use Pydantic's version of `dataclasses`.
In that case, you can simply swap the standard `dataclasses` with `pydantic.dataclasses`, which is a drop-in replacement:
-```{ .python .annotate hl_lines="1 5 8-11 14-17 23-25 28" }
-{!../../docs_src/dataclasses/tutorial003.py!}
-```
+{* ../../docs_src/dataclasses/tutorial003.py hl[1,5,8:11,14:17,23:25,28] *}
1. We still import `field` from standard `dataclasses`.
From bcd55f8c099128a5c00783e418f9d8f96c3db1d3 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 28 Oct 2024 10:35:33 +0000
Subject: [PATCH 311/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e381ba3b7..8a44e27f6 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/es/docs/tutorial/cookie-params.md`. PR [#12602](https://github.com/fastapi/fastapi/pull/12602) by [@antonyare93](https://github.com/antonyare93).
* 📝 Update includes in `docs/fr/docs/tutorial/path-params-numeric-validations.md`. PR [#12601](https://github.com/fastapi/fastapi/pull/12601) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/fr/docs/tutorial/background-tasks.md`. PR [#12600](https://github.com/fastapi/fastapi/pull/12600) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/tutorial/encoder.md`. PR [#12597](https://github.com/fastapi/fastapi/pull/12597) by [@tonyjly](https://github.com/tonyjly).
From 2bd2ccbd1930d58fafe5acb1f2990f5c25b6653a Mon Sep 17 00:00:00 2001
From: Mohamed Salman <mohamed.akj@gmail.com>
Date: Mon, 28 Oct 2024 16:06:22 +0530
Subject: [PATCH 312/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/events.md`=20(#12604)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/events.md | 24 ++++++------------------
1 file changed, 6 insertions(+), 18 deletions(-)
diff --git a/docs/en/docs/advanced/events.md b/docs/en/docs/advanced/events.md
index efce492f4..19465d891 100644
--- a/docs/en/docs/advanced/events.md
+++ b/docs/en/docs/advanced/events.md
@@ -30,9 +30,7 @@ Let's start with an example and then see it in detail.
We create an async function `lifespan()` with `yield` like this:
-```Python hl_lines="16 19"
-{!../../docs_src/events/tutorial003.py!}
-```
+{* ../../docs_src/events/tutorial003.py hl[16,19] *}
Here we are simulating the expensive *startup* operation of loading the model by putting the (fake) model function in the dictionary with machine learning models before the `yield`. This code will be executed **before** the application **starts taking requests**, during the *startup*.
@@ -50,9 +48,7 @@ Maybe you need to start a new version, or you just got tired of running it. 🤷
The first thing to notice, is that we are defining an async function with `yield`. This is very similar to Dependencies with `yield`.
-```Python hl_lines="14-19"
-{!../../docs_src/events/tutorial003.py!}
-```
+{* ../../docs_src/events/tutorial003.py hl[14:19] *}
The first part of the function, before the `yield`, will be executed **before** the application starts.
@@ -64,9 +60,7 @@ If you check, the function is decorated with an `@asynccontextmanager`.
That converts the function into something called an "**async context manager**".
-```Python hl_lines="1 13"
-{!../../docs_src/events/tutorial003.py!}
-```
+{* ../../docs_src/events/tutorial003.py hl[1,13] *}
A **context manager** in Python is something that you can use in a `with` statement, for example, `open()` can be used as a context manager:
@@ -88,9 +82,7 @@ In our code example above, we don't use it directly, but we pass it to FastAPI f
The `lifespan` parameter of the `FastAPI` app takes an **async context manager**, so we can pass our new `lifespan` async context manager to it.
-```Python hl_lines="22"
-{!../../docs_src/events/tutorial003.py!}
-```
+{* ../../docs_src/events/tutorial003.py hl[22] *}
## Alternative Events (deprecated)
@@ -112,9 +104,7 @@ These functions can be declared with `async def` or normal `def`.
To add a function that should be run before the application starts, declare it with the event `"startup"`:
-```Python hl_lines="8"
-{!../../docs_src/events/tutorial001.py!}
-```
+{* ../../docs_src/events/tutorial001.py hl[8] *}
In this case, the `startup` event handler function will initialize the items "database" (just a `dict`) with some values.
@@ -126,9 +116,7 @@ And your application won't start receiving requests until all the `startup` even
To add a function that should be run when the application is shutting down, declare it with the event `"shutdown"`:
-```Python hl_lines="6"
-{!../../docs_src/events/tutorial002.py!}
-```
+{* ../../docs_src/events/tutorial002.py hl[6] *}
Here, the `shutdown` event handler function will write a text line `"Application shutdown"` to a file `log.txt`.
From 3ea198f23c68eacd5b9d537b8114eb381b3dd426 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 28 Oct 2024 10:37:16 +0000
Subject: [PATCH 313/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8a44e27f6..0c11a9dd7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/dataclasses.md`. PR [#12603](https://github.com/fastapi/fastapi/pull/12603) by [@salmantec](https://github.com/salmantec).
* 📝 Update includes in `docs/es/docs/tutorial/cookie-params.md`. PR [#12602](https://github.com/fastapi/fastapi/pull/12602) by [@antonyare93](https://github.com/antonyare93).
* 📝 Update includes in `docs/fr/docs/tutorial/path-params-numeric-validations.md`. PR [#12601](https://github.com/fastapi/fastapi/pull/12601) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/fr/docs/tutorial/background-tasks.md`. PR [#12600](https://github.com/fastapi/fastapi/pull/12600) by [@kantandane](https://github.com/kantandane).
From 8a4652d8b4ba1b558fbbee7db1e0e1bec4e64594 Mon Sep 17 00:00:00 2001
From: Mohamed Salman <mohamed.akj@gmail.com>
Date: Mon, 28 Oct 2024 16:08:23 +0530
Subject: [PATCH 314/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/openapi-webhooks.md`=20(#12605)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/openapi-webhooks.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
diff --git a/docs/en/docs/advanced/openapi-webhooks.md b/docs/en/docs/advanced/openapi-webhooks.md
index eaaa48a37..97aaa41af 100644
--- a/docs/en/docs/advanced/openapi-webhooks.md
+++ b/docs/en/docs/advanced/openapi-webhooks.md
@@ -32,9 +32,7 @@ Webhooks are available in OpenAPI 3.1.0 and above, supported by FastAPI `0.99.0`
When you create a **FastAPI** application, there is a `webhooks` attribute that you can use to define *webhooks*, the same way you would define *path operations*, for example with `@app.webhooks.post()`.
-```Python hl_lines="9-13 36-53"
-{!../../docs_src/openapi_webhooks/tutorial001.py!}
-```
+{* ../../docs_src/openapi_webhooks/tutorial001.py hl[9:13,36:53] *}
The webhooks that you define will end up in the **OpenAPI** schema and the automatic **docs UI**.
From 794d4b3a9b7b391f6b7bbcf6044fed7af31475fe Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 28 Oct 2024 10:39:28 +0000
Subject: [PATCH 315/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 0c11a9dd7..3fc4b6baf 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/events.md`. PR [#12604](https://github.com/fastapi/fastapi/pull/12604) by [@salmantec](https://github.com/salmantec).
* 📝 Update includes in `docs/en/docs/advanced/dataclasses.md`. PR [#12603](https://github.com/fastapi/fastapi/pull/12603) by [@salmantec](https://github.com/salmantec).
* 📝 Update includes in `docs/es/docs/tutorial/cookie-params.md`. PR [#12602](https://github.com/fastapi/fastapi/pull/12602) by [@antonyare93](https://github.com/antonyare93).
* 📝 Update includes in `docs/fr/docs/tutorial/path-params-numeric-validations.md`. PR [#12601](https://github.com/fastapi/fastapi/pull/12601) by [@kantandane](https://github.com/kantandane).
From 86d8e729c8f39c6ae6816ffc1d54533bd0f73799 Mon Sep 17 00:00:00 2001
From: Rabin Lama Dong <rrabin.lama.dong@gmail.com>
Date: Mon, 28 Oct 2024 14:42:34 +0400
Subject: [PATCH 316/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/how-to/custom-docs-ui-assets.md`=20(#12623)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/how-to/custom-docs-ui-assets.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
diff --git a/docs/en/docs/how-to/custom-docs-ui-assets.md b/docs/en/docs/how-to/custom-docs-ui-assets.md
index abcccb499..f717c98fa 100644
--- a/docs/en/docs/how-to/custom-docs-ui-assets.md
+++ b/docs/en/docs/how-to/custom-docs-ui-assets.md
@@ -118,9 +118,7 @@ After that, your file structure could look like:
* Import `StaticFiles`.
* "Mount" a `StaticFiles()` instance in a specific path.
-```Python hl_lines="7 11"
-{!../../docs_src/custom_docs_ui/tutorial002.py!}
-```
+{* ../../docs_src/custom_docs_ui/tutorial002.py hl[7,11] *}
### Test the static files
From 70869200bdbb5952d296356f18848ec5eb301cce Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 28 Oct 2024 10:42:48 +0000
Subject: [PATCH 317/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3fc4b6baf..f8bad8450 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/openapi-webhooks.md`. PR [#12605](https://github.com/fastapi/fastapi/pull/12605) by [@salmantec](https://github.com/salmantec).
* 📝 Update includes in `docs/en/docs/advanced/events.md`. PR [#12604](https://github.com/fastapi/fastapi/pull/12604) by [@salmantec](https://github.com/salmantec).
* 📝 Update includes in `docs/en/docs/advanced/dataclasses.md`. PR [#12603](https://github.com/fastapi/fastapi/pull/12603) by [@salmantec](https://github.com/salmantec).
* 📝 Update includes in `docs/es/docs/tutorial/cookie-params.md`. PR [#12602](https://github.com/fastapi/fastapi/pull/12602) by [@antonyare93](https://github.com/antonyare93).
From f6a6366e42fa5b0c00991582e8f64a3c50100aa9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 28 Oct 2024 10:50:28 +0000
Subject: [PATCH 318/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f8bad8450..1d8910635 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/how-to/custom-docs-ui-assets.md`. PR [#12623](https://github.com/fastapi/fastapi/pull/12623) by [@rabinlamadong](https://github.com/rabinlamadong).
* 📝 Update includes in `docs/en/docs/advanced/openapi-webhooks.md`. PR [#12605](https://github.com/fastapi/fastapi/pull/12605) by [@salmantec](https://github.com/salmantec).
* 📝 Update includes in `docs/en/docs/advanced/events.md`. PR [#12604](https://github.com/fastapi/fastapi/pull/12604) by [@salmantec](https://github.com/salmantec).
* 📝 Update includes in `docs/en/docs/advanced/dataclasses.md`. PR [#12603](https://github.com/fastapi/fastapi/pull/12603) by [@salmantec](https://github.com/salmantec).
From 26702a65253d60980828bcbf648e1363d3684195 Mon Sep 17 00:00:00 2001
From: Quentin Takeda <quentin.vadon@gmail.com>
Date: Mon, 28 Oct 2024 12:13:18 +0100
Subject: [PATCH 319/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/response-status-code.md`=20(#12620)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/response-status-code.md | 12 +++---------
1 file changed, 3 insertions(+), 9 deletions(-)
diff --git a/docs/en/docs/tutorial/response-status-code.md b/docs/en/docs/tutorial/response-status-code.md
index 73af62aed..a32faa40b 100644
--- a/docs/en/docs/tutorial/response-status-code.md
+++ b/docs/en/docs/tutorial/response-status-code.md
@@ -8,9 +8,7 @@ The same way you can specify a response model, you can also declare the HTTP sta
* `@app.delete()`
* etc.
-```Python hl_lines="6"
-{!../../docs_src/response_status_code/tutorial001.py!}
-```
+{* ../../docs_src/response_status_code/tutorial001.py hl[6] *}
/// note
@@ -76,9 +74,7 @@ To know more about each status code and which code is for what, check the <a hre
Let's see the previous example again:
-```Python hl_lines="6"
-{!../../docs_src/response_status_code/tutorial001.py!}
-```
+{* ../../docs_src/response_status_code/tutorial001.py hl[6] *}
`201` is the status code for "Created".
@@ -86,9 +82,7 @@ But you don't have to memorize what each of these codes mean.
You can use the convenience variables from `fastapi.status`.
-```Python hl_lines="1 6"
-{!../../docs_src/response_status_code/tutorial002.py!}
-```
+{* ../../docs_src/response_status_code/tutorial002.py hl[1,6] *}
They are just a convenience, they hold the same number, but that way you can use the editor's autocomplete to find them:
From efb99a2bb4456fde97c1e3de06d0716f9874b405 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 28 Oct 2024 11:13:38 +0000
Subject: [PATCH 320/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 1d8910635..1107ec7bf 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/response-status-code.md`. PR [#12620](https://github.com/fastapi/fastapi/pull/12620) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/how-to/custom-docs-ui-assets.md`. PR [#12623](https://github.com/fastapi/fastapi/pull/12623) by [@rabinlamadong](https://github.com/rabinlamadong).
* 📝 Update includes in `docs/en/docs/advanced/openapi-webhooks.md`. PR [#12605](https://github.com/fastapi/fastapi/pull/12605) by [@salmantec](https://github.com/salmantec).
* 📝 Update includes in `docs/en/docs/advanced/events.md`. PR [#12604](https://github.com/fastapi/fastapi/pull/12604) by [@salmantec](https://github.com/salmantec).
From cb2c56008d0792b9e1f0d21ea19c8c8d7ebb0e05 Mon Sep 17 00:00:00 2001
From: Abdul Hadi Bharara <32545366+bharara@users.noreply.github.com>
Date: Mon, 28 Oct 2024 16:18:17 +0500
Subject: [PATCH 321/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/dependencies/index.md`=20(#12615)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/dependencies/index.md | 180 +-------------------
1 file changed, 4 insertions(+), 176 deletions(-)
diff --git a/docs/en/docs/tutorial/dependencies/index.md b/docs/en/docs/tutorial/dependencies/index.md
index b50edb98e..596ce1599 100644
--- a/docs/en/docs/tutorial/dependencies/index.md
+++ b/docs/en/docs/tutorial/dependencies/index.md
@@ -31,57 +31,7 @@ Let's first focus on the dependency.
It is just a function that can take all the same parameters that a *path operation function* can take:
-//// tab | Python 3.10+
-
-```Python hl_lines="8-9"
-{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="8-11"
-{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9-12"
-{!> ../../docs_src/dependencies/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="6-7"
-{!> ../../docs_src/dependencies/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="8-11"
-{!> ../../docs_src/dependencies/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/dependencies/tutorial001_an_py310.py hl[8:9] *}
That's it.
@@ -113,113 +63,13 @@ Make sure you [Upgrade the FastAPI version](../../deployment/versions.md#upgradi
### Import `Depends`
-//// tab | Python 3.10+
-
-```Python hl_lines="3"
-{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="3"
-{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="3"
-{!> ../../docs_src/dependencies/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="1"
-{!> ../../docs_src/dependencies/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="3"
-{!> ../../docs_src/dependencies/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/dependencies/tutorial001_an_py310.py hl[3] *}
### Declare the dependency, in the "dependant"
The same way you use `Body`, `Query`, etc. with your *path operation function* parameters, use `Depends` with a new parameter:
-//// tab | Python 3.10+
-
-```Python hl_lines="13 18"
-{!> ../../docs_src/dependencies/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="15 20"
-{!> ../../docs_src/dependencies/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="16 21"
-{!> ../../docs_src/dependencies/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="11 16"
-{!> ../../docs_src/dependencies/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="15 20"
-{!> ../../docs_src/dependencies/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/dependencies/tutorial001_an_py310.py hl[13,18] *}
Although you use `Depends` in the parameters of your function the same way you use `Body`, `Query`, etc, `Depends` works a bit differently.
@@ -276,29 +126,7 @@ commons: Annotated[dict, Depends(common_parameters)]
But because we are using `Annotated`, we can store that `Annotated` value in a variable and use it in multiple places:
-//// tab | Python 3.10+
-
-```Python hl_lines="12 16 21"
-{!> ../../docs_src/dependencies/tutorial001_02_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="14 18 23"
-{!> ../../docs_src/dependencies/tutorial001_02_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="15 19 24"
-{!> ../../docs_src/dependencies/tutorial001_02_an.py!}
-```
-
-////
+{* ../../docs_src/dependencies/tutorial001_02_an_py310.py hl[12,16,21] *}
/// tip
From 38bb9f934ba23e6545452fbfe74821f4a0446319 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 28 Oct 2024 11:19:26 +0000
Subject: [PATCH 322/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 1107ec7bf..c49904533 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/dependencies/index.md`. PR [#12615](https://github.com/fastapi/fastapi/pull/12615) by [@bharara](https://github.com/bharara).
* 📝 Update includes in `docs/en/docs/tutorial/response-status-code.md`. PR [#12620](https://github.com/fastapi/fastapi/pull/12620) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/how-to/custom-docs-ui-assets.md`. PR [#12623](https://github.com/fastapi/fastapi/pull/12623) by [@rabinlamadong](https://github.com/rabinlamadong).
* 📝 Update includes in `docs/en/docs/advanced/openapi-webhooks.md`. PR [#12605](https://github.com/fastapi/fastapi/pull/12605) by [@salmantec](https://github.com/salmantec).
From ec9976f7a6bb27b11e68ce2e44fb64acaaed5bbb Mon Sep 17 00:00:00 2001
From: Rabin Lama Dong <rrabin.lama.dong@gmail.com>
Date: Mon, 28 Oct 2024 15:21:54 +0400
Subject: [PATCH 323/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/how-to/conditional-openapi.md`=20(#12624)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/how-to/conditional-openapi.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
diff --git a/docs/en/docs/how-to/conditional-openapi.md b/docs/en/docs/how-to/conditional-openapi.md
index 6cd0385a2..bd6cad9a8 100644
--- a/docs/en/docs/how-to/conditional-openapi.md
+++ b/docs/en/docs/how-to/conditional-openapi.md
@@ -29,9 +29,7 @@ You can easily use the same Pydantic settings to configure your generated OpenAP
For example:
-```Python hl_lines="6 11"
-{!../../docs_src/conditional_openapi/tutorial001.py!}
-```
+{* ../../docs_src/conditional_openapi/tutorial001.py hl[6,11] *}
Here we declare the setting `openapi_url` with the same default of `"/openapi.json"`.
From f2b633ebeeb261fc6809a76925211ba4a14943ea Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 28 Oct 2024 11:24:36 +0000
Subject: [PATCH 324/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c49904533..c0c0721d5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/how-to/conditional-openapi.md`. PR [#12624](https://github.com/fastapi/fastapi/pull/12624) by [@rabinlamadong](https://github.com/rabinlamadong).
* 📝 Update includes in `docs/en/docs/tutorial/dependencies/index.md`. PR [#12615](https://github.com/fastapi/fastapi/pull/12615) by [@bharara](https://github.com/bharara).
* 📝 Update includes in `docs/en/docs/tutorial/response-status-code.md`. PR [#12620](https://github.com/fastapi/fastapi/pull/12620) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/how-to/custom-docs-ui-assets.md`. PR [#12623](https://github.com/fastapi/fastapi/pull/12623) by [@rabinlamadong](https://github.com/rabinlamadong).
From 5c3326941970d181598704ae3d7c48a4873ab2cb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B9=80=EC=86=8C=EC=97=B0?=
<54532519+dhdld@users.noreply.github.com>
Date: Mon, 28 Oct 2024 20:29:32 +0900
Subject: [PATCH 325/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/fastapi-cli.md`=20(#12515)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/fastapi-cli.md | 83 +++++++++++++++++++++++++++++++++++++
1 file changed, 83 insertions(+)
create mode 100644 docs/ko/docs/fastapi-cli.md
diff --git a/docs/ko/docs/fastapi-cli.md b/docs/ko/docs/fastapi-cli.md
new file mode 100644
index 000000000..3a976af36
--- /dev/null
+++ b/docs/ko/docs/fastapi-cli.md
@@ -0,0 +1,83 @@
+# FastAPI CLI
+
+**FastAPI CLI**는 FastAPI 애플리케이션을 실행하고, 프로젝트를 관리하는 등 다양한 작업을 수행할 수 있는 커맨드 라인 프로그램입니다.
+
+FastAPI를 설치할 때 (예: `pip install "fastapi[standard]"` 명령어를 사용할 경우), `fastapi-cli`라는 패키지가 포함됩니다. 이 패키지는 터미널에서 사용할 수 있는 `fastapi` 명령어를 제공합니다.
+
+개발용으로 FastAPI 애플리케이션을 실행하려면 다음과 같이 `fastapi dev` 명령어를 사용할 수 있습니다:
+
+<div class="termy">
+
+```console
+$ <font color="#4E9A06">fastapi</font> dev <u style="text-decoration-style:single">main.py</u>
+<font color="#3465A4">INFO </font> Using path <font color="#3465A4">main.py</font>
+<font color="#3465A4">INFO </font> Resolved absolute path <font color="#75507B">/home/user/code/awesomeapp/</font><font color="#AD7FA8">main.py</font>
+<font color="#3465A4">INFO </font> Searching for package file structure from directories with <font color="#3465A4">__init__.py</font> files
+<font color="#3465A4">INFO </font> Importing from <font color="#75507B">/home/user/code/</font><font color="#AD7FA8">awesomeapp</font>
+
+ ╭─ <font color="#8AE234"><b>Python module file</b></font> ─╮
+ │ │
+ │ 🐍 main.py │
+ │ │
+ ╰──────────────────────╯
+
+<font color="#3465A4">INFO </font> Importing module <font color="#4E9A06">main</font>
+<font color="#3465A4">INFO </font> Found importable FastAPI app
+
+ ╭─ <font color="#8AE234"><b>Importable FastAPI app</b></font> ─╮
+ │ │
+ │ <span style="background-color:#272822"><font color="#FF4689">from</font></span><span style="background-color:#272822"><font color="#F8F8F2"> main </font></span><span style="background-color:#272822"><font color="#FF4689">import</font></span><span style="background-color:#272822"><font color="#F8F8F2"> app</font></span><span style="background-color:#272822"> </span> │
+ │ │
+ ╰──────────────────────────╯
+
+<font color="#3465A4">INFO </font> Using import string <font color="#8AE234"><b>main:app</b></font>
+
+ <span style="background-color:#C4A000"><font color="#2E3436">╭────────── FastAPI CLI - Development mode ───────────╮</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ Serving at: http://127.0.0.1:8000 │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ API docs: http://127.0.0.1:8000/docs │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ Running in development mode, for production use: │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ </font></span><span style="background-color:#C4A000"><font color="#555753"><b>fastapi run</b></font></span><span style="background-color:#C4A000"><font color="#2E3436"> │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">│ │</font></span>
+ <span style="background-color:#C4A000"><font color="#2E3436">╰─────────────────────────────────────────────────────╯</font></span>
+
+<font color="#4E9A06">INFO</font>: Will watch for changes in these directories: ['/home/user/code/awesomeapp']
+<font color="#4E9A06">INFO</font>: Uvicorn running on <b>http://127.0.0.1:8000</b> (Press CTRL+C to quit)
+<font color="#4E9A06">INFO</font>: Started reloader process [<font color="#34E2E2"><b>2265862</b></font>] using <font color="#34E2E2"><b>WatchFiles</b></font>
+<font color="#4E9A06">INFO</font>: Started server process [<font color="#06989A">2265873</font>]
+<font color="#4E9A06">INFO</font>: Waiting for application startup.
+<font color="#4E9A06">INFO</font>: Application startup complete.
+```
+
+</div>
+
+`fastapi`라고 불리는 명령어 프로그램은 **FastAPI CLI**입니다.
+
+FastAPI CLI는 Python 프로그램의 경로(예: `main.py`)를 인수로 받아, `FastAPI` 인스턴스(일반적으로 `app`으로 명명)를 자동으로 감지하고 올바른 임포트 과정을 결정한 후 이를 실행합니다.
+
+프로덕션 환경에서는 `fastapi run` 명령어를 사용합니다. 🚀
+
+내부적으로, **FastAPI CLI**는 고성능의, 프로덕션에 적합한, ASGI 서버인 <a href="https://www.uvicorn.org" class="external-link" target="_blank">Uvicorn</a>을 사용합니다. 😎
+
+## `fastapi dev`
+
+`fastapi dev` 명령을 실행하면 개발 모드가 시작됩니다.
+
+기본적으로 **자동 재시작(auto-reload)** 기능이 활성화되어, 코드에 변경이 생기면 서버를 자동으로 다시 시작합니다. 하지만 이 기능은 리소스를 많이 사용하며, 비활성화했을 때보다 안정성이 떨어질 수 있습니다. 따라서 개발 환경에서만 사용하는 것이 좋습니다. 또한, 서버는 컴퓨터가 자체적으로 통신할 수 있는 IP 주소(`localhost`)인 `127.0.0.1`에서 연결을 대기합니다.
+
+## `fastapi run`
+
+`fastapi run` 명령을 실행하면 기본적으로 프로덕션 모드로 FastAPI가 시작됩니다.
+
+기본적으로 **자동 재시작(auto-reload)** 기능이 비활성화되어 있습니다. 또한, 사용 가능한 모든 IP 주소인 `0.0.0.0`에서 연결을 대기하므로 해당 컴퓨터와 통신할 수 있는 모든 사람이 공개적으로 액세스할 수 있습니다. 이는 일반적으로 컨테이너와 같은 프로덕션 환경에서 실행하는 방법입니다.
+
+애플리케이션을 배포하는 방식에 따라 다르지만, 대부분 "종료 프록시(termination proxy)"를 활용해 HTTPS를 처리하는 것이 좋습니다. 배포 서비스 제공자가 이 작업을 대신 처리해줄 수도 있고, 직접 설정해야 할 수도 있습니다.
+
+/// tip
+
+자세한 내용은 [deployment documentation](deployment/index.md){.internal-link target=\_blank}에서 확인할 수 있습니다.
+
+///
From 8669a92dac5ec065f144705bf682226362277c1c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 28 Oct 2024 11:31:18 +0000
Subject: [PATCH 326/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c0c0721d5..84ffb2e8d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -26,6 +26,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `docs/ko/docs/fastapi-cli.md`. PR [#12515](https://github.com/fastapi/fastapi/pull/12515) by [@dhdld](https://github.com/dhdld).
* 🌐 Add Korean Translation for `docs/ko/docs/advanced/response-change-status-code.md`. PR [#12547](https://github.com/fastapi/fastapi/pull/12547) by [@9zimin9](https://github.com/9zimin9).
## 0.115.4
From 93bf4c9c2dd77f523f8d2af4e9bcda7d310a06f3 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
<66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 28 Oct 2024 20:31:44 +0000
Subject: [PATCH 327/504] =?UTF-8?q?=E2=AC=86=20[pre-commit.ci]=20pre-commi?=
=?UTF-8?q?t=20autoupdate=20(#12707)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
updates:
- [github.com/astral-sh/ruff-pre-commit: v0.7.0 → v0.7.1](https://github.com/astral-sh/ruff-pre-commit/compare/v0.7.0...v0.7.1)
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
.pre-commit-config.yaml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 779018ff9..84bec0421 100644
--- a/.pre-commit-config.yaml
+++ b/.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.7.0
+ rev: v0.7.1
hooks:
- id: ruff
args:
From e1d724ab926ebaa8541f8d76bde7e025e7a52f77 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 28 Oct 2024 20:32:12 +0000
Subject: [PATCH 328/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 84ffb2e8d..e7bea3c76 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -29,6 +29,10 @@ hide:
* 🌐 Add Korean translation for `docs/ko/docs/fastapi-cli.md`. PR [#12515](https://github.com/fastapi/fastapi/pull/12515) by [@dhdld](https://github.com/dhdld).
* 🌐 Add Korean Translation for `docs/ko/docs/advanced/response-change-status-code.md`. PR [#12547](https://github.com/fastapi/fastapi/pull/12547) by [@9zimin9](https://github.com/9zimin9).
+### Internal
+
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12707](https://github.com/fastapi/fastapi/pull/12707) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+
## 0.115.4
### Refactors
From 3f822818b25c042280cbecce1968ca11006ba8e4 Mon Sep 17 00:00:00 2001
From: kim-sangah <kimsangah_@naver.com>
Date: Tue, 29 Oct 2024 19:32:45 +0900
Subject: [PATCH 329/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20Translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/advanced/response-cookies.md`=20(#1254?=
=?UTF-8?q?6)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/advanced/response-cookies.md | 53 +++++++++++++++++++++++
1 file changed, 53 insertions(+)
create mode 100644 docs/ko/docs/advanced/response-cookies.md
diff --git a/docs/ko/docs/advanced/response-cookies.md b/docs/ko/docs/advanced/response-cookies.md
new file mode 100644
index 000000000..3f87b320a
--- /dev/null
+++ b/docs/ko/docs/advanced/response-cookies.md
@@ -0,0 +1,53 @@
+# 응답 쿠키
+
+## `Response` 매개변수 사용하기
+
+*경로 작동 함수*에서 `Response` 타입의 매개변수를 선언할 수 있습니다.
+
+그런 다음 해당 *임시* 응답 객체에서 쿠키를 설정할 수 있습니다.
+
+```Python hl_lines="1 8-9"
+{!../../docs_src/response_cookies/tutorial002.py!}
+```
+
+그런 다음 필요한 객체(`dict`, 데이터베이스 모델 등)를 반환할 수 있습니다.
+
+그리고 `response_model`을 선언했다면 반환한 객체를 거르고 변환하는 데 여전히 사용됩니다.
+
+**FastAPI**는 그 *임시* 응답에서 쿠키(또한 헤더 및 상태 코드)를 추출하고, 반환된 값이 포함된 최종 응답에 이를 넣습니다. 이 값은 `response_model`로 걸러지게 됩니다.
+
+또한 의존관계에서 `Response` 매개변수를 선언하고, 해당 의존성에서 쿠키(및 헤더)를 설정할 수도 있습니다.
+
+## `Response`를 직접 반환하기
+
+코드에서 `Response`를 직접 반환할 때도 쿠키를 생성할 수 있습니다.
+
+이를 위해 [Response를 직접 반환하기](response-directly.md){.internal-link target=_blank}에서 설명한 대로 응답을 생성할 수 있습니다.
+
+그런 다음 쿠키를 설정하고 반환하면 됩니다:
+```Python hl_lines="1 18"
+{!../../docs_src/response_directly/tutorial002.py!}
+```
+/// tip
+
+`Response` 매개변수를 사용하지 않고 응답을 직접 반환하는 경우, FastAPI는 이를 직접 반환한다는 점에 유의하세요.
+
+따라서 데이터가 올바른 유형인지 확인해야 합니다. 예: `JSONResponse`를 반환하는 경우, JSON과 호환되는지 확인하세요.
+
+또한 `response_model`로 걸러져야 할 데이터가 전달되지 않도록 확인하세요.
+
+///
+
+### 추가 정보
+
+/// note | "기술적 세부사항"
+
+`from starlette.responses import Response` 또는 `from starlette.responses import JSONResponse`를 사용할 수도 있습니다.
+
+**FastAPI**는 개발자의 편의를 위해 `fastapi.responses`로 동일한 `starlette.responses`를 제공합니다. 그러나 대부분의 응답은 Starlette에서 직접 제공됩니다.
+
+또한 `Response`는 헤더와 쿠키를 설정하는 데 자주 사용되므로, **FastAPI**는 이를 `fastapi.Response`로도 제공합니다.
+
+///
+
+사용 가능한 모든 매개변수와 옵션은 <a href="https://www.starlette.io/responses/#set-cookie" class="external-link" target="_blank">Starlette 문서</a>에서 확인할 수 있습니다.
From 3f3637ba73d0e15ce2d57910697aed7f152316f6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 29 Oct 2024 10:33:16 +0000
Subject: [PATCH 330/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e7bea3c76..e547d8b58 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -26,6 +26,7 @@ hide:
### Translations
+* 🌐 Add Korean Translation for `docs/ko/docs/advanced/response-cookies.md`. PR [#12546](https://github.com/fastapi/fastapi/pull/12546) by [@kim-sangah](https://github.com/kim-sangah).
* 🌐 Add Korean translation for `docs/ko/docs/fastapi-cli.md`. PR [#12515](https://github.com/fastapi/fastapi/pull/12515) by [@dhdld](https://github.com/dhdld).
* 🌐 Add Korean Translation for `docs/ko/docs/advanced/response-change-status-code.md`. PR [#12547](https://github.com/fastapi/fastapi/pull/12547) by [@9zimin9](https://github.com/9zimin9).
From 46a085ebe7dd24129023a197f2eff6e9e8089afe Mon Sep 17 00:00:00 2001
From: LKY <74170199+kwang1215@users.noreply.github.com>
Date: Tue, 29 Oct 2024 19:36:06 +0900
Subject: [PATCH 331/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/tutorial/metadata.md`=20(#12541)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/tutorial/metadata.md | 131 ++++++++++++++++++++++++++++++
1 file changed, 131 insertions(+)
create mode 100644 docs/ko/docs/tutorial/metadata.md
diff --git a/docs/ko/docs/tutorial/metadata.md b/docs/ko/docs/tutorial/metadata.md
new file mode 100644
index 000000000..87531152c
--- /dev/null
+++ b/docs/ko/docs/tutorial/metadata.md
@@ -0,0 +1,131 @@
+
+# 메타데이터 및 문서화 URL
+
+**FastAPI** 응용 프로그램에서 다양한 메타데이터 구성을 사용자 맞춤 설정할 수 있습니다.
+
+## API에 대한 메타데이터
+
+OpenAPI 명세 및 자동화된 API 문서 UI에 사용되는 다음 필드를 설정할 수 있습니다:
+
+| 매개변수 | 타입 | 설명 |
+|----------|------|-------|
+| `title` | `str` | API의 제목입니다. |
+| `summary` | `str` | API에 대한 짧은 요약입니다. <small>OpenAPI 3.1.0, FastAPI 0.99.0부터 사용 가능</small> |
+| `description` | `str` | API에 대한 짧은 설명입니다. 마크다운을 사용할 수 있습니다. |
+| `version` | `string` | API의 버전입니다. OpenAPI의 버전이 아닌, 여러분의 애플리케이션의 버전을 나타냅니다. 예: `2.5.0` |
+| `terms_of_service` | `str` | API 이용 약관의 URL입니다. 제공하는 경우 URL 형식이어야 합니다. |
+| `contact` | `dict` | 노출된 API에 대한 연락처 정보입니다. 여러 필드를 포함할 수 있습니다. <details><summary><code>contact</code> 필드</summary><table><thead><tr><th>매개변수</th><th>타입</th><th>설명</th></tr></thead><tbody><tr><td><code>name</code></td><td><code>str</code></td><td>연락처 인물/조직의 식별명입니다.</td></tr><tr><td><code>url</code></td><td><code>str</code></td><td>연락처 정보가 담긴 URL입니다. URL 형식이어야 합니다.</td></tr><tr><td><code>email</code></td><td><code>str</code></td><td>연락처 인물/조직의 이메일 주소입니다. 이메일 주소 형식이어야 합니다.</td></tr></tbody></table></details> |
+| `license_info` | `dict` | 노출된 API의 라이선스 정보입니다. 여러 필드를 포함할 수 있습니다. <details><summary><code>license_info</code> 필드</summary><table><thead><tr><th>매개변수</th><th>타입</th><th>설명</th></tr></thead><tbody><tr><td><code>name</code></td><td><code>str</code></td><td><strong>필수</strong> (<code>license_info</code>가 설정된 경우). API에 사용된 라이선스 이름입니다.</td></tr><tr><td><code>identifier</code></td><td><code>str</code></td><td>API에 대한 <a href="https://spdx.org/licenses/" class="external-link" target="_blank">SPDX</a> 라이선스 표현입니다. <code>identifier</code> 필드는 <code>url</code> 필드와 상호 배타적입니다. <small>OpenAPI 3.1.0, FastAPI 0.99.0부터 사용 가능</small></td></tr><tr><td><code>url</code></td><td><code>str</code></td><td>API에 사용된 라이선스의 URL입니다. URL 형식이어야 합니다.</td></tr></tbody></table></details> |
+
+다음과 같이 설정할 수 있습니다:
+
+```Python hl_lines="3-16 19-32"
+{!../../docs_src/metadata/tutorial001.py!}
+```
+
+/// tip
+
+`description` 필드에 마크다운을 사용할 수 있으며, 출력에서 렌더링됩니다.
+
+///
+
+이 구성을 사용하면 문서 자동화(로 생성된) API 문서는 다음과 같이 보입니다:
+
+<img src="/img/tutorial/metadata/image01.png">
+
+## 라이선스 식별자
+
+OpenAPI 3.1.0 및 FastAPI 0.99.0부터 `license_info`에 `identifier`를 URL 대신 설정할 수 있습니다.
+
+예:
+
+```Python hl_lines="31"
+{!../../docs_src/metadata/tutorial001_1.py!}
+```
+
+## 태그에 대한 메타데이터
+
+`openapi_tags` 매개변수를 사용하여 경로 작동을 그룹화하는 데 사용되는 태그에 추가 메타데이터를 추가할 수 있습니다.
+
+리스트는 각 태그에 대해 하나의 딕셔너리를 포함해야 합니다.
+
+각 딕셔너리에는 다음이 포함될 수 있습니다:
+
+* `name` (**필수**): `tags` 매개변수에서 *경로 작동*과 `APIRouter`에 사용된 태그 이름과 동일한 `str`입니다.
+* `description`: 태그에 대한 간단한 설명을 담은 `str`입니다. 마크다운을 사용할 수 있으며 문서 UI에 표시됩니다.
+* `externalDocs`: 외부 문서를 설명하는 `dict`이며:
+ * `description`: 외부 문서에 대한 간단한 설명을 담은 `str`입니다.
+ * `url` (**필수**): 외부 문서의 URL을 담은 `str`입니다.
+
+### 태그에 대한 메타데이터 생성
+
+`users` 및 `items`에 대한 태그 예시와 함께 메타데이터를 생성하고 이를 `openapi_tags` 매개변수로 전달해 보겠습니다:
+
+```Python hl_lines="3-16 18"
+{!../../docs_src/metadata/tutorial004.py!}
+```
+
+설명 안에 마크다운을 사용할 수 있습니다. 예를 들어 "login"은 굵게(**login**) 표시되고, "fancy"는 기울임꼴(_fancy_)로 표시됩니다.
+
+/// tip
+
+사용 중인 모든 태그에 메타데이터를 추가할 필요는 없습니다.
+
+///
+
+### 태그 사용
+
+`tags` 매개변수를 *경로 작동* 및 `APIRouter`와 함께 사용하여 태그에 할당할 수 있습니다:
+
+```Python hl_lines="21 26"
+{!../../docs_src/metadata/tutorial004.py!}
+```
+
+/// info
+
+태그에 대한 자세한 내용은 [경로 작동 구성](path-operation-configuration.md#tags){.internal-link target=_blank}에서 읽어보세요.
+
+///
+
+### 문서 확인
+
+이제 문서를 확인하면 모든 추가 메타데이터가 표시됩니다:
+
+<img src="/img/tutorial/metadata/image02.png">
+
+### 태그 순서
+
+각 태그 메타데이터 딕셔너리의 순서는 문서 UI에 표시되는 순서를 정의합니다.
+
+예를 들어, 알파벳 순서상 `users`는 `items` 뒤에 오지만, 우리는 `users` 메타데이터를 리스트의 첫 번째 딕셔너리로 추가했기 때문에 먼저 표시됩니다.
+
+## OpenAPI URL
+
+OpenAPI 구조는 기본적으로 `/openapi.json`에서 제공됩니다.
+
+`openapi_url` 매개변수를 통해 이를 설정할 수 있습니다.
+
+예를 들어, 이를 `/api/v1/openapi.json`에 제공하도록 설정하려면:
+
+```Python hl_lines="3"
+{!../../docs_src/metadata/tutorial002.py!}
+```
+
+OpenAPI 구조를 완전히 비활성화하려면 `openapi_url=None`으로 설정할 수 있으며, 이를 사용하여 문서화 사용자 인터페이스도 비활성화됩니다.
+
+## 문서화 URL
+
+포함된 두 가지 문서화 사용자 인터페이스를 설정할 수 있습니다:
+
+* **Swagger UI**: `/docs`에서 제공됩니다.
+ * `docs_url` 매개변수로 URL을 설정할 수 있습니다.
+ * `docs_url=None`으로 설정하여 비활성화할 수 있습니다.
+* **ReDoc**: `/redoc`에서 제공됩니다.
+ * `redoc_url` 매개변수로 URL을 설정할 수 있습니다.
+ * `redoc_url=None`으로 설정하여 비활성화할 수 있습니다.
+
+예를 들어, Swagger UI를 `/documentation`에서 제공하고 ReDoc을 비활성화하려면:
+
+```Python hl_lines="3"
+{!../../docs_src/metadata/tutorial003.py!}
+```
From 6e07910cc4112bea61473fe8f69a272fdeb5e526 Mon Sep 17 00:00:00 2001
From: Lincoln Melo <81188429+LinkolnR@users.noreply.github.com>
Date: Tue, 29 Oct 2024 07:36:14 -0300
Subject: [PATCH 332/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/metadata.md`=20(#12538)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/tutorial/metadata.md | 132 ++++++++++++++++++++++++++++++
1 file changed, 132 insertions(+)
create mode 100644 docs/pt/docs/tutorial/metadata.md
diff --git a/docs/pt/docs/tutorial/metadata.md b/docs/pt/docs/tutorial/metadata.md
new file mode 100644
index 000000000..5db2882b9
--- /dev/null
+++ b/docs/pt/docs/tutorial/metadata.md
@@ -0,0 +1,132 @@
+# Metadados e Urls de Documentos
+
+Você pode personalizar várias configurações de metadados na sua aplicação **FastAPI**.
+
+## Metadados para API
+
+Você pode definir os seguintes campos que são usados na especificação OpenAPI e nas interfaces automáticas de documentação da API:
+
+| Parâmetro | Tipo | Descrição |
+|------------|------|-------------|
+| `title` | `str` | O título da API. |
+| `summary` | `str` | Um breve resumo da API. <small>Disponível desde OpenAPI 3.1.0, FastAPI 0.99.0.</small> |
+| `description` | `str` | Uma breve descrição da API. Pode usar Markdown. |
+| `version` | `string` | A versão da API. Esta é a versão da sua aplicação, não do OpenAPI. Por exemplo, `2.5.0`. |
+| `terms_of_service` | `str` | Uma URL para os Termos de Serviço da API. Se fornecido, deve ser uma URL. |
+| `contact` | `dict` | As informações de contato da API exposta. Pode conter vários campos. <details><summary>Campos de <code>contact</code></summary><table><thead><tr><th>Parâmetro</th><th>Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td><code>name</code></td><td><code>str</code></td><td>O nome identificador da pessoa/organização de contato.</td></tr><tr><td><code>url</code></td><td><code>str</code></td><td>A URL que aponta para as informações de contato. DEVE estar no formato de uma URL.</td></tr><tr><td><code>email</code></td><td><code>str</code></td><td>O endereço de e-mail da pessoa/organização de contato. DEVE estar no formato de um endereço de e-mail.</td></tr></tbody></table></details> |
+| `license_info` | `dict` | As informações de licença para a API exposta. Ela pode conter vários campos. <details><summary>Campos de <code>license_info</code></summary><table><thead><tr><th>Parâmetro</th><th>Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td><code>name</code></td><td><code>str</code></td><td><strong>OBRIGATÓRIO</strong> (se um <code>license_info</code> for definido). O nome da licença usada para a API.</td></tr><tr><td><code>identifier</code></td><td><code>str</code></td><td>Uma expressão de licença <a href="https://spdx.org/licenses/" class="external-link" target="_blank">SPDX</a> para a API. O campo <code>identifier</code> é mutuamente exclusivo do campo <code>url</code>. <small>Disponível desde OpenAPI 3.1.0, FastAPI 0.99.0.</small></td></tr><tr><td><code>url</code></td><td><code>str</code></td><td>Uma URL para a licença usada para a API. DEVE estar no formato de uma URL.</td></tr></tbody></table></details> |
+
+Você pode defini-los da seguinte maneira:
+
+```Python hl_lines="3-16 19-32"
+{!../../docs_src/metadata/tutorial001.py!}
+```
+
+/// tip | Dica
+
+Você pode escrever Markdown no campo `description` e ele será renderizado na saída.
+
+///
+
+Com essa configuração, a documentação automática da API se pareceria com:
+
+<img src="/img/tutorial/metadata/image01.png">
+
+## Identificador de Licença
+
+Desde o OpenAPI 3.1.0 e FastAPI 0.99.0, você também pode definir o license_info com um identifier em vez de uma url.
+
+Por exemplo:
+
+```Python hl_lines="31"
+{!../../docs_src/metadata/tutorial001_1.py!}
+```
+
+## Metadados para tags
+
+Você também pode adicionar metadados adicionais para as diferentes tags usadas para agrupar suas operações de rota com o parâmetro `openapi_tags`.
+
+Ele recebe uma lista contendo um dicionário para cada tag.
+
+Cada dicionário pode conter:
+
+* `name` (**obrigatório**): uma `str` com o mesmo nome da tag que você usa no parâmetro `tags` nas suas *operações de rota* e `APIRouter`s.
+* `description`: uma `str` com uma breve descrição da tag. Pode conter Markdown e será exibido na interface de documentação.
+* `externalDocs`: um `dict` descrevendo a documentação externa com:
+ * `description`: uma `str` com uma breve descrição da documentação externa.
+ * `url` (**obrigatório**): uma `str` com a URL da documentação externa.
+
+### Criar Metadados para tags
+
+Vamos tentar isso em um exemplo com tags para `users` e `items`.
+
+Crie metadados para suas tags e passe-os para o parâmetro `openapi_tags`:
+
+```Python hl_lines="3-16 18"
+{!../../docs_src/metadata/tutorial004.py!}
+```
+
+Observe que você pode usar Markdown dentro das descrições. Por exemplo, "login" será exibido em negrito (**login**) e "fancy" será exibido em itálico (_fancy_).
+
+/// tip | Dica
+
+Você não precisa adicionar metadados para todas as tags que você usa.
+
+///
+
+### Use suas tags
+
+Use o parâmetro `tags` com suas *operações de rota* (e `APIRouter`s) para atribuí-los a diferentes tags:
+
+```Python hl_lines="21 26"
+{!../../docs_src/metadata/tutorial004.py!}
+```
+
+/// info | Informação
+
+Leia mais sobre tags em [Configuração de Operação de Caminho](path-operation-configuration.md#tags){.internal-link target=_blank}.
+
+///
+
+### Cheque os documentos
+
+Agora, se você verificar a documentação, ela exibirá todos os metadados adicionais:
+
+<img src="/img/tutorial/metadata/image02.png">
+
+### Ordem das tags
+
+A ordem de cada dicionário de metadados de tag também define a ordem exibida na interface de documentação.
+
+Por exemplo, embora `users` apareça após `items` em ordem alfabética, ele é exibido antes deles, porque adicionamos seus metadados como o primeiro dicionário na lista.
+
+## URL da OpenAPI
+
+Por padrão, o esquema OpenAPI é servido em `/openapi.json`.
+
+Mas você pode configurá-lo com o parâmetro `openapi_url`.
+
+Por exemplo, para defini-lo para ser servido em `/api/v1/openapi.json`:
+
+```Python hl_lines="3"
+{!../../docs_src/metadata/tutorial002.py!}
+```
+
+Se você quiser desativar completamente o esquema OpenAPI, pode definir `openapi_url=None`, o que também desativará as interfaces de documentação que o utilizam.
+
+## URLs da Documentação
+
+Você pode configurar as duas interfaces de documentação incluídas:
+
+* **Swagger UI**: acessível em `/docs`.
+ * Você pode definir sua URL com o parâmetro `docs_url`.
+ * Você pode desativá-la definindo `docs_url=None`.
+* **ReDoc**: acessível em `/redoc`.
+ * Você pode definir sua URL com o parâmetro `redoc_url`.
+ * Você pode desativá-la definindo `redoc_url=None`.
+
+Por exemplo, para definir o Swagger UI para ser servido em `/documentation` e desativar o ReDoc:
+
+```Python hl_lines="3"
+{!../../docs_src/metadata/tutorial003.py!}
+```
From 8cae611101fb4b1e6804df032c020758447a7ded Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 29 Oct 2024 10:36:58 +0000
Subject: [PATCH 333/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e547d8b58..b6d679ae3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -26,6 +26,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `docs/ko/docs/tutorial/metadata.md`. PR [#12541](https://github.com/fastapi/fastapi/pull/12541) by [@kwang1215](https://github.com/kwang1215).
* 🌐 Add Korean Translation for `docs/ko/docs/advanced/response-cookies.md`. PR [#12546](https://github.com/fastapi/fastapi/pull/12546) by [@kim-sangah](https://github.com/kim-sangah).
* 🌐 Add Korean translation for `docs/ko/docs/fastapi-cli.md`. PR [#12515](https://github.com/fastapi/fastapi/pull/12515) by [@dhdld](https://github.com/dhdld).
* 🌐 Add Korean Translation for `docs/ko/docs/advanced/response-change-status-code.md`. PR [#12547](https://github.com/fastapi/fastapi/pull/12547) by [@9zimin9](https://github.com/9zimin9).
From c8f5755d0a14f6013a3667f3414753cbe1604660 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 29 Oct 2024 10:39:18 +0000
Subject: [PATCH 334/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b6d679ae3..ee044f228 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -26,6 +26,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/metadata.md`. PR [#12538](https://github.com/fastapi/fastapi/pull/12538) by [@LinkolnR](https://github.com/LinkolnR).
* 🌐 Add Korean translation for `docs/ko/docs/tutorial/metadata.md`. PR [#12541](https://github.com/fastapi/fastapi/pull/12541) by [@kwang1215](https://github.com/kwang1215).
* 🌐 Add Korean Translation for `docs/ko/docs/advanced/response-cookies.md`. PR [#12546](https://github.com/fastapi/fastapi/pull/12546) by [@kim-sangah](https://github.com/kim-sangah).
* 🌐 Add Korean translation for `docs/ko/docs/fastapi-cli.md`. PR [#12515](https://github.com/fastapi/fastapi/pull/12515) by [@dhdld](https://github.com/dhdld).
From 268eac9e16cccf2b60bcc1d4a70ff3b15b6958b9 Mon Sep 17 00:00:00 2001
From: Krishna Madhavan <krishnamadhavan07@gmail.com>
Date: Tue, 29 Oct 2024 16:32:16 +0530
Subject: [PATCH 335/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/security/oauth2-scopes.md`=20(#12572)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../docs/advanced/security/oauth2-scopes.md | 528 +-----------------
1 file changed, 8 insertions(+), 520 deletions(-)
diff --git a/docs/en/docs/advanced/security/oauth2-scopes.md b/docs/en/docs/advanced/security/oauth2-scopes.md
index 3db284d02..5ba0b1c14 100644
--- a/docs/en/docs/advanced/security/oauth2-scopes.md
+++ b/docs/en/docs/advanced/security/oauth2-scopes.md
@@ -62,71 +62,7 @@ For OAuth2 they are just strings.
First, let's quickly see the parts that change from the examples in the main **Tutorial - User Guide** for [OAuth2 with Password (and hashing), Bearer with JWT tokens](../../tutorial/security/oauth2-jwt.md){.internal-link target=_blank}. Now using OAuth2 scopes:
-//// tab | Python 3.10+
-
-```Python hl_lines="5 9 13 47 65 106 108-116 122-125 129-135 140 156"
-{!> ../../docs_src/security/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="2 5 9 13 47 65 106 108-116 122-125 129-135 140 156"
-{!> ../../docs_src/security/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="2 5 9 13 48 66 107 109-117 123-126 130-136 141 157"
-{!> ../../docs_src/security/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="4 8 12 46 64 105 107-115 121-124 128-134 139 155"
-{!> ../../docs_src/security/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="2 5 9 13 47 65 106 108-116 122-125 129-135 140 156"
-{!> ../../docs_src/security/tutorial005_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="2 5 9 13 47 65 106 108-116 122-125 129-135 140 156"
-{!> ../../docs_src/security/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial005_an_py310.py hl[5,9,13,47,65,106,108:116,122:125,129:135,140,156] *}
Now let's review those changes step by step.
@@ -136,71 +72,7 @@ The first change is that now we are declaring the OAuth2 security scheme with tw
The `scopes` parameter receives a `dict` with each scope as a key and the description as the value:
-//// tab | Python 3.10+
-
-```Python hl_lines="63-66"
-{!> ../../docs_src/security/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="63-66"
-{!> ../../docs_src/security/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="64-67"
-{!> ../../docs_src/security/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="62-65"
-{!> ../../docs_src/security/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="63-66"
-{!> ../../docs_src/security/tutorial005_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="63-66"
-{!> ../../docs_src/security/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial005_an_py310.py hl[63:66] *}
Because we are now declaring those scopes, they will show up in the API docs when you log-in/authorize.
@@ -226,71 +98,7 @@ But in your application, for security, you should make sure you only add the sco
///
-//// tab | Python 3.10+
-
-```Python hl_lines="156"
-{!> ../../docs_src/security/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="156"
-{!> ../../docs_src/security/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="157"
-{!> ../../docs_src/security/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="155"
-{!> ../../docs_src/security/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="156"
-{!> ../../docs_src/security/tutorial005_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="156"
-{!> ../../docs_src/security/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial005_an_py310.py hl[156] *}
## Declare scopes in *path operations* and dependencies
@@ -316,71 +124,7 @@ We are doing it here to demonstrate how **FastAPI** handles scopes declared at d
///
-//// tab | Python 3.10+
-
-```Python hl_lines="5 140 171"
-{!> ../../docs_src/security/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="5 140 171"
-{!> ../../docs_src/security/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="5 141 172"
-{!> ../../docs_src/security/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="4 139 168"
-{!> ../../docs_src/security/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="5 140 169"
-{!> ../../docs_src/security/tutorial005_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="5 140 169"
-{!> ../../docs_src/security/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial005_an_py310.py hl[5,140,171] *}
/// info | "Technical Details"
@@ -406,71 +150,7 @@ We also declare a special parameter of type `SecurityScopes`, imported from `fas
This `SecurityScopes` class is similar to `Request` (`Request` was used to get the request object directly).
-//// tab | Python 3.10+
-
-```Python hl_lines="9 106"
-{!> ../../docs_src/security/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="9 106"
-{!> ../../docs_src/security/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9 107"
-{!> ../../docs_src/security/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="8 105"
-{!> ../../docs_src/security/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9 106"
-{!> ../../docs_src/security/tutorial005_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9 106"
-{!> ../../docs_src/security/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial005_an_py310.py hl[9,106] *}
## Use the `scopes`
@@ -484,71 +164,7 @@ We create an `HTTPException` that we can reuse (`raise`) later at several points
In this exception, we include the scopes required (if any) as a string separated by spaces (using `scope_str`). We put that string containing the scopes in the `WWW-Authenticate` header (this is part of the spec).
-//// tab | Python 3.10+
-
-```Python hl_lines="106 108-116"
-{!> ../../docs_src/security/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="106 108-116"
-{!> ../../docs_src/security/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="107 109-117"
-{!> ../../docs_src/security/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="105 107-115"
-{!> ../../docs_src/security/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="106 108-116"
-{!> ../../docs_src/security/tutorial005_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="106 108-116"
-{!> ../../docs_src/security/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial005_an_py310.py hl[106,108:116] *}
## Verify the `username` and data shape
@@ -564,71 +180,7 @@ Instead of, for example, a `dict`, or something else, as it could break the appl
We also verify that we have a user with that username, and if not, we raise that same exception we created before.
-//// tab | Python 3.10+
-
-```Python hl_lines="47 117-128"
-{!> ../../docs_src/security/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="47 117-128"
-{!> ../../docs_src/security/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="48 118-129"
-{!> ../../docs_src/security/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="46 116-127"
-{!> ../../docs_src/security/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="47 117-128"
-{!> ../../docs_src/security/tutorial005_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="47 117-128"
-{!> ../../docs_src/security/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial005_an_py310.py hl[47,117:128] *}
## Verify the `scopes`
@@ -636,71 +188,7 @@ We now verify that all the scopes required, by this dependency and all the depen
For this, we use `security_scopes.scopes`, that contains a `list` with all these scopes as `str`.
-//// tab | Python 3.10+
-
-```Python hl_lines="129-135"
-{!> ../../docs_src/security/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="129-135"
-{!> ../../docs_src/security/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="130-136"
-{!> ../../docs_src/security/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="128-134"
-{!> ../../docs_src/security/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="129-135"
-{!> ../../docs_src/security/tutorial005_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="129-135"
-{!> ../../docs_src/security/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial005_an_py310.py hl[129:135] *}
## Dependency tree and scopes
From 25c63800f6c5c76b8514d6f3c3b3178c12e24471 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 29 Oct 2024 11:02:39 +0000
Subject: [PATCH 336/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ee044f228..f510f6c30 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/security/oauth2-scopes.md`. PR [#12572](https://github.com/fastapi/fastapi/pull/12572) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes for `docs/en/docs/how-to/conditional-openapi.md`. PR [#12624](https://github.com/fastapi/fastapi/pull/12624) by [@rabinlamadong](https://github.com/rabinlamadong).
* 📝 Update includes in `docs/en/docs/tutorial/dependencies/index.md`. PR [#12615](https://github.com/fastapi/fastapi/pull/12615) by [@bharara](https://github.com/bharara).
* 📝 Update includes in `docs/en/docs/tutorial/response-status-code.md`. PR [#12620](https://github.com/fastapi/fastapi/pull/12620) by [@kantandane](https://github.com/kantandane).
From c5a9d3ac28cd21a010608f36c9967c7185a54904 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Pedro=20Pereira=20Holanda?=
<joaopedroph09@gmail.com>
Date: Tue, 29 Oct 2024 08:47:10 -0300
Subject: [PATCH 337/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20Trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/custom-response.md`=20(#1?=
=?UTF-8?q?2631)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/advanced/custom-response.md | 344 +++++++++++++++++++++++
1 file changed, 344 insertions(+)
create mode 100644 docs/pt/docs/advanced/custom-response.md
diff --git a/docs/pt/docs/advanced/custom-response.md b/docs/pt/docs/advanced/custom-response.md
new file mode 100644
index 000000000..5f673d7ce
--- /dev/null
+++ b/docs/pt/docs/advanced/custom-response.md
@@ -0,0 +1,344 @@
+# Resposta Personalizada - HTML, Stream, File e outras
+
+Por padrão, o **FastAPI** irá retornar respostas utilizando `JSONResponse`.
+
+Mas você pode sobrescrever esse comportamento utilizando `Response` diretamente, como visto em [Retornando uma Resposta Diretamente](response-directly.md){.internal-link target=_blank}.
+
+Mas se você retornar uma `Response` diretamente (ou qualquer subclasse, como `JSONResponse`), os dados não serão convertidos automaticamente (mesmo que você declare um `response_model`), e a documentação não será gerada automaticamente (por exemplo, incluindo o "media type", no cabeçalho HTTP `Content-Type` como parte do esquema OpenAPI gerado).
+
+Mas você também pode declarar a `Response` que você deseja utilizar (e.g. qualquer subclasse de `Response`), em um *decorador de operação de rota* utilizando o parâmetro `response_class`.
+
+Os conteúdos que você retorna em sua *função de operador de rota* serão colocados dentro dessa `Response`.
+
+E se a `Response` tiver um media type JSON (`application/json`), como é o caso com `JSONResponse` e `UJSONResponse`, os dados que você retornar serão automaticamente convertidos (e filtrados) com qualquer `response_model` do Pydantic que for declarado em sua *função de operador de rota*.
+
+/// note | Nota
+
+Se você utilizar uma classe de Resposta sem media type, o FastAPI esperará que sua resposta não tenha conteúdo, então ele não irá documentar o formato da resposta na documentação OpenAPI gerada.
+
+///
+
+## Utilizando `ORJSONResponse`
+
+Por exemplo, se você precisa bastante de performance, você pode instalar e utilizar o <a href="https://github.com/ijl/orjson" class="external-link" target="_blank">`orjson`</a> e definir a resposta para ser uma `ORJSONResponse`.
+
+Importe a classe, ou subclasse, de `Response` que você deseja utilizar e declare ela no *decorador de operação de rota*.
+
+Para respostas grandes, retornar uma `Response` diretamente é muito mais rápido que retornar um dicionário.
+
+Isso ocorre por que, por padrão, o FastAPI irá verificar cada item dentro do dicionário e garantir que ele seja serializável para JSON, utilizando o mesmo[Codificador Compatível com JSON](../tutorial/encoder.md){.internal-link target=_blank} explicado no tutorial. Isso permite que você retorne **objetos abstratos**, como modelos do banco de dados, por exemplo.
+
+Mas se você tem certeza que o conteúdo que você está retornando é **serializável com JSON**, você pode passá-lo diretamente para a classe de resposta e evitar o trabalho extra que o FastAPI teria ao passar o conteúdo pelo `jsonable_encoder` antes de passar para a classe de resposta.
+
+```Python hl_lines="2 7"
+{!../../docs_src/custom_response/tutorial001b.py!}
+```
+
+/// info | Informação
+
+O parâmetro `response_class` também será usado para definir o "media type" da resposta.
+
+Neste caso, o cabeçalho HTTP `Content-Type` irá ser definido como `application/json`.
+
+E será documentado como tal no OpenAPI.
+
+///
+
+/// tip | Dica
+
+A `ORJSONResponse` está disponível apenas no FastAPI, e não no Starlette.
+
+///
+
+## Resposta HTML
+
+Para retornar uma resposta com HTML diretamente do **FastAPI**, utilize `HTMLResponse`.
+
+* Importe `HTMLResponse`
+* Passe `HTMLResponse` como o parâmetro de `response_class` do seu *decorador de operação de rota*.
+
+```Python hl_lines="2 7"
+{!../../docs_src/custom_response/tutorial002.py!}
+```
+
+/// info | Informação
+
+O parâmetro `response_class` também será usado para definir o "media type" da resposta.
+
+Neste caso, o cabeçalho HTTP `Content-Type` será definido como `text/html`.
+
+E será documentado como tal no OpenAPI.
+
+///
+
+### Retornando uma `Response`
+
+Como visto em [Retornando uma Resposta Diretamente](response-directly.md){.internal-link target=_blank}, você também pode sobrescrever a resposta diretamente na sua *operação de rota*, ao retornar ela.
+
+O mesmo exemplo de antes, retornando uma `HTMLResponse`, poderia parecer com:
+
+```Python hl_lines="2 7 19"
+{!../../docs_src/custom_response/tutorial003.py!}
+```
+
+/// warning | Aviso
+
+Uma `Response` retornada diretamente em sua *função de operação de rota* não será documentada no OpenAPI (por exemplo, o `Content-Type` não será documentado) e não será visível na documentação interativa automática.
+
+///
+
+/// info | Informação
+
+Obviamente, o cabeçalho `Content-Type`, o código de status, etc, virão do objeto `Response` que você retornou.
+
+///
+
+### Documentar no OpenAPI e sobrescrever `Response`
+
+Se você deseja sobrescrever a resposta dentro de uma função, mas ao mesmo tempo documentar o "media type" no OpenAPI, você pode utilizar o parâmetro `response_class` E retornar um objeto `Response`.
+
+A `response_class` será usada apenas para documentar o OpenAPI da *operação de rota*, mas sua `Response` será usada como foi definida.
+
+##### Retornando uma `HTMLResponse` diretamente
+
+Por exemplo, poderia ser algo como:
+
+```Python hl_lines="7 21 23"
+{!../../docs_src/custom_response/tutorial004.py!}
+```
+
+Neste exemplo, a função `generate_html_response()` já cria e retorna uma `Response` em vez de retornar o HTML em uma `str`.
+
+Ao retornar o resultado chamando `generate_html_response()`, você já está retornando uma `Response` que irá sobrescrever o comportamento padrão do **FastAPI**.
+
+Mas se você passasse uma `HTMLResponse` em `response_class` também, o **FastAPI** saberia como documentar isso no OpenAPI e na documentação interativa como um HTML com `text/html`:
+
+<img src="/img/tutorial/custom-response/image01.png">
+
+## Respostas disponíveis
+
+Aqui estão algumas dos tipos de resposta disponíveis.
+
+Lembre-se que você pode utilizar `Response` para retornar qualquer outra coisa, ou até mesmo criar uma subclasse personalizada.
+
+/// note | Detalhes Técnicos
+
+Você também pode utilizar `from starlette.responses import HTMLResponse`.
+
+O **FastAPI** provê a mesma `starlette.responses` como `fastapi.responses` apenas como uma facilidade para você, desenvolvedor. Mas a maioria das respostas disponíveis vêm diretamente do Starlette.
+
+///
+
+### `Response`
+
+A classe principal de respostas, todas as outras respostas herdam dela.
+
+Você pode retorná-la diretamente.
+
+Ela aceita os seguintes parâmetros:
+
+* `content` - Uma sequência de caracteres (`str`) ou `bytes`.
+* `status_code` - Um código de status HTTP do tipo `int`.
+* `headers` - Um dicionário `dict` de strings.
+* `media_type` - Uma `str` informando o media type. E.g. `"text/html"`.
+
+O FastAPI (Starlette, na verdade) irá incluir o cabeçalho Content-Length automaticamente. Ele também irá incluir o cabeçalho Content-Type, baseado no `media_type` e acrescentando uma codificação para tipos textuais.
+
+```Python hl_lines="1 18"
+{!../../docs_src/response_directly/tutorial002.py!}
+```
+
+### `HTMLResponse`
+
+Usa algum texto ou sequência de bytes e retorna uma resposta HTML. Como você leu acima.
+
+### `PlainTextResponse`
+
+Usa algum texto ou sequência de bytes para retornar uma resposta de texto não formatado.
+
+```Python hl_lines="2 7 9"
+{!../../docs_src/custom_response/tutorial005.py!}
+```
+
+### `JSONResponse`
+
+Pega alguns dados e retorna uma resposta com codificação `application/json`.
+
+É a resposta padrão utilizada no **FastAPI**, como você leu acima.
+
+### `ORJSONResponse`
+
+Uma alternativa mais rápida de resposta JSON utilizando o <a href="https://github.com/ijl/orjson" class="external-link" target="_blank">`orjson`</a>, como você leu acima.
+
+/// info | Informação
+
+Essa resposta requer a instalação do pacote `orjson`, com o comando `pip install orjson`, por exemplo.
+
+///
+
+### `UJSONResponse`
+
+Uma alternativa de resposta JSON utilizando a biblioteca <a href="https://github.com/ultrajson/ultrajson" class="external-link" target="_blank">`ujson`</a>.
+
+/// info | Informação
+
+Essa resposta requer a instalação do pacote `ujson`, com o comando `pip install ujson`, por exemplo.
+
+///
+
+/// warning | Aviso
+
+`ujson` é menos cauteloso que a implementação nativa do Python na forma que os casos especiais são tratados
+
+///
+
+```Python hl_lines="2 7"
+{!../../docs_src/custom_response/tutorial001.py!}
+```
+
+/// tip | Dica
+
+É possível que `ORJSONResponse` seja uma alternativa mais rápida.
+
+///
+
+### `RedirectResponse`
+
+Retorna um redirecionamento HTTP. Utiliza o código de status 307 (Redirecionamento Temporário) por padrão.
+
+Você pode retornar uma `RedirectResponse` diretamente:
+
+```Python hl_lines="2 9"
+{!../../docs_src/custom_response/tutorial006.py!}
+```
+
+---
+
+Ou você pode utilizá-la no parâmetro `response_class`:
+
+```Python hl_lines="2 7 9"
+{!../../docs_src/custom_response/tutorial006b.py!}
+```
+
+Se você fizer isso, então você pode retornar a URL diretamente da sua *função de operação de rota*
+
+Neste caso, o `status_code` utilizada será o padrão de `RedirectResponse`, que é `307`.
+
+---
+
+Você também pode utilizar o parâmetro `status_code` combinado com o parâmetro `response_class`:
+
+```Python hl_lines="2 7 9"
+{!../../docs_src/custom_response/tutorial006c.py!}
+```
+
+### `StreamingResponse`
+
+Recebe uma gerador assíncrono ou um gerador/iterador comum e retorna o corpo da requisição continuamente (stream).
+
+```Python hl_lines="2 14"
+{!../../docs_src/custom_response/tutorial007.py!}
+```
+
+#### Utilizando `StreamingResponse` com objetos semelhantes a arquivos
+
+Se você tiver um objeto semelhante a um arquivo (e.g. o objeto retornado por `open()`), você pode criar uma função geradora para iterar sobre esse objeto.
+
+Dessa forma, você não precisa ler todo o arquivo na memória primeiro, e você pode passar essa função geradora para `StreamingResponse` e retorná-la.
+
+Isso inclui muitas bibliotecas que interagem com armazenamento em nuvem, processamento de vídeos, entre outras.
+
+```{ .python .annotate hl_lines="2 10-12 14" }
+{!../../docs_src/custom_response/tutorial008.py!}
+```
+
+1. Essa é a função geradora. É definida como "função geradora" porque contém declarações `yield` nela.
+2. Ao utilizar o bloco `with`, nós garantimos que o objeto semelhante a um arquivo é fechado após a função geradora ser finalizada. Isto é, após a resposta terminar de ser enivada.
+3. Essa declaração `yield from` informa a função para iterar sobre essa coisa nomeada de `file_like`. E então, para cada parte iterada, fornece essa parte como se viesse dessa função geradora (`iterfile`).
+
+ Então, é uma função geradora que transfere o trabalho de "geração" para alguma outra coisa interna.
+
+ Fazendo dessa forma, podemos colocá-la em um bloco `with`, e assim garantir que o objeto semelhante a um arquivo é fechado quando a função termina.
+
+/// tip | Dica
+
+Perceba que aqui estamos utilizando o `open()` da biblioteca padrão que não suporta `async` e `await`, e declaramos a operação de rota com o `def` básico.
+
+///
+
+### `FileResponse`
+
+Envia um arquivo de forma assíncrona e contínua (stream).
+*
+Recebe um conjunto de argumentos do construtor diferente dos outros tipos de resposta:
+
+* `path` - O caminho do arquivo que será transmitido
+* `headers` - quaisquer cabeçalhos que serão incluídos, como um dicionário.
+* `media_type` - Uma string com o media type. Se não for definida, o media type é inferido a partir do nome ou caminho do arquivo.
+* `filename` - Se for definido, é incluído no cabeçalho `Content-Disposition`.
+
+Respostas de Arquivos incluem o tamanho do arquivo, data da última modificação e ETags apropriados, nos cabeçalhos `Content-Length`, `Last-Modified` e `ETag`, respectivamente.
+
+```Python hl_lines="2 10"
+{!../../docs_src/custom_response/tutorial009.py!}
+```
+
+Você também pode usar o parâmetro `response_class`:
+
+```Python hl_lines="2 8 10"
+{!../../docs_src/custom_response/tutorial009b.py!}
+```
+
+Nesse caso, você pode retornar o caminho do arquivo diretamente da sua *função de operação de rota*.
+
+## Classe de resposta personalizada
+
+Você pode criar sua própria classe de resposta, herdando de `Response` e usando essa nova classe.
+
+Por exemplo, vamos supor que você queira utilizar o <a href="https://github.com/ijl/orjson" class="external-link" target="_blank">`orjson`</a>, mas com algumas configurações personalizadas que não estão incluídas na classe `ORJSONResponse`.
+
+Vamos supor também que você queira retornar um JSON indentado e formatado, então você quer utilizar a opção `orjson.OPT_INDENT_2` do orjson.
+
+Você poderia criar uma classe `CustomORJSONResponse`. A principal coisa a ser feita é sobrecarregar o método render da classe Response, `Response.render(content)`, que retorna o conteúdo em bytes, para retornar o conteúdo que você deseja:
+
+```Python hl_lines="9-14 17"
+{!../../docs_src/custom_response/tutorial009c.py!}
+```
+
+Agora em vez de retornar:
+
+```json
+{"message": "Hello World"}
+```
+
+...essa resposta retornará:
+
+```json
+{
+ "message": "Hello World"
+}
+```
+
+Obviamente, você provavelmente vai encontrar maneiras muito melhores de se aproveitar disso do que a formatação de JSON. 😉
+
+## Classe de resposta padrão
+
+Quando você criar uma instância da classe **FastAPI** ou um `APIRouter` você pode especificar qual classe de resposta utilizar por padrão.
+
+O padrão que define isso é o `default_response_class`.
+
+No exemplo abaixo, o **FastAPI** irá utilizar `ORJSONResponse` por padrão, em todas as *operações de rota*, em vez de `JSONResponse`.
+
+```Python hl_lines="2 4"
+{!../../docs_src/custom_response/tutorial010.py!}
+```
+
+/// tip | Dica
+
+Você ainda pode substituir `response_class` em *operações de rota* como antes.
+
+///
+
+## Documentação adicional
+
+Você também pode declarar o media type e muitos outros detalhes no OpenAPI utilizando `responses`: [Retornos Adicionais no OpenAPI](additional-responses.md){.internal-link target=_blank}.
From 8dc523b1efda92d878796c22f9a4a88f4a03605a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 29 Oct 2024 11:47:36 +0000
Subject: [PATCH 338/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f510f6c30..ae4567f00 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Portuguese Translation for `docs/pt/docs/advanced/custom-response.md`. PR [#12631](https://github.com/fastapi/fastapi/pull/12631) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/metadata.md`. PR [#12538](https://github.com/fastapi/fastapi/pull/12538) by [@LinkolnR](https://github.com/LinkolnR).
* 🌐 Add Korean translation for `docs/ko/docs/tutorial/metadata.md`. PR [#12541](https://github.com/fastapi/fastapi/pull/12541) by [@kwang1215](https://github.com/kwang1215).
* 🌐 Add Korean Translation for `docs/ko/docs/advanced/response-cookies.md`. PR [#12546](https://github.com/fastapi/fastapi/pull/12546) by [@kim-sangah](https://github.com/kim-sangah).
From ece28bc8db18d9b0ea176855730ba2773f044a8b Mon Sep 17 00:00:00 2001
From: Luis Rodrigues <103431660+devluisrodrigues@users.noreply.github.com>
Date: Wed, 30 Oct 2024 16:52:32 -0300
Subject: [PATCH 339/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/request-files.md`=20(#127?=
=?UTF-8?q?06)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/tutorial/request-files.md | 176 +++++++++++++++++++++++++
1 file changed, 176 insertions(+)
create mode 100644 docs/pt/docs/tutorial/request-files.md
diff --git a/docs/pt/docs/tutorial/request-files.md b/docs/pt/docs/tutorial/request-files.md
new file mode 100644
index 000000000..d230f1feb
--- /dev/null
+++ b/docs/pt/docs/tutorial/request-files.md
@@ -0,0 +1,176 @@
+# Arquivos de Requisição
+
+Você pode definir arquivos para serem enviados pelo cliente usando `File`.
+
+/// info | Informação
+
+Para receber arquivos enviados, primeiro instale o <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
+
+Garanta que você criou um [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, o ativou e então o instalou, por exemplo:
+
+```console
+$ pip install python-multipart
+```
+
+Isso é necessário, visto que os arquivos enviados são enviados como "dados de formulário".
+
+///
+
+## Importe `File`
+
+Importe `File` e `UploadFile` de `fastapi`:
+
+{* ../../docs_src/request_files/tutorial001_an_py39.py hl[3] *}
+
+## Definir Parâmetros `File`
+
+Crie parâmetros de arquivo da mesma forma que você faria para `Body` ou `Form`:
+
+{* ../../docs_src/request_files/tutorial001_an_py39.py hl[9] *}
+
+/// info | Informação
+
+`File` é uma classe que herda diretamente de `Form`.
+
+Mas lembre-se que quando você importa `Query`, `Path`, `File` e outros de `fastapi`, eles são, na verdade, funções que retornam classes especiais.
+
+///
+
+/// tip | Dica
+
+Para declarar corpos de arquivos, você precisa usar `File`, caso contrário, os parâmetros seriam interpretados como parâmetros de consulta ou parâmetros de corpo (JSON).
+
+///
+
+Os arquivos serão enviados como "dados de formulário".
+
+Se você declarar o tipo do parâmetro da função da sua *operação de rota* como `bytes`, o **FastAPI** lerá o arquivo para você e você receberá o conteúdo como `bytes`.
+
+Mantenha em mente que isso significa que todo o conteúdo será armazenado na memória. Isso funcionará bem para arquivos pequenos.
+
+Mas há muitos casos em que você pode se beneficiar do uso de `UploadFile`.
+
+## Parâmetros de Arquivo com `UploadFile`
+
+Defina um parâmetro de arquivo com um tipo de `UploadFile`:
+
+{* ../../docs_src/request_files/tutorial001_an_py39.py hl[14] *}
+
+Utilizar `UploadFile` tem várias vantagens sobre `bytes`:
+
+* Você não precisa utilizar o `File()` no valor padrão do parâmetro.
+* Ele utiliza um arquivo "spooled":
+ * Um arquivo armazenado na memória até um limite máximo de tamanho, e após passar esse limite, ele será armazenado no disco.
+* Isso significa que funcionará bem para arquivos grandes como imagens, vídeos, binários grandes, etc., sem consumir toda a memória.
+* Você pode receber metadados do arquivo enviado.
+* Ele tem uma <a href="https://docs.python.org/3/glossary.html#term-file-like-object" class="external-link" target="_blank">file-like</a> interface `assíncrona`.
+* Ele expõe um objeto python <a href="https://docs.python.org/3/library/tempfile.html#tempfile.SpooledTemporaryFile" class="external-link" target="_blank">`SpooledTemporaryFile`</a> que você pode passar diretamente para outras bibliotecas que esperam um objeto semelhante a um arquivo("file-like").
+
+### `UploadFile`
+
+`UploadFile` tem os seguintes atributos:
+
+* `filename`: Uma `str` com o nome do arquivo original que foi enviado (por exemplo, `myimage.jpg`).
+* `content_type`: Uma `str` com o tipo de conteúdo (tipo MIME / tipo de mídia) (por exemplo, `image/jpeg`).
+* `file`: Um <a href="https://docs.python.org/3/library/tempfile.html#tempfile.SpooledTemporaryFile" class="external-link" target="_blank">`SpooledTemporaryFile`</a> (um <a href="https://docs.python.org/3/glossary.html#term-file-like-object" class="external-link" target="_blank">file-like</a> objeto). Este é o objeto de arquivo Python que você pode passar diretamente para outras funções ou bibliotecas que esperam um objeto semelhante a um arquivo("file-like").
+
+`UploadFile` tem os seguintes métodos `assíncronos`. Todos eles chamam os métodos de arquivo correspondentes por baixo dos panos (usando o `SpooledTemporaryFile` interno).
+
+* `write(data)`: Escreve `data` (`str` ou `bytes`) no arquivo.
+* `read(size)`: Lê `size` (`int`) bytes/caracteres do arquivo.
+* `seek(offset)`: Vai para o byte na posição `offset` (`int`) no arquivo.
+ * Por exemplo, `await myfile.seek(0)` irá para o início do arquivo.
+ * Isso é especialmente útil se você executar `await myfile.read()` uma vez e precisar ler o conteúdo novamente.
+* `close()`: Fecha o arquivo.
+
+Como todos esses métodos são métodos `assíncronos`, você precisa "aguardar" por eles.
+
+Por exemplo, dentro de uma função de *operação de rota* `assíncrona`, você pode obter o conteúdo com:
+
+```Python
+contents = await myfile.read()
+```
+
+Se você estiver dentro de uma função de *operação de rota* normal `def`, você pode acessar o `UploadFile.file` diretamente, por exemplo:
+
+```Python
+contents = myfile.file.read()
+```
+
+/// note | Detalhes Técnicos do `async`
+
+Quando você usa os métodos `async`, o **FastAPI** executa os métodos de arquivo em um threadpool e aguarda por eles.
+
+///
+
+/// note | "Detalhes Técnicos do Starlette"
+
+O `UploadFile` do ***FastAPI** herda diretamente do `UploadFile` do **Starlette** , mas adiciona algumas partes necessárias para torná-lo compatível com o **Pydantic** e as outras partes do FastAPI.
+
+///
+
+## O que é "Form Data"
+
+O jeito que os formulários HTML (`<form></form>`) enviam os dados para o servidor normalmente usa uma codificação "especial" para esses dados, a qual é diferente do JSON.
+
+**FastAPI** se certificará de ler esses dados do lugar certo, ao invés de JSON.
+
+/// note | "Detalhes Técnicos"
+
+Dados de formulários normalmente são codificados usando o "media type" (tipo de mídia) `application/x-www-form-urlencoded` quando não incluem arquivos.
+
+Mas quando o formulário inclui arquivos, ele é codificado como `multipart/form-data`. Se você usar `File`, o **FastAPI** saberá que tem que pegar os arquivos da parte correta do corpo da requisição.
+
+Se você quiser ler mais sobre essas codificações e campos de formulário, vá para a <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST" class="external-link" target="_blank"><abbr title="Mozilla Developer Network">MDN</abbr> web docs para <code>POST</code></a>.
+
+///
+
+/// warning | Aviso
+
+Você pode declarar múltiplos parâmetros `File` e `Form` em uma *operação de rota*, mas você não pode declarar campos `Body` que você espera receber como JSON, pois a requisição terá o corpo codificado usando `multipart/form-data` ao invés de `application/json`.
+
+Isso não é uma limitação do **FastAPI**, é parte do protocolo HTTP.
+
+///
+
+## Upload de Arquivo Opcional
+
+Você pode tornar um arquivo opcional usando anotações de tipo padrão e definindo um valor padrão de `None`:
+
+{* ../../docs_src/request_files/tutorial001_02_an_py310.py hl[9,17] *}
+
+## `UploadFile` com Metadados Adicionais
+
+Você também pode usar `File()` com `UploadFile`, por exemplo, para definir metadados adicionais:
+
+{* ../../docs_src/request_files/tutorial001_03_an_py39.py hl[9,15] *}
+
+## Uploads de Múltiplos Arquivos
+
+É possível realizar o upload de vários arquivos ao mesmo tempo.
+
+Eles serão associados ao mesmo "campo de formulário" enviado usando "dados de formulário".
+
+Para usar isso, declare uma lista de `bytes` ou `UploadFile`:
+
+{* ../../docs_src/request_files/tutorial002_an_py39.py hl[10,15] *}
+
+Você receberá, tal como declarado, uma `list` de `bytes` ou `UploadFile`.
+
+/// note | "Detalhes Técnicos"
+
+Você pode também pode usar `from starlette.responses import HTMLResponse`.
+
+**FastAPI** providencia o mesmo `starlette.responses` que `fastapi.responses` apenas como uma conveniência para você, o desenvolvedor. Mas a maioria das respostas disponíveis vem diretamente do Starlette.
+
+///
+
+### Uploads de Múltiplos Arquivos com Metadados Adicionais
+
+Da mesma forma de antes, você pode usar `File()` para definir parâmetros adicionais, mesmo para `UploadFile`:
+
+{* ../../docs_src/request_files/tutorial003_an_py39.py hl[11,18:20] *}
+
+## Recapitulando
+
+Utilize `File`, `bytes` e `UploadFile` para declarar arquivos a serem enviados na requisição, enviados como dados de formulário.
From 872feaccbe065c243e15d76efce33f25ba07e73c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 30 Oct 2024 19:52:53 +0000
Subject: [PATCH 340/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ae4567f00..4ff93b7bd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/request-files.md`. PR [#12706](https://github.com/fastapi/fastapi/pull/12706) by [@devluisrodrigues](https://github.com/devluisrodrigues).
* 🌐 Add Portuguese Translation for `docs/pt/docs/advanced/custom-response.md`. PR [#12631](https://github.com/fastapi/fastapi/pull/12631) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/metadata.md`. PR [#12538](https://github.com/fastapi/fastapi/pull/12538) by [@LinkolnR](https://github.com/LinkolnR).
* 🌐 Add Korean translation for `docs/ko/docs/tutorial/metadata.md`. PR [#12541](https://github.com/fastapi/fastapi/pull/12541) by [@kwang1215](https://github.com/kwang1215).
From 5be5ea92c0257cb1a0de61c0ab9b51285bf7f60e Mon Sep 17 00:00:00 2001
From: Fernando Alzueta <fefealzueta@gmail.com>
Date: Wed, 30 Oct 2024 16:53:03 -0300
Subject: [PATCH 341/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/openapi-callbacks.md`=20(?=
=?UTF-8?q?#12705)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/advanced/openapi-callbacks.md | 194 +++++++++++++++++++++
1 file changed, 194 insertions(+)
create mode 100644 docs/pt/docs/advanced/openapi-callbacks.md
diff --git a/docs/pt/docs/advanced/openapi-callbacks.md b/docs/pt/docs/advanced/openapi-callbacks.md
new file mode 100644
index 000000000..c66ababa0
--- /dev/null
+++ b/docs/pt/docs/advanced/openapi-callbacks.md
@@ -0,0 +1,194 @@
+# Callbacks na OpenAPI
+
+Você poderia criar uma API com uma *operação de rota* que poderia acionar uma solicitação a uma *API externa* criada por outra pessoa (provavelmente o mesmo desenvolvedor que estaria *usando* sua API).
+
+O processo que acontece quando seu aplicativo de API chama a *API externa* é chamado de "callback". Porque o software que o desenvolvedor externo escreveu envia uma solicitação para sua API e então sua API *chama de volta*, enviando uma solicitação para uma *API externa* (que provavelmente foi criada pelo mesmo desenvolvedor).
+
+Nesse caso, você poderia querer documentar como essa API externa *deveria* ser. Que *operação de rota* ela deveria ter, que corpo ela deveria esperar, que resposta ela deveria retornar, etc.
+
+## Um aplicativo com callbacks
+
+Vamos ver tudo isso com um exemplo.
+
+Imagine que você tem um aplicativo que permite criar faturas.
+
+Essas faturas terão um `id`, `title` (opcional), `customer` e `total`.
+
+O usuário da sua API (um desenvolvedor externo) criará uma fatura em sua API com uma solicitação POST.
+
+Então sua API irá (vamos imaginar):
+
+* Enviar uma solicitação de pagamento para o desenvolvedor externo.
+* Coletar o dinheiro.
+* Enviar a notificação de volta para o usuário da API (o desenvolvedor externo).
+* Isso será feito enviando uma solicitação POST (de *sua API*) para alguma *API externa* fornecida por esse desenvolvedor externo (este é o "callback").
+
+## O aplicativo **FastAPI** normal
+
+Vamos primeiro ver como o aplicativo da API normal se pareceria antes de adicionar o callback.
+
+Ele terá uma *operação de rota* que receberá um corpo `Invoice`, e um parâmetro de consulta `callback_url` que conterá a URL para o callback.
+
+Essa parte é bastante normal, a maior parte do código provavelmente já é familiar para você:
+
+```Python hl_lines="9-13 36-53"
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
+```
+
+/// tip | Dica
+
+O parâmetro de consulta `callback_url` usa um tipo Pydantic <a href="https://docs.pydantic.dev/latest/api/networks/" class="external-link" target="_blank">Url</a>.
+
+///
+
+A única coisa nova é o argumento `callbacks=invoices_callback_router.routes` no decorador da *operação de rota*. Veremos o que é isso a seguir.
+
+## Documentando o callback
+
+O código real do callback dependerá muito do seu próprio aplicativo de API.
+
+E provavelmente variará muito de um aplicativo para o outro.
+
+Poderia ser apenas uma ou duas linhas de código, como:
+
+```Python
+callback_url = "https://example.com/api/v1/invoices/events/"
+httpx.post(callback_url, json={"description": "Invoice paid", "paid": True})
+```
+
+Mas possivelmente a parte mais importante do callback é garantir que o usuário da sua API (o desenvolvedor externo) implemente a *API externa* corretamente, de acordo com os dados que *sua API* vai enviar no corpo da solicitação do callback, etc.
+
+Então, o que faremos a seguir é adicionar o código para documentar como essa *API externa* deve ser para receber o callback de *sua API*.
+
+A documentação aparecerá na interface do Swagger em `/docs` em sua API, e permitirá que os desenvolvedores externos saibam como construir a *API externa*.
+
+Esse exemplo não implementa o callback em si (que poderia ser apenas uma linha de código), apenas a parte da documentação.
+
+/// tip | Dica
+
+O callback real é apenas uma solicitação HTTP.
+
+Quando implementando o callback por você mesmo, você pode usar algo como <a href="https://www.python-httpx.org" class="external-link" target="_blank">HTTPX</a> ou <a href="https://requests.readthedocs.io/" class="external-link" target="_blank">Requisições</a>.
+
+///
+
+## Escrevendo o código de documentação do callback
+
+Esse código não será executado em seu aplicativo, nós só precisamos dele para *documentar* como essa *API externa* deveria ser.
+
+Mas, você já sabe como criar facilmente documentação automática para uma API com o **FastAPI**.
+
+Então vamos usar esse mesmo conhecimento para documentar como a *API externa* deveria ser... criando as *operações de rota* que a *API externa* deveria implementar (as que sua API irá chamar).
+
+/// tip | Dica
+
+Quando escrever o código para documentar um callback, pode ser útil imaginar que você é aquele *desenvolvedor externo*. E que você está atualmente implementando a *API externa*, não *sua API*.
+
+Adotar temporariamente esse ponto de vista (do *desenvolvedor externo*) pode ajudar a sentir que é mais óbvio onde colocar os parâmetros, o modelo Pydantic para o corpo, para a resposta, etc. para essa *API externa*.
+
+///
+
+### Criar um `APIRouter` para o callback
+
+Primeiramente crie um novo `APIRouter` que conterá um ou mais callbacks.
+
+```Python hl_lines="3 25"
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
+```
+
+### Crie a *operação de rota* do callback
+
+Para criar a *operação de rota* do callback, use o mesmo `APIRouter` que você criou acima.
+
+Ele deve parecer exatamente como uma *operação de rota* normal do FastAPI:
+
+* Ele provavelmente deveria ter uma declaração do corpo que deveria receber, por exemplo. `body: InvoiceEvent`.
+* E também deveria ter uma declaração de um código de status de resposta, por exemplo. `response_model=InvoiceEventReceived`.
+
+```Python hl_lines="16-18 21-22 28-32"
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
+```
+
+Há 2 diferenças principais de uma *operação de rota* normal:
+
+* Ela não necessita ter nenhum código real, porque seu aplicativo nunca chamará esse código. Ele é usado apenas para documentar a *API externa*. Então, a função poderia ter apenas `pass`.
+* A *rota* pode conter uma <a href="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#key-expression" class="external-link" target="_blank">expressão OpenAPI 3</a> (veja mais abaixo) onde pode usar variáveis com parâmetros e partes da solicitação original enviada para *sua API*.
+
+### A expressão do caminho do callback
+
+A *rota* do callback pode ter uma <a href="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#key-expression" class="external-link" target="_blank">expressão OpenAPI 3</a> que pode conter partes da solicitação original enviada para *sua API*.
+
+Nesse caso, é a `str`:
+
+```Python
+"{$callback_url}/invoices/{$request.body.id}"
+```
+
+Então, se o usuário da sua API (o desenvolvedor externo) enviar uma solicitação para *sua API* para:
+
+```
+https://yourapi.com/invoices/?callback_url=https://www.external.org/events
+```
+
+com um corpo JSON de:
+
+```JSON
+{
+ "id": "2expen51ve",
+ "customer": "Mr. Richie Rich",
+ "total": "9999"
+}
+```
+
+então *sua API* processará a fatura e, em algum momento posterior, enviará uma solicitação de callback para o `callback_url` (a *API externa*):
+
+```
+https://www.external.org/events/invoices/2expen51ve
+```
+
+com um corpo JSON contendo algo como:
+
+```JSON
+{
+ "description": "Payment celebration",
+ "paid": true
+}
+```
+
+e esperaria uma resposta daquela *API externa* com um corpo JSON como:
+
+```JSON
+{
+ "ok": true
+}
+```
+
+/// tip | Dica
+
+Perceba como a URL de callback usada contém a URL recebida como um parâmetro de consulta em `callback_url` (`https://www.external.org/events`) e também o `id` da fatura de dentro do corpo JSON (`2expen51ve`).
+
+///
+
+### Adicionar o roteador de callback
+
+Nesse ponto você tem a(s) *operação de rota de callback* necessária(s) (a(s) que o *desenvolvedor externo* deveria implementar na *API externa*) no roteador de callback que você criou acima.
+
+Agora use o parâmetro `callbacks` no decorador da *operação de rota de sua API* para passar o atributo `.routes` (que é na verdade apenas uma `list` de rotas/*operações de rota*) do roteador de callback que você criou acima:
+
+```Python hl_lines="35"
+{!../../docs_src/openapi_callbacks/tutorial001.py!}
+```
+
+/// tip | Dica
+
+Perceba que você não está passando o roteador em si (`invoices_callback_router`) para `callback=`, mas o atributo `.routes`, como em `invoices_callback_router.routes`.
+
+///
+
+### Verifique a documentação
+
+Agora você pode iniciar seu aplicativo e ir para <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+Você verá sua documentação incluindo uma seção "Callbacks" para sua *operação de rota* que mostra como a *API externa* deveria ser:
+
+<img src="/img/tutorial/openapi-callbacks/image01.png">
From 067ec21580e4aa81973a173cbc5c3158966cb2c5 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 30 Oct 2024 19:54:20 +0000
Subject: [PATCH 342/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4ff93b7bd..90fef213d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/openapi-callbacks.md`. PR [#12705](https://github.com/fastapi/fastapi/pull/12705) by [@devfernandoa](https://github.com/devfernandoa).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/request-files.md`. PR [#12706](https://github.com/fastapi/fastapi/pull/12706) by [@devluisrodrigues](https://github.com/devluisrodrigues).
* 🌐 Add Portuguese Translation for `docs/pt/docs/advanced/custom-response.md`. PR [#12631](https://github.com/fastapi/fastapi/pull/12631) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/metadata.md`. PR [#12538](https://github.com/fastapi/fastapi/pull/12538) by [@LinkolnR](https://github.com/LinkolnR).
From 3184b5c7011759fb573e331aa7a09a14cf089cc5 Mon Sep 17 00:00:00 2001
From: Luis Rodrigues <103431660+devluisrodrigues@users.noreply.github.com>
Date: Wed, 30 Oct 2024 17:00:22 -0300
Subject: [PATCH 343/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/middleware.md`=20(#12704)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/advanced/middleware.md | 96 +++++++++++++++++++++++++++++
1 file changed, 96 insertions(+)
create mode 100644 docs/pt/docs/advanced/middleware.md
diff --git a/docs/pt/docs/advanced/middleware.md b/docs/pt/docs/advanced/middleware.md
new file mode 100644
index 000000000..8167f7d27
--- /dev/null
+++ b/docs/pt/docs/advanced/middleware.md
@@ -0,0 +1,96 @@
+# Middleware Avançado
+
+No tutorial principal você leu como adicionar [Middleware Personalizado](../tutorial/middleware.md){.internal-link target=_blank} à sua aplicação.
+
+E então você também leu como lidar com [CORS com o `CORSMiddleware`](../tutorial/cors.md){.internal-link target=_blank}.
+
+Nesta seção, veremos como usar outros middlewares.
+
+## Adicionando middlewares ASGI
+
+Como o **FastAPI** é baseado no Starlette e implementa a especificação <abbr title="Asynchronous Server Gateway Interface">ASGI</abbr>, você pode usar qualquer middleware ASGI.
+
+O middleware não precisa ser feito para o FastAPI ou Starlette para funcionar, desde que siga a especificação ASGI.
+
+No geral, os middlewares ASGI são classes que esperam receber um aplicativo ASGI como o primeiro argumento.
+
+Então, na documentação de middlewares ASGI de terceiros, eles provavelmente dirão para você fazer algo como:
+
+```Python
+from unicorn import UnicornMiddleware
+
+app = SomeASGIApp()
+
+new_app = UnicornMiddleware(app, some_config="rainbow")
+```
+
+Mas, o FastAPI (na verdade, o Starlette) fornece uma maneira mais simples de fazer isso que garante que os middlewares internos lidem com erros do servidor e que os manipuladores de exceções personalizados funcionem corretamente.
+
+Para isso, você usa `app.add_middleware()` (como no exemplo para CORS).
+
+```Python
+from fastapi import FastAPI
+from unicorn import UnicornMiddleware
+
+app = FastAPI()
+
+app.add_middleware(UnicornMiddleware, some_config="rainbow")
+```
+
+`app.add_middleware()` recebe uma classe de middleware como o primeiro argumento e quaisquer argumentos adicionais a serem passados para o middleware.
+
+## Middlewares Integrados
+
+**FastAPI** inclui vários middlewares para casos de uso comuns, veremos a seguir como usá-los.
+
+/// note | Detalhes Técnicos
+
+Para o próximo exemplo, você também poderia usar `from starlette.middleware.something import SomethingMiddleware`.
+
+**FastAPI** fornece vários middlewares em `fastapi.middleware` apenas como uma conveniência para você, o desenvolvedor. Mas a maioria dos middlewares disponíveis vem diretamente do Starlette.
+
+///
+
+## `HTTPSRedirectMiddleware`
+
+Garante que todas as requisições devem ser `https` ou `wss`.
+
+Qualquer requisição para `http` ou `ws` será redirecionada para o esquema seguro.
+
+{* ../../docs_src/advanced_middleware/tutorial001.py hl[2,6] *}
+
+## `TrustedHostMiddleware`
+
+Garante que todas as requisições recebidas tenham um cabeçalho `Host` corretamente configurado, a fim de proteger contra ataques de cabeçalho de host HTTP.
+
+{* ../../docs_src/advanced_middleware/tutorial002.py hl[2,6:8] *}
+
+Os seguintes argumentos são suportados:
+
+* `allowed_hosts` - Uma lista de nomes de domínio que são permitidos como nomes de host. Domínios com coringa, como `*.example.com`, são suportados para corresponder a subdomínios. Para permitir qualquer nome de host, use `allowed_hosts=["*"]` ou omita o middleware.
+
+Se uma requisição recebida não for validada corretamente, uma resposta `400` será enviada.
+
+## `GZipMiddleware`
+
+Gerencia respostas GZip para qualquer requisição que inclua `"gzip"` no cabeçalho `Accept-Encoding`.
+
+O middleware lidará com respostas padrão e de streaming.
+
+{* ../../docs_src/advanced_middleware/tutorial003.py hl[2,6] *}
+
+Os seguintes argumentos são suportados:
+
+* `minimum_size` - Não comprima respostas menores que este tamanho mínimo em bytes. O padrão é `500`.
+* `compresslevel` - Usado durante a compressão GZip. É um inteiro variando de 1 a 9. O padrão é `9`. Um valor menor resulta em uma compressão mais rápida, mas em arquivos maiores, enquanto um valor maior resulta em uma compressão mais lenta, mas em arquivos menores.
+
+## Outros middlewares
+
+Há muitos outros middlewares ASGI.
+
+Por exemplo:
+
+* <a href="https://github.com/encode/uvicorn/blob/master/uvicorn/middleware/proxy_headers.py" class="external-link" target="_blank">Uvicorn's `ProxyHeadersMiddleware`</a>
+* <a href="https://github.com/florimondmanca/msgpack-asgi" class="external-link" target="_blank">MessagePack</a>
+
+Para checar outros middlewares disponíveis, confira <a href="https://www.starlette.io/middleware/" class="external-link" target="_blank">Documentação de Middlewares do Starlette</a> e a <a href="https://github.com/florimondmanca/awesome-asgi" class="external-link" target="_blank">Lista Incrível do ASGI</a>.
From e93b27452bb60bc0390516d433314372bf9d7fe8 Mon Sep 17 00:00:00 2001
From: namjimin_43 <mimi3123832@gmail.com>
Date: Thu, 31 Oct 2024 05:00:57 +0900
Subject: [PATCH 344/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/advanced/response-directly.md`=20(#126?=
=?UTF-8?q?74)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/advanced/response-directly.md | 67 ++++++++++++++++++++++
1 file changed, 67 insertions(+)
create mode 100644 docs/ko/docs/advanced/response-directly.md
diff --git a/docs/ko/docs/advanced/response-directly.md b/docs/ko/docs/advanced/response-directly.md
new file mode 100644
index 000000000..20389ff2a
--- /dev/null
+++ b/docs/ko/docs/advanced/response-directly.md
@@ -0,0 +1,67 @@
+# 응답을 직접 반환하기
+
+**FastAPI**에서 *경로 작업(path operation)*을 생성할 때, 일반적으로 `dict`, `list`, Pydantic 모델, 데이터베이스 모델 등의 데이터를 반환할 수 있습니다.
+
+기본적으로 **FastAPI**는 [JSON 호환 가능 인코더](../tutorial/encoder.md){.internal-link target=_blank}에 설명된 `jsonable_encoder`를 사용해 해당 반환 값을 자동으로 `JSON`으로 변환합니다.
+
+그런 다음, JSON 호환 데이터(예: `dict`)를 `JSONResponse`에 넣어 사용자의 응답을 전송하는 방식으로 처리됩니다.
+
+그러나 *경로 작업*에서 `JSONResponse`를 직접 반환할 수도 있습니다.
+
+예를 들어, 사용자 정의 헤더나 쿠키를 반환해야 하는 경우에 유용할 수 있습니다.
+
+## `Response` 반환하기
+
+사실, `Response` 또는 그 하위 클래스를 반환할 수 있습니다.
+
+/// tip
+
+`JSONResponse` 자체도 `Response`의 하위 클래스입니다.
+
+///
+
+그리고 `Response`를 반환하면 **FastAPI**가 이를 그대로 전달합니다.
+
+Pydantic 모델로 데이터 변환을 수행하지 않으며, 내용을 다른 형식으로 변환하지 않습니다.
+
+이로 인해 많은 유연성을 얻을 수 있습니다. 어떤 데이터 유형이든 반환할 수 있고, 데이터 선언이나 유효성 검사를 재정의할 수 있습니다.
+
+## `Response`에서 `jsonable_encoder` 사용하기
+
+**FastAPI**는 반환하는 `Response`에 아무런 변환을 하지 않으므로, 그 내용이 준비되어 있어야 합니다.
+
+예를 들어, Pydantic 모델을 `dict`로 변환해 `JSONResponse`에 넣지 않으면 JSON 호환 유형으로 변환된 데이터 유형(예: `datetime`, `UUID` 등)이 사용되지 않습니다.
+
+이러한 경우, 데이터를 응답에 전달하기 전에 `jsonable_encoder`를 사용하여 변환할 수 있습니다:
+
+```Python hl_lines="6-7 21-22"
+{!../../docs_src/response_directly/tutorial001.py!}
+```
+
+/// note | "기술적 세부 사항"
+
+`from starlette.responses import JSONResponse`를 사용할 수도 있습니다.
+
+**FastAPI**는 개발자의 편의를 위해 `starlette.responses`를 `fastapi.responses`로 제공합니다. 그러나 대부분의 가능한 응답은 Starlette에서 직접 제공합니다.
+
+///
+
+## 사용자 정의 `Response` 반환하기
+위 예제는 필요한 모든 부분을 보여주지만, 아직 유용하지는 않습니다. 사실 데이터를 직접 반환하면 **FastAPI**가 이를 `JSONResponse`에 넣고 `dict`로 변환하는 등 모든 작업을 자동으로 처리합니다.
+
+이제, 사용자 정의 응답을 반환하는 방법을 알아보겠습니다.
+
+예를 들어 <a href="https://en.wikipedia.org/wiki/XML" class="external-link" target="_blank">XML</a> 응답을 반환하고 싶다고 가정해보겠습니다.
+
+XML 내용을 문자열에 넣고, 이를 `Response`에 넣어 반환할 수 있습니다:
+
+```Python hl_lines="1 18"
+{!../../docs_src/response_directly/tutorial002.py!}
+```
+
+## 참고 사항
+`Response`를 직접 반환할 때, 그 데이터는 자동으로 유효성 검사되거나, 변환(직렬화)되거나, 문서화되지 않습니다.
+
+그러나 [OpenAPI에서 추가 응답](additional-responses.md){.internal-link target=_blank}에서 설명된 대로 문서화할 수 있습니다.
+
+이후 단락에서 자동 데이터 변환, 문서화 등을 사용하면서 사용자 정의 `Response`를 선언하는 방법을 확인할 수 있습니다.
From 2f7a860ee04e6a98eb7005585c862422f228a12e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 30 Oct 2024 20:02:34 +0000
Subject: [PATCH 345/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 90fef213d..b3035dbdd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/middleware.md`. PR [#12704](https://github.com/fastapi/fastapi/pull/12704) by [@devluisrodrigues](https://github.com/devluisrodrigues).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/openapi-callbacks.md`. PR [#12705](https://github.com/fastapi/fastapi/pull/12705) by [@devfernandoa](https://github.com/devfernandoa).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/request-files.md`. PR [#12706](https://github.com/fastapi/fastapi/pull/12706) by [@devluisrodrigues](https://github.com/devluisrodrigues).
* 🌐 Add Portuguese Translation for `docs/pt/docs/advanced/custom-response.md`. PR [#12631](https://github.com/fastapi/fastapi/pull/12631) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
From bf838898448ae760cf4aae91066e29a24dee4548 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 30 Oct 2024 20:02:57 +0000
Subject: [PATCH 346/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b3035dbdd..bd9d6476f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `docs/ko/docs/advanced/response-directly.md`. PR [#12674](https://github.com/fastapi/fastapi/pull/12674) by [@9zimin9](https://github.com/9zimin9).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/middleware.md`. PR [#12704](https://github.com/fastapi/fastapi/pull/12704) by [@devluisrodrigues](https://github.com/devluisrodrigues).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/openapi-callbacks.md`. PR [#12705](https://github.com/fastapi/fastapi/pull/12705) by [@devfernandoa](https://github.com/devfernandoa).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/request-files.md`. PR [#12706](https://github.com/fastapi/fastapi/pull/12706) by [@devluisrodrigues](https://github.com/devluisrodrigues).
From 05c8ed3312cd3a9993abebd1955c9be7887b0cfa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 31 Oct 2024 10:13:26 +0100
Subject: [PATCH 347/504] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors:=20add?=
=?UTF-8?q?=20Render=20(#12733)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
README.md | 1 +
docs/en/data/sponsors.yml | 3 +++
docs/en/data/sponsors_badge.yml | 1 +
docs/en/docs/deployment/cloud.md | 1 +
docs/en/docs/img/sponsors/render-banner.svg | 25 +++++++++++++++++++++
docs/en/docs/img/sponsors/render.svg | 24 ++++++++++++++++++++
docs/en/overrides/main.html | 6 +++++
7 files changed, 61 insertions(+)
create mode 100644 docs/en/docs/img/sponsors/render-banner.svg
create mode 100644 docs/en/docs/img/sponsors/render.svg
diff --git a/README.md b/README.md
index a12e740f7..62eeda03b 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,7 @@ The key features are:
<a href="https://www.mongodb.com/developer/languages/python/python-quickstart-fastapi/?utm_campaign=fastapi_framework&utm_source=fastapi_sponsorship&utm_medium=web_referral" target="_blank" title="Simplify Full Stack Development with FastAPI & MongoDB"><img src="https://fastapi.tiangolo.com/img/sponsors/mongodb.png"></a>
<a href="https://zuplo.link/fastapi-gh" target="_blank" title="Zuplo: Scale, Protect, Document, and Monetize your FastAPI"><img src="https://fastapi.tiangolo.com/img/sponsors/zuplo.png"></a>
<a href="https://liblab.com?utm_source=fastapi" target="_blank" title="liblab - Generate SDKs from FastAPI"><img src="https://fastapi.tiangolo.com/img/sponsors/liblab.png"></a>
+<a href="https://docs.render.com/deploy-fastapi?utm_source=deploydoc&utm_medium=referral&utm_campaign=fastapi" target="_blank" title="Deploy & scale any full-stack web app on Render. Focus on building apps, not infra."><img src="https://fastapi.tiangolo.com/img/sponsors/render.svg"></a>
<a href="https://github.com/deepset-ai/haystack/" target="_blank" title="Build powerful search from composable, open source building blocks"><img src="https://fastapi.tiangolo.com/img/sponsors/haystack-fastapi.svg"></a>
<a href="https://databento.com/" target="_blank" title="Pay as you go for market data"><img src="https://fastapi.tiangolo.com/img/sponsors/databento.svg"></a>
<a href="https://speakeasy.com?utm_source=fastapi+repo&utm_medium=github+sponsorship" target="_blank" title="SDKs for your API | Speakeasy"><img src="https://fastapi.tiangolo.com/img/sponsors/speakeasy.png"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 6db9c509a..1c83579e2 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -29,6 +29,9 @@ gold:
- url: https://liblab.com?utm_source=fastapi
title: liblab - Generate SDKs from FastAPI
img: https://fastapi.tiangolo.com/img/sponsors/liblab.png
+ - url: https://docs.render.com/deploy-fastapi?utm_source=deploydoc&utm_medium=referral&utm_campaign=fastapi
+ title: Deploy & scale any full-stack web app on Render. Focus on building apps, not infra.
+ img: https://fastapi.tiangolo.com/img/sponsors/render.svg
silver:
- url: https://github.com/deepset-ai/haystack/
title: Build powerful search from composable, open source building blocks
diff --git a/docs/en/data/sponsors_badge.yml b/docs/en/data/sponsors_badge.yml
index d45028aaa..7470b0238 100644
--- a/docs/en/data/sponsors_badge.yml
+++ b/docs/en/data/sponsors_badge.yml
@@ -31,3 +31,4 @@ logins:
- zuplo-oss
- Kong
- speakeasy-api
+ - jess-render
diff --git a/docs/en/docs/deployment/cloud.md b/docs/en/docs/deployment/cloud.md
index 41ada859d..471808851 100644
--- a/docs/en/docs/deployment/cloud.md
+++ b/docs/en/docs/deployment/cloud.md
@@ -15,3 +15,4 @@ You might want to try their services and follow their guides:
* <a href="https://docs.platform.sh/languages/python.html?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" class="external-link" target="_blank">Platform.sh</a>
* <a href="https://docs.porter.run/language-specific-guides/fastapi" class="external-link" target="_blank">Porter</a>
* <a href="https://www.withcoherence.com/?utm_medium=advertising&utm_source=fastapi&utm_campaign=website" class="external-link" target="_blank">Coherence</a>
+* <a href="https://docs.render.com/deploy-fastapi?utm_source=deploydoc&utm_medium=referral&utm_campaign=fastapi" class="external-link" target="_blank">Render</a>
diff --git a/docs/en/docs/img/sponsors/render-banner.svg b/docs/en/docs/img/sponsors/render-banner.svg
new file mode 100644
index 000000000..b8b1ed2e9
--- /dev/null
+++ b/docs/en/docs/img/sponsors/render-banner.svg
@@ -0,0 +1,25 @@
+<svg width="400" height="40" viewBox="0 0 400 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_23_117)">
+<rect width="400" height="40" fill="#8A05FF"/>
+<path d="M47.3359 11.6395C51.0617 11.6395 53.4838 13.7438 53.4838 17.1236C53.4838 19.5981 52.0595 21.4369 49.8264 22.2215L54.204 29.6973H50.957L46.8732 22.6037H42.3628V29.6973H39.5664V11.6395H47.3359ZM42.3587 14.1542V20.1172H47.2031C49.4241 20.1172 50.5708 18.8779 50.5708 17.1236C50.5708 15.3291 49.4281 14.1542 47.2031 14.1542H42.3587Z" fill="white"/>
+<path d="M61.3177 16.6569C65.0434 16.6569 67.4656 19.4251 67.4656 22.8451C67.4656 23.2435 67.4375 23.6579 67.361 24.0683H57.447C57.5677 25.9835 59.2053 27.4884 61.4142 27.4884C63.0116 27.4884 64.287 26.8084 65.2446 25.3076L67.188 26.7199C66.0051 28.8483 63.6754 29.9669 61.4142 29.9669C57.5556 29.9669 54.7191 27.1182 54.7191 23.328C54.7191 19.5176 57.447 16.6569 61.3177 16.6569ZM64.79 22.0968C64.629 20.3022 63.1283 19.0348 61.2895 19.0348C59.3341 19.0348 57.8413 20.2982 57.5114 22.0968H64.79Z" fill="white"/>
+<path d="M69.9119 29.6973V16.9224H72.5594V18.5319C72.9859 17.88 74.197 16.6569 76.4864 16.6569C79.9989 16.6569 81.8498 18.8377 81.8498 21.9398V29.6973H79.2144V22.4991C79.2144 20.3827 78.0556 19.1595 76.072 19.1595C74.1286 19.1595 72.5473 20.3827 72.5473 22.4991V29.6973H69.9119Z" fill="white"/>
+<path d="M90.436 16.6569C92.6047 16.6569 94.0411 17.4535 94.9866 18.6646V10.9595H97.622V29.6973H94.9866V27.9551C94.0411 29.1662 92.6047 29.9629 90.436 29.9629C86.8027 29.9629 84.0225 27.1665 84.0225 23.2435C84.0225 19.3165 86.8027 16.6569 90.436 16.6569ZM86.6539 23.2435C86.6539 25.5973 88.2915 27.593 90.7539 27.593C93.2163 27.593 94.9705 25.5973 94.9705 23.2435C94.9705 20.8897 93.2002 19.0268 90.7539 19.0268C88.2915 19.0227 86.6539 20.8857 86.6539 23.2435Z" fill="white"/>
+<path d="M106.454 16.6569C110.18 16.6569 112.602 19.4251 112.602 22.8451C112.602 23.2435 112.574 23.6579 112.497 24.0683H102.583C102.704 25.9835 104.341 27.4884 106.55 27.4884C108.148 27.4884 109.423 26.8084 110.381 25.3076L112.324 26.7199C111.141 28.8483 108.811 29.9669 106.55 29.9669C102.692 29.9669 99.8551 27.1182 99.8551 23.328C99.8511 19.5176 102.579 16.6569 106.454 16.6569ZM109.926 22.0968C109.765 20.3022 108.264 19.0348 106.426 19.0348C104.47 19.0348 102.977 20.2982 102.647 22.0968H109.926Z" fill="white"/>
+<path d="M115.149 29.6973V16.9224H117.796V18.6646C118.516 17.2685 119.727 16.6569 121.124 16.6569C122.121 16.6569 122.882 16.9747 122.882 16.9747L122.604 19.3969C122.459 19.3446 121.884 19.1032 121.047 19.1032C119.635 19.1032 117.8 19.8476 117.8 22.7365V29.6973H115.149Z" fill="white"/>
+<path d="M23.5327 8.00613C20.7001 7.87335 18.3182 9.91331 17.9118 12.6011C17.8957 12.7258 17.8716 12.8465 17.8515 12.9672C17.2198 16.3148 14.2786 18.8497 10.7459 18.8497C9.48655 18.8497 8.30363 18.5278 7.2736 17.9645C7.14887 17.8961 7 17.9846 7 18.1255V18.8457V29.6973H17.8475V21.5616C17.8475 20.0648 19.0626 18.8497 20.5593 18.8497H23.2712C26.3411 18.8497 28.8116 16.3028 28.6909 13.2046C28.5823 10.4163 26.321 8.13891 23.5327 8.00613Z" fill="white"/>
+<rect width="255" height="40" transform="translate(150)" fill="#E6DAFF"/>
+<path d="M170.555 26H165.349V12.415H170.517C174.279 12.415 176.559 14.847 176.559 19.217C176.559 23.587 174.317 26 170.555 26ZM167.439 24.195H170.422C173.576 24.195 174.393 21.839 174.393 19.217C174.393 16.595 173.576 14.22 170.422 14.22H167.439V24.195ZM186.995 20.946C186.995 21.212 186.995 21.497 186.976 21.649H179.528C179.566 23.264 180.516 24.765 182.435 24.765C184.145 24.765 184.81 23.663 184.981 23.017H186.881C186.368 24.879 184.943 26.285 182.397 26.285C179.319 26.285 177.609 24.1 177.609 21.136C177.609 18.096 179.433 16.006 182.397 16.006C185.342 16.006 186.995 17.944 186.995 20.946ZM179.528 20.186H185.057C185.057 18.666 183.993 17.526 182.34 17.526C180.782 17.526 179.642 18.59 179.528 20.186ZM193.261 16.025C195.731 16.025 197.612 17.963 197.612 21.155C197.612 24.347 195.731 26.266 193.261 26.266C191.741 26.266 190.81 25.582 190.278 24.803H190.24V29.363H188.378V16.31H190.24V17.45H190.278C190.81 16.766 191.741 16.025 193.261 16.025ZM192.957 24.727C194.781 24.727 195.655 23.055 195.655 21.155C195.655 19.255 194.781 17.583 192.957 17.583C191.285 17.583 190.259 18.951 190.259 21.155C190.259 23.34 191.285 24.727 192.957 24.727ZM200.886 26H199.024V12.415H200.886V26ZM207.118 26.285C204.097 26.285 202.273 24.195 202.273 21.155C202.273 18.134 204.097 16.006 207.137 16.006C210.139 16.006 211.963 18.115 211.963 21.136C211.963 24.176 210.139 26.285 207.118 26.285ZM207.137 24.746C209.113 24.746 210.025 23.169 210.025 21.155C210.025 19.122 209.113 17.564 207.137 17.564C205.123 17.564 204.211 19.122 204.211 21.155C204.211 23.169 205.123 24.746 207.137 24.746ZM214.352 29.401C213.934 29.401 213.649 29.363 213.155 29.268V27.748C213.478 27.786 213.649 27.805 213.953 27.805C214.694 27.805 215.568 27.425 215.948 25.905L212.034 16.31H214.067L216.898 23.72H216.936L219.596 16.31H221.553L217.715 26.228C216.784 28.622 215.853 29.401 214.352 29.401ZM234.539 23.435L236.686 26H234.425L233.437 24.784C232.468 25.677 231.195 26.266 229.542 26.266C226.844 26.266 225.324 24.727 225.324 22.694C225.324 20.642 226.882 19.578 228.44 18.685C227.509 17.526 226.863 16.595 226.863 15.36C226.863 13.745 228.003 12.149 230.264 12.149C232.43 12.13 233.646 13.612 233.646 15.341C233.646 16.975 232.563 17.849 230.796 18.913L233.361 21.991C233.76 21.193 234.007 20.262 234.159 19.35H235.945C235.755 20.718 235.318 22.181 234.539 23.435ZM230.264 13.802C229.238 13.802 228.687 14.562 228.687 15.379C228.687 16.177 229.2 16.956 229.903 17.849C231.176 17.089 231.822 16.424 231.822 15.474C231.822 14.543 231.252 13.802 230.264 13.802ZM229.694 24.499C230.796 24.499 231.651 24.081 232.316 23.435L229.314 19.768C228.041 20.547 227.243 21.345 227.243 22.447C227.243 23.644 228.117 24.499 229.694 24.499ZM244.935 26.266C241.99 26.266 240.527 24.746 240.47 22.77H242.351C242.427 23.891 243.111 24.765 244.916 24.765C246.55 24.765 246.987 24.043 246.987 23.34C246.987 22.124 245.695 21.991 244.441 21.725C242.75 21.326 240.812 20.832 240.812 18.818C240.812 17.146 242.161 16.025 244.498 16.025C247.158 16.025 248.431 17.45 248.564 19.122H246.683C246.55 18.381 246.151 17.526 244.536 17.526C243.282 17.526 242.75 18.02 242.75 18.742C242.75 19.749 243.833 19.844 245.201 20.148C246.987 20.566 248.925 21.079 248.925 23.245C248.925 25.126 247.481 26.266 244.935 26.266ZM254.46 26.285C251.572 26.285 249.691 24.195 249.691 21.155C249.691 18.115 251.572 16.025 254.441 16.025C256.93 16.025 258.583 17.64 258.811 19.825H256.892C256.797 18.818 256.227 17.564 254.46 17.564C252.389 17.564 251.629 19.331 251.629 21.155C251.629 22.979 252.389 24.727 254.46 24.727C256.246 24.727 256.797 23.511 256.892 22.409H258.811C258.678 24.632 256.949 26.285 254.46 26.285ZM262.786 26.266C260.848 26.266 259.613 25.145 259.613 23.492C259.613 21.326 261.247 20.68 263.66 20.224C265.18 19.939 266.111 19.749 266.111 18.799C266.111 18.096 265.693 17.507 264.268 17.507C262.577 17.507 262.064 18.039 261.969 19.331H260.069C260.164 17.469 261.38 16.006 264.344 16.006C266.339 16.006 267.935 16.842 267.935 19.35V23.796C267.935 24.499 268.03 24.86 268.391 24.86C268.448 24.86 268.505 24.86 268.619 24.841V25.981C268.296 26.057 267.973 26.095 267.669 26.095C266.738 26.095 266.244 25.734 266.13 24.632H266.092C265.465 25.639 264.363 26.266 262.786 26.266ZM263.204 24.765C264.876 24.765 266.111 23.91 266.111 22.219V20.832C265.807 21.117 264.971 21.326 263.983 21.535C262.273 21.877 261.551 22.352 261.551 23.359C261.551 24.271 262.045 24.765 263.204 24.765ZM271.873 26H270.011V12.415H271.873V26ZM282.665 20.946C282.665 21.212 282.665 21.497 282.646 21.649H275.198C275.236 23.264 276.186 24.765 278.105 24.765C279.815 24.765 280.48 23.663 280.651 23.017H282.551C282.038 24.879 280.613 26.285 278.067 26.285C274.989 26.285 273.279 24.1 273.279 21.136C273.279 18.096 275.103 16.006 278.067 16.006C281.012 16.006 282.665 17.944 282.665 20.946ZM275.198 20.186H280.727C280.727 18.666 279.663 17.526 278.01 17.526C276.452 17.526 275.312 18.59 275.198 20.186ZM290.223 26H288.133V12.415H297.557V14.22H290.223V18.305H296.151V20.11H290.223V26ZM300.263 26.266C298.325 26.266 297.09 25.145 297.09 23.492C297.09 21.326 298.724 20.68 301.137 20.224C302.657 19.939 303.588 19.749 303.588 18.799C303.588 18.096 303.17 17.507 301.745 17.507C300.054 17.507 299.541 18.039 299.446 19.331H297.546C297.641 17.469 298.857 16.006 301.821 16.006C303.816 16.006 305.412 16.842 305.412 19.35V23.796C305.412 24.499 305.507 24.86 305.868 24.86C305.925 24.86 305.982 24.86 306.096 24.841V25.981C305.773 26.057 305.45 26.095 305.146 26.095C304.215 26.095 303.721 25.734 303.607 24.632H303.569C302.942 25.639 301.84 26.266 300.263 26.266ZM300.681 24.765C302.353 24.765 303.588 23.91 303.588 22.219V20.832C303.284 21.117 302.448 21.326 301.46 21.535C299.75 21.877 299.028 22.352 299.028 23.359C299.028 24.271 299.522 24.765 300.681 24.765ZM311.307 26.266C308.362 26.266 306.899 24.746 306.842 22.77H308.723C308.799 23.891 309.483 24.765 311.288 24.765C312.922 24.765 313.359 24.043 313.359 23.34C313.359 22.124 312.067 21.991 310.813 21.725C309.122 21.326 307.184 20.832 307.184 18.818C307.184 17.146 308.533 16.025 310.87 16.025C313.53 16.025 314.803 17.45 314.936 19.122H313.055C312.922 18.381 312.523 17.526 310.908 17.526C309.654 17.526 309.122 18.02 309.122 18.742C309.122 19.749 310.205 19.844 311.573 20.148C313.359 20.566 315.297 21.079 315.297 23.245C315.297 25.126 313.853 26.266 311.307 26.266ZM320.036 24.575C320.359 24.575 320.511 24.556 320.834 24.499V26C320.359 26.095 320.055 26.114 319.656 26.114C318.06 26.114 317.091 25.506 317.091 23.264V17.849H315.685V16.31H317.091V13.194H318.953V16.31H320.815V17.849H318.953V23.321C318.953 24.347 319.238 24.575 320.036 24.575ZM323.261 26H321.057L326.111 12.415H328.372L333.464 26H331.184L330.063 22.732H324.382L323.261 26ZM327.213 14.353L325.009 20.965H329.474L327.251 14.353H327.213ZM336.773 26H334.683V12.415H340.345C342.91 12.415 344.791 13.612 344.791 16.462C344.791 19.312 342.91 20.49 340.345 20.49H336.773V26ZM336.773 18.685H340.25C341.827 18.685 342.625 17.982 342.625 16.462C342.625 14.923 341.827 14.22 340.25 14.22H336.773V18.685ZM348.439 26H346.349V12.415H348.439V26ZM351.25 28.584V27.558C351.953 27.349 352.257 26.988 352.238 26H351.25V23.929H353.321V26C353.321 27.235 352.77 28.204 351.25 28.584Z" fill="#0D0D0D"/>
+<path d="M363.975 14.277C363.082 14.277 362.854 14.714 362.664 15.74L362.55 16.291H364.298L363.899 18.286H362.17L360.669 26H358.047L359.548 18.286H358.237L358.636 16.291H359.947L360.118 15.417C360.574 13.099 361.581 12.263 363.462 12.263C363.918 12.263 364.393 12.301 365.039 12.434L364.659 14.353C364.374 14.296 364.184 14.277 363.975 14.277ZM366.243 26.285C364.476 26.285 363.469 25.392 363.469 23.796C363.469 21.497 365.559 20.737 367.877 20.224C369.549 19.882 370.765 19.635 370.765 18.666C370.765 18.115 370.366 17.811 369.397 17.811C368.162 17.811 367.478 18.305 367.174 19.407H364.666C365.122 17.45 366.661 15.968 369.682 15.968C372.285 15.968 373.691 17.089 373.121 19.92L372.323 23.777C372.209 24.385 372.228 24.632 372.722 24.632C372.779 24.632 372.836 24.632 372.931 24.613L372.646 26C372.114 26.114 371.696 26.171 371.259 26.171C370.176 26.171 369.644 25.696 369.663 24.765H369.625C368.903 25.658 367.725 26.285 366.243 26.285ZM367.383 24.385C368.922 24.385 369.834 23.435 370.138 22.048L370.347 21.079C369.91 21.364 369.682 21.459 368.352 21.744C366.889 22.067 366.11 22.39 366.11 23.321C366.11 24.043 366.604 24.385 367.383 24.385ZM378.263 26.285C375.09 26.285 373.874 24.613 373.95 22.789H376.363C376.325 23.796 376.952 24.423 378.339 24.423C379.46 24.423 380.125 24.024 380.125 23.302C380.125 22.447 379.099 22.219 377.94 21.858C376.477 21.421 374.9 20.87 374.9 19.084C374.9 17.241 376.629 15.987 379.175 15.987C382.082 15.987 383.279 17.621 383.146 19.198H380.714C380.752 18.4 380.315 17.811 379.042 17.811C378.092 17.811 377.446 18.134 377.446 18.799C377.446 19.578 378.358 19.749 379.612 20.148C381.265 20.661 382.728 21.269 382.728 23.036C382.728 24.784 381.265 26.285 378.263 26.285ZM389.857 18.286H388.109L387.197 22.979C386.988 23.986 387.33 24.157 388.014 24.157C388.299 24.157 388.47 24.138 388.85 24.081L388.47 25.981C387.843 26.114 387.368 26.171 386.855 26.171C384.917 26.171 384.138 25.297 384.575 22.998L385.506 18.286H384.138L384.518 16.291H385.886L386.456 13.422H389.059L388.508 16.291H390.237L389.857 18.286Z" fill="#8A05FF"/>
+<path d="M137 30L150 30L150 40L137 40L137 30Z" fill="#E6DAFF"/>
+<path d="M131 24L150 24L150 27L131 27L131 24Z" fill="#E6DAFF"/>
+<path d="M134 18L150 18L150 21L134 21L134 18Z" fill="#E6DAFF"/>
+<path d="M139 6L160 6L160 9L139 9L139 6Z" fill="#8A05FF"/>
+<path d="M139 4.54598e-06L165 0L165 3L139 3L139 4.54598e-06Z" fill="#8A05FF"/>
+</g>
+<defs>
+<clipPath id="clip0_23_117">
+<rect width="400" height="40" fill="white"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/docs/en/docs/img/sponsors/render.svg b/docs/en/docs/img/sponsors/render.svg
new file mode 100644
index 000000000..4a830482d
--- /dev/null
+++ b/docs/en/docs/img/sponsors/render.svg
@@ -0,0 +1,24 @@
+<svg width="240" height="100" viewBox="0 0 240 100" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_23_129)">
+<rect width="240" height="100" fill="#8A05FF"/>
+<path d="M72.1133 18.3337C77.5735 18.3337 81.1233 21.4176 81.1233 26.3708C81.1233 29.9972 79.0359 32.692 75.7633 33.8418L82.1788 44.7978H77.4202L71.4352 34.402H64.8252V44.7978H60.7271V18.3337H72.1133ZM64.8193 22.0191V30.7579H71.9187C75.1736 30.7579 76.8542 28.9417 76.8542 26.3708C76.8542 23.7409 75.1795 22.0191 71.9187 22.0191H64.8193Z" fill="white"/>
+<path d="M92.6039 25.6868C98.0641 25.6868 101.614 29.7437 101.614 34.7558C101.614 35.3396 101.573 35.9469 101.461 36.5484H86.9314C87.1083 39.3552 89.5082 41.5605 92.7454 41.5605C95.0863 41.5605 96.9556 40.564 98.3589 38.3646L101.207 40.4343C99.4734 43.5536 96.0593 45.1929 92.7454 45.1929C87.0906 45.1929 82.9335 41.018 82.9335 35.4634C82.9335 29.8793 86.9314 25.6868 92.6039 25.6868ZM97.6926 33.659C97.4568 31.0291 95.2573 29.1717 92.5626 29.1717C89.6969 29.1717 87.5093 31.0232 87.0257 33.659H97.6926Z" fill="white"/>
+<path d="M105.199 44.7978V26.076H109.079V28.4346C109.704 27.4794 111.479 25.6868 114.834 25.6868C119.982 25.6868 122.694 28.8828 122.694 33.4291V44.7978H118.832V34.2487C118.832 31.1471 117.134 29.3545 114.227 29.3545C111.379 29.3545 109.061 31.1471 109.061 34.2487V44.7978H105.199Z" fill="white"/>
+<path d="M135.277 25.6868C138.456 25.6868 140.561 26.8543 141.946 28.6292V17.3372H145.809V44.7978H141.946V42.2445C140.561 44.0194 138.456 45.187 135.277 45.187C129.953 45.187 125.878 41.0888 125.878 35.3396C125.878 29.5845 129.953 25.6868 135.277 25.6868ZM129.735 35.3396C129.735 38.7891 132.134 41.7138 135.743 41.7138C139.352 41.7138 141.923 38.7891 141.923 35.3396C141.923 31.8901 139.328 29.1599 135.743 29.1599C132.134 29.154 129.735 31.8842 129.735 35.3396Z" fill="white"/>
+<path d="M158.752 25.6868C164.212 25.6868 167.761 29.7437 167.761 34.7558C167.761 35.3396 167.72 35.9469 167.608 36.5484H153.079C153.256 39.3552 155.656 41.5605 158.893 41.5605C161.234 41.5605 163.103 40.564 164.507 38.3646L167.355 40.4343C165.621 43.5536 162.207 45.1929 158.893 45.1929C153.238 45.1929 149.081 41.018 149.081 35.4634C149.075 29.8793 153.073 25.6868 158.752 25.6868ZM163.84 33.659C163.604 31.0291 161.405 29.1717 158.71 29.1717C155.845 29.1717 153.657 31.0232 153.173 33.659H163.84Z" fill="white"/>
+<path d="M171.494 44.7978V26.076H175.374V28.6292C176.429 26.5831 178.204 25.6868 180.25 25.6868C181.713 25.6868 182.827 26.1526 182.827 26.1526L182.42 29.7024C182.208 29.6257 181.365 29.2719 180.138 29.2719C178.069 29.2719 175.38 30.3628 175.38 34.5966V44.7978H171.494Z" fill="white"/>
+<path d="M37.229 13.009C33.0778 12.8144 29.587 15.804 28.9915 19.7429C28.9679 19.9257 28.9325 20.1026 28.903 20.2795C27.9773 25.1855 23.6669 28.9004 18.4897 28.9004C16.6441 28.9004 14.9105 28.4287 13.401 27.6032C13.2182 27.5029 13 27.6326 13 27.839V28.8945V44.7978H28.8971V32.8748C28.8971 30.6812 30.6779 28.9004 32.8714 28.9004H36.8457C41.3448 28.9004 44.9653 25.1678 44.7884 20.6274C44.6292 16.5411 41.3153 13.2036 37.229 13.009Z" fill="white"/>
+<path d="M19.3913 70H14.4593V57.13H19.3553C22.9193 57.13 25.0793 59.434 25.0793 63.574C25.0793 67.714 22.9553 70 19.3913 70ZM16.4393 68.29H19.2653C22.2533 68.29 23.0273 66.058 23.0273 63.574C23.0273 61.09 22.2533 58.84 19.2653 58.84H16.4393V68.29ZM34.9661 65.212C34.9661 65.464 34.9661 65.734 34.9481 65.878H27.8921C27.9281 67.408 28.8281 68.83 30.6461 68.83C32.2661 68.83 32.8961 67.786 33.0581 67.174H34.8581C34.3721 68.938 33.0221 70.27 30.6101 70.27C27.6941 70.27 26.0741 68.2 26.0741 65.392C26.0741 62.512 27.8021 60.532 30.6101 60.532C33.4001 60.532 34.9661 62.368 34.9661 65.212ZM27.8921 64.492H33.1301C33.1301 63.052 32.1221 61.972 30.5561 61.972C29.0801 61.972 28.0001 62.98 27.8921 64.492ZM40.9022 60.55C43.2422 60.55 45.0242 62.386 45.0242 65.41C45.0242 68.434 43.2422 70.252 40.9022 70.252C39.4622 70.252 38.5802 69.604 38.0762 68.866H38.0402V73.186H36.2762V60.82H38.0402V61.9H38.0762C38.5802 61.252 39.4622 60.55 40.9022 60.55ZM40.6142 68.794C42.3422 68.794 43.1702 67.21 43.1702 65.41C43.1702 63.61 42.3422 62.026 40.6142 62.026C39.0302 62.026 38.0582 63.322 38.0582 65.41C38.0582 67.48 39.0302 68.794 40.6142 68.794ZM48.1258 70H46.3618V57.13H48.1258V70ZM54.0299 70.27C51.1679 70.27 49.4399 68.29 49.4399 65.41C49.4399 62.548 51.1679 60.532 54.0479 60.532C56.8919 60.532 58.6199 62.53 58.6199 65.392C58.6199 68.272 56.8919 70.27 54.0299 70.27ZM54.0479 68.812C55.9199 68.812 56.7839 67.318 56.7839 65.41C56.7839 63.484 55.9199 62.008 54.0479 62.008C52.1399 62.008 51.2759 63.484 51.2759 65.41C51.2759 67.318 52.1399 68.812 54.0479 68.812ZM60.8832 73.222C60.4872 73.222 60.2172 73.186 59.7492 73.096V71.656C60.0552 71.692 60.2172 71.71 60.5052 71.71C61.2072 71.71 62.0352 71.35 62.3952 69.91L58.6872 60.82H60.6132L63.2952 67.84H63.3312L65.8512 60.82H67.7052L64.0692 70.216C63.1872 72.484 62.3052 73.222 60.8832 73.222ZM80.0073 67.57L82.0413 70H79.8993L78.9633 68.848C78.0453 69.694 76.8393 70.252 75.2733 70.252C72.7173 70.252 71.2773 68.794 71.2773 66.868C71.2773 64.924 72.7533 63.916 74.2293 63.07C73.3473 61.972 72.7353 61.09 72.7353 59.92C72.7353 58.39 73.8153 56.878 75.9573 56.878C78.0093 56.86 79.1613 58.264 79.1613 59.902C79.1613 61.45 78.1353 62.278 76.4613 63.286L78.8913 66.202C79.2693 65.446 79.5033 64.564 79.6473 63.7H81.3393C81.1593 64.996 80.7453 66.382 80.0073 67.57ZM75.9573 58.444C74.9853 58.444 74.4633 59.164 74.4633 59.938C74.4633 60.694 74.9493 61.432 75.6153 62.278C76.8213 61.558 77.4333 60.928 77.4333 60.028C77.4333 59.146 76.8933 58.444 75.9573 58.444ZM75.4173 68.578C76.4613 68.578 77.2713 68.182 77.9013 67.57L75.0573 64.096C73.8513 64.834 73.0953 65.59 73.0953 66.634C73.0953 67.768 73.9233 68.578 75.4173 68.578ZM89.8568 70.252C87.0668 70.252 85.6808 68.812 85.6268 66.94H87.4088C87.4808 68.002 88.1288 68.83 89.8388 68.83C91.3868 68.83 91.8008 68.146 91.8008 67.48C91.8008 66.328 90.5768 66.202 89.3888 65.95C87.7868 65.572 85.9508 65.104 85.9508 63.196C85.9508 61.612 87.2288 60.55 89.4428 60.55C91.9628 60.55 93.1688 61.9 93.2948 63.484H91.5128C91.3868 62.782 91.0088 61.972 89.4788 61.972C88.2908 61.972 87.7868 62.44 87.7868 63.124C87.7868 64.078 88.8128 64.168 90.1088 64.456C91.8008 64.852 93.6368 65.338 93.6368 67.39C93.6368 69.172 92.2688 70.252 89.8568 70.252ZM98.8799 70.27C96.1439 70.27 94.3619 68.29 94.3619 65.41C94.3619 62.53 96.1439 60.55 98.8619 60.55C101.22 60.55 102.786 62.08 103.002 64.15H101.184C101.094 63.196 100.554 62.008 98.8799 62.008C96.9179 62.008 96.1979 63.682 96.1979 65.41C96.1979 67.138 96.9179 68.794 98.8799 68.794C100.572 68.794 101.094 67.642 101.184 66.598H103.002C102.876 68.704 101.238 70.27 98.8799 70.27ZM106.768 70.252C104.932 70.252 103.762 69.19 103.762 67.624C103.762 65.572 105.31 64.96 107.596 64.528C109.036 64.258 109.918 64.078 109.918 63.178C109.918 62.512 109.522 61.954 108.172 61.954C106.57 61.954 106.084 62.458 105.994 63.682H104.194C104.284 61.918 105.436 60.532 108.244 60.532C110.134 60.532 111.646 61.324 111.646 63.7V67.912C111.646 68.578 111.736 68.92 112.078 68.92C112.132 68.92 112.186 68.92 112.294 68.902V69.982C111.988 70.054 111.682 70.09 111.394 70.09C110.512 70.09 110.044 69.748 109.936 68.704H109.9C109.306 69.658 108.262 70.252 106.768 70.252ZM107.164 68.83C108.748 68.83 109.918 68.02 109.918 66.418V65.104C109.63 65.374 108.838 65.572 107.902 65.77C106.282 66.094 105.598 66.544 105.598 67.498C105.598 68.362 106.066 68.83 107.164 68.83ZM115.377 70H113.613V57.13H115.377V70ZM125.601 65.212C125.601 65.464 125.601 65.734 125.583 65.878H118.527C118.563 67.408 119.463 68.83 121.281 68.83C122.901 68.83 123.531 67.786 123.693 67.174H125.493C125.007 68.938 123.657 70.27 121.245 70.27C118.329 70.27 116.709 68.2 116.709 65.392C116.709 62.512 118.437 60.532 121.245 60.532C124.035 60.532 125.601 62.368 125.601 65.212ZM118.527 64.492H123.765C123.765 63.052 122.757 61.972 121.191 61.972C119.715 61.972 118.635 62.98 118.527 64.492ZM132.761 70H130.781V57.13H139.709V58.84H132.761V62.71H138.377V64.42H132.761V70ZM142.273 70.252C140.437 70.252 139.267 69.19 139.267 67.624C139.267 65.572 140.815 64.96 143.101 64.528C144.541 64.258 145.423 64.078 145.423 63.178C145.423 62.512 145.027 61.954 143.677 61.954C142.075 61.954 141.589 62.458 141.499 63.682H139.699C139.789 61.918 140.941 60.532 143.749 60.532C145.639 60.532 147.151 61.324 147.151 63.7V67.912C147.151 68.578 147.241 68.92 147.583 68.92C147.637 68.92 147.691 68.92 147.799 68.902V69.982C147.493 70.054 147.187 70.09 146.899 70.09C146.017 70.09 145.549 69.748 145.441 68.704H145.405C144.811 69.658 143.767 70.252 142.273 70.252ZM142.669 68.83C144.253 68.83 145.423 68.02 145.423 66.418V65.104C145.135 65.374 144.343 65.572 143.407 65.77C141.787 66.094 141.103 66.544 141.103 67.498C141.103 68.362 141.571 68.83 142.669 68.83ZM152.735 70.252C149.945 70.252 148.559 68.812 148.505 66.94H150.287C150.359 68.002 151.007 68.83 152.717 68.83C154.265 68.83 154.679 68.146 154.679 67.48C154.679 66.328 153.455 66.202 152.267 65.95C150.665 65.572 148.829 65.104 148.829 63.196C148.829 61.612 150.107 60.55 152.321 60.55C154.841 60.55 156.047 61.9 156.173 63.484H154.391C154.265 62.782 153.887 61.972 152.357 61.972C151.169 61.972 150.665 62.44 150.665 63.124C150.665 64.078 151.691 64.168 152.987 64.456C154.679 64.852 156.515 65.338 156.515 67.39C156.515 69.172 155.147 70.252 152.735 70.252ZM161.005 68.65C161.311 68.65 161.455 68.632 161.761 68.578V70C161.311 70.09 161.023 70.108 160.645 70.108C159.133 70.108 158.215 69.532 158.215 67.408V62.278H156.883V60.82H158.215V57.868H159.979V60.82H161.743V62.278H159.979V67.462C159.979 68.434 160.249 68.65 161.005 68.65ZM164.06 70H161.972L166.76 57.13H168.902L173.726 70H171.566L170.504 66.904H165.122L164.06 70ZM167.804 58.966L165.716 65.23H169.946L167.84 58.966H167.804ZM176.861 70H174.881V57.13H180.245C182.675 57.13 184.457 58.264 184.457 60.964C184.457 63.664 182.675 64.78 180.245 64.78H176.861V70ZM176.861 63.07H180.155C181.649 63.07 182.405 62.404 182.405 60.964C182.405 59.506 181.649 58.84 180.155 58.84H176.861V63.07ZM187.913 70H185.933V57.13H187.913V70ZM190.576 72.448V71.476C191.242 71.278 191.53 70.936 191.512 70H190.576V68.038H192.538V70C192.538 71.17 192.016 72.088 190.576 72.448ZM203.114 59.128C202.268 59.128 202.052 59.578 201.854 60.586L201.818 60.784H203.42L202.988 62.944H201.386L200.018 70H197.138L198.524 62.944H197.264L197.696 60.784H198.938L199.064 60.136C199.496 57.886 200.45 56.968 202.412 56.968C202.898 56.968 203.456 57.022 204.122 57.166L203.708 59.218C203.474 59.146 203.276 59.128 203.114 59.128ZM205.02 70.288C203.364 70.288 202.41 69.442 202.41 67.948C202.41 65.716 204.498 64.96 206.622 64.492C208.116 64.168 209.214 63.916 209.214 63.106C209.214 62.638 208.854 62.404 208.116 62.404C207.072 62.404 206.496 62.854 206.226 63.772H203.508C203.922 61.954 205.398 60.478 208.44 60.478C211.014 60.478 212.418 61.54 211.806 64.492L211.104 67.876C210.996 68.416 211.014 68.578 211.482 68.578C211.518 68.578 211.536 68.578 211.626 68.56L211.338 70.036C210.726 70.144 210.276 70.198 209.844 70.198C208.728 70.198 208.188 69.73 208.188 68.884H208.152C207.504 69.694 206.406 70.288 205.02 70.288ZM206.37 68.272C207.72 68.272 208.368 67.372 208.638 66.22L208.818 65.464C208.386 65.698 208.224 65.788 207.036 66.058C205.938 66.31 205.344 66.616 205.344 67.372C205.344 67.984 205.758 68.272 206.37 68.272ZM216.475 70.288C213.289 70.288 212.263 68.614 212.371 66.94H214.999C214.945 67.858 215.485 68.308 216.565 68.308C217.519 68.308 218.023 67.966 218.023 67.426C218.023 66.688 217.033 66.508 215.989 66.184C214.621 65.752 213.235 65.194 213.235 63.574C213.235 61.828 214.873 60.496 217.501 60.496C220.399 60.496 221.497 62.116 221.335 63.592H218.689C218.743 62.818 218.347 62.404 217.339 62.404C216.511 62.404 216.043 62.692 216.043 63.196C216.043 63.88 216.889 64.024 217.987 64.366C219.553 64.852 220.903 65.482 220.903 67.102C220.903 68.686 219.607 70.288 216.475 70.288ZM227.725 62.944H226.123L225.349 66.94C225.151 67.93 225.511 68.02 226.069 68.02C226.339 68.02 226.501 68.002 226.861 67.948L226.465 69.982C225.817 70.126 225.295 70.18 224.719 70.18C222.703 70.18 222.019 69.262 222.451 67.012L223.243 62.944H221.965L222.379 60.784H223.657L224.161 58.21H227.041L226.537 60.784H228.139L227.725 62.944Z" fill="white"/>
+<rect y="92" width="240" height="8" fill="#E6DAFF"/>
+<rect width="5" height="18" transform="matrix(1 0 0 -1 215 18)" fill="#E6DAFF"/>
+<rect width="5" height="18" transform="matrix(1 0 0 -1 205 18)" fill="#E6DAFF"/>
+<rect width="5" height="18" transform="matrix(1 0 0 -1 235 18)" fill="#E6DAFF"/>
+<rect width="5" height="18" transform="matrix(1 0 0 -1 225 18)" fill="#E6DAFF"/>
+<rect y="83" width="64" height="9" fill="#E6DAFF"/>
+</g>
+<defs>
+<clipPath id="clip0_23_129">
+<rect width="240" height="100" fill="white"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index 462907e7c..70a05831f 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -82,6 +82,12 @@
<img class="sponsor-image" src="/img/sponsors/liblab-banner.png" />
</a>
</div>
+ <div class="item">
+ <a title="Deploy & scale any full-stack web app on Render. Focus on building apps, not infra." style="display: block; position: relative;" href="https://docs.render.com/deploy-fastapi?utm_source=deploydoc&utm_medium=referral&utm_campaign=fastapi" target="_blank">
+ <span class="sponsor-badge">sponsor</span>
+ <img class="sponsor-image" src="/img/sponsors/render-banner.svg" />
+ </a>
+ </div>
</div>
</div>
{% endblock %}
From 086e3ca54b09d9e331cc0c60399be22856cbf69e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 31 Oct 2024 09:13:53 +0000
Subject: [PATCH 348/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index bd9d6476f..9a5a7533f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -40,6 +40,7 @@ hide:
### Internal
+* 🔧 Update sponsors: add Render. PR [#12733](https://github.com/fastapi/fastapi/pull/12733) by [@tiangolo](https://github.com/tiangolo).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12707](https://github.com/fastapi/fastapi/pull/12707) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
## 0.115.4
From bb7921be252b5fa95162ccbcb6c4fff8af1f8153 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?L=C3=ADdia?= <lidiaalves2002@outlook.com>
Date: Thu, 31 Oct 2024 09:17:45 -0300
Subject: [PATCH 349/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/tutorial/security/simple-oauth2.md?=
=?UTF-8?q?`=20(#12520)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../docs/tutorial/security/simple-oauth2.md | 539 ++++++++++++++++++
1 file changed, 539 insertions(+)
create mode 100644 docs/pt/docs/tutorial/security/simple-oauth2.md
diff --git a/docs/pt/docs/tutorial/security/simple-oauth2.md b/docs/pt/docs/tutorial/security/simple-oauth2.md
new file mode 100644
index 000000000..4e55f8c25
--- /dev/null
+++ b/docs/pt/docs/tutorial/security/simple-oauth2.md
@@ -0,0 +1,539 @@
+# Simples OAuth2 com senha e Bearer
+
+Agora vamos construir a partir do capítulo anterior e adicionar as partes que faltam para ter um fluxo de segurança completo.
+
+## Pegue o `username` (nome de usuário) e `password` (senha)
+
+É utilizado o utils de segurança da **FastAPI** para obter o `username` e a `password`.
+
+OAuth2 especifica que ao usar o "password flow" (fluxo de senha), que estamos usando, o cliente/usuário deve enviar os campos `username` e `password` como dados do formulário.
+
+E a especificação diz que os campos devem ser nomeados assim. Portanto, `user-name` ou `email` não funcionariam.
+
+Mas não se preocupe, você pode mostrá-lo como quiser aos usuários finais no frontend.
+
+E seus modelos de banco de dados podem usar qualquer outro nome que você desejar.
+
+Mas para a *operação de rota* de login, precisamos usar esses nomes para serem compatíveis com a especificação (e poder, por exemplo, usar o sistema integrado de documentação da API).
+
+A especificação também afirma que o `username` e a `password` devem ser enviados como dados de formulário (portanto, não há JSON aqui).
+
+### `scope`
+
+A especificação também diz que o cliente pode enviar outro campo de formulário "`scope`" (Escopo).
+
+O nome do campo do formulário é `scope` (no singular), mas na verdade é uma longa string com "escopos" separados por espaços.
+
+Cada “scope” é apenas uma string (sem espaços).
+
+Normalmente são usados para declarar permissões de segurança específicas, por exemplo:
+
+* `users:read` ou `users:write` são exemplos comuns.
+* `instagram_basic` é usado pelo Facebook e Instagram.
+* `https://www.googleapis.com/auth/drive` é usado pelo Google.
+
+/// info | Informação
+
+No OAuth2, um "scope" é apenas uma string que declara uma permissão específica necessária.
+
+Não importa se tem outros caracteres como `:` ou se é uma URL.
+
+Esses detalhes são específicos da implementação.
+
+Para OAuth2 são apenas strings.
+
+///
+
+## Código para conseguir o `username` e a `password`
+
+Agora vamos usar os utilitários fornecidos pelo **FastAPI** para lidar com isso.
+
+### `OAuth2PasswordRequestForm`
+
+Primeiro, importe `OAuth2PasswordRequestForm` e use-o como uma dependência com `Depends` na *operação de rota* para `/token`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="4 78"
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="4 78"
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="4 79"
+{!> ../../docs_src/security/tutorial003_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira usar a versão `Annotated`, se possível.
+
+///
+
+```Python hl_lines="2 74"
+{!> ../../docs_src/security/tutorial003_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira usar a versão `Annotated`, se possível.
+
+///
+
+```Python hl_lines="4 76"
+{!> ../../docs_src/security/tutorial003.py!}
+```
+
+////
+
+`OAuth2PasswordRequestForm` é uma dependência de classe que declara um corpo de formulário com:
+
+* O `username`.
+* A `password`.
+* Um campo `scope` opcional como uma string grande, composta de strings separadas por espaços.
+* Um `grant_type` (tipo de concessão) opcional.
+
+/// tip | Dica
+
+A especificação OAuth2 na verdade *requer* um campo `grant_type` com um valor fixo de `password`, mas `OAuth2PasswordRequestForm` não o impõe.
+
+Se você precisar aplicá-lo, use `OAuth2PasswordRequestFormStrict` em vez de `OAuth2PasswordRequestForm`.
+
+///
+
+* Um `client_id` opcional (não precisamos dele em nosso exemplo).
+* Um `client_secret` opcional (não precisamos dele em nosso exemplo).
+
+/// info | Informação
+
+O `OAuth2PasswordRequestForm` não é uma classe especial para **FastAPI** como é `OAuth2PasswordBearer`.
+
+`OAuth2PasswordBearer` faz com que **FastAPI** saiba que é um esquema de segurança. Portanto, é adicionado dessa forma ao OpenAPI.
+
+Mas `OAuth2PasswordRequestForm` é apenas uma dependência de classe que você mesmo poderia ter escrito ou poderia ter declarado os parâmetros do `Form` (formulário) diretamente.
+
+Mas como é um caso de uso comum, ele é fornecido diretamente pelo **FastAPI**, apenas para facilitar.
+
+///
+
+### Use os dados do formulário
+
+/// tip | Dica
+
+A instância da classe de dependência `OAuth2PasswordRequestForm` não terá um atributo `scope` com a string longa separada por espaços, em vez disso, terá um atributo `scopes` com a lista real de strings para cada escopo enviado.
+
+Não estamos usando `scopes` neste exemplo, mas a funcionalidade está disponível se você precisar.
+
+///
+
+Agora, obtenha os dados do usuário do banco de dados (falso), usando o `username` do campo do formulário.
+
+Se não existir tal usuário, retornaremos um erro dizendo "Incorrect username or password" (Nome de usuário ou senha incorretos).
+
+Para o erro, usamos a exceção `HTTPException`:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="3 79-81"
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="3 79-81"
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="3 80-82"
+{!> ../../docs_src/security/tutorial003_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira usar a versão `Annotated`, se possível.
+
+///
+
+```Python hl_lines="1 75-77"
+{!> ../../docs_src/security/tutorial003_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira usar a versão `Annotated`, se possível.
+
+///
+
+```Python hl_lines="3 77-79"
+{!> ../../docs_src/security/tutorial003.py!}
+```
+
+////
+
+### Confira a password (senha)
+
+Neste ponto temos os dados do usuário do nosso banco de dados, mas não verificamos a senha.
+
+Vamos colocar esses dados primeiro no modelo `UserInDB` do Pydantic.
+
+Você nunca deve salvar senhas em texto simples, portanto, usaremos o sistema de hashing de senhas (falsas).
+
+Se as senhas não corresponderem, retornaremos o mesmo erro.
+
+#### Hashing de senha
+
+"Hashing" significa: converter algum conteúdo (uma senha neste caso) em uma sequência de bytes (apenas uma string) que parece algo sem sentido.
+
+Sempre que você passa exatamente o mesmo conteúdo (exatamente a mesma senha), você obtém exatamente a mesma sequência aleatória de caracteres.
+
+Mas você não pode converter a sequência aleatória de caracteres de volta para a senha.
+
+##### Porque usar hashing de senha
+
+Se o seu banco de dados for roubado, o ladrão não terá as senhas em texto simples dos seus usuários, apenas os hashes.
+
+Assim, o ladrão não poderá tentar usar essas mesmas senhas em outro sistema (como muitos usuários usam a mesma senha em todos os lugares, isso seria perigoso).
+
+//// tab | Python 3.10+
+
+```Python hl_lines="82-85"
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="82-85"
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="83-86"
+{!> ../../docs_src/security/tutorial003_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira usar a versão `Annotated`, se possível.
+
+///
+
+```Python hl_lines="78-81"
+{!> ../../docs_src/security/tutorial003_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira usar a versão `Annotated`, se possível.
+
+///
+
+```Python hl_lines="80-83"
+{!> ../../docs_src/security/tutorial003.py!}
+```
+
+////
+
+#### Sobre `**user_dict`
+
+`UserInDB(**user_dict)` significa:
+
+*Passe as keys (chaves) e values (valores) de `user_dict` diretamente como argumentos de valor-chave, equivalente a:*
+
+```Python
+UserInDB(
+ username = user_dict["username"],
+ email = user_dict["email"],
+ full_name = user_dict["full_name"],
+ disabled = user_dict["disabled"],
+ hashed_password = user_dict["hashed_password"],
+)
+```
+
+/// info | Informação
+
+Para uma explicação mais completa de `**user_dict`, verifique [a documentação para **Extra Models**](../extra-models.md#about-user_indict){.internal-link target=_blank}.
+
+///
+
+## Retorne o token
+
+A resposta do endpoint `token` deve ser um objeto JSON.
+
+Deve ter um `token_type`. No nosso caso, como estamos usando tokens "Bearer", o tipo de token deve ser "`bearer`".
+
+E deve ter um `access_token`, com uma string contendo nosso token de acesso.
+
+Para este exemplo simples, seremos completamente inseguros e retornaremos o mesmo `username` do token.
+
+/// tip | Dica
+
+No próximo capítulo, você verá uma implementação realmente segura, com hash de senha e tokens <abbr title="JSON Web Tokens">JWT</abbr>.
+
+Mas, por enquanto, vamos nos concentrar nos detalhes específicos de que precisamos.
+
+///
+
+//// tab | Python 3.10+
+
+```Python hl_lines="87"
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="87"
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="88"
+{!> ../../docs_src/security/tutorial003_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira usar a versão `Annotated`, se possível.
+
+///
+
+```Python hl_lines="83"
+{!> ../../docs_src/security/tutorial003_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira usar a versão `Annotated`, se possível.
+
+///
+
+```Python hl_lines="85"
+{!> ../../docs_src/security/tutorial003.py!}
+```
+
+////
+
+/// tip | Dica
+
+Pela especificação, você deve retornar um JSON com um `access_token` e um `token_type`, o mesmo que neste exemplo.
+
+Isso é algo que você mesmo deve fazer em seu código e certifique-se de usar essas chaves JSON.
+
+É quase a única coisa que você deve se lembrar de fazer corretamente, para estar em conformidade com as especificações.
+
+De resto, **FastAPI** cuida disso para você.
+
+///
+
+## Atualize as dependências
+
+Agora vamos atualizar nossas dependências.
+
+Queremos obter o `user_user` *somente* se este usuário estiver ativo.
+
+Portanto, criamos uma dependência adicional `get_current_active_user` que por sua vez usa `get_current_user` como dependência.
+
+Ambas as dependências retornarão apenas um erro HTTP se o usuário não existir ou se estiver inativo.
+
+Portanto, em nosso endpoint, só obteremos um usuário se o usuário existir, tiver sido autenticado corretamente e estiver ativo:
+
+//// tab | Python 3.10+
+
+```Python hl_lines="58-66 69-74 94"
+{!> ../../docs_src/security/tutorial003_an_py310.py!}
+```
+
+////
+
+//// tab | Python 3.9+
+
+```Python hl_lines="58-66 69-74 94"
+{!> ../../docs_src/security/tutorial003_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="59-67 70-75 95"
+{!> ../../docs_src/security/tutorial003_an.py!}
+```
+
+////
+
+//// tab | Python 3.10+ non-Annotated
+
+/// tip | Dica
+
+Prefira usar a versão `Annotated`, se possível.
+
+///
+
+```Python hl_lines="56-64 67-70 88"
+{!> ../../docs_src/security/tutorial003_py310.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | Dica
+
+Prefira usar a versão `Annotated`, se possível.
+
+///
+
+```Python hl_lines="58-66 69-72 90"
+{!> ../../docs_src/security/tutorial003.py!}
+```
+
+////
+
+/// info | Informação
+
+O cabeçalho adicional `WWW-Authenticate` com valor `Bearer` que estamos retornando aqui também faz parte da especificação.
+
+Qualquer código de status HTTP (erro) 401 "UNAUTHORIZED" também deve retornar um cabeçalho `WWW-Authenticate`.
+
+No caso de tokens ao portador (nosso caso), o valor desse cabeçalho deve ser `Bearer`.
+
+Na verdade, você pode pular esse cabeçalho extra e ainda funcionaria.
+
+Mas é fornecido aqui para estar em conformidade com as especificações.
+
+Além disso, pode haver ferramentas que esperam e usam isso (agora ou no futuro) e que podem ser úteis para você ou seus usuários, agora ou no futuro.
+
+Esse é o benefício dos padrões...
+
+///
+
+## Veja em ação
+
+Abra o docs interativo: <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+### Autenticação
+
+Clique no botão "Authorize".
+
+Use as credenciais:
+
+User: `johndoe`
+
+Password: `secret`
+
+<img src="/img/tutorial/security/image04.png">
+
+Após autenticar no sistema, você verá assim:
+
+<img src="/img/tutorial/security/image05.png">
+
+### Obtenha seus próprios dados de usuário
+
+Agora use a operação `GET` com o caminho `/users/me`.
+
+Você obterá os dados do seu usuário, como:
+
+```JSON
+{
+ "username": "johndoe",
+ "email": "johndoe@example.com",
+ "full_name": "John Doe",
+ "disabled": false,
+ "hashed_password": "fakehashedsecret"
+}
+```
+
+<img src="/img/tutorial/security/image06.png">
+
+Se você clicar no ícone de cadeado, sair e tentar a mesma operação novamente, receberá um erro HTTP 401 de:
+
+```JSON
+{
+ "detail": "Not authenticated"
+}
+```
+
+### Usuário inativo
+
+Agora tente com um usuário inativo, autentique-se com:
+
+User: `alice`
+
+Password: `secret2`
+
+E tente usar a operação `GET` com o caminho `/users/me`.
+
+Você receberá um erro "Usuário inativo", como:
+
+```JSON
+{
+ "detail": "Inactive user"
+}
+```
+
+## Recaptulando
+
+Agora você tem as ferramentas para implementar um sistema de segurança completo baseado em `username` e `password` para sua API.
+
+Usando essas ferramentas, você pode tornar o sistema de segurança compatível com qualquer banco de dados e com qualquer usuário ou modelo de dados.
+
+O único detalhe que falta é que ainda não é realmente "seguro".
+
+No próximo capítulo você verá como usar uma biblioteca de hashing de senha segura e tokens <abbr title="JSON Web Tokens">JWT</abbr>.
From 868720a7986b72e08c66cf4a695a48844bf0625a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 31 Oct 2024 12:18:10 +0000
Subject: [PATCH 350/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9a5a7533f..6574f7de6 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/security/simple-oauth2.md`. PR [#12520](https://github.com/fastapi/fastapi/pull/12520) by [@LidiaDomingos](https://github.com/LidiaDomingos).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/response-directly.md`. PR [#12674](https://github.com/fastapi/fastapi/pull/12674) by [@9zimin9](https://github.com/9zimin9).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/middleware.md`. PR [#12704](https://github.com/fastapi/fastapi/pull/12704) by [@devluisrodrigues](https://github.com/devluisrodrigues).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/openapi-callbacks.md`. PR [#12705](https://github.com/fastapi/fastapi/pull/12705) by [@devfernandoa](https://github.com/devfernandoa).
From b7102a267598354faa01aef63b96f03c49af025d Mon Sep 17 00:00:00 2001
From: Fernando Alzueta <fefealzueta@gmail.com>
Date: Thu, 31 Oct 2024 09:20:59 -0300
Subject: [PATCH 351/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/websockets.md`=20(#12703)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/advanced/websockets.md | 188 ++++++++++++++++++++++++++++
1 file changed, 188 insertions(+)
create mode 100644 docs/pt/docs/advanced/websockets.md
diff --git a/docs/pt/docs/advanced/websockets.md b/docs/pt/docs/advanced/websockets.md
new file mode 100644
index 000000000..694f2bb5d
--- /dev/null
+++ b/docs/pt/docs/advanced/websockets.md
@@ -0,0 +1,188 @@
+# WebSockets
+
+Você pode usar <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebSockets_API" class="external-link" target="_blank">WebSockets</a> com **FastAPI**.
+
+## Instalando `WebSockets`
+
+Garanta que você criou um [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, o ativou e instalou o `websockets`:
+
+<div class="termy">
+
+```console
+$ pip install websockets
+
+---> 100%
+```
+
+</div>
+
+## Cliente WebSockets
+
+### Em produção
+
+Em seu sistema de produção, você provavelmente tem um frontend criado com um framework moderno como React, Vue.js ou Angular.
+
+E para comunicar usando WebSockets com seu backend, você provavelmente usaria as utilidades do seu frontend.
+
+Ou você pode ter um aplicativo móvel nativo que se comunica diretamente com seu backend WebSocket, em código nativo.
+
+Ou você pode ter qualquer outra forma de comunicar com o endpoint WebSocket.
+
+---
+
+Mas para este exemplo, usaremos um documento HTML muito simples com algum JavaScript, tudo dentro de uma string longa.
+
+Esse, é claro, não é o ideal e você não o usaria para produção.
+
+Na produção, você teria uma das opções acima.
+
+Mas é a maneira mais simples de focar no lado do servidor de WebSockets e ter um exemplo funcional:
+
+```Python hl_lines="2 6-38 41-43"
+{!../../docs_src/websockets/tutorial001.py!}
+```
+
+## Criando um `websocket`
+
+Em sua aplicação **FastAPI**, crie um `websocket`:
+
+{*../../docs_src/websockets/tutorial001.py hl[46:47]*}
+
+/// note | Detalhes Técnicos
+
+Você também poderia usar `from starlette.websockets import WebSocket`.
+
+A **FastAPI** fornece o mesmo `WebSocket` diretamente apenas como uma conveniência para você, o desenvolvedor. Mas ele vem diretamente do Starlette.
+
+///
+
+## Aguardar por mensagens e enviar mensagens
+
+Em sua rota WebSocket você pode esperar (`await`) por mensagens e enviar mensagens.
+
+{*../../docs_src/websockets/tutorial001.py hl[48:52]*}
+
+Você pode receber e enviar dados binários, de texto e JSON.
+
+## Tente você mesmo
+
+Se seu arquivo for nomeado `main.py`, execute sua aplicação com:
+
+<div class="termy">
+
+```console
+$ fastapi dev main.py
+
+<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+</div>
+
+Abra seu navegador em: <a href="http://127.0.0.1:8000" class="external-link" target="_blank">http://127.0.0.1:8000</a>.
+
+Você verá uma página simples como:
+
+<img src="/img/tutorial/websockets/image01.png">
+
+Você pode digitar mensagens na caixa de entrada e enviá-las:
+
+<img src="/img/tutorial/websockets/image02.png">
+
+E sua aplicação **FastAPI** com WebSockets responderá de volta:
+
+<img src="/img/tutorial/websockets/image03.png">
+
+Você pode enviar (e receber) muitas mensagens:
+
+<img src="/img/tutorial/websockets/image04.png">
+
+E todas elas usarão a mesma conexão WebSocket.
+
+## Usando `Depends` e outros
+
+Nos endpoints WebSocket você pode importar do `fastapi` e usar:
+
+* `Depends`
+* `Security`
+* `Cookie`
+* `Header`
+* `Path`
+* `Query`
+
+Eles funcionam da mesma forma que para outros endpoints FastAPI/*operações de rota*:
+
+{*../../docs_src/websockets/tutorial002_an_py310.py hl[68:69,82]*}
+
+/// info | Informação
+
+Como isso é um WebSocket, não faz muito sentido levantar uma `HTTPException`, em vez disso levantamos uma `WebSocketException`.
+
+Você pode usar um código de fechamento dos <a href="https://tools.ietf.org/html/rfc6455#section-7.4.1" class="external-link" target="_blank">códigos válidos definidos na especificação</a>.
+
+///
+
+### Tente os WebSockets com dependências
+
+Se seu arquivo for nomeado `main.py`, execute sua aplicação com:
+
+<div class="termy">
+
+```console
+$ fastapi dev main.py
+
+<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+</div>
+
+Abrar seu browser em: <a href="http://127.0.0.1:8000" class="external-link" target="_blank">http://127.0.0.1:8000</a>.
+
+Lá você pode definir:
+
+* O "Item ID", usado na rota.
+* O "Token" usado como um parâmetro de consulta.
+
+/// tip | Dica
+
+Perceba que a consulta `token` será manipulada por uma dependência.
+
+///
+
+Com isso você pode conectar o WebSocket e então enviar e receber mensagens:
+
+<img src="/img/tutorial/websockets/image05.png">
+
+## Lidando com desconexões e múltiplos clientes
+
+Quando uma conexão WebSocket é fechada, o `await websocket.receive_text()` levantará uma exceção `WebSocketDisconnect`, que você pode então capturar e lidar como neste exemplo.
+
+{*../../docs_src/websockets/tutorial003_py39.py hl[79:81]*}
+
+Para testar:
+
+* Abrar o aplicativo com várias abas do navegador.
+* Escreva mensagens a partir delas.
+* Então feche uma das abas.
+
+Isso levantará a exceção `WebSocketDisconnect`, e todos os outros clientes receberão uma mensagem como:
+
+```
+Client #1596980209979 left the chat
+```
+
+/// tip | Dica
+
+O app acima é um exemplo mínimo e simples para demonstrar como lidar e transmitir mensagens para várias conexões WebSocket.
+
+Mas tenha em mente que, como tudo é manipulado na memória, em uma única lista, ele só funcionará enquanto o processo estiver em execução e só funcionará com um único processo.
+
+Se você precisa de algo fácil de integrar com o FastAPI, mas que seja mais robusto, suportado por Redis, PostgreSQL ou outros, verifique o <a href="https://github.com/encode/broadcaster" class="external-link" target="_blank">encode/broadcaster</a>.
+
+///
+
+## Mais informações
+
+Para aprender mais sobre as opções, verifique a documentação do Starlette para:
+
+* <a href="https://www.starlette.io/websockets/" class="external-link" target="_blank">A classe `WebSocket`</a>.
+* <a href="https://www.starlette.io/endpoints/#websocketendpoint" class="external-link" target="_blank">Manipulação de WebSockets baseada em classes</a>.
From 42c002e4ec62cf319d932bae8b229294c1c124f5 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 31 Oct 2024 12:21:22 +0000
Subject: [PATCH 352/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6574f7de6..85aa085ad 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/websockets.md`. PR [#12703](https://github.com/fastapi/fastapi/pull/12703) by [@devfernandoa](https://github.com/devfernandoa).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/security/simple-oauth2.md`. PR [#12520](https://github.com/fastapi/fastapi/pull/12520) by [@LidiaDomingos](https://github.com/LidiaDomingos).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/response-directly.md`. PR [#12674](https://github.com/fastapi/fastapi/pull/12674) by [@9zimin9](https://github.com/9zimin9).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/middleware.md`. PR [#12704](https://github.com/fastapi/fastapi/pull/12704) by [@devluisrodrigues](https://github.com/devluisrodrigues).
From 14b087cd36792f04d34419c6d29b832a62303aa9 Mon Sep 17 00:00:00 2001
From: Chol_rang <vhtmxj154@naver.com>
Date: Fri, 1 Nov 2024 03:56:37 +0900
Subject: [PATCH 353/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/advanced/wsgi.md`=20(#12659)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/advanced/wsgi.md | 37 +++++++++++++++++++++++++++++++++++
1 file changed, 37 insertions(+)
create mode 100644 docs/ko/docs/advanced/wsgi.md
diff --git a/docs/ko/docs/advanced/wsgi.md b/docs/ko/docs/advanced/wsgi.md
new file mode 100644
index 000000000..87aabf203
--- /dev/null
+++ b/docs/ko/docs/advanced/wsgi.md
@@ -0,0 +1,37 @@
+# WSGI 포함하기 - Flask, Django 그 외
+
+[서브 응용 프로그램 - 마운트](sub-applications.md){.internal-link target=_blank}, [프록시 뒤편에서](behind-a-proxy.md){.internal-link target=_blank}에서 보았듯이 WSGI 응용 프로그램들을 다음과 같이 마운트 할 수 있습니다.
+
+`WSGIMiddleware`를 사용하여 WSGI 응용 프로그램(예: Flask, Django 등)을 감쌀 수 있습니다.
+
+## `WSGIMiddleware` 사용하기
+
+`WSGIMiddleware`를 불러와야 합니다.
+
+그런 다음, WSGI(예: Flask) 응용 프로그램을 미들웨어로 포장합니다.
+
+그 후, 해당 경로에 마운트합니다.
+
+```Python hl_lines="2-3 23"
+{!../../docs_src/wsgi/tutorial001.py!}
+```
+
+## 확인하기
+
+이제 `/v1/` 경로에 있는 모든 요청은 Flask 응용 프로그램에서 처리됩니다.
+
+그리고 나머지는 **FastAPI**에 의해 처리됩니다.
+
+실행하면 <a href="http://localhost:8000/v1/" class="external-link" target="_blank">http://localhost:8000/v1/</a>으로 이동해서 Flask의 응답을 볼 수 있습니다:
+
+```txt
+Hello, World from Flask!
+```
+
+그리고 다음으로 이동하면 <a href="http://localhost:8000/v2" class="external-link" target="_blank">http://localhost:8000/v2</a> Flask의 응답을 볼 수 있습니다:
+
+```JSON
+{
+ "message": "Hello World"
+}
+```
From a18ab763223ef19c1b00d3838e5b087d22dc81c7 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 31 Oct 2024 18:56:59 +0000
Subject: [PATCH 354/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 85aa085ad..590e4423b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `docs/ko/docs/advanced/wsgi.md`. PR [#12659](https://github.com/fastapi/fastapi/pull/12659) by [@Limsunoh](https://github.com/Limsunoh).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/websockets.md`. PR [#12703](https://github.com/fastapi/fastapi/pull/12703) by [@devfernandoa](https://github.com/devfernandoa).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/security/simple-oauth2.md`. PR [#12520](https://github.com/fastapi/fastapi/pull/12520) by [@LidiaDomingos](https://github.com/LidiaDomingos).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/response-directly.md`. PR [#12674](https://github.com/fastapi/fastapi/pull/12674) by [@9zimin9](https://github.com/9zimin9).
From 808196f2a36ba94a9b1ac315b8d426175cbe2d38 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 1 Nov 2024 11:16:34 +0000
Subject: [PATCH 355/504] =?UTF-8?q?=E2=AC=86=20Update=20pytest=20requireme?=
=?UTF-8?q?nt=20from=20<8.0.0,>=3D7.1.3=20to=20>=3D7.1.3,<9.0.0=20(#12745)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Updates the requirements on [pytest](https://github.com/pytest-dev/pytest) to permit the latest version.
- [Release notes](https://github.com/pytest-dev/pytest/releases)
- [Changelog](https://github.com/pytest-dev/pytest/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pytest-dev/pytest/compare/7.1.3...8.3.3)
---
updated-dependencies:
- dependency-name: pytest
dependency-type: direct:production
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
requirements-tests.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/requirements-tests.txt b/requirements-tests.txt
index 189fcaf7e..f8c860ee8 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -1,6 +1,6 @@
-e .[all]
-r requirements-docs-tests.txt
-pytest >=7.1.3,<8.0.0
+pytest >=7.1.3,<9.0.0
coverage[toml] >= 6.5.0,< 8.0
mypy ==1.8.0
dirty-equals ==0.6.0
From 4695b8d07f4e8c07349716a957b31f6235cbda65 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 1 Nov 2024 11:16:55 +0000
Subject: [PATCH 356/504] =?UTF-8?q?=E2=AC=86=20Bump=20pillow=20from=2010.4?=
=?UTF-8?q?.0=20to=2011.0.0=20(#12746)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Bumps [pillow](https://github.com/python-pillow/Pillow) from 10.4.0 to 11.0.0.
- [Release notes](https://github.com/python-pillow/Pillow/releases)
- [Changelog](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst)
- [Commits](https://github.com/python-pillow/Pillow/compare/10.4.0...11.0.0)
---
updated-dependencies:
- dependency-name: pillow
dependency-type: direct:production
update-type: version-update:semver-major
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
requirements-docs.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/requirements-docs.txt b/requirements-docs.txt
index 1639159af..6f2fa3ee7 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -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==10.4.0
+pillow==11.0.0
# For image processing by Material for MkDocs
cairosvg==2.7.1
mkdocstrings[python]==0.26.1
From c4a2201a6bd3816730ac07c35c99df36c61de713 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 1 Nov 2024 11:16:58 +0000
Subject: [PATCH 357/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 590e4423b..6b9a50502 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -43,6 +43,7 @@ hide:
### Internal
+* ⬆ Update pytest requirement from <8.0.0,>=7.1.3 to >=7.1.3,<9.0.0. PR [#12745](https://github.com/fastapi/fastapi/pull/12745) by [@dependabot[bot]](https://github.com/apps/dependabot).
* 🔧 Update sponsors: add Render. PR [#12733](https://github.com/fastapi/fastapi/pull/12733) by [@tiangolo](https://github.com/tiangolo).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12707](https://github.com/fastapi/fastapi/pull/12707) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
From fd98edcdd5325f8a5acc0ffc2edd4d9bd548a60b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 1 Nov 2024 11:17:12 +0000
Subject: [PATCH 358/504] =?UTF-8?q?=E2=AC=86=20Update=20flask=20requiremen?=
=?UTF-8?q?t=20from=20<3.0.0,>=3D1.1.2=20to=20>=3D1.1.2,<4.0.0=20(#12747)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Updates the requirements on [flask](https://github.com/pallets/flask) to permit the latest version.
- [Release notes](https://github.com/pallets/flask/releases)
- [Changelog](https://github.com/pallets/flask/blob/main/CHANGES.rst)
- [Commits](https://github.com/pallets/flask/compare/1.1.2...3.0.3)
---
updated-dependencies:
- dependency-name: flask
dependency-type: direct:production
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
requirements-tests.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/requirements-tests.txt b/requirements-tests.txt
index f8c860ee8..95ec09884 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -5,7 +5,7 @@ coverage[toml] >= 6.5.0,< 8.0
mypy ==1.8.0
dirty-equals ==0.6.0
sqlmodel==0.0.22
-flask >=1.1.2,<3.0.0
+flask >=1.1.2,<4.0.0
anyio[trio] >=3.2.1,<4.0.0
PyJWT==2.8.0
pyyaml >=5.3.1,<7.0.0
From 54fa592dacfe33bc788d289a1fb3db8f3a84e0f9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 1 Nov 2024 11:17:22 +0000
Subject: [PATCH 359/504] =?UTF-8?q?=E2=AC=86=20Bump=20typer=20from=200.12.?=
=?UTF-8?q?3=20to=200.12.5=20(#12748)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Bumps [typer](https://github.com/fastapi/typer) from 0.12.3 to 0.12.5.
- [Release notes](https://github.com/fastapi/typer/releases)
- [Changelog](https://github.com/fastapi/typer/blob/master/docs/release-notes.md)
- [Commits](https://github.com/fastapi/typer/compare/0.12.3...0.12.5)
---
updated-dependencies:
- dependency-name: typer
dependency-type: direct:production
update-type: version-update:semver-patch
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
requirements-docs.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/requirements-docs.txt b/requirements-docs.txt
index 6f2fa3ee7..9754eaa4a 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -3,7 +3,7 @@
mkdocs-material==9.5.18
mdx-include >=1.4.1,<2.0.0
mkdocs-redirects>=1.2.1,<1.3.0
-typer == 0.12.3
+typer == 0.12.5
pyyaml >=5.3.1,<7.0.0
# For Material for MkDocs, Chinese search
jieba==0.42.1
From 70f50442d95fdb73c61b676fb46fc9ed594e66ee Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 1 Nov 2024 11:17:26 +0000
Subject: [PATCH 360/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6b9a50502..a241e0d2a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -43,6 +43,7 @@ hide:
### Internal
+* ⬆ Bump pillow from 10.4.0 to 11.0.0. PR [#12746](https://github.com/fastapi/fastapi/pull/12746) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Update pytest requirement from <8.0.0,>=7.1.3 to >=7.1.3,<9.0.0. PR [#12745](https://github.com/fastapi/fastapi/pull/12745) by [@dependabot[bot]](https://github.com/apps/dependabot).
* 🔧 Update sponsors: add Render. PR [#12733](https://github.com/fastapi/fastapi/pull/12733) by [@tiangolo](https://github.com/tiangolo).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12707](https://github.com/fastapi/fastapi/pull/12707) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
From fd40d00748d1781b2a53bba79f9241144f9a4765 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 1 Nov 2024 11:17:36 +0000
Subject: [PATCH 361/504] =?UTF-8?q?=E2=AC=86=20Update=20pre-commit=20requi?=
=?UTF-8?q?rement=20from=20<4.0.0,>=3D2.17.0=20to=20>=3D2.17.0,<5.0.0=20(#?=
=?UTF-8?q?12749)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Updates the requirements on [pre-commit](https://github.com/pre-commit/pre-commit) to permit the latest version.
- [Release notes](https://github.com/pre-commit/pre-commit/releases)
- [Changelog](https://github.com/pre-commit/pre-commit/blob/main/CHANGELOG.md)
- [Commits](https://github.com/pre-commit/pre-commit/compare/v2.17.0...v4.0.1)
---
updated-dependencies:
- dependency-name: pre-commit
dependency-type: direct:production
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
requirements.txt | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/requirements.txt b/requirements.txt
index 8e1fef341..9180bf1be 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,6 +1,6 @@
-e .[all]
-r requirements-tests.txt
-r requirements-docs.txt
-pre-commit >=2.17.0,<4.0.0
+pre-commit >=2.17.0,<5.0.0
# For generating screenshots
playwright
From 6670e8af6851563265f61cae8196a902711b4130 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 1 Nov 2024 11:18:59 +0000
Subject: [PATCH 362/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a241e0d2a..893185808 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -43,6 +43,7 @@ hide:
### Internal
+* ⬆ Update flask requirement from <3.0.0,>=1.1.2 to >=1.1.2,<4.0.0. PR [#12747](https://github.com/fastapi/fastapi/pull/12747) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump pillow from 10.4.0 to 11.0.0. PR [#12746](https://github.com/fastapi/fastapi/pull/12746) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Update pytest requirement from <8.0.0,>=7.1.3 to >=7.1.3,<9.0.0. PR [#12745](https://github.com/fastapi/fastapi/pull/12745) by [@dependabot[bot]](https://github.com/apps/dependabot).
* 🔧 Update sponsors: add Render. PR [#12733](https://github.com/fastapi/fastapi/pull/12733) by [@tiangolo](https://github.com/tiangolo).
From 1f150346388e7f94fc1499d0f70ac847f0463087 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 1 Nov 2024 11:19:50 +0000
Subject: [PATCH 363/504] =?UTF-8?q?=E2=AC=86=20Bump=20pypa/gh-action-pypi-?=
=?UTF-8?q?publish=20from=201.10.3=20to=201.11.0=20(#12721)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Bumps [pypa/gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish) from 1.10.3 to 1.11.0.
- [Release notes](https://github.com/pypa/gh-action-pypi-publish/releases)
- [Commits](https://github.com/pypa/gh-action-pypi-publish/compare/v1.10.3...v1.11.0)
---
updated-dependencies:
- dependency-name: pypa/gh-action-pypi-publish
dependency-type: direct:production
update-type: version-update:semver-minor
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
.github/workflows/publish.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index c8ea4e18c..694d68c69 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -35,7 +35,7 @@ jobs:
TIANGOLO_BUILD_PACKAGE: ${{ matrix.package }}
run: python -m build
- name: Publish
- uses: pypa/gh-action-pypi-publish@v1.10.3
+ uses: pypa/gh-action-pypi-publish@v1.11.0
- name: Dump GitHub context
env:
GITHUB_CONTEXT: ${{ toJson(github) }}
From eba967c65acdccfa19b2e6633f96b59e4024d412 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 1 Nov 2024 11:20:24 +0000
Subject: [PATCH 364/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 893185808..64f563ef4 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -43,6 +43,7 @@ hide:
### Internal
+* ⬆ Bump typer from 0.12.3 to 0.12.5. PR [#12748](https://github.com/fastapi/fastapi/pull/12748) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Update flask requirement from <3.0.0,>=1.1.2 to >=1.1.2,<4.0.0. PR [#12747](https://github.com/fastapi/fastapi/pull/12747) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump pillow from 10.4.0 to 11.0.0. PR [#12746](https://github.com/fastapi/fastapi/pull/12746) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Update pytest requirement from <8.0.0,>=7.1.3 to >=7.1.3,<9.0.0. PR [#12745](https://github.com/fastapi/fastapi/pull/12745) by [@dependabot[bot]](https://github.com/apps/dependabot).
From 3739999b7650997366e9b63b223170d9e08c9e41 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 1 Nov 2024 11:21:54 +0000
Subject: [PATCH 365/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 64f563ef4..4822a9cc7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -43,6 +43,7 @@ hide:
### Internal
+* ⬆ Update pre-commit requirement from <4.0.0,>=2.17.0 to >=2.17.0,<5.0.0. PR [#12749](https://github.com/fastapi/fastapi/pull/12749) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump typer from 0.12.3 to 0.12.5. PR [#12748](https://github.com/fastapi/fastapi/pull/12748) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Update flask requirement from <3.0.0,>=1.1.2 to >=1.1.2,<4.0.0. PR [#12747](https://github.com/fastapi/fastapi/pull/12747) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump pillow from 10.4.0 to 11.0.0. PR [#12746](https://github.com/fastapi/fastapi/pull/12746) by [@dependabot[bot]](https://github.com/apps/dependabot).
From d4ab06a2b6b59bd264c0cc43367c5a68174e8f88 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 1 Nov 2024 11:25:57 +0000
Subject: [PATCH 366/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4822a9cc7..d072c618d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -43,6 +43,7 @@ hide:
### Internal
+* ⬆ Bump pypa/gh-action-pypi-publish from 1.10.3 to 1.11.0. PR [#12721](https://github.com/fastapi/fastapi/pull/12721) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Update pre-commit requirement from <4.0.0,>=2.17.0 to >=2.17.0,<5.0.0. PR [#12749](https://github.com/fastapi/fastapi/pull/12749) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump typer from 0.12.3 to 0.12.5. PR [#12748](https://github.com/fastapi/fastapi/pull/12748) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Update flask requirement from <3.0.0,>=1.1.2 to >=1.1.2,<4.0.0. PR [#12747](https://github.com/fastapi/fastapi/pull/12747) by [@dependabot[bot]](https://github.com/apps/dependabot).
From 3ff4da5387912b9b6cbaf5f5e46c57999a37ff19 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
<66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Wed, 6 Nov 2024 18:14:55 +0000
Subject: [PATCH 367/504] =?UTF-8?q?=E2=AC=86=20[pre-commit.ci]=20pre-commi?=
=?UTF-8?q?t=20autoupdate=20(#12766)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
updates:
- [github.com/astral-sh/ruff-pre-commit: v0.7.1 → v0.7.2](https://github.com/astral-sh/ruff-pre-commit/compare/v0.7.1...v0.7.2)
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
.pre-commit-config.yaml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 84bec0421..d90e7281e 100644
--- a/.pre-commit-config.yaml
+++ b/.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.7.1
+ rev: v0.7.2
hooks:
- id: ruff
args:
From 7eda7e28a694066c8e55fd3c7beb537af55bcc39 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 6 Nov 2024 18:15:12 +0000
Subject: [PATCH 368/504] =?UTF-8?q?=E2=AC=86=20Bump=20cloudflare/wrangler-?=
=?UTF-8?q?action=20from=203.11=20to=203.12=20(#12777)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Bumps [cloudflare/wrangler-action](https://github.com/cloudflare/wrangler-action) from 3.11 to 3.12.
- [Release notes](https://github.com/cloudflare/wrangler-action/releases)
- [Changelog](https://github.com/cloudflare/wrangler-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/cloudflare/wrangler-action/compare/v3.11...v3.12)
---
updated-dependencies:
- dependency-name: cloudflare/wrangler-action
dependency-type: direct:production
update-type: version-update:semver-minor
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
.github/workflows/deploy-docs.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index e46786a53..387063f12 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -64,7 +64,7 @@ jobs:
BRANCH: ${{ ( github.event.workflow_run.head_repository.full_name == github.repository && github.event.workflow_run.head_branch == 'master' && 'main' ) || ( github.event.workflow_run.head_sha ) }}
# TODO: Use v3 when it's fixed, probably in v3.11
# https://github.com/cloudflare/wrangler-action/issues/307
- uses: cloudflare/wrangler-action@v3.11
+ uses: cloudflare/wrangler-action@v3.12
# uses: cloudflare/wrangler-action@v3
with:
apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
From 4d3e1cd22aaea9fdcccd276479a4997fd361d702 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 6 Nov 2024 18:15:17 +0000
Subject: [PATCH 369/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d072c618d..8c1723d2e 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -43,6 +43,7 @@ hide:
### Internal
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12766](https://github.com/fastapi/fastapi/pull/12766) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* ⬆ Bump pypa/gh-action-pypi-publish from 1.10.3 to 1.11.0. PR [#12721](https://github.com/fastapi/fastapi/pull/12721) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Update pre-commit requirement from <4.0.0,>=2.17.0 to >=2.17.0,<5.0.0. PR [#12749](https://github.com/fastapi/fastapi/pull/12749) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump typer from 0.12.3 to 0.12.5. PR [#12748](https://github.com/fastapi/fastapi/pull/12748) by [@dependabot[bot]](https://github.com/apps/dependabot).
From c8bcb633ccaadbfe3b1c18568476aa1dd3cd7a96 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 6 Nov 2024 18:15:30 +0000
Subject: [PATCH 370/504] =?UTF-8?q?=E2=AC=86=20Bump=20pypa/gh-action-pypi-?=
=?UTF-8?q?publish=20from=201.11.0=20to=201.12.0=20(#12781)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Bumps [pypa/gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish) from 1.11.0 to 1.12.0.
- [Release notes](https://github.com/pypa/gh-action-pypi-publish/releases)
- [Commits](https://github.com/pypa/gh-action-pypi-publish/compare/v1.11.0...v1.12.0)
---
updated-dependencies:
- dependency-name: pypa/gh-action-pypi-publish
dependency-type: direct:production
update-type: version-update:semver-minor
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
.github/workflows/publish.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 694d68c69..a26d2d563 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -35,7 +35,7 @@ jobs:
TIANGOLO_BUILD_PACKAGE: ${{ matrix.package }}
run: python -m build
- name: Publish
- uses: pypa/gh-action-pypi-publish@v1.11.0
+ uses: pypa/gh-action-pypi-publish@v1.12.0
- name: Dump GitHub context
env:
GITHUB_CONTEXT: ${{ toJson(github) }}
From 45579ad78c08909b1d46fe31be4047a860186c14 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 6 Nov 2024 18:15:59 +0000
Subject: [PATCH 371/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8c1723d2e..2722f1457 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -43,6 +43,7 @@ hide:
### Internal
+* ⬆ Bump cloudflare/wrangler-action from 3.11 to 3.12. PR [#12777](https://github.com/fastapi/fastapi/pull/12777) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12766](https://github.com/fastapi/fastapi/pull/12766) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* ⬆ Bump pypa/gh-action-pypi-publish from 1.10.3 to 1.11.0. PR [#12721](https://github.com/fastapi/fastapi/pull/12721) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Update pre-commit requirement from <4.0.0,>=2.17.0 to >=2.17.0,<5.0.0. PR [#12749](https://github.com/fastapi/fastapi/pull/12749) by [@dependabot[bot]](https://github.com/apps/dependabot).
From 845a2ecd3910f557de3d86cedeb837d82975b39c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 6 Nov 2024 18:17:40 +0000
Subject: [PATCH 372/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2722f1457..32c212d70 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -43,6 +43,7 @@ hide:
### Internal
+* ⬆ Bump pypa/gh-action-pypi-publish from 1.11.0 to 1.12.0. PR [#12781](https://github.com/fastapi/fastapi/pull/12781) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump cloudflare/wrangler-action from 3.11 to 3.12. PR [#12777](https://github.com/fastapi/fastapi/pull/12777) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12766](https://github.com/fastapi/fastapi/pull/12766) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
* ⬆ Bump pypa/gh-action-pypi-publish from 1.10.3 to 1.11.0. PR [#12721](https://github.com/fastapi/fastapi/pull/12721) by [@dependabot[bot]](https://github.com/apps/dependabot).
From d0e0b27f732aecfdde325585016a3de0c9a03e65 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Pedro=20Pereira=20Holanda?=
<joaopedroph09@gmail.com>
Date: Wed, 6 Nov 2024 15:21:50 -0300
Subject: [PATCH 373/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Portuguese=20trans?=
=?UTF-8?q?lation=20for=20`docs/pt/docs/advanced/path-operation-advanced-c?=
=?UTF-8?q?onfiguration.md`=20(#12762)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../path-operation-advanced-configuration.md | 212 ++++++++++++++++++
1 file changed, 212 insertions(+)
create mode 100644 docs/pt/docs/advanced/path-operation-advanced-configuration.md
diff --git a/docs/pt/docs/advanced/path-operation-advanced-configuration.md b/docs/pt/docs/advanced/path-operation-advanced-configuration.md
new file mode 100644
index 000000000..04f5cc9a3
--- /dev/null
+++ b/docs/pt/docs/advanced/path-operation-advanced-configuration.md
@@ -0,0 +1,212 @@
+# Configuração Avançada da Operação de Rota
+
+## operationId do OpenAPI
+
+/// warning | Aviso
+
+Se você não é um "especialista" no OpenAPI, você provavelmente não precisa disso.
+
+///
+
+Você pode definir o `operationId` do OpenAPI que será utilizado na sua *operação de rota* com o parâmetro `operation_id`.
+
+Você precisa ter certeza que ele é único para cada operação.
+
+{* ../../docs_src/path_operation_advanced_configuration/tutorial001.py hl[6] *}
+
+### Utilizando o nome da *função de operação de rota* como o operationId
+
+Se você quiser utilizar o nome das funções da sua API como `operationId`s, você pode iterar sobre todos esses nomes e sobrescrever o `operationId` em cada *operação de rota* utilizando o `APIRoute.name` dela.
+
+Você deve fazer isso depois de adicionar todas as suas *operações de rota*.
+
+{* ../../docs_src/path_operation_advanced_configuration/tutorial002.py hl[2,12:21,24] *}
+
+/// tip | Dica
+
+Se você chamar `app.openapi()` manualmente, os `operationId`s devem ser atualizados antes dessa chamada.
+
+///
+
+/// warning | Aviso
+
+Se você fizer isso, você tem que ter certeza de que cada uma das suas *funções de operação de rota* tem um nome único.
+
+Mesmo que elas estejam em módulos (arquivos Python) diferentes.
+
+///
+
+## Excluir do OpenAPI
+
+Para excluir uma *operação de rota* do esquema OpenAPI gerado (e por consequência, dos sistemas de documentação automáticos), utilize o parâmetro `include_in_schema` e defina ele como `False`:
+
+{* ../../docs_src/path_operation_advanced_configuration/tutorial003.py hl[6] *}
+
+## Descrição avançada a partir de docstring
+
+Você pode limitar as linhas utilizadas a partir de uma docstring de uma *função de operação de rota* para o OpenAPI.
+
+Adicionar um `\f` (um caractere de escape para alimentação de formulário) faz com que o **FastAPI** restrinja a saída utilizada pelo OpenAPI até esse ponto.
+
+Ele não será mostrado na documentação, mas outras ferramentas (como o Sphinx) serão capazes de utilizar o resto do texto.
+
+{* ../../docs_src/path_operation_advanced_configuration/tutorial004.py hl[19:29] *}
+
+## Respostas Adicionais
+
+Você provavelmente já viu como declarar o `response_model` e `status_code` para uma *operação de rota*.
+
+Isso define os metadados sobre a resposta principal da *operação de rota*.
+
+Você também pode declarar respostas adicionais, com seus modelos, códigos de status, etc.
+
+Existe um capítulo inteiro da nossa documentação sobre isso, você pode ler em [Retornos Adicionais no OpenAPI](additional-responses.md){.internal-link target=_blank}.
+
+## Extras do OpenAPI
+
+Quando você declara uma *operação de rota* na sua aplicação, o **FastAPI** irá gerar os metadados relevantes da *operação de rota* automaticamente para serem incluídos no esquema do OpenAPI.
+
+/// note | Nota
+
+Na especificação do OpenAPI, isso é chamado de um <a href="https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operation-object" class="external-link" target="_blank">Objeto de Operação</a>.
+
+///
+
+Ele possui toda a informação sobre a *operação de rota* e é usado para gerar a documentação automaticamente.
+
+Ele inclui os atributos `tags`, `parameters`, `requestBody`, `responses`, etc.
+
+Esse esquema específico para uma *operação de rota* normalmente é gerado automaticamente pelo **FastAPI**, mas você também pode estender ele.
+
+/// tip | Dica
+
+Esse é um ponto de extensão de baixo nível.
+
+Caso você só precise declarar respostas adicionais, uma forma conveniente de fazer isso é com [Retornos Adicionais no OpenAPI](additional-responses.md){.internal-link target=_blank}.
+
+///
+
+Você pode estender o esquema do OpenAPI para uma *operação de rota* utilizando o parâmetro `openapi_extra`.
+
+### Extensões do OpenAPI
+
+Esse parâmetro `openapi_extra` pode ser útil, por exemplo, para declarar [Extensões do OpenAPI](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#specificationExtensions):
+
+{* ../../docs_src/path_operation_advanced_configuration/tutorial005.py hl[6] *}
+
+Se você abrir os documentos criados automaticamente para a API, sua extensão aparecerá no final da *operação de rota* específica.
+
+<img src="/img/tutorial/path-operation-advanced-configuration/image01.png">
+
+E se você olhar o esquema OpenAPI resultante (na rota `/openapi.json` da sua API), você verá que a sua extensão também faz parte da *operação de rota* específica:
+
+```JSON hl_lines="22"
+{
+ "openapi": "3.1.0",
+ "info": {
+ "title": "FastAPI",
+ "version": "0.1.0"
+ },
+ "paths": {
+ "/items/": {
+ "get": {
+ "summary": "Read Items",
+ "operationId": "read_items_items__get",
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {
+ "application/json": {
+ "schema": {}
+ }
+ }
+ }
+ },
+ "x-aperture-labs-portal": "blue"
+ }
+ }
+ }
+}
+```
+
+### Esquema de *operação de rota* do OpenAPI personalizado
+
+O dicionário em `openapi_extra` vai ter todos os seus níveis mesclados dentro do esquema OpenAPI gerado automaticamente para a *operação de rota*.
+
+Então, você pode adicionar dados extras para o esquema gerado automaticamente.
+
+Por exemplo, você poderia optar por ler e validar a requisição com seu próprio código, sem utilizar funcionalidades automatizadas do FastAPI com o Pydantic, mas você ainda pode quere definir a requisição no esquema OpenAPI.
+
+Você pode fazer isso com `openapi_extra`:
+
+{* ../../docs_src/path_operation_advanced_configuration/tutorial006.py hl[19:36,39:40] *}
+
+Nesse exemplo, nós não declaramos nenhum modelo do Pydantic. Na verdade, o corpo da requisição não está nem mesmo <abbr title="convertido de um formato plano, como bytes, para objetos Python">analisado</abbr> como JSON, ele é lido diretamente como `bytes` e a função `magic_data_reader()` seria a responsável por analisar ele de alguma forma.
+
+De toda forma, nós podemos declarar o esquema esperado para o corpo da requisição.
+
+### Tipo de conteúdo do OpenAPI personalizado
+
+Utilizando esse mesmo truque, você pode utilizar um modelo Pydantic para definir o esquema JSON que é então incluído na seção do esquema personalizado do OpenAPI na *operação de rota*.
+
+E você pode fazer isso até mesmo quando os dados da requisição não seguem o formato JSON.
+
+Por exemplo, nesta aplicação nós não usamos a funcionalidade integrada ao FastAPI de extrair o esquema JSON dos modelos Pydantic nem a validação automática do JSON. Na verdade, estamos declarando o tipo do conteúdo da requisição como YAML, em vez de JSON:
+
+//// tab | Pydantic v2
+
+```Python hl_lines="17-22 24"
+{!> ../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
+```
+
+////
+
+//// tab | Pydantic v1
+
+```Python hl_lines="17-22 24"
+{!> ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py!}
+```
+
+////
+
+/// info | Informação
+
+Na versão 1 do Pydantic, o método para obter o esquema JSON de um modelo é `Item.schema()`, na versão 2 do Pydantic, o método é `Item.model_json_schema()`
+
+///
+
+Entretanto, mesmo que não utilizemos a funcionalidade integrada por padrão, ainda estamos usando um modelo Pydantic para gerar um esquema JSON manualmente para os dados que queremos receber no formato YAML.
+
+Então utilizamos a requisição diretamente, e extraímos o corpo como `bytes`. Isso significa que o FastAPI não vai sequer tentar analisar o corpo da requisição como JSON.
+
+E então no nosso código, nós analisamos o conteúdo YAML diretamente, e estamos utilizando o mesmo modelo Pydantic para validar o conteúdo YAML:
+
+//// tab | Pydantic v2
+
+```Python hl_lines="26-33"
+{!> ../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
+```
+
+////
+
+//// tab | Pydantic v1
+
+```Python hl_lines="26-33"
+{!> ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py!}
+```
+
+////
+
+/// info | Informação
+
+Na versão 1 do Pydantic, o método para analisar e validar um objeto era `Item.parse_obj()`, na versão 2 do Pydantic, o método é chamado de `Item.model_validate()`.
+
+///
+
+///tip | Dica
+
+Aqui reutilizamos o mesmo modelo do Pydantic.
+
+Mas da mesma forma, nós poderíamos ter validado de alguma outra forma.
+
+///
From 0c7296b19ed5cecbafb01a8d0592bcd66e703153 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 6 Nov 2024 18:24:11 +0000
Subject: [PATCH 374/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 32c212d70..d7b1134d2 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/path-operation-advanced-configuration.md`. PR [#12762](https://github.com/fastapi/fastapi/pull/12762) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/wsgi.md`. PR [#12659](https://github.com/fastapi/fastapi/pull/12659) by [@Limsunoh](https://github.com/Limsunoh).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/websockets.md`. PR [#12703](https://github.com/fastapi/fastapi/pull/12703) by [@devfernandoa](https://github.com/devfernandoa).
* 🌐 Add Portuguese translation for `docs/pt/docs/tutorial/security/simple-oauth2.md`. PR [#12520](https://github.com/fastapi/fastapi/pull/12520) by [@LidiaDomingos](https://github.com/LidiaDomingos).
From 731c85a876f33327ad1b3a280b406703852bb0d9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 7 Nov 2024 20:32:35 +0000
Subject: [PATCH 375/504] =?UTF-8?q?=E2=AC=86=20Bump=20pypa/gh-action-pypi-?=
=?UTF-8?q?publish=20from=201.12.0=20to=201.12.2=20(#12788)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Bumps [pypa/gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish) from 1.12.0 to 1.12.2.
- [Release notes](https://github.com/pypa/gh-action-pypi-publish/releases)
- [Commits](https://github.com/pypa/gh-action-pypi-publish/compare/v1.12.0...v1.12.2)
---
updated-dependencies:
- dependency-name: pypa/gh-action-pypi-publish
dependency-type: direct:production
update-type: version-update:semver-patch
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
.github/workflows/publish.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index a26d2d563..fc61c3fca 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -35,7 +35,7 @@ jobs:
TIANGOLO_BUILD_PACKAGE: ${{ matrix.package }}
run: python -m build
- name: Publish
- uses: pypa/gh-action-pypi-publish@v1.12.0
+ uses: pypa/gh-action-pypi-publish@v1.12.2
- name: Dump GitHub context
env:
GITHUB_CONTEXT: ${{ toJson(github) }}
From f2c7b8772183256e62c9c1ac0b4e44e467fdc55a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 7 Nov 2024 20:32:59 +0000
Subject: [PATCH 376/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d7b1134d2..57d58696c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -44,6 +44,7 @@ hide:
### Internal
+* ⬆ Bump pypa/gh-action-pypi-publish from 1.12.0 to 1.12.2. PR [#12788](https://github.com/fastapi/fastapi/pull/12788) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump pypa/gh-action-pypi-publish from 1.11.0 to 1.12.0. PR [#12781](https://github.com/fastapi/fastapi/pull/12781) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump cloudflare/wrangler-action from 3.11 to 3.12. PR [#12777](https://github.com/fastapi/fastapi/pull/12777) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#12766](https://github.com/fastapi/fastapi/pull/12766) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
From 23c352246757e9c960571caddd6be3ba1cbe440b Mon Sep 17 00:00:00 2001
From: kim-sangah <kimsangah_@naver.com>
Date: Fri, 8 Nov 2024 05:38:25 +0900
Subject: [PATCH 377/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/security/index.md`=20(#12743)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/security/index.md | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)
create mode 100644 docs/ko/docs/security/index.md
diff --git a/docs/ko/docs/security/index.md b/docs/ko/docs/security/index.md
new file mode 100644
index 000000000..5a6c733f0
--- /dev/null
+++ b/docs/ko/docs/security/index.md
@@ -0,0 +1,19 @@
+# 고급 보안
+
+## 추가 기능
+
+[자습서 - 사용자 가이드: 보안](../../tutorial/security/index.md){.internal-link target=_blank} 문서에서 다룬 내용 외에도 보안 처리를 위한 몇 가지 추가 기능이 있습니다.
+
+/// tip
+
+다음 섹션은 **반드시 "고급"** 기능은 아닙니다.
+
+그리고 여러분의 사용 사례에 따라, 적합한 해결책이 그 중 하나에 있을 가능성이 있습니다.
+
+///
+
+## 먼저 자습서 읽기
+
+다음 섹션은 이미 [자습서 - 사용자 가이드: 보안](../../tutorial/security/index.md){.internal-link target=_blank} 문서를 읽었다고 가정합니다.
+
+이 섹션들은 모두 동일한 개념을 바탕으로 하며, 추가 기능을 제공합니다.
From 569c54cb9a80b41fe7c770815b8d77bfc50820c0 Mon Sep 17 00:00:00 2001
From: namjimin_43 <mimi3123832@gmail.com>
Date: Fri, 8 Nov 2024 05:38:31 +0900
Subject: [PATCH 378/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/advanced/testing-events.md`=20(#12741)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/advanced/testing-events.md | 7 +++++++
1 file changed, 7 insertions(+)
create mode 100644 docs/ko/docs/advanced/testing-events.md
diff --git a/docs/ko/docs/advanced/testing-events.md b/docs/ko/docs/advanced/testing-events.md
new file mode 100644
index 000000000..dc082412a
--- /dev/null
+++ b/docs/ko/docs/advanced/testing-events.md
@@ -0,0 +1,7 @@
+# 이벤트 테스트: 시작 - 종료
+
+테스트에서 이벤트 핸들러(`startup` 및 `shutdown`)를 실행해야 하는 경우, `with` 문과 함께 `TestClient`를 사용할 수 있습니다.
+
+```Python hl_lines="9-12 20-24"
+{!../../docs_src/app_testing/tutorial003.py!}
+```
From 3a2ec11e807ec6e0e1e3350d342c0ad87b122027 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 7 Nov 2024 20:38:47 +0000
Subject: [PATCH 379/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 57d58696c..8b982817a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `docs/ko/docs/security/index.md`. PR [#12743](https://github.com/fastapi/fastapi/pull/12743) by [@kim-sangah](https://github.com/kim-sangah).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/path-operation-advanced-configuration.md`. PR [#12762](https://github.com/fastapi/fastapi/pull/12762) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/wsgi.md`. PR [#12659](https://github.com/fastapi/fastapi/pull/12659) by [@Limsunoh](https://github.com/Limsunoh).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/websockets.md`. PR [#12703](https://github.com/fastapi/fastapi/pull/12703) by [@devfernandoa](https://github.com/devfernandoa).
From b3d3f0e7234574b006d4468dfcdd406d8cd5a629 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 7 Nov 2024 20:39:11 +0000
Subject: [PATCH 380/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8b982817a..912b75974 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `docs/ko/docs/advanced/testing-events.md`. PR [#12741](https://github.com/fastapi/fastapi/pull/12741) by [@9zimin9](https://github.com/9zimin9).
* 🌐 Add Korean translation for `docs/ko/docs/security/index.md`. PR [#12743](https://github.com/fastapi/fastapi/pull/12743) by [@kim-sangah](https://github.com/kim-sangah).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/path-operation-advanced-configuration.md`. PR [#12762](https://github.com/fastapi/fastapi/pull/12762) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/wsgi.md`. PR [#12659](https://github.com/fastapi/fastapi/pull/12659) by [@Limsunoh](https://github.com/Limsunoh).
From c5ff950dfc37d26a436dc7d1ea7827350df0721c Mon Sep 17 00:00:00 2001
From: LKY <74170199+kwang1215@users.noreply.github.com>
Date: Fri, 8 Nov 2024 05:40:19 +0900
Subject: [PATCH 381/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/advanced/using=5Frequest=5Fdirectly.md?=
=?UTF-8?q?`=20(#12738)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../docs/advanced/using-request-directly.md | 58 +++++++++++++++++++
1 file changed, 58 insertions(+)
create mode 100644 docs/ko/docs/advanced/using-request-directly.md
diff --git a/docs/ko/docs/advanced/using-request-directly.md b/docs/ko/docs/advanced/using-request-directly.md
new file mode 100644
index 000000000..027ea9fad
--- /dev/null
+++ b/docs/ko/docs/advanced/using-request-directly.md
@@ -0,0 +1,58 @@
+# `Request` 직접 사용하기
+
+지금까지 요청에서 필요한 부분을 각 타입으로 선언하여 사용해 왔습니다.
+
+다음과 같은 곳에서 데이터를 가져왔습니다:
+
+* 경로의 파라미터로부터.
+* 헤더.
+* 쿠키.
+* 기타 등등.
+
+이렇게 함으로써, **FastAPI**는 데이터를 검증하고 변환하며, API에 대한 문서를 자동화로 생성합니다.
+
+하지만 `Request` 객체에 직접 접근해야 하는 상황이 있을 수 있습니다.
+
+## `Request` 객체에 대한 세부 사항
+
+**FastAPI**는 실제로 내부에 **Starlette**을 사용하며, 그 위에 여러 도구를 덧붙인 구조입니다. 따라서 여러분이 필요할 때 Starlette의 <a href="https://www.starlette.io/requests/" class="external-link" target="_blank">`Request`</a> 객체를 직접 사용할 수 있습니다.
+
+`Request` 객체에서 데이터를 직접 가져오는 경우(예: 본문을 읽기)에는 FastAPI가 해당 데이터를 검증하거나 변환하지 않으며, 문서화(OpenAPI를 통한 문서 자동화(로 생성된) API 사용자 인터페이스)도 되지 않습니다.
+
+그러나 다른 매개변수(예: Pydantic 모델을 사용한 본문)는 여전히 검증, 변환, 주석 추가 등이 이루어집니다.
+
+하지만 특정한 경우에는 `Request` 객체에 직접 접근하는 것이 유용할 수 있습니다.
+
+## `Request` 객체를 직접 사용하기
+
+여러분이 클라이언트의 IP 주소/호스트 정보를 *경로 작동 함수* 내부에서 가져와야 한다고 가정해 보겠습니다.
+
+이를 위해서는 요청에 직접 접근해야 합니다.
+
+```Python hl_lines="1 7-8"
+{!../../docs_src/using_request_directly/tutorial001.py!}
+```
+
+*경로 작동 함수* 매개변수를 `Request` 타입으로 선언하면 **FastAPI**가 해당 매개변수에 `Request` 객체를 전달하는 것을 알게 됩니다.
+
+/// tip | 팁
+
+이 경우, 요청 매개변수와 함께 경로 매개변수를 선언한 것을 볼 수 있습니다.
+
+따라서, 경로 매개변수는 추출되고 검증되며 지정된 타입으로 변환되고 OpenAPI로 주석이 추가됩니다.
+
+이와 같은 방식으로, 다른 매개변수들을 평소처럼 선언하면서, 부가적으로 `Request`도 가져올 수 있습니다.
+
+///
+
+## `Request` 설명서
+
+여러분은 `Request` 객체에 대한 더 자세한 내용을 <a href="https://www.starlette.io/requests/" class="external-link" target="_blank">공식 Starlette 설명서 사이트</a>에서 읽어볼 수 있습니다.
+
+/// note | 기술 세부사항
+
+`from starlette.requests import Request`를 사용할 수도 있습니다.
+
+**FastAPI**는 여러분(개발자)를 위한 편의를 위해 이를 직접 제공하지만, 실제로는 Starlette에서 가져온 것입니다.
+
+///
From 2fcae5f10832bc89f9a1f7974270cc83bedf8c40 Mon Sep 17 00:00:00 2001
From: sptcnl <119477585+sptcnl@users.noreply.github.com>
Date: Fri, 8 Nov 2024 05:41:38 +0900
Subject: [PATCH 382/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/how-to/conditional-openapi.md`=20(#127?=
=?UTF-8?q?31)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/how-to/conditional-openapi.md | 61 ++++++++++++++++++++++
1 file changed, 61 insertions(+)
create mode 100644 docs/ko/docs/how-to/conditional-openapi.md
diff --git a/docs/ko/docs/how-to/conditional-openapi.md b/docs/ko/docs/how-to/conditional-openapi.md
new file mode 100644
index 000000000..79c7f0dd2
--- /dev/null
+++ b/docs/ko/docs/how-to/conditional-openapi.md
@@ -0,0 +1,61 @@
+# 조건부적인 OpenAPI
+
+필요한 경우, 설정 및 환경 변수를 사용하여 환경에 따라 조건부로 OpenAPI를 구성하고 완전히 비활성화할 수도 있습니다.
+
+## 보안, API 및 docs에 대해서
+
+프로덕션에서, 문서화된 사용자 인터페이스(UI)를 숨기는 것이 API를 보호하는 방법이 *되어서는 안 됩니다*.
+
+이는 API에 추가적인 보안을 제공하지 않으며, *경로 작업*은 여전히 동일한 위치에서 사용 할 수 있습니다.
+
+코드에 보안 결함이 있다면, 그 결함은 여전히 존재할 것입니다.
+
+문서를 숨기는 것은 API와 상호작용하는 방법을 이해하기 어렵게 만들며, 프로덕션에서 디버깅을 더 어렵게 만들 수 있습니다. 이는 단순히 <a href="https://en.wikipedia.org/wiki/Security_through_obscurity" class="external-link" target="_blank">'모호성에 의한 보안'</a>의 한 형태로 간주될 수 있습니다.
+
+API를 보호하고 싶다면, 예를 들어 다음과 같은 더 나은 방법들이 있습니다:
+
+* 요청 본문과 응답에 대해 잘 정의된 Pydantic 모델을 사용하도록 하세요.
+
+* 종속성을 사용하여 필요한 권한과 역할을 구성하세요.
+
+* 평문 비밀번호를 절대 저장하지 말고, 오직 암호화된 비밀번호만 저장하세요.
+
+* Passlib과 JWT 토큰과 같은 잘 알려진 암호화 도구들을 구현하고 사용하세요.
+
+* 필요한 곳에 OAuth2 범위를 사용하여 더 세분화된 권한 제어를 추가하세요.
+
+* 등등....
+
+그럼에도 불구하고, 특정 환경(예: 프로덕션)에서 또는 환경 변수의 설정에 따라 API 문서를 비활성화해야 하는 매우 특정한 사용 사례가 있을 수 있습니다.
+
+## 설정 및 환경변수의 조건부 OpenAPI
+
+동일한 Pydantic 설정을 사용하여 생성된 OpenAPI 및 문서 UI를 쉽게 구성할 수 있습니다.
+
+예를 들어:
+
+{* ../../docs_src/conditional_openapi/tutorial001.py hl[6,11] *}
+
+여기서 `openapi_url` 설정을 기본값인 `"/openapi.json"`으로 선언합니다.
+
+그런 뒤, 우리는 `FastAPI` 앱을 만들 때 그것을 사용합니다.
+
+환경 변수 `OPENAPI_URL`을 빈 문자열로 설정하여 OpenAPI(문서 UI 포함)를 비활성화할 수도 있습니다. 예를 들어:
+
+<div class="termy">
+
+```console
+$ OPENAPI_URL= uvicorn main:app
+
+<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+</div>
+
+그리고 `/openapi.json`, `/docs` 또는 `/redoc`의 URL로 이동하면 `404 Not Found`라는 오류가 다음과 같이 표시됩니다:
+
+```JSON
+{
+ "detail": "Not Found"
+}
+```
From 4565466f3494ad4c0a56927994087e238fc4a13a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 7 Nov 2024 20:43:27 +0000
Subject: [PATCH 383/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 912b75974..1adf634da 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `docs/ko/docs/advanced/using_request_directly.md`. PR [#12738](https://github.com/fastapi/fastapi/pull/12738) by [@kwang1215](https://github.com/kwang1215).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/testing-events.md`. PR [#12741](https://github.com/fastapi/fastapi/pull/12741) by [@9zimin9](https://github.com/9zimin9).
* 🌐 Add Korean translation for `docs/ko/docs/security/index.md`. PR [#12743](https://github.com/fastapi/fastapi/pull/12743) by [@kim-sangah](https://github.com/kim-sangah).
* 🌐 Add Portuguese translation for `docs/pt/docs/advanced/path-operation-advanced-configuration.md`. PR [#12762](https://github.com/fastapi/fastapi/pull/12762) by [@Joao-Pedro-P-Holanda](https://github.com/Joao-Pedro-P-Holanda).
From 321053bdef17bbe3dffba0c324a9f6215411fcfe Mon Sep 17 00:00:00 2001
From: kim-sangah <kimsangah_@naver.com>
Date: Fri, 8 Nov 2024 05:43:46 +0900
Subject: [PATCH 384/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/advanced/advanced-dependencies.md`=20(?=
=?UTF-8?q?#12675)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../ko/docs/advanced/advanced-dependencies.md | 179 ++++++++++++++++++
1 file changed, 179 insertions(+)
create mode 100644 docs/ko/docs/advanced/advanced-dependencies.md
diff --git a/docs/ko/docs/advanced/advanced-dependencies.md b/docs/ko/docs/advanced/advanced-dependencies.md
new file mode 100644
index 000000000..aa5a332f8
--- /dev/null
+++ b/docs/ko/docs/advanced/advanced-dependencies.md
@@ -0,0 +1,179 @@
+# 고급 의존성
+
+## 매개변수화된 의존성
+
+지금까지 본 모든 의존성은 고정된 함수 또는 클래스입니다.
+
+하지만 여러 개의 함수나 클래스를 선언하지 않고도 의존성에 매개변수를 설정해야 하는 경우가 있을 수 있습니다.
+
+예를 들어, `q` 쿼리 매개변수가 특정 고정된 내용을 포함하고 있는지 확인하는 의존성을 원한다고 가정해 봅시다.
+
+이때 해당 고정된 내용을 매개변수화할 수 있길 바랍니다.
+
+## "호출 가능한" 인스턴스
+
+Python에는 클래스의 인스턴스를 "호출 가능"하게 만드는 방법이 있습니다.
+
+클래스 자체(이미 호출 가능함)가 아니라 해당 클래스의 인스턴스에 대해 호출 가능하게 하는 것입니다.
+
+이를 위해 `__call__` 메서드를 선언합니다:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="12"
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="11"
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | 참고
+
+가능하다면 `Annotated` 버전을 사용하는 것이 좋습니다.
+
+///
+
+```Python hl_lines="10"
+{!> ../../docs_src/dependencies/tutorial011.py!}
+```
+
+////
+
+이 경우, **FastAPI**는 추가 매개변수와 하위 의존성을 확인하기 위해 `__call__`을 사용하게 되며,
+나중에 *경로 연산 함수*에서 매개변수에 값을 전달할 때 이를 호출하게 됩니다.
+
+## 인스턴스 매개변수화하기
+
+이제 `__init__`을 사용하여 의존성을 "매개변수화"할 수 있는 인스턴스의 매개변수를 선언할 수 있습니다:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="9"
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="8"
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | 참고
+
+가능하다면 `Annotated` 버전을 사용하는 것이 좋습니다.
+
+///
+
+```Python hl_lines="7"
+{!> ../../docs_src/dependencies/tutorial011.py!}
+```
+
+////
+
+이 경우, **FastAPI**는 `__init__`에 전혀 관여하지 않으며, 우리는 이 메서드를 코드에서 직접 사용하게 됩니다.
+
+## 인스턴스 생성하기
+
+다음과 같이 이 클래스의 인스턴스를 생성할 수 있습니다:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="18"
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="17"
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | 참고
+
+가능하다면 `Annotated` 버전을 사용하는 것이 좋습니다.
+
+///
+
+```Python hl_lines="16"
+{!> ../../docs_src/dependencies/tutorial011.py!}
+```
+
+////
+
+이렇게 하면 `checker.fixed_content` 속성에 `"bar"`라는 값을 담아 의존성을 "매개변수화"할 수 있습니다.
+
+## 인스턴스를 의존성으로 사용하기
+
+그런 다음, `Depends(FixedContentQueryChecker)` 대신 `Depends(checker)`에서 이 `checker` 인스턴스를 사용할 수 있으며,
+클래스 자체가 아닌 인스턴스 `checker`가 의존성이 됩니다.
+
+의존성을 해결할 때 **FastAPI**는 이 `checker`를 다음과 같이 호출합니다:
+
+```Python
+checker(q="somequery")
+```
+
+...그리고 이때 반환되는 값을 *경로 연산 함수*의 `fixed_content_included` 매개변수로 전달합니다:
+
+//// tab | Python 3.9+
+
+```Python hl_lines="22"
+{!> ../../docs_src/dependencies/tutorial011_an_py39.py!}
+```
+
+////
+
+//// tab | Python 3.8+
+
+```Python hl_lines="21"
+{!> ../../docs_src/dependencies/tutorial011_an.py!}
+```
+
+////
+
+//// tab | Python 3.8+ non-Annotated
+
+/// tip | 참고
+
+가능하다면 `Annotated` 버전을 사용하는 것이 좋습니다.
+
+///
+
+```Python hl_lines="20"
+{!> ../../docs_src/dependencies/tutorial011.py!}
+```
+
+////
+
+/// tip | 참고
+
+이 모든 과정이 복잡하게 느껴질 수 있습니다. 그리고 지금은 이 방법이 얼마나 유용한지 명확하지 않을 수도 있습니다.
+
+이 예시는 의도적으로 간단하게 만들었지만, 전체 구조가 어떻게 작동하는지 보여줍니다.
+
+보안 관련 장에서는 이와 같은 방식으로 구현된 편의 함수들이 있습니다.
+
+이 모든 과정을 이해했다면, 이러한 보안 도구들이 내부적으로 어떻게 작동하는지 이미 파악한 것입니다.
+
+///
From 1b8030945fff1bcbda098e81d8612ac8412d906f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 7 Nov 2024 20:45:49 +0000
Subject: [PATCH 385/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 1adf634da..4ca504c12 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `docs/ko/docs/how-to/conditional-openapi.md`. PR [#12731](https://github.com/fastapi/fastapi/pull/12731) by [@sptcnl](https://github.com/sptcnl).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/using_request_directly.md`. PR [#12738](https://github.com/fastapi/fastapi/pull/12738) by [@kwang1215](https://github.com/kwang1215).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/testing-events.md`. PR [#12741](https://github.com/fastapi/fastapi/pull/12741) by [@9zimin9](https://github.com/9zimin9).
* 🌐 Add Korean translation for `docs/ko/docs/security/index.md`. PR [#12743](https://github.com/fastapi/fastapi/pull/12743) by [@kim-sangah](https://github.com/kim-sangah).
From 745c073a6b37bbbb9c262eed79bacfae54f9e1a9 Mon Sep 17 00:00:00 2001
From: Saeye Lee <62229734+saeye@users.noreply.github.com>
Date: Fri, 8 Nov 2024 05:46:14 +0900
Subject: [PATCH 386/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/history-design-future.md`=20(#12646)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/history-design-future.md | 81 +++++++++++++++++++++++++++
1 file changed, 81 insertions(+)
create mode 100644 docs/ko/docs/history-design-future.md
diff --git a/docs/ko/docs/history-design-future.md b/docs/ko/docs/history-design-future.md
new file mode 100644
index 000000000..6680a46e7
--- /dev/null
+++ b/docs/ko/docs/history-design-future.md
@@ -0,0 +1,81 @@
+# 역사, 디자인 그리고 미래
+
+어느 날, [한 FastAPI 사용자](https://github.com/fastapi/fastapi/issues/3#issuecomment-454956920)가 이렇게 물었습니다:
+
+> 이 프로젝트의 역사를 알려 주실 수 있나요? 몇 주 만에 멋진 결과를 낸 것 같아요. [...]
+
+여기서 그 역사에 대해 간단히 설명하겠습니다.
+
+---
+
+## 대안
+
+저는 여러 해 동안 머신러닝, 분산 시스템, 비동기 작업, NoSQL 데이터베이스 같은 복잡한 요구사항을 가진 API를 개발하며 여러 팀을 이끌어 왔습니다.
+
+이 과정에서 많은 대안을 조사하고, 테스트하며, 사용해야 했습니다. **FastAPI**의 역사는 그 이전에 나왔던 여러 도구의 역사와 밀접하게 연관되어 있습니다.
+
+[대안](alternatives.md){.internal-link target=_blank} 섹션에서 언급된 것처럼:
+
+> **FastAPI**는 이전에 나왔던 많은 도구들의 노력 없이는 존재하지 않았을 것입니다.
+>
+> 이전에 개발된 여러 도구들이 이 프로젝트에 영감을 주었습니다.
+>
+> 저는 오랫동안 새로운 프레임워크를 만드는 것을 피하고자 했습니다. 처음에는 **FastAPI**가 제공하는 기능들을 다양한 프레임워크와 플러그인, 도구들을 조합해 해결하려 했습니다.
+>
+> 하지만 결국에는 이 모든 기능을 통합하는 도구가 필요해졌습니다. 이전 도구들로부터 최고의 아이디어들을 모으고, 이를 최적의 방식으로 조합해야만 했습니다. 이는 :term:Python 3.6+ 타입 힌트 <type hints>와 같은, 이전에는 사용할 수 없었던 언어 기능이 가능했기 때문입니다.
+
+---
+
+## 조사
+
+여러 대안을 사용해 보며 다양한 도구에서 배운 점들을 모아 저와 개발팀에게 가장 적합한 방식을 찾았습니다.
+
+예를 들어, 표준 :term:Python 타입 힌트 <type hints>에 기반하는 것이 이상적이라는 점이 명확했습니다.
+
+또한, 이미 존재하는 표준을 활용하는 것이 가장 좋은 접근법이라 판단했습니다.
+
+그래서 **FastAPI**의 코드를 작성하기 전에 몇 달 동안 OpenAPI, JSON Schema, OAuth2 명세를 연구하며 이들의 관계와 겹치는 부분, 차이점을 이해했습니다.
+
+---
+
+## 디자인
+
+그 후, **FastAPI** 사용자가 될 개발자로서 사용하고 싶은 개발자 "API"를 디자인했습니다.
+
+[Python Developer Survey](https://www.jetbrains.com/research/python-developers-survey-2018/#development-tools)에 따르면 약 80%의 Python 개발자가 PyCharm, VS Code, Jedi 기반 편집기 등에서 개발합니다. 이 과정에서 여러 아이디어를 테스트했습니다.
+
+대부분의 다른 편집기도 유사하게 동작하기 때문에, **FastAPI**의 이점은 거의 모든 편집기에서 누릴 수 있습니다.
+
+이 과정을 통해 코드 중복을 최소화하고, 모든 곳에서 자동 완성, 타입 검사, 에러 확인 기능이 제공되는 최적의 방식을 찾아냈습니다.
+
+이 모든 것은 개발자들에게 최고의 개발 경험을 제공하기 위해 설계되었습니다.
+
+---
+
+## 필요조건
+
+여러 대안을 테스트한 후, [Pydantic](https://docs.pydantic.dev/)을 사용하기로 결정했습니다.
+
+이후 저는 **Pydantic**이 JSON Schema와 완벽히 호환되도록 개선하고, 다양한 제약 조건 선언을 지원하며, 여러 편집기에서의 자동 완성과 타입 검사 기능을 향상하기 위해 기여했습니다.
+
+또한, 또 다른 주요 필요조건이었던 [Starlette](https://www.starlette.io/)에도 기여했습니다.
+
+---
+
+## 개발
+
+**FastAPI**를 개발하기 시작할 즈음에는 대부분의 준비가 이미 완료된 상태였습니다. 설계가 정의되었고, 필요조건과 도구가 준비되었으며, 표준과 명세에 대한 지식도 충분했습니다.
+
+---
+
+## 미래
+
+현시점에서 **FastAPI**가 많은 사람들에게 유용하다는 것이 명백해졌습니다.
+
+여러 용도에 더 적합한 도구로서 기존 대안보다 선호되고 있습니다.
+이미 많은 개발자와 팀들이 **FastAPI**에 의존해 프로젝트를 진행 중입니다 (저와 제 팀도 마찬가지입니다).
+
+하지만 여전히 개선해야 할 점과 추가할 기능들이 많이 남아 있습니다.
+
+**FastAPI**는 밝은 미래로 나아가고 있습니다.
+그리고 [여러분의 도움](help-fastapi.md){.internal-link target=_blank}은 큰 힘이 됩니다.
From 3ff6cfd544ac4fca6ec76d87ffc0a2eae4707691 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 7 Nov 2024 20:48:35 +0000
Subject: [PATCH 387/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4ca504c12..fe1789a70 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `docs/ko/docs/advanced/advanced-dependencies.md`. PR [#12675](https://github.com/fastapi/fastapi/pull/12675) by [@kim-sangah](https://github.com/kim-sangah).
* 🌐 Add Korean translation for `docs/ko/docs/how-to/conditional-openapi.md`. PR [#12731](https://github.com/fastapi/fastapi/pull/12731) by [@sptcnl](https://github.com/sptcnl).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/using_request_directly.md`. PR [#12738](https://github.com/fastapi/fastapi/pull/12738) by [@kwang1215](https://github.com/kwang1215).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/testing-events.md`. PR [#12741](https://github.com/fastapi/fastapi/pull/12741) by [@9zimin9](https://github.com/9zimin9).
From 647a0dcad31133e9f812303c500a311e62897a91 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 7 Nov 2024 20:52:31 +0000
Subject: [PATCH 388/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fe1789a70..78e98cbc1 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `docs/ko/docs/history-design-future.md`. PR [#12646](https://github.com/fastapi/fastapi/pull/12646) by [@saeye](https://github.com/saeye).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/advanced-dependencies.md`. PR [#12675](https://github.com/fastapi/fastapi/pull/12675) by [@kim-sangah](https://github.com/kim-sangah).
* 🌐 Add Korean translation for `docs/ko/docs/how-to/conditional-openapi.md`. PR [#12731](https://github.com/fastapi/fastapi/pull/12731) by [@sptcnl](https://github.com/sptcnl).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/using_request_directly.md`. PR [#12738](https://github.com/fastapi/fastapi/pull/12738) by [@kwang1215](https://github.com/kwang1215).
From d28bae06e4b73feb98282874d6031c3ba6dd7b64 Mon Sep 17 00:00:00 2001
From: Hyunjun KIM <hihj070914@icloud.com>
Date: Fri, 8 Nov 2024 05:57:27 +0900
Subject: [PATCH 389/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`/docs/ko/docs/environment-variables.md`=20(#12526)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/environment-variables.md | 298 ++++++++++++++++++++++++++
1 file changed, 298 insertions(+)
create mode 100644 docs/ko/docs/environment-variables.md
diff --git a/docs/ko/docs/environment-variables.md b/docs/ko/docs/environment-variables.md
new file mode 100644
index 000000000..09c2fd6d3
--- /dev/null
+++ b/docs/ko/docs/environment-variables.md
@@ -0,0 +1,298 @@
+# 환경 변수
+
+/// tip | "팁"
+
+만약 "환경 변수"가 무엇이고, 어떻게 사용하는지 알고 계시다면, 이 챕터를 스킵하셔도 좋습니다.
+
+///
+
+환경 변수는 파이썬 코드의 **바깥**인, **운영 체제**에 존재하는 변수입니다. 파이썬 코드나 다른 프로그램에서 읽을 수 있습니다.
+
+환경 변수는 애플리케이션 **설정**을 처리하거나, 파이썬의 **설치** 과정의 일부로 유용합니다.
+
+## 환경 변수를 만들고 사용하기
+
+파이썬 없이도, **셸 (터미널)** 에서 환경 변수를 **생성** 하고 사용할 수 있습니다.
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// You could create an env var MY_NAME with
+$ export MY_NAME="Wade Wilson"
+
+// Then you could use it with other programs, like
+$ echo "Hello $MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// Create an env var MY_NAME
+$ $Env:MY_NAME = "Wade Wilson"
+
+// Use it with other programs, like
+$ echo "Hello $Env:MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+## 파이썬에서 환경 변수 읽기
+
+파이썬 **바깥**인 터미널에서(다른 도구로도 가능) 환경 변수를 생성도 할 수도 있고, 이를 **파이썬에서 읽을 수 있습니다.**
+
+예를 들어 다음과 같은 `main.py` 파일이 있다고 합시다:
+
+```Python hl_lines="3"
+import os
+
+name = os.getenv("MY_NAME", "World")
+print(f"Hello {name} from Python")
+```
+
+/// tip | "팁"
+
+<a href="https://docs.python.org/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> 의 두 번째 인자는 반환할 기본값입니다.
+
+여기서는 `"World"`를 넣었기에 기본값으로써 사용됩니다. 넣지 않으면 `None` 이 기본값으로 사용됩니다.
+
+///
+
+그러면 해당 파이썬 프로그램을 다음과 같이 호출할 수 있습니다:
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// Here we don't set the env var yet
+$ python main.py
+
+// As we didn't set the env var, we get the default value
+
+Hello World from Python
+
+// But if we create an environment variable first
+$ export MY_NAME="Wade Wilson"
+
+// And then call the program again
+$ python main.py
+
+// Now it can read the environment variable
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// Here we don't set the env var yet
+$ python main.py
+
+// As we didn't set the env var, we get the default value
+
+Hello World from Python
+
+// But if we create an environment variable first
+$ $Env:MY_NAME = "Wade Wilson"
+
+// And then call the program again
+$ python main.py
+
+// Now it can read the environment variable
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+환경변수는 코드 바깥에서 설정될 수 있지만, 코드에서 읽을 수 있고, 나머지 파일과 함께 저장(`git`에 커밋)할 필요가 없으므로, 구성이나 **설정** 에 사용하는 것이 일반적입니다.
+
+**특정 프로그램 호출**에 대해서만 사용할 수 있는 환경 변수를 만들 수도 있습니다. 해당 프로그램에서만 사용할 수 있고, 해당 프로그램이 실행되는 동안만 사용할 수 있습니다.
+
+그렇게 하려면 프로그램 바로 앞, 같은 줄에 환경 변수를 만들어야 합니다:
+
+<div class="termy">
+
+```console
+// Create an env var MY_NAME in line for this program call
+$ MY_NAME="Wade Wilson" python main.py
+
+// Now it can read the environment variable
+
+Hello Wade Wilson from Python
+
+// The env var no longer exists afterwards
+$ python main.py
+
+Hello World from Python
+```
+
+</div>
+
+/// tip | "팁"
+
+<a href="https://12factor.net/config" class="external-link" target="_blank">The Twelve-Factor App: Config</a> 에서 좀 더 자세히 알아볼 수 있습니다.
+
+///
+
+## 타입과 검증
+
+이 환경변수들은 오직 **텍스트 문자열**로만 처리할 수 있습니다. 텍스트 문자열은 파이썬 외부에 있으며 다른 프로그램 및 나머지 시스템(Linux, Windows, macOS 등 다른 운영 체제)과 호환되어야 합니다.
+
+즉, 파이썬에서 환경 변수로부터 읽은 **모든 값**은 **`str`**이 되고, 다른 타입으로의 변환이나 검증은 코드에서 수행해야 합니다.
+
+**애플리케이션 설정**을 처리하기 위한 환경 변수 사용에 대한 자세한 내용은 [고급 사용자 가이드 - 설정 및 환경 변수](./advanced/settings.md){.internal-link target=\_blank} 에서 확인할 수 있습니다.
+
+## `PATH` 환경 변수
+
+**`PATH`**라고 불리는, **특별한** 환경변수가 있습니다. 운영체제(Linux, Windows, macOS 등)에서 실행할 프로그램을 찾기위해 사용됩니다.
+
+변수 `PATH`의 값은 Linux와 macOS에서는 콜론 `:`, Windows에서는 세미콜론 `;`으로 구분된 디렉토리로 구성된 긴 문자열입니다.
+
+예를 들어, `PATH` 환경 변수는 다음과 같습니다:
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+이는 시스템이 다음 디렉토리에서 프로그램을 찾아야 함을 의미합니다:
+
+- `/usr/local/bin`
+- `/usr/bin`
+- `/bin`
+- `/usr/sbin`
+- `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32
+```
+
+이는 시스템이 다음 디렉토리에서 프로그램을 찾아야 함을 의미합니다:
+
+- `C:\Program Files\Python312\Scripts`
+- `C:\Program Files\Python312`
+- `C:\Windows\System32`
+
+////
+
+터미널에 **명령어**를 입력하면 운영 체제는 `PATH` 환경 변수에 나열된 **각 디렉토리**에서 프로그램을 **찾습니다.**
+
+예를 들어 터미널에 `python`을 입력하면 운영 체제는 해당 목록의 **첫 번째 디렉토리**에서 `python`이라는 프로그램을 찾습니다.
+
+찾으면 **사용합니다**. 그렇지 않으면 **다른 디렉토리**에서 계속 찾습니다.
+
+### 파이썬 설치와 `PATH` 업데이트
+
+파이썬을 설치할 때, 아마 `PATH` 환경 변수를 업데이트 할 것이냐고 물어봤을 겁니다.
+
+//// tab | Linux, macOS
+
+파이썬을 설치하고 그것이 `/opt/custompython/bin` 디렉토리에 있다고 가정해 보겠습니다.
+
+`PATH` 환경 변수를 업데이트하도록 "예"라고 하면 설치 관리자가 `/opt/custompython/bin`을 `PATH` 환경 변수에 추가합니다.
+
+다음과 같이 보일 수 있습니다:
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin
+```
+
+이렇게 하면 터미널에 `python`을 입력할 때, 시스템이 `/opt/custompython/bin`(마지막 디렉토리)에서 파이썬 프로그램을 찾아 사용합니다.
+
+////
+
+//// tab | Windows
+
+파이썬을 설치하고 그것이 `C:\opt\custompython\bin` 디렉토리에 있다고 가정해 보겠습니다.
+
+`PATH` 환경 변수를 업데이트하도록 "예"라고 하면 설치 관리자가 `C:\opt\custompython\bin`을 `PATH` 환경 변수에 추가합니다.
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin
+```
+
+이렇게 하면 터미널에 `python`을 입력할 때, 시스템이 `C:\opt\custompython\bin`(마지막 디렉토리)에서 파이썬 프로그램을 찾아 사용합니다.
+
+////
+
+그래서, 다음과 같이 입력한다면:
+
+<div class="termy">
+
+```console
+$ python
+```
+
+</div>
+
+//// tab | Linux, macOS
+
+시스템은 `/opt/custompython/bin`에서 `python` 프로그램을 **찾아** 실행합니다.
+
+다음과 같이 입력하는 것과 거의 같습니다:
+
+<div class="termy">
+
+```console
+$ /opt/custompython/bin/python
+```
+
+</div>
+
+////
+
+//// tab | Windows
+
+시스템은 `C:\opt\custompython\bin\python`에서 `python` 프로그램을 **찾아** 실행합니다.
+
+다음과 같이 입력하는 것과 거의 같습니다:
+
+<div class="termy">
+
+```console
+$ C:\opt\custompython\bin\python
+```
+
+</div>
+
+////
+
+이 정보는 [가상 환경](virtual-environments.md){.internal-link target=\_blank} 에 대해 알아볼 때 유용할 것입니다.
+
+## 결론
+
+이 문서를 읽고 **환경 변수**가 무엇이고 파이썬에서 어떻게 사용하는지 기본적으로 이해하셨을 겁니다.
+
+또한 <a href="https://ko.wikipedia.org/wiki/환경_변수" class="external-link" target="_blank">환경 변수에 대한 위키피디아(한국어)</a>에서 이에 대해 자세히 알아볼 수 있습니다.
+
+많은 경우에서, 환경 변수가 어떻게 유용하고 적용 가능한지 바로 명확하게 알 수는 없습니다. 하지만 개발할 때 다양한 시나리오에서 계속 나타나므로 이에 대해 아는 것이 좋습니다.
+
+예를 들어, 다음 섹션인 [가상 환경](virtual-environments.md)에서 이 정보가 필요합니다.
From 2809c08a70c5b429a8fe803a5d62802d44d066be Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 7 Nov 2024 21:05:45 +0000
Subject: [PATCH 390/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 78e98cbc1..3764e2f96 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `/docs/ko/docs/environment-variables.md`. PR [#12526](https://github.com/fastapi/fastapi/pull/12526) by [@Tolerblanc](https://github.com/Tolerblanc).
* 🌐 Add Korean translation for `docs/ko/docs/history-design-future.md`. PR [#12646](https://github.com/fastapi/fastapi/pull/12646) by [@saeye](https://github.com/saeye).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/advanced-dependencies.md`. PR [#12675](https://github.com/fastapi/fastapi/pull/12675) by [@kim-sangah](https://github.com/kim-sangah).
* 🌐 Add Korean translation for `docs/ko/docs/how-to/conditional-openapi.md`. PR [#12731](https://github.com/fastapi/fastapi/pull/12731) by [@sptcnl](https://github.com/sptcnl).
From 45d9fabbdd3b0d30f4faa87c9abc95b9cb73d615 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8F=B2=E4=BA=91=E6=98=94=20=28Vincy=20SHI=29?=
<vincy@vincy1230.net>
Date: Sat, 9 Nov 2024 03:23:26 +0800
Subject: [PATCH 391/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Chinese=20translat?=
=?UTF-8?q?ion=20for=20`docs/zh/docs/virtual-environments.md`=20(#12790)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh/docs/virtual-environments.md | 844 +++++++++++++++++++++++++++
1 file changed, 844 insertions(+)
create mode 100644 docs/zh/docs/virtual-environments.md
diff --git a/docs/zh/docs/virtual-environments.md b/docs/zh/docs/virtual-environments.md
new file mode 100644
index 000000000..9b3c0340a
--- /dev/null
+++ b/docs/zh/docs/virtual-environments.md
@@ -0,0 +1,844 @@
+# 虚拟环境
+
+当你在 Python 工程中工作时，你可能会有必要用到一个**虚拟环境**（或类似的机制）来隔离你为每个工程安装的包。
+
+/// info
+
+如果你已经了解虚拟环境，知道如何创建和使用它们，你可以考虑跳过这一部分。🤓
+
+///
+
+/// tip
+
+**虚拟环境**和**环境变量**是不同的。
+
+**环境变量**是系统中的一个变量，可以被程序使用。
+
+**虚拟环境**是一个包含一些文件的目录。
+
+///
+
+/// info
+
+这个页面将教你如何使用**虚拟环境**以及了解它们的工作原理。
+
+如果你计划使用一个**可以为你管理一切的工具**（包括安装 Python），试试 <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">uv</a>。
+
+///
+
+## 创建一个工程
+
+首先，为你的工程创建一个目录。
+
+我 (指原作者 —— 译者注) 通常会在我的主目录下创建一个名为 `code` 的目录。
+
+在这个目录下，我再为每个工程创建一个目录。
+
+<div class="termy">
+
+```console
+// 进入主目录
+$ cd
+// 创建一个用于存放所有代码工程的目录
+$ mkdir code
+// 进入 code 目录
+$ cd code
+// 创建一个用于存放这个工程的目录
+$ mkdir awesome-project
+// 进入这个工程的目录
+$ cd awesome-project
+```
+
+</div>
+
+## 创建一个虚拟环境
+
+在开始一个 Python 工程的**第一时间**，**<abbr title="还有其他做法，此处仅作一个简单的指南">在你的工程内部</abbr>**创建一个虚拟环境。
+
+/// tip
+
+你只需要 **在每个工程中操作一次**，而不是每次工作时都操作。
+
+///
+
+//// tab | `venv`
+
+你可以使用 Python 自带的 `venv` 模块来创建一个虚拟环境。
+
+<div class="termy">
+
+```console
+$ python -m venv .venv
+```
+
+</div>
+
+/// details | 上述命令的含义
+
+* `python`: 使用名为 `python` 的程序
+* `-m`: 以脚本的方式调用一个模块，我们将告诉它接下来使用哪个模块
+* `venv`: 使用名为 `venv` 的模块，这个模块通常随 Python 一起安装
+* `.venv`: 在新目录 `.venv` 中创建虚拟环境
+
+///
+
+////
+
+//// tab | `uv`
+
+如果你安装了 <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>，你也可以使用它来创建一个虚拟环境。
+
+<div class="termy">
+
+```console
+$ uv venv
+```
+
+</div>
+
+/// tip
+
+默认情况下，`uv` 会在一个名为 `.venv` 的目录中创建一个虚拟环境。
+
+但你可以通过传递一个额外的参数来自定义它，指定目录的名称。
+
+///
+
+////
+
+这个命令会在一个名为 `.venv` 的目录中创建一个新的虚拟环境。
+
+/// details | `.venv`，或是其他名称
+
+你可以在不同的目录下创建虚拟环境，但通常我们会把它命名为 `.venv`。
+
+///
+
+## 激活虚拟环境
+
+激活新的虚拟环境来确保你运行的任何 Python 命令或安装的包都能使用到它。
+
+/// tip
+
+**每次**开始一个 **新的终端会话** 来工作在这个工程时，你都需要执行这个操作。
+
+///
+
+//// tab | Linux, macOS
+
+<div class="termy">
+
+```console
+$ source .venv/bin/activate
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ .venv\Scripts\Activate.ps1
+```
+
+</div>
+
+////
+
+//// tab | Windows Bash
+
+或者，如果你在 Windows 上使用 Bash（例如 <a href="https://gitforwindows.org/" class="external-link" target="_blank">Git Bash</a>）：
+
+<div class="termy">
+
+```console
+$ source .venv/Scripts/activate
+```
+
+</div>
+
+////
+
+/// tip
+
+每次你在这个环境中安装一个 **新的包** 时，都需要 **重新激活** 这个环境。
+
+这么做确保了当你使用一个由这个包安装的 **终端（<abbr title="命令行界面">CLI</abbr>）程序** 时，你使用的是你的虚拟环境中的程序，而不是全局安装、可能版本不同的程序。
+
+///
+
+## 检查虚拟环境是否激活
+
+检查虚拟环境是否激活 (前面的命令是否生效)。
+
+/// tip
+
+这是 **可选的**，但这是一个很好的方法，可以 **检查** 一切是否按预期工作，以及你是否使用了你打算使用的虚拟环境。
+
+///
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+$ which python
+
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+</div>
+
+如果它显示了在你工程 (在这个例子中是 `awesome-project`) 的 `.venv/bin/python` 中的 `python` 二进制文件，那么它就生效了。🎉
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ Get-Command python
+
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+</div>
+
+如果它显示了在你工程 (在这个例子中是 `awesome-project`) 的 `.venv\Scripts\python` 中的 `python` 二进制文件，那么它就生效了。🎉
+
+////
+
+## 升级 `pip`
+
+/// tip
+
+如果你使用 <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a> 来安装内容，而不是 `pip`，那么你就不需要升级 `pip`。😎
+
+///
+
+如果你使用 `pip` 来安装包（它是 Python 的默认组件），你应该将它 **升级** 到最新版本。
+
+在安装包时出现的许多奇怪的错误都可以通过先升级 `pip` 来解决。
+
+/// tip
+
+通常你只需要在创建虚拟环境后 **执行一次** 这个操作。
+
+///
+
+确保虚拟环境是激活的 (使用上面的命令)，然后运行：
+
+<div class="termy">
+
+```console
+$ python -m pip install --upgrade pip
+
+---> 100%
+```
+
+</div>
+
+## 添加 `.gitignore`
+
+如果你使用 **Git** (这是你应该使用的)，添加一个 `.gitignore` 文件来排除你的 `.venv` 中的所有内容。
+
+/// tip
+
+如果你使用 <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a> 来创建虚拟环境，它会自动为你完成这个操作，你可以跳过这一步。😎
+
+///
+
+/// tip
+
+通常你只需要在创建虚拟环境后 **执行一次** 这个操作。
+
+///
+
+<div class="termy">
+
+```console
+$ echo "*" > .venv/.gitignore
+```
+
+</div>
+
+/// details | 上述命令的含义
+
+* `echo "*"`: 将在终端中 "打印" 文本 `*`（接下来的部分会对这个操作进行一些修改）
+* `>`: 使左边的命令打印到终端的任何内容实际上都不会被打印，而是会被写入到右边的文件中
+* `.gitignore`: 被写入文本的文件的名称
+
+而 `*` 对于 Git 来说意味着 "所有内容"。所以，它会忽略 `.venv` 目录中的所有内容。
+
+该命令会创建一个名为 `.gitignore` 的文件，内容如下：
+
+```gitignore
+*
+```
+
+///
+
+## 安装软件包
+
+在激活虚拟环境后，你可以在其中安装软件包。
+
+/// tip
+
+当你需要安装或升级软件包时，执行本操作**一次**；
+
+如果你需要再升级版本或添加新软件包，你可以**再次执行此操作**。
+
+///
+
+### 直接安装包
+
+如果你急于安装，不想使用文件来声明工程的软件包依赖，您可以直接安装它们。
+
+/// tip
+
+将程序所需的软件包及其版本放在文件中（例如 `requirements.txt` 或 `pyproject.toml`）是个好（并且非常好）的主意。
+
+///
+
+//// tab | `pip`
+
+<div class="termy">
+
+```console
+$ pip install "fastapi[standard]"
+
+---> 100%
+```
+
+</div>
+
+////
+
+//// tab | `uv`
+
+如果你有 <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>:
+
+<div class="termy">
+
+```console
+$ uv pip install "fastapi[standard]"
+---> 100%
+```
+
+</div>
+
+////
+
+### 从 `requirements.txt` 安装
+
+如果你有一个 `requirements.txt` 文件，你可以使用它来安装其中的软件包。
+
+//// tab | `pip`
+
+<div class="termy">
+
+```console
+$ pip install -r requirements.txt
+---> 100%
+```
+
+</div>
+
+////
+
+//// tab | `uv`
+
+如果你有 <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>:
+
+<div class="termy">
+
+```console
+$ uv pip install -r requirements.txt
+---> 100%
+```
+
+</div>
+
+////
+
+/// details | 关于 `requirements.txt`
+
+一个包含一些软件包的 `requirements.txt` 文件看起来应该是这样的：
+
+```requirements.txt
+fastapi[standard]==0.113.0
+pydantic==2.8.0
+```
+
+///
+
+## 运行程序
+
+在你激活虚拟环境后，你可以运行你的程序，它将使用虚拟环境中的 Python 和你在其中安装的软件包。
+
+<div class="termy">
+
+```console
+$ python main.py
+
+Hello World
+```
+
+</div>
+
+## 配置编辑器
+
+你可能会用到编辑器（即 IDE —— 译者注），请确保配置它使用与你创建的相同的虚拟环境（它可能会自动检测到），以便你可以获得自动补全和内联错误提示。
+
+例如：
+
+* <a href="https://code.visualstudio.com/docs/python/environments#_select-and-activate-an-environment" class="external-link" target="_blank">VS Code</a>
+* <a href="https://www.jetbrains.com/help/pycharm/creating-virtual-environment.html" class="external-link" target="_blank">PyCharm</a>
+
+/// tip
+
+通常你只需要在创建虚拟环境时执行此操作**一次**。
+
+///
+
+## 退出虚拟环境
+
+当你完成工作后，你可以**退出**虚拟环境。
+
+<div class="termy">
+
+```console
+$ deactivate
+```
+
+</div>
+
+这样，当你运行 `python` 时，它不会尝试从安装了软件包的虚拟环境中运行。（即，它将不再会尝试从虚拟环境中运行，也不会使用其中安装的软件包。—— 译者注）
+
+## 开始工作
+
+现在你已经准备好开始你的工作了。
+
+
+
+/// tip
+
+你想要理解上面的所有内容吗？
+
+继续阅读。👇🤓
+
+///
+
+## 为什么要使用虚拟环境
+
+你需要安装 <a href="https://www.python.org/" class="external-link" target="_blank">Python</a> 才能使用 FastAPI。
+
+之后，你需要**安装** FastAPI 和你想要使用的任何其他**软件包**。
+
+要安装软件包，你通常会使用随 Python 一起提供的 `pip` 命令（或类似的替代方案）。
+
+然而，如果你直接使用 `pip`，软件包将被安装在你的**全局 Python 环境**中（即 Python 的全局安装）。
+
+### 存在的问题
+
+那么，在全局 Python 环境中安装软件包有什么问题呢？
+
+有些时候，你可能会编写许多不同的程序，这些程序依赖于**不同的软件包**；你所做的一些工程也会依赖于**同一软件包的不同版本**。😱
+
+例如，你可能会创建一个名为 `philosophers-stone` 的工程，这个程序依赖于另一个名为 **`harry` 的软件包，使用版本 `1`**。因此，你需要安装 `harry`。
+
+```mermaid
+flowchart LR
+ stone(philosophers-stone) -->|需要| harry-1[harry v1]
+```
+
+然而在此之后，你又创建了另一个名为 `prisoner-of-azkaban` 的工程，这个工程也依赖于 `harry`，但是这个工程需要 **`harry` 版本 `3`**。
+
+```mermaid
+flowchart LR
+ azkaban(prisoner-of-azkaban) --> |需要| harry-3[harry v3]
+```
+
+那么现在的问题是，如果你将软件包安装在全局环境中而不是在本地**虚拟环境**中，你将不得不面临选择安装哪个版本的 `harry` 的问题。
+
+如果你想运行 `philosophers-stone`，你需要首先安装 `harry` 版本 `1`，例如：
+
+<div class="termy">
+
+```console
+$ pip install "harry==1"
+```
+
+</div>
+
+然后你将在全局 Python 环境中安装 `harry` 版本 `1`。
+
+```mermaid
+flowchart LR
+ subgraph global[全局环境]
+ harry-1[harry v1]
+ end
+ subgraph stone-project[工程 philosophers-stone]
+ stone(philosophers-stone) -->|需要| harry-1
+ end
+```
+
+但是如果你想运行 `prisoner-of-azkaban`，你需要卸载 `harry` 版本 `1` 并安装 `harry` 版本 `3`（或者说，只要你安装版本 `3` ，版本 `1` 就会自动卸载）。
+
+<div class="termy">
+
+```console
+$ pip install "harry==3"
+```
+
+</div>
+
+于是，你在你的全局 Python 环境中安装了 `harry` 版本 `3`。
+
+如果你再次尝试运行 `philosophers-stone`，有可能它**无法正常工作**，因为它需要 `harry` 版本 `1`。
+
+```mermaid
+flowchart LR
+ subgraph global[全局环境]
+ harry-1[<strike>harry v1</strike>]
+ style harry-1 fill:#ccc,stroke-dasharray: 5 5
+ harry-3[harry v3]
+ end
+ subgraph stone-project[工程 philosophers-stone]
+ stone(philosophers-stone) -.-x|⛔️| harry-1
+ end
+ subgraph azkaban-project[工程 prisoner-of-azkaban]
+ azkaban(prisoner-of-azkaban) --> |需要| harry-3
+ end
+```
+
+/// tip
+
+Python 包在推出**新版本**时通常会尽量**避免破坏性更改**，但最好还是要小心，要想清楚再安装新版本，而且在运行测试以确保一切能正常工作时再安装。
+
+///
+
+现在，想象一下，如果有**许多**其他**软件包**，它们都是你的**工程所依赖的**。这是非常难以管理的。你可能会发现，有些工程使用了一些**不兼容的软件包版本**，而不知道为什么某些东西无法正常工作。
+
+此外，取决于你的操作系统（例如 Linux、Windows、macOS），它可能已经预先安装了 Python。在这种情况下，它可能已经预先安装了一些软件包，这些软件包的特定版本是**系统所需的**。如果你在全局 Python 环境中安装软件包，你可能会**破坏**一些随操作系统一起安装的程序。
+
+## 软件包安装在哪里
+
+当你安装 Python 时，它会在你的计算机上创建一些目录，并在这些目录中放一些文件。
+
+其中一些目录负责存放你安装的所有软件包。
+
+当你运行：
+
+<div class="termy">
+
+```console
+// 先别去运行这个命令，这只是一个示例 🤓
+$ pip install "fastapi[standard]"
+---> 100%
+```
+
+</div>
+
+这将会从 <a href="https://pypi.org/project/fastapi/" class="external-link" target="_blank">PyPI</a> 下载一个压缩文件，其中包含 FastAPI 代码。
+
+它还会**下载** FastAPI 依赖的其他软件包的文件。
+
+然后它会**解压**所有这些文件，并将它们放在你的计算机上的一个目录中。
+
+默认情况下，它会将下载并解压的这些文件放在随 Python 安装的目录中，这就是**全局环境**。
+
+## 什么是虚拟环境
+
+解决软件包都安装在全局环境中的问题的方法是为你所做的每个工程使用一个**虚拟环境**。
+
+虚拟环境是一个**目录**，与全局环境非常相似，你可以在其中专为某个工程安装软件包。
+
+这样，每个工程都会有自己的虚拟环境（`.venv` 目录），其中包含自己的软件包。
+
+```mermaid
+flowchart TB
+ subgraph stone-project[工程 philosophers-stone]
+ stone(philosophers-stone) --->|需要| harry-1
+ subgraph venv1[.venv]
+ harry-1[harry v1]
+ end
+ end
+ subgraph azkaban-project[工程 prisoner-of-azkaban]
+ azkaban(prisoner-of-azkaban) --->|需要| harry-3
+ subgraph venv2[.venv]
+ harry-3[harry v3]
+ end
+ end
+ stone-project ~~~ azkaban-project
+```
+
+## 激活虚拟环境意味着什么
+
+当你激活了一个虚拟环境，例如：
+
+//// tab | Linux, macOS
+
+<div class="termy">
+
+```console
+$ source .venv/bin/activate
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ .venv\Scripts\Activate.ps1
+```
+
+</div>
+
+////
+
+//// tab | Windows Bash
+
+或者如果你在 Windows 上使用 Bash（例如 <a href="https://gitforwindows.org/" class="external-link" target="_blank">Git Bash</a>）：
+
+<div class="termy">
+
+```console
+$ source .venv/Scripts/activate
+```
+
+</div>
+
+////
+
+这个命令会创建或修改一些[环境变量](environment-variables.md){.internal-link target=_blank}，这些环境变量将在接下来的命令中可用。
+
+其中之一是 `PATH` 变量。
+
+/// tip
+
+你可以在 [环境变量](environment-variables.md#path-environment-variable){.internal-link target=_blank} 部分了解更多关于 `PATH` 环境变量的内容。
+
+///
+
+激活虚拟环境会将其路径 `.venv/bin`（在 Linux 和 macOS 上）或 `.venv\Scripts`（在 Windows 上）添加到 `PATH` 环境变量中。
+
+假设在激活环境之前，`PATH` 变量看起来像这样：
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+这意味着系统会在以下目录中查找程序：
+
+* `/usr/bin`
+* `/bin`
+* `/usr/sbin`
+* `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Windows\System32
+```
+
+这意味着系统会在以下目录中查找程序：
+
+* `C:\Windows\System32`
+
+////
+
+激活虚拟环境后，`PATH` 变量会变成这样：
+
+//// tab | Linux, macOS
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+这意味着系统现在会首先在以下目录中查找程序：
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin
+```
+
+然后再在其他目录中查找。
+
+因此，当你在终端中输入 `python` 时，系统会在以下目录中找到 Python 程序：
+
+```plaintext
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+并使用这个。
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts;C:\Windows\System32
+```
+
+这意味着系统现在会首先在以下目录中查找程序：
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts
+```
+
+然后再在其他目录中查找。
+
+因此，当你在终端中输入 `python` 时，系统会在以下目录中找到 Python 程序：
+
+```plaintext
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+并使用这个。
+
+////
+
+一个重要的细节是，虚拟环境路径会被放在 `PATH` 变量的**开头**。系统会在找到任何其他可用的 Python **之前**找到它。这样，当你运行 `python` 时，它会使用**虚拟环境中**的 Python，而不是任何其他 `python`（例如，全局环境中的 `python`）。
+
+激活虚拟环境还会改变其他一些东西，但这是它所做的最重要的事情之一。
+
+## 检查虚拟环境
+
+当你检查虚拟环境是否激活时，例如：
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+$ which python
+
+/home/user/code/awesome-project/.venv/bin/python
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+$ Get-Command python
+
+C:\Users\user\code\awesome-project\.venv\Scripts\python
+```
+
+</div>
+
+////
+
+这意味着将使用的 `python` 程序是**在虚拟环境中**的那个。
+
+在 Linux 和 macOS 中使用 `which`，在 Windows PowerShell 中使用 `Get-Command`。
+
+这个命令的工作方式是，它会在 `PATH` 环境变量中查找，按顺序**逐个路径**查找名为 `python` 的程序。一旦找到，它会**显示该程序的路径**。
+
+最重要的部分是，当你调用 `python` 时，将执行的就是这个确切的 "`python`"。
+
+因此，你可以确认你是否在正确的虚拟环境中。
+
+/// tip
+
+激活一个虚拟环境，获取一个 Python，然后**转到另一个工程**是一件很容易的事情；
+
+但如果第二个工程**无法工作**，那是因为你使用了来自另一个工程的虚拟环境的、**不正确的 Python**。
+
+因此，会检查正在使用的 `python` 是很有用的。🤓
+
+///
+
+## 为什么要停用虚拟环境
+
+例如，你可能正在一个工程 `philosophers-stone` 上工作，**激活了该虚拟环境**，安装了包并使用了该环境，
+
+然后你想要在**另一个工程** `prisoner-of-azkaban` 上工作，
+
+你进入那个工程：
+
+<div class="termy">
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+```
+
+</div>
+
+如果你不去停用 `philosophers-stone` 的虚拟环境，当你在终端中运行 `python` 时，它会尝试使用 `philosophers-stone` 中的 Python。
+
+<div class="termy">
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+
+$ python main.py
+
+// 导入 sirius 报错，它没有安装 😱
+Traceback (most recent call last):
+ File "main.py", line 1, in <module>
+ import sirius
+```
+
+</div>
+
+但是如果你停用虚拟环境并激活 `prisoner-of-askaban` 的新虚拟环境，那么当你运行 `python` 时，它会使用 `prisoner-of-askaban` 中的虚拟环境中的 Python。
+
+<div class="termy">
+
+```console
+$ cd ~/code/prisoner-of-azkaban
+
+// 你不需要在旧目录中操作停用，你可以在任何地方操作停用，甚至在转到另一个工程之后 😎
+$ deactivate
+
+// 激活 prisoner-of-azkaban/.venv 中的虚拟环境 🚀
+$ source .venv/bin/activate
+
+// 现在当你运行 python 时，它会在这个虚拟环境中找到安装的 sirius 包 ✨
+$ python main.py
+
+I solemnly swear 🐺
+```
+
+</div>
+
+## 替代方案
+
+这是一个简单的指南，可以帮助你入门并教会你如何理解一切**底层**的东西。
+
+有许多**替代方案**来管理虚拟环境、包依赖（requirements）、工程。
+
+一旦你准备好并想要使用一个工具来**管理整个工程**、包依赖、虚拟环境等，建议你尝试 <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">uv</a>。
+
+`uv` 可以做很多事情，它可以：
+
+* 为你**安装 Python**，包括不同的版本
+* 为你的工程管理**虚拟环境**
+* 安装**软件包**
+* 为你的工程管理软件包的**依赖和版本**
+* 确保你有一个**确切**的软件包和版本集合来安装，包括它们的依赖项，这样你就可以确保在生产中运行你的工程与在开发时在你的计算机上运行的工程完全相同，这被称为**锁定**
+* 还有很多其他功能
+
+## 结论
+
+如果你读过并理解了所有这些，现在**你对虚拟环境的了解比很多开发者都要多**。🤓
+
+在未来当你调试看起来复杂的东西时，了解这些细节很可能会有用，你会知道**它是如何在底层工作的**。😎
From 4f430f49ace8153eb605a39919a03cfaba0127f4 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 8 Nov 2024 19:23:51 +0000
Subject: [PATCH 392/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3764e2f96..718d1d57b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Chinese translation for `docs/zh/docs/virtual-environments.md`. PR [#12790](https://github.com/fastapi/fastapi/pull/12790) by [@Vincy1230](https://github.com/Vincy1230).
* 🌐 Add Korean translation for `/docs/ko/docs/environment-variables.md`. PR [#12526](https://github.com/fastapi/fastapi/pull/12526) by [@Tolerblanc](https://github.com/Tolerblanc).
* 🌐 Add Korean translation for `docs/ko/docs/history-design-future.md`. PR [#12646](https://github.com/fastapi/fastapi/pull/12646) by [@saeye](https://github.com/saeye).
* 🌐 Add Korean translation for `docs/ko/docs/advanced/advanced-dependencies.md`. PR [#12675](https://github.com/fastapi/fastapi/pull/12675) by [@kim-sangah](https://github.com/kim-sangah).
From 075f41bad98c46d483482f3dfd36b707a5f2895a Mon Sep 17 00:00:00 2001
From: LKY <74170199+kwang1215@users.noreply.github.com>
Date: Sat, 9 Nov 2024 04:42:29 +0900
Subject: [PATCH 393/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`ko/docs/advanced/response-headers.md`=20(#12740)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/advanced/response-headers.md | 45 +++++++++++++++++++++++
1 file changed, 45 insertions(+)
create mode 100644 docs/ko/docs/advanced/response-headers.md
diff --git a/docs/ko/docs/advanced/response-headers.md b/docs/ko/docs/advanced/response-headers.md
new file mode 100644
index 000000000..54cf655c5
--- /dev/null
+++ b/docs/ko/docs/advanced/response-headers.md
@@ -0,0 +1,45 @@
+# 응답 헤더
+
+## `Response` 매개변수 사용하기
+
+여러분은 *경로 작동 함수*에서 `Response` 타입의 매개변수를 선언할 수 있습니다 (쿠키와 같이 사용할 수 있습니다).
+
+그런 다음, 여러분은 해당 *임시* 응답 객체에서 헤더를 설정할 수 있습니다.
+
+```Python hl_lines="1 7-8"
+{!../../docs_src/response_headers/tutorial002.py!}
+```
+
+그 후, 일반적으로 사용하듯이 필요한 객체(`dict`, 데이터베이스 모델 등)를 반환할 수 있습니다.
+
+`response_model`을 선언한 경우, 반환한 객체를 필터링하고 변환하는 데 여전히 사용됩니다.
+
+**FastAPI**는 해당 *임시* 응답에서 헤더(쿠키와 상태 코드도 포함)를 추출하여, 여러분이 반환한 값을 포함하는 최종 응답에 `response_model`로 필터링된 값을 넣습니다.
+
+또한, 종속성에서 `Response` 매개변수를 선언하고 그 안에서 헤더(및 쿠키)를 설정할 수 있습니다.
+
+## `Response` 직접 반환하기
+
+`Response`를 직접 반환할 때에도 헤더를 추가할 수 있습니다.
+
+[응답을 직접 반환하기](response-directly.md){.internal-link target=_blank}에서 설명한 대로 응답을 생성하고, 헤더를 추가 매개변수로 전달하세요.
+
+```Python hl_lines="10-12"
+{!../../docs_src/response_headers/tutorial001.py!}
+```
+
+/// note | "기술적 세부사항"
+
+`from starlette.responses import Response`나 `from starlette.responses import JSONResponse`를 사용할 수도 있습니다.
+
+**FastAPI**는 `starlette.responses`를 `fastapi.responses`로 개발자의 편의를 위해 직접 제공하지만, 대부분의 응답은 Starlette에서 직접 제공됩니다.
+
+그리고 `Response`는 헤더와 쿠키를 설정하는 데 자주 사용될 수 있으므로, **FastAPI**는 `fastapi.Response`로도 이를 제공합니다.
+
+///
+
+## 커스텀 헤더
+
+<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers" class="external-link" target="_blank">‘X-’ 접두어를 사용하여</a> 커스텀 사설 헤더를 추가할 수 있습니다.
+
+하지만, 여러분이 브라우저에서 클라이언트가 볼 수 있기를 원하는 커스텀 헤더가 있는 경우, CORS 설정에 이를 추가해야 합니다([CORS (Cross-Origin Resource Sharing)](../tutorial/cors.md){.internal-link target=_blank}에서 자세히 알아보세요). `expose_headers` 매개변수를 사용하여 <a href="https://www.starlette.io/middleware/#corsmiddleware" class="external-link" target="_blank">Starlette의 CORS 설명서</a>에 문서화된 대로 설정할 수 있습니다.
From b0fe5ebbf0aa129d9a4bcf60e7f0fc0b2828cf3c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 8 Nov 2024 19:42:52 +0000
Subject: [PATCH 394/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 718d1d57b..972c096e3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -27,6 +27,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `ko/docs/advanced/response-headers.md`. PR [#12740](https://github.com/fastapi/fastapi/pull/12740) by [@kwang1215](https://github.com/kwang1215).
* 🌐 Add Chinese translation for `docs/zh/docs/virtual-environments.md`. PR [#12790](https://github.com/fastapi/fastapi/pull/12790) by [@Vincy1230](https://github.com/Vincy1230).
* 🌐 Add Korean translation for `/docs/ko/docs/environment-variables.md`. PR [#12526](https://github.com/fastapi/fastapi/pull/12526) by [@Tolerblanc](https://github.com/Tolerblanc).
* 🌐 Add Korean translation for `docs/ko/docs/history-design-future.md`. PR [#12646](https://github.com/fastapi/fastapi/pull/12646) by [@saeye](https://github.com/saeye).
From 8cd47a3551a0bafd594b43963eedbedb5b81a370 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 8 Nov 2024 22:05:33 +0000
Subject: [PATCH 395/504] =?UTF-8?q?=E2=AC=86=20Bump=20tiangolo/latest-chan?=
=?UTF-8?q?ges=20from=200.3.1=20to=200.3.2=20(#12794)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Bumps [tiangolo/latest-changes](https://github.com/tiangolo/latest-changes) from 0.3.1 to 0.3.2.
- [Release notes](https://github.com/tiangolo/latest-changes/releases)
- [Commits](https://github.com/tiangolo/latest-changes/compare/0.3.1...0.3.2)
---
updated-dependencies:
- dependency-name: tiangolo/latest-changes
dependency-type: direct:production
update-type: version-update:semver-patch
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
.github/workflows/latest-changes.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.github/workflows/latest-changes.yml b/.github/workflows/latest-changes.yml
index 16da3bc63..b8b5c42ee 100644
--- a/.github/workflows/latest-changes.yml
+++ b/.github/workflows/latest-changes.yml
@@ -34,7 +34,7 @@ jobs:
if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled == 'true' }}
with:
limit-access-to-actor: true
- - uses: tiangolo/latest-changes@0.3.1
+ - uses: tiangolo/latest-changes@0.3.2
with:
token: ${{ secrets.GITHUB_TOKEN }}
latest_changes_file: docs/en/docs/release-notes.md
From 858912e6e46a9a4d312ea2695a7d9afe50773be9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 8 Nov 2024 22:06:00 +0000
Subject: [PATCH 396/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 972c096e3..69f0c9c9e 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -53,6 +53,7 @@ hide:
### Internal
+* ⬆ Bump tiangolo/latest-changes from 0.3.1 to 0.3.2. PR [#12794](https://github.com/fastapi/fastapi/pull/12794) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump pypa/gh-action-pypi-publish from 1.12.0 to 1.12.2. PR [#12788](https://github.com/fastapi/fastapi/pull/12788) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump pypa/gh-action-pypi-publish from 1.11.0 to 1.12.0. PR [#12781](https://github.com/fastapi/fastapi/pull/12781) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump cloudflare/wrangler-action from 3.11 to 3.12. PR [#12777](https://github.com/fastapi/fastapi/pull/12777) by [@dependabot[bot]](https://github.com/apps/dependabot).
From 855b4f66f51071f47581c2bce6643b3132ae60a1 Mon Sep 17 00:00:00 2001
From: Alissa <96190409+alissadb@users.noreply.github.com>
Date: Sat, 9 Nov 2024 11:02:30 +0100
Subject: [PATCH 397/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/de/docs/how-to/configure-swagger-ui.md`=20(#12690)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/de/docs/how-to/configure-swagger-ui.md | 16 ++++------------
1 file changed, 4 insertions(+), 12 deletions(-)
diff --git a/docs/de/docs/how-to/configure-swagger-ui.md b/docs/de/docs/how-to/configure-swagger-ui.md
index 31b9cd290..1ee72d205 100644
--- a/docs/de/docs/how-to/configure-swagger-ui.md
+++ b/docs/de/docs/how-to/configure-swagger-ui.md
@@ -18,9 +18,7 @@ Ohne Änderung der Einstellungen ist die Syntaxhervorhebung standardmäßig akti
Sie können sie jedoch deaktivieren, indem Sie `syntaxHighlight` auf `False` setzen:
-```Python hl_lines="3"
-{!../../docs_src/configure_swagger_ui/tutorial001.py!}
-```
+{* ../../docs_src/configure_swagger_ui/tutorial001.py hl[3] *}
... und dann zeigt die Swagger-Oberfläche die Syntaxhervorhebung nicht mehr an:
@@ -30,9 +28,7 @@ Sie können sie jedoch deaktivieren, indem Sie `syntaxHighlight` auf `False` set
Auf die gleiche Weise könnten Sie das Theme der Syntaxhervorhebung mit dem Schlüssel `syntaxHighlight.theme` festlegen (beachten Sie, dass er einen Punkt in der Mitte hat):
-```Python hl_lines="3"
-{!../../docs_src/configure_swagger_ui/tutorial002.py!}
-```
+{* ../../docs_src/configure_swagger_ui/tutorial002.py hl[3] *}
Obige Konfiguration würde das Theme für die Farbe der Syntaxhervorhebung ändern:
@@ -44,17 +40,13 @@ FastAPI enthält einige Defaultkonfigurationsparameter, die für die meisten Anw
Es umfasst die folgenden Defaultkonfigurationen:
-```Python
-{!../../fastapi/openapi/docs.py[ln:7-23]!}
-```
+{* ../../fastapi/openapi/docs.py ln[7:23] *}
Sie können jede davon überschreiben, indem Sie im Argument `swagger_ui_parameters` einen anderen Wert festlegen.
Um beispielsweise `deepLinking` zu deaktivieren, könnten Sie folgende Einstellungen an `swagger_ui_parameters` übergeben:
-```Python hl_lines="3"
-{!../../docs_src/configure_swagger_ui/tutorial003.py!}
-```
+{* ../../docs_src/configure_swagger_ui/tutorial003.py hl[3] *}
## Andere Parameter der Swagger-Oberfläche
From 561803520305f5faf6bdc23eef311561d6ee3a24 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 10:02:55 +0000
Subject: [PATCH 398/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 69f0c9c9e..ad76badbe 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/de/docs/how-to/configure-swagger-ui.md`. PR [#12690](https://github.com/fastapi/fastapi/pull/12690) by [@alissadb](https://github.com/alissadb).
* 📝 Update includes in `docs/en/docs/advanced/security/oauth2-scopes.md`. PR [#12572](https://github.com/fastapi/fastapi/pull/12572) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes for `docs/en/docs/how-to/conditional-openapi.md`. PR [#12624](https://github.com/fastapi/fastapi/pull/12624) by [@rabinlamadong](https://github.com/rabinlamadong).
* 📝 Update includes in `docs/en/docs/tutorial/dependencies/index.md`. PR [#12615](https://github.com/fastapi/fastapi/pull/12615) by [@bharara](https://github.com/bharara).
From 1e9ea61cbd6c11d673df4317ef9af20759d650ea Mon Sep 17 00:00:00 2001
From: Quentin Takeda <quentin.vadon@gmail.com>
Date: Sat, 9 Nov 2024 11:08:25 +0100
Subject: [PATCH 399/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/fr/docs/tutorial/path-params.md`=20(#12592)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/fr/docs/tutorial/path-params.md | 36 +++++++---------------------
1 file changed, 9 insertions(+), 27 deletions(-)
diff --git a/docs/fr/docs/tutorial/path-params.md b/docs/fr/docs/tutorial/path-params.md
index 34012c278..508529fae 100644
--- a/docs/fr/docs/tutorial/path-params.md
+++ b/docs/fr/docs/tutorial/path-params.md
@@ -4,9 +4,7 @@ Vous pouvez déclarer des "paramètres" ou "variables" de chemin avec la même s
<a href="https://docs.python.org/fr/3/library/string.html#format-string-syntax" class="external-link" target="_blank">formatage de chaîne Python</a> :
-```Python hl_lines="6-7"
-{!../../docs_src/path_params/tutorial001.py!}
-```
+{* ../../docs_src/path_params/tutorial001.py hl[6:7] *}
La valeur du paramètre `item_id` sera transmise à la fonction dans l'argument `item_id`.
@@ -22,9 +20,7 @@ vous verrez comme réponse :
Vous pouvez déclarer le type d'un paramètre de chemin dans la fonction, en utilisant les annotations de type Python :
-```Python hl_lines="7"
-{!../../docs_src/path_params/tutorial002.py!}
-```
+{* ../../docs_src/path_params/tutorial002.py hl[7] *}
Ici, `item_id` est déclaré comme `int`.
@@ -131,9 +127,7 @@ Et vous avez un second chemin : `/users/{user_id}` pour récupérer de la donné
Les *fonctions de chemin* étant évaluées dans l'ordre, il faut s'assurer que la fonction correspondant à `/users/me` est déclarée avant celle de `/users/{user_id}` :
-```Python hl_lines="6 11"
-{!../../docs_src/path_params/tutorial003.py!}
-```
+{* ../../docs_src/path_params/tutorial003.py hl[6,11] *}
Sinon, le chemin `/users/{user_id}` correspondrait aussi à `/users/me`, la fonction "croyant" qu'elle a reçu un paramètre `user_id` avec pour valeur `"me"`.
@@ -149,9 +143,7 @@ En héritant de `str` la documentation sera capable de savoir que les valeurs do
Créez ensuite des attributs de classe avec des valeurs fixes, qui seront les valeurs autorisées pour cette énumération.
-```Python hl_lines="1 6-9"
-{!../../docs_src/path_params/tutorial005.py!}
-```
+{* ../../docs_src/path_params/tutorial005.py hl[1,6:9] *}
/// info
@@ -169,9 +161,7 @@ Pour ceux qui se demandent, "AlexNet", "ResNet", et "LeNet" sont juste des noms
Créez ensuite un *paramètre de chemin* avec une annotation de type désignant l'énumération créée précédemment (`ModelName`) :
-```Python hl_lines="16"
-{!../../docs_src/path_params/tutorial005.py!}
-```
+{* ../../docs_src/path_params/tutorial005.py hl[16] *}
### Documentation
@@ -187,17 +177,13 @@ La valeur du *paramètre de chemin* sera un des "membres" de l'énumération.
Vous pouvez comparer ce paramètre avec les membres de votre énumération `ModelName` :
-```Python hl_lines="17"
-{!../../docs_src/path_params/tutorial005.py!}
-```
+{* ../../docs_src/path_params/tutorial005.py hl[17] *}
#### Récupérer la *valeur de l'énumération*
Vous pouvez obtenir la valeur réel d'un membre (une chaîne de caractères ici), avec `model_name.value`, ou en général, `votre_membre_d'enum.value` :
-```Python hl_lines="20"
-{!../../docs_src/path_params/tutorial005.py!}
-```
+{* ../../docs_src/path_params/tutorial005.py hl[20] *}
/// tip | "Astuce"
@@ -211,9 +197,7 @@ Vous pouvez retourner des *membres d'énumération* dans vos *fonctions de chemi
Ils seront convertis vers leurs valeurs correspondantes (chaînes de caractères ici) avant d'être transmis au client :
-```Python hl_lines="18 21 23"
-{!../../docs_src/path_params/tutorial005.py!}
-```
+{* ../../docs_src/path_params/tutorial005.py hl[18,21,23] *}
Le client recevra une réponse JSON comme celle-ci :
@@ -252,9 +236,7 @@ Dans ce cas, le nom du paramètre est `file_path`, et la dernière partie, `:pat
Vous pouvez donc l'utilisez comme tel :
-```Python hl_lines="6"
-{!../../docs_src/path_params/tutorial004.py!}
-```
+{* ../../docs_src/path_params/tutorial004.py hl[6] *}
/// tip | "Astuce"
From ee260368d005339de963f9f05697dd2ad03e05b6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 10:08:49 +0000
Subject: [PATCH 400/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ad76badbe..dcf3c66ef 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/fr/docs/tutorial/path-params.md`. PR [#12592](https://github.com/fastapi/fastapi/pull/12592) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes for `docs/de/docs/how-to/configure-swagger-ui.md`. PR [#12690](https://github.com/fastapi/fastapi/pull/12690) by [@alissadb](https://github.com/alissadb).
* 📝 Update includes in `docs/en/docs/advanced/security/oauth2-scopes.md`. PR [#12572](https://github.com/fastapi/fastapi/pull/12572) by [@krishnamadhavan](https://github.com/krishnamadhavan).
* 📝 Update includes for `docs/en/docs/how-to/conditional-openapi.md`. PR [#12624](https://github.com/fastapi/fastapi/pull/12624) by [@rabinlamadong](https://github.com/rabinlamadong).
From af280dbde9d12f0bf212c35e181a6a15531ee25c Mon Sep 17 00:00:00 2001
From: Alissa <96190409+alissadb@users.noreply.github.com>
Date: Sat, 9 Nov 2024 11:12:35 +0100
Subject: [PATCH 401/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/de/docs/advanced/dataclasses.md`=20(#12658)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/de/docs/advanced/dataclasses.md | 12 +++---------
1 file changed, 3 insertions(+), 9 deletions(-)
diff --git a/docs/de/docs/advanced/dataclasses.md b/docs/de/docs/advanced/dataclasses.md
index 573f500e8..8e537c639 100644
--- a/docs/de/docs/advanced/dataclasses.md
+++ b/docs/de/docs/advanced/dataclasses.md
@@ -4,9 +4,7 @@ FastAPI basiert auf **Pydantic** und ich habe Ihnen gezeigt, wie Sie Pydantic-Mo
Aber FastAPI unterstützt auf die gleiche Weise auch die Verwendung von <a href="https://docs.python.org/3/library/dataclasses.html" class="external-link" target="_blank">`dataclasses`</a>:
-```Python hl_lines="1 7-12 19-20"
-{!../../docs_src/dataclasses/tutorial001.py!}
-```
+{* ../../docs_src/dataclasses/tutorial001.py hl[1,7:12,19:20] *}
Das ist dank **Pydantic** ebenfalls möglich, da es <a href="https://pydantic-docs.helpmanual.io/usage/dataclasses/#use-of-stdlib-dataclasses-with-basemodel" class="external-link" target="_blank">`dataclasses` intern unterstützt</a>.
@@ -34,9 +32,7 @@ Wenn Sie jedoch eine Menge Datenklassen herumliegen haben, ist dies ein guter Tr
Sie können `dataclasses` auch im Parameter `response_model` verwenden:
-```Python hl_lines="1 7-13 19"
-{!../../docs_src/dataclasses/tutorial002.py!}
-```
+{* ../../docs_src/dataclasses/tutorial002.py hl[1,7:13,19] *}
Die Datenklasse wird automatisch in eine Pydantic-Datenklasse konvertiert.
@@ -52,9 +48,7 @@ In einigen Fällen müssen Sie möglicherweise immer noch Pydantics Version von
In diesem Fall können Sie einfach die Standard-`dataclasses` durch `pydantic.dataclasses` ersetzen, was einen direkten Ersatz darstellt:
-```{ .python .annotate hl_lines="1 5 8-11 14-17 23-25 28" }
-{!../../docs_src/dataclasses/tutorial003.py!}
-```
+{* ../../docs_src/dataclasses/tutorial003.py hl[1,5,8:11,14:17,23:25,28] *}
1. Wir importieren `field` weiterhin von Standard-`dataclasses`.
From 546bb50e091e603d5eea33870ed65982e56c230f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 10:12:55 +0000
Subject: [PATCH 402/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index dcf3c66ef..04b06a359 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/de/docs/advanced/dataclasses.md`. PR [#12658](https://github.com/fastapi/fastapi/pull/12658) by [@alissadb](https://github.com/alissadb).
* 📝 Update includes in `docs/fr/docs/tutorial/path-params.md`. PR [#12592](https://github.com/fastapi/fastapi/pull/12592) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes for `docs/de/docs/how-to/configure-swagger-ui.md`. PR [#12690](https://github.com/fastapi/fastapi/pull/12690) by [@alissadb](https://github.com/alissadb).
* 📝 Update includes in `docs/en/docs/advanced/security/oauth2-scopes.md`. PR [#12572](https://github.com/fastapi/fastapi/pull/12572) by [@krishnamadhavan](https://github.com/krishnamadhavan).
From 890a61fb67e24b7262a4dfee106d9bdb715a9ab1 Mon Sep 17 00:00:00 2001
From: Alissa <96190409+alissadb@users.noreply.github.com>
Date: Sat, 9 Nov 2024 11:15:47 +0100
Subject: [PATCH 403/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/de/docs/python-types.md`=20(#12660)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/de/docs/python-types.md | 44 +++++++++---------------------------
1 file changed, 11 insertions(+), 33 deletions(-)
diff --git a/docs/de/docs/python-types.md b/docs/de/docs/python-types.md
index a43bf5ffe..a9ab4beab 100644
--- a/docs/de/docs/python-types.md
+++ b/docs/de/docs/python-types.md
@@ -22,9 +22,7 @@ Wenn Sie ein Python-Experte sind und bereits alles über Typhinweise wissen, üb
Fangen wir mit einem einfachen Beispiel an:
-```Python
-{!../../docs_src/python_types/tutorial001.py!}
-```
+{* ../../docs_src/python_types/tutorial001.py *}
Dieses Programm gibt aus:
@@ -38,9 +36,7 @@ Die Funktion macht Folgendes:
* Schreibt den ersten Buchstaben eines jeden Wortes groß, mithilfe von `title()`.
* <abbr title="Füge zu einer Einheit zusammen, eins nach dem anderen.">Verkettet</abbr> sie mit einem Leerzeichen in der Mitte.
-```Python hl_lines="2"
-{!../../docs_src/python_types/tutorial001.py!}
-```
+{* ../../docs_src/python_types/tutorial001.py hl[2] *}
### Bearbeiten Sie es
@@ -82,9 +78,7 @@ Das war's.
Das sind die „Typhinweise“:
-```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial002.py!}
-```
+{* ../../docs_src/python_types/tutorial002.py hl[1] *}
Das ist nicht das gleiche wie das Deklarieren von Defaultwerten, wie es hier der Fall ist:
@@ -112,9 +106,7 @@ Hier können Sie durch die Optionen blättern, bis Sie diejenige finden, bei der
Sehen Sie sich diese Funktion an, sie hat bereits Typhinweise:
-```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial003.py!}
-```
+{* ../../docs_src/python_types/tutorial003.py hl[1] *}
Da der Editor die Typen der Variablen kennt, erhalten Sie nicht nur Code-Vervollständigung, sondern auch eine Fehlerprüfung:
@@ -122,9 +114,7 @@ Da der Editor die Typen der Variablen kennt, erhalten Sie nicht nur Code-Vervoll
Jetzt, da Sie wissen, dass Sie das reparieren müssen, konvertieren Sie `age` mittels `str(age)` in einen String:
-```Python hl_lines="2"
-{!../../docs_src/python_types/tutorial004.py!}
-```
+{* ../../docs_src/python_types/tutorial004.py hl[2] *}
## Deklarieren von Typen
@@ -143,9 +133,7 @@ Zum Beispiel diese:
* `bool`
* `bytes`
-```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial005.py!}
-```
+{* ../../docs_src/python_types/tutorial005.py hl[1] *}
### Generische Typen mit Typ-Parametern
@@ -320,9 +308,7 @@ Sie können deklarieren, dass ein Wert ein `str`, aber vielleicht auch `None` se
In Python 3.6 und darüber (inklusive Python 3.10) können Sie das deklarieren, indem Sie `Optional` vom `typing` Modul importieren und verwenden.
-```Python hl_lines="1 4"
-{!../../docs_src/python_types/tutorial009.py!}
-```
+{* ../../docs_src/python_types/tutorial009.py hl[1,4] *}
Wenn Sie `Optional[str]` anstelle von nur `str` verwenden, wird Ihr Editor Ihnen dabei helfen, Fehler zu erkennen, bei denen Sie annehmen könnten, dass ein Wert immer eine String (`str`) ist, obwohl er auch `None` sein könnte.
@@ -369,9 +355,7 @@ Es geht nur um Wörter und Namen. Aber diese Worte können beeinflussen, wie Sie
Nehmen wir zum Beispiel diese Funktion:
-```Python hl_lines="1 4"
-{!../../docs_src/python_types/tutorial009c.py!}
-```
+{* ../../docs_src/python_types/tutorial009c.py hl[1,4] *}
Der Parameter `name` ist definiert als `Optional[str]`, aber er ist **nicht optional**, Sie können die Funktion nicht ohne diesen Parameter aufrufen:
@@ -387,9 +371,7 @@ say_hi(name=None) # Das funktioniert, None is gültig 🎉
Die gute Nachricht ist, dass Sie sich darüber keine Sorgen mehr machen müssen, wenn Sie Python 3.10 verwenden, da Sie einfach `|` verwenden können, um Vereinigungen von Typen zu definieren:
-```Python hl_lines="1 4"
-{!../../docs_src/python_types/tutorial009c_py310.py!}
-```
+{* ../../docs_src/python_types/tutorial009c_py310.py hl[1,4] *}
Und dann müssen Sie sich nicht mehr um Namen wie `Optional` und `Union` kümmern. 😎
@@ -451,15 +433,11 @@ Sie können auch eine Klasse als Typ einer Variablen deklarieren.
Nehmen wir an, Sie haben eine Klasse `Person`, mit einem Namen:
-```Python hl_lines="1-3"
-{!../../docs_src/python_types/tutorial010.py!}
-```
+{* ../../docs_src/python_types/tutorial010.py hl[1:3] *}
Dann können Sie eine Variable vom Typ `Person` deklarieren:
-```Python hl_lines="6"
-{!../../docs_src/python_types/tutorial010.py!}
-```
+{* ../../docs_src/python_types/tutorial010.py hl[6] *}
Und wiederum bekommen Sie die volle Editor-Unterstützung:
From ce97de97d9d77d2f6671f8b7527e3db2163e3448 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 10:16:07 +0000
Subject: [PATCH 404/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 04b06a359..58c21a482 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/de/docs/python-types.md`. PR [#12660](https://github.com/fastapi/fastapi/pull/12660) by [@alissadb](https://github.com/alissadb).
* 📝 Update includes for `docs/de/docs/advanced/dataclasses.md`. PR [#12658](https://github.com/fastapi/fastapi/pull/12658) by [@alissadb](https://github.com/alissadb).
* 📝 Update includes in `docs/fr/docs/tutorial/path-params.md`. PR [#12592](https://github.com/fastapi/fastapi/pull/12592) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes for `docs/de/docs/how-to/configure-swagger-ui.md`. PR [#12690](https://github.com/fastapi/fastapi/pull/12690) by [@alissadb](https://github.com/alissadb).
From 51fe0e437b05185bb677583d023f17533d9509e7 Mon Sep 17 00:00:00 2001
From: Rafael de Oliveira Marques <rafaelomarques@gmail.com>
Date: Sat, 9 Nov 2024 07:32:53 -0300
Subject: [PATCH 405/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/pt/docs/python-types.md`=20(#12671)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/python-types.md | 42 ++++++++++--------------------------
1 file changed, 11 insertions(+), 31 deletions(-)
diff --git a/docs/pt/docs/python-types.md b/docs/pt/docs/python-types.md
index a0938259f..90a361f40 100644
--- a/docs/pt/docs/python-types.md
+++ b/docs/pt/docs/python-types.md
@@ -22,9 +22,7 @@ Se você é um especialista em Python e já sabe tudo sobre type hints, pule par
Vamos começar com um exemplo simples:
-```Python
-{!../../docs_src/python_types/tutorial001.py!}
-```
+{* ../../docs_src/python_types/tutorial001.py *}
A chamada deste programa gera:
@@ -38,9 +36,7 @@ A função faz o seguinte:
* Converte a primeira letra de cada uma em maiúsculas com `title()`.
* <abbr title = "Agrupa-os, como um. Com o conteúdo de um após o outro.">Concatena</abbr> com um espaço no meio.
-```Python hl_lines="2"
-{!../../docs_src/python_types/tutorial001.py!}
-```
+{* ../../docs_src/python_types/tutorial001.py hl[2] *}
### Edite-o
@@ -82,9 +78,7 @@ para:
Esses são os "type hints":
-```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial002.py!}
-```
+{* ../../docs_src/python_types/tutorial002.py hl[1] *}
Isso não é o mesmo que declarar valores padrão como seria com:
@@ -112,9 +106,7 @@ Com isso, você pode rolar, vendo as opções, até encontrar o que "soa familia
Verifique esta função, ela já possui type hints:
-```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial003.py!}
-```
+{* ../../docs_src/python_types/tutorial003.py hl[1] *}
Como o editor conhece os tipos de variáveis, você não obtém apenas o preenchimento automático, mas também as verificações de erro:
@@ -122,9 +114,7 @@ Como o editor conhece os tipos de variáveis, você não obtém apenas o preench
Agora você sabe que precisa corrigí-lo, converta `age` em uma string com `str(age)`:
-```Python hl_lines="2"
-{!../../docs_src/python_types/tutorial004.py!}
-```
+{* ../../docs_src/python_types/tutorial004.py hl[2] *}
## Declarando Tipos
@@ -143,9 +133,7 @@ Você pode usar, por exemplo:
* `bool`
* `bytes`
-```Python hl_lines="1"
-{!../../docs_src/python_types/tutorial005.py!}
-```
+{* ../../docs_src/python_types/tutorial005.py hl[1] *}
### Tipos genéricos com parâmetros de tipo
@@ -321,7 +309,7 @@ Você pode declarar que um valor pode ter um tipo, como `str`, mas que ele tamb
No Python 3.6 e superior (incluindo o Python 3.10) você pode declará-lo importando e utilizando `Optional` do módulo `typing`.
-```Python hl_lines="1 4"
+```Python hl_lines="1 4"
{!../../docs_src/python_types/tutorial009.py!}
```
@@ -370,9 +358,7 @@ Isso é apenas sobre palavras e nomes. Mas estas palavras podem afetar como os s
Por exemplo, vamos pegar esta função:
-```Python hl_lines="1 4"
-{!../../docs_src/python_types/tutorial009c.py!}
-```
+{* ../../docs_src/python_types/tutorial009c.py hl[1,4] *}
O paâmetro `name` é definido como `Optional[str]`, mas ele **não é opcional**, você não pode chamar a função sem o parâmetro:
@@ -388,9 +374,7 @@ say_hi(name=None) # This works, None is valid 🎉
A boa notícia é, quando você estiver no Python 3.10 você não precisará se preocupar mais com isso, pois você poderá simplesmente utilizar o `|` para definir uniões de tipos:
-```Python hl_lines="1 4"
-{!../../docs_src/python_types/tutorial009c_py310.py!}
-```
+{* ../../docs_src/python_types/tutorial009c_py310.py hl[1,4] *}
E então você não precisará mais se preocupar com nomes como `Optional` e `Union`. 😎
@@ -452,15 +436,11 @@ Você também pode declarar uma classe como o tipo de uma variável.
Digamos que você tenha uma classe `Person`, com um nome:
-```Python hl_lines="1-3"
-{!../../docs_src/python_types/tutorial010.py!}
-```
+{* ../../docs_src/python_types/tutorial010.py hl[1:3] *}
Então você pode declarar que uma variável é do tipo `Person`:
-```Python hl_lines="6"
-{!../../docs_src/python_types/tutorial010.py!}
-```
+{* ../../docs_src/python_types/tutorial010.py hl[6] *}
E então, novamente, você recebe todo o suporte do editor:
From 92a5f68e4db675e552aa127bbb43eeb958023e17 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 10:33:21 +0000
Subject: [PATCH 406/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 58c21a482..29c33a362 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/pt/docs/python-types.md`. PR [#12671](https://github.com/fastapi/fastapi/pull/12671) by [@ceb10n](https://github.com/ceb10n).
* 📝 Update includes for `docs/de/docs/python-types.md`. PR [#12660](https://github.com/fastapi/fastapi/pull/12660) by [@alissadb](https://github.com/alissadb).
* 📝 Update includes for `docs/de/docs/advanced/dataclasses.md`. PR [#12658](https://github.com/fastapi/fastapi/pull/12658) by [@alissadb](https://github.com/alissadb).
* 📝 Update includes in `docs/fr/docs/tutorial/path-params.md`. PR [#12592](https://github.com/fastapi/fastapi/pull/12592) by [@kantandane](https://github.com/kantandane).
From 1cfd9a70ac0b63b42e0d6acec31e41422ca7b7f6 Mon Sep 17 00:00:00 2001
From: Baldeep Singh Handa <handabaldeep@gmail.com>
Date: Sat, 9 Nov 2024 10:44:28 +0000
Subject: [PATCH 407/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/advanced/custom-response.md`=20(#12797)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/custom-response.md | 64 ++++++------------------
1 file changed, 16 insertions(+), 48 deletions(-)
diff --git a/docs/en/docs/advanced/custom-response.md b/docs/en/docs/advanced/custom-response.md
index 1d6dc3f6d..95152b9fe 100644
--- a/docs/en/docs/advanced/custom-response.md
+++ b/docs/en/docs/advanced/custom-response.md
@@ -30,9 +30,7 @@ This is because by default, FastAPI will inspect every item inside and make sure
But if you are certain that the content that you are returning is **serializable with JSON**, you can pass it directly to the response class and avoid the extra overhead that FastAPI would have by passing your return content through the `jsonable_encoder` before passing it to the response class.
-```Python hl_lines="2 7"
-{!../../docs_src/custom_response/tutorial001b.py!}
-```
+{* ../../docs_src/custom_response/tutorial001b.py hl[2,7] *}
/// info
@@ -57,9 +55,7 @@ To return a response with HTML directly from **FastAPI**, use `HTMLResponse`.
* Import `HTMLResponse`.
* Pass `HTMLResponse` as the parameter `response_class` of your *path operation decorator*.
-```Python hl_lines="2 7"
-{!../../docs_src/custom_response/tutorial002.py!}
-```
+{* ../../docs_src/custom_response/tutorial002.py hl[2,7] *}
/// info
@@ -77,9 +73,7 @@ As seen in [Return a Response directly](response-directly.md){.internal-link tar
The same example from above, returning an `HTMLResponse`, could look like:
-```Python hl_lines="2 7 19"
-{!../../docs_src/custom_response/tutorial003.py!}
-```
+{* ../../docs_src/custom_response/tutorial003.py hl[2,7,19] *}
/// warning
@@ -103,9 +97,7 @@ The `response_class` will then be used only to document the OpenAPI *path operat
For example, it could be something like:
-```Python hl_lines="7 21 23"
-{!../../docs_src/custom_response/tutorial004.py!}
-```
+{* ../../docs_src/custom_response/tutorial004.py hl[7,21,23] *}
In this example, the function `generate_html_response()` already generates and returns a `Response` instead of returning the HTML in a `str`.
@@ -144,9 +136,7 @@ It accepts the following parameters:
FastAPI (actually Starlette) will automatically include a Content-Length header. It will also include a Content-Type header, based on the `media_type` and appending a charset for text types.
-```Python hl_lines="1 18"
-{!../../docs_src/response_directly/tutorial002.py!}
-```
+{* ../../docs_src/response_directly/tutorial002.py hl[1,18] *}
### `HTMLResponse`
@@ -156,9 +146,7 @@ Takes some text or bytes and returns an HTML response, as you read above.
Takes some text or bytes and returns a plain text response.
-```Python hl_lines="2 7 9"
-{!../../docs_src/custom_response/tutorial005.py!}
-```
+{* ../../docs_src/custom_response/tutorial005.py hl[2,7,9] *}
### `JSONResponse`
@@ -192,9 +180,7 @@ This requires installing `ujson` for example with `pip install ujson`.
///
-```Python hl_lines="2 7"
-{!../../docs_src/custom_response/tutorial001.py!}
-```
+{* ../../docs_src/custom_response/tutorial001.py hl[2,7] *}
/// tip
@@ -208,18 +194,14 @@ Returns an HTTP redirect. Uses a 307 status code (Temporary Redirect) by default
You can return a `RedirectResponse` directly:
-```Python hl_lines="2 9"
-{!../../docs_src/custom_response/tutorial006.py!}
-```
+{* ../../docs_src/custom_response/tutorial006.py hl[2,9] *}
---
Or you can use it in the `response_class` parameter:
-```Python hl_lines="2 7 9"
-{!../../docs_src/custom_response/tutorial006b.py!}
-```
+{* ../../docs_src/custom_response/tutorial006b.py hl[2,7,9] *}
If you do that, then you can return the URL directly from your *path operation* function.
@@ -229,17 +211,13 @@ In this case, the `status_code` used will be the default one for the `RedirectRe
You can also use the `status_code` parameter combined with the `response_class` parameter:
-```Python hl_lines="2 7 9"
-{!../../docs_src/custom_response/tutorial006c.py!}
-```
+{* ../../docs_src/custom_response/tutorial006c.py hl[2,7,9] *}
### `StreamingResponse`
Takes an async generator or a normal generator/iterator and streams the response body.
-```Python hl_lines="2 14"
-{!../../docs_src/custom_response/tutorial007.py!}
-```
+{* ../../docs_src/custom_response/tutorial007.py hl[2,14] *}
#### Using `StreamingResponse` with file-like objects
@@ -249,9 +227,7 @@ That way, you don't have to read it all first in memory, and you can pass that g
This includes many libraries to interact with cloud storage, video processing, and others.
-```{ .python .annotate hl_lines="2 10-12 14" }
-{!../../docs_src/custom_response/tutorial008.py!}
-```
+{* ../../docs_src/custom_response/tutorial008.py hl[2,10:12,14] *}
1. This is the generator function. It's a "generator function" because it contains `yield` statements inside.
2. By using a `with` block, we make sure that the file-like object is closed after the generator function is done. So, after it finishes sending the response.
@@ -280,15 +256,11 @@ Takes a different set of arguments to instantiate than the other response types:
File responses will include appropriate `Content-Length`, `Last-Modified` and `ETag` headers.
-```Python hl_lines="2 10"
-{!../../docs_src/custom_response/tutorial009.py!}
-```
+{* ../../docs_src/custom_response/tutorial009.py hl[2,10] *}
You can also use the `response_class` parameter:
-```Python hl_lines="2 8 10"
-{!../../docs_src/custom_response/tutorial009b.py!}
-```
+{* ../../docs_src/custom_response/tutorial009b.py hl[2,8,10] *}
In this case, you can return the file path directly from your *path operation* function.
@@ -302,9 +274,7 @@ Let's say you want it to return indented and formatted JSON, so you want to use
You could create a `CustomORJSONResponse`. The main thing you have to do is create a `Response.render(content)` method that returns the content as `bytes`:
-```Python hl_lines="9-14 17"
-{!../../docs_src/custom_response/tutorial009c.py!}
-```
+{* ../../docs_src/custom_response/tutorial009c.py hl[9:14,17] *}
Now instead of returning:
@@ -330,9 +300,7 @@ The parameter that defines this is `default_response_class`.
In the example below, **FastAPI** will use `ORJSONResponse` by default, in all *path operations*, instead of `JSONResponse`.
-```Python hl_lines="2 4"
-{!../../docs_src/custom_response/tutorial010.py!}
-```
+{* ../../docs_src/custom_response/tutorial010.py hl[2,4] *}
/// tip
From 4733cc74864003cd79c883f81ff5717bb6c68fc7 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 10:44:54 +0000
Subject: [PATCH 408/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 29c33a362..17a287571 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/advanced/custom-response.md`. PR [#12797](https://github.com/fastapi/fastapi/pull/12797) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes for `docs/pt/docs/python-types.md`. PR [#12671](https://github.com/fastapi/fastapi/pull/12671) by [@ceb10n](https://github.com/ceb10n).
* 📝 Update includes for `docs/de/docs/python-types.md`. PR [#12660](https://github.com/fastapi/fastapi/pull/12660) by [@alissadb](https://github.com/alissadb).
* 📝 Update includes for `docs/de/docs/advanced/dataclasses.md`. PR [#12658](https://github.com/fastapi/fastapi/pull/12658) by [@alissadb](https://github.com/alissadb).
From 5b2bd906d7af3c5ba1c04c20741352b0cbcf7a72 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix?= <49922137+bhunao@users.noreply.github.com>
Date: Sat, 9 Nov 2024 07:55:35 -0300
Subject: [PATCH 409/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/pt/docs/tutorial/background-tasks.md`=20(#12736)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/pt/docs/tutorial/background-tasks.md | 16 ++++------------
1 file changed, 4 insertions(+), 12 deletions(-)
diff --git a/docs/pt/docs/tutorial/background-tasks.md b/docs/pt/docs/tutorial/background-tasks.md
index 2b5f82464..6a69ae2af 100644
--- a/docs/pt/docs/tutorial/background-tasks.md
+++ b/docs/pt/docs/tutorial/background-tasks.md
@@ -15,9 +15,7 @@ Isso inclui, por exemplo:
Primeiro, importe `BackgroundTasks` e defina um parâmetro em sua _função de operação de caminho_ com uma declaração de tipo de `BackgroundTasks`:
-```Python hl_lines="1 13"
-{!../../docs_src/background_tasks/tutorial001.py!}
-```
+{* ../../docs_src/background_tasks/tutorial001.py hl[1,13] *}
O **FastAPI** criará o objeto do tipo `BackgroundTasks` para você e o passará como esse parâmetro.
@@ -33,17 +31,13 @@ Nesse caso, a função de tarefa gravará em um arquivo (simulando o envio de um
E como a operação de gravação não usa `async` e `await`, definimos a função com `def` normal:
-```Python hl_lines="6-9"
-{!../../docs_src/background_tasks/tutorial001.py!}
-```
+{* ../../docs_src/background_tasks/tutorial001.py hl[6:9] *}
## Adicionar a tarefa em segundo plano
Dentro de sua _função de operação de caminho_, passe sua função de tarefa para o objeto _tarefas em segundo plano_ com o método `.add_task()`:
-```Python hl_lines="14"
-{!../../docs_src/background_tasks/tutorial001.py!}
-```
+{* ../../docs_src/background_tasks/tutorial001.py hl[14] *}
`.add_task()` recebe como argumentos:
@@ -57,9 +51,7 @@ Usar `BackgroundTasks` também funciona com o sistema de injeção de dependênc
O **FastAPI** sabe o que fazer em cada caso e como reutilizar o mesmo objeto, de forma que todas as tarefas em segundo plano sejam mescladas e executadas em segundo plano posteriormente:
-```Python hl_lines="13 15 22 25"
-{!../../docs_src/background_tasks/tutorial002.py!}
-```
+{* ../../docs_src/background_tasks/tutorial002.py hl[13,15,22,25] *}
Neste exemplo, as mensagens serão gravadas no arquivo `log.txt` _após_ o envio da resposta.
From 6d066c0d62d8ac8c0953658f4086571e03a464ff Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 10:56:01 +0000
Subject: [PATCH 410/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 17a287571..a55e8cecd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/pt/docs/tutorial/background-tasks.md`. PR [#12736](https://github.com/fastapi/fastapi/pull/12736) by [@bhunao](https://github.com/bhunao).
* 📝 Update includes for `docs/en/docs/advanced/custom-response.md`. PR [#12797](https://github.com/fastapi/fastapi/pull/12797) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes for `docs/pt/docs/python-types.md`. PR [#12671](https://github.com/fastapi/fastapi/pull/12671) by [@ceb10n](https://github.com/ceb10n).
* 📝 Update includes for `docs/de/docs/python-types.md`. PR [#12660](https://github.com/fastapi/fastapi/pull/12660) by [@alissadb](https://github.com/alissadb).
From 83d7f114051385edf95a9f343b5e1eab34cb663d Mon Sep 17 00:00:00 2001
From: Tashanam Shahbaz <64039299+Tashanam-Shahbaz@users.noreply.github.com>
Date: Sat, 9 Nov 2024 16:08:12 +0500
Subject: [PATCH 411/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/body-multiple-params.md`=20(#12593)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/body-multiple-params.md | 220 +-----------------
1 file changed, 6 insertions(+), 214 deletions(-)
diff --git a/docs/en/docs/tutorial/body-multiple-params.md b/docs/en/docs/tutorial/body-multiple-params.md
index eebbb3fe4..9fced9652 100644
--- a/docs/en/docs/tutorial/body-multiple-params.md
+++ b/docs/en/docs/tutorial/body-multiple-params.md
@@ -8,57 +8,9 @@ First, of course, you can mix `Path`, `Query` and request body parameter declara
And you can also declare body parameters as optional, by setting the default to `None`:
-//// tab | Python 3.10+
+{* ../../docs_src/body_multiple_params/tutorial001_an_py310.py hl[18:20] *}
-```Python hl_lines="18-20"
-{!> ../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="18-20"
-{!> ../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="19-21"
-{!> ../../docs_src/body_multiple_params/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="17-19"
-{!> ../../docs_src/body_multiple_params/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="19-21"
-{!> ../../docs_src/body_multiple_params/tutorial001.py!}
-```
-
-////
+## Multiple body parameters
/// note
@@ -81,21 +33,8 @@ In the previous example, the *path operations* would expect a JSON body with the
But you can also declare multiple body parameters, e.g. `item` and `user`:
-//// tab | Python 3.10+
-
-```Python hl_lines="20"
-{!> ../../docs_src/body_multiple_params/tutorial002_py310.py!}
-```
-
-////
+{* ../../docs_src/body_multiple_params/tutorial002_py310.py hl[20] *}
-//// tab | Python 3.8+
-
-```Python hl_lines="22"
-{!> ../../docs_src/body_multiple_params/tutorial002.py!}
-```
-
-////
In this case, **FastAPI** will notice that there is more than one body parameter in the function (there are two parameters that are Pydantic models).
@@ -136,57 +75,8 @@ If you declare it as is, because it is a singular value, **FastAPI** will assume
But you can instruct **FastAPI** to treat it as another body key using `Body`:
-//// tab | Python 3.10+
-
-```Python hl_lines="23"
-{!> ../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="23"
-{!> ../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="24"
-{!> ../../docs_src/body_multiple_params/tutorial003_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
+{* ../../docs_src/body_multiple_params/tutorial003_an_py310.py hl[23] *}
-```Python hl_lines="20"
-{!> ../../docs_src/body_multiple_params/tutorial003_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="22"
-{!> ../../docs_src/body_multiple_params/tutorial003.py!}
-```
-
-////
In this case, **FastAPI** will expect a body like:
@@ -226,57 +116,8 @@ q: str | None = None
For example:
-//// tab | Python 3.10+
-
-```Python hl_lines="28"
-{!> ../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="28"
-{!> ../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="29"
-{!> ../../docs_src/body_multiple_params/tutorial004_an.py!}
-```
-
-////
+{* ../../docs_src/body_multiple_params/tutorial004_an_py310.py hl[28] *}
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="26"
-{!> ../../docs_src/body_multiple_params/tutorial004_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="28"
-{!> ../../docs_src/body_multiple_params/tutorial004.py!}
-```
-
-////
/// info
@@ -298,57 +139,8 @@ item: Item = Body(embed=True)
as in:
-//// tab | Python 3.10+
-
-```Python hl_lines="17"
-{!> ../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="17"
-{!> ../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="18"
-{!> ../../docs_src/body_multiple_params/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="15"
-{!> ../../docs_src/body_multiple_params/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="17"
-{!> ../../docs_src/body_multiple_params/tutorial005.py!}
-```
+{* ../../docs_src/body_multiple_params/tutorial005_an_py310.py hl[17] *}
-////
In this case **FastAPI** will expect a body like:
From c1110d529e54aae58a38192c70757f003f31e4ba Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 11:08:32 +0000
Subject: [PATCH 412/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a55e8cecd..04d596fb5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/body-multiple-params.md`. PR [#12593](https://github.com/fastapi/fastapi/pull/12593) by [@Tashanam-Shahbaz](https://github.com/Tashanam-Shahbaz).
* 📝 Update includes in `docs/pt/docs/tutorial/background-tasks.md`. PR [#12736](https://github.com/fastapi/fastapi/pull/12736) by [@bhunao](https://github.com/bhunao).
* 📝 Update includes for `docs/en/docs/advanced/custom-response.md`. PR [#12797](https://github.com/fastapi/fastapi/pull/12797) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes for `docs/pt/docs/python-types.md`. PR [#12671](https://github.com/fastapi/fastapi/pull/12671) by [@ceb10n](https://github.com/ceb10n).
From 150f8225b2eb03ed68846e3618b3af4a7a7d64d6 Mon Sep 17 00:00:00 2001
From: Quentin Takeda <quentin.vadon@gmail.com>
Date: Sat, 9 Nov 2024 12:10:17 +0100
Subject: [PATCH 413/504] =?UTF-8?q?=F0=9F=93=9D=20=20Update=20includes=20i?=
=?UTF-8?q?n=20`docs/fr/docs/tutorial/body-multiple-params.md`=20(#12598)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/fr/docs/tutorial/body-multiple-params.md | 223 +-----------------
1 file changed, 5 insertions(+), 218 deletions(-)
diff --git a/docs/fr/docs/tutorial/body-multiple-params.md b/docs/fr/docs/tutorial/body-multiple-params.md
index dafd869e3..0541acc74 100644
--- a/docs/fr/docs/tutorial/body-multiple-params.md
+++ b/docs/fr/docs/tutorial/body-multiple-params.md
@@ -8,57 +8,7 @@ Tout d'abord, sachez que vous pouvez mélanger les déclarations des paramètres
Vous pouvez également déclarer des paramètres body comme étant optionnels, en leur assignant une valeur par défaut à `None` :
-//// tab | Python 3.10+
-
-```Python hl_lines="18-20"
-{!> ../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="18-20"
-{!> ../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="19-21"
-{!> ../../docs_src/body_multiple_params/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="17-19"
-{!> ../../docs_src/body_multiple_params/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="19-21"
-{!> ../../docs_src/body_multiple_params/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/body_multiple_params/tutorial001_an_py310.py hl[18:20] *}
/// note
@@ -81,21 +31,7 @@ Dans l'exemple précédent, les opérations de routage attendaient un body JSON
Mais vous pouvez également déclarer plusieurs paramètres provenant de body, par exemple `item` et `user` simultanément :
-//// tab | Python 3.10+
-
-```Python hl_lines="20"
-{!> ../../docs_src/body_multiple_params/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="22"
-{!> ../../docs_src/body_multiple_params/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/body_multiple_params/tutorial002_py310.py hl[20] *}
Dans ce cas, **FastAPI** détectera qu'il y a plus d'un paramètre dans le body (chacun correspondant à un modèle Pydantic).
@@ -135,57 +71,8 @@ Par exemple, en étendant le modèle précédent, vous pouvez vouloir ajouter un
Si vous le déclarez tel quel, comme c'est une valeur [scalaire](https://docs.github.com/fr/graphql/reference/scalars), **FastAPI** supposera qu'il s'agit d'un paramètre de requête (`Query`).
Mais vous pouvez indiquer à **FastAPI** de la traiter comme une variable de body en utilisant `Body` :
-//// tab | Python 3.10+
-
-```Python hl_lines="23"
-{!> ../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="23"
-{!> ../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="24"
-{!> ../../docs_src/body_multiple_params/tutorial003_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="20"
-{!> ../../docs_src/body_multiple_params/tutorial003_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="22"
-{!> ../../docs_src/body_multiple_params/tutorial003.py!}
-```
-////
+{* ../../docs_src/body_multiple_params/tutorial003_an_py310.py hl[23] *}
Dans ce cas, **FastAPI** s'attendra à un body semblable à :
@@ -225,57 +112,7 @@ q: str | None = None
Par exemple :
-//// tab | Python 3.10+
-
-```Python hl_lines="27"
-{!> ../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="27"
-{!> ../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="28"
-{!> ../../docs_src/body_multiple_params/tutorial004_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="25"
-{!> ../../docs_src/body_multiple_params/tutorial004_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="27"
-{!> ../../docs_src/body_multiple_params/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/body_multiple_params/tutorial004_an_py310.py hl[27] *}
/// info
@@ -297,57 +134,7 @@ item: Item = Body(embed=True)
Voici un exemple complet :
-//// tab | Python 3.10+
-
-```Python hl_lines="17"
-{!> ../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="17"
-{!> ../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="18"
-{!> ../../docs_src/body_multiple_params/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="15"
-{!> ../../docs_src/body_multiple_params/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Préférez utiliser la version `Annotated` si possible.
-
-///
-
-```Python hl_lines="17"
-{!> ../../docs_src/body_multiple_params/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/body_multiple_params/tutorial005_an_py310.py hl[17] *}
Dans ce cas **FastAPI** attendra un body semblable à :
From 38141dbc9f3bf5613471b61525a6fe7c201a4e71 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 11:12:50 +0000
Subject: [PATCH 414/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 04d596fb5..d4f8a9a2c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/fr/docs/tutorial/body-multiple-params.md`. PR [#12598](https://github.com/fastapi/fastapi/pull/12598) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/tutorial/body-multiple-params.md`. PR [#12593](https://github.com/fastapi/fastapi/pull/12593) by [@Tashanam-Shahbaz](https://github.com/Tashanam-Shahbaz).
* 📝 Update includes in `docs/pt/docs/tutorial/background-tasks.md`. PR [#12736](https://github.com/fastapi/fastapi/pull/12736) by [@bhunao](https://github.com/bhunao).
* 📝 Update includes for `docs/en/docs/advanced/custom-response.md`. PR [#12797](https://github.com/fastapi/fastapi/pull/12797) by [@handabaldeep](https://github.com/handabaldeep).
From 2d4e9d46c036040e8ff37c10a777155c3c429e2b Mon Sep 17 00:00:00 2001
From: Baldeep Singh Handa <handabaldeep@gmail.com>
Date: Sat, 9 Nov 2024 11:23:09 +0000
Subject: [PATCH 415/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20`doc?=
=?UTF-8?q?s/en/docs/advanced/openapi-callbacks.md`=20(#12800)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/openapi-callbacks.md | 16 ++++------------
1 file changed, 4 insertions(+), 12 deletions(-)
diff --git a/docs/en/docs/advanced/openapi-callbacks.md b/docs/en/docs/advanced/openapi-callbacks.md
index 82069a950..ca9065a89 100644
--- a/docs/en/docs/advanced/openapi-callbacks.md
+++ b/docs/en/docs/advanced/openapi-callbacks.md
@@ -31,9 +31,7 @@ It will have a *path operation* that will receive an `Invoice` body, and a query
This part is pretty normal, most of the code is probably already familiar to you:
-```Python hl_lines="9-13 36-53"
-{!../../docs_src/openapi_callbacks/tutorial001.py!}
-```
+{* ../../docs_src/openapi_callbacks/tutorial001.py hl[9:13,36:53] *}
/// tip
@@ -92,9 +90,7 @@ Temporarily adopting this point of view (of the *external developer*) can help y
First create a new `APIRouter` that will contain one or more callbacks.
-```Python hl_lines="3 25"
-{!../../docs_src/openapi_callbacks/tutorial001.py!}
-```
+{* ../../docs_src/openapi_callbacks/tutorial001.py hl[3,25] *}
### Create the callback *path operation*
@@ -105,9 +101,7 @@ It should look just like a normal FastAPI *path operation*:
* It should probably have a declaration of the body it should receive, e.g. `body: InvoiceEvent`.
* And it could also have a declaration of the response it should return, e.g. `response_model=InvoiceEventReceived`.
-```Python hl_lines="16-18 21-22 28-32"
-{!../../docs_src/openapi_callbacks/tutorial001.py!}
-```
+{* ../../docs_src/openapi_callbacks/tutorial001.py hl[16:18,21:22,28:32] *}
There are 2 main differences from a normal *path operation*:
@@ -175,9 +169,7 @@ At this point you have the *callback path operation(s)* needed (the one(s) that
Now use the parameter `callbacks` in *your API's path operation decorator* to pass the attribute `.routes` (that's actually just a `list` of routes/*path operations*) from that callback router:
-```Python hl_lines="35"
-{!../../docs_src/openapi_callbacks/tutorial001.py!}
-```
+{* ../../docs_src/openapi_callbacks/tutorial001.py hl[35] *}
/// tip
From c0f56ce0b285c391116f5fcabf21e116110fef21 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 11:23:32 +0000
Subject: [PATCH 416/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d4f8a9a2c..2633c1965 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes `docs/en/docs/advanced/openapi-callbacks.md`. PR [#12800](https://github.com/fastapi/fastapi/pull/12800) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/fr/docs/tutorial/body-multiple-params.md`. PR [#12598](https://github.com/fastapi/fastapi/pull/12598) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/tutorial/body-multiple-params.md`. PR [#12593](https://github.com/fastapi/fastapi/pull/12593) by [@Tashanam-Shahbaz](https://github.com/Tashanam-Shahbaz).
* 📝 Update includes in `docs/pt/docs/tutorial/background-tasks.md`. PR [#12736](https://github.com/fastapi/fastapi/pull/12736) by [@bhunao](https://github.com/bhunao).
From 7517aa9f8f5fd2b7068c844e83b059bb8783e3b5 Mon Sep 17 00:00:00 2001
From: Baldeep Singh Handa <handabaldeep@gmail.com>
Date: Sat, 9 Nov 2024 11:23:58 +0000
Subject: [PATCH 417/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20`doc?=
=?UTF-8?q?s/en/docs/advanced/response-change-status-code.md`=20(#12801)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/response-change-status-code.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
diff --git a/docs/en/docs/advanced/response-change-status-code.md b/docs/en/docs/advanced/response-change-status-code.md
index fc041f7de..6d3f9f3e8 100644
--- a/docs/en/docs/advanced/response-change-status-code.md
+++ b/docs/en/docs/advanced/response-change-status-code.md
@@ -20,9 +20,7 @@ You can declare a parameter of type `Response` in your *path operation function*
And then you can set the `status_code` in that *temporal* response object.
-```Python hl_lines="1 9 12"
-{!../../docs_src/response_change_status_code/tutorial001.py!}
-```
+{* ../../docs_src/response_change_status_code/tutorial001.py hl[1,9,12] *}
And then you can return any object you need, as you normally would (a `dict`, a database model, etc).
From b2ec345e67d691f4c40d484750645d765226dd15 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 11:25:26 +0000
Subject: [PATCH 418/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2633c1965..bfe34cea5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes `docs/en/docs/advanced/response-change-status-code.md`. PR [#12801](https://github.com/fastapi/fastapi/pull/12801) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes `docs/en/docs/advanced/openapi-callbacks.md`. PR [#12800](https://github.com/fastapi/fastapi/pull/12800) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/fr/docs/tutorial/body-multiple-params.md`. PR [#12598](https://github.com/fastapi/fastapi/pull/12598) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/tutorial/body-multiple-params.md`. PR [#12593](https://github.com/fastapi/fastapi/pull/12593) by [@Tashanam-Shahbaz](https://github.com/Tashanam-Shahbaz).
From 34ed88394c27fb448bfccc0fc165317139478dbf Mon Sep 17 00:00:00 2001
From: Alex Wendland <a.p.wendland@gmail.com>
Date: Sat, 9 Nov 2024 11:27:35 +0000
Subject: [PATCH 419/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/em/docs/tutorial/body-updates.md`=20(#12799)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/em/docs/tutorial/body-updates.md | 96 ++-------------------------
1 file changed, 4 insertions(+), 92 deletions(-)
diff --git a/docs/em/docs/tutorial/body-updates.md b/docs/em/docs/tutorial/body-updates.md
index 4a4b3b6b8..7e2fbfaf7 100644
--- a/docs/em/docs/tutorial/body-updates.md
+++ b/docs/em/docs/tutorial/body-updates.md
@@ -6,29 +6,7 @@
👆 💪 ⚙️ `jsonable_encoder` 🗜 🔢 💽 📊 👈 💪 🏪 🎻 (✅ ⏮️ ☁ 💽). 🖼, 🏭 `datetime` `str`.
-//// tab | 🐍 3️⃣.6️⃣ & 🔛
-
-```Python hl_lines="30-35"
-{!> ../../docs_src/body_updates/tutorial001.py!}
-```
-
-////
-
-//// tab | 🐍 3️⃣.9️⃣ & 🔛
-
-```Python hl_lines="30-35"
-{!> ../../docs_src/body_updates/tutorial001_py39.py!}
-```
-
-////
-
-//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
-
-```Python hl_lines="28-33"
-{!> ../../docs_src/body_updates/tutorial001_py310.py!}
-```
-
-////
+{* ../../docs_src/body_updates/tutorial001.py hl[30:35] *}
`PUT` ⚙️ 📨 💽 👈 🔜 ❎ ♻ 💽.
@@ -76,29 +54,7 @@
⤴️ 👆 💪 ⚙️ 👉 🏗 `dict` ⏮️ 🕴 💽 👈 ⚒ (📨 📨), 🚫 🔢 💲:
-//// tab | 🐍 3️⃣.6️⃣ & 🔛
-
-```Python hl_lines="34"
-{!> ../../docs_src/body_updates/tutorial002.py!}
-```
-
-////
-
-//// tab | 🐍 3️⃣.9️⃣ & 🔛
-
-```Python hl_lines="34"
-{!> ../../docs_src/body_updates/tutorial002_py39.py!}
-```
-
-////
-
-//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
-
-```Python hl_lines="32"
-{!> ../../docs_src/body_updates/tutorial002_py310.py!}
-```
-
-////
+{* ../../docs_src/body_updates/tutorial002.py hl[34] *}
### ⚙️ Pydantic `update` 🔢
@@ -106,29 +62,7 @@
💖 `stored_item_model.copy(update=update_data)`:
-//// tab | 🐍 3️⃣.6️⃣ & 🔛
-
-```Python hl_lines="35"
-{!> ../../docs_src/body_updates/tutorial002.py!}
-```
-
-////
-
-//// tab | 🐍 3️⃣.9️⃣ & 🔛
-
-```Python hl_lines="35"
-{!> ../../docs_src/body_updates/tutorial002_py39.py!}
-```
-
-////
-
-//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
-
-```Python hl_lines="33"
-{!> ../../docs_src/body_updates/tutorial002_py310.py!}
-```
-
-////
+{* ../../docs_src/body_updates/tutorial002.py hl[35] *}
### 🍕 ℹ 🌃
@@ -145,29 +79,7 @@
* 🖊 💽 👆 💽.
* 📨 ℹ 🏷.
-//// tab | 🐍 3️⃣.6️⃣ & 🔛
-
-```Python hl_lines="30-37"
-{!> ../../docs_src/body_updates/tutorial002.py!}
-```
-
-////
-
-//// tab | 🐍 3️⃣.9️⃣ & 🔛
-
-```Python hl_lines="30-37"
-{!> ../../docs_src/body_updates/tutorial002_py39.py!}
-```
-
-////
-
-//// tab | 🐍 3️⃣.1️⃣0️⃣ & 🔛
-
-```Python hl_lines="28-35"
-{!> ../../docs_src/body_updates/tutorial002_py310.py!}
-```
-
-////
+{* ../../docs_src/body_updates/tutorial002.py hl[30:37] *}
/// tip
From 6b965b576edc8a968f5e11934364e894319b0ff8 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 11:31:19 +0000
Subject: [PATCH 420/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index bfe34cea5..72ebd4684 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/em/docs/tutorial/body-updates.md`. PR [#12799](https://github.com/fastapi/fastapi/pull/12799) by [@AlexWendland](https://github.com/AlexWendland).
* 📝 Update includes `docs/en/docs/advanced/response-change-status-code.md`. PR [#12801](https://github.com/fastapi/fastapi/pull/12801) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes `docs/en/docs/advanced/openapi-callbacks.md`. PR [#12800](https://github.com/fastapi/fastapi/pull/12800) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/fr/docs/tutorial/body-multiple-params.md`. PR [#12598](https://github.com/fastapi/fastapi/pull/12598) by [@kantandane](https://github.com/kantandane).
From c88e82d6ec2227bc934a62cfcd85267b4bd1937e Mon Sep 17 00:00:00 2001
From: Alissa <96190409+alissadb@users.noreply.github.com>
Date: Sat, 9 Nov 2024 12:32:51 +0100
Subject: [PATCH 421/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/de/docs/tutorial/body-multiple-params.md`=20(#12699)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/de/docs/tutorial/body-multiple-params.md | 224 +-----------------
1 file changed, 5 insertions(+), 219 deletions(-)
diff --git a/docs/de/docs/tutorial/body-multiple-params.md b/docs/de/docs/tutorial/body-multiple-params.md
index 26ae73ebc..891c98cb2 100644
--- a/docs/de/docs/tutorial/body-multiple-params.md
+++ b/docs/de/docs/tutorial/body-multiple-params.md
@@ -8,57 +8,7 @@ Zuerst einmal, Sie können `Path`-, `Query`- und Requestbody-Parameter-Deklarati
Und Sie können auch Body-Parameter als optional kennzeichnen, indem Sie den Defaultwert auf `None` setzen:
-//// tab | Python 3.10+
-
-```Python hl_lines="18-20"
-{!> ../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="18-20"
-{!> ../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="19-21"
-{!> ../../docs_src/body_multiple_params/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="17-19"
-{!> ../../docs_src/body_multiple_params/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="19-21"
-{!> ../../docs_src/body_multiple_params/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/body_multiple_params/tutorial001_an_py310.py hl[18:20] *}
/// note | "Hinweis"
@@ -81,21 +31,7 @@ Im vorherigen Beispiel erwartete die *Pfadoperation* einen JSON-Body mit den Att
Aber Sie können auch mehrere Body-Parameter deklarieren, z. B. `item` und `user`:
-//// tab | Python 3.10+
-
-```Python hl_lines="20"
-{!> ../../docs_src/body_multiple_params/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="22"
-{!> ../../docs_src/body_multiple_params/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/body_multiple_params/tutorial002_py310.py hl[20] *}
In diesem Fall wird **FastAPI** bemerken, dass es mehr als einen Body-Parameter in der Funktion gibt (zwei Parameter, die Pydantic-Modelle sind).
@@ -136,57 +72,7 @@ Wenn Sie diesen Parameter einfach so hinzufügen, wird **FastAPI** annehmen, das
Aber Sie können **FastAPI** instruieren, ihn als weiteren Body-Schlüssel zu erkennen, indem Sie `Body` verwenden:
-//// tab | Python 3.10+
-
-```Python hl_lines="23"
-{!> ../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="23"
-{!> ../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="24"
-{!> ../../docs_src/body_multiple_params/tutorial003_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="20"
-{!> ../../docs_src/body_multiple_params/tutorial003_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="22"
-{!> ../../docs_src/body_multiple_params/tutorial003.py!}
-```
-
-////
+{* ../../docs_src/body_multiple_params/tutorial003_an_py310.py hl[23] *}
In diesem Fall erwartet **FastAPI** einen Body wie:
@@ -226,57 +112,7 @@ q: str | None = None
Zum Beispiel:
-//// tab | Python 3.10+
-
-```Python hl_lines="27"
-{!> ../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="27"
-{!> ../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="28"
-{!> ../../docs_src/body_multiple_params/tutorial004_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="25"
-{!> ../../docs_src/body_multiple_params/tutorial004_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="27"
-{!> ../../docs_src/body_multiple_params/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/body_multiple_params/tutorial004_an_py310.py hl[27] *}
/// info
@@ -298,57 +134,7 @@ item: Item = Body(embed=True)
so wie in:
-//// tab | Python 3.10+
-
-```Python hl_lines="17"
-{!> ../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="17"
-{!> ../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="18"
-{!> ../../docs_src/body_multiple_params/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="15"
-{!> ../../docs_src/body_multiple_params/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="17"
-{!> ../../docs_src/body_multiple_params/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/body_multiple_params/tutorial005_an_py310.py hl[17] *}
In diesem Fall erwartet **FastAPI** einen Body wie:
From a36454a7e6eacda8460f84fe504144751d9cd569 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 11:34:42 +0000
Subject: [PATCH 422/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 72ebd4684..c0c19da9e 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/de/docs/tutorial/body-multiple-params.md`. PR [#12699](https://github.com/fastapi/fastapi/pull/12699) by [@alissadb](https://github.com/alissadb).
* 📝 Update includes in `docs/em/docs/tutorial/body-updates.md`. PR [#12799](https://github.com/fastapi/fastapi/pull/12799) by [@AlexWendland](https://github.com/AlexWendland).
* 📝 Update includes `docs/en/docs/advanced/response-change-status-code.md`. PR [#12801](https://github.com/fastapi/fastapi/pull/12801) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes `docs/en/docs/advanced/openapi-callbacks.md`. PR [#12800](https://github.com/fastapi/fastapi/pull/12800) by [@handabaldeep](https://github.com/handabaldeep).
From 5e0722276a43596ca072e591096ca64b9cae8551 Mon Sep 17 00:00:00 2001
From: Zhaohan Dong <65422392+zhaohan-dong@users.noreply.github.com>
Date: Sat, 9 Nov 2024 11:49:55 +0000
Subject: [PATCH 423/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/zh/docs/tutorial/background-tasks.md`=20(#12798)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh/docs/tutorial/background-tasks.md | 32 ++++++-----------------
1 file changed, 8 insertions(+), 24 deletions(-)
diff --git a/docs/zh/docs/tutorial/background-tasks.md b/docs/zh/docs/tutorial/background-tasks.md
index fc9312bc5..80622e129 100644
--- a/docs/zh/docs/tutorial/background-tasks.md
+++ b/docs/zh/docs/tutorial/background-tasks.md
@@ -15,9 +15,7 @@
首先导入 `BackgroundTasks` 并在 *路径操作函数* 中使用类型声明 `BackgroundTasks` 定义一个参数：
-```Python hl_lines="1 13"
-{!../../docs_src/background_tasks/tutorial001.py!}
-```
+{* ../../docs_src/background_tasks/tutorial001.py hl[1, 13] *}
**FastAPI** 会创建一个 `BackgroundTasks` 类型的对象并作为该参数传入。
@@ -33,17 +31,13 @@
由于写操作不使用 `async` 和 `await`，我们用普通的 `def` 定义函数：
-```Python hl_lines="6-9"
-{!../../docs_src/background_tasks/tutorial001.py!}
-```
+{* ../../docs_src/background_tasks/tutorial001.py hl[6:9] *}
## 添加后台任务
在你的 *路径操作函数* 里，用 `.add_task()` 方法将任务函数传到 *后台任务* 对象中：
-```Python hl_lines="14"
-{!../../docs_src/background_tasks/tutorial001.py!}
-```
+{* ../../docs_src/background_tasks/tutorial001.py hl[14] *}
`.add_task()` 接收以下参数：
@@ -59,25 +53,19 @@
//// tab | Python 3.10+
-```Python hl_lines="13 15 22 25"
-{!> ../../docs_src/background_tasks/tutorial002_an_py310.py!}
-```
+{* ../../docs_src/background_tasks/tutorial002_an_py310.py hl[13, 15, 22, 25] *}
////
//// tab | Python 3.9+
-```Python hl_lines="13 15 22 25"
-{!> ../../docs_src/background_tasks/tutorial002_an_py39.py!}
-```
+{* ../../docs_src/background_tasks/tutorial002_an_py39.py hl[13, 15, 22, 25] *}
////
//// tab | Python 3.8+
-```Python hl_lines="14 16 23 26"
-{!> ../../docs_src/background_tasks/tutorial002_an.py!}
-```
+{* ../../docs_src/background_tasks/tutorial002_an.py hl[14, 16, 23, 26] *}
////
@@ -89,9 +77,7 @@
///
-```Python hl_lines="11 13 20 23"
-{!> ../../docs_src/background_tasks/tutorial002_py310.py!}
-```
+{* ../../docs_src/background_tasks/tutorial002_py310.py hl[11, 13, 20, 23] *}
////
@@ -103,9 +89,7 @@
///
-```Python hl_lines="13 15 22 25"
-{!> ../../docs_src/background_tasks/tutorial002.py!}
-```
+{* ../../docs_src/background_tasks/tutorial002.py hl[13, 15, 22, 25] *}
////
From 835123ee28bba1a6b3bfffc97e47e87f62d376d7 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 11:50:20 +0000
Subject: [PATCH 424/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c0c19da9e..d2fd65995 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/zh/docs/tutorial/background-tasks.md`. PR [#12798](https://github.com/fastapi/fastapi/pull/12798) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes for `docs/de/docs/tutorial/body-multiple-params.md`. PR [#12699](https://github.com/fastapi/fastapi/pull/12699) by [@alissadb](https://github.com/alissadb).
* 📝 Update includes in `docs/em/docs/tutorial/body-updates.md`. PR [#12799](https://github.com/fastapi/fastapi/pull/12799) by [@AlexWendland](https://github.com/AlexWendland).
* 📝 Update includes `docs/en/docs/advanced/response-change-status-code.md`. PR [#12801](https://github.com/fastapi/fastapi/pull/12801) by [@handabaldeep](https://github.com/handabaldeep).
From 22eafff2d87c66a0f6e78dcbf68fdcbddfc56e58 Mon Sep 17 00:00:00 2001
From: Baldeep Singh Handa <handabaldeep@gmail.com>
Date: Sat, 9 Nov 2024 11:54:19 +0000
Subject: [PATCH 425/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/advanced/response-directly.md`=20(#12803)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/response-directly.md | 8 ++------
1 file changed, 2 insertions(+), 6 deletions(-)
diff --git a/docs/en/docs/advanced/response-directly.md b/docs/en/docs/advanced/response-directly.md
index 8246b9674..09947a2ee 100644
--- a/docs/en/docs/advanced/response-directly.md
+++ b/docs/en/docs/advanced/response-directly.md
@@ -34,9 +34,7 @@ For example, you cannot put a Pydantic model in a `JSONResponse` without first c
For those cases, you can use the `jsonable_encoder` to convert your data before passing it to a response:
-```Python hl_lines="6-7 21-22"
-{!../../docs_src/response_directly/tutorial001.py!}
-```
+{* ../../docs_src/response_directly/tutorial001.py hl[6:7,21:22] *}
/// note | "Technical Details"
@@ -56,9 +54,7 @@ Let's say that you want to return an <a href="https://en.wikipedia.org/wiki/XML"
You could put your XML content in a string, put that in a `Response`, and return it:
-```Python hl_lines="1 18"
-{!../../docs_src/response_directly/tutorial002.py!}
-```
+{* ../../docs_src/response_directly/tutorial002.py hl[1,18] *}
## Notes
From 8fb33488896443298684c8685e098ccb56d64eea Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 11:54:43 +0000
Subject: [PATCH 426/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d2fd65995..1c43ac02a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/advanced/response-directly.md`. PR [#12803](https://github.com/fastapi/fastapi/pull/12803) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/zh/docs/tutorial/background-tasks.md`. PR [#12798](https://github.com/fastapi/fastapi/pull/12798) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes for `docs/de/docs/tutorial/body-multiple-params.md`. PR [#12699](https://github.com/fastapi/fastapi/pull/12699) by [@alissadb](https://github.com/alissadb).
* 📝 Update includes in `docs/em/docs/tutorial/body-updates.md`. PR [#12799](https://github.com/fastapi/fastapi/pull/12799) by [@AlexWendland](https://github.com/AlexWendland).
From b5036db18cb910e533728de695b8704dfa8a1f6e Mon Sep 17 00:00:00 2001
From: Zhaohan Dong <65422392+zhaohan-dong@users.noreply.github.com>
Date: Sat, 9 Nov 2024 11:58:07 +0000
Subject: [PATCH 427/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/path-operation-advanced-configuration?=
=?UTF-8?q?.md`=20(#12802)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../path-operation-advanced-configuration.md | 40 +++++--------------
1 file changed, 10 insertions(+), 30 deletions(-)
diff --git a/docs/en/docs/advanced/path-operation-advanced-configuration.md b/docs/en/docs/advanced/path-operation-advanced-configuration.md
index a61e3f19b..fea1e4db0 100644
--- a/docs/en/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/en/docs/advanced/path-operation-advanced-configuration.md
@@ -12,9 +12,7 @@ You can set the OpenAPI `operationId` to be used in your *path operation* with t
You would have to make sure that it is unique for each operation.
-```Python hl_lines="6"
-{!../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial001.py hl[6] *}
### Using the *path operation function* name as the operationId
@@ -22,9 +20,7 @@ If you want to use your APIs' function names as `operationId`s, you can iterate
You should do it after adding all your *path operations*.
-```Python hl_lines="2 12-21 24"
-{!../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial002.py hl[2, 12:21, 24] *}
/// tip
@@ -44,9 +40,7 @@ Even if they are in different modules (Python files).
To exclude a *path operation* from the generated OpenAPI schema (and thus, from the automatic documentation systems), use the parameter `include_in_schema` and set it to `False`:
-```Python hl_lines="6"
-{!../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial003.py hl[6] *}
## Advanced description from docstring
@@ -56,9 +50,7 @@ Adding an `\f` (an escaped "form feed" character) causes **FastAPI** to truncate
It won't show up in the documentation, but other tools (such as Sphinx) will be able to use the rest.
-```Python hl_lines="19-29"
-{!../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial004.py hl[19:29] *}
## Additional Responses
@@ -100,9 +92,7 @@ You can extend the OpenAPI schema for a *path operation* using the parameter `op
This `openapi_extra` can be helpful, for example, to declare [OpenAPI Extensions](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#specificationExtensions):
-```Python hl_lines="6"
-{!../../docs_src/path_operation_advanced_configuration/tutorial005.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial005.py hl[6] *}
If you open the automatic API docs, your extension will show up at the bottom of the specific *path operation*.
@@ -149,9 +139,7 @@ For example, you could decide to read and validate the request with your own cod
You could do that with `openapi_extra`:
-```Python hl_lines="19-36 39-40"
-{!../../docs_src/path_operation_advanced_configuration/tutorial006.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial006.py hl[19:36, 39:40] *}
In this example, we didn't declare any Pydantic model. In fact, the request body is not even <abbr title="converted from some plain format, like bytes, into Python objects">parsed</abbr> as JSON, it is read directly as `bytes`, and the function `magic_data_reader()` would be in charge of parsing it in some way.
@@ -167,17 +155,13 @@ For example, in this application we don't use FastAPI's integrated functionality
//// tab | Pydantic v2
-```Python hl_lines="17-22 24"
-{!> ../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial007.py hl[17:22, 24] *}
////
//// tab | Pydantic v1
-```Python hl_lines="17-22 24"
-{!> ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py hl[17:22, 24] *}
////
@@ -195,17 +179,13 @@ And then in our code, we parse that YAML content directly, and then we are again
//// tab | Pydantic v2
-```Python hl_lines="26-33"
-{!> ../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial007.py hl[26:33] *}
////
//// tab | Pydantic v1
-```Python hl_lines="26-33"
-{!> ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial007_pv1.py hl[26:33] *}
////
From f91d193d6304ac6598cf76850a6be87a382ed63b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 11:58:33 +0000
Subject: [PATCH 428/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 1c43ac02a..ebcc8ffc6 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/path-operation-advanced-configuration.md`. PR [#12802](https://github.com/fastapi/fastapi/pull/12802) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes for `docs/en/docs/advanced/response-directly.md`. PR [#12803](https://github.com/fastapi/fastapi/pull/12803) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/zh/docs/tutorial/background-tasks.md`. PR [#12798](https://github.com/fastapi/fastapi/pull/12798) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes for `docs/de/docs/tutorial/body-multiple-params.md`. PR [#12699](https://github.com/fastapi/fastapi/pull/12699) by [@alissadb](https://github.com/alissadb).
From 854cddf1a8e3ab5e3da70f74286c5485ccff5fb1 Mon Sep 17 00:00:00 2001
From: Zhaohan Dong <65422392+zhaohan-dong@users.noreply.github.com>
Date: Sat, 9 Nov 2024 12:06:35 +0000
Subject: [PATCH 429/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/response-cookies.md`=20(#12804)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/response-cookies.md | 8 ++------
1 file changed, 2 insertions(+), 6 deletions(-)
diff --git a/docs/en/docs/advanced/response-cookies.md b/docs/en/docs/advanced/response-cookies.md
index 4467779ba..988394d06 100644
--- a/docs/en/docs/advanced/response-cookies.md
+++ b/docs/en/docs/advanced/response-cookies.md
@@ -6,9 +6,7 @@ You can declare a parameter of type `Response` in your *path operation function*
And then you can set cookies in that *temporal* response object.
-```Python hl_lines="1 8-9"
-{!../../docs_src/response_cookies/tutorial002.py!}
-```
+{* ../../docs_src/response_cookies/tutorial002.py hl[1, 8:9] *}
And then you can return any object you need, as you normally would (a `dict`, a database model, etc).
@@ -26,9 +24,7 @@ To do that, you can create a response as described in [Return a Response Directl
Then set Cookies in it, and then return it:
-```Python hl_lines="10-12"
-{!../../docs_src/response_cookies/tutorial001.py!}
-```
+{* ../../docs_src/response_cookies/tutorial001.py hl[10:12] *}
/// tip
From 75cde1fb5cab577249f92c70c7da8b6ee808845b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 12:06:57 +0000
Subject: [PATCH 430/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ebcc8ffc6..4d512f712 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/response-cookies.md`. PR [#12804](https://github.com/fastapi/fastapi/pull/12804) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/advanced/path-operation-advanced-configuration.md`. PR [#12802](https://github.com/fastapi/fastapi/pull/12802) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes for `docs/en/docs/advanced/response-directly.md`. PR [#12803](https://github.com/fastapi/fastapi/pull/12803) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/zh/docs/tutorial/background-tasks.md`. PR [#12798](https://github.com/fastapi/fastapi/pull/12798) by [@zhaohan-dong](https://github.com/zhaohan-dong).
From f55f93c181491d0d7dff60b556b6d2792a9da611 Mon Sep 17 00:00:00 2001
From: Quentin Takeda <quentin.vadon@gmail.com>
Date: Sat, 9 Nov 2024 13:10:11 +0100
Subject: [PATCH 431/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/fr/docs/tutorial/first-steps.md`=20(#12594)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
docs/fr/docs/tutorial/first-steps.md | 32 +++++++---------------------
1 file changed, 8 insertions(+), 24 deletions(-)
diff --git a/docs/fr/docs/tutorial/first-steps.md b/docs/fr/docs/tutorial/first-steps.md
index e9511b029..b2fb5181c 100644
--- a/docs/fr/docs/tutorial/first-steps.md
+++ b/docs/fr/docs/tutorial/first-steps.md
@@ -2,9 +2,7 @@
Le fichier **FastAPI** le plus simple possible pourrait ressembler à cela :
-```Python
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py *}
Copiez ce code dans un fichier nommé `main.py`.
@@ -134,9 +132,7 @@ Vous pourriez aussi l'utiliser pour générer du code automatiquement, pour les
### Étape 1 : import `FastAPI`
-```Python hl_lines="1"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[1] *}
`FastAPI` est une classe Python qui fournit toutes les fonctionnalités nécessaires au lancement de votre API.
@@ -150,9 +146,7 @@ Vous pouvez donc aussi utiliser toutes les fonctionnalités de <a href="https://
### Étape 2 : créer une "instance" `FastAPI`
-```Python hl_lines="3"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[3] *}
Ici la variable `app` sera une "instance" de la classe `FastAPI`.
@@ -172,9 +166,7 @@ $ uvicorn main:app --reload
Si vous créez votre app avec :
-```Python hl_lines="3"
-{!../../docs_src/first_steps/tutorial002.py!}
-```
+{* ../../docs_src/first_steps/tutorial002.py hl[3] *}
Et la mettez dans un fichier `main.py`, alors vous appelleriez `uvicorn` avec :
@@ -250,9 +242,7 @@ Nous allons donc aussi appeler ces dernières des "**opérations**".
#### Définir un *décorateur d'opération de chemin*
-```Python hl_lines="6"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[6] *}
Le `@app.get("/")` dit à **FastAPI** que la fonction en dessous est chargée de gérer les requêtes qui vont sur :
@@ -306,9 +296,7 @@ Voici notre "**fonction de chemin**" (ou fonction d'opération de chemin) :
* **opération** : `get`.
* **fonction** : la fonction sous le "décorateur" (sous `@app.get("/")`).
-```Python hl_lines="7"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[7] *}
C'est une fonction Python.
@@ -320,9 +308,7 @@ Ici, c'est une fonction asynchrone (définie avec `async def`).
Vous pourriez aussi la définir comme une fonction classique plutôt qu'avec `async def` :
-```Python hl_lines="7"
-{!../../docs_src/first_steps/tutorial003.py!}
-```
+{* ../../docs_src/first_steps/tutorial003.py hl[7] *}
/// note
@@ -332,9 +318,7 @@ Si vous ne connaissez pas la différence, allez voir la section [Concurrence : *
### Étape 5 : retourner le contenu
-```Python hl_lines="8"
-{!../../docs_src/first_steps/tutorial001.py!}
-```
+{* ../../docs_src/first_steps/tutorial001.py hl[8] *}
Vous pouvez retourner un dictionnaire (`dict`), une liste (`list`), des valeurs seules comme des chaines de caractères (`str`) et des entiers (`int`), etc.
From 62b318e585ba2287dfbbabd8ed557413252b0e35 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 12:12:02 +0000
Subject: [PATCH 432/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4d512f712..9ffb524de 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/fr/docs/tutorial/first-steps.md`. PR [#12594](https://github.com/fastapi/fastapi/pull/12594) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/advanced/response-cookies.md`. PR [#12804](https://github.com/fastapi/fastapi/pull/12804) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/advanced/path-operation-advanced-configuration.md`. PR [#12802](https://github.com/fastapi/fastapi/pull/12802) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes for `docs/en/docs/advanced/response-directly.md`. PR [#12803](https://github.com/fastapi/fastapi/pull/12803) by [@handabaldeep](https://github.com/handabaldeep).
From 58975aa3ed1caebf01b309ee62ae9558b30ffa26 Mon Sep 17 00:00:00 2001
From: Zhaohan Dong <65422392+zhaohan-dong@users.noreply.github.com>
Date: Sat, 9 Nov 2024 12:14:09 +0000
Subject: [PATCH 433/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/response-headers.md`=20(#12805)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/response-headers.md | 8 ++------
1 file changed, 2 insertions(+), 6 deletions(-)
diff --git a/docs/en/docs/advanced/response-headers.md b/docs/en/docs/advanced/response-headers.md
index 80c100826..fca641d89 100644
--- a/docs/en/docs/advanced/response-headers.md
+++ b/docs/en/docs/advanced/response-headers.md
@@ -6,9 +6,7 @@ You can declare a parameter of type `Response` in your *path operation function*
And then you can set headers in that *temporal* response object.
-```Python hl_lines="1 7-8"
-{!../../docs_src/response_headers/tutorial002.py!}
-```
+{* ../../docs_src/response_headers/tutorial002.py hl[1, 7:8] *}
And then you can return any object you need, as you normally would (a `dict`, a database model, etc).
@@ -24,9 +22,7 @@ You can also add headers when you return a `Response` directly.
Create a response as described in [Return a Response Directly](response-directly.md){.internal-link target=_blank} and pass the headers as an additional parameter:
-```Python hl_lines="10-12"
-{!../../docs_src/response_headers/tutorial001.py!}
-```
+{* ../../docs_src/response_headers/tutorial001.py hl[10:12] *}
/// note | "Technical Details"
From 35c37be540287f8d4f930f55cce6839773208761 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 12:15:34 +0000
Subject: [PATCH 434/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9ffb524de..c258e2bdc 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/response-headers.md`. PR [#12805](https://github.com/fastapi/fastapi/pull/12805) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/fr/docs/tutorial/first-steps.md`. PR [#12594](https://github.com/fastapi/fastapi/pull/12594) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/advanced/response-cookies.md`. PR [#12804](https://github.com/fastapi/fastapi/pull/12804) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/advanced/path-operation-advanced-configuration.md`. PR [#12802](https://github.com/fastapi/fastapi/pull/12802) by [@zhaohan-dong](https://github.com/zhaohan-dong).
From 58eb4e4fc53509550a44f3a30ba584004a85977d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8F=B2=E4=BA=91=E6=98=94=20=28Vincy=20SHI=29?=
<vincy@vincy1230.net>
Date: Sat, 9 Nov 2024 20:17:15 +0800
Subject: [PATCH 435/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Chinese=20translat?=
=?UTF-8?q?ion=20for=20`docs/zh/docs/environment-variables.md`=20(#12784)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh/docs/environment-variables.md | 298 ++++++++++++++++++++++++++
1 file changed, 298 insertions(+)
create mode 100644 docs/zh/docs/environment-variables.md
diff --git a/docs/zh/docs/environment-variables.md b/docs/zh/docs/environment-variables.md
new file mode 100644
index 000000000..812278051
--- /dev/null
+++ b/docs/zh/docs/environment-variables.md
@@ -0,0 +1,298 @@
+# 环境变量
+
+/// tip
+
+如果你已经知道什么是“环境变量”并且知道如何使用它们，你可以放心跳过这一部分。
+
+///
+
+环境变量（也称为“**env var**”）是一个独立于 Python 代码**之外**的变量，它存在于**操作系统**中，可以被你的 Python 代码（或其他程序）读取。
+
+环境变量对于处理应用程序**设置**、作为 Python **安装**的一部分等方面非常有用。
+
+## 创建和使用环境变量
+
+你在 **shell（终端）**中就可以**创建**和使用环境变量，并不需要用到 Python：
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// 你可以使用以下命令创建一个名为 MY_NAME 的环境变量
+$ export MY_NAME="Wade Wilson"
+
+// 然后，你可以在其他程序中使用它，例如
+$ echo "Hello $MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// 创建一个名为 MY_NAME 的环境变量
+$ $Env:MY_NAME = "Wade Wilson"
+
+// 在其他程序中使用它，例如
+$ echo "Hello $Env:MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+## 在 Python 中读取环境变量
+
+你也可以在 Python **之外**的终端中创建环境变量（或使用任何其他方法），然后在 Python 中**读取**它们。
+
+例如，你可以创建一个名为 `main.py` 的文件，其中包含以下内容：
+
+```Python hl_lines="3"
+import os
+
+name = os.getenv("MY_NAME", "World")
+print(f"Hello {name} from Python")
+```
+
+/// tip
+
+第二个参数是 <a href="https://docs.python.org/zh-cn/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> 的默认返回值。
+
+如果没有提供，默认值为 `None`，这里我们提供 `"World"` 作为默认值。
+
+///
+
+然后你可以调用这个 Python 程序：
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// 这里我们还没有设置环境变量
+$ python main.py
+
+// 因为我们没有设置环境变量，所以我们得到的是默认值
+
+Hello World from Python
+
+// 但是如果我们事先创建过一个环境变量
+$ export MY_NAME="Wade Wilson"
+
+// 然后再次调用程序
+$ python main.py
+
+// 现在就可以读取到环境变量了
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// 这里我们还没有设置环境变量
+$ python main.py
+
+// 因为我们没有设置环境变量，所以我们得到的是默认值
+
+Hello World from Python
+
+// 但是如果我们事先创建过一个环境变量
+$ $Env:MY_NAME = "Wade Wilson"
+
+// 然后再次调用程序
+$ python main.py
+
+// 现在就可以读取到环境变量了
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+由于环境变量可以在代码之外设置、但可以被代码读取，并且不必与其他文件一起存储（提交到 `git`），因此通常用于配置或**设置**。
+
+你还可以为**特定的程序调用**创建特定的环境变量，该环境变量仅对该程序可用，且仅在其运行期间有效。
+
+要实现这一点，只需在同一行内、程序本身之前创建它：
+
+<div class="termy">
+
+```console
+// 在这个程序调用的同一行中创建一个名为 MY_NAME 的环境变量
+$ MY_NAME="Wade Wilson" python main.py
+
+// 现在就可以读取到环境变量了
+
+Hello Wade Wilson from Python
+
+// 在此之后这个环境变量将不会依然存在
+$ python main.py
+
+Hello World from Python
+```
+
+</div>
+
+/// tip
+
+你可以在 <a href="https://12factor.net/zh_cn/config" class="external-link" target="_blank">The Twelve-Factor App: 配置</a>中了解更多信息。
+
+///
+
+## 类型和验证
+
+这些环境变量只能处理**文本字符串**，因为它们是处于 Python 范畴之外的，必须与其他程序和操作系统的其余部分兼容（甚至与不同的操作系统兼容，如 Linux、Windows、macOS）。
+
+这意味着从环境变量中读取的**任何值**在 Python 中都将是一个 `str`，任何类型转换或验证都必须在代码中完成。
+
+你将在[高级用户指南 - 设置和环境变量](./advanced/settings.md)中了解更多关于使用环境变量处理**应用程序设置**的信息。
+
+## `PATH` 环境变量
+
+有一个**特殊的**环境变量称为 **`PATH`**，操作系统（Linux、macOS、Windows）用它来查找要运行的程序。
+
+`PATH` 变量的值是一个长字符串，由 Linux 和 macOS 上的冒号 `:` 分隔的目录组成，而在 Windows 上则是由分号 `;` 分隔的。
+
+例如，`PATH` 环境变量可能如下所示：
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+这意味着系统应该在以下目录中查找程序：
+
+- `/usr/local/bin`
+- `/usr/bin`
+- `/bin`
+- `/usr/sbin`
+- `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32
+```
+
+这意味着系统应该在以下目录中查找程序：
+
+- `C:\Program Files\Python312\Scripts`
+- `C:\Program Files\Python312`
+- `C:\Windows\System32`
+
+////
+
+当你在终端中输入一个**命令**时，操作系统会在 `PATH` 环境变量中列出的**每个目录**中**查找**程序。
+
+例如，当你在终端中输入 `python` 时，操作系统会在该列表中的**第一个目录**中查找名为 `python` 的程序。
+
+如果找到了，那么操作系统将**使用它**；否则，操作系统会继续在**其他目录**中查找。
+
+### 安装 Python 和更新 `PATH`
+
+安装 Python 时，可能会询问你是否要更新 `PATH` 环境变量。
+
+//// tab | Linux, macOS
+
+假设你安装 Python 并最终将其安装在了目录 `/opt/custompython/bin` 中。
+
+如果你同意更新 `PATH` 环境变量，那么安装程序将会将 `/opt/custompython/bin` 添加到 `PATH` 环境变量中。
+
+它看起来大概会像这样：
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin
+```
+
+如此一来，当你在终端中输入 `python` 时，系统会在 `/opt/custompython/bin` 中找到 Python 程序（最后一个目录）并使用它。
+
+////
+
+//// tab | Windows
+
+假设你安装 Python 并最终将其安装在了目录 `C:\opt\custompython\bin` 中。
+
+如果你同意更新 `PATH` 环境变量 (在 Python 安装程序中，这个操作是名为 `Add Python x.xx to PATH` 的复选框 —— 译者注)，那么安装程序将会将 `C:\opt\custompython\bin` 添加到 `PATH` 环境变量中。
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin
+```
+
+如此一来，当你在终端中输入 `python` 时，系统会在 `C:\opt\custompython\bin` 中找到 Python 程序（最后一个目录）并使用它。
+
+////
+
+因此，如果你输入：
+
+<div class="termy">
+
+```console
+$ python
+```
+
+</div>
+
+//// tab | Linux, macOS
+
+系统会在 `/opt/custompython/bin` 中**找到** `python` 程序并运行它。
+
+这和输入以下命令大致等价：
+
+<div class="termy">
+
+```console
+$ /opt/custompython/bin/python
+```
+
+</div>
+
+////
+
+//// tab | Windows
+
+系统会在 `C:\opt\custompython\bin\python` 中**找到** `python` 程序并运行它。
+
+这和输入以下命令大致等价：
+
+<div class="termy">
+
+```console
+$ C:\opt\custompython\bin\python
+```
+
+</div>
+
+////
+
+当学习[虚拟环境](virtual-environments.md)时，这些信息将会很有用。
+
+## 结论
+
+通过这个教程，你应该对**环境变量**是什么以及如何在 Python 中使用它们有了基本的了解。
+
+你也可以在<a href="https://zh.wikipedia.org/wiki/%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F" class="external-link" target="_blank">环境变量 - 维基百科</a> (<a href="https://en.wikipedia.org/wiki/Environment_variable" class="external-link" target="_blank">Wikipedia for Environment Variable</a>) 中了解更多关于它们的信息。
+
+在许多情况下，环境变量的用途和适用性并不是很明显。但是在开发过程中，它们会在许多不同的场景中出现，因此了解它们是很有必要的。
+
+例如，你将在下一节关于[虚拟环境](virtual-environments.md)中需要这些信息。
From b458d0acb5602f8e096a7f7d7fc152d931087a4a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 12:17:39 +0000
Subject: [PATCH 436/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c258e2bdc..1de48f196 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -46,6 +46,7 @@ hide:
### Translations
+* 🌐 Add Chinese translation for `docs/zh/docs/environment-variables.md`. PR [#12784](https://github.com/fastapi/fastapi/pull/12784) by [@Vincy1230](https://github.com/Vincy1230).
* 🌐 Add Korean translation for `ko/docs/advanced/response-headers.md`. PR [#12740](https://github.com/fastapi/fastapi/pull/12740) by [@kwang1215](https://github.com/kwang1215).
* 🌐 Add Chinese translation for `docs/zh/docs/virtual-environments.md`. PR [#12790](https://github.com/fastapi/fastapi/pull/12790) by [@Vincy1230](https://github.com/Vincy1230).
* 🌐 Add Korean translation for `/docs/ko/docs/environment-variables.md`. PR [#12526](https://github.com/fastapi/fastapi/pull/12526) by [@Tolerblanc](https://github.com/Tolerblanc).
From 8b183f18f744855cc477550b74ca89dca1bcece8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8F=B2=E4=BA=91=E6=98=94=20=28Vincy=20SHI=29?=
<vincy@vincy1230.net>
Date: Sat, 9 Nov 2024 20:17:55 +0800
Subject: [PATCH 437/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Traditional=20Chin?=
=?UTF-8?q?ese=20translation=20for=20`docs/zh-hant/docs/environment-variab?=
=?UTF-8?q?les.md`=20(#12785)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh-hant/docs/environment-variables.md | 298 +++++++++++++++++++++
1 file changed, 298 insertions(+)
create mode 100644 docs/zh-hant/docs/environment-variables.md
diff --git a/docs/zh-hant/docs/environment-variables.md b/docs/zh-hant/docs/environment-variables.md
new file mode 100644
index 000000000..a1598fc01
--- /dev/null
+++ b/docs/zh-hant/docs/environment-variables.md
@@ -0,0 +1,298 @@
+# 環境變數
+
+/// tip
+
+如果你已經知道什麼是「環境變數」並且知道如何使用它們，你可以放心跳過這一部分。
+
+///
+
+環境變數（也稱為「**env var**」）是一個獨立於 Python 程式碼**之外**的變數，它存在於**作業系統**中，可以被你的 Python 程式碼（或其他程式）讀取。
+
+環境變數對於處理應用程式**設定**（作為 Python **安裝**的一部分等方面）非常有用。
+
+## 建立和使用環境變數
+
+你在 **shell（終端機）**中就可以**建立**和使用環境變數，並不需要用到 Python：
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// 你可以使用以下指令建立一個名為 MY_NAME 的環境變數
+$ export MY_NAME="Wade Wilson"
+
+// 然後，你可以在其他程式中使用它，例如
+$ echo "Hello $MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// 建立一個名為 MY_NAME 的環境變數
+$ $Env:MY_NAME = "Wade Wilson"
+
+// 在其他程式中使用它，例如
+$ echo "Hello $Env:MY_NAME"
+
+Hello Wade Wilson
+```
+
+</div>
+
+////
+
+## 在 Python 中讀取環境變數
+
+你也可以在 Python **之外**的終端機中建立環境變數（或使用其他方法），然後在 Python 中**讀取**它們。
+
+例如，你可以建立一個名為 `main.py` 的檔案，其中包含以下內容：
+
+```Python hl_lines="3"
+import os
+
+name = os.getenv("MY_NAME", "World")
+print(f"Hello {name} from Python")
+```
+
+/// tip
+
+第二個參數是 <a href="https://docs.python.org/zh-tw/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> 的預設回傳值。
+
+如果沒有提供，預設值為 `None`，這裡我們提供 `"World"` 作為預設值。
+
+///
+
+然後你可以呼叫這個 Python 程式：
+
+//// tab | Linux, macOS, Windows Bash
+
+<div class="termy">
+
+```console
+// 這裡我們還沒有設定環境變數
+$ python main.py
+
+// 因為我們沒有設定環境變數，所以我們得到的是預設值
+
+Hello World from Python
+
+// 但是如果我們事先建立過一個環境變數
+$ export MY_NAME="Wade Wilson"
+
+// 然後再次呼叫程式
+$ python main.py
+
+// 現在就可以讀取到環境變數了
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+//// tab | Windows PowerShell
+
+<div class="termy">
+
+```console
+// 這裡我們還沒有設定環境變數
+$ python main.py
+
+// 因為我們沒有設定環境變數，所以我們得到的是預設值
+
+Hello World from Python
+
+// 但是如果我們事先建立過一個環境變數
+$ $Env:MY_NAME = "Wade Wilson"
+
+// 然後再次呼叫程式
+$ python main.py
+
+// 現在就可以讀取到環境變數了
+
+Hello Wade Wilson from Python
+```
+
+</div>
+
+////
+
+由於環境變數可以在程式碼之外設定，但可以被程式碼讀取，並且不必與其他檔案一起儲存（提交到 `git`），因此通常用於配置或**設定**。
+
+你還可以為**特定的程式呼叫**建立特定的環境變數，該環境變數僅對該程式可用，且僅在其執行期間有效。
+
+要實現這一點，只需在同一行內（程式本身之前）建立它：
+
+<div class="termy">
+
+```console
+// 在這個程式呼叫的同一行中建立一個名為 MY_NAME 的環境變數
+$ MY_NAME="Wade Wilson" python main.py
+
+// 現在就可以讀取到環境變數了
+
+Hello Wade Wilson from Python
+
+// 在此之後這個環境變數將不再存在
+$ python main.py
+
+Hello World from Python
+```
+
+</div>
+
+/// tip
+
+你可以在 <a href="https://12factor.net/zh_cn/config" class="external-link" target="_blank">The Twelve-Factor App: 配置</a>中了解更多資訊。
+
+///
+
+## 型別和驗證
+
+這些環境變數只能處理**文字字串**，因為它們是位於 Python 範疇之外的，必須與其他程式和作業系統的其餘部分相容（甚至與不同的作業系統相容，如 Linux、Windows、macOS）。
+
+這意味著從環境變數中讀取的**任何值**在 Python 中都將是一個 `str`，任何型別轉換或驗證都必須在程式碼中完成。
+
+你將在[進階使用者指南 - 設定和環境變數](./advanced/settings.md)中了解更多關於使用環境變數處理**應用程式設定**的資訊。
+
+## `PATH` 環境變數
+
+有一個**特殊的**環境變數稱為 **`PATH`**，作業系統（Linux、macOS、Windows）用它來查找要執行的程式。
+
+`PATH` 變數的值是一個長字串，由 Linux 和 macOS 上的冒號 `:` 分隔的目錄組成，而在 Windows 上則是由分號 `;` 分隔的。
+
+例如，`PATH` 環境變數可能如下所示：
+
+//// tab | Linux, macOS
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
+```
+
+這意味著系統應該在以下目錄中查找程式：
+
+- `/usr/local/bin`
+- `/usr/bin`
+- `/bin`
+- `/usr/sbin`
+- `/sbin`
+
+////
+
+//// tab | Windows
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32
+```
+
+這意味著系統應該在以下目錄中查找程式：
+
+- `C:\Program Files\Python312\Scripts`
+- `C:\Program Files\Python312`
+- `C:\Windows\System32`
+
+////
+
+當你在終端機中輸入一個**指令**時，作業系統會在 `PATH` 環境變數中列出的**每個目錄**中**查找**程式。
+
+例如，當你在終端機中輸入 `python` 時，作業系統會在該列表中的**第一個目錄**中查找名為 `python` 的程式。
+
+如果找到了，那麼作業系統將**使用它**；否則，作業系統會繼續在**其他目錄**中查找。
+
+### 安裝 Python 並更新 `PATH`
+
+安裝 Python 時，可能會詢問你是否要更新 `PATH` 環境變數。
+
+//// tab | Linux, macOS
+
+假設你安裝了 Python，並將其安裝在目錄 `/opt/custompython/bin` 中。
+
+如果你選擇更新 `PATH` 環境變數，那麼安裝程式會將 `/opt/custompython/bin` 加入到 `PATH` 環境變數中。
+
+它看起來大致會是這樣：
+
+```plaintext
+/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin
+```
+
+如此一來，當你在終端機輸入 `python` 時，系統會在 `/opt/custompython/bin` 中找到 Python 程式（最後一個目錄）並使用它。
+
+////
+
+//// tab | Windows
+
+假設你安裝了 Python，並將其安裝在目錄 `C:\opt\custompython\bin` 中。
+
+如果你選擇更新 `PATH` 環境變數（在 Python 安裝程式中，這個選項是名為 `Add Python x.xx to PATH` 的勾選框——譯者註），那麼安裝程式會將 `C:\opt\custompython\bin` 加入到 `PATH` 環境變數中。
+
+```plaintext
+C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin
+```
+
+如此一來，當你在終端機輸入 `python` 時，系統會在 `C:\opt\custompython\bin` 中找到 Python 程式（最後一個目錄）並使用它。
+
+////
+
+因此，如果你輸入：
+
+<div class="termy">
+
+```console
+$ python
+```
+
+</div>
+
+//// tab | Linux, macOS
+
+系統會在 `/opt/custompython/bin` 中**找到** `python` 程式並執行它。
+
+這大致等同於輸入以下指令：
+
+<div class="termy">
+
+```console
+$ /opt/custompython/bin/python
+```
+
+</div>
+
+////
+
+//// tab | Windows
+
+系統會在 `C:\opt\custompython\bin\python` 中**找到** `python` 程式並執行它。
+
+這大致等同於輸入以下指令：
+
+<div class="termy">
+
+```console
+$ C:\opt\custompython\bin\python
+```
+
+</div>
+
+////
+
+當學習[虛擬環境](virtual-environments.md)時，這些資訊將會很有用。
+
+## 結論
+
+透過這個教學，你應該對**環境變數**是什麼以及如何在 Python 中使用它們有了基本的了解。
+
+你也可以在<a href="https://zh.wikipedia.org/wiki/%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F" class="external-link" target="_blank">環境變數 - 維基百科</a> (<a href="https://en.wikipedia.org/wiki/Environment_variable" class="external-link" target="_blank">Wikipedia for Environment Variable</a>) 中了解更多關於它們的資訊。
+
+在許多情況下，環境變數的用途和適用性可能不會立刻顯現。但是在開發過程中，它們會在許多不同的場景中出現，因此瞭解它們是非常必要的。
+
+例如，你在接下來的[虛擬環境](virtual-environments.md)章節中將需要這些資訊。
From 2abde61372004bae6964ea7d70e7e99535560324 Mon Sep 17 00:00:00 2001
From: Chol_rang <vhtmxj154@naver.com>
Date: Sat, 9 Nov 2024 21:18:47 +0900
Subject: [PATCH 438/504] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
=?UTF-8?q?on=20for=20`docs/ko/docs/advanced/testing-websockets.md`=20(#12?=
=?UTF-8?q?739)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/ko/docs/advanced/testing-websockets.md | 15 +++++++++++++++
1 file changed, 15 insertions(+)
create mode 100644 docs/ko/docs/advanced/testing-websockets.md
diff --git a/docs/ko/docs/advanced/testing-websockets.md b/docs/ko/docs/advanced/testing-websockets.md
new file mode 100644
index 000000000..f1580c3c3
--- /dev/null
+++ b/docs/ko/docs/advanced/testing-websockets.md
@@ -0,0 +1,15 @@
+# WebSocket 테스트하기
+
+`TestClient`를 사용하여 WebSocket을 테스트할 수 있습니다.
+
+이를 위해 `with` 문에서 `TestClient`를 사용하여 WebSocket에 연결합니다:
+
+```Python hl_lines="27-31"
+{!../../docs_src/app_testing/tutorial002.py!}
+```
+
+/// note | 참고
+
+자세한 내용은 Starlette의 <a href="https://www.starlette.io/testclient/#testing-websocket-sessions" class="external-link" target="_blank"> WebSocket 테스트</a>에 관한 설명서를 참고하시길 바랍니다.
+
+///
From 589f3c0e592cd522adab65759377476e39be3e66 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 12:21:07 +0000
Subject: [PATCH 439/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 1de48f196..6fcb9b050 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -46,6 +46,7 @@ hide:
### Translations
+* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/environment-variables.md`. PR [#12785](https://github.com/fastapi/fastapi/pull/12785) by [@Vincy1230](https://github.com/Vincy1230).
* 🌐 Add Chinese translation for `docs/zh/docs/environment-variables.md`. PR [#12784](https://github.com/fastapi/fastapi/pull/12784) by [@Vincy1230](https://github.com/Vincy1230).
* 🌐 Add Korean translation for `ko/docs/advanced/response-headers.md`. PR [#12740](https://github.com/fastapi/fastapi/pull/12740) by [@kwang1215](https://github.com/kwang1215).
* 🌐 Add Chinese translation for `docs/zh/docs/virtual-environments.md`. PR [#12790](https://github.com/fastapi/fastapi/pull/12790) by [@Vincy1230](https://github.com/Vincy1230).
From 334d8326d00d7bbd7bfa3b1b50d1ecef2befbe69 Mon Sep 17 00:00:00 2001
From: Zhaohan Dong <65422392+zhaohan-dong@users.noreply.github.com>
Date: Sat, 9 Nov 2024 12:21:25 +0000
Subject: [PATCH 440/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/sub-applications.md`=20(#12806)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/sub-applications.md | 12 +++---------
1 file changed, 3 insertions(+), 9 deletions(-)
diff --git a/docs/en/docs/advanced/sub-applications.md b/docs/en/docs/advanced/sub-applications.md
index befa9908a..48e329fc1 100644
--- a/docs/en/docs/advanced/sub-applications.md
+++ b/docs/en/docs/advanced/sub-applications.md
@@ -10,9 +10,7 @@ If you need to have two independent FastAPI applications, with their own indepen
First, create the main, top-level, **FastAPI** application, and its *path operations*:
-```Python hl_lines="3 6-8"
-{!../../docs_src/sub_applications/tutorial001.py!}
-```
+{* ../../docs_src/sub_applications/tutorial001.py hl[3, 6:8] *}
### Sub-application
@@ -20,9 +18,7 @@ Then, create your sub-application, and its *path operations*.
This sub-application is just another standard FastAPI application, but this is the one that will be "mounted":
-```Python hl_lines="11 14-16"
-{!../../docs_src/sub_applications/tutorial001.py!}
-```
+{* ../../docs_src/sub_applications/tutorial001.py hl[11, 14:16] *}
### Mount the sub-application
@@ -30,9 +26,7 @@ In your top-level application, `app`, mount the sub-application, `subapi`.
In this case, it will be mounted at the path `/subapi`:
-```Python hl_lines="11 19"
-{!../../docs_src/sub_applications/tutorial001.py!}
-```
+{* ../../docs_src/sub_applications/tutorial001.py hl[11, 19] *}
### Check the automatic API docs
From e364f941be902c40e438acfee9c6ac6edad054f4 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 12:23:03 +0000
Subject: [PATCH 441/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6fcb9b050..611c49121 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -46,6 +46,7 @@ hide:
### Translations
+* 🌐 Add Korean translation for `docs/ko/docs/advanced/testing-websockets.md`. PR [#12739](https://github.com/fastapi/fastapi/pull/12739) by [@Limsunoh](https://github.com/Limsunoh).
* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/environment-variables.md`. PR [#12785](https://github.com/fastapi/fastapi/pull/12785) by [@Vincy1230](https://github.com/Vincy1230).
* 🌐 Add Chinese translation for `docs/zh/docs/environment-variables.md`. PR [#12784](https://github.com/fastapi/fastapi/pull/12784) by [@Vincy1230](https://github.com/Vincy1230).
* 🌐 Add Korean translation for `ko/docs/advanced/response-headers.md`. PR [#12740](https://github.com/fastapi/fastapi/pull/12740) by [@kwang1215](https://github.com/kwang1215).
From f0a8f00b41490cd7c54029036a6f2fbd49f78751 Mon Sep 17 00:00:00 2001
From: Alex Wendland <a.p.wendland@gmail.com>
Date: Sat, 9 Nov 2024 12:24:09 +0000
Subject: [PATCH 442/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/middleware.md`=20(#12807)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/middleware.md | 9 +++------
1 file changed, 3 insertions(+), 6 deletions(-)
diff --git a/docs/en/docs/tutorial/middleware.md b/docs/en/docs/tutorial/middleware.md
index 7c4954c7b..16d853018 100644
--- a/docs/en/docs/tutorial/middleware.md
+++ b/docs/en/docs/tutorial/middleware.md
@@ -31,9 +31,7 @@ The middleware function receives:
* Then it returns the `response` generated by the corresponding *path operation*.
* You can then further modify the `response` before returning it.
-```Python hl_lines="8-9 11 14"
-{!../../docs_src/middleware/tutorial001.py!}
-```
+{* ../../docs_src/middleware/tutorial001.py hl[8:9,11,14] *}
/// tip
@@ -59,11 +57,10 @@ And also after the `response` is generated, before returning it.
For example, you could add a custom header `X-Process-Time` containing the time in seconds that it took to process the request and generate a response:
-```Python hl_lines="10 12-13"
-{!../../docs_src/middleware/tutorial001.py!}
-```
+{* ../../docs_src/middleware/tutorial001.py hl[10,12:13] *}
/// tip
+```Python hl_lines="10 12-13"
Here we use <a href="https://docs.python.org/3/library/time.html#time.perf_counter" class="external-link" target="_blank">`time.perf_counter()`</a> instead of `time.time()` because it can be more precise for these use cases. 🤓
From 3c914aa610c5734072b43a0fa44b1943114f9603 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 12:25:28 +0000
Subject: [PATCH 443/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 611c49121..908f1acdd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/sub-applications.md`. PR [#12806](https://github.com/fastapi/fastapi/pull/12806) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/advanced/response-headers.md`. PR [#12805](https://github.com/fastapi/fastapi/pull/12805) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/fr/docs/tutorial/first-steps.md`. PR [#12594](https://github.com/fastapi/fastapi/pull/12594) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/advanced/response-cookies.md`. PR [#12804](https://github.com/fastapi/fastapi/pull/12804) by [@zhaohan-dong](https://github.com/zhaohan-dong).
From 3f2b4339aaff79983423643cae003c1378b0f54a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 12:27:28 +0000
Subject: [PATCH 444/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 908f1acdd..f972b1cdd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/middleware.md`. PR [#12807](https://github.com/fastapi/fastapi/pull/12807) by [@AlexWendland](https://github.com/AlexWendland).
* 📝 Update includes in `docs/en/docs/advanced/sub-applications.md`. PR [#12806](https://github.com/fastapi/fastapi/pull/12806) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/advanced/response-headers.md`. PR [#12805](https://github.com/fastapi/fastapi/pull/12805) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/fr/docs/tutorial/first-steps.md`. PR [#12594](https://github.com/fastapi/fastapi/pull/12594) by [@kantandane](https://github.com/kantandane).
From 5d62d85095cc44d879f7e82c07b13563c09597e7 Mon Sep 17 00:00:00 2001
From: Baldeep Singh Handa <handabaldeep@gmail.com>
Date: Sat, 9 Nov 2024 12:32:45 +0000
Subject: [PATCH 445/504] =?UTF-8?q?=F0=9F=93=9D=20Updates=20include=20for?=
=?UTF-8?q?=20`docs/en/docs/tutorial/cookie-params.md`=20(#12808)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/cookie-params.md | 104 +------------------------
1 file changed, 2 insertions(+), 102 deletions(-)
diff --git a/docs/en/docs/tutorial/cookie-params.md b/docs/en/docs/tutorial/cookie-params.md
index 8804f854f..aeeefe3f5 100644
--- a/docs/en/docs/tutorial/cookie-params.md
+++ b/docs/en/docs/tutorial/cookie-params.md
@@ -6,57 +6,7 @@ You can define Cookie parameters the same way you define `Query` and `Path` para
First import `Cookie`:
-//// tab | Python 3.10+
-
-```Python hl_lines="3"
-{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="3"
-{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="3"
-{!> ../../docs_src/cookie_params/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="1"
-{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="3"
-{!> ../../docs_src/cookie_params/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/cookie_params/tutorial001_an_py310.py hl[3] *}
## Declare `Cookie` parameters
@@ -64,57 +14,7 @@ Then declare the cookie parameters using the same structure as with `Path` and `
You can define the default value as well as all the extra validation or annotation parameters:
-//// tab | Python 3.10+
-
-```Python hl_lines="9"
-{!> ../../docs_src/cookie_params/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="9"
-{!> ../../docs_src/cookie_params/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="10"
-{!> ../../docs_src/cookie_params/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="7"
-{!> ../../docs_src/cookie_params/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9"
-{!> ../../docs_src/cookie_params/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/cookie_params/tutorial001_an_py310.py hl[9] *}
/// note | "Technical Details"
From 64204dc2b170ae583d70c25daf028018ac4497a3 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 12:35:47 +0000
Subject: [PATCH 446/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f972b1cdd..762dd3c80 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Updates include for `docs/en/docs/tutorial/cookie-params.md`. PR [#12808](https://github.com/fastapi/fastapi/pull/12808) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/en/docs/tutorial/middleware.md`. PR [#12807](https://github.com/fastapi/fastapi/pull/12807) by [@AlexWendland](https://github.com/AlexWendland).
* 📝 Update includes in `docs/en/docs/advanced/sub-applications.md`. PR [#12806](https://github.com/fastapi/fastapi/pull/12806) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/advanced/response-headers.md`. PR [#12805](https://github.com/fastapi/fastapi/pull/12805) by [@zhaohan-dong](https://github.com/zhaohan-dong).
From ffcb635c2a21c353b156e00a3f37f9cc6cc2d827 Mon Sep 17 00:00:00 2001
From: VISHNU V S <84698110+vishnuvskvkl@users.noreply.github.com>
Date: Sat, 9 Nov 2024 18:55:07 +0530
Subject: [PATCH 447/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/websockets.md`=20(#12606)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/websockets.md | 80 ++---------------------------
1 file changed, 5 insertions(+), 75 deletions(-)
diff --git a/docs/en/docs/advanced/websockets.md b/docs/en/docs/advanced/websockets.md
index 8947f32e7..95a394749 100644
--- a/docs/en/docs/advanced/websockets.md
+++ b/docs/en/docs/advanced/websockets.md
@@ -38,17 +38,13 @@ In production you would have one of the options above.
But it's the simplest way to focus on the server-side of WebSockets and have a working example:
-```Python hl_lines="2 6-38 41-43"
-{!../../docs_src/websockets/tutorial001.py!}
-```
+{* ../../docs_src/websockets/tutorial001.py hl[2,6:38,41:43] *}
## Create a `websocket`
In your **FastAPI** application, create a `websocket`:
-```Python hl_lines="1 46-47"
-{!../../docs_src/websockets/tutorial001.py!}
-```
+{* ../../docs_src/websockets/tutorial001.py hl[1,46:47] *}
/// note | "Technical Details"
@@ -62,9 +58,7 @@ You could also use `from starlette.websockets import WebSocket`.
In your WebSocket route you can `await` for messages and send messages.
-```Python hl_lines="48-52"
-{!../../docs_src/websockets/tutorial001.py!}
-```
+{* ../../docs_src/websockets/tutorial001.py hl[48:52] *}
You can receive and send binary, text, and JSON data.
@@ -115,57 +109,7 @@ In WebSocket endpoints you can import from `fastapi` and use:
They work the same way as for other FastAPI endpoints/*path operations*:
-//// tab | Python 3.10+
-
-```Python hl_lines="68-69 82"
-{!> ../../docs_src/websockets/tutorial002_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="68-69 82"
-{!> ../../docs_src/websockets/tutorial002_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="69-70 83"
-{!> ../../docs_src/websockets/tutorial002_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="66-67 79"
-{!> ../../docs_src/websockets/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="68-69 81"
-{!> ../../docs_src/websockets/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/websockets/tutorial002_an_py310.py hl[68:69,82] *}
/// info
@@ -210,21 +154,7 @@ With that you can connect the WebSocket and then send and receive messages:
When a WebSocket connection is closed, the `await websocket.receive_text()` will raise a `WebSocketDisconnect` exception, which you can then catch and handle like in this example.
-//// tab | Python 3.9+
-
-```Python hl_lines="79-81"
-{!> ../../docs_src/websockets/tutorial003_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="81-83"
-{!> ../../docs_src/websockets/tutorial003.py!}
-```
-
-////
+{* ../../docs_src/websockets/tutorial003_py39.py hl[79:81] *}
To try it out:
From f2b100900a4ea675802e3c351bd75e96a8b70960 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 13:25:30 +0000
Subject: [PATCH 448/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 762dd3c80..37c35a135 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/websockets.md`. PR [#12606](https://github.com/fastapi/fastapi/pull/12606) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Updates include for `docs/en/docs/tutorial/cookie-params.md`. PR [#12808](https://github.com/fastapi/fastapi/pull/12808) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/en/docs/tutorial/middleware.md`. PR [#12807](https://github.com/fastapi/fastapi/pull/12807) by [@AlexWendland](https://github.com/AlexWendland).
* 📝 Update includes in `docs/en/docs/advanced/sub-applications.md`. PR [#12806](https://github.com/fastapi/fastapi/pull/12806) by [@zhaohan-dong](https://github.com/zhaohan-dong).
From abd6ad21873d336a58adae69bd900d7153776da1 Mon Sep 17 00:00:00 2001
From: Quentin Takeda <quentin.vadon@gmail.com>
Date: Sat, 9 Nov 2024 15:13:47 +0100
Subject: [PATCH 449/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/response-model.md`=20(#12621)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/response-model.md | 264 ++----------------------
1 file changed, 16 insertions(+), 248 deletions(-)
diff --git a/docs/en/docs/tutorial/response-model.md b/docs/en/docs/tutorial/response-model.md
index 36ccfc4ce..e7837086f 100644
--- a/docs/en/docs/tutorial/response-model.md
+++ b/docs/en/docs/tutorial/response-model.md
@@ -4,29 +4,7 @@ You can declare the type used for the response by annotating the *path operation
You can use **type annotations** the same way you would for input data in function **parameters**, you can use Pydantic models, lists, dictionaries, scalar values like integers, booleans, etc.
-//// tab | Python 3.10+
-
-```Python hl_lines="16 21"
-{!> ../../docs_src/response_model/tutorial001_01_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="18 23"
-{!> ../../docs_src/response_model/tutorial001_01_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="18 23"
-{!> ../../docs_src/response_model/tutorial001_01.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial001_01_py310.py hl[16,21] *}
FastAPI will use this return type to:
@@ -59,29 +37,7 @@ You can use the `response_model` parameter in any of the *path operations*:
* `@app.delete()`
* etc.
-//// tab | Python 3.10+
-
-```Python hl_lines="17 22 24-27"
-{!> ../../docs_src/response_model/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="17 22 24-27"
-{!> ../../docs_src/response_model/tutorial001_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="17 22 24-27"
-{!> ../../docs_src/response_model/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial001_py310.py hl[17,22,24:27] *}
/// note
@@ -113,21 +69,7 @@ You can also use `response_model=None` to disable creating a response model for
Here we are declaring a `UserIn` model, it will contain a plaintext password:
-//// tab | Python 3.10+
-
-```Python hl_lines="7 9"
-{!> ../../docs_src/response_model/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9 11"
-{!> ../../docs_src/response_model/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial002_py310.py hl[7,9] *}
/// info
@@ -149,21 +91,7 @@ $ pip install "pydantic[email]"
And we are using this model to declare our input and the same model to declare our output:
-//// tab | Python 3.10+
-
-```Python hl_lines="16"
-{!> ../../docs_src/response_model/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="18"
-{!> ../../docs_src/response_model/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial002_py310.py hl[16] *}
Now, whenever a browser is creating a user with a password, the API will return the same password in the response.
@@ -181,57 +109,15 @@ Never store the plain password of a user or send it in a response like this, unl
We can instead create an input model with the plaintext password and an output model without it:
-//// tab | Python 3.10+
-
-```Python hl_lines="9 11 16"
-{!> ../../docs_src/response_model/tutorial003_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9 11 16"
-{!> ../../docs_src/response_model/tutorial003.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial003_py310.py hl[9,11,16] *}
Here, even though our *path operation function* is returning the same input user that contains the password:
-//// tab | Python 3.10+
-
-```Python hl_lines="24"
-{!> ../../docs_src/response_model/tutorial003_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="24"
-{!> ../../docs_src/response_model/tutorial003.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial003_py310.py hl[24] *}
...we declared the `response_model` to be our model `UserOut`, that doesn't include the password:
-//// tab | Python 3.10+
-
-```Python hl_lines="22"
-{!> ../../docs_src/response_model/tutorial003_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="22"
-{!> ../../docs_src/response_model/tutorial003.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial003_py310.py hl[22] *}
So, **FastAPI** will take care of filtering out all the data that is not declared in the output model (using Pydantic).
@@ -255,21 +141,7 @@ But in most of the cases where we need to do something like this, we want the mo
And in those cases, we can use classes and inheritance to take advantage of function **type annotations** to get better support in the editor and tools, and still get the FastAPI **data filtering**.
-//// tab | Python 3.10+
-
-```Python hl_lines="7-10 13-14 18"
-{!> ../../docs_src/response_model/tutorial003_01_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9-13 15-16 20"
-{!> ../../docs_src/response_model/tutorial003_01.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial003_01_py310.py hl[7:10,13:14,18] *}
With this, we get tooling support, from editors and mypy as this code is correct in terms of types, but we also get the data filtering from FastAPI.
@@ -311,9 +183,7 @@ There might be cases where you return something that is not a valid Pydantic fie
The most common case would be [returning a Response directly as explained later in the advanced docs](../advanced/response-directly.md){.internal-link target=_blank}.
-```Python hl_lines="8 10-11"
-{!> ../../docs_src/response_model/tutorial003_02.py!}
-```
+{* ../../docs_src/response_model/tutorial003_02.py hl[8,10:11] *}
This simple case is handled automatically by FastAPI because the return type annotation is the class (or a subclass of) `Response`.
@@ -323,9 +193,7 @@ And tools will also be happy because both `RedirectResponse` and `JSONResponse`
You can also use a subclass of `Response` in the type annotation:
-```Python hl_lines="8-9"
-{!> ../../docs_src/response_model/tutorial003_03.py!}
-```
+{* ../../docs_src/response_model/tutorial003_03.py hl[8:9] *}
This will also work because `RedirectResponse` is a subclass of `Response`, and FastAPI will automatically handle this simple case.
@@ -335,21 +203,7 @@ But when you return some other arbitrary object that is not a valid Pydantic typ
The same would happen if you had something like a <abbr title='A union between multiple types means "any of these types".'>union</abbr> between different types where one or more of them are not valid Pydantic types, for example this would fail 💥:
-//// tab | Python 3.10+
-
-```Python hl_lines="8"
-{!> ../../docs_src/response_model/tutorial003_04_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="10"
-{!> ../../docs_src/response_model/tutorial003_04.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial003_04_py310.py hl[8] *}
...this fails because the type annotation is not a Pydantic type and is not just a single `Response` class or subclass, it's a union (any of the two) between a `Response` and a `dict`.
@@ -361,21 +215,7 @@ But you might want to still keep the return type annotation in the function to g
In this case, you can disable the response model generation by setting `response_model=None`:
-//// tab | Python 3.10+
-
-```Python hl_lines="7"
-{!> ../../docs_src/response_model/tutorial003_05_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9"
-{!> ../../docs_src/response_model/tutorial003_05.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial003_05_py310.py hl[7] *}
This will make FastAPI skip the response model generation and that way you can have any return type annotations you need without it affecting your FastAPI application. 🤓
@@ -383,29 +223,7 @@ This will make FastAPI skip the response model generation and that way you can h
Your response model could have default values, like:
-//// tab | Python 3.10+
-
-```Python hl_lines="9 11-12"
-{!> ../../docs_src/response_model/tutorial004_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="11 13-14"
-{!> ../../docs_src/response_model/tutorial004_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="11 13-14"
-{!> ../../docs_src/response_model/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial004_py310.py hl[9,11:12] *}
* `description: Union[str, None] = None` (or `str | None = None` in Python 3.10) has a default of `None`.
* `tax: float = 10.5` has a default of `10.5`.
@@ -419,29 +237,7 @@ For example, if you have models with many optional attributes in a NoSQL databas
You can set the *path operation decorator* parameter `response_model_exclude_unset=True`:
-//// tab | Python 3.10+
-
-```Python hl_lines="22"
-{!> ../../docs_src/response_model/tutorial004_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="24"
-{!> ../../docs_src/response_model/tutorial004_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="24"
-{!> ../../docs_src/response_model/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial004_py310.py hl[22] *}
and those default values won't be included in the response, only the values actually set.
@@ -538,21 +334,7 @@ This also applies to `response_model_by_alias` that works similarly.
///
-//// tab | Python 3.10+
-
-```Python hl_lines="29 35"
-{!> ../../docs_src/response_model/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="31 37"
-{!> ../../docs_src/response_model/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial005_py310.py hl[29,35] *}
/// tip
@@ -566,21 +348,7 @@ It is equivalent to `set(["name", "description"])`.
If you forget to use a `set` and use a `list` or `tuple` instead, FastAPI will still convert it to a `set` and it will work correctly:
-//// tab | Python 3.10+
-
-```Python hl_lines="29 35"
-{!> ../../docs_src/response_model/tutorial006_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="31 37"
-{!> ../../docs_src/response_model/tutorial006.py!}
-```
-
-////
+{* ../../docs_src/response_model/tutorial006_py310.py hl[29,35] *}
## Recap
From 23cb1f8334c1665ed33f47c758567805bf338ffc Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 14:14:59 +0000
Subject: [PATCH 450/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 37c35a135..f7723b0b2 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/response-model.md`. PR [#12621](https://github.com/fastapi/fastapi/pull/12621) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/advanced/websockets.md`. PR [#12606](https://github.com/fastapi/fastapi/pull/12606) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Updates include for `docs/en/docs/tutorial/cookie-params.md`. PR [#12808](https://github.com/fastapi/fastapi/pull/12808) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/en/docs/tutorial/middleware.md`. PR [#12807](https://github.com/fastapi/fastapi/pull/12807) by [@AlexWendland](https://github.com/AlexWendland).
From 6f671b8b5a6b8550f254957a99f28090dc073363 Mon Sep 17 00:00:00 2001
From: Alex Wendland <a.p.wendland@gmail.com>
Date: Sat, 9 Nov 2024 14:19:27 +0000
Subject: [PATCH 451/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/path-params.md`=20(#12811)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/path-params.md | 40 +++++++---------------------
1 file changed, 10 insertions(+), 30 deletions(-)
diff --git a/docs/en/docs/tutorial/path-params.md b/docs/en/docs/tutorial/path-params.md
index fd9e74585..7e83d3ae5 100644
--- a/docs/en/docs/tutorial/path-params.md
+++ b/docs/en/docs/tutorial/path-params.md
@@ -2,9 +2,7 @@
You can declare path "parameters" or "variables" with the same syntax used by Python format strings:
-```Python hl_lines="6-7"
-{!../../docs_src/path_params/tutorial001.py!}
-```
+{* ../../docs_src/path_params/tutorial001.py hl[6:7] *}
The value of the path parameter `item_id` will be passed to your function as the argument `item_id`.
@@ -18,9 +16,7 @@ So, if you run this example and go to <a href="http://127.0.0.1:8000/items/foo"
You can declare the type of a path parameter in the function, using standard Python type annotations:
-```Python hl_lines="7"
-{!../../docs_src/path_params/tutorial002.py!}
-```
+{* ../../docs_src/path_params/tutorial002.py hl[7] *}
In this case, `item_id` is declared to be an `int`.
@@ -123,17 +119,13 @@ And then you can also have a path `/users/{user_id}` to get data about a specifi
Because *path operations* are evaluated in order, you need to make sure that the path for `/users/me` is declared before the one for `/users/{user_id}`:
-```Python hl_lines="6 11"
-{!../../docs_src/path_params/tutorial003.py!}
-```
+{* ../../docs_src/path_params/tutorial003.py hl[6,11] *}
Otherwise, the path for `/users/{user_id}` would match also for `/users/me`, "thinking" that it's receiving a parameter `user_id` with a value of `"me"`.
Similarly, you cannot redefine a path operation:
-```Python hl_lines="6 11"
-{!../../docs_src/path_params/tutorial003b.py!}
-```
+{* ../../docs_src/path_params/tutorial003b.py hl[6,11] *}
The first one will always be used since the path matches first.
@@ -149,9 +141,7 @@ By inheriting from `str` the API docs will be able to know that the values must
Then create class attributes with fixed values, which will be the available valid values:
-```Python hl_lines="1 6-9"
-{!../../docs_src/path_params/tutorial005.py!}
-```
+{* ../../docs_src/path_params/tutorial005.py hl[1,6:9] *}
/// info
@@ -169,9 +159,7 @@ If you are wondering, "AlexNet", "ResNet", and "LeNet" are just names of Machine
Then create a *path parameter* with a type annotation using the enum class you created (`ModelName`):
-```Python hl_lines="16"
-{!../../docs_src/path_params/tutorial005.py!}
-```
+{* ../../docs_src/path_params/tutorial005.py hl[16] *}
### Check the docs
@@ -187,17 +175,13 @@ The value of the *path parameter* will be an *enumeration member*.
You can compare it with the *enumeration member* in your created enum `ModelName`:
-```Python hl_lines="17"
-{!../../docs_src/path_params/tutorial005.py!}
-```
+{* ../../docs_src/path_params/tutorial005.py hl[17] *}
#### Get the *enumeration value*
You can get the actual value (a `str` in this case) using `model_name.value`, or in general, `your_enum_member.value`:
-```Python hl_lines="20"
-{!../../docs_src/path_params/tutorial005.py!}
-```
+{* ../../docs_src/path_params/tutorial005.py hl[20] *}
/// tip
@@ -211,9 +195,7 @@ You can return *enum members* from your *path operation*, even nested in a JSON
They will be converted to their corresponding values (strings in this case) before returning them to the client:
-```Python hl_lines="18 21 23"
-{!../../docs_src/path_params/tutorial005.py!}
-```
+{* ../../docs_src/path_params/tutorial005.py hl[18,21,23] *}
In your client you will get a JSON response like:
@@ -252,9 +234,7 @@ In this case, the name of the parameter is `file_path`, and the last part, `:pat
So, you can use it with:
-```Python hl_lines="6"
-{!../../docs_src/path_params/tutorial004.py!}
-```
+{* ../../docs_src/path_params/tutorial004.py hl[6] *}
/// tip
From e6b48c64518ac38e6b495cd9d7b3036072fbc1ef Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 14:19:51 +0000
Subject: [PATCH 452/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f7723b0b2..60a83dff0 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/path-params.md`. PR [#12811](https://github.com/fastapi/fastapi/pull/12811) by [@AlexWendland](https://github.com/AlexWendland).
* 📝 Update includes in `docs/en/docs/tutorial/response-model.md`. PR [#12621](https://github.com/fastapi/fastapi/pull/12621) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/advanced/websockets.md`. PR [#12606](https://github.com/fastapi/fastapi/pull/12606) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Updates include for `docs/en/docs/tutorial/cookie-params.md`. PR [#12808](https://github.com/fastapi/fastapi/pull/12808) by [@handabaldeep](https://github.com/handabaldeep).
From f6ba3a3c468e8db02c7e4219d16867f366b08430 Mon Sep 17 00:00:00 2001
From: Baldeep Singh Handa <handabaldeep@gmail.com>
Date: Sat, 9 Nov 2024 14:47:24 +0000
Subject: [PATCH 453/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/tutorial/query-param-models.md`=20(#12817)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/query-param-models.md | 132 +-------------------
1 file changed, 2 insertions(+), 130 deletions(-)
diff --git a/docs/en/docs/tutorial/query-param-models.md b/docs/en/docs/tutorial/query-param-models.md
index f7ce345b2..84d82931a 100644
--- a/docs/en/docs/tutorial/query-param-models.md
+++ b/docs/en/docs/tutorial/query-param-models.md
@@ -14,71 +14,7 @@ This is supported since FastAPI version `0.115.0`. 🤓
Declare the **query parameters** that you need in a **Pydantic model**, and then declare the parameter as `Query`:
-//// tab | Python 3.10+
-
-```Python hl_lines="9-13 17"
-{!> ../../docs_src/query_param_models/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="8-12 16"
-{!> ../../docs_src/query_param_models/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="10-14 18"
-{!> ../../docs_src/query_param_models/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9-13 17"
-{!> ../../docs_src/query_param_models/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="8-12 16"
-{!> ../../docs_src/query_param_models/tutorial001_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9-13 17"
-{!> ../../docs_src/query_param_models/tutorial001_py310.py!}
-```
-
-////
+{* ../../docs_src/query_param_models/tutorial001_an_py310.py hl[9:13,17] *}
**FastAPI** will **extract** the data for **each field** from the **query parameters** in the request and give you the Pydantic model you defined.
@@ -96,71 +32,7 @@ In some special use cases (probably not very common), you might want to **restri
You can use Pydantic's model configuration to `forbid` any `extra` fields:
-//// tab | Python 3.10+
-
-```Python hl_lines="10"
-{!> ../../docs_src/query_param_models/tutorial002_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="9"
-{!> ../../docs_src/query_param_models/tutorial002_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="11"
-{!> ../../docs_src/query_param_models/tutorial002_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="10"
-{!> ../../docs_src/query_param_models/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9"
-{!> ../../docs_src/query_param_models/tutorial002_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="11"
-{!> ../../docs_src/query_param_models/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/query_param_models/tutorial002_an_py310.py hl[10] *}
If a client tries to send some **extra** data in the **query parameters**, they will receive an **error** response.
From 9628d38d241c42c98503c885c751860d9f04d8dd Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 14:47:48 +0000
Subject: [PATCH 454/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 60a83dff0..656f9abb6 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/tutorial/query-param-models.md`. PR [#12817](https://github.com/fastapi/fastapi/pull/12817) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/en/docs/tutorial/path-params.md`. PR [#12811](https://github.com/fastapi/fastapi/pull/12811) by [@AlexWendland](https://github.com/AlexWendland).
* 📝 Update includes in `docs/en/docs/tutorial/response-model.md`. PR [#12621](https://github.com/fastapi/fastapi/pull/12621) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/en/docs/advanced/websockets.md`. PR [#12606](https://github.com/fastapi/fastapi/pull/12606) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
From 170826c911719876cd2935f3690933e5521f286f Mon Sep 17 00:00:00 2001
From: Zhaohan Dong <65422392+zhaohan-dong@users.noreply.github.com>
Date: Sat, 9 Nov 2024 14:49:21 +0000
Subject: [PATCH 455/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/request-files.md`=20(#12818)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/request-files.md | 260 +------------------------
1 file changed, 7 insertions(+), 253 deletions(-)
diff --git a/docs/en/docs/tutorial/request-files.md b/docs/en/docs/tutorial/request-files.md
index f3f1eb103..2b433555b 100644
--- a/docs/en/docs/tutorial/request-files.md
+++ b/docs/en/docs/tutorial/request-files.md
@@ -20,69 +20,13 @@ This is because uploaded files are sent as "form data".
Import `File` and `UploadFile` from `fastapi`:
-//// tab | Python 3.9+
-
-```Python hl_lines="3"
-{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="1"
-{!> ../../docs_src/request_files/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="1"
-{!> ../../docs_src/request_files/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/request_files/tutorial001_an_py39.py hl[3] *}
## Define `File` Parameters
Create file parameters the same way you would for `Body` or `Form`:
-//// tab | Python 3.9+
-
-```Python hl_lines="9"
-{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="8"
-{!> ../../docs_src/request_files/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="7"
-{!> ../../docs_src/request_files/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/request_files/tutorial001_an_py39.py hl[9] *}
/// info
@@ -110,35 +54,7 @@ But there are several cases in which you might benefit from using `UploadFile`.
Define a file parameter with a type of `UploadFile`:
-//// tab | Python 3.9+
-
-```Python hl_lines="14"
-{!> ../../docs_src/request_files/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="13"
-{!> ../../docs_src/request_files/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="12"
-{!> ../../docs_src/request_files/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/request_files/tutorial001_an_py39.py hl[14] *}
Using `UploadFile` has several advantages over `bytes`:
@@ -221,91 +137,13 @@ This is not a limitation of **FastAPI**, it's part of the HTTP protocol.
You can make a file optional by using standard type annotations and setting a default value of `None`:
-//// tab | Python 3.10+
-
-```Python hl_lines="9 17"
-{!> ../../docs_src/request_files/tutorial001_02_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="9 17"
-{!> ../../docs_src/request_files/tutorial001_02_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="10 18"
-{!> ../../docs_src/request_files/tutorial001_02_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="7 15"
-{!> ../../docs_src/request_files/tutorial001_02_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9 17"
-{!> ../../docs_src/request_files/tutorial001_02.py!}
-```
-
-////
+{* ../../docs_src/request_files/tutorial001_02_an_py310.py hl[9,17] *}
## `UploadFile` with Additional Metadata
You can also use `File()` with `UploadFile`, for example, to set additional metadata:
-//// tab | Python 3.9+
-
-```Python hl_lines="9 15"
-{!> ../../docs_src/request_files/tutorial001_03_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="8 14"
-{!> ../../docs_src/request_files/tutorial001_03_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="7 13"
-{!> ../../docs_src/request_files/tutorial001_03.py!}
-```
-
-////
+{* ../../docs_src/request_files/tutorial001_03_an_py39.py hl[9,15] *}
## Multiple File Uploads
@@ -315,49 +153,7 @@ They would be associated to the same "form field" sent using "form data".
To use that, declare a list of `bytes` or `UploadFile`:
-//// tab | Python 3.9+
-
-```Python hl_lines="10 15"
-{!> ../../docs_src/request_files/tutorial002_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="11 16"
-{!> ../../docs_src/request_files/tutorial002_an.py!}
-```
-
-////
-
-//// tab | Python 3.9+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="8 13"
-{!> ../../docs_src/request_files/tutorial002_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="10 15"
-{!> ../../docs_src/request_files/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/request_files/tutorial002_an_py39.py hl[10,15] *}
You will receive, as declared, a `list` of `bytes` or `UploadFile`s.
@@ -373,49 +169,7 @@ You could also use `from starlette.responses import HTMLResponse`.
And the same way as before, you can use `File()` to set additional parameters, even for `UploadFile`:
-//// tab | Python 3.9+
-
-```Python hl_lines="11 18-20"
-{!> ../../docs_src/request_files/tutorial003_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="12 19-21"
-{!> ../../docs_src/request_files/tutorial003_an.py!}
-```
-
-////
-
-//// tab | Python 3.9+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9 16"
-{!> ../../docs_src/request_files/tutorial003_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="11 18"
-{!> ../../docs_src/request_files/tutorial003.py!}
-```
-
-////
+{* ../../docs_src/request_files/tutorial003_an_py39.py hl[11,18:20] *}
## Recap
From e474d042d39a73126840d823b115d9c7ca355a71 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 14:50:19 +0000
Subject: [PATCH 456/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 656f9abb6..24db5b3e5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/request-files.md`. PR [#12818](https://github.com/fastapi/fastapi/pull/12818) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes for `docs/en/docs/tutorial/query-param-models.md`. PR [#12817](https://github.com/fastapi/fastapi/pull/12817) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/en/docs/tutorial/path-params.md`. PR [#12811](https://github.com/fastapi/fastapi/pull/12811) by [@AlexWendland](https://github.com/AlexWendland).
* 📝 Update includes in `docs/en/docs/tutorial/response-model.md`. PR [#12621](https://github.com/fastapi/fastapi/pull/12621) by [@kantandane](https://github.com/kantandane).
From f6819ba5d2d90a898f05cc5c3a7a4d5653b2555f Mon Sep 17 00:00:00 2001
From: Alex Wendland <a.p.wendland@gmail.com>
Date: Sat, 9 Nov 2024 14:54:23 +0000
Subject: [PATCH 457/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/path-operation-configuration.md`=20(#?=
=?UTF-8?q?12809)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../tutorial/path-operation-configuration.md | 128 +-----------------
1 file changed, 7 insertions(+), 121 deletions(-)
diff --git a/docs/en/docs/tutorial/path-operation-configuration.md b/docs/en/docs/tutorial/path-operation-configuration.md
index 4ca6ebf13..c78d20ea6 100644
--- a/docs/en/docs/tutorial/path-operation-configuration.md
+++ b/docs/en/docs/tutorial/path-operation-configuration.md
@@ -16,29 +16,7 @@ You can pass directly the `int` code, like `404`.
But if you don't remember what each number code is for, you can use the shortcut constants in `status`:
-//// tab | Python 3.10+
-
-```Python hl_lines="1 15"
-{!> ../../docs_src/path_operation_configuration/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="3 17"
-{!> ../../docs_src/path_operation_configuration/tutorial001_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="3 17"
-{!> ../../docs_src/path_operation_configuration/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/path_operation_configuration/tutorial001_py310.py hl[1,15] *}
That status code will be used in the response and will be added to the OpenAPI schema.
@@ -54,29 +32,7 @@ You could also use `from starlette import status`.
You can add tags to your *path operation*, pass the parameter `tags` with a `list` of `str` (commonly just one `str`):
-//// tab | Python 3.10+
-
-```Python hl_lines="15 20 25"
-{!> ../../docs_src/path_operation_configuration/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="17 22 27"
-{!> ../../docs_src/path_operation_configuration/tutorial002_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="17 22 27"
-{!> ../../docs_src/path_operation_configuration/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/path_operation_configuration/tutorial002_py310.py hl[15,20,25] *}
They will be added to the OpenAPI schema and used by the automatic documentation interfaces:
@@ -90,37 +46,13 @@ In these cases, it could make sense to store the tags in an `Enum`.
**FastAPI** supports that the same way as with plain strings:
-```Python hl_lines="1 8-10 13 18"
-{!../../docs_src/path_operation_configuration/tutorial002b.py!}
-```
+{* ../../docs_src/path_operation_configuration/tutorial002b.py hl[1,8:10,13,18] *}
## Summary and description
You can add a `summary` and `description`:
-//// tab | Python 3.10+
-
-```Python hl_lines="18-19"
-{!> ../../docs_src/path_operation_configuration/tutorial003_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="20-21"
-{!> ../../docs_src/path_operation_configuration/tutorial003_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="20-21"
-{!> ../../docs_src/path_operation_configuration/tutorial003.py!}
-```
-
-////
+{* ../../docs_src/path_operation_configuration/tutorial003_py310.py hl[18:19] *}
## Description from docstring
@@ -128,29 +60,7 @@ As descriptions tend to be long and cover multiple lines, you can declare the *p
You can write <a href="https://en.wikipedia.org/wiki/Markdown" class="external-link" target="_blank">Markdown</a> in the docstring, it will be interpreted and displayed correctly (taking into account docstring indentation).
-//// tab | Python 3.10+
-
-```Python hl_lines="17-25"
-{!> ../../docs_src/path_operation_configuration/tutorial004_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="19-27"
-{!> ../../docs_src/path_operation_configuration/tutorial004_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="19-27"
-{!> ../../docs_src/path_operation_configuration/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/path_operation_configuration/tutorial004_py310.py hl[17:25] *}
It will be used in the interactive docs:
@@ -160,29 +70,7 @@ It will be used in the interactive docs:
You can specify the response description with the parameter `response_description`:
-//// tab | Python 3.10+
-
-```Python hl_lines="19"
-{!> ../../docs_src/path_operation_configuration/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="21"
-{!> ../../docs_src/path_operation_configuration/tutorial005_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="21"
-{!> ../../docs_src/path_operation_configuration/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/path_operation_configuration/tutorial005_py310.py hl[19] *}
/// info
@@ -204,9 +92,7 @@ So, if you don't provide one, **FastAPI** will automatically generate one of "Su
If you need to mark a *path operation* as <abbr title="obsolete, recommended not to use it">deprecated</abbr>, but without removing it, pass the parameter `deprecated`:
-```Python hl_lines="16"
-{!../../docs_src/path_operation_configuration/tutorial006.py!}
-```
+{* ../../docs_src/path_operation_configuration/tutorial006.py hl[16] *}
It will be clearly marked as deprecated in the interactive docs:
From 4dcdb20151b761fef1645bc7b49cfda14e2dae2d Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 14:54:50 +0000
Subject: [PATCH 458/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 24db5b3e5..0a36a500c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/path-operation-configuration.md`. PR [#12809](https://github.com/fastapi/fastapi/pull/12809) by [@AlexWendland](https://github.com/AlexWendland).
* 📝 Update includes in `docs/en/docs/tutorial/request-files.md`. PR [#12818](https://github.com/fastapi/fastapi/pull/12818) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes for `docs/en/docs/tutorial/query-param-models.md`. PR [#12817](https://github.com/fastapi/fastapi/pull/12817) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/en/docs/tutorial/path-params.md`. PR [#12811](https://github.com/fastapi/fastapi/pull/12811) by [@AlexWendland](https://github.com/AlexWendland).
From 069e9bdea863a39123aca1ba02d15a391be7e0a1 Mon Sep 17 00:00:00 2001
From: Zhaohan Dong <65422392+zhaohan-dong@users.noreply.github.com>
Date: Sat, 9 Nov 2024 15:10:11 +0000
Subject: [PATCH 459/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/body-nested-models.md`=20(#12812)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/body-nested-models.md | 220 +-------------------
1 file changed, 11 insertions(+), 209 deletions(-)
diff --git a/docs/en/docs/tutorial/body-nested-models.md b/docs/en/docs/tutorial/body-nested-models.md
index 38f3eb136..b473062de 100644
--- a/docs/en/docs/tutorial/body-nested-models.md
+++ b/docs/en/docs/tutorial/body-nested-models.md
@@ -6,21 +6,7 @@ With **FastAPI**, you can define, validate, document, and use arbitrarily deeply
You can define an attribute to be a subtype. For example, a Python `list`:
-//// tab | Python 3.10+
-
-```Python hl_lines="12"
-{!> ../../docs_src/body_nested_models/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="14"
-{!> ../../docs_src/body_nested_models/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/body_nested_models/tutorial001_py310.py hl[12] *}
This will make `tags` be a list, although it doesn't declare the type of the elements of the list.
@@ -34,9 +20,7 @@ In Python 3.9 and above you can use the standard `list` to declare these type an
But in Python versions before 3.9 (3.6 and above), you first need to import `List` from standard Python's `typing` module:
-```Python hl_lines="1"
-{!> ../../docs_src/body_nested_models/tutorial002.py!}
-```
+{* ../../docs_src/body_nested_models/tutorial002.py hl[1] *}
### Declare a `list` with a type parameter
@@ -65,29 +49,7 @@ Use that same standard syntax for model attributes with internal types.
So, in our example, we can make `tags` be specifically a "list of strings":
-//// tab | Python 3.10+
-
-```Python hl_lines="12"
-{!> ../../docs_src/body_nested_models/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="14"
-{!> ../../docs_src/body_nested_models/tutorial002_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="14"
-{!> ../../docs_src/body_nested_models/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/body_nested_models/tutorial002_py310.py hl[12] *}
## Set types
@@ -97,29 +59,7 @@ And Python has a special data type for sets of unique items, the `set`.
Then we can declare `tags` as a set of strings:
-//// tab | Python 3.10+
-
-```Python hl_lines="12"
-{!> ../../docs_src/body_nested_models/tutorial003_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="14"
-{!> ../../docs_src/body_nested_models/tutorial003_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="1 14"
-{!> ../../docs_src/body_nested_models/tutorial003.py!}
-```
-
-////
+{* ../../docs_src/body_nested_models/tutorial003_py310.py hl[12] *}
With this, even if you receive a request with duplicate data, it will be converted to a set of unique items.
@@ -141,57 +81,13 @@ All that, arbitrarily nested.
For example, we can define an `Image` model:
-//// tab | Python 3.10+
-
-```Python hl_lines="7-9"
-{!> ../../docs_src/body_nested_models/tutorial004_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="9-11"
-{!> ../../docs_src/body_nested_models/tutorial004_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9-11"
-{!> ../../docs_src/body_nested_models/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/body_nested_models/tutorial004_py310.py hl[7:9] *}
### Use the submodel as a type
And then we can use it as the type of an attribute:
-//// tab | Python 3.10+
-
-```Python hl_lines="18"
-{!> ../../docs_src/body_nested_models/tutorial004_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="20"
-{!> ../../docs_src/body_nested_models/tutorial004_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="20"
-{!> ../../docs_src/body_nested_models/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/body_nested_models/tutorial004_py310.py hl[18] *}
This would mean that **FastAPI** would expect a body similar to:
@@ -224,29 +120,7 @@ To see all the options you have, checkout <a href="https://docs.pydantic.dev/lat
For example, as in the `Image` model we have a `url` field, we can declare it to be an instance of Pydantic's `HttpUrl` instead of a `str`:
-//// tab | Python 3.10+
-
-```Python hl_lines="2 8"
-{!> ../../docs_src/body_nested_models/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="4 10"
-{!> ../../docs_src/body_nested_models/tutorial005_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="4 10"
-{!> ../../docs_src/body_nested_models/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/body_nested_models/tutorial005_py310.py hl[2,8] *}
The string will be checked to be a valid URL, and documented in JSON Schema / OpenAPI as such.
@@ -254,29 +128,7 @@ The string will be checked to be a valid URL, and documented in JSON Schema / Op
You can also use Pydantic models as subtypes of `list`, `set`, etc.:
-//// tab | Python 3.10+
-
-```Python hl_lines="18"
-{!> ../../docs_src/body_nested_models/tutorial006_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="20"
-{!> ../../docs_src/body_nested_models/tutorial006_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="20"
-{!> ../../docs_src/body_nested_models/tutorial006.py!}
-```
-
-////
+{* ../../docs_src/body_nested_models/tutorial006_py310.py hl[18] *}
This will expect (convert, validate, document, etc.) a JSON body like:
@@ -314,29 +166,7 @@ Notice how the `images` key now has a list of image objects.
You can define arbitrarily deeply nested models:
-//// tab | Python 3.10+
-
-```Python hl_lines="7 12 18 21 25"
-{!> ../../docs_src/body_nested_models/tutorial007_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="9 14 20 23 27"
-{!> ../../docs_src/body_nested_models/tutorial007_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9 14 20 23 27"
-{!> ../../docs_src/body_nested_models/tutorial007.py!}
-```
-
-////
+{* ../../docs_src/body_nested_models/tutorial007_py310.py hl[7,12,18,21,25] *}
/// info
@@ -360,21 +190,7 @@ images: list[Image]
as in:
-//// tab | Python 3.9+
-
-```Python hl_lines="13"
-{!> ../../docs_src/body_nested_models/tutorial008_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="15"
-{!> ../../docs_src/body_nested_models/tutorial008.py!}
-```
-
-////
+{* ../../docs_src/body_nested_models/tutorial008_py39.py hl[13] *}
## Editor support everywhere
@@ -404,21 +220,7 @@ That's what we are going to see here.
In this case, you would accept any `dict` as long as it has `int` keys with `float` values:
-//// tab | Python 3.9+
-
-```Python hl_lines="7"
-{!> ../../docs_src/body_nested_models/tutorial009_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9"
-{!> ../../docs_src/body_nested_models/tutorial009.py!}
-```
-
-////
+{* ../../docs_src/body_nested_models/tutorial009_py39.py hl[7] *}
/// tip
From 76b13045fec86ea6b155a6a78983e39ca1e9b3ab Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 15:10:34 +0000
Subject: [PATCH 460/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 0a36a500c..6ecd07b05 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/body-nested-models.md`. PR [#12812](https://github.com/fastapi/fastapi/pull/12812) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/tutorial/path-operation-configuration.md`. PR [#12809](https://github.com/fastapi/fastapi/pull/12809) by [@AlexWendland](https://github.com/AlexWendland).
* 📝 Update includes in `docs/en/docs/tutorial/request-files.md`. PR [#12818](https://github.com/fastapi/fastapi/pull/12818) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes for `docs/en/docs/tutorial/query-param-models.md`. PR [#12817](https://github.com/fastapi/fastapi/pull/12817) by [@handabaldeep](https://github.com/handabaldeep).
From 747534334a5cfa31dfad2f7c3eaf62929f857bf4 Mon Sep 17 00:00:00 2001
From: Baldeep Singh Handa <handabaldeep@gmail.com>
Date: Sat, 9 Nov 2024 15:21:30 +0000
Subject: [PATCH 461/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/tutorial/dependencies/sub-dependencies.md`=20(?=
=?UTF-8?q?#12810)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../tutorial/dependencies/sub-dependencies.md | 156 +-----------------
1 file changed, 3 insertions(+), 153 deletions(-)
diff --git a/docs/en/docs/tutorial/dependencies/sub-dependencies.md b/docs/en/docs/tutorial/dependencies/sub-dependencies.md
index 2b098d159..1f8ba420a 100644
--- a/docs/en/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/en/docs/tutorial/dependencies/sub-dependencies.md
@@ -10,57 +10,7 @@ They can be as **deep** as you need them to be.
You could create a first dependency ("dependable") like:
-//// tab | Python 3.10+
-
-```Python hl_lines="8-9"
-{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="8-9"
-{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9-10"
-{!> ../../docs_src/dependencies/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10 non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="6-7"
-{!> ../../docs_src/dependencies/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8 non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="8-9"
-{!> ../../docs_src/dependencies/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/dependencies/tutorial005_an_py310.py hl[8:9] *}
It declares an optional query parameter `q` as a `str`, and then it just returns it.
@@ -70,57 +20,7 @@ This is quite simple (not very useful), but will help us focus on how the sub-de
Then you can create another dependency function (a "dependable") that at the same time declares a dependency of its own (so it is a "dependant" too):
-//// tab | Python 3.10+
-
-```Python hl_lines="13"
-{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="13"
-{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="14"
-{!> ../../docs_src/dependencies/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10 non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="11"
-{!> ../../docs_src/dependencies/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8 non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="13"
-{!> ../../docs_src/dependencies/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/dependencies/tutorial005_an_py310.py hl[13] *}
Let's focus on the parameters declared:
@@ -133,57 +33,7 @@ Let's focus on the parameters declared:
Then we can use the dependency with:
-//// tab | Python 3.10+
-
-```Python hl_lines="23"
-{!> ../../docs_src/dependencies/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="23"
-{!> ../../docs_src/dependencies/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="24"
-{!> ../../docs_src/dependencies/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10 non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="19"
-{!> ../../docs_src/dependencies/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8 non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="22"
-{!> ../../docs_src/dependencies/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/dependencies/tutorial005_an_py310.py hl[23] *}
/// info
From 48c66e30db387a62981291371b3af60641cd40b6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 15:21:54 +0000
Subject: [PATCH 462/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6ecd07b05..b28226b74 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/tutorial/dependencies/sub-dependencies.md`. PR [#12810](https://github.com/fastapi/fastapi/pull/12810) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/en/docs/tutorial/body-nested-models.md`. PR [#12812](https://github.com/fastapi/fastapi/pull/12812) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/tutorial/path-operation-configuration.md`. PR [#12809](https://github.com/fastapi/fastapi/pull/12809) by [@AlexWendland](https://github.com/AlexWendland).
* 📝 Update includes in `docs/en/docs/tutorial/request-files.md`. PR [#12818](https://github.com/fastapi/fastapi/pull/12818) by [@zhaohan-dong](https://github.com/zhaohan-dong).
From 85e0a95bde0267d6c958f298a341f63cc47a1880 Mon Sep 17 00:00:00 2001
From: VISHNU V S <84698110+vishnuvskvkl@users.noreply.github.com>
Date: Sat, 9 Nov 2024 20:56:44 +0530
Subject: [PATCH 463/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/tutorial/cors.md`=20(#12637)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/cors.md | 5 ++---
1 file changed, 2 insertions(+), 3 deletions(-)
diff --git a/docs/en/docs/tutorial/cors.md b/docs/en/docs/tutorial/cors.md
index 8dfc9bad9..a5d9b763a 100644
--- a/docs/en/docs/tutorial/cors.md
+++ b/docs/en/docs/tutorial/cors.md
@@ -46,9 +46,8 @@ You can also specify whether your backend allows:
* Specific HTTP methods (`POST`, `PUT`) or all of them with the wildcard `"*"`.
* Specific HTTP headers or all of them with the wildcard `"*"`.
-```Python hl_lines="2 6-11 13-19"
-{!../../docs_src/cors/tutorial001.py!}
-```
+{* ../../docs_src/cors/tutorial001.py hl[2,6:11,13:19] *}
+
The default parameters used by the `CORSMiddleware` implementation are restrictive by default, so you'll need to explicitly enable particular origins, methods, or headers, in order for browsers to be permitted to use them in a Cross-Domain context.
From 825419ecc48e3d68767f93f2c462cf5b7a2719ae Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 15:27:18 +0000
Subject: [PATCH 464/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b28226b74..ddc5cc3c7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/tutorial/cors.md`. PR [#12637](https://github.com/fastapi/fastapi/pull/12637) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Update includes for `docs/en/docs/tutorial/dependencies/sub-dependencies.md`. PR [#12810](https://github.com/fastapi/fastapi/pull/12810) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/en/docs/tutorial/body-nested-models.md`. PR [#12812](https://github.com/fastapi/fastapi/pull/12812) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/tutorial/path-operation-configuration.md`. PR [#12809](https://github.com/fastapi/fastapi/pull/12809) by [@AlexWendland](https://github.com/AlexWendland).
From 480ba19e9f2cf055a722cdd86c427c1b6e9b5816 Mon Sep 17 00:00:00 2001
From: VISHNU V S <84698110+vishnuvskvkl@users.noreply.github.com>
Date: Sat, 9 Nov 2024 20:58:48 +0530
Subject: [PATCH 465/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/tutorial/extra-models.md`=20(#12638)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/extra-models.md | 76 ++-------------------------
1 file changed, 5 insertions(+), 71 deletions(-)
diff --git a/docs/en/docs/tutorial/extra-models.md b/docs/en/docs/tutorial/extra-models.md
index 4e6f69f31..5fac3f69e 100644
--- a/docs/en/docs/tutorial/extra-models.md
+++ b/docs/en/docs/tutorial/extra-models.md
@@ -20,21 +20,8 @@ If you don't know, you will learn what a "password hash" is in the [security cha
Here's a general idea of how the models could look like with their password fields and the places where they are used:
-//// tab | Python 3.10+
+{* ../../docs_src/extra_models/tutorial001_py310.py hl[7,9,14,20,22,27:28,31:33,38:39] *}
-```Python hl_lines="7 9 14 20 22 27-28 31-33 38-39"
-{!> ../../docs_src/extra_models/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9 11 16 22 24 29-30 33-35 40-41"
-{!> ../../docs_src/extra_models/tutorial001.py!}
-```
-
-////
/// info
@@ -176,21 +163,7 @@ All the data conversion, validation, documentation, etc. will still work as norm
That way, we can declare just the differences between the models (with plaintext `password`, with `hashed_password` and without password):
-//// tab | Python 3.10+
-
-```Python hl_lines="7 13-14 17-18 21-22"
-{!> ../../docs_src/extra_models/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9 15-16 19-20 23-24"
-{!> ../../docs_src/extra_models/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/extra_models/tutorial002_py310.py hl[7,13:14,17:18,21:22] *}
## `Union` or `anyOf`
@@ -206,21 +179,8 @@ When defining a <a href="https://docs.pydantic.dev/latest/concepts/types/#unions
///
-//// tab | Python 3.10+
-
-```Python hl_lines="1 14-15 18-20 33"
-{!> ../../docs_src/extra_models/tutorial003_py310.py!}
-```
-
-////
+{* ../../docs_src/extra_models/tutorial003_py310.py hl[1,14:15,18:20,33] *}
-//// tab | Python 3.8+
-
-```Python hl_lines="1 14-15 18-20 33"
-{!> ../../docs_src/extra_models/tutorial003.py!}
-```
-
-////
### `Union` in Python 3.10
@@ -242,21 +202,8 @@ The same way, you can declare responses of lists of objects.
For that, use the standard Python `typing.List` (or just `list` in Python 3.9 and above):
-//// tab | Python 3.9+
-
-```Python hl_lines="18"
-{!> ../../docs_src/extra_models/tutorial004_py39.py!}
-```
-
-////
+{* ../../docs_src/extra_models/tutorial004_py39.py hl[18] *}
-//// tab | Python 3.8+
-
-```Python hl_lines="1 20"
-{!> ../../docs_src/extra_models/tutorial004.py!}
-```
-
-////
## Response with arbitrary `dict`
@@ -266,21 +213,8 @@ This is useful if you don't know the valid field/attribute names (that would be
In this case, you can use `typing.Dict` (or just `dict` in Python 3.9 and above):
-//// tab | Python 3.9+
-
-```Python hl_lines="6"
-{!> ../../docs_src/extra_models/tutorial005_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="1 8"
-{!> ../../docs_src/extra_models/tutorial005.py!}
-```
+{* ../../docs_src/extra_models/tutorial005_py39.py hl[6] *}
-////
## Recap
From 0c449748ffabae7ab8a8dd106b731322aad1e098 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 15:29:42 +0000
Subject: [PATCH 466/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ddc5cc3c7..a6f9c4d55 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/tutorial/extra-models.md`. PR [#12638](https://github.com/fastapi/fastapi/pull/12638) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Update includes for `docs/en/docs/tutorial/cors.md`. PR [#12637](https://github.com/fastapi/fastapi/pull/12637) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Update includes for `docs/en/docs/tutorial/dependencies/sub-dependencies.md`. PR [#12810](https://github.com/fastapi/fastapi/pull/12810) by [@handabaldeep](https://github.com/handabaldeep).
* 📝 Update includes in `docs/en/docs/tutorial/body-nested-models.md`. PR [#12812](https://github.com/fastapi/fastapi/pull/12812) by [@zhaohan-dong](https://github.com/zhaohan-dong).
From 35506c1f59d306602d6abb33cd7183f2b40ca374 Mon Sep 17 00:00:00 2001
From: VISHNU V S <84698110+vishnuvskvkl@users.noreply.github.com>
Date: Sat, 9 Nov 2024 20:59:53 +0530
Subject: [PATCH 467/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/cookie-param-models.md`=20(#12639)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/cookie-param-models.md | 82 +-------------------
1 file changed, 2 insertions(+), 80 deletions(-)
diff --git a/docs/en/docs/tutorial/cookie-param-models.md b/docs/en/docs/tutorial/cookie-param-models.md
index 62cafbb23..55a812852 100644
--- a/docs/en/docs/tutorial/cookie-param-models.md
+++ b/docs/en/docs/tutorial/cookie-param-models.md
@@ -20,57 +20,7 @@ This same technique applies to `Query`, `Cookie`, and `Header`. 😎
Declare the **cookie** parameters that you need in a **Pydantic model**, and then declare the parameter as `Cookie`:
-//// tab | Python 3.10+
-
-```Python hl_lines="9-12 16"
-{!> ../../docs_src/cookie_param_models/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="9-12 16"
-{!> ../../docs_src/cookie_param_models/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="10-13 17"
-{!> ../../docs_src/cookie_param_models/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="7-10 14"
-{!> ../../docs_src/cookie_param_models/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9-12 16"
-{!> ../../docs_src/cookie_param_models/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/cookie_param_models/tutorial001_an_py310.py hl[9:12,16] *}
**FastAPI** will **extract** the data for **each field** from the **cookies** received in the request and give you the Pydantic model you defined.
@@ -100,35 +50,7 @@ Your API now has the power to control its own <abbr title="This is a joke, just
You can use Pydantic's model configuration to `forbid` any `extra` fields:
-//// tab | Python 3.9+
-
-```Python hl_lines="10"
-{!> ../../docs_src/cookie_param_models/tutorial002_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="11"
-{!> ../../docs_src/cookie_param_models/tutorial002_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="10"
-{!> ../../docs_src/cookie_param_models/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/cookie_param_models/tutorial002_an_py39.py hl[10] *}
If a client tries to send some **extra cookies**, they will receive an **error** response.
From 182cc4439e5a97ff0c1be3ff1be90f78398e40ed Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 15:30:31 +0000
Subject: [PATCH 468/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a6f9c4d55..bfc7669a5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/cookie-param-models.md`. PR [#12639](https://github.com/fastapi/fastapi/pull/12639) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Update includes for `docs/en/docs/tutorial/extra-models.md`. PR [#12638](https://github.com/fastapi/fastapi/pull/12638) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Update includes for `docs/en/docs/tutorial/cors.md`. PR [#12637](https://github.com/fastapi/fastapi/pull/12637) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Update includes for `docs/en/docs/tutorial/dependencies/sub-dependencies.md`. PR [#12810](https://github.com/fastapi/fastapi/pull/12810) by [@handabaldeep](https://github.com/handabaldeep).
From 438343c3767f87cc04e7a4e9dfc3963ea6ecdc83 Mon Sep 17 00:00:00 2001
From: VISHNU V S <84698110+vishnuvskvkl@users.noreply.github.com>
Date: Sat, 9 Nov 2024 21:02:39 +0530
Subject: [PATCH 469/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/tutorial/header-params.md`=20(#12640)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/header-params.md | 222 +------------------------
1 file changed, 4 insertions(+), 218 deletions(-)
diff --git a/docs/en/docs/tutorial/header-params.md b/docs/en/docs/tutorial/header-params.md
index 293de897f..e34f301a9 100644
--- a/docs/en/docs/tutorial/header-params.md
+++ b/docs/en/docs/tutorial/header-params.md
@@ -6,57 +6,7 @@ You can define Header parameters the same way you define `Query`, `Path` and `Co
First import `Header`:
-//// tab | Python 3.10+
-
-```Python hl_lines="3"
-{!> ../../docs_src/header_params/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="3"
-{!> ../../docs_src/header_params/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="3"
-{!> ../../docs_src/header_params/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="1"
-{!> ../../docs_src/header_params/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="3"
-{!> ../../docs_src/header_params/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/header_params/tutorial001_an_py310.py hl[3] *}
## Declare `Header` parameters
@@ -64,57 +14,7 @@ Then declare the header parameters using the same structure as with `Path`, `Que
You can define the default value as well as all the extra validation or annotation parameters:
-//// tab | Python 3.10+
-
-```Python hl_lines="9"
-{!> ../../docs_src/header_params/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="9"
-{!> ../../docs_src/header_params/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="10"
-{!> ../../docs_src/header_params/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="7"
-{!> ../../docs_src/header_params/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9"
-{!> ../../docs_src/header_params/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/header_params/tutorial001_an_py310.py hl[9] *}
/// note | "Technical Details"
@@ -146,57 +46,7 @@ So, you can use `user_agent` as you normally would in Python code, instead of ne
If for some reason you need to disable automatic conversion of underscores to hyphens, set the parameter `convert_underscores` of `Header` to `False`:
-//// tab | Python 3.10+
-
-```Python hl_lines="10"
-{!> ../../docs_src/header_params/tutorial002_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="11"
-{!> ../../docs_src/header_params/tutorial002_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="12"
-{!> ../../docs_src/header_params/tutorial002_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="8"
-{!> ../../docs_src/header_params/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="10"
-{!> ../../docs_src/header_params/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/header_params/tutorial002_an_py310.py hl[10] *}
/// warning
@@ -214,71 +64,7 @@ You will receive all the values from the duplicate header as a Python `list`.
For example, to declare a header of `X-Token` that can appear more than once, you can write:
-//// tab | Python 3.10+
-
-```Python hl_lines="9"
-{!> ../../docs_src/header_params/tutorial003_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="9"
-{!> ../../docs_src/header_params/tutorial003_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="10"
-{!> ../../docs_src/header_params/tutorial003_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="7"
-{!> ../../docs_src/header_params/tutorial003_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9"
-{!> ../../docs_src/header_params/tutorial003_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9"
-{!> ../../docs_src/header_params/tutorial003.py!}
-```
-
-////
+{* ../../docs_src/header_params/tutorial003_an_py310.py hl[9] *}
If you communicate with that *path operation* sending two HTTP headers like:
From 911d24bede6e98c1d4207cb7679e89f6a6e30b4f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 15:33:00 +0000
Subject: [PATCH 470/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index bfc7669a5..fcbe0f28c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/tutorial/header-params.md`. PR [#12640](https://github.com/fastapi/fastapi/pull/12640) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Update includes in `docs/en/docs/tutorial/cookie-param-models.md`. PR [#12639](https://github.com/fastapi/fastapi/pull/12639) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Update includes for `docs/en/docs/tutorial/extra-models.md`. PR [#12638](https://github.com/fastapi/fastapi/pull/12638) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Update includes for `docs/en/docs/tutorial/cors.md`. PR [#12637](https://github.com/fastapi/fastapi/pull/12637) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
From 5cf323d93c7563683d1518702dbfe58ee4a76219 Mon Sep 17 00:00:00 2001
From: Quentin Takeda <quentin.vadon@gmail.com>
Date: Sat, 9 Nov 2024 16:38:03 +0100
Subject: [PATCH 471/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/fr/docs/advanced/response-directly.md`=20(#12632)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/fr/docs/advanced/response-directly.md | 8 ++------
1 file changed, 2 insertions(+), 6 deletions(-)
diff --git a/docs/fr/docs/advanced/response-directly.md b/docs/fr/docs/advanced/response-directly.md
index 80876bc18..338aee017 100644
--- a/docs/fr/docs/advanced/response-directly.md
+++ b/docs/fr/docs/advanced/response-directly.md
@@ -34,9 +34,7 @@ Par exemple, vous ne pouvez pas mettre un modèle Pydantic dans une `JSONRespons
Pour ces cas, vous pouvez spécifier un appel à `jsonable_encoder` pour convertir vos données avant de les passer à une réponse :
-```Python hl_lines="6-7 21-22"
-{!../../docs_src/response_directly/tutorial001.py!}
-```
+{* ../../docs_src/response_directly/tutorial001.py hl[6:7,21:22] *}
/// note | "Détails techniques"
@@ -56,9 +54,7 @@ Disons que vous voulez retourner une réponse <a href="https://en.wikipedia.org/
Vous pouvez mettre votre contenu XML dans une chaîne de caractères, la placer dans une `Response`, et la retourner :
-```Python hl_lines="1 18"
-{!../../docs_src/response_directly/tutorial002.py!}
-```
+{* ../../docs_src/response_directly/tutorial002.py hl[1,18] *}
## Notes
From 2e35557254f53215fe3d2150a24778cd85096472 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 15:39:04 +0000
Subject: [PATCH 472/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fcbe0f28c..8ddb0f4dc 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/fr/docs/advanced/response-directly.md`. PR [#12632](https://github.com/fastapi/fastapi/pull/12632) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes for `docs/en/docs/tutorial/header-params.md`. PR [#12640](https://github.com/fastapi/fastapi/pull/12640) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Update includes in `docs/en/docs/tutorial/cookie-param-models.md`. PR [#12639](https://github.com/fastapi/fastapi/pull/12639) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Update includes for `docs/en/docs/tutorial/extra-models.md`. PR [#12638](https://github.com/fastapi/fastapi/pull/12638) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
From 2cfd018446ec0e1f97f03a35b9b5227829263248 Mon Sep 17 00:00:00 2001
From: Quentin Takeda <quentin.vadon@gmail.com>
Date: Sat, 9 Nov 2024 16:43:03 +0100
Subject: [PATCH 473/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/fr/docs/advanced/path-operation-advanced-configuration?=
=?UTF-8?q?.md`=20(#12633)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../path-operation-advanced-configuration.md | 32 +++++--------------
1 file changed, 8 insertions(+), 24 deletions(-)
diff --git a/docs/fr/docs/advanced/path-operation-advanced-configuration.md b/docs/fr/docs/advanced/path-operation-advanced-configuration.md
index 94b20b0f3..b00f46727 100644
--- a/docs/fr/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/fr/docs/advanced/path-operation-advanced-configuration.md
@@ -12,9 +12,7 @@ Dans OpenAPI, les chemins sont des ressources, tels que /users/ ou /items/, expo
Vous devez vous assurer qu'il est unique pour chaque opération.
-```Python hl_lines="6"
-{!../../docs_src/path_operation_advanced_configuration/tutorial001.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial001.py hl[6] *}
### Utilisation du nom *path operation function* comme operationId
@@ -22,9 +20,7 @@ Si vous souhaitez utiliser les noms de fonction de vos API comme `operationId`,
Vous devriez le faire après avoir ajouté toutes vos *paramètres de chemin*.
-```Python hl_lines="2 12-21 24"
-{!../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial002.py hl[2,12:21,24] *}
/// tip | "Astuce"
@@ -44,9 +40,7 @@ Même s'ils se trouvent dans des modules différents (fichiers Python).
Pour exclure un *chemin* du schéma OpenAPI généré (et donc des systèmes de documentation automatiques), utilisez le paramètre `include_in_schema` et assignez-lui la valeur `False` :
-```Python hl_lines="6"
-{!../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial003.py hl[6] *}
## Description avancée de docstring
@@ -56,9 +50,7 @@ L'ajout d'un `\f` (un caractère d'échappement "form feed") va permettre à **F
Il n'apparaîtra pas dans la documentation, mais d'autres outils (tel que Sphinx) pourront utiliser le reste.
-```Python hl_lines="19-29"
-{!../../docs_src/path_operation_advanced_configuration/tutorial004.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial004.py hl[19:29] *}
## Réponses supplémentaires
@@ -98,9 +90,7 @@ Vous pouvez étendre le schéma OpenAPI pour une *opération de chemin* en utili
Cet `openapi_extra` peut être utile, par exemple, pour déclarer [OpenAPI Extensions](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#specificationExtensions) :
-```Python hl_lines="6"
-{!../../docs_src/path_operation_advanced_configuration/tutorial005.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial005.py hl[6] *}
Si vous ouvrez la documentation automatique de l'API, votre extension apparaîtra au bas du *chemin* spécifique.
@@ -147,9 +137,7 @@ Par exemple, vous pouvez décider de lire et de valider la requête avec votre p
Vous pouvez le faire avec `openapi_extra` :
-```Python hl_lines="20-37 39-40"
-{!../../docs_src/path_operation_advanced_configuration/tutorial006.py !}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial006.py hl[20:37,39:40] *}
Dans cet exemple, nous n'avons déclaré aucun modèle Pydantic. En fait, le corps de la requête n'est même pas <abbr title="converti d'un format simple, comme des octets, en objets Python">parsé</abbr> en tant que JSON, il est lu directement en tant que `bytes`, et la fonction `magic_data_reader()` serait chargé de l'analyser d'une manière ou d'une autre.
@@ -163,9 +151,7 @@ Et vous pouvez le faire même si le type de données dans la requête n'est pas
Dans cet exemple, nous n'utilisons pas les fonctionnalités de FastAPI pour extraire le schéma JSON des modèles Pydantic ni la validation automatique pour JSON. En fait, nous déclarons le type de contenu de la requête en tant que YAML, et non JSON :
-```Python hl_lines="17-22 24"
-{!../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial007.py hl[17:22,24] *}
Néanmoins, bien que nous n'utilisions pas la fonctionnalité par défaut, nous utilisons toujours un modèle Pydantic pour générer manuellement le schéma JSON pour les données que nous souhaitons recevoir en YAML.
@@ -173,9 +159,7 @@ Ensuite, nous utilisons directement la requête et extrayons son contenu en tant
Et nous analysons directement ce contenu YAML, puis nous utilisons à nouveau le même modèle Pydantic pour valider le contenu YAML :
-```Python hl_lines="26-33"
-{!../../docs_src/path_operation_advanced_configuration/tutorial007.py!}
-```
+{* ../../docs_src/path_operation_advanced_configuration/tutorial007.py hl[26:33] *}
/// tip | "Astuce"
From 712c57393c01fe56983762780f62a1f4901070dd Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 15:43:28 +0000
Subject: [PATCH 474/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8ddb0f4dc..e80a53532 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/fr/docs/advanced/path-operation-advanced-configuration.md`. PR [#12633](https://github.com/fastapi/fastapi/pull/12633) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/fr/docs/advanced/response-directly.md`. PR [#12632](https://github.com/fastapi/fastapi/pull/12632) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes for `docs/en/docs/tutorial/header-params.md`. PR [#12640](https://github.com/fastapi/fastapi/pull/12640) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
* 📝 Update includes in `docs/en/docs/tutorial/cookie-param-models.md`. PR [#12639](https://github.com/fastapi/fastapi/pull/12639) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
From 9a8a1adad3b5c7222ee947ecfd32fe8230faebc6 Mon Sep 17 00:00:00 2001
From: Fred <frederic.egmorte@gmail.com>
Date: Sat, 9 Nov 2024 16:48:46 +0100
Subject: [PATCH 475/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/fr/docs/advanced/additional-responses.md`=20(#12634)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/fr/docs/advanced/additional-responses.md | 16 ++++------------
1 file changed, 4 insertions(+), 12 deletions(-)
diff --git a/docs/fr/docs/advanced/additional-responses.md b/docs/fr/docs/advanced/additional-responses.md
index 52a0a0792..12f944b12 100644
--- a/docs/fr/docs/advanced/additional-responses.md
+++ b/docs/fr/docs/advanced/additional-responses.md
@@ -26,9 +26,7 @@ Chacun de ces `dict` de réponse peut avoir une clé `model`, contenant un modè
Par exemple, pour déclarer une autre réponse avec un code HTTP `404` et un modèle Pydantic `Message`, vous pouvez écrire :
-```Python hl_lines="18 22"
-{!../../docs_src/additional_responses/tutorial001.py!}
-```
+{* ../../docs_src/additional_responses/tutorial001.py hl[18,22] *}
/// note | "Remarque"
@@ -177,9 +175,7 @@ Vous pouvez utiliser ce même paramètre `responses` pour ajouter différents ty
Par exemple, vous pouvez ajouter un type de média supplémentaire `image/png`, en déclarant que votre *opération de chemin* peut renvoyer un objet JSON (avec le type de média `application/json`) ou une image PNG :
-```Python hl_lines="19-24 28"
-{!../../docs_src/additional_responses/tutorial002.py!}
-```
+{* ../../docs_src/additional_responses/tutorial002.py hl[19:24,28] *}
/// note | "Remarque"
@@ -207,9 +203,7 @@ Par exemple, vous pouvez déclarer une réponse avec un code HTTP `404` qui util
Et une réponse avec un code HTTP `200` qui utilise votre `response_model`, mais inclut un `example` personnalisé :
-```Python hl_lines="20-31"
-{!../../docs_src/additional_responses/tutorial003.py!}
-```
+{* ../../docs_src/additional_responses/tutorial003.py hl[20:31] *}
Tout sera combiné et inclus dans votre OpenAPI, et affiché dans la documentation de l'API :
@@ -243,9 +237,7 @@ Vous pouvez utiliser cette technique pour réutiliser certaines réponses préd
Par exemple:
-```Python hl_lines="13-17 26"
-{!../../docs_src/additional_responses/tutorial004.py!}
-```
+{* ../../docs_src/additional_responses/tutorial004.py hl[13:17,26] *}
## Plus d'informations sur les réponses OpenAPI
From 636171ce312d7021b5f29378417db196cc5b0224 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 15:49:07 +0000
Subject: [PATCH 476/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e80a53532..73d60c229 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/fr/docs/advanced/additional-responses.md`. PR [#12634](https://github.com/fastapi/fastapi/pull/12634) by [@fegmorte](https://github.com/fegmorte).
* 📝 Update includes in `docs/fr/docs/advanced/path-operation-advanced-configuration.md`. PR [#12633](https://github.com/fastapi/fastapi/pull/12633) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/fr/docs/advanced/response-directly.md`. PR [#12632](https://github.com/fastapi/fastapi/pull/12632) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes for `docs/en/docs/tutorial/header-params.md`. PR [#12640](https://github.com/fastapi/fastapi/pull/12640) by [@vishnuvskvkl](https://github.com/vishnuvskvkl).
From 5c080d81ae95d3f7dd0775b1f1789b9249d1bbec Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 9 Nov 2024 17:00:17 +0100
Subject: [PATCH 477/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/tutorial/schema-extra-example.md`=20(#12822)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/de/docs/tutorial/schema-extra-example.md | 200 +-----------------
docs/en/docs/tutorial/schema-extra-example.md | 200 +-----------------
docs/ko/docs/tutorial/schema-extra-example.md | 200 +-----------------
..._py310_pv1.py => tutorial001_pv1_py310.py} | 0
...0_pv1.py => test_tutorial001_pv1_py310.py} | 2 +-
5 files changed, 25 insertions(+), 577 deletions(-)
rename docs_src/schema_extra_example/{tutorial001_py310_pv1.py => tutorial001_pv1_py310.py} (100%)
rename tests/test_tutorial/test_schema_extra_example/{test_tutorial001_py310_pv1.py => test_tutorial001_pv1_py310.py} (98%)
diff --git a/docs/de/docs/tutorial/schema-extra-example.md b/docs/de/docs/tutorial/schema-extra-example.md
index 0da1a4ea4..ae3b98709 100644
--- a/docs/de/docs/tutorial/schema-extra-example.md
+++ b/docs/de/docs/tutorial/schema-extra-example.md
@@ -8,35 +8,15 @@ Hier sind mehrere Möglichkeiten, das zu tun.
Sie können `examples` („Beispiele“) für ein Pydantic-Modell deklarieren, welche dem generierten JSON-Schema hinzugefügt werden.
-//// tab | Python 3.10+ Pydantic v2
-
-```Python hl_lines="13-24"
-{!> ../../docs_src/schema_extra_example/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.10+ Pydantic v1
-
-```Python hl_lines="13-23"
-{!> ../../docs_src/schema_extra_example/tutorial001_py310_pv1.py!}
-```
-
-////
-
-//// tab | Python 3.8+ Pydantic v2
+//// tab | Pydantic v2
-```Python hl_lines="15-26"
-{!> ../../docs_src/schema_extra_example/tutorial001.py!}
-```
+{* ../../docs_src/schema_extra_example/tutorial001_py310.py hl[13:24] *}
////
-//// tab | Python 3.8+ Pydantic v1
+//// tab | Pydantic v1
-```Python hl_lines="15-25"
-{!> ../../docs_src/schema_extra_example/tutorial001_pv1.py!}
-```
+{* ../../docs_src/schema_extra_example/tutorial001_pv1_py310.py hl[13:23] *}
////
@@ -80,21 +60,7 @@ Mehr erfahren Sie am Ende dieser Seite.
Wenn Sie `Field()` mit Pydantic-Modellen verwenden, können Sie ebenfalls zusätzliche `examples` deklarieren:
-//// tab | Python 3.10+
-
-```Python hl_lines="2 8-11"
-{!> ../../docs_src/schema_extra_example/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="4 10-13"
-{!> ../../docs_src/schema_extra_example/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/schema_extra_example/tutorial002_py310.py hl[2,8:11] *}
## `examples` im JSON-Schema – OpenAPI
@@ -114,57 +80,7 @@ können Sie auch eine Gruppe von `examples` mit zusätzlichen Informationen dekl
Hier übergeben wir `examples`, welches ein einzelnes Beispiel für die in `Body()` erwarteten Daten enthält:
-//// tab | Python 3.10+
-
-```Python hl_lines="22-29"
-{!> ../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="22-29"
-{!> ../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="23-30"
-{!> ../../docs_src/schema_extra_example/tutorial003_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="18-25"
-{!> ../../docs_src/schema_extra_example/tutorial003_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="20-27"
-{!> ../../docs_src/schema_extra_example/tutorial003.py!}
-```
-
-////
+{* ../../docs_src/schema_extra_example/tutorial003_an_py310.py hl[22:29] *}
### Beispiel in der Dokumentations-Benutzeroberfläche
@@ -176,57 +92,7 @@ Mit jeder der oben genannten Methoden würde es in `/docs` so aussehen:
Sie können natürlich auch mehrere `examples` übergeben:
-//// tab | Python 3.10+
-
-```Python hl_lines="23-38"
-{!> ../../docs_src/schema_extra_example/tutorial004_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="23-38"
-{!> ../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="24-39"
-{!> ../../docs_src/schema_extra_example/tutorial004_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="19-34"
-{!> ../../docs_src/schema_extra_example/tutorial004_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="21-36"
-{!> ../../docs_src/schema_extra_example/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/schema_extra_example/tutorial004_an_py310.py hl[23:38] *}
Wenn Sie das tun, werden die Beispiele Teil des internen **JSON-Schemas** für diese Body-Daten.
@@ -267,57 +133,7 @@ Jedes spezifische Beispiel-`dict` in den `examples` kann Folgendes enthalten:
Sie können es so verwenden:
-//// tab | Python 3.10+
-
-```Python hl_lines="23-49"
-{!> ../../docs_src/schema_extra_example/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="23-49"
-{!> ../../docs_src/schema_extra_example/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="24-50"
-{!> ../../docs_src/schema_extra_example/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="19-45"
-{!> ../../docs_src/schema_extra_example/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ nicht annotiert
-
-/// tip | "Tipp"
-
-Bevorzugen Sie die `Annotated`-Version, falls möglich.
-
-///
-
-```Python hl_lines="21-47"
-{!> ../../docs_src/schema_extra_example/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/schema_extra_example/tutorial005_an_py310.py hl[23:49] *}
### OpenAPI-Beispiele in der Dokumentations-Benutzeroberfläche
diff --git a/docs/en/docs/tutorial/schema-extra-example.md b/docs/en/docs/tutorial/schema-extra-example.md
index 5896b54d9..32a1f5ca2 100644
--- a/docs/en/docs/tutorial/schema-extra-example.md
+++ b/docs/en/docs/tutorial/schema-extra-example.md
@@ -8,35 +8,15 @@ Here are several ways to do it.
You can declare `examples` for a Pydantic model that will be added to the generated JSON Schema.
-//// tab | Python 3.10+ Pydantic v2
-
-```Python hl_lines="13-24"
-{!> ../../docs_src/schema_extra_example/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.10+ Pydantic v1
-
-```Python hl_lines="13-23"
-{!> ../../docs_src/schema_extra_example/tutorial001_py310_pv1.py!}
-```
-
-////
-
-//// tab | Python 3.8+ Pydantic v2
+//// tab | Pydantic v2
-```Python hl_lines="15-26"
-{!> ../../docs_src/schema_extra_example/tutorial001.py!}
-```
+{* ../../docs_src/schema_extra_example/tutorial001_py310.py hl[13:24] *}
////
-//// tab | Python 3.8+ Pydantic v1
+//// tab | Pydantic v1
-```Python hl_lines="15-25"
-{!> ../../docs_src/schema_extra_example/tutorial001_pv1.py!}
-```
+{* ../../docs_src/schema_extra_example/tutorial001_pv1_py310.py hl[13:23] *}
////
@@ -80,21 +60,7 @@ You can read more at the end of this page.
When using `Field()` with Pydantic models, you can also declare additional `examples`:
-//// tab | Python 3.10+
-
-```Python hl_lines="2 8-11"
-{!> ../../docs_src/schema_extra_example/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="4 10-13"
-{!> ../../docs_src/schema_extra_example/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/schema_extra_example/tutorial002_py310.py hl[2,8:11] *}
## `examples` in JSON Schema - OpenAPI
@@ -114,57 +80,7 @@ you can also declare a group of `examples` with additional information that will
Here we pass `examples` containing one example of the data expected in `Body()`:
-//// tab | Python 3.10+
-
-```Python hl_lines="22-29"
-{!> ../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="22-29"
-{!> ../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="23-30"
-{!> ../../docs_src/schema_extra_example/tutorial003_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="18-25"
-{!> ../../docs_src/schema_extra_example/tutorial003_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="20-27"
-{!> ../../docs_src/schema_extra_example/tutorial003.py!}
-```
-
-////
+{* ../../docs_src/schema_extra_example/tutorial003_an_py310.py hl[22:29] *}
### Example in the docs UI
@@ -176,57 +92,7 @@ With any of the methods above it would look like this in the `/docs`:
You can of course also pass multiple `examples`:
-//// tab | Python 3.10+
-
-```Python hl_lines="23-38"
-{!> ../../docs_src/schema_extra_example/tutorial004_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="23-38"
-{!> ../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="24-39"
-{!> ../../docs_src/schema_extra_example/tutorial004_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="19-34"
-{!> ../../docs_src/schema_extra_example/tutorial004_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="21-36"
-{!> ../../docs_src/schema_extra_example/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/schema_extra_example/tutorial004_an_py310.py hl[23:38] *}
When you do this, the examples will be part of the internal **JSON Schema** for that body data.
@@ -267,57 +133,7 @@ Each specific example `dict` in the `examples` can contain:
You can use it like this:
-//// tab | Python 3.10+
-
-```Python hl_lines="23-49"
-{!> ../../docs_src/schema_extra_example/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="23-49"
-{!> ../../docs_src/schema_extra_example/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="24-50"
-{!> ../../docs_src/schema_extra_example/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="19-45"
-{!> ../../docs_src/schema_extra_example/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="21-47"
-{!> ../../docs_src/schema_extra_example/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/schema_extra_example/tutorial005_an_py310.py hl[23:49] *}
### OpenAPI Examples in the Docs UI
diff --git a/docs/ko/docs/tutorial/schema-extra-example.md b/docs/ko/docs/tutorial/schema-extra-example.md
index 71052b334..b713c8975 100644
--- a/docs/ko/docs/tutorial/schema-extra-example.md
+++ b/docs/ko/docs/tutorial/schema-extra-example.md
@@ -8,35 +8,15 @@
생성된 JSON 스키마에 추가될 Pydantic 모델을 위한 `examples`을 선언할 수 있습니다.
-//// tab | Python 3.10+ Pydantic v2
-
-```Python hl_lines="13-24"
-{!> ../../docs_src/schema_extra_example/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.10+ Pydantic v1
-
-```Python hl_lines="13-23"
-{!> ../../docs_src/schema_extra_example/tutorial001_py310_pv1.py!}
-```
-
-////
-
-//// tab | Python 3.8+ Pydantic v2
+//// tab | Pydantic v2
-```Python hl_lines="15-26"
-{!> ../../docs_src/schema_extra_example/tutorial001.py!}
-```
+{* ../../docs_src/schema_extra_example/tutorial001_py310.py hl[13:24] *}
////
-//// tab | Python 3.8+ Pydantic v1
+//// tab | Pydantic v1
-```Python hl_lines="15-25"
-{!> ../../docs_src/schema_extra_example/tutorial001_pv1.py!}
-```
+{* ../../docs_src/schema_extra_example/tutorial001_pv1_py310.py hl[13:23] *}
////
@@ -80,21 +60,7 @@ JSON 스키마를 확장하고 여러분의 별도의 자체 데이터를 추가
Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를 선언할 수 있습니다:
-//// tab | Python 3.10+
-
-```Python hl_lines="2 8-11"
-{!> ../../docs_src/schema_extra_example/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="4 10-13"
-{!> ../../docs_src/schema_extra_example/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/schema_extra_example/tutorial002_py310.py hl[2,8:11] *}
## JSON Schema에서의 `examples` - OpenAPI
@@ -114,57 +80,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
여기, `Body()`에 예상되는 예제 데이터 하나를 포함한 `examples`를 넘겼습니다:
-//// tab | Python 3.10+
-
-```Python hl_lines="22-29"
-{!> ../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="22-29"
-{!> ../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="23-30"
-{!> ../../docs_src/schema_extra_example/tutorial003_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ Annotated가 없는 경우
-
-/// tip | "팁"
-
-가능하다면 `Annotated`가 달린 버전을 권장합니다.
-
-///
-
-```Python hl_lines="18-25"
-{!> ../../docs_src/schema_extra_example/tutorial003_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ Annotated가 없는 경우
-
-/// tip | "팁"
-
-가능하다면 `Annotated`가 달린 버전을 권장합니다.
-
-///
-
-```Python hl_lines="20-27"
-{!> ../../docs_src/schema_extra_example/tutorial003.py!}
-```
-
-////
+{* ../../docs_src/schema_extra_example/tutorial003_an_py310.py hl[22:29] *}
### 문서 UI 예시
@@ -176,57 +92,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
물론 여러 `examples`를 넘길 수 있습니다:
-//// tab | Python 3.10+
-
-```Python hl_lines="23-38"
-{!> ../../docs_src/schema_extra_example/tutorial004_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="23-38"
-{!> ../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="24-39"
-{!> ../../docs_src/schema_extra_example/tutorial004_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ Annotated가 없는 경우
-
-/// tip | "팁"
-
-가능하다면 `Annotated`가 달린 버전을 권장합니다.
-
-///
-
-```Python hl_lines="19-34"
-{!> ../../docs_src/schema_extra_example/tutorial004_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ Annotated가 없는 경우
-
-/// tip | "팁"
-
-가능하다면 `Annotated`가 달린 버전을 권장합니다.
-
-///
-
-```Python hl_lines="21-36"
-{!> ../../docs_src/schema_extra_example/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/schema_extra_example/tutorial004_an_py310.py hl[23:38] *}
이와 같이 하면 이 예제는 그 본문 데이터를 위한 내부 **JSON 스키마**의 일부가 될 것입니다.
@@ -267,57 +133,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
이를 다음과 같이 사용할 수 있습니다:
-//// tab | Python 3.10+
-
-```Python hl_lines="23-49"
-{!> ../../docs_src/schema_extra_example/tutorial005_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="23-49"
-{!> ../../docs_src/schema_extra_example/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="24-50"
-{!> ../../docs_src/schema_extra_example/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ Annotated가 없는 경우
-
-/// tip | "팁"
-
-가능하다면 `Annotated`가 달린 버전을 권장합니다.
-
-///
-
-```Python hl_lines="19-45"
-{!> ../../docs_src/schema_extra_example/tutorial005_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ Annotated가 없는 경우
-
-/// tip | "팁"
-
-가능하다면 `Annotated`가 달린 버전을 권장합니다.
-
-///
-
-```Python hl_lines="21-47"
-{!> ../../docs_src/schema_extra_example/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/schema_extra_example/tutorial005_an_py310.py hl[23:49] *}
### 문서 UI에서의 OpenAPI 예시
diff --git a/docs_src/schema_extra_example/tutorial001_py310_pv1.py b/docs_src/schema_extra_example/tutorial001_pv1_py310.py
similarity index 100%
rename from docs_src/schema_extra_example/tutorial001_py310_pv1.py
rename to docs_src/schema_extra_example/tutorial001_pv1_py310.py
diff --git a/tests/test_tutorial/test_schema_extra_example/test_tutorial001_py310_pv1.py b/tests/test_tutorial/test_schema_extra_example/test_tutorial001_pv1_py310.py
similarity index 98%
rename from tests/test_tutorial/test_schema_extra_example/test_tutorial001_py310_pv1.py
rename to tests/test_tutorial/test_schema_extra_example/test_tutorial001_pv1_py310.py
index e036d6b68..b2a4d15b1 100644
--- a/tests/test_tutorial/test_schema_extra_example/test_tutorial001_py310_pv1.py
+++ b/tests/test_tutorial/test_schema_extra_example/test_tutorial001_pv1_py310.py
@@ -6,7 +6,7 @@ from ...utils import needs_py310, needs_pydanticv1
@pytest.fixture(name="client")
def get_client():
- from docs_src.schema_extra_example.tutorial001_py310_pv1 import app
+ from docs_src.schema_extra_example.tutorial001_pv1_py310 import app
client = TestClient(app)
return client
From aac7bbb51e04383e85933a3b37dcd3ed0113923c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 16:00:40 +0000
Subject: [PATCH 478/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 73d60c229..75fda217f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/tutorial/schema-extra-example.md`. PR [#12822](https://github.com/fastapi/fastapi/pull/12822) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes in `docs/fr/docs/advanced/additional-responses.md`. PR [#12634](https://github.com/fastapi/fastapi/pull/12634) by [@fegmorte](https://github.com/fegmorte).
* 📝 Update includes in `docs/fr/docs/advanced/path-operation-advanced-configuration.md`. PR [#12633](https://github.com/fastapi/fastapi/pull/12633) by [@kantandane](https://github.com/kantandane).
* 📝 Update includes in `docs/fr/docs/advanced/response-directly.md`. PR [#12632](https://github.com/fastapi/fastapi/pull/12632) by [@kantandane](https://github.com/kantandane).
From 5eec59fa4d68d25bd08263b5549198a24cf599f1 Mon Sep 17 00:00:00 2001
From: paintdog <paintdog@users.noreply.github.com>
Date: Sat, 9 Nov 2024 17:15:51 +0100
Subject: [PATCH 479/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/de/docs/tutorial/middleware.md`=20(#12729)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/de/docs/tutorial/middleware.md | 8 ++------
1 file changed, 2 insertions(+), 6 deletions(-)
diff --git a/docs/de/docs/tutorial/middleware.md b/docs/de/docs/tutorial/middleware.md
index 410dc0247..6bdececbc 100644
--- a/docs/de/docs/tutorial/middleware.md
+++ b/docs/de/docs/tutorial/middleware.md
@@ -31,9 +31,7 @@ Die Middleware-Funktion erhält:
* Dann gibt es die von der entsprechenden *Pfadoperation* generierte `response` zurück.
* Sie können die `response` dann weiter modifizieren, bevor Sie sie zurückgeben.
-```Python hl_lines="8-9 11 14"
-{!../../docs_src/middleware/tutorial001.py!}
-```
+{* ../../docs_src/middleware/tutorial001.py hl[8:9,11,14] *}
/// tip | "Tipp"
@@ -59,9 +57,7 @@ Und auch nachdem die `response` generiert wurde, bevor sie zurückgegeben wird.
Sie könnten beispielsweise einen benutzerdefinierten Header `X-Process-Time` hinzufügen, der die Zeit in Sekunden enthält, die benötigt wurde, um den Request zu verarbeiten und eine Response zu generieren:
-```Python hl_lines="10 12-13"
-{!../../docs_src/middleware/tutorial001.py!}
-```
+{* ../../docs_src/middleware/tutorial001.py hl[10,12:13] *}
## Andere Middlewares
From 5a7bd20316a948c6fc77492895b059592934d53c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 16:16:22 +0000
Subject: [PATCH 480/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 75fda217f..8a22dc440 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/de/docs/tutorial/middleware.md`. PR [#12729](https://github.com/fastapi/fastapi/pull/12729) by [@paintdog](https://github.com/paintdog).
* 📝 Update includes for `docs/en/docs/tutorial/schema-extra-example.md`. PR [#12822](https://github.com/fastapi/fastapi/pull/12822) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes in `docs/fr/docs/advanced/additional-responses.md`. PR [#12634](https://github.com/fastapi/fastapi/pull/12634) by [@fegmorte](https://github.com/fegmorte).
* 📝 Update includes in `docs/fr/docs/advanced/path-operation-advanced-configuration.md`. PR [#12633](https://github.com/fastapi/fastapi/pull/12633) by [@kantandane](https://github.com/kantandane).
From a86d2bbf4f02d379f9ab0683b3402ddbb2d56fbd Mon Sep 17 00:00:00 2001
From: Hamid Rasti <43915620+hamidrasti@users.noreply.github.com>
Date: Sat, 9 Nov 2024 19:47:10 +0330
Subject: [PATCH 481/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/advanced/wsgi.md`=20(#12758)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/wsgi.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
diff --git a/docs/en/docs/advanced/wsgi.md b/docs/en/docs/advanced/wsgi.md
index 3974d491c..296eb1364 100644
--- a/docs/en/docs/advanced/wsgi.md
+++ b/docs/en/docs/advanced/wsgi.md
@@ -12,9 +12,7 @@ Then wrap the WSGI (e.g. Flask) app with the middleware.
And then mount that under a path.
-```Python hl_lines="2-3 23"
-{!../../docs_src/wsgi/tutorial001.py!}
-```
+{* ../../docs_src/wsgi/tutorial001.py hl[2:3,3] *}
## Check it
From 8a560758f886e6c24737163ce5c38d5c3ce3c625 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 16:18:19 +0000
Subject: [PATCH 482/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8a22dc440..fe975e6a2 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/advanced/wsgi.md`. PR [#12758](https://github.com/fastapi/fastapi/pull/12758) by [@hamidrasti](https://github.com/hamidrasti).
* 📝 Update includes in `docs/de/docs/tutorial/middleware.md`. PR [#12729](https://github.com/fastapi/fastapi/pull/12729) by [@paintdog](https://github.com/paintdog).
* 📝 Update includes for `docs/en/docs/tutorial/schema-extra-example.md`. PR [#12822](https://github.com/fastapi/fastapi/pull/12822) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes in `docs/fr/docs/advanced/additional-responses.md`. PR [#12634](https://github.com/fastapi/fastapi/pull/12634) by [@fegmorte](https://github.com/fegmorte).
From 2d45b54f10e69dd63939ec2f979f1eb9e87d4e4c Mon Sep 17 00:00:00 2001
From: Hamid Rasti <43915620+hamidrasti@users.noreply.github.com>
Date: Sat, 9 Nov 2024 19:48:55 +0330
Subject: [PATCH 483/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/advanced/using-request-directly.md`=20(#12760)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/using-request-directly.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
diff --git a/docs/en/docs/advanced/using-request-directly.md b/docs/en/docs/advanced/using-request-directly.md
index 917d77a95..3e35734bc 100644
--- a/docs/en/docs/advanced/using-request-directly.md
+++ b/docs/en/docs/advanced/using-request-directly.md
@@ -29,9 +29,7 @@ Let's imagine you want to get the client's IP address/host inside of your *path
For that you need to access the request directly.
-```Python hl_lines="1 7-8"
-{!../../docs_src/using_request_directly/tutorial001.py!}
-```
+{* ../../docs_src/using_request_directly/tutorial001.py hl[1,7:8] *}
By declaring a *path operation function* parameter with the type being the `Request` **FastAPI** will know to pass the `Request` in that parameter.
From 18ca10cee4230547b3a46b0f7db32d71bece5cc4 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 16:19:17 +0000
Subject: [PATCH 484/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fe975e6a2..85129304d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/advanced/using-request-directly.md`. PR [#12760](https://github.com/fastapi/fastapi/pull/12760) by [@hamidrasti](https://github.com/hamidrasti).
* 📝 Update includes for `docs/advanced/wsgi.md`. PR [#12758](https://github.com/fastapi/fastapi/pull/12758) by [@hamidrasti](https://github.com/hamidrasti).
* 📝 Update includes in `docs/de/docs/tutorial/middleware.md`. PR [#12729](https://github.com/fastapi/fastapi/pull/12729) by [@paintdog](https://github.com/paintdog).
* 📝 Update includes for `docs/en/docs/tutorial/schema-extra-example.md`. PR [#12822](https://github.com/fastapi/fastapi/pull/12822) by [@tiangolo](https://github.com/tiangolo).
From 52e8ea4c97ca35744e0c1511856182a6aa609ec7 Mon Sep 17 00:00:00 2001
From: Hamid Rasti <43915620+hamidrasti@users.noreply.github.com>
Date: Sat, 9 Nov 2024 19:49:46 +0330
Subject: [PATCH 485/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/advanced/testing-websockets.md`=20(#12761)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/testing-websockets.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
diff --git a/docs/en/docs/advanced/testing-websockets.md b/docs/en/docs/advanced/testing-websockets.md
index ab08c90fe..60dfdc343 100644
--- a/docs/en/docs/advanced/testing-websockets.md
+++ b/docs/en/docs/advanced/testing-websockets.md
@@ -4,9 +4,7 @@ You can use the same `TestClient` to test WebSockets.
For this, you use the `TestClient` in a `with` statement, connecting to the WebSocket:
-```Python hl_lines="27-31"
-{!../../docs_src/app_testing/tutorial002.py!}
-```
+{* ../../docs_src/app_testing/tutorial002.py hl[27:31] *}
/// note
From 5e21dddb9367259d073c10af588cdb476b739f1b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 16:21:37 +0000
Subject: [PATCH 486/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 85129304d..6ca16a982 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/advanced/testing-websockets.md`. PR [#12761](https://github.com/fastapi/fastapi/pull/12761) by [@hamidrasti](https://github.com/hamidrasti).
* 📝 Update includes for `docs/en/docs/advanced/using-request-directly.md`. PR [#12760](https://github.com/fastapi/fastapi/pull/12760) by [@hamidrasti](https://github.com/hamidrasti).
* 📝 Update includes for `docs/advanced/wsgi.md`. PR [#12758](https://github.com/fastapi/fastapi/pull/12758) by [@hamidrasti](https://github.com/hamidrasti).
* 📝 Update includes in `docs/de/docs/tutorial/middleware.md`. PR [#12729](https://github.com/fastapi/fastapi/pull/12729) by [@paintdog](https://github.com/paintdog).
From ac9f4517f00709a8b7182d3b4e5401f37f15b638 Mon Sep 17 00:00:00 2001
From: Zhaohan Dong <65422392+zhaohan-dong@users.noreply.github.com>
Date: Sat, 9 Nov 2024 16:25:01 +0000
Subject: [PATCH 487/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/path-params-numeric-validations.md`?=
=?UTF-8?q?=20(#12825)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../path-params-numeric-validations.md | 234 +-----------------
1 file changed, 9 insertions(+), 225 deletions(-)
diff --git a/docs/en/docs/tutorial/path-params-numeric-validations.md b/docs/en/docs/tutorial/path-params-numeric-validations.md
index 9ddf49ea9..dc13a513c 100644
--- a/docs/en/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/en/docs/tutorial/path-params-numeric-validations.md
@@ -6,57 +6,7 @@ In the same way that you can declare more validations and metadata for query par
First, import `Path` from `fastapi`, and import `Annotated`:
-//// tab | Python 3.10+
-
-```Python hl_lines="1 3"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="1 3"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="3-4"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="1"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="3"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[1,3] *}
/// info
@@ -74,57 +24,7 @@ You can declare all the same parameters as for `Query`.
For example, to declare a `title` metadata value for the path parameter `item_id` you can type:
-//// tab | Python 3.10+
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="11"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="8"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[10] *}
/// note
@@ -162,29 +62,13 @@ Prefer to use the `Annotated` version if possible.
///
-```Python hl_lines="7"
-{!> ../../docs_src/path_params_numeric_validations/tutorial002.py!}
-```
+{* ../../docs_src/path_params_numeric_validations/tutorial002.py hl[7] *}
////
But keep in mind that if you use `Annotated`, you won't have this problem, it won't matter as you're not using the function parameter default values for `Query()` or `Path()`.
-//// tab | Python 3.9+
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9"
-{!> ../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py *}
## Order the parameters as you need, tricks
@@ -209,29 +93,13 @@ Pass `*`, as the first parameter of the function.
Python won't do anything with that `*`, but it will know that all the following parameters should be called as keyword arguments (key-value pairs), also known as <abbr title="From: K-ey W-ord Arg-uments"><code>kwargs</code></abbr>. Even if they don't have a default value.
-```Python hl_lines="7"
-{!../../docs_src/path_params_numeric_validations/tutorial003.py!}
-```
+{* ../../docs_src/path_params_numeric_validations/tutorial003.py hl[7] *}
### Better with `Annotated`
Keep in mind that if you use `Annotated`, as you are not using function parameter default values, you won't have this problem, and you probably won't need to use `*`.
-//// tab | Python 3.9+
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9"
-{!> ../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py hl[10] *}
## Number validations: greater than or equal
@@ -239,35 +107,7 @@ With `Query` and `Path` (and others you'll see later) you can declare number con
Here, with `ge=1`, `item_id` will need to be an integer number "`g`reater than or `e`qual" to `1`.
-//// tab | Python 3.9+
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9"
-{!> ../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="8"
-{!> ../../docs_src/path_params_numeric_validations/tutorial004.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py hl[10] *}
## Number validations: greater than and less than or equal
@@ -276,35 +116,7 @@ The same applies for:
* `gt`: `g`reater `t`han
* `le`: `l`ess than or `e`qual
-//// tab | Python 3.9+
-
-```Python hl_lines="10"
-{!> ../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9"
-{!> ../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="9"
-{!> ../../docs_src/path_params_numeric_validations/tutorial005.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py hl[10] *}
## Number validations: floats, greater than and less than
@@ -316,35 +128,7 @@ So, `0.5` would be a valid value. But `0.0` or `0` would not.
And the same for <abbr title="less than"><code>lt</code></abbr>.
-//// tab | Python 3.9+
-
-```Python hl_lines="13"
-{!> ../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="12"
-{!> ../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="11"
-{!> ../../docs_src/path_params_numeric_validations/tutorial006.py!}
-```
-
-////
+{* ../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py hl[13] *}
## Recap
From e5d00910d63674ded70aebab8f366cfa8f4a5fd6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 16:28:06 +0000
Subject: [PATCH 488/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6ca16a982..37ad0fc5c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/tutorial/path-params-numeric-validations.md`. PR [#12825](https://github.com/fastapi/fastapi/pull/12825) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes for `docs/en/docs/advanced/testing-websockets.md`. PR [#12761](https://github.com/fastapi/fastapi/pull/12761) by [@hamidrasti](https://github.com/hamidrasti).
* 📝 Update includes for `docs/en/docs/advanced/using-request-directly.md`. PR [#12760](https://github.com/fastapi/fastapi/pull/12760) by [@hamidrasti](https://github.com/hamidrasti).
* 📝 Update includes for `docs/advanced/wsgi.md`. PR [#12758](https://github.com/fastapi/fastapi/pull/12758) by [@hamidrasti](https://github.com/hamidrasti).
From e812f872766bc576136936ebae7422d230ddb89c Mon Sep 17 00:00:00 2001
From: Zhaohan Dong <65422392+zhaohan-dong@users.noreply.github.com>
Date: Sat, 9 Nov 2024 16:29:26 +0000
Subject: [PATCH 489/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/zh/docs/advanced/additional-responses.md`=20(#12828)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/zh/docs/advanced/additional-responses.md | 16 ++++------------
1 file changed, 4 insertions(+), 12 deletions(-)
diff --git a/docs/zh/docs/advanced/additional-responses.md b/docs/zh/docs/advanced/additional-responses.md
index f051b12a4..362ef9460 100644
--- a/docs/zh/docs/advanced/additional-responses.md
+++ b/docs/zh/docs/advanced/additional-responses.md
@@ -16,9 +16,7 @@
**FastAPI**将采用该模型，生成其`JSON Schema`并将其包含在`OpenAPI`中的正确位置。
例如，要声明另一个具有状态码 `404` 和`Pydantic`模型 `Message` 的响应，可以写：
-```Python hl_lines="18 22"
-{!../../docs_src/additional_responses/tutorial001.py!}
-```
+{* ../../docs_src/additional_responses/tutorial001.py hl[18,22] *}
/// note
@@ -163,9 +161,7 @@
例如，您可以添加一个额外的媒体类型` image/png` ，声明您的路径操作可以返回JSON对象（媒体类型 `application/json` ）或PNG图像：
-```Python hl_lines="19-24 28"
-{!../../docs_src/additional_responses/tutorial002.py!}
-```
+{* ../../docs_src/additional_responses/tutorial002.py hl[19:24,28] *}
/// note
@@ -191,9 +187,7 @@
以及一个状态码为 `200` 的响应，它使用您的 `response_model` ，但包含自定义的 `example` ：
-```Python hl_lines="20-31"
-{!../../docs_src/additional_responses/tutorial003.py!}
-```
+{* ../../docs_src/additional_responses/tutorial003.py hl[20:31] *}
所有这些都将被合并并包含在您的OpenAPI中，并在API文档中显示：
@@ -219,9 +213,7 @@ new_dict = {**old_dict, "new key": "new value"}
```
您可以使用该技术在路径操作中重用一些预定义的响应，并将它们与其他自定义响应相结合。
**例如：**
-```Python hl_lines="13-17 26"
-{!../../docs_src/additional_responses/tutorial004.py!}
-```
+{* ../../docs_src/additional_responses/tutorial004.py hl[13:17,26] *}
## 有关OpenAPI响应的更多信息
要了解您可以在响应中包含哪些内容，您可以查看OpenAPI规范中的以下部分：
From d08c4cffabc11b5232bfc125acc251448d8a408c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 16:34:56 +0000
Subject: [PATCH 490/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 37ad0fc5c..fa66930fc 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/zh/docs/advanced/additional-responses.md`. PR [#12828](https://github.com/fastapi/fastapi/pull/12828) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/tutorial/path-params-numeric-validations.md`. PR [#12825](https://github.com/fastapi/fastapi/pull/12825) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes for `docs/en/docs/advanced/testing-websockets.md`. PR [#12761](https://github.com/fastapi/fastapi/pull/12761) by [@hamidrasti](https://github.com/hamidrasti).
* 📝 Update includes for `docs/en/docs/advanced/using-request-directly.md`. PR [#12760](https://github.com/fastapi/fastapi/pull/12760) by [@hamidrasti](https://github.com/hamidrasti).
From 7fb9c5922d6a01a8c38f92101515cb7baa0cdcf4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 9 Nov 2024 17:39:20 +0100
Subject: [PATCH 491/504] =?UTF-8?q?=F0=9F=93=9D=20Fix=20admonition=20doubl?=
=?UTF-8?q?e=20quotes=20with=20new=20syntax=20(#12835)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
docs/de/docs/advanced/additional-responses.md | 6 +-
.../docs/advanced/additional-status-codes.md | 8 +-
.../de/docs/advanced/advanced-dependencies.md | 10 +--
docs/de/docs/advanced/async-tests.md | 8 +-
docs/de/docs/advanced/behind-a-proxy.md | 14 ++--
docs/de/docs/advanced/custom-response.md | 16 ++--
docs/de/docs/advanced/events.md | 6 +-
docs/de/docs/advanced/generate-clients.md | 2 +-
docs/de/docs/advanced/index.md | 2 +-
docs/de/docs/advanced/middleware.md | 2 +-
docs/de/docs/advanced/openapi-callbacks.md | 10 +--
.../path-operation-advanced-configuration.md | 12 +--
docs/de/docs/advanced/response-cookies.md | 4 +-
docs/de/docs/advanced/response-directly.md | 4 +-
docs/de/docs/advanced/response-headers.md | 2 +-
docs/de/docs/advanced/security/index.md | 2 +-
.../docs/advanced/security/oauth2-scopes.md | 60 +++++++--------
docs/de/docs/advanced/settings.md | 28 +++----
docs/de/docs/advanced/templates.md | 6 +-
docs/de/docs/advanced/testing-dependencies.md | 8 +-
docs/de/docs/advanced/testing-websockets.md | 2 +-
.../docs/advanced/using-request-directly.md | 4 +-
docs/de/docs/advanced/websockets.md | 10 +--
docs/de/docs/alternatives.md | 40 +++++-----
docs/de/docs/async.md | 2 +-
docs/de/docs/contributing.md | 18 ++---
docs/de/docs/deployment/concepts.md | 8 +-
docs/de/docs/deployment/docker.md | 16 ++--
docs/de/docs/deployment/https.md | 6 +-
docs/de/docs/deployment/manually.md | 4 +-
docs/de/docs/deployment/versions.md | 4 +-
docs/de/docs/help-fastapi.md | 2 +-
docs/de/docs/how-to/custom-docs-ui-assets.md | 4 +-
.../docs/how-to/custom-request-and-route.md | 8 +-
docs/de/docs/how-to/graphql.md | 4 +-
docs/de/docs/how-to/index.md | 2 +-
docs/de/docs/python-types.md | 10 +--
docs/de/docs/tutorial/background-tasks.md | 4 +-
docs/de/docs/tutorial/bigger-applications.md | 20 ++---
docs/de/docs/tutorial/body-fields.md | 16 ++--
docs/de/docs/tutorial/body-multiple-params.md | 4 +-
docs/de/docs/tutorial/body-nested-models.md | 2 +-
docs/de/docs/tutorial/body-updates.md | 6 +-
docs/de/docs/tutorial/body.md | 4 +-
docs/de/docs/tutorial/cookie-params.md | 10 +--
.../dependencies/classes-as-dependencies.md | 42 +++++------
...pendencies-in-path-operation-decorators.md | 10 +--
.../dependencies/dependencies-with-yield.md | 26 +++----
.../dependencies/global-dependencies.md | 2 +-
docs/de/docs/tutorial/dependencies/index.md | 18 ++---
.../tutorial/dependencies/sub-dependencies.md | 16 ++--
docs/de/docs/tutorial/encoder.md | 2 +-
docs/de/docs/tutorial/extra-models.md | 6 +-
docs/de/docs/tutorial/first-steps.md | 10 +--
docs/de/docs/tutorial/handling-errors.md | 8 +-
docs/de/docs/tutorial/header-params.md | 22 +++---
docs/de/docs/tutorial/index.md | 2 +-
docs/de/docs/tutorial/metadata.md | 4 +-
docs/de/docs/tutorial/middleware.md | 6 +-
.../tutorial/path-operation-configuration.md | 4 +-
.../path-params-numeric-validations.md | 24 +++---
docs/de/docs/tutorial/path-params.md | 6 +-
.../tutorial/query-params-str-validations.md | 68 ++++++++---------
docs/de/docs/tutorial/query-params.md | 2 +-
docs/de/docs/tutorial/request-files.md | 32 ++++----
.../docs/tutorial/request-forms-and-files.md | 6 +-
docs/de/docs/tutorial/request-forms.md | 10 +--
docs/de/docs/tutorial/response-model.md | 12 +--
docs/de/docs/tutorial/response-status-code.md | 10 +--
docs/de/docs/tutorial/schema-extra-example.md | 6 +-
docs/de/docs/tutorial/security/first-steps.md | 14 ++--
.../tutorial/security/get-current-user.md | 24 +++---
docs/de/docs/tutorial/security/index.md | 4 +-
docs/de/docs/tutorial/security/oauth2-jwt.md | 26 +++----
.../docs/tutorial/security/simple-oauth2.md | 28 +++----
docs/de/docs/tutorial/static-files.md | 2 +-
docs/de/docs/tutorial/testing.md | 10 +--
.../docs/advanced/additional-status-codes.md | 2 +-
docs/em/docs/advanced/behind-a-proxy.md | 2 +-
docs/em/docs/advanced/custom-response.md | 2 +-
docs/em/docs/advanced/middleware.md | 2 +-
.../path-operation-advanced-configuration.md | 2 +-
docs/em/docs/advanced/response-cookies.md | 2 +-
docs/em/docs/advanced/response-directly.md | 2 +-
docs/em/docs/advanced/response-headers.md | 2 +-
.../docs/advanced/security/oauth2-scopes.md | 2 +-
docs/em/docs/advanced/templates.md | 2 +-
.../docs/advanced/using-request-directly.md | 2 +-
docs/em/docs/advanced/websockets.md | 2 +-
docs/em/docs/alternatives.md | 38 +++++-----
.../docs/how-to/custom-request-and-route.md | 2 +-
docs/em/docs/tutorial/bigger-applications.md | 4 +-
docs/em/docs/tutorial/body-fields.md | 2 +-
docs/em/docs/tutorial/cookie-params.md | 2 +-
docs/em/docs/tutorial/cors.md | 2 +-
.../dependencies/dependencies-with-yield.md | 4 +-
docs/em/docs/tutorial/first-steps.md | 4 +-
docs/em/docs/tutorial/handling-errors.md | 4 +-
docs/em/docs/tutorial/header-params.md | 2 +-
docs/em/docs/tutorial/middleware.md | 4 +-
.../tutorial/path-operation-configuration.md | 2 +-
.../path-params-numeric-validations.md | 2 +-
docs/em/docs/tutorial/request-files.md | 8 +-
docs/em/docs/tutorial/request-forms.md | 2 +-
docs/em/docs/tutorial/response-status-code.md | 2 +-
docs/em/docs/tutorial/security/first-steps.md | 4 +-
docs/em/docs/tutorial/sql-databases.md | 6 +-
docs/em/docs/tutorial/static-files.md | 2 +-
docs/em/docs/tutorial/testing.md | 2 +-
.../docs/advanced/additional-status-codes.md | 2 +-
docs/en/docs/advanced/behind-a-proxy.md | 2 +-
docs/en/docs/advanced/custom-response.md | 2 +-
docs/en/docs/advanced/middleware.md | 2 +-
.../path-operation-advanced-configuration.md | 2 +-
docs/en/docs/advanced/response-cookies.md | 2 +-
docs/en/docs/advanced/response-directly.md | 2 +-
docs/en/docs/advanced/response-headers.md | 2 +-
.../docs/advanced/security/oauth2-scopes.md | 2 +-
docs/en/docs/advanced/templates.md | 2 +-
.../docs/advanced/using-request-directly.md | 2 +-
docs/en/docs/advanced/websockets.md | 2 +-
docs/en/docs/alternatives.md | 38 +++++-----
docs/en/docs/contributing.md | 2 +-
.../docs/how-to/custom-request-and-route.md | 2 +-
docs/en/docs/management-tasks.md | 4 +-
docs/en/docs/tutorial/bigger-applications.md | 4 +-
docs/en/docs/tutorial/body-fields.md | 2 +-
docs/en/docs/tutorial/cookie-params.md | 2 +-
docs/en/docs/tutorial/cors.md | 2 +-
.../dependencies/dependencies-with-yield.md | 4 +-
docs/en/docs/tutorial/first-steps.md | 4 +-
docs/en/docs/tutorial/handling-errors.md | 4 +-
docs/en/docs/tutorial/header-params.md | 2 +-
docs/en/docs/tutorial/middleware.md | 4 +-
.../tutorial/path-operation-configuration.md | 2 +-
.../path-params-numeric-validations.md | 2 +-
docs/en/docs/tutorial/request-files.md | 8 +-
docs/en/docs/tutorial/request-forms.md | 2 +-
docs/en/docs/tutorial/response-status-code.md | 2 +-
docs/en/docs/tutorial/security/first-steps.md | 4 +-
docs/en/docs/tutorial/static-files.md | 2 +-
docs/en/docs/tutorial/testing.md | 2 +-
.../path-operation-advanced-configuration.md | 2 +-
docs/es/docs/tutorial/cookie-params.md | 2 +-
docs/es/docs/tutorial/index.md | 2 +-
docs/fa/docs/tutorial/middleware.md | 4 +-
docs/fr/docs/advanced/additional-responses.md | 6 +-
.../docs/advanced/additional-status-codes.md | 4 +-
docs/fr/docs/advanced/index.md | 2 +-
.../path-operation-advanced-configuration.md | 12 +--
docs/fr/docs/advanced/response-directly.md | 4 +-
docs/fr/docs/alternatives.md | 38 +++++-----
docs/fr/docs/async.md | 2 +-
docs/fr/docs/deployment/docker.md | 2 +-
docs/fr/docs/deployment/manually.md | 2 +-
docs/fr/docs/deployment/versions.md | 4 +-
docs/fr/docs/python-types.md | 2 +-
docs/fr/docs/tutorial/body.md | 2 +-
docs/fr/docs/tutorial/first-steps.md | 6 +-
.../path-params-numeric-validations.md | 2 +-
docs/fr/docs/tutorial/path-params.md | 12 +--
.../tutorial/query-params-str-validations.md | 4 +-
docs/fr/docs/tutorial/query-params.md | 4 +-
docs/id/docs/tutorial/index.md | 2 +-
.../docs/advanced/additional-status-codes.md | 4 +-
docs/ja/docs/advanced/custom-response.md | 22 +++---
docs/ja/docs/advanced/index.md | 2 +-
.../path-operation-advanced-configuration.md | 6 +-
docs/ja/docs/advanced/response-directly.md | 4 +-
docs/ja/docs/advanced/websockets.md | 8 +-
docs/ja/docs/alternatives.md | 50 ++++++-------
docs/ja/docs/async.md | 4 +-
docs/ja/docs/contributing.md | 12 +--
docs/ja/docs/deployment/manually.md | 2 +-
docs/ja/docs/deployment/versions.md | 4 +-
docs/ja/docs/features.md | 2 +-
docs/ja/docs/python-types.md | 8 +-
docs/ja/docs/tutorial/body-fields.md | 6 +-
docs/ja/docs/tutorial/body-multiple-params.md | 6 +-
docs/ja/docs/tutorial/body-nested-models.md | 6 +-
docs/ja/docs/tutorial/body-updates.md | 6 +-
docs/ja/docs/tutorial/body.md | 6 +-
docs/ja/docs/tutorial/cookie-params.md | 4 +-
docs/ja/docs/tutorial/cors.md | 2 +-
docs/ja/docs/tutorial/debugging.md | 2 +-
.../dependencies/classes-as-dependencies.md | 2 +-
...pendencies-in-path-operation-decorators.md | 2 +-
.../dependencies/dependencies-with-yield.md | 20 ++---
docs/ja/docs/tutorial/dependencies/index.md | 6 +-
.../tutorial/dependencies/sub-dependencies.md | 4 +-
docs/ja/docs/tutorial/encoder.md | 2 +-
docs/ja/docs/tutorial/extra-models.md | 4 +-
docs/ja/docs/tutorial/first-steps.md | 12 +--
docs/ja/docs/tutorial/handling-errors.md | 8 +-
docs/ja/docs/tutorial/header-params.md | 6 +-
docs/ja/docs/tutorial/index.md | 2 +-
docs/ja/docs/tutorial/metadata.md | 4 +-
docs/ja/docs/tutorial/middleware.md | 6 +-
.../tutorial/path-operation-configuration.md | 8 +-
.../path-params-numeric-validations.md | 6 +-
docs/ja/docs/tutorial/path-params.md | 16 ++--
.../tutorial/query-params-str-validations.md | 14 ++--
docs/ja/docs/tutorial/query-params.md | 4 +-
.../docs/tutorial/request-forms-and-files.md | 4 +-
docs/ja/docs/tutorial/request-forms.md | 10 +--
docs/ja/docs/tutorial/response-model.md | 16 ++--
docs/ja/docs/tutorial/response-status-code.md | 12 +--
docs/ja/docs/tutorial/schema-extra-example.md | 2 +-
docs/ja/docs/tutorial/security/first-steps.md | 14 ++--
.../tutorial/security/get-current-user.md | 4 +-
docs/ja/docs/tutorial/security/index.md | 4 +-
docs/ja/docs/tutorial/security/oauth2-jwt.md | 12 +--
docs/ja/docs/tutorial/static-files.md | 2 +-
docs/ja/docs/tutorial/testing.md | 8 +-
docs/ko/docs/advanced/events.md | 8 +-
docs/ko/docs/advanced/index.md | 2 +-
docs/ko/docs/advanced/response-cookies.md | 2 +-
docs/ko/docs/advanced/response-directly.md | 2 +-
docs/ko/docs/advanced/response-headers.md | 2 +-
docs/ko/docs/async.md | 4 +-
docs/ko/docs/deployment/docker.md | 20 ++---
docs/ko/docs/deployment/server-workers.md | 2 +-
docs/ko/docs/deployment/versions.md | 4 +-
docs/ko/docs/environment-variables.md | 6 +-
docs/ko/docs/features.md | 2 +-
docs/ko/docs/python-types.md | 8 +-
docs/ko/docs/tutorial/body-fields.md | 16 ++--
docs/ko/docs/tutorial/body-multiple-params.md | 6 +-
docs/ko/docs/tutorial/body-nested-models.md | 6 +-
docs/ko/docs/tutorial/body.md | 6 +-
docs/ko/docs/tutorial/cookie-params.md | 12 +--
docs/ko/docs/tutorial/cors.md | 2 +-
docs/ko/docs/tutorial/debugging.md | 2 +-
.../dependencies/classes-as-dependencies.md | 2 +-
...pendencies-in-path-operation-decorators.md | 12 +--
.../dependencies/global-dependencies.md | 2 +-
docs/ko/docs/tutorial/dependencies/index.md | 22 +++---
docs/ko/docs/tutorial/encoder.md | 2 +-
docs/ko/docs/tutorial/first-steps.md | 12 +--
docs/ko/docs/tutorial/header-params.md | 6 +-
docs/ko/docs/tutorial/index.md | 2 +-
docs/ko/docs/tutorial/middleware.md | 6 +-
.../tutorial/path-operation-configuration.md | 8 +-
.../path-params-numeric-validations.md | 6 +-
docs/ko/docs/tutorial/path-params.md | 16 ++--
.../tutorial/query-params-str-validations.md | 14 ++--
docs/ko/docs/tutorial/query-params.md | 6 +-
docs/ko/docs/tutorial/request-files.md | 16 ++--
.../docs/tutorial/request-forms-and-files.md | 4 +-
docs/ko/docs/tutorial/response-model.md | 16 ++--
docs/ko/docs/tutorial/response-status-code.md | 12 +--
docs/ko/docs/tutorial/schema-extra-example.md | 12 +--
.../tutorial/security/get-current-user.md | 4 +-
docs/ko/docs/tutorial/static-files.md | 2 +-
docs/pl/docs/help-fastapi.md | 2 +-
docs/pl/docs/tutorial/first-steps.md | 4 +-
docs/pt/docs/advanced/additional-responses.md | 10 +--
.../docs/advanced/additional-status-codes.md | 8 +-
.../pt/docs/advanced/advanced-dependencies.md | 10 +--
docs/pt/docs/advanced/async-tests.md | 8 +-
docs/pt/docs/advanced/behind-a-proxy.md | 14 ++--
docs/pt/docs/advanced/events.md | 10 +--
docs/pt/docs/advanced/index.md | 2 +-
docs/pt/docs/advanced/openapi-webhooks.md | 4 +-
docs/pt/docs/advanced/response-cookies.md | 2 +-
docs/pt/docs/advanced/response-headers.md | 2 +-
.../docs/advanced/security/http-basic-auth.md | 6 +-
docs/pt/docs/advanced/security/index.md | 2 +-
.../docs/advanced/security/oauth2-scopes.md | 6 +-
docs/pt/docs/advanced/templates.md | 4 +-
docs/pt/docs/advanced/testing-dependencies.md | 8 +-
docs/pt/docs/advanced/testing-websockets.md | 2 +-
.../docs/advanced/using-request-directly.md | 4 +-
docs/pt/docs/alternatives.md | 40 +++++-----
docs/pt/docs/deployment/concepts.md | 8 +-
docs/pt/docs/deployment/docker.md | 2 +-
docs/pt/docs/deployment/https.md | 2 +-
docs/pt/docs/deployment/manually.md | 6 +-
docs/pt/docs/deployment/server-workers.md | 2 +-
docs/pt/docs/deployment/versions.md | 4 +-
docs/pt/docs/environment-variables.md | 6 +-
docs/pt/docs/help-fastapi.md | 2 +-
docs/pt/docs/how-to/graphql.md | 4 +-
docs/pt/docs/tutorial/bigger-applications.md | 26 +++----
docs/pt/docs/tutorial/body-fields.md | 6 +-
docs/pt/docs/tutorial/body-multiple-params.md | 6 +-
docs/pt/docs/tutorial/body-nested-models.md | 6 +-
docs/pt/docs/tutorial/body.md | 6 +-
docs/pt/docs/tutorial/cors.md | 2 +-
docs/pt/docs/tutorial/debugging.md | 2 +-
.../dependencies/classes-as-dependencies.md | 42 +++++------
...pendencies-in-path-operation-decorators.md | 12 +--
.../dependencies/dependencies-with-yield.md | 32 ++++----
.../dependencies/global-dependencies.md | 2 +-
docs/pt/docs/tutorial/dependencies/index.md | 22 +++---
.../tutorial/dependencies/sub-dependencies.md | 18 ++---
docs/pt/docs/tutorial/encoder.md | 2 +-
docs/pt/docs/tutorial/first-steps.md | 12 +--
docs/pt/docs/tutorial/handling-errors.md | 8 +-
docs/pt/docs/tutorial/header-params.md | 4 +-
docs/pt/docs/tutorial/index.md | 2 +-
docs/pt/docs/tutorial/middleware.md | 6 +-
.../tutorial/path-operation-configuration.md | 6 +-
.../path-params-numeric-validations.md | 6 +-
docs/pt/docs/tutorial/path-params.md | 16 ++--
.../tutorial/query-params-str-validations.md | 14 ++--
docs/pt/docs/tutorial/query-params.md | 4 +-
docs/pt/docs/tutorial/request-files.md | 6 +-
docs/pt/docs/tutorial/request-form-models.md | 8 +-
.../docs/tutorial/request-forms-and-files.md | 4 +-
docs/pt/docs/tutorial/request-forms.md | 10 +--
docs/pt/docs/tutorial/response-status-code.md | 12 +--
docs/pt/docs/tutorial/schema-extra-example.md | 6 +-
docs/pt/docs/tutorial/security/first-steps.md | 14 ++--
docs/pt/docs/tutorial/security/index.md | 4 +-
docs/pt/docs/tutorial/static-files.md | 2 +-
docs/pt/docs/tutorial/testing.md | 14 ++--
docs/pt/docs/virtual-environments.md | 38 +++++-----
docs/ru/docs/alternatives.md | 50 ++++++-------
docs/ru/docs/contributing.md | 12 +--
docs/ru/docs/deployment/concepts.md | 8 +-
docs/ru/docs/deployment/docker.md | 20 ++---
docs/ru/docs/deployment/https.md | 6 +-
docs/ru/docs/deployment/manually.md | 4 +-
docs/ru/docs/deployment/versions.md | 4 +-
docs/ru/docs/features.md | 2 +-
docs/ru/docs/help-fastapi.md | 4 +-
docs/ru/docs/tutorial/body-fields.md | 8 +-
docs/ru/docs/tutorial/body-multiple-params.md | 22 +++---
docs/ru/docs/tutorial/body-nested-models.md | 6 +-
docs/ru/docs/tutorial/body-updates.md | 6 +-
docs/ru/docs/tutorial/body.md | 6 +-
docs/ru/docs/tutorial/cookie-params.md | 4 +-
docs/ru/docs/tutorial/cors.md | 2 +-
docs/ru/docs/tutorial/debugging.md | 2 +-
.../dependencies/classes-as-dependencies.md | 42 +++++------
.../dependencies/dependencies-with-yield.md | 26 +++----
.../dependencies/global-dependencies.md | 2 +-
docs/ru/docs/tutorial/dependencies/index.md | 22 +++---
.../tutorial/dependencies/sub-dependencies.md | 18 ++---
docs/ru/docs/tutorial/encoder.md | 2 +-
docs/ru/docs/tutorial/extra-models.md | 6 +-
docs/ru/docs/tutorial/first-steps.md | 12 +--
docs/ru/docs/tutorial/handling-errors.md | 8 +-
docs/ru/docs/tutorial/header-params.md | 24 +++---
docs/ru/docs/tutorial/index.md | 2 +-
docs/ru/docs/tutorial/metadata.md | 6 +-
.../tutorial/path-operation-configuration.md | 8 +-
.../path-params-numeric-validations.md | 28 +++----
docs/ru/docs/tutorial/path-params.md | 16 ++--
.../tutorial/query-params-str-validations.md | 74 +++++++++----------
docs/ru/docs/tutorial/query-params.md | 4 +-
docs/ru/docs/tutorial/request-files.md | 36 ++++-----
.../docs/tutorial/request-forms-and-files.md | 8 +-
docs/ru/docs/tutorial/request-forms.md | 14 ++--
docs/ru/docs/tutorial/response-model.md | 18 ++---
docs/ru/docs/tutorial/response-status-code.md | 12 +--
docs/ru/docs/tutorial/security/first-steps.md | 20 ++---
docs/ru/docs/tutorial/security/index.md | 4 +-
docs/ru/docs/tutorial/static-files.md | 2 +-
docs/ru/docs/tutorial/testing.md | 14 ++--
docs/tr/docs/advanced/index.md | 2 +-
docs/tr/docs/advanced/security/index.md | 2 +-
docs/tr/docs/advanced/testing-websockets.md | 2 +-
docs/tr/docs/alternatives.md | 50 ++++++-------
docs/tr/docs/async.md | 2 +-
docs/tr/docs/how-to/index.md | 2 +-
docs/tr/docs/python-types.md | 4 +-
docs/tr/docs/tutorial/cookie-params.md | 12 +--
docs/tr/docs/tutorial/first-steps.md | 12 +--
docs/tr/docs/tutorial/path-params.md | 16 ++--
docs/tr/docs/tutorial/query-params.md | 4 +-
docs/tr/docs/tutorial/request-forms.md | 10 +--
docs/tr/docs/tutorial/static-files.md | 2 +-
docs/uk/docs/alternatives.md | 50 ++++++-------
docs/uk/docs/tutorial/body-fields.md | 2 +-
docs/uk/docs/tutorial/cookie-params.md | 2 +-
docs/uk/docs/tutorial/encoder.md | 2 +-
docs/uk/docs/tutorial/first-steps.md | 10 +--
docs/vi/docs/tutorial/first-steps.md | 2 +-
.../docs/advanced/additional-status-codes.md | 4 +-
.../zh/docs/advanced/advanced-dependencies.md | 2 +-
docs/zh/docs/advanced/behind-a-proxy.md | 14 ++--
docs/zh/docs/advanced/custom-response.md | 20 ++---
docs/zh/docs/advanced/dataclasses.md | 2 +-
docs/zh/docs/advanced/events.md | 8 +-
docs/zh/docs/advanced/middleware.md | 2 +-
docs/zh/docs/advanced/openapi-callbacks.md | 10 +--
docs/zh/docs/advanced/response-cookies.md | 2 +-
docs/zh/docs/advanced/response-directly.md | 4 +-
docs/zh/docs/advanced/response-headers.md | 2 +-
docs/zh/docs/advanced/security/index.md | 2 +-
.../docs/advanced/security/oauth2-scopes.md | 14 ++--
docs/zh/docs/advanced/templates.md | 6 +-
docs/zh/docs/advanced/testing-dependencies.md | 4 +-
docs/zh/docs/advanced/testing-websockets.md | 2 +-
.../docs/advanced/using-request-directly.md | 4 +-
docs/zh/docs/advanced/websockets.md | 2 +-
docs/zh/docs/contributing.md | 2 +-
docs/zh/docs/fastapi-cli.md | 2 +-
docs/zh/docs/help-fastapi.md | 2 +-
docs/zh/docs/tutorial/bigger-applications.md | 4 +-
docs/zh/docs/tutorial/body-fields.md | 6 +-
docs/zh/docs/tutorial/body-updates.md | 6 +-
docs/zh/docs/tutorial/body.md | 6 +-
docs/zh/docs/tutorial/cookie-params.md | 4 +-
docs/zh/docs/tutorial/cors.md | 2 +-
...pendencies-in-path-operation-decorators.md | 4 +-
.../dependencies/dependencies-with-yield.md | 4 +-
docs/zh/docs/tutorial/dependencies/index.md | 6 +-
.../tutorial/dependencies/sub-dependencies.md | 4 +-
docs/zh/docs/tutorial/extra-models.md | 6 +-
docs/zh/docs/tutorial/first-steps.md | 4 +-
docs/zh/docs/tutorial/handling-errors.md | 8 +-
docs/zh/docs/tutorial/header-params.md | 6 +-
docs/zh/docs/tutorial/metadata.md | 4 +-
docs/zh/docs/tutorial/middleware.md | 4 +-
.../tutorial/path-operation-configuration.md | 8 +-
.../path-params-numeric-validations.md | 2 +-
docs/zh/docs/tutorial/path-params.md | 16 ++--
docs/zh/docs/tutorial/query-params.md | 6 +-
docs/zh/docs/tutorial/request-files.md | 16 ++--
.../docs/tutorial/request-forms-and-files.md | 4 +-
docs/zh/docs/tutorial/request-forms.md | 10 +--
docs/zh/docs/tutorial/response-model.md | 2 +-
docs/zh/docs/tutorial/response-status-code.md | 12 +--
docs/zh/docs/tutorial/security/first-steps.md | 14 ++--
.../tutorial/security/get-current-user.md | 4 +-
docs/zh/docs/tutorial/security/oauth2-jwt.md | 12 +--
.../docs/tutorial/security/simple-oauth2.md | 16 ++--
docs/zh/docs/tutorial/sql-databases.md | 6 +-
docs/zh/docs/tutorial/static-files.md | 2 +-
docs/zh/docs/tutorial/testing.md | 14 ++--
433 files changed, 1799 insertions(+), 1799 deletions(-)
diff --git a/docs/de/docs/advanced/additional-responses.md b/docs/de/docs/advanced/additional-responses.md
index a87c56491..29a7b064a 100644
--- a/docs/de/docs/advanced/additional-responses.md
+++ b/docs/de/docs/advanced/additional-responses.md
@@ -1,6 +1,6 @@
# Zusätzliche Responses in OpenAPI
-/// warning | "Achtung"
+/// warning | Achtung
Dies ist ein eher fortgeschrittenes Thema.
@@ -30,7 +30,7 @@ Um beispielsweise eine weitere Response mit dem Statuscode `404` und einem Pydan
{!../../docs_src/additional_responses/tutorial001.py!}
```
-/// note | "Hinweis"
+/// note | Hinweis
Beachten Sie, dass Sie die `JSONResponse` direkt zurückgeben müssen.
@@ -181,7 +181,7 @@ Sie können beispielsweise einen zusätzlichen Medientyp `image/png` hinzufügen
{!../../docs_src/additional_responses/tutorial002.py!}
```
-/// note | "Hinweis"
+/// note | Hinweis
Beachten Sie, dass Sie das Bild direkt mit einer `FileResponse` zurückgeben müssen.
diff --git a/docs/de/docs/advanced/additional-status-codes.md b/docs/de/docs/advanced/additional-status-codes.md
index fc8d09e4c..50702e7e6 100644
--- a/docs/de/docs/advanced/additional-status-codes.md
+++ b/docs/de/docs/advanced/additional-status-codes.md
@@ -40,7 +40,7 @@ Um dies zu erreichen, importieren Sie `JSONResponse`, und geben Sie Ihren Inhalt
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -54,7 +54,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -66,7 +66,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// warning | "Achtung"
+/// warning | Achtung
Wenn Sie eine `Response` direkt zurückgeben, wie im obigen Beispiel, wird sie direkt zurückgegeben.
@@ -76,7 +76,7 @@ Stellen Sie sicher, dass sie die gewünschten Daten enthält und dass die Werte
///
-/// note | "Technische Details"
+/// note | Technische Details
Sie können auch `from starlette.responses import JSONResponse` verwenden.
diff --git a/docs/de/docs/advanced/advanced-dependencies.md b/docs/de/docs/advanced/advanced-dependencies.md
index 54351714e..80cbf1fd3 100644
--- a/docs/de/docs/advanced/advanced-dependencies.md
+++ b/docs/de/docs/advanced/advanced-dependencies.md
@@ -36,7 +36,7 @@ Dazu deklarieren wir eine Methode `__call__`:
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -72,7 +72,7 @@ Und jetzt können wir `__init__` verwenden, um die Parameter der Instanz zu dekl
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -108,7 +108,7 @@ Wir könnten eine Instanz dieser Klasse erstellen mit:
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -152,7 +152,7 @@ checker(q="somequery")
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -164,7 +164,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// tip | "Tipp"
+/// tip | Tipp
Das alles mag gekünstelt wirken. Und es ist möglicherweise noch nicht ganz klar, welchen Nutzen das hat.
diff --git a/docs/de/docs/advanced/async-tests.md b/docs/de/docs/advanced/async-tests.md
index 6c1981e25..c118e588f 100644
--- a/docs/de/docs/advanced/async-tests.md
+++ b/docs/de/docs/advanced/async-tests.md
@@ -62,7 +62,7 @@ Der Marker `@pytest.mark.anyio` teilt pytest mit, dass diese Testfunktion asynch
{* ../../docs_src/async_tests/test_main.py hl[7] *}
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass die Testfunktion jetzt `async def` ist und nicht nur `def` wie zuvor, wenn Sie den `TestClient` verwenden.
@@ -80,13 +80,13 @@ response = client.get('/')
... welches wir verwendet haben, um unsere Requests mit dem `TestClient` zu machen.
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass wir async/await mit dem neuen `AsyncClient` verwenden – der Request ist asynchron.
///
-/// warning | "Achtung"
+/// warning | Achtung
Falls Ihre Anwendung auf Lifespan-Events angewiesen ist, der `AsyncClient` löst diese Events nicht aus. Um sicherzustellen, dass sie ausgelöst werden, verwenden Sie `LifespanManager` von <a href="https://github.com/florimondmanca/asgi-lifespan#usage" class="external-link" target="_blank">florimondmanca/asgi-lifespan</a>.
@@ -96,7 +96,7 @@ Falls Ihre Anwendung auf Lifespan-Events angewiesen ist, der `AsyncClient` löst
Da die Testfunktion jetzt asynchron ist, können Sie in Ihren Tests neben dem Senden von Requests an Ihre FastAPI-Anwendung jetzt auch andere `async`hrone Funktionen aufrufen (und `await`en), genau so, wie Sie diese an anderer Stelle in Ihrem Code aufrufen würden.
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie einen `RuntimeError: Task attached to a different loop` erhalten, wenn Sie asynchrone Funktionsaufrufe in Ihre Tests integrieren (z. B. bei Verwendung von <a href="https://stackoverflow.com/questions/41584243/runtimeerror-task-attached-to-a-different-loop" class="external-link" target="_blank">MongoDBs MotorClient</a>), dann denken Sie daran, Objekte zu instanziieren, die einen Event Loop nur innerhalb asynchroner Funktionen benötigen, z. B. einen `@app.on_event("startup")`-Callback.
diff --git a/docs/de/docs/advanced/behind-a-proxy.md b/docs/de/docs/advanced/behind-a-proxy.md
index 74b25308a..9da18a626 100644
--- a/docs/de/docs/advanced/behind-a-proxy.md
+++ b/docs/de/docs/advanced/behind-a-proxy.md
@@ -43,7 +43,7 @@ browser --> proxy
proxy --> server
```
-/// tip | "Tipp"
+/// tip | Tipp
Die IP `0.0.0.0` wird üblicherweise verwendet, um anzudeuten, dass das Programm alle auf diesem Computer/Server verfügbaren IPs abhört.
@@ -84,7 +84,7 @@ $ uvicorn main:app --root-path /api/v1
Falls Sie Hypercorn verwenden, das hat auch die Option `--root-path`.
-/// note | "Technische Details"
+/// note | Technische Details
Die ASGI-Spezifikation definiert einen `root_path` für diesen Anwendungsfall.
@@ -178,7 +178,7 @@ Dann erstellen Sie eine Datei `traefik.toml` mit:
Dadurch wird Traefik angewiesen, Port 9999 abzuhören und eine andere Datei `routes.toml` zu verwenden.
-/// tip | "Tipp"
+/// tip | Tipp
Wir verwenden Port 9999 anstelle des Standard-HTTP-Ports 80, damit Sie ihn nicht mit Administratorrechten (`sudo`) ausführen müssen.
@@ -248,7 +248,7 @@ Wenn Sie nun zur URL mit dem Port für Uvicorn gehen: <a href="http://127.0.0.1:
}
```
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass, obwohl Sie unter `http://127.0.0.1:8000/app` darauf zugreifen, als `root_path` angezeigt wird `/api/v1`, welches aus der Option `--root-path` stammt.
@@ -295,7 +295,7 @@ Dies liegt daran, dass FastAPI diesen `root_path` verwendet, um den Default-`ser
## Zusätzliche Server
-/// warning | "Achtung"
+/// warning | Achtung
Dies ist ein fortgeschrittener Anwendungsfall. Überspringen Sie das gerne.
@@ -338,7 +338,7 @@ Erzeugt ein OpenAPI-Schema, wie:
}
```
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie den automatisch generierten Server mit dem `URL`-Wert `/api/v1`, welcher vom `root_path` stammt.
@@ -348,7 +348,7 @@ In der Dokumentationsoberfläche unter <a href="http://127.0.0.1:9999/api/v1/doc
<img src="/img/tutorial/behind-a-proxy/image03.png">
-/// tip | "Tipp"
+/// tip | Tipp
Die Dokumentationsoberfläche interagiert mit dem von Ihnen ausgewählten Server.
diff --git a/docs/de/docs/advanced/custom-response.md b/docs/de/docs/advanced/custom-response.md
index 357d2c562..7738bfca4 100644
--- a/docs/de/docs/advanced/custom-response.md
+++ b/docs/de/docs/advanced/custom-response.md
@@ -12,7 +12,7 @@ Der Inhalt, den Sie von Ihrer *Pfadoperation-Funktion* zurückgeben, wird in die
Und wenn diese `Response` einen JSON-Medientyp (`application/json`) hat, wie es bei `JSONResponse` und `UJSONResponse` der Fall ist, werden die von Ihnen zurückgegebenen Daten automatisch mit jedem Pydantic `response_model` konvertiert (und gefiltert), das Sie im *Pfadoperation-Dekorator* deklariert haben.
-/// note | "Hinweis"
+/// note | Hinweis
Wenn Sie eine Response-Klasse ohne Medientyp verwenden, erwartet FastAPI, dass Ihre Response keinen Inhalt hat, und dokumentiert daher das Format der Response nicht in deren generierter OpenAPI-Dokumentation.
@@ -44,7 +44,7 @@ Und er wird als solcher in OpenAPI dokumentiert.
///
-/// tip | "Tipp"
+/// tip | Tipp
Die `ORJSONResponse` ist derzeit nur in FastAPI verfügbar, nicht in Starlette.
@@ -81,7 +81,7 @@ Das gleiche Beispiel von oben, das eine `HTMLResponse` zurückgibt, könnte so a
{!../../docs_src/custom_response/tutorial003.py!}
```
-/// warning | "Achtung"
+/// warning | Achtung
Eine `Response`, die direkt von Ihrer *Pfadoperation-Funktion* zurückgegeben wird, wird in OpenAPI nicht dokumentiert (zum Beispiel wird der `Content-Type` nicht dokumentiert) und ist in der automatischen interaktiven Dokumentation nicht sichtbar.
@@ -121,7 +121,7 @@ Hier sind einige der verfügbaren Responses.
Bedenken Sie, dass Sie `Response` verwenden können, um alles andere zurückzugeben, oder sogar eine benutzerdefinierte Unterklasse zu erstellen.
-/// note | "Technische Details"
+/// note | Technische Details
Sie können auch `from starlette.responses import HTMLResponse` verwenden.
@@ -174,7 +174,7 @@ Eine schnelle alternative JSON-Response mit <a href="https://github.com/ijl/orjs
Eine alternative JSON-Response mit <a href="https://github.com/ultrajson/ultrajson" class="external-link" target="_blank">`ujson`</a>.
-/// warning | "Achtung"
+/// warning | Achtung
`ujson` ist bei der Behandlung einiger Sonderfälle weniger sorgfältig als Pythons eingebaute Implementierung.
@@ -184,7 +184,7 @@ Eine alternative JSON-Response mit <a href="https://github.com/ultrajson/ultrajs
{!../../docs_src/custom_response/tutorial001.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Möglicherweise ist `ORJSONResponse` eine schnellere Alternative.
@@ -249,7 +249,7 @@ Das umfasst viele Bibliotheken zur Interaktion mit Cloud-Speicher, Videoverarbei
Auf diese Weise können wir das Ganze in einen `with`-Block einfügen und so sicherstellen, dass das dateiartige Objekt nach Abschluss geschlossen wird.
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass wir, da wir Standard-`open()` verwenden, welches `async` und `await` nicht unterstützt, hier die Pfadoperation mit normalen `def` deklarieren.
@@ -322,7 +322,7 @@ Im folgenden Beispiel verwendet **FastAPI** standardmäßig `ORJSONResponse` in
{!../../docs_src/custom_response/tutorial010.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Sie können dennoch weiterhin `response_class` in *Pfadoperationen* überschreiben, wie bisher.
diff --git a/docs/de/docs/advanced/events.md b/docs/de/docs/advanced/events.md
index b0c4d3922..cae53091c 100644
--- a/docs/de/docs/advanced/events.md
+++ b/docs/de/docs/advanced/events.md
@@ -38,7 +38,7 @@ Hier simulieren wir das langsame *Hochfahren*, das Laden des Modells, indem wir
Und dann, direkt nach dem `yield`, entladen wir das Modell. Dieser Code wird unmittelbar vor dem *Herunterfahren* ausgeführt, **nachdem** die Anwendung **die Bearbeitung von Requests abgeschlossen hat**. Dadurch könnten beispielsweise Ressourcen wie Arbeitsspeicher oder eine GPU freigegeben werden.
-/// tip | "Tipp"
+/// tip | Tipp
Das *Herunterfahren* würde erfolgen, wenn Sie die Anwendung **stoppen**.
@@ -94,7 +94,7 @@ Der Parameter `lifespan` der `FastAPI`-App benötigt einen **asynchronen Kontext
## Alternative Events (deprecated)
-/// warning | "Achtung"
+/// warning | Achtung
Der empfohlene Weg, das *Hochfahren* und *Herunterfahren* zu handhaben, ist die Verwendung des `lifespan`-Parameters der `FastAPI`-App, wie oben beschrieben. Wenn Sie einen `lifespan`-Parameter übergeben, werden die `startup`- und `shutdown`-Eventhandler nicht mehr aufgerufen. Es ist entweder alles `lifespan` oder alles Events, nicht beides.
@@ -138,7 +138,7 @@ In der Funktion `open()` bedeutet `mode="a"` „append“ („anhängen“), sod
///
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass wir in diesem Fall eine Standard-Python-Funktion `open()` verwenden, die mit einer Datei interagiert.
diff --git a/docs/de/docs/advanced/generate-clients.md b/docs/de/docs/advanced/generate-clients.md
index 80c44b3f9..8f71e5419 100644
--- a/docs/de/docs/advanced/generate-clients.md
+++ b/docs/de/docs/advanced/generate-clients.md
@@ -127,7 +127,7 @@ Sie erhalten außerdem automatische Vervollständigung für die zu sendende Payl
<img src="/img/tutorial/generate-clients/image03.png">
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie die automatische Vervollständigung für `name` und `price`, welche in der FastAPI-Anwendung im `Item`-Modell definiert wurden.
diff --git a/docs/de/docs/advanced/index.md b/docs/de/docs/advanced/index.md
index 953ad317d..d93cd5fe8 100644
--- a/docs/de/docs/advanced/index.md
+++ b/docs/de/docs/advanced/index.md
@@ -6,7 +6,7 @@ Das Haupt-[Tutorial – Benutzerhandbuch](../tutorial/index.md){.internal-link t
In den nächsten Abschnitten sehen Sie weitere Optionen, Konfigurationen und zusätzliche Funktionen.
-/// tip | "Tipp"
+/// tip | Tipp
Die nächsten Abschnitte sind **nicht unbedingt „fortgeschritten“**.
diff --git a/docs/de/docs/advanced/middleware.md b/docs/de/docs/advanced/middleware.md
index b4001efda..d2130c9b7 100644
--- a/docs/de/docs/advanced/middleware.md
+++ b/docs/de/docs/advanced/middleware.md
@@ -43,7 +43,7 @@ app.add_middleware(UnicornMiddleware, some_config="rainbow")
**FastAPI** enthält mehrere Middlewares für gängige Anwendungsfälle. Wir werden als Nächstes sehen, wie man sie verwendet.
-/// note | "Technische Details"
+/// note | Technische Details
Für die nächsten Beispiele könnten Sie auch `from starlette.middleware.something import SomethingMiddleware` verwenden.
diff --git a/docs/de/docs/advanced/openapi-callbacks.md b/docs/de/docs/advanced/openapi-callbacks.md
index f407d5450..4ee2874a3 100644
--- a/docs/de/docs/advanced/openapi-callbacks.md
+++ b/docs/de/docs/advanced/openapi-callbacks.md
@@ -35,7 +35,7 @@ Dieser Teil ist ziemlich normal, der größte Teil des Codes ist Ihnen wahrschei
{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Der Query-Parameter `callback_url` verwendet einen Pydantic-<a href="https://docs.pydantic.dev/latest/api/networks/" class="external-link" target="_blank">Url</a>-Typ.
@@ -64,7 +64,7 @@ Diese Dokumentation wird in der Swagger-Oberfläche unter `/docs` in Ihrer API a
In diesem Beispiel wird nicht der Callback selbst implementiert (das könnte nur eine Codezeile sein), sondern nur der Dokumentationsteil.
-/// tip | "Tipp"
+/// tip | Tipp
Der eigentliche Callback ist nur ein HTTP-Request.
@@ -80,7 +80,7 @@ Sie wissen jedoch bereits, wie Sie mit **FastAPI** ganz einfach eine automatisch
Daher werden wir dasselbe Wissen nutzen, um zu dokumentieren, wie die *externe API* aussehen sollte ... indem wir die *Pfadoperation(en)* erstellen, welche die externe API implementieren soll (die, welche Ihre API aufruft).
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie den Code zum Dokumentieren eines Callbacks schreiben, kann es hilfreich sein, sich vorzustellen, dass Sie dieser *externe Entwickler* sind. Und dass Sie derzeit die *externe API* implementieren, nicht *Ihre API*.
@@ -163,7 +163,7 @@ und sie würde eine Response von dieser *externen API* mit einem JSON-Body wie d
}
```
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass die verwendete Callback-URL die URL enthält, die als Query-Parameter in `callback_url` (`https://www.external.org/events`) empfangen wurde, und auch die Rechnungs-`id` aus dem JSON-Body (`2expen51ve`).
@@ -179,7 +179,7 @@ Verwenden Sie nun den Parameter `callbacks` im *Pfadoperation-Dekorator Ihrer AP
{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass Sie nicht den Router selbst (`invoices_callback_router`) an `callback=` übergeben, sondern das Attribut `.routes`, wie in `invoices_callback_router.routes`.
diff --git a/docs/de/docs/advanced/path-operation-advanced-configuration.md b/docs/de/docs/advanced/path-operation-advanced-configuration.md
index 2d8b88be5..53d395724 100644
--- a/docs/de/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/de/docs/advanced/path-operation-advanced-configuration.md
@@ -2,7 +2,7 @@
## OpenAPI operationId
-/// warning | "Achtung"
+/// warning | Achtung
Wenn Sie kein „Experte“ für OpenAPI sind, brauchen Sie dies wahrscheinlich nicht.
@@ -26,13 +26,13 @@ Sie sollten dies tun, nachdem Sie alle Ihre *Pfadoperationen* hinzugefügt haben
{!../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie `app.openapi()` manuell aufrufen, sollten Sie vorher die `operationId`s aktualisiert haben.
///
-/// warning | "Achtung"
+/// warning | Achtung
Wenn Sie dies tun, müssen Sie sicherstellen, dass jede Ihrer *Pfadoperation-Funktionen* einen eindeutigen Namen hat.
@@ -74,7 +74,7 @@ Es gibt hier in der Dokumentation ein ganzes Kapitel darüber, Sie können es un
Wenn Sie in Ihrer Anwendung eine *Pfadoperation* deklarieren, generiert **FastAPI** automatisch die relevanten Metadaten dieser *Pfadoperation*, die in das OpenAPI-Schema aufgenommen werden sollen.
-/// note | "Technische Details"
+/// note | Technische Details
In der OpenAPI-Spezifikation wird das <a href="https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operation-object" class="external-link" target="_blank">Operationsobjekt</a> genannt.
@@ -86,7 +86,7 @@ Es enthält `tags`, `parameters`, `requestBody`, `responses`, usw.
Dieses *Pfadoperation*-spezifische OpenAPI-Schema wird normalerweise automatisch von **FastAPI** generiert, Sie können es aber auch erweitern.
-/// tip | "Tipp"
+/// tip | Tipp
Dies ist ein Low-Level Erweiterungspunkt.
@@ -215,7 +215,7 @@ In Pydantic Version 1 war die Methode zum Parsen und Validieren eines Objekts `I
///
-/// tip | "Tipp"
+/// tip | Tipp
Hier verwenden wir dasselbe Pydantic-Modell wieder.
diff --git a/docs/de/docs/advanced/response-cookies.md b/docs/de/docs/advanced/response-cookies.md
index ba100870d..6f9d66e07 100644
--- a/docs/de/docs/advanced/response-cookies.md
+++ b/docs/de/docs/advanced/response-cookies.md
@@ -30,7 +30,7 @@ Setzen Sie dann Cookies darin und geben Sie sie dann zurück:
{!../../docs_src/response_cookies/tutorial001.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass, wenn Sie eine Response direkt zurückgeben, anstatt den `Response`-Parameter zu verwenden, FastAPI diese direkt zurückgibt.
@@ -42,7 +42,7 @@ Und auch, dass Sie keine Daten senden, die durch ein `response_model` hätten ge
### Mehr Informationen
-/// note | "Technische Details"
+/// note | Technische Details
Sie können auch `from starlette.responses import Response` oder `from starlette.responses import JSONResponse` verwenden.
diff --git a/docs/de/docs/advanced/response-directly.md b/docs/de/docs/advanced/response-directly.md
index 70c045f57..fab2e3965 100644
--- a/docs/de/docs/advanced/response-directly.md
+++ b/docs/de/docs/advanced/response-directly.md
@@ -14,7 +14,7 @@ Das kann beispielsweise nützlich sein, um benutzerdefinierte Header oder Cookie
Tatsächlich können Sie jede `Response` oder jede Unterklasse davon zurückgeben.
-/// tip | "Tipp"
+/// tip | Tipp
`JSONResponse` selbst ist eine Unterklasse von `Response`.
@@ -38,7 +38,7 @@ In diesen Fällen können Sie den `jsonable_encoder` verwenden, um Ihre Daten zu
{!../../docs_src/response_directly/tutorial001.py!}
```
-/// note | "Technische Details"
+/// note | Technische Details
Sie können auch `from starlette.responses import JSONResponse` verwenden.
diff --git a/docs/de/docs/advanced/response-headers.md b/docs/de/docs/advanced/response-headers.md
index 31c2c9c98..ca1a28fa4 100644
--- a/docs/de/docs/advanced/response-headers.md
+++ b/docs/de/docs/advanced/response-headers.md
@@ -28,7 +28,7 @@ Erstellen Sie eine Response wie in [Eine Response direkt zurückgeben](response-
{!../../docs_src/response_headers/tutorial001.py!}
```
-/// note | "Technische Details"
+/// note | Technische Details
Sie können auch `from starlette.responses import Response` oder `from starlette.responses import JSONResponse` verwenden.
diff --git a/docs/de/docs/advanced/security/index.md b/docs/de/docs/advanced/security/index.md
index 380e48bbf..25eeb25b5 100644
--- a/docs/de/docs/advanced/security/index.md
+++ b/docs/de/docs/advanced/security/index.md
@@ -4,7 +4,7 @@
Neben den in [Tutorial – Benutzerhandbuch: Sicherheit](../../tutorial/security/index.md){.internal-link target=_blank} behandelten Funktionen gibt es noch einige zusätzliche Funktionen zur Handhabung der Sicherheit.
-/// tip | "Tipp"
+/// tip | Tipp
Die nächsten Abschnitte sind **nicht unbedingt „fortgeschritten“**.
diff --git a/docs/de/docs/advanced/security/oauth2-scopes.md b/docs/de/docs/advanced/security/oauth2-scopes.md
index c0af2560a..85175a895 100644
--- a/docs/de/docs/advanced/security/oauth2-scopes.md
+++ b/docs/de/docs/advanced/security/oauth2-scopes.md
@@ -10,7 +10,7 @@ Jedes Mal, wenn Sie sich mit Facebook, Google, GitHub, Microsoft oder Twitter an
In diesem Abschnitt erfahren Sie, wie Sie Authentifizierung und Autorisierung mit demselben OAuth2, mit Scopes in Ihrer **FastAPI**-Anwendung verwalten.
-/// warning | "Achtung"
+/// warning | Achtung
Dies ist ein mehr oder weniger fortgeschrittener Abschnitt. Wenn Sie gerade erst anfangen, können Sie ihn überspringen.
@@ -88,7 +88,7 @@ Sehen wir uns zunächst kurz die Teile an, die sich gegenüber den Beispielen im
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -102,7 +102,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.9+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -116,7 +116,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -162,7 +162,7 @@ Der `scopes`-Parameter erhält ein `dict` mit jedem Scope als Schlüssel und des
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -176,7 +176,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.9+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -190,7 +190,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -218,7 +218,7 @@ Wir verwenden immer noch dasselbe `OAuth2PasswordRequestForm`. Es enthält eine
Und wir geben die Scopes als Teil des JWT-Tokens zurück.
-/// danger | "Gefahr"
+/// danger | Gefahr
Der Einfachheit halber fügen wir hier die empfangenen Scopes direkt zum Token hinzu.
@@ -252,7 +252,7 @@ Aus Sicherheitsgründen sollten Sie jedoch sicherstellen, dass Sie in Ihrer Anwe
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -266,7 +266,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.9+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -280,7 +280,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -308,7 +308,7 @@ Und die Abhängigkeitsfunktion `get_current_active_user` kann auch Unterabhängi
In diesem Fall erfordert sie den Scope `me` (sie könnte mehr als einen Scope erfordern).
-/// note | "Hinweis"
+/// note | Hinweis
Sie müssen nicht unbedingt an verschiedenen Stellen verschiedene Scopes hinzufügen.
@@ -342,7 +342,7 @@ Wir tun dies hier, um zu demonstrieren, wie **FastAPI** auf verschiedenen Ebenen
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -356,7 +356,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.9+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -370,7 +370,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -382,7 +382,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// info | "Technische Details"
+/// info | Technische Details
`Security` ist tatsächlich eine Unterklasse von `Depends` und hat nur noch einen zusätzlichen Parameter, den wir später kennenlernen werden.
@@ -432,7 +432,7 @@ Diese `SecurityScopes`-Klasse ähnelt `Request` (`Request` wurde verwendet, um d
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -446,7 +446,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.9+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -460,7 +460,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -510,7 +510,7 @@ In diese Exception fügen wir (falls vorhanden) die erforderlichen Scopes als du
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -524,7 +524,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.9+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -538,7 +538,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -590,7 +590,7 @@ Wir verifizieren auch, dass wir einen Benutzer mit diesem Benutzernamen haben, u
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -604,7 +604,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.9+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -618,7 +618,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -662,7 +662,7 @@ Hierzu verwenden wir `security_scopes.scopes`, das eine `list`e mit allen diesen
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -676,7 +676,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.9+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -690,7 +690,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -727,7 +727,7 @@ So sieht die Hierarchie der Abhängigkeiten und Scopes aus:
* `security_scopes.scopes` enthält `["me"]` für die *Pfadoperation* `read_users_me`, da das in der Abhängigkeit `get_current_active_user` deklariert ist.
* `security_scopes.scopes` wird `[]` (nichts) für die *Pfadoperation* `read_system_status` enthalten, da diese keine `Security` mit `scopes` deklariert hat, und deren Abhängigkeit `get_current_user` ebenfalls keinerlei `scopes` deklariert.
-/// tip | "Tipp"
+/// tip | Tipp
Das Wichtige und „Magische“ hier ist, dass `get_current_user` für jede *Pfadoperation* eine andere Liste von `scopes` hat, die überprüft werden.
@@ -771,7 +771,7 @@ Am häufigsten ist der „Implicit“-Flow.
Am sichersten ist der „Code“-Flow, die Implementierung ist jedoch komplexer, da mehr Schritte erforderlich sind. Da er komplexer ist, schlagen viele Anbieter letztendlich den „Implicit“-Flow vor.
-/// note | "Hinweis"
+/// note | Hinweis
Es ist üblich, dass jeder Authentifizierungsanbieter seine Flows anders benennt, um sie zu einem Teil seiner Marke zu machen.
diff --git a/docs/de/docs/advanced/settings.md b/docs/de/docs/advanced/settings.md
index 8b9ba2f48..c90f74844 100644
--- a/docs/de/docs/advanced/settings.md
+++ b/docs/de/docs/advanced/settings.md
@@ -8,7 +8,7 @@ Aus diesem Grund werden diese üblicherweise in Umgebungsvariablen bereitgestell
## Umgebungsvariablen
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie bereits wissen, was „Umgebungsvariablen“ sind und wie man sie verwendet, können Sie gerne mit dem nächsten Abschnitt weiter unten fortfahren.
@@ -67,7 +67,7 @@ name = os.getenv("MY_NAME", "World")
print(f"Hello {name} from Python")
```
-/// tip | "Tipp"
+/// tip | Tipp
Das zweite Argument für <a href="https://docs.python.org/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> ist der zurückzugebende Defaultwert.
@@ -124,7 +124,7 @@ Hello World from Python
</div>
-/// tip | "Tipp"
+/// tip | Tipp
Weitere Informationen dazu finden Sie unter <a href="https://12factor.net/config" class="external-link" target="_blank">The Twelve-Factor App: Config</a>.
@@ -200,7 +200,7 @@ In Pydantic v1 würden Sie `BaseSettings` direkt von `pydantic` statt von `pydan
////
-/// tip | "Tipp"
+/// tip | Tipp
Für ein schnelles Copy-and-paste verwenden Sie nicht dieses Beispiel, sondern das letzte unten.
@@ -232,7 +232,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" uvicorn main:app
</div>
-/// tip | "Tipp"
+/// tip | Tipp
Um mehrere Umgebungsvariablen für einen einzelnen Befehl festzulegen, trennen Sie diese einfach durch ein Leerzeichen und fügen Sie alle vor dem Befehl ein.
@@ -260,7 +260,7 @@ Und dann verwenden Sie diese in einer Datei `main.py`:
{!../../docs_src/settings/app01/main.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Sie benötigen außerdem eine Datei `__init__.py`, wie in [Größere Anwendungen – mehrere Dateien](../tutorial/bigger-applications.md){.internal-link target=_blank} gesehen.
@@ -304,7 +304,7 @@ Jetzt erstellen wir eine Abhängigkeit, die ein neues `config.Settings()` zurüc
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -316,7 +316,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// tip | "Tipp"
+/// tip | Tipp
Wir werden das `@lru_cache` in Kürze besprechen.
@@ -344,7 +344,7 @@ Und dann können wir das von der *Pfadoperation-Funktion* als Abhängigkeit einf
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -374,7 +374,7 @@ Wenn Sie viele Einstellungen haben, die sich möglicherweise oft ändern, vielle
Diese Praxis ist so weit verbreitet, dass sie einen Namen hat. Diese Umgebungsvariablen werden üblicherweise in einer Datei `.env` abgelegt und die Datei wird „dotenv“ genannt.
-/// tip | "Tipp"
+/// tip | Tipp
Eine Datei, die mit einem Punkt (`.`) beginnt, ist eine versteckte Datei in Unix-ähnlichen Systemen wie Linux und macOS.
@@ -384,7 +384,7 @@ Aber eine dotenv-Datei muss nicht unbedingt genau diesen Dateinamen haben.
Pydantic unterstützt das Lesen dieser Dateitypen mithilfe einer externen Bibliothek. Weitere Informationen finden Sie unter <a href="https://docs.pydantic.dev/latest/concepts/pydantic_settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic Settings: Dotenv (.env) support</a>.
-/// tip | "Tipp"
+/// tip | Tipp
Damit das funktioniert, müssen Sie `pip install python-dotenv` ausführen.
@@ -409,7 +409,7 @@ Und dann aktualisieren Sie Ihre `config.py` mit:
{!> ../../docs_src/settings/app03_an/config.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Das Attribut `model_config` wird nur für die Pydantic-Konfiguration verwendet. Weitere Informationen finden Sie unter <a href="https://docs.pydantic.dev/latest/concepts/config/" class="external-link" target="_blank">Pydantic: Configuration</a>.
@@ -423,7 +423,7 @@ Das Attribut `model_config` wird nur für die Pydantic-Konfiguration verwendet.
{!> ../../docs_src/settings/app03_an/config_pv1.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Die Klasse `Config` wird nur für die Pydantic-Konfiguration verwendet. Weitere Informationen finden Sie unter <a href="https://docs.pydantic.dev/1.10/usage/model_config/" class="external-link" target="_blank">Pydantic Model Config</a>.
@@ -480,7 +480,7 @@ Da wir jedoch den `@lru_cache`-Dekorator oben verwenden, wird das `Settings`-Obj
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
diff --git a/docs/de/docs/advanced/templates.md b/docs/de/docs/advanced/templates.md
index 6cb3fcf6c..658a2592e 100644
--- a/docs/de/docs/advanced/templates.md
+++ b/docs/de/docs/advanced/templates.md
@@ -31,7 +31,7 @@ $ pip install jinja2
{!../../docs_src/templates/tutorial001.py!}
```
-/// note | "Hinweis"
+/// note | Hinweis
Vor FastAPI 0.108.0 und Starlette 0.29.0 war `name` der erste Parameter.
@@ -39,13 +39,13 @@ Außerdem wurde in früheren Versionen das `request`-Objekt als Teil der Schlüs
///
-/// tip | "Tipp"
+/// tip | Tipp
Durch die Deklaration von `response_class=HTMLResponse` kann die Dokumentationsoberfläche erkennen, dass die Response HTML sein wird.
///
-/// note | "Technische Details"
+/// note | Technische Details
Sie können auch `from starlette.templating import Jinja2Templates` verwenden.
diff --git a/docs/de/docs/advanced/testing-dependencies.md b/docs/de/docs/advanced/testing-dependencies.md
index c565b30f2..3b4604da3 100644
--- a/docs/de/docs/advanced/testing-dependencies.md
+++ b/docs/de/docs/advanced/testing-dependencies.md
@@ -54,7 +54,7 @@ Und dann ruft **FastAPI** diese Überschreibung anstelle der ursprünglichen Abh
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -68,7 +68,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -80,7 +80,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// tip | "Tipp"
+/// tip | Tipp
Sie können eine Überschreibung für eine Abhängigkeit festlegen, die an einer beliebigen Stelle in Ihrer **FastAPI**-Anwendung verwendet wird.
@@ -96,7 +96,7 @@ Anschließend können Sie Ihre Überschreibungen zurücksetzen (entfernen), inde
app.dependency_overrides = {}
```
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie eine Abhängigkeit nur während einiger Tests überschreiben möchten, können Sie die Überschreibung zu Beginn des Tests (innerhalb der Testfunktion) festlegen und am Ende (am Ende der Testfunktion) zurücksetzen.
diff --git a/docs/de/docs/advanced/testing-websockets.md b/docs/de/docs/advanced/testing-websockets.md
index 7ae7d92d6..5122e1f33 100644
--- a/docs/de/docs/advanced/testing-websockets.md
+++ b/docs/de/docs/advanced/testing-websockets.md
@@ -8,7 +8,7 @@ Dazu verwenden Sie den `TestClient` in einer `with`-Anweisung, eine Verbindung z
{!../../docs_src/app_testing/tutorial002.py!}
```
-/// note | "Hinweis"
+/// note | Hinweis
Weitere Informationen finden Sie in der Starlette-Dokumentation zum <a href="https://www.starlette.io/testclient/#testing-websocket-sessions" class="external-link" target="_blank">Testen von WebSockets</a>.
diff --git a/docs/de/docs/advanced/using-request-directly.md b/docs/de/docs/advanced/using-request-directly.md
index 6a0b96680..1c2a6f852 100644
--- a/docs/de/docs/advanced/using-request-directly.md
+++ b/docs/de/docs/advanced/using-request-directly.md
@@ -35,7 +35,7 @@ Dazu müssen Sie direkt auf den Request zugreifen.
Durch die Deklaration eines *Pfadoperation-Funktionsparameters*, dessen Typ der `Request` ist, weiß **FastAPI**, dass es den `Request` diesem Parameter übergeben soll.
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass wir in diesem Fall einen Pfad-Parameter zusätzlich zum Request-Parameter deklarieren.
@@ -49,7 +49,7 @@ Auf die gleiche Weise können Sie wie gewohnt jeden anderen Parameter deklariere
Weitere Details zum <a href="https://www.starlette.io/requests/" class="external-link" target="_blank">`Request`-Objekt finden Sie in der offiziellen Starlette-Dokumentation</a>.
-/// note | "Technische Details"
+/// note | Technische Details
Sie können auch `from starlette.requests import Request` verwenden.
diff --git a/docs/de/docs/advanced/websockets.md b/docs/de/docs/advanced/websockets.md
index cf13fa23c..5bc5f6902 100644
--- a/docs/de/docs/advanced/websockets.md
+++ b/docs/de/docs/advanced/websockets.md
@@ -50,7 +50,7 @@ Erstellen Sie in Ihrer **FastAPI**-Anwendung einen `websocket`:
{!../../docs_src/websockets/tutorial001.py!}
```
-/// note | "Technische Details"
+/// note | Technische Details
Sie können auch `from starlette.websockets import WebSocket` verwenden.
@@ -141,7 +141,7 @@ Diese funktionieren auf die gleiche Weise wie für andere FastAPI-Endpunkte/*Pfa
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -155,7 +155,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -196,7 +196,7 @@ Dort können Sie einstellen:
* Die „Item ID“, die im Pfad verwendet wird.
* Das „Token“, das als Query-Parameter verwendet wird.
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass der Query-„Token“ von einer Abhängigkeit verarbeitet wird.
@@ -238,7 +238,7 @@ Das wird die Ausnahme `WebSocketDisconnect` auslösen und alle anderen Clients e
Client #1596980209979 left the chat
```
-/// tip | "Tipp"
+/// tip | Tipp
Die obige Anwendung ist ein minimales und einfaches Beispiel, das zeigt, wie Nachrichten verarbeitet und an mehrere WebSocket-Verbindungen gesendet werden.
diff --git a/docs/de/docs/alternatives.md b/docs/de/docs/alternatives.md
index 49e1cc6f0..611315501 100644
--- a/docs/de/docs/alternatives.md
+++ b/docs/de/docs/alternatives.md
@@ -30,13 +30,13 @@ Es wird von vielen Unternehmen verwendet, darunter Mozilla, Red Hat und Eventbri
Es war eines der ersten Beispiele für **automatische API-Dokumentation**, und dies war insbesondere eine der ersten Ideen, welche „die Suche nach“ **FastAPI** inspirierten.
-/// note | "Hinweis"
+/// note | Hinweis
Das Django REST Framework wurde von Tom Christie erstellt. Derselbe Schöpfer von Starlette und Uvicorn, auf denen **FastAPI** basiert.
///
-/// check | "Inspirierte **FastAPI**"
+/// check | Inspirierte **FastAPI**
Eine automatische API-Dokumentationsoberfläche zu haben.
@@ -56,7 +56,7 @@ Diese Entkopplung der Teile und die Tatsache, dass es sich um ein „Mikroframew
Angesichts der Einfachheit von Flask schien es eine gute Ergänzung zum Erstellen von APIs zu sein. Als Nächstes musste ein „Django REST Framework“ für Flask gefunden werden.
-/// check | "Inspirierte **FastAPI**"
+/// check | Inspirierte **FastAPI**
Ein Mikroframework zu sein. Es einfach zu machen, die benötigten Tools und Teile zu kombinieren.
@@ -98,7 +98,7 @@ def read_url():
Sehen Sie sich die Ähnlichkeiten in `requests.get(...)` und `@app.get(...)` an.
-/// check | "Inspirierte **FastAPI**"
+/// check | Inspirierte **FastAPI**
* Über eine einfache und intuitive API zu verfügen.
* HTTP-Methodennamen (Operationen) direkt, auf einfache und intuitive Weise zu verwenden.
@@ -118,7 +118,7 @@ Irgendwann wurde Swagger an die Linux Foundation übergeben und in OpenAPI umben
Aus diesem Grund spricht man bei Version 2.0 häufig von „Swagger“ und ab Version 3 von „OpenAPI“.
-/// check | "Inspirierte **FastAPI**"
+/// check | Inspirierte **FastAPI**
Einen offenen Standard für API-Spezifikationen zu übernehmen und zu verwenden, anstelle eines benutzerdefinierten Schemas.
@@ -147,7 +147,7 @@ Für diese Funktionen wurde Marshmallow entwickelt. Es ist eine großartige Bibl
Aber sie wurde erstellt, bevor Typhinweise in Python existierten. Um also ein <abbr title="die Definition, wie Daten geformt sein werden sollen">Schema</abbr> zu definieren, müssen Sie bestimmte Werkzeuge und Klassen verwenden, die von Marshmallow bereitgestellt werden.
-/// check | "Inspirierte **FastAPI**"
+/// check | Inspirierte **FastAPI**
Code zu verwenden, um „Schemas“ zu definieren, welche Datentypen und Validierung automatisch bereitstellen.
@@ -169,7 +169,7 @@ Webargs wurde von denselben Marshmallow-Entwicklern erstellt.
///
-/// check | "Inspirierte **FastAPI**"
+/// check | Inspirierte **FastAPI**
Eingehende Requestdaten automatisch zu validieren.
@@ -199,7 +199,7 @@ APISpec wurde von denselben Marshmallow-Entwicklern erstellt.
///
-/// check | "Inspirierte **FastAPI**"
+/// check | Inspirierte **FastAPI**
Den offenen Standard für APIs, OpenAPI, zu unterstützen.
@@ -231,7 +231,7 @@ Flask-apispec wurde von denselben Marshmallow-Entwicklern erstellt.
///
-/// check | "Inspirierte **FastAPI**"
+/// check | Inspirierte **FastAPI**
Das OpenAPI-Schema automatisch zu generieren, aus demselben Code, welcher die Serialisierung und Validierung definiert.
@@ -251,7 +251,7 @@ Da TypeScript-Daten jedoch nach der Kompilierung nach JavaScript nicht erhalten
Es kann nicht sehr gut mit verschachtelten Modellen umgehen. Wenn es sich beim JSON-Body in der Anfrage also um ein JSON-Objekt mit inneren Feldern handelt, die wiederum verschachtelte JSON-Objekte sind, kann er nicht richtig dokumentiert und validiert werden.
-/// check | "Inspirierte **FastAPI**"
+/// check | Inspirierte **FastAPI**
Python-Typen zu verwenden, um eine hervorragende Editorunterstützung zu erhalten.
@@ -263,7 +263,7 @@ Python-Typen zu verwenden, um eine hervorragende Editorunterstützung zu erhalte
Es war eines der ersten extrem schnellen Python-Frameworks, welches auf `asyncio` basierte. Es wurde so gestaltet, dass es Flask sehr ähnlich ist.
-/// note | "Technische Details"
+/// note | Technische Details
Es verwendete <a href="https://github.com/MagicStack/uvloop" class="external-link" target="_blank">`uvloop`</a> anstelle der standardmäßigen Python-`asyncio`-Schleife. Das hat es so schnell gemacht.
@@ -271,7 +271,7 @@ Hat eindeutig Uvicorn und Starlette inspiriert, welche derzeit in offenen Benchm
///
-/// check | "Inspirierte **FastAPI**"
+/// check | Inspirierte **FastAPI**
Einen Weg zu finden, eine hervorragende Performanz zu haben.
@@ -287,7 +287,7 @@ Es ist so konzipiert, dass es über Funktionen verfügt, welche zwei Parameter e
Daher müssen Datenvalidierung, Serialisierung und Dokumentation im Code und nicht automatisch erfolgen. Oder sie müssen als Framework oberhalb von Falcon implementiert werden, so wie Hug. Dieselbe Unterscheidung findet auch in anderen Frameworks statt, die vom Design von Falcon inspiriert sind und ein Requestobjekt und ein Responseobjekt als Parameter haben.
-/// check | "Inspirierte **FastAPI**"
+/// check | Inspirierte **FastAPI**
Wege zu finden, eine großartige Performanz zu erzielen.
@@ -313,7 +313,7 @@ Das Dependency Injection System erfordert eine Vorab-Registrierung der Abhängig
Routen werden an einer einzigen Stelle deklariert, indem Funktionen verwendet werden, die an anderen Stellen deklariert wurden (anstatt Dekoratoren zu verwenden, welche direkt über der Funktion platziert werden können, welche den Endpunkt verarbeitet). Dies ähnelt eher der Vorgehensweise von Django als der Vorgehensweise von Flask (und Starlette). Es trennt im Code Dinge, die relativ eng miteinander gekoppelt sind.
-/// check | "Inspirierte **FastAPI**"
+/// check | Inspirierte **FastAPI**
Zusätzliche Validierungen für Datentypen zu definieren, mithilfe des „Default“-Werts von Modellattributen. Dies verbessert die Editorunterstützung und war zuvor in Pydantic nicht verfügbar.
@@ -341,7 +341,7 @@ Hug wurde von Timothy Crosley erstellt, dem gleichen Schöpfer von <a href="http
///
-/// check | "Ideen, die **FastAPI** inspiriert haben"
+/// check | Ideen, die **FastAPI** inspiriert haben
Hug inspirierte Teile von APIStar und war eines der Tools, die ich am vielversprechendsten fand, neben APIStar.
@@ -385,7 +385,7 @@ APIStar wurde von Tom Christie erstellt. Derselbe, welcher Folgendes erstellt ha
///
-/// check | "Inspirierte **FastAPI**"
+/// check | Inspirierte **FastAPI**
Zu existieren.
@@ -409,7 +409,7 @@ Das macht es äußerst intuitiv.
Es ist vergleichbar mit Marshmallow. Obwohl es in Benchmarks schneller als Marshmallow ist. Und da es auf den gleichen Python-Typhinweisen basiert, ist die Editorunterstützung großartig.
-/// check | "**FastAPI** verwendet es, um"
+/// check | **FastAPI** verwendet es, um
Die gesamte Datenvalidierung, Datenserialisierung und automatische Modelldokumentation (basierend auf JSON Schema) zu erledigen.
@@ -444,7 +444,7 @@ Es bietet jedoch keine automatische Datenvalidierung, Serialisierung oder Dokume
Das ist eines der wichtigsten Dinge, welche **FastAPI** hinzufügt, alles basierend auf Python-Typhinweisen (mit Pydantic). Das, plus, das Dependency Injection System, Sicherheitswerkzeuge, OpenAPI-Schemagenerierung, usw.
-/// note | "Technische Details"
+/// note | Technische Details
ASGI ist ein neuer „Standard“, welcher von Mitgliedern des Django-Kernteams entwickelt wird. Es handelt sich immer noch nicht um einen „Python-Standard“ (ein PEP), obwohl sie gerade dabei sind, das zu tun.
@@ -452,7 +452,7 @@ Dennoch wird es bereits von mehreren Tools als „Standard“ verwendet. Das ver
///
-/// check | "**FastAPI** verwendet es, um"
+/// check | **FastAPI** verwendet es, um
Alle Kern-Webaspekte zu handhaben. Und fügt Funktionen obenauf.
@@ -470,7 +470,7 @@ Es handelt sich nicht um ein Webframework, sondern um einen Server. Beispielswei
Es ist der empfohlene Server für Starlette und **FastAPI**.
-/// check | "**FastAPI** empfiehlt es als"
+/// check | **FastAPI** empfiehlt es als
Hauptwebserver zum Ausführen von **FastAPI**-Anwendungen.
diff --git a/docs/de/docs/async.md b/docs/de/docs/async.md
index 74b6b6968..b5b3a4c52 100644
--- a/docs/de/docs/async.md
+++ b/docs/de/docs/async.md
@@ -401,7 +401,7 @@ All das ist es, was FastAPI (via Starlette) befeuert und es eine so beeindrucken
## Sehr technische Details
-/// warning | "Achtung"
+/// warning | Achtung
Das folgende können Sie wahrscheinlich überspringen.
diff --git a/docs/de/docs/contributing.md b/docs/de/docs/contributing.md
index 58567ad7f..9dfa1e65a 100644
--- a/docs/de/docs/contributing.md
+++ b/docs/de/docs/contributing.md
@@ -106,7 +106,7 @@ $ python -m pip install --upgrade pip
</div>
-/// tip | "Tipp"
+/// tip | Tipp
Aktivieren Sie jedes Mal, wenn Sie ein neues Package mit `pip` in dieser Umgebung installieren, die Umgebung erneut.
@@ -138,7 +138,7 @@ Und wenn Sie diesen lokalen FastAPI-Quellcode aktualisieren und dann die Python-
Auf diese Weise müssen Sie Ihre lokale Version nicht „installieren“, um jede Änderung testen zu können.
-/// note | "Technische Details"
+/// note | Technische Details
Das geschieht nur, wenn Sie die Installation mit der enthaltenen `requirements.txt` durchführen, anstatt `pip install fastapi` direkt auszuführen.
@@ -186,7 +186,7 @@ Das stellt die Dokumentation unter `http://127.0.0.1:8008` bereit.
Auf diese Weise können Sie die Dokumentation/Quelldateien bearbeiten und die Änderungen live sehen.
-/// tip | "Tipp"
+/// tip | Tipp
Alternativ können Sie die Schritte des Skripts auch manuell ausführen.
@@ -229,7 +229,7 @@ Die Dokumentation verwendet <a href="https://www.mkdocs.org/" class="external-li
Und es gibt zusätzliche Tools/Skripte für Übersetzungen, in `./scripts/docs.py`.
-/// tip | "Tipp"
+/// tip | Tipp
Sie müssen sich den Code in `./scripts/docs.py` nicht anschauen, verwenden Sie ihn einfach in der Kommandozeile.
@@ -283,7 +283,7 @@ Hier sind die Schritte, die Ihnen bei Übersetzungen helfen.
* Sehen Sie diese Pull Requests durch (Review), schlagen Sie Änderungen vor, oder segnen Sie sie ab (Approval). Bei den Sprachen, die ich nicht spreche, warte ich, bis mehrere andere die Übersetzung durchgesehen haben, bevor ich den Pull Request merge.
-/// tip | "Tipp"
+/// tip | Tipp
Sie können <a href="https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request" class="external-link" target="_blank">Kommentare mit Änderungsvorschlägen</a> zu vorhandenen Pull Requests hinzufügen.
@@ -303,7 +303,7 @@ Angenommen, Sie möchten eine Seite für eine Sprache übersetzen, die bereits
Im Spanischen lautet der Zwei-Buchstaben-Code `es`. Das Verzeichnis für spanische Übersetzungen befindet sich also unter `docs/es/`.
-/// tip | "Tipp"
+/// tip | Tipp
Die Haupt („offizielle“) Sprache ist Englisch und befindet sich unter `docs/en/`.
@@ -324,7 +324,7 @@ $ python ./scripts/docs.py live es
</div>
-/// tip | "Tipp"
+/// tip | Tipp
Alternativ können Sie die Schritte des Skripts auch manuell ausführen.
@@ -360,7 +360,7 @@ docs/en/docs/features.md
docs/es/docs/features.md
```
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass die einzige Änderung in Pfad und Dateiname der Sprachcode ist, von `en` zu `es`.
@@ -399,7 +399,7 @@ Obiges Kommando hat eine Datei `docs/ht/mkdocs.yml` mit einer Minimal-Konfigurat
INHERIT: ../en/mkdocs.yml
```
-/// tip | "Tipp"
+/// tip | Tipp
Sie können diese Datei mit diesem Inhalt auch einfach manuell erstellen.
diff --git a/docs/de/docs/deployment/concepts.md b/docs/de/docs/deployment/concepts.md
index 3c1c0cfce..97ad854e2 100644
--- a/docs/de/docs/deployment/concepts.md
+++ b/docs/de/docs/deployment/concepts.md
@@ -151,7 +151,7 @@ Und dennoch möchten Sie wahrscheinlich nicht, dass die Anwendung tot bleibt, we
Aber in den Fällen mit wirklich schwerwiegenden Fehlern, die den laufenden **Prozess** zum Absturz bringen, benötigen Sie eine externe Komponente, die den Prozess **neu startet**, zumindest ein paar Mal ...
-/// tip | "Tipp"
+/// tip | Tipp
... Obwohl es wahrscheinlich keinen Sinn macht, sie immer wieder neu zu starten, wenn die gesamte Anwendung einfach **sofort abstürzt**. Aber in diesen Fällen werden Sie es wahrscheinlich während der Entwicklung oder zumindest direkt nach dem Deployment bemerken.
@@ -241,7 +241,7 @@ Hier sind einige mögliche Kombinationen und Strategien:
* **Cloud-Dienste**, welche das für Sie erledigen
* Der Cloud-Dienst wird wahrscheinlich **die Replikation für Sie übernehmen**. Er würde Sie möglicherweise **einen auszuführenden Prozess** oder ein **zu verwendendes Container-Image** definieren lassen, in jedem Fall wäre es höchstwahrscheinlich **ein einzelner Uvicorn-Prozess**, und der Cloud-Dienst wäre auch verantwortlich für die Replikation.
-/// tip | "Tipp"
+/// tip | Tipp
Machen Sie sich keine Sorgen, wenn einige dieser Punkte zu **Containern**, Docker oder Kubernetes noch nicht viel Sinn ergeben.
@@ -263,7 +263,7 @@ Und Sie müssen sicherstellen, dass es sich um einen einzelnen Prozess handelt,
Natürlich gibt es Fälle, in denen es kein Problem darstellt, die Vorab-Schritte mehrmals auszuführen. In diesem Fall ist die Handhabung viel einfacher.
-/// tip | "Tipp"
+/// tip | Tipp
Bedenken Sie außerdem, dass Sie, abhängig von Ihrer Einrichtung, in manchen Fällen **gar keine Vorab-Schritte** benötigen, bevor Sie die Anwendung starten.
@@ -281,7 +281,7 @@ Hier sind einige mögliche Ideen:
* Ein Bash-Skript, das die Vorab-Schritte ausführt und dann Ihre Anwendung startet
* Sie benötigen immer noch eine Möglichkeit, *dieses* Bash-Skript zu starten/neu zu starten, Fehler zu erkennen, usw.
-/// tip | "Tipp"
+/// tip | Tipp
Konkretere Beispiele hierfür mit Containern gebe ich Ihnen in einem späteren Kapitel: [FastAPI in Containern – Docker](docker.md){.internal-link target=_blank}.
diff --git a/docs/de/docs/deployment/docker.md b/docs/de/docs/deployment/docker.md
index c11dc4127..a2734e068 100644
--- a/docs/de/docs/deployment/docker.md
+++ b/docs/de/docs/deployment/docker.md
@@ -4,7 +4,7 @@ Beim Deployment von FastAPI-Anwendungen besteht ein gängiger Ansatz darin, ein
Die Verwendung von Linux-Containern bietet mehrere Vorteile, darunter **Sicherheit**, **Replizierbarkeit**, **Einfachheit** und andere.
-/// tip | "Tipp"
+/// tip | Tipp
Sie haben es eilig und kennen sich bereits aus? Springen Sie zum [`Dockerfile` unten 👇](#ein-docker-image-fur-fastapi-erstellen).
@@ -231,7 +231,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
Da das Programm unter `/code` gestartet wird und sich darin das Verzeichnis `./app` mit Ihrem Code befindet, kann **Uvicorn** `app` sehen und aus `app.main` **importieren**.
-/// tip | "Tipp"
+/// tip | Tipp
Lernen Sie, was jede Zeile bewirkt, indem Sie auf die Zahlenblasen im Code klicken. 👆
@@ -305,7 +305,7 @@ $ docker build -t myimage .
</div>
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie das `.` am Ende, es entspricht `./` und teilt Docker mit, welches Verzeichnis zum Erstellen des Containerimages verwendet werden soll.
@@ -409,7 +409,7 @@ Wenn wir uns nur auf das **Containerimage** für eine FastAPI-Anwendung (und sp
Es könnte sich um einen anderen Container handeln, zum Beispiel mit <a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a>, welcher **HTTPS** und **automatischen** Erwerb von **Zertifikaten** handhabt.
-/// tip | "Tipp"
+/// tip | Tipp
Traefik verfügt über Integrationen mit Docker, Kubernetes und anderen, sodass Sie damit ganz einfach HTTPS für Ihre Container einrichten und konfigurieren können.
@@ -441,7 +441,7 @@ Bei der Verwendung von Containern ist normalerweise eine Komponente vorhanden, *
Da diese Komponente die **Last** an Requests aufnehmen und diese (hoffentlich) **ausgewogen** auf die Worker verteilen würde, wird sie üblicherweise auch **Load Balancer** – Lastverteiler – genannt.
-/// tip | "Tipp"
+/// tip | Tipp
Die gleiche **TLS-Terminierungsproxy**-Komponente, die für HTTPS verwendet wird, wäre wahrscheinlich auch ein **Load Balancer**.
@@ -544,7 +544,7 @@ Dieses Image wäre vor allem in den oben beschriebenen Situationen nützlich: [C
* <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
-/// warning | "Achtung"
+/// warning | Achtung
Es besteht eine hohe Wahrscheinlichkeit, dass Sie dieses oder ein ähnliches Basisimage **nicht** benötigen und es besser wäre, wenn Sie das Image von Grund auf neu erstellen würden, wie [oben beschrieben in: Ein Docker-Image für FastAPI erstellen](#ein-docker-image-fur-fastapi-erstellen).
@@ -556,7 +556,7 @@ Es verfügt über **vernünftige Standardeinstellungen**, aber Sie können trotz
Es unterstützt auch die Ausführung von <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker#pre_start_path" class="external-link" target="_blank">**Vorab-Schritten vor dem Start** </a> mit einem Skript.
-/// tip | "Tipp"
+/// tip | Tipp
Um alle Konfigurationen und Optionen anzuzeigen, gehen Sie zur Docker-Image-Seite: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
@@ -687,7 +687,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
11. Führe den Befehl `uvicorn` aus und weise ihn an, das aus `app.main` importierte `app`-Objekt zu verwenden.
-/// tip | "Tipp"
+/// tip | Tipp
Klicken Sie auf die Zahlenblasen, um zu sehen, was jede Zeile bewirkt.
diff --git a/docs/de/docs/deployment/https.md b/docs/de/docs/deployment/https.md
index b1f0aca77..630582995 100644
--- a/docs/de/docs/deployment/https.md
+++ b/docs/de/docs/deployment/https.md
@@ -4,7 +4,7 @@ Es ist leicht anzunehmen, dass HTTPS etwas ist, was einfach nur „aktiviert“
Aber es ist viel komplexer als das.
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie es eilig haben oder es Ihnen egal ist, fahren Sie mit den nächsten Abschnitten fort, um Schritt-für-Schritt-Anleitungen für die Einrichtung der verschiedenen Technologien zu erhalten.
@@ -71,7 +71,7 @@ In dem oder den DNS-Server(n) würden Sie einen Eintrag (einen „`A record`“)
Sie würden dies wahrscheinlich nur einmal tun, beim ersten Mal, wenn Sie alles einrichten.
-/// tip | "Tipp"
+/// tip | Tipp
Dieser Domainnamen-Aspekt liegt weit vor HTTPS, aber da alles von der Domain und der IP-Adresse abhängt, lohnt es sich, das hier zu erwähnen.
@@ -121,7 +121,7 @@ Danach verfügen der Client und der Server über eine **verschlüsselte TCP-Verb
Und genau das ist **HTTPS**, es ist einfach **HTTP** innerhalb einer **sicheren TLS-Verbindung**, statt einer puren (unverschlüsselten) TCP-Verbindung.
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass die Verschlüsselung der Kommunikation auf der **TCP-Ebene** und nicht auf der HTTP-Ebene erfolgt.
diff --git a/docs/de/docs/deployment/manually.md b/docs/de/docs/deployment/manually.md
index 2b4ed3fad..fdb33f7fe 100644
--- a/docs/de/docs/deployment/manually.md
+++ b/docs/de/docs/deployment/manually.md
@@ -36,7 +36,7 @@ $ pip install "uvicorn[standard]"
</div>
-/// tip | "Tipp"
+/// tip | Tipp
Durch das Hinzufügen von `standard` installiert und verwendet Uvicorn einige empfohlene zusätzliche Abhängigkeiten.
@@ -96,7 +96,7 @@ Running on 0.0.0.0:8080 over http (CTRL + C to quit)
////
-/// warning | "Achtung"
+/// warning | Achtung
Denken Sie daran, die Option `--reload` zu entfernen, wenn Sie diese verwendet haben.
diff --git a/docs/de/docs/deployment/versions.md b/docs/de/docs/deployment/versions.md
index 2d10ac4b6..5b8c69754 100644
--- a/docs/de/docs/deployment/versions.md
+++ b/docs/de/docs/deployment/versions.md
@@ -42,7 +42,7 @@ Gemäß den Konventionen zur semantischen Versionierung könnte jede Version unt
FastAPI folgt auch der Konvention, dass jede „PATCH“-Versionsänderung für Bugfixes und abwärtskompatible Änderungen gedacht ist.
-/// tip | "Tipp"
+/// tip | Tipp
Der „PATCH“ ist die letzte Zahl, zum Beispiel ist in `0.2.3` die PATCH-Version `3`.
@@ -56,7 +56,7 @@ fastapi>=0.45.0,<0.46.0
Nicht abwärtskompatible Änderungen und neue Funktionen werden in „MINOR“-Versionen hinzugefügt.
-/// tip | "Tipp"
+/// tip | Tipp
„MINOR“ ist die Zahl in der Mitte, zum Beispiel ist in `0.2.3` die MINOR-Version `2`.
diff --git a/docs/de/docs/help-fastapi.md b/docs/de/docs/help-fastapi.md
index 2c84a5e5b..0b9c52316 100644
--- a/docs/de/docs/help-fastapi.md
+++ b/docs/de/docs/help-fastapi.md
@@ -228,7 +228,7 @@ Wenn Sie mir dabei helfen können, **helfen Sie mir, FastAPI am Laufen zu erhalt
Treten Sie dem 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" target="_blank">Discord-Chatserver</a> 👥 bei und treffen Sie sich mit anderen Mitgliedern der FastAPI-Community.
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie Fragen haben, stellen Sie sie bei <a href="https://github.com/fastapi/fastapi/discussions/new?category=questions" class="external-link" target="_blank">GitHub Diskussionen</a>, es besteht eine viel bessere Chance, dass Sie hier Hilfe von den [FastAPI-Experten](fastapi-people.md#experten){.internal-link target=_blank} erhalten.
diff --git a/docs/de/docs/how-to/custom-docs-ui-assets.md b/docs/de/docs/how-to/custom-docs-ui-assets.md
index e5fd20a10..a292be69b 100644
--- a/docs/de/docs/how-to/custom-docs-ui-assets.md
+++ b/docs/de/docs/how-to/custom-docs-ui-assets.md
@@ -40,7 +40,7 @@ Und genau so für ReDoc ...
{!../../docs_src/custom_docs_ui/tutorial001.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Die *Pfadoperation* für `swagger_ui_redirect` ist ein Hilfsmittel bei der Verwendung von OAuth2.
@@ -180,7 +180,7 @@ Und genau so für ReDoc ...
{!../../docs_src/custom_docs_ui/tutorial002.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Die *Pfadoperation* für `swagger_ui_redirect` ist ein Hilfsmittel bei der Verwendung von OAuth2.
diff --git a/docs/de/docs/how-to/custom-request-and-route.md b/docs/de/docs/how-to/custom-request-and-route.md
index f81fa1da3..ef71d96dc 100644
--- a/docs/de/docs/how-to/custom-request-and-route.md
+++ b/docs/de/docs/how-to/custom-request-and-route.md
@@ -6,7 +6,7 @@ Das kann insbesondere eine gute Alternative zur Logik in einer Middleware sein.
Wenn Sie beispielsweise den Requestbody lesen oder manipulieren möchten, bevor er von Ihrer Anwendung verarbeitet wird.
-/// danger | "Gefahr"
+/// danger | Gefahr
Dies ist eine „fortgeschrittene“ Funktion.
@@ -30,7 +30,7 @@ Und eine `APIRoute`-Unterklasse zur Verwendung dieser benutzerdefinierten Reques
### Eine benutzerdefinierte `GzipRequest`-Klasse erstellen
-/// tip | "Tipp"
+/// tip | Tipp
Dies ist nur ein einfaches Beispiel, um zu demonstrieren, wie es funktioniert. Wenn Sie Gzip-Unterstützung benötigen, können Sie die bereitgestellte [`GzipMiddleware`](../advanced/middleware.md#gzipmiddleware){.internal-link target=_blank} verwenden.
@@ -60,7 +60,7 @@ Hier verwenden wir sie, um aus dem ursprünglichen Request einen `GzipRequest` z
{!../../docs_src/custom_request_and_route/tutorial001.py!}
```
-/// note | "Technische Details"
+/// note | Technische Details
Ein `Request` hat ein `request.scope`-Attribut, welches einfach ein Python-`dict` ist, welches die mit dem Request verbundenen Metadaten enthält.
@@ -84,7 +84,7 @@ Aufgrund unserer Änderungen in `GzipRequest.body` wird der Requestbody jedoch b
## Zugriff auf den Requestbody in einem Exceptionhandler
-/// tip | "Tipp"
+/// tip | Tipp
Um dasselbe Problem zu lösen, ist es wahrscheinlich viel einfacher, den `body` in einem benutzerdefinierten Handler für `RequestValidationError` zu verwenden ([Fehlerbehandlung](../tutorial/handling-errors.md#den-requestvalidationerror-body-verwenden){.internal-link target=_blank}).
diff --git a/docs/de/docs/how-to/graphql.md b/docs/de/docs/how-to/graphql.md
index cde56ffde..4366ea52d 100644
--- a/docs/de/docs/how-to/graphql.md
+++ b/docs/de/docs/how-to/graphql.md
@@ -4,7 +4,7 @@ Da **FastAPI** auf dem **ASGI**-Standard basiert, ist es sehr einfach, jede **Gr
Sie können normale FastAPI-*Pfadoperationen* mit GraphQL in derselben Anwendung kombinieren.
-/// tip | "Tipp"
+/// tip | Tipp
**GraphQL** löst einige sehr spezifische Anwendungsfälle.
@@ -49,7 +49,7 @@ Frühere Versionen von Starlette enthielten eine `GraphQLApp`-Klasse zur Integra
Das wurde von Starlette deprecated, aber wenn Sie Code haben, der das verwendet, können Sie einfach zu <a href="https://github.com/ciscorn/starlette-graphene3" class="external-link" target="_blank">starlette-graphene3</a> **migrieren**, welches denselben Anwendungsfall abdeckt und über eine **fast identische Schnittstelle** verfügt.
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie GraphQL benötigen, würde ich Ihnen trotzdem empfehlen, sich <a href="https://strawberry.rocks/" class="external-link" target="_blank">Strawberry</a> anzuschauen, da es auf Typannotationen basiert, statt auf benutzerdefinierten Klassen und Typen.
diff --git a/docs/de/docs/how-to/index.md b/docs/de/docs/how-to/index.md
index 75779a01c..84a178fc8 100644
--- a/docs/de/docs/how-to/index.md
+++ b/docs/de/docs/how-to/index.md
@@ -6,7 +6,7 @@ Die meisten dieser Ideen sind mehr oder weniger **unabhängig**, und in den meis
Wenn etwas für Ihr Projekt interessant und nützlich erscheint, lesen Sie es, andernfalls überspringen Sie es einfach.
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie strukturiert **FastAPI lernen** möchten (empfohlen), lesen Sie stattdessen Kapitel für Kapitel das [Tutorial – Benutzerhandbuch](../tutorial/index.md){.internal-link target=_blank}.
diff --git a/docs/de/docs/python-types.md b/docs/de/docs/python-types.md
index a9ab4beab..81d43bc5b 100644
--- a/docs/de/docs/python-types.md
+++ b/docs/de/docs/python-types.md
@@ -12,7 +12,7 @@ Dies ist lediglich eine **schnelle Anleitung / Auffrischung** über Pythons Typh
Aber selbst wenn Sie **FastAPI** nie verwenden, wird es für Sie nützlich sein, ein wenig darüber zu lernen.
-/// note | "Hinweis"
+/// note | Hinweis
Wenn Sie ein Python-Experte sind und bereits alles über Typhinweise wissen, überspringen Sie dieses Kapitel und fahren Sie mit dem nächsten fort.
@@ -195,7 +195,7 @@ Da die Liste ein Typ ist, welcher innere Typen enthält, werden diese von eckige
////
-/// tip | "Tipp"
+/// tip | Tipp
Die inneren Typen in den eckigen Klammern werden als „Typ-Parameter“ bezeichnet.
@@ -205,7 +205,7 @@ In diesem Fall ist `str` der Typ-Parameter, der an `List` übergeben wird (oder
Das bedeutet: Die Variable `items` ist eine Liste – `list` – und jedes der Elemente in dieser Liste ist ein String – `str`.
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie Python 3.9 oder höher verwenden, müssen Sie `List` nicht von `typing` importieren, Sie können stattdessen den regulären `list`-Typ verwenden.
@@ -495,7 +495,7 @@ Um mehr über <a href="https://pydantic-docs.helpmanual.io/" class="external-lin
Viel mehr von all dem werden Sie in praktischer Anwendung im [Tutorial - Benutzerhandbuch](tutorial/index.md){.internal-link target=_blank} sehen.
-/// tip | "Tipp"
+/// tip | Tipp
Pydantic verhält sich speziell, wenn Sie `Optional` oder `Union[Etwas, None]` ohne einen Default-Wert verwenden. Sie können darüber in der Pydantic Dokumentation unter <a href="https://docs.pydantic.dev/2.3/usage/models/#required-fields" class="external-link" target="_blank">Required fields</a> mehr erfahren.
@@ -537,7 +537,7 @@ Im Moment müssen Sie nur wissen, dass `Annotated` existiert, und dass es Standa
Später werden Sie sehen, wie **mächtig** es sein kann.
-/// tip | "Tipp"
+/// tip | Tipp
Der Umstand, dass es **Standard-Python** ist, bedeutet, dass Sie immer noch die **bestmögliche Entwickler-Erfahrung** in ihrem Editor haben, sowie mit den Tools, die Sie nutzen, um ihren Code zu analysieren, zu refaktorisieren, usw. ✨
diff --git a/docs/de/docs/tutorial/background-tasks.md b/docs/de/docs/tutorial/background-tasks.md
index cd857f5e7..d40b6d4fb 100644
--- a/docs/de/docs/tutorial/background-tasks.md
+++ b/docs/de/docs/tutorial/background-tasks.md
@@ -83,7 +83,7 @@ Die Verwendung von `BackgroundTasks` funktioniert auch mit dem <abbr title="Einb
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -97,7 +97,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
diff --git a/docs/de/docs/tutorial/bigger-applications.md b/docs/de/docs/tutorial/bigger-applications.md
index 000fa1f43..59e91bdcc 100644
--- a/docs/de/docs/tutorial/bigger-applications.md
+++ b/docs/de/docs/tutorial/bigger-applications.md
@@ -29,7 +29,7 @@ Nehmen wir an, Sie haben eine Dateistruktur wie diese:
│ └── admin.py
```
-/// tip | "Tipp"
+/// tip | Tipp
Es gibt mehrere `__init__.py`-Dateien: eine in jedem Verzeichnis oder Unterverzeichnis.
@@ -105,7 +105,7 @@ Alle die gleichen Optionen werden unterstützt.
Alle die gleichen `parameters`, `responses`, `dependencies`, `tags`, usw.
-/// tip | "Tipp"
+/// tip | Tipp
In diesem Beispiel heißt die Variable `router`, aber Sie können ihr einen beliebigen Namen geben.
@@ -139,7 +139,7 @@ Wir werden nun eine einfache Abhängigkeit verwenden, um einen benutzerdefiniert
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -151,7 +151,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// tip | "Tipp"
+/// tip | Tipp
Um dieses Beispiel zu vereinfachen, verwenden wir einen erfundenen Header.
@@ -201,7 +201,7 @@ Wir können auch eine Liste von `tags` und zusätzliche `responses` hinzufügen,
Und wir können eine Liste von `dependencies` hinzufügen, die allen *Pfadoperationen* im Router hinzugefügt und für jeden an sie gerichteten Request ausgeführt/aufgelöst werden.
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass ähnlich wie bei [Abhängigkeiten in *Pfadoperation-Dekoratoren*](dependencies/dependencies-in-path-operation-decorators.md){.internal-link target=_blank} kein Wert an Ihre *Pfadoperation-Funktion* übergeben wird.
@@ -222,7 +222,7 @@ Das Endergebnis ist, dass die Pfade für diese Artikel jetzt wie folgt lauten:
* Zuerst werden die Router-Abhängigkeiten ausgeführt, dann die [`dependencies` im Dekorator](dependencies/dependencies-in-path-operation-decorators.md){.internal-link target=_blank} und dann die normalen Parameterabhängigkeiten.
* Sie können auch [`Security`-Abhängigkeiten mit `scopes`](../advanced/security/oauth2-scopes.md){.internal-link target=_blank} hinzufügen.
-/// tip | "Tipp"
+/// tip | Tipp
`dependencies` im `APIRouter` können beispielsweise verwendet werden, um eine Authentifizierung für eine ganze Gruppe von *Pfadoperationen* zu erfordern. Selbst wenn die Abhängigkeiten nicht jeder einzeln hinzugefügt werden.
@@ -248,7 +248,7 @@ Daher verwenden wir einen relativen Import mit `..` für die Abhängigkeiten:
#### Wie relative Importe funktionieren
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie genau wissen, wie Importe funktionieren, fahren Sie mit dem nächsten Abschnitt unten fort.
@@ -319,7 +319,7 @@ Aber wir können immer noch _mehr_ `tags` hinzufügen, die auf eine bestimmte *P
{!../../docs_src/bigger_applications/app/routers/items.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Diese letzte Pfadoperation wird eine Kombination von Tags haben: `["items", "custom"]`.
@@ -441,7 +441,7 @@ Mit `app.include_router()` können wir jeden `APIRouter` zur Hauptanwendung `Fas
Es wird alle Routen von diesem Router als Teil von dieser inkludieren.
-/// note | "Technische Details"
+/// note | Technische Details
Tatsächlich wird intern eine *Pfadoperation* für jede *Pfadoperation* erstellt, die im `APIRouter` deklariert wurde.
@@ -504,7 +504,7 @@ Hier machen wir es ... nur um zu zeigen, dass wir es können 🤷:
und es wird korrekt funktionieren, zusammen mit allen anderen *Pfadoperationen*, die mit `app.include_router()` hinzugefügt wurden.
-/// info | "Sehr technische Details"
+/// info | Sehr technische Details
**Hinweis**: Dies ist ein sehr technisches Detail, das Sie wahrscheinlich **einfach überspringen** können.
diff --git a/docs/de/docs/tutorial/body-fields.md b/docs/de/docs/tutorial/body-fields.md
index d22524c67..df3d7f939 100644
--- a/docs/de/docs/tutorial/body-fields.md
+++ b/docs/de/docs/tutorial/body-fields.md
@@ -32,7 +32,7 @@ Importieren Sie es zuerst:
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -46,7 +46,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -58,7 +58,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// warning | "Achtung"
+/// warning | Achtung
Beachten Sie, dass `Field` direkt von `pydantic` importiert wird, nicht von `fastapi`, wie die anderen (`Query`, `Path`, `Body`, usw.)
@@ -94,7 +94,7 @@ Dann können Sie `Field` mit Modellattributen deklarieren:
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -108,7 +108,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -122,7 +122,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
`Field` funktioniert genauso wie `Query`, `Path` und `Body`, es hat die gleichen Parameter, usw.
-/// note | "Technische Details"
+/// note | Technische Details
Tatsächlich erstellen `Query`, `Path` und andere, die sie kennenlernen werden, Instanzen von Unterklassen einer allgemeinen Klasse `Param`, die ihrerseits eine Unterklasse von Pydantics `FieldInfo`-Klasse ist.
@@ -134,7 +134,7 @@ Denken Sie daran, dass `Query`, `Path` und andere von `fastapi` tatsächlich Fun
///
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass jedes Modellattribut mit einem Typ, Defaultwert und `Field` die gleiche Struktur hat wie ein Parameter einer Pfadoperation-Funktion, nur mit `Field` statt `Path`, `Query`, `Body`.
@@ -146,7 +146,7 @@ Sie können zusätzliche Information in `Field`, `Query`, `Body`, usw. deklarier
Sie werden später mehr darüber lernen, wie man zusätzliche Information unterbringt, wenn Sie lernen, Beispiele zu deklarieren.
-/// warning | "Achtung"
+/// warning | Achtung
Extra-Schlüssel, die `Field` überreicht werden, werden auch im resultierenden OpenAPI-Schema Ihrer Anwendung gelistet. Da diese Schlüssel nicht notwendigerweise Teil der OpenAPI-Spezifikation sind, könnten einige OpenAPI-Tools, wie etwa [der OpenAPI-Validator](https://validator.swagger.io/), nicht mit Ihrem generierten Schema funktionieren.
diff --git a/docs/de/docs/tutorial/body-multiple-params.md b/docs/de/docs/tutorial/body-multiple-params.md
index 891c98cb2..8a9978d34 100644
--- a/docs/de/docs/tutorial/body-multiple-params.md
+++ b/docs/de/docs/tutorial/body-multiple-params.md
@@ -10,7 +10,7 @@ Und Sie können auch Body-Parameter als optional kennzeichnen, indem Sie den Def
{* ../../docs_src/body_multiple_params/tutorial001_an_py310.py hl[18:20] *}
-/// note | "Hinweis"
+/// note | Hinweis
Beachten Sie, dass in diesem Fall das `item`, welches vom Body genommen wird, optional ist. Da es `None` als Defaultwert hat.
@@ -52,7 +52,7 @@ Es wird deshalb die Parameternamen als Schlüssel (Feldnamen) im Body verwenden,
}
```
-/// note | "Hinweis"
+/// note | Hinweis
Beachten Sie, dass, obwohl `item` wie zuvor deklariert wurde, es nun unter einem Schlüssel `item` im Body erwartet wird.
diff --git a/docs/de/docs/tutorial/body-nested-models.md b/docs/de/docs/tutorial/body-nested-models.md
index 13153aa68..478064a8b 100644
--- a/docs/de/docs/tutorial/body-nested-models.md
+++ b/docs/de/docs/tutorial/body-nested-models.md
@@ -420,7 +420,7 @@ Im folgenden Beispiel akzeptieren Sie irgendein `dict`, solange es `int`-Schlüs
////
-/// tip | "Tipp"
+/// tip | Tipp
Bedenken Sie, dass JSON nur `str` als Schlüssel unterstützt.
diff --git a/docs/de/docs/tutorial/body-updates.md b/docs/de/docs/tutorial/body-updates.md
index ed5c1890f..01a534a23 100644
--- a/docs/de/docs/tutorial/body-updates.md
+++ b/docs/de/docs/tutorial/body-updates.md
@@ -54,7 +54,7 @@ Sie können auch die <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/
Das bedeutet, sie senden nur die Daten, die Sie aktualisieren wollen, der Rest bleibt unverändert.
-/// note | "Hinweis"
+/// note | Hinweis
`PATCH` wird seltener verwendet und ist weniger bekannt als `PUT`.
@@ -185,7 +185,7 @@ Zusammengefasst, um Teil-Ersetzungen vorzunehmen:
////
-/// tip | "Tipp"
+/// tip | Tipp
Sie können tatsächlich die gleiche Technik mit einer HTTP `PUT` Operation verwenden.
@@ -193,7 +193,7 @@ Aber dieses Beispiel verwendet `PATCH`, da dieses für solche Anwendungsfälle g
///
-/// note | "Hinweis"
+/// note | Hinweis
Beachten Sie, dass das hereinkommende Modell immer noch validiert wird.
diff --git a/docs/de/docs/tutorial/body.md b/docs/de/docs/tutorial/body.md
index 3a64e747e..1038ebe91 100644
--- a/docs/de/docs/tutorial/body.md
+++ b/docs/de/docs/tutorial/body.md
@@ -149,7 +149,7 @@ Aber Sie bekommen die gleiche Editor-Unterstützung in <a href="https://www.jetb
<img src="/img/tutorial/body/image05.png">
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a> als Ihren Editor verwenden, probieren Sie das <a href="https://github.com/koxudaxi/pydantic-pycharm-plugin/" class="external-link" target="_blank">Pydantic PyCharm Plugin</a> aus.
@@ -233,7 +233,7 @@ Die Funktionsparameter werden wie folgt erkannt:
* Wenn der Parameter ein **einfacher Typ** ist (wie `int`, `float`, `str`, `bool`, usw.), wird er als **Query**-Parameter interpretiert.
* Wenn der Parameter vom Typ eines **Pydantic-Modells** ist, wird er als Request**body** interpretiert.
-/// note | "Hinweis"
+/// note | Hinweis
FastAPI weiß, dass der Wert von `q` nicht erforderlich ist, wegen des definierten Defaultwertes `= None`
diff --git a/docs/de/docs/tutorial/cookie-params.md b/docs/de/docs/tutorial/cookie-params.md
index 4714a59ae..ecb14ad03 100644
--- a/docs/de/docs/tutorial/cookie-params.md
+++ b/docs/de/docs/tutorial/cookie-params.md
@@ -32,7 +32,7 @@ Importieren Sie zuerst `Cookie`:
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -46,7 +46,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -90,7 +90,7 @@ Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra Validierungs
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -104,7 +104,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -116,7 +116,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// note | "Technische Details"
+/// note | Technische Details
`Cookie` ist eine Schwesterklasse von `Path` und `Query`. Sie erbt von derselben gemeinsamen `Param`-Elternklasse.
diff --git a/docs/de/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/de/docs/tutorial/dependencies/classes-as-dependencies.md
index a660ab337..a3e3d2c60 100644
--- a/docs/de/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/de/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -32,7 +32,7 @@ Im vorherigen Beispiel haben wir ein `dict` von unserer Abhängigkeit („Depend
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -46,7 +46,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -145,7 +145,7 @@ Dann können wir das „Dependable“ `common_parameters` der Abhängigkeit von
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -159,7 +159,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -199,7 +199,7 @@ Achten Sie auf die Methode `__init__`, die zum Erstellen der Instanz der Klasse
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -213,7 +213,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -253,7 +253,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -267,7 +267,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -319,7 +319,7 @@ Jetzt können Sie Ihre Abhängigkeit mithilfe dieser Klasse deklarieren.
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -333,7 +333,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -361,7 +361,7 @@ commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -397,7 +397,7 @@ commons: Annotated[CommonQueryParams, ...
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -423,7 +423,7 @@ commons: Annotated[Any, Depends(CommonQueryParams)]
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -463,7 +463,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -477,7 +477,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -507,7 +507,7 @@ commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -535,7 +535,7 @@ commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -559,7 +559,7 @@ commons: Annotated[CommonQueryParams, Depends()]
//// tab | Python 3.8 nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -601,7 +601,7 @@ Dasselbe Beispiel würde dann so aussehen:
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -615,7 +615,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -629,7 +629,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
... und **FastAPI** wird wissen, was zu tun ist.
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie das eher verwirrt, als Ihnen zu helfen, ignorieren Sie es, Sie *brauchen* es nicht.
diff --git a/docs/de/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/de/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index 3bb261e44..6aa5ef199 100644
--- a/docs/de/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/de/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -32,7 +32,7 @@ Es sollte eine `list`e von `Depends()` sein:
//// tab | Python 3.8 nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -46,7 +46,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
Diese Abhängigkeiten werden auf die gleiche Weise wie normale Abhängigkeiten ausgeführt/aufgelöst. Aber ihr Wert (falls sie einen zurückgeben) wird nicht an Ihre *Pfadoperation-Funktion* übergeben.
-/// tip | "Tipp"
+/// tip | Tipp
Einige Editoren prüfen, ob Funktionsparameter nicht verwendet werden, und zeigen das als Fehler an.
@@ -90,7 +90,7 @@ Sie können Anforderungen für einen Request (wie Header) oder andere Unterabhä
//// tab | Python 3.8 nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -124,7 +124,7 @@ Die Abhängigkeiten können Exceptions `raise`n, genau wie normale Abhängigkeit
//// tab | Python 3.8 nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -160,7 +160,7 @@ Sie können also eine normale Abhängigkeit (die einen Wert zurückgibt), die Si
//// tab | Python 3.8 nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
diff --git a/docs/de/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/de/docs/tutorial/dependencies/dependencies-with-yield.md
index 48b057e28..ce6bbad69 100644
--- a/docs/de/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/de/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -4,13 +4,13 @@ FastAPI unterstützt Abhängigkeiten, die nach Abschluss einige <abbr title="Man
Verwenden Sie dazu `yield` statt `return` und schreiben Sie die zusätzlichen Schritte / den zusätzlichen Code danach.
-/// tip | "Tipp"
+/// tip | Tipp
Stellen Sie sicher, dass Sie `yield` nur einmal pro Abhängigkeit verwenden.
///
-/// note | "Technische Details"
+/// note | Technische Details
Jede Funktion, die dekoriert werden kann mit:
@@ -45,7 +45,7 @@ Der auf die `yield`-Anweisung folgende Code wird ausgeführt, nachdem die Respon
{!../../docs_src/dependencies/tutorial007.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Sie können `async`hrone oder reguläre Funktionen verwenden.
@@ -93,7 +93,7 @@ Beispielsweise kann `dependency_c` von `dependency_b` und `dependency_b` von `de
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -129,7 +129,7 @@ Und wiederum benötigt `dependency_b` den Wert von `dependency_a` (hier `dep_a`
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -149,7 +149,7 @@ Sie können beliebige Kombinationen von Abhängigkeiten haben.
**FastAPI** stellt sicher, dass alles in der richtigen Reihenfolge ausgeführt wird.
-/// note | "Technische Details"
+/// note | Technische Details
Dieses funktioniert dank Pythons <a href="https://docs.python.org/3/library/contextlib.html" class="external-link" target="_blank">Kontextmanager</a>.
@@ -163,7 +163,7 @@ Sie haben gesehen, dass Ihre Abhängigkeiten `yield` verwenden können und `try`
Auf die gleiche Weise könnten Sie im Exit-Code nach dem `yield` eine `HTTPException` oder ähnliches auslösen.
-/// tip | "Tipp"
+/// tip | Tipp
Dies ist eine etwas fortgeschrittene Technik, die Sie in den meisten Fällen nicht wirklich benötigen, da Sie Exceptions (einschließlich `HTTPException`) innerhalb des restlichen Anwendungscodes auslösen können, beispielsweise in der *Pfadoperation-Funktion*.
@@ -189,7 +189,7 @@ Aber es ist für Sie da, wenn Sie es brauchen. 🤓
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -250,7 +250,7 @@ Nachdem eine dieser Responses gesendet wurde, kann keine weitere Response gesend
///
-/// tip | "Tipp"
+/// tip | Tipp
Obiges Diagramm verwendet `HTTPException`, aber Sie können auch jede andere Exception auslösen, die Sie in einer Abhängigkeit mit `yield` abfangen, oder mit einem [benutzerdefinierten Exceptionhandler](../handling-errors.md#benutzerdefinierte-exceptionhandler-definieren){.internal-link target=_blank} erstellt haben.
@@ -260,7 +260,7 @@ Wenn Sie eine Exception auslösen, wird diese mit yield an die Abhängigkeiten
## Abhängigkeiten mit `yield`, `HTTPException` und Hintergrundtasks
-/// warning | "Achtung"
+/// warning | Achtung
Sie benötigen diese technischen Details höchstwahrscheinlich nicht, Sie können diesen Abschnitt überspringen und weiter unten fortfahren.
@@ -274,7 +274,7 @@ Dies wurde hauptsächlich so konzipiert, damit die gleichen Objekte, die durch A
Da dies jedoch bedeuten würde, darauf zu warten, dass die Response durch das Netzwerk reist, während eine Ressource unnötigerweise in einer Abhängigkeit mit yield gehalten wird (z. B. eine Datenbankverbindung), wurde dies in FastAPI 0.106.0 geändert.
-/// tip | "Tipp"
+/// tip | Tipp
Darüber hinaus handelt es sich bei einem Hintergrundtask normalerweise um einen unabhängigen Satz von Logik, der separat behandelt werden sollte, mit eigenen Ressourcen (z. B. einer eigenen Datenbankverbindung).
@@ -308,7 +308,7 @@ Wenn Sie eine Abhängigkeit mit `yield` erstellen, erstellt **FastAPI** dafür i
### Kontextmanager in Abhängigkeiten mit `yield` verwenden
-/// warning | "Achtung"
+/// warning | Achtung
Dies ist mehr oder weniger eine „fortgeschrittene“ Idee.
@@ -324,7 +324,7 @@ Sie können solche auch innerhalb von **FastAPI**-Abhängigkeiten mit `yield` ve
{!../../docs_src/dependencies/tutorial010.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Andere Möglichkeiten, einen Kontextmanager zu erstellen, sind:
diff --git a/docs/de/docs/tutorial/dependencies/global-dependencies.md b/docs/de/docs/tutorial/dependencies/global-dependencies.md
index 6b9e9e395..4df9f64e9 100644
--- a/docs/de/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/de/docs/tutorial/dependencies/global-dependencies.md
@@ -24,7 +24,7 @@ In diesem Fall werden sie auf alle *Pfadoperationen* in der Anwendung angewendet
//// tab | Python 3.8 nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
diff --git a/docs/de/docs/tutorial/dependencies/index.md b/docs/de/docs/tutorial/dependencies/index.md
index 494708d19..2a4a5177a 100644
--- a/docs/de/docs/tutorial/dependencies/index.md
+++ b/docs/de/docs/tutorial/dependencies/index.md
@@ -56,7 +56,7 @@ Es handelt sich einfach um eine Funktion, die die gleichen Parameter entgegennim
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -70,7 +70,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -138,7 +138,7 @@ Bitte [aktualisieren Sie FastAPI](../../deployment/versions.md#upgrade-der-fasta
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -152,7 +152,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -194,7 +194,7 @@ So wie auch `Body`, `Query`, usw., verwenden Sie `Depends` mit den Parametern Ih
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -208,7 +208,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -230,7 +230,7 @@ Sie **rufen diese nicht direkt auf** (fügen Sie am Ende keine Klammern hinzu),
Und diese Funktion akzeptiert Parameter auf die gleiche Weise wie *Pfadoperation-Funktionen*.
-/// tip | "Tipp"
+/// tip | Tipp
Im nächsten Kapitel erfahren Sie, welche anderen „Dinge“, außer Funktionen, Sie als Abhängigkeiten verwenden können.
@@ -299,7 +299,7 @@ Da wir jedoch `Annotated` verwenden, können wir diesen `Annotated`-Wert in eine
////
-/// tip | "Tipp"
+/// tip | Tipp
Das ist schlicht Standard-Python, es wird als „Typalias“ bezeichnet und ist eigentlich nicht **FastAPI**-spezifisch.
@@ -321,7 +321,7 @@ Und Sie können Abhängigkeiten mit `async def` innerhalb normaler `def`-*Pfadop
Es spielt keine Rolle. **FastAPI** weiß, was zu tun ist.
-/// note | "Hinweis"
+/// note | Hinweis
Wenn Ihnen das nichts sagt, lesen Sie den [Async: *„In Eile?“*](../../async.md#in-eile){.internal-link target=_blank}-Abschnitt über `async` und `await` in der Dokumentation.
diff --git a/docs/de/docs/tutorial/dependencies/sub-dependencies.md b/docs/de/docs/tutorial/dependencies/sub-dependencies.md
index a20aed63b..6da7c64de 100644
--- a/docs/de/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/de/docs/tutorial/dependencies/sub-dependencies.md
@@ -36,7 +36,7 @@ Sie könnten eine erste Abhängigkeit („Dependable“) wie folgt erstellen:
//// tab | Python 3.10 nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -50,7 +50,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8 nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -96,7 +96,7 @@ Dann können Sie eine weitere Abhängigkeitsfunktion (ein „Dependable“) erst
//// tab | Python 3.10 nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -110,7 +110,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8 nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -159,7 +159,7 @@ Diese Abhängigkeit verwenden wir nun wie folgt:
//// tab | Python 3.10 nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -173,7 +173,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8 nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -223,7 +223,7 @@ async def needy_dependency(fresh_value: Annotated[str, Depends(get_value, use_ca
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -244,7 +244,7 @@ Einfach Funktionen, die genauso aussehen wie *Pfadoperation-Funktionen*.
Dennoch ist es sehr mächtig und ermöglicht Ihnen die Deklaration beliebig tief verschachtelter Abhängigkeits-„Graphen“ (Bäume).
-/// tip | "Tipp"
+/// tip | Tipp
All dies scheint angesichts dieser einfachen Beispiele möglicherweise nicht so nützlich zu sein.
diff --git a/docs/de/docs/tutorial/encoder.md b/docs/de/docs/tutorial/encoder.md
index 0ab72b8dd..428eee287 100644
--- a/docs/de/docs/tutorial/encoder.md
+++ b/docs/de/docs/tutorial/encoder.md
@@ -42,7 +42,7 @@ Das Resultat dieses Aufrufs ist etwas, das mit Pythons Standard-<a href="https:/
Es wird also kein großer `str` zurückgegeben, der die Daten im JSON-Format (als String) enthält. Es wird eine Python-Standarddatenstruktur (z. B. ein `dict`) zurückgegeben, mit Werten und Unterwerten, die alle mit JSON kompatibel sind.
-/// note | "Hinweis"
+/// note | Hinweis
`jsonable_encoder` wird tatsächlich von **FastAPI** intern verwendet, um Daten zu konvertieren. Aber es ist in vielen anderen Szenarien hilfreich.
diff --git a/docs/de/docs/tutorial/extra-models.md b/docs/de/docs/tutorial/extra-models.md
index 14e842065..4c2c158db 100644
--- a/docs/de/docs/tutorial/extra-models.md
+++ b/docs/de/docs/tutorial/extra-models.md
@@ -8,7 +8,7 @@ Insbesondere Benutzermodelle, denn:
* Das **herausgehende Modell** sollte kein Passwort haben.
* Das **Datenbankmodell** sollte wahrscheinlich ein <abbr title='Ein aus scheinbar zufälligen Zeichen bestehender „Fingerabdruck“ eines Textes. Der Inhalt des Textes kann nicht eingesehen werden.'>gehashtes</abbr> Passwort haben.
-/// danger | "Gefahr"
+/// danger | Gefahr
Speichern Sie niemals das Klartext-Passwort eines Benutzers. Speichern Sie immer den „sicheren Hash“, den Sie verifizieren können.
@@ -154,7 +154,7 @@ UserInDB(
)
```
-/// warning | "Achtung"
+/// warning | Achtung
Die Hilfsfunktionen `fake_password_hasher` und `fake_save_user` demonstrieren nur den möglichen Fluss der Daten und bieten natürlich keine echte Sicherheit.
@@ -200,7 +200,7 @@ Das wird in OpenAPI mit `anyOf` angezeigt.
Um das zu tun, verwenden Sie Pythons Standard-Typhinweis <a href="https://docs.python.org/3/library/typing.html#typing.Union" class="external-link" target="_blank">`typing.Union`</a>:
-/// note | "Hinweis"
+/// note | Hinweis
Listen Sie, wenn Sie eine <a href="https://pydantic-docs.helpmanual.io/usage/types/#unions" class="external-link" target="_blank">`Union`</a> definieren, denjenigen Typ zuerst, der am spezifischsten ist, gefolgt von den weniger spezifischen Typen. Im Beispiel oben, in `Union[PlaneItem, CarItem]` also den spezifischeren `PlaneItem` vor dem weniger spezifischen `CarItem`.
diff --git a/docs/de/docs/tutorial/first-steps.md b/docs/de/docs/tutorial/first-steps.md
index fe3886b70..debefb156 100644
--- a/docs/de/docs/tutorial/first-steps.md
+++ b/docs/de/docs/tutorial/first-steps.md
@@ -24,7 +24,7 @@ $ uvicorn main:app --reload
</div>
-/// note | "Hinweis"
+/// note | Hinweis
Der Befehl `uvicorn main:app` bezieht sich auf:
@@ -139,7 +139,7 @@ Ebenfalls können Sie es verwenden, um automatisch Code für Clients zu generier
`FastAPI` ist eine Python-Klasse, die die gesamte Funktionalität für Ihre API bereitstellt.
-/// note | "Technische Details"
+/// note | Technische Details
`FastAPI` ist eine Klasse, die direkt von `Starlette` erbt.
@@ -259,7 +259,7 @@ Das `@app.get("/")` sagt **FastAPI**, dass die Funktion direkt darunter für die
* den Pfad `/`
* unter der Verwendung der <abbr title="eine HTTP GET Methode"><code>get</code>-Operation</abbr> gehen
-/// info | "`@decorator` Information"
+/// info | `@decorator` Information
Diese `@something`-Syntax wird in Python „Dekorator“ genannt.
@@ -286,7 +286,7 @@ Oder die exotischeren:
* `@app.patch()`
* `@app.trace()`
-/// tip | "Tipp"
+/// tip | Tipp
Es steht Ihnen frei, jede Operation (HTTP-Methode) so zu verwenden, wie Sie es möchten.
@@ -324,7 +324,7 @@ Sie könnten sie auch als normale Funktion anstelle von `async def` definieren:
{!../../docs_src/first_steps/tutorial003.py!}
```
-/// note | "Hinweis"
+/// note | Hinweis
Wenn Sie den Unterschied nicht kennen, lesen Sie [Async: *„In Eile?“*](../async.md#in-eile){.internal-link target=_blank}.
diff --git a/docs/de/docs/tutorial/handling-errors.md b/docs/de/docs/tutorial/handling-errors.md
index 70dc0c523..85de76ef1 100644
--- a/docs/de/docs/tutorial/handling-errors.md
+++ b/docs/de/docs/tutorial/handling-errors.md
@@ -63,7 +63,7 @@ Aber wenn der Client `http://example.com/items/bar` anfragt (ein nicht-existiere
}
```
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie eine `HTTPException` auslösen, können Sie dem Parameter `detail` jeden Wert übergeben, der nach JSON konvertiert werden kann, nicht nur `str`.
@@ -109,7 +109,7 @@ Sie erhalten also einen sauberen Error mit einem Statuscode `418` und dem JSON-I
{"message": "Oops! yolo did something. There goes a rainbow..."}
```
-/// note | "Technische Details"
+/// note | Technische Details
Sie können auch `from starlette.requests import Request` und `from starlette.responses import JSONResponse` verwenden.
@@ -166,7 +166,7 @@ path -> item_id
#### `RequestValidationError` vs. `ValidationError`
-/// warning | "Achtung"
+/// warning | Achtung
Das folgende sind technische Details, die Sie überspringen können, wenn sie für Sie nicht wichtig sind.
@@ -192,7 +192,7 @@ Zum Beispiel könnten Sie eine Klartext-Response statt JSON für diese Fehler zu
{!../../docs_src/handling_errors/tutorial004.py!}
```
-/// note | "Technische Details"
+/// note | Technische Details
Sie können auch `from starlette.responses import PlainTextResponse` verwenden.
diff --git a/docs/de/docs/tutorial/header-params.md b/docs/de/docs/tutorial/header-params.md
index c4901c2ee..40a773f50 100644
--- a/docs/de/docs/tutorial/header-params.md
+++ b/docs/de/docs/tutorial/header-params.md
@@ -32,7 +32,7 @@ Importieren Sie zuerst `Header`:
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -46,7 +46,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -90,7 +90,7 @@ Der erste Wert ist der Typ. Sie können `Header` die gehabten Extra Validierungs
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -104,7 +104,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -116,7 +116,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// note | "Technische Details"
+/// note | Technische Details
`Header` ist eine Schwesterklasse von `Path`, `Query` und `Cookie`. Sie erbt von derselben gemeinsamen `Param`-Elternklasse.
@@ -172,7 +172,7 @@ Wenn Sie aus irgendeinem Grund das automatische Konvertieren von Unterstrichen z
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -186,7 +186,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -198,7 +198,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// warning | "Achtung"
+/// warning | Achtung
Bevor Sie `convert_underscores` auf `False` setzen, bedenken Sie, dass manche HTTP-Proxys und Server die Verwendung von Headern mit Unterstrichen nicht erlauben.
@@ -240,7 +240,7 @@ Um zum Beispiel einen Header `X-Token` zu deklarieren, der mehrmals vorkommen ka
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -254,7 +254,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.9+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -268,7 +268,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
diff --git a/docs/de/docs/tutorial/index.md b/docs/de/docs/tutorial/index.md
index c15d0b0bd..3cbfe37f4 100644
--- a/docs/de/docs/tutorial/index.md
+++ b/docs/de/docs/tutorial/index.md
@@ -52,7 +52,7 @@ $ pip install "fastapi[all]"
... das beinhaltet auch `uvicorn`, welchen Sie als Server verwenden können, der ihren Code ausführt.
-/// note | "Hinweis"
+/// note | Hinweis
Sie können die einzelnen Teile auch separat installieren.
diff --git a/docs/de/docs/tutorial/metadata.md b/docs/de/docs/tutorial/metadata.md
index 98724e1e8..5a0b723c5 100644
--- a/docs/de/docs/tutorial/metadata.md
+++ b/docs/de/docs/tutorial/metadata.md
@@ -22,7 +22,7 @@ Sie können diese wie folgt setzen:
{!../../docs_src/metadata/tutorial001.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Sie können Markdown in das Feld `description` schreiben und es wird in der Ausgabe gerendert.
@@ -68,7 +68,7 @@ Erstellen Sie Metadaten für Ihre Tags und übergeben Sie sie an den Parameter `
Beachten Sie, dass Sie Markdown in den Beschreibungen verwenden können. Beispielsweise wird „login“ in Fettschrift (**login**) und „fancy“ in Kursivschrift (_fancy_) angezeigt.
-/// tip | "Tipp"
+/// tip | Tipp
Sie müssen nicht für alle von Ihnen verwendeten Tags Metadaten hinzufügen.
diff --git a/docs/de/docs/tutorial/middleware.md b/docs/de/docs/tutorial/middleware.md
index 6bdececbc..d3699be1b 100644
--- a/docs/de/docs/tutorial/middleware.md
+++ b/docs/de/docs/tutorial/middleware.md
@@ -11,7 +11,7 @@ Eine „Middleware“ ist eine Funktion, die mit jedem **Request** arbeitet, bev
* Sie kann etwas mit dieser **Response** tun oder beliebigen Code ausführen.
* Dann gibt sie die **Response** zurück.
-/// note | "Technische Details"
+/// note | Technische Details
Wenn Sie Abhängigkeiten mit `yield` haben, wird der Exit-Code *nach* der Middleware ausgeführt.
@@ -33,7 +33,7 @@ Die Middleware-Funktion erhält:
{* ../../docs_src/middleware/tutorial001.py hl[8:9,11,14] *}
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass benutzerdefinierte proprietäre Header hinzugefügt werden können. <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers" class="external-link" target="_blank">Verwenden Sie dafür das Präfix 'X-'</a>.
@@ -41,7 +41,7 @@ Wenn Sie jedoch benutzerdefinierte Header haben, die ein Client in einem Browser
///
-/// note | "Technische Details"
+/// note | Technische Details
Sie könnten auch `from starlette.requests import Request` verwenden.
diff --git a/docs/de/docs/tutorial/path-operation-configuration.md b/docs/de/docs/tutorial/path-operation-configuration.md
index 411916e9c..55d0f2a91 100644
--- a/docs/de/docs/tutorial/path-operation-configuration.md
+++ b/docs/de/docs/tutorial/path-operation-configuration.md
@@ -2,7 +2,7 @@
Es gibt mehrere Konfigurations-Parameter, die Sie Ihrem *Pfadoperation-Dekorator* übergeben können.
-/// warning | "Achtung"
+/// warning | Achtung
Beachten Sie, dass diese Parameter direkt dem *Pfadoperation-Dekorator* übergeben werden, nicht der *Pfadoperation-Funktion*.
@@ -42,7 +42,7 @@ Aber falls Sie sich nicht mehr erinnern, wofür jede Nummer steht, können Sie d
Dieser Statuscode wird in der Response verwendet und zum OpenAPI-Schema hinzugefügt.
-/// note | "Technische Details"
+/// note | Technische Details
Sie können auch `from starlette import status` verwenden.
diff --git a/docs/de/docs/tutorial/path-params-numeric-validations.md b/docs/de/docs/tutorial/path-params-numeric-validations.md
index fc2d5dff1..b74fc8a04 100644
--- a/docs/de/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/de/docs/tutorial/path-params-numeric-validations.md
@@ -32,7 +32,7 @@ Importieren Sie zuerst `Path` von `fastapi`, und importieren Sie `Annotated`.
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -46,7 +46,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -100,7 +100,7 @@ Um zum Beispiel einen `title`-Metadaten-Wert für den Pfad-Parameter `item_id` z
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -114,7 +114,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -126,7 +126,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// note | "Hinweis"
+/// note | Hinweis
Ein Pfad-Parameter ist immer erforderlich, weil er Teil des Pfads sein muss.
@@ -138,7 +138,7 @@ Doch selbst wenn Sie ihn mit `None` deklarieren, oder einen Defaultwert setzen,
## Sortieren Sie die Parameter, wie Sie möchten
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie `Annotated` verwenden, ist das folgende nicht so wichtig / nicht notwendig.
@@ -160,7 +160,7 @@ Sie können Ihre Funktion also so deklarieren:
//// tab | Python 3.8 nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -192,7 +192,7 @@ Aber bedenken Sie, dass Sie dieses Problem nicht haben, wenn Sie `Annotated` ver
## Sortieren Sie die Parameter wie Sie möchten: Tricks
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie `Annotated` verwenden, ist das folgende nicht so wichtig / nicht notwendig.
@@ -260,7 +260,7 @@ Hier, mit `ge=1`, wird festgelegt, dass `item_id` eine Ganzzahl benötigt, die g
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -297,7 +297,7 @@ Das Gleiche trifft zu auf:
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -337,7 +337,7 @@ Das gleiche gilt für <abbr title="less than – kleiner als"><code>lt</code></a
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -368,7 +368,7 @@ Sie alle teilen die gleichen Parameter für zusätzliche Validierung und Metadat
///
-/// note | "Technische Details"
+/// note | Technische Details
`Query`, `Path` und andere, die Sie von `fastapi` importieren, sind tatsächlich Funktionen.
diff --git a/docs/de/docs/tutorial/path-params.md b/docs/de/docs/tutorial/path-params.md
index 9cb172c94..e91c3db51 100644
--- a/docs/de/docs/tutorial/path-params.md
+++ b/docs/de/docs/tutorial/path-params.md
@@ -159,7 +159,7 @@ Erstellen Sie dann Klassen-Attribute mit festgelegten Werten, welches die erlaub
///
-/// tip | "Tipp"
+/// tip | Tipp
Falls Sie sich fragen, was „AlexNet“, „ResNet“ und „LeNet“ ist, das sind Namen von <abbr title="Genau genommen, Deep-Learning-Modellarchitekturen">Modellen</abbr> für maschinelles Lernen.
@@ -199,7 +199,7 @@ Den tatsächlichen Wert (in diesem Fall ein `str`) erhalten Sie via `model_name.
{!../../docs_src/path_params/tutorial005.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Sie können den Wert `"lenet"` außerdem mittels `ModelName.lenet.value` abrufen.
@@ -256,7 +256,7 @@ Sie verwenden das also wie folgt:
{!../../docs_src/path_params/tutorial004.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Der Parameter könnte einen führenden Schrägstrich (`/`) haben, wie etwa in `/home/johndoe/myfile.txt`.
diff --git a/docs/de/docs/tutorial/query-params-str-validations.md b/docs/de/docs/tutorial/query-params-str-validations.md
index a9f1e0f39..d71a23dc2 100644
--- a/docs/de/docs/tutorial/query-params-str-validations.md
+++ b/docs/de/docs/tutorial/query-params-str-validations.md
@@ -22,7 +22,7 @@ Nehmen wir als Beispiel die folgende Anwendung:
Der Query-Parameter `q` hat den Typ `Union[str, None]` (oder `str | None` in Python 3.10), was bedeutet, er ist entweder ein `str` oder `None`. Der Defaultwert ist `None`, also weiß FastAPI, der Parameter ist nicht erforderlich.
-/// note | "Hinweis"
+/// note | Hinweis
FastAPI weiß nur dank des definierten Defaultwertes `=None`, dass der Wert von `q` nicht erforderlich ist
@@ -153,7 +153,7 @@ FastAPI wird nun:
Frühere Versionen von FastAPI (vor <abbr title="vor 2023-03">0.95.0</abbr>) benötigten `Query` als Defaultwert des Parameters, statt es innerhalb von `Annotated` unterzubringen. Die Chance ist groß, dass Sie Quellcode sehen, der das immer noch so macht, darum erkläre ich es Ihnen.
-/// tip | "Tipp"
+/// tip | Tipp
Verwenden Sie für neuen Code, und wann immer möglich, `Annotated`, wie oben erklärt. Es gibt mehrere Vorteile (unten erläutert) und keine Nachteile. 🍰
@@ -301,7 +301,7 @@ Sie können auch einen Parameter `min_length` hinzufügen:
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -315,7 +315,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -357,7 +357,7 @@ Sie können einen <abbr title="Ein regulärer Ausdruck, auch regex oder regexp g
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -371,7 +371,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -433,7 +433,7 @@ Beispielsweise könnten Sie den `q` Query-Parameter so deklarieren, dass er eine
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -445,7 +445,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// note | "Hinweis"
+/// note | Hinweis
Ein Parameter ist optional (nicht erforderlich), wenn er irgendeinen Defaultwert, auch `None`, hat.
@@ -503,7 +503,7 @@ Wenn Sie einen Parameter erforderlich machen wollen, während Sie `Query` verwen
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -513,7 +513,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
{!> ../../docs_src/query_params_str_validations/tutorial006.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass, obwohl in diesem Fall `Query()` der Funktionsparameter-Defaultwert ist, wir nicht `default=None` zu `Query()` hinzufügen.
@@ -545,7 +545,7 @@ Es gibt eine Alternative, die explizit deklariert, dass ein Wert erforderlich is
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -599,7 +599,7 @@ Um das zu machen, deklarieren Sie, dass `None` ein gültiger Typ ist, aber verwe
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -613,7 +613,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -625,13 +625,13 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// tip | "Tipp"
+/// tip | Tipp
Pydantic, welches die gesamte Datenvalidierung und Serialisierung in FastAPI antreibt, hat ein spezielles Verhalten, wenn Sie `Optional` oder `Union[Something, None]` ohne Defaultwert verwenden, Sie können mehr darüber in der Pydantic-Dokumentation unter <a href="https://docs.pydantic.dev/2.3/usage/models/#required-fields" class="external-link" target="_blank">Required fields</a> erfahren.
///
-/// tip | "Tipp"
+/// tip | Tipp
Denken Sie daran, dass Sie in den meisten Fällen, wenn etwas erforderlich ist, einfach den Defaultwert weglassen können. Sie müssen also normalerweise `...` nicht verwenden.
@@ -669,7 +669,7 @@ Um zum Beispiel einen Query-Parameter `q` zu deklarieren, der mehrere Male in de
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -683,7 +683,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.9+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -697,7 +697,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -728,7 +728,7 @@ Die Response für diese URL wäre also:
}
```
-/// tip | "Tipp"
+/// tip | Tipp
Um einen Query-Parameter vom Typ `list` zu deklarieren, wie im Beispiel oben, müssen Sie explizit `Query` verwenden, sonst würde der Parameter als Requestbody interpretiert werden.
@@ -760,7 +760,7 @@ Und Sie können auch eine Default-`list`e von Werten definieren, wenn keine übe
//// tab | Python 3.9+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -774,7 +774,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -825,7 +825,7 @@ Sie können auch `list` direkt verwenden, anstelle von `List[str]` (oder `list[s
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -837,7 +837,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// note | "Hinweis"
+/// note | Hinweis
Beachten Sie, dass FastAPI in diesem Fall den Inhalt der Liste nicht überprüft.
@@ -851,7 +851,7 @@ Sie können mehr Informationen zum Parameter hinzufügen.
Diese Informationen werden zur generierten OpenAPI hinzugefügt, und von den Dokumentations-Oberflächen und von externen Tools verwendet.
-/// note | "Hinweis"
+/// note | Hinweis
Beachten Sie, dass verschiedene Tools OpenAPI möglicherweise unterschiedlich gut unterstützen.
@@ -887,7 +887,7 @@ Sie können einen Titel hinzufügen – `title`:
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -901,7 +901,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -941,7 +941,7 @@ Und eine Beschreibung – `description`:
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -955,7 +955,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -1011,7 +1011,7 @@ Dann können Sie einen `alias` deklarieren, und dieser Alias wird verwendet, um
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -1025,7 +1025,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -1071,7 +1071,7 @@ In diesem Fall fügen Sie den Parameter `deprecated=True` zu `Query` hinzu.
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -1085,7 +1085,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -1131,7 +1131,7 @@ Um einen Query-Parameter vom generierten OpenAPI-Schema auszuschließen (und dah
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -1145,7 +1145,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
diff --git a/docs/de/docs/tutorial/query-params.md b/docs/de/docs/tutorial/query-params.md
index bb1dbdf9c..e67fef79d 100644
--- a/docs/de/docs/tutorial/query-params.md
+++ b/docs/de/docs/tutorial/query-params.md
@@ -241,7 +241,7 @@ In diesem Fall gibt es drei Query-Parameter:
* `skip`, ein `int` mit einem Defaultwert `0`.
* `limit`, ein optionales `int`.
-/// tip | "Tipp"
+/// tip | Tipp
Sie können auch `Enum`s verwenden, auf die gleiche Weise wie mit [Pfad-Parametern](path-params.md#vordefinierte-parameterwerte){.internal-link target=_blank}.
diff --git a/docs/de/docs/tutorial/request-files.md b/docs/de/docs/tutorial/request-files.md
index c0d0ef3f2..cbfb4271f 100644
--- a/docs/de/docs/tutorial/request-files.md
+++ b/docs/de/docs/tutorial/request-files.md
@@ -34,7 +34,7 @@ Importieren Sie `File` und `UploadFile` von `fastapi`:
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -68,7 +68,7 @@ Erstellen Sie Datei-Parameter, so wie Sie es auch mit `Body` und `Form` machen w
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -88,7 +88,7 @@ Aber erinnern Sie sich, dass, wenn Sie `Query`, `Path`, `File` und andere von `
///
-/// tip | "Tipp"
+/// tip | Tipp
Um Dateibodys zu deklarieren, müssen Sie `File` verwenden, da diese Parameter sonst als Query-Parameter oder Body(-JSON)-Parameter interpretiert werden würden.
@@ -124,7 +124,7 @@ Definieren Sie einen Datei-Parameter mit dem Typ `UploadFile`:
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -177,13 +177,13 @@ Wenn Sie sich innerhalb einer normalen `def`-*Pfadoperation-Funktion* befinden,
contents = myfile.file.read()
```
-/// note | "Technische Details zu `async`"
+/// note | Technische Details zu `async`
Wenn Sie die `async`-Methoden verwenden, führt **FastAPI** die Datei-Methoden in einem <abbr title="Mehrere unabhängige Kindprozesse">Threadpool</abbr> aus und erwartet sie.
///
-/// note | "Technische Details zu Starlette"
+/// note | Technische Details zu Starlette
**FastAPI**s `UploadFile` erbt direkt von **Starlette**s `UploadFile`, fügt aber ein paar notwendige Teile hinzu, um es kompatibel mit **Pydantic** und anderen Teilen von FastAPI zu machen.
@@ -195,7 +195,7 @@ HTML-Formulare (`<form></form>`) senden die Daten in einer „speziellen“ Kodi
**FastAPI** stellt sicher, dass diese Daten korrekt ausgelesen werden, statt JSON zu erwarten.
-/// note | "Technische Details"
+/// note | Technische Details
Daten aus Formularen werden, wenn es keine Dateien sind, normalerweise mit dem <abbr title='Media type – Medientyp, Typ des Mediums'>„media type“</abbr> `application/x-www-form-urlencoded` kodiert.
@@ -205,7 +205,7 @@ Wenn Sie mehr über Formularfelder und ihre Kodierungen lesen möchten, besuchen
///
-/// warning | "Achtung"
+/// warning | Achtung
Sie können mehrere `File`- und `Form`-Parameter in einer *Pfadoperation* deklarieren, aber Sie können nicht gleichzeitig auch `Body`-Felder deklarieren, welche Sie als JSON erwarten, da der Request den Body mittels `multipart/form-data` statt `application/json` kodiert.
@@ -243,7 +243,7 @@ Sie können eine Datei optional machen, indem Sie Standard-Typannotationen verwe
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -257,7 +257,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -291,7 +291,7 @@ Sie können auch `File()` zusammen mit `UploadFile` verwenden, um zum Beispiel z
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -329,7 +329,7 @@ Um das zu machen, deklarieren Sie eine Liste von `bytes` oder `UploadFile`s:
//// tab | Python 3.9+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -343,7 +343,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -357,7 +357,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
Sie erhalten, wie deklariert, eine `list`e von `bytes` oder `UploadFile`s.
-/// note | "Technische Details"
+/// note | Technische Details
Sie können auch `from starlette.responses import HTMLResponse` verwenden.
@@ -387,7 +387,7 @@ Und so wie zuvor können Sie `File()` verwenden, um zusätzliche Parameter zu se
//// tab | Python 3.9+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -401,7 +401,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
diff --git a/docs/de/docs/tutorial/request-forms-and-files.md b/docs/de/docs/tutorial/request-forms-and-files.md
index 2b89edbb4..bdd1e0fac 100644
--- a/docs/de/docs/tutorial/request-forms-and-files.md
+++ b/docs/de/docs/tutorial/request-forms-and-files.md
@@ -30,7 +30,7 @@ Z. B. `pip install python-multipart`.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -64,7 +64,7 @@ Erstellen Sie Datei- und Formularparameter, so wie Sie es auch mit `Body` und `Q
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -80,7 +80,7 @@ Die Datei- und Formularfelder werden als Formulardaten hochgeladen, und Sie erha
Und Sie können einige der Dateien als `bytes` und einige als `UploadFile` deklarieren.
-/// warning | "Achtung"
+/// warning | Achtung
Sie können mehrere `File`- und `Form`-Parameter in einer *Pfadoperation* deklarieren, aber Sie können nicht gleichzeitig auch `Body`-Felder deklarieren, welche Sie als JSON erwarten, da der Request den Body mittels `multipart/form-data` statt `application/json` kodiert.
diff --git a/docs/de/docs/tutorial/request-forms.md b/docs/de/docs/tutorial/request-forms.md
index 0784aa8c0..2b6aeb41c 100644
--- a/docs/de/docs/tutorial/request-forms.md
+++ b/docs/de/docs/tutorial/request-forms.md
@@ -32,7 +32,7 @@ Importieren Sie `Form` von `fastapi`:
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -66,7 +66,7 @@ Erstellen Sie Formular-Parameter, so wie Sie es auch mit `Body` und `Query` mach
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -90,7 +90,7 @@ Mit `Form` haben Sie die gleichen Konfigurationsmöglichkeiten wie mit `Body` (u
///
-/// tip | "Tipp"
+/// tip | Tipp
Um Formularbodys zu deklarieren, verwenden Sie explizit `Form`, da diese Parameter sonst als Query-Parameter oder Body(-JSON)-Parameter interpretiert werden würden.
@@ -102,7 +102,7 @@ HTML-Formulare (`<form></form>`) senden die Daten in einer „speziellen“ Kodi
**FastAPI** stellt sicher, dass diese Daten korrekt ausgelesen werden, statt JSON zu erwarten.
-/// note | "Technische Details"
+/// note | Technische Details
Daten aus Formularen werden normalerweise mit dem <abbr title='Media type – Medientyp, Typ des Mediums'>„media type“</abbr> `application/x-www-form-urlencoded` kodiert.
@@ -112,7 +112,7 @@ Wenn Sie mehr über Formularfelder und ihre Kodierungen lesen möchten, besuchen
///
-/// warning | "Achtung"
+/// warning | Achtung
Sie können mehrere `Form`-Parameter in einer *Pfadoperation* deklarieren, aber Sie können nicht gleichzeitig auch `Body`-Felder deklarieren, welche Sie als JSON erwarten, da der Request den Body mittels `application/x-www-form-urlencoded` statt `application/json` kodiert.
diff --git a/docs/de/docs/tutorial/response-model.md b/docs/de/docs/tutorial/response-model.md
index 31ad73c77..aa27e0726 100644
--- a/docs/de/docs/tutorial/response-model.md
+++ b/docs/de/docs/tutorial/response-model.md
@@ -83,7 +83,7 @@ Sie können `response_model` in jeder möglichen *Pfadoperation* verwenden:
////
-/// note | "Hinweis"
+/// note | Hinweis
Beachten Sie, dass `response_model` ein Parameter der „Dekorator“-Methode ist (`get`, `post`, usw.). Nicht der *Pfadoperation-Funktion*, so wie die anderen Parameter.
@@ -93,7 +93,7 @@ Beachten Sie, dass `response_model` ein Parameter der „Dekorator“-Methode is
FastAPI wird dieses `response_model` nehmen, um die Daten zu dokumentieren, validieren, usw. und auch, um **die Ausgabedaten** entsprechend der Typdeklaration **zu konvertieren und filtern**.
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie in Ihrem Editor strikte Typchecks haben, mypy, usw., können Sie den Funktions-Rückgabetyp als <abbr title='„Irgend etwas“'>`Any`</abbr> deklarieren.
@@ -162,7 +162,7 @@ Hier ist das möglicherweise kein Problem, da es derselbe Benutzer ist, der das
Aber wenn wir dasselbe Modell für eine andere *Pfadoperation* verwenden, könnten wir das Passwort dieses Benutzers zu jedem Client schicken.
-/// danger | "Gefahr"
+/// danger | Gefahr
Speichern Sie niemals das Klartext-Passwort eines Benutzers, oder versenden Sie es in einer Response wie dieser, wenn Sie sich nicht der resultierenden Gefahren bewusst sind und nicht wissen, was Sie tun.
@@ -503,7 +503,7 @@ dann ist FastAPI klug genug (tatsächlich ist Pydantic klug genug) zu erkennen,
Diese Felder werden also in der JSON-Response enthalten sein.
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass Defaultwerte alles Mögliche sein können, nicht nur `None`.
@@ -519,7 +519,7 @@ Diese nehmen ein `set` von `str`s entgegen, welches Namen von Attributen sind, d
Das kann als schnelle Abkürzung verwendet werden, wenn Sie nur ein Pydantic-Modell haben und ein paar Daten von der Ausgabe ausschließen wollen.
-/// tip | "Tipp"
+/// tip | Tipp
Es wird dennoch empfohlen, dass Sie die Ideen von oben verwenden, also mehrere Klassen statt dieser Parameter.
@@ -545,7 +545,7 @@ Das trifft auch auf `response_model_by_alias` zu, welches ähnlich funktioniert.
////
-/// tip | "Tipp"
+/// tip | Tipp
Die Syntax `{"name", "description"}` erzeugt ein `set` mit diesen zwei Werten.
diff --git a/docs/de/docs/tutorial/response-status-code.md b/docs/de/docs/tutorial/response-status-code.md
index 5f017355b..a1b388a0a 100644
--- a/docs/de/docs/tutorial/response-status-code.md
+++ b/docs/de/docs/tutorial/response-status-code.md
@@ -10,7 +10,7 @@ So wie ein Responsemodell, können Sie auch einen HTTP-Statuscode für die Respo
{* ../../docs_src/response_status_code/tutorial001.py hl[6] *}
-/// note | "Hinweis"
+/// note | Hinweis
Beachten Sie, dass `status_code` ein Parameter der „Dekorator“-Methode ist (`get`, `post`, usw.). Nicht der *Pfadoperation-Funktion*, so wie die anderen Parameter und der Body.
@@ -31,7 +31,7 @@ Das wird:
<img src="/img/tutorial/response-status-code/image01.png">
-/// note | "Hinweis"
+/// note | Hinweis
Einige Responsecodes (siehe nächster Abschnitt) kennzeichnen, dass die Response keinen Body hat.
@@ -41,7 +41,7 @@ FastAPI versteht das und wird in der OpenAPI-Dokumentation anzeigen, dass es kei
## Über HTTP-Statuscodes
-/// note | "Hinweis"
+/// note | Hinweis
Wenn Sie bereits wissen, was HTTP-Statuscodes sind, überspringen Sie dieses Kapitel und fahren Sie mit dem nächsten fort.
@@ -64,7 +64,7 @@ Kurz:
* Für allgemeine Fehler beim Client können Sie einfach `400` verwenden.
* `500` und darüber stehen für Server-Fehler. Diese verwenden Sie fast nie direkt. Wenn etwas an irgendeiner Stelle in Ihrem Anwendungscode oder im Server schiefläuft, wird automatisch einer dieser Fehler-Statuscodes zurückgegeben.
-/// tip | "Tipp"
+/// tip | Tipp
Um mehr über Statuscodes zu lernen, und welcher wofür verwendet wird, lesen Sie die <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" class="external-link" target="_blank"><abbr title="Mozilla Developer Network – Mozilla-Entwickler-Netzwerk">MDN</abbr> Dokumentation über HTTP-Statuscodes</a>.
@@ -88,7 +88,7 @@ Diese sind nur eine Annehmlichkeit und enthalten dieselbe Nummer, aber auf diese
<img src="/img/tutorial/response-status-code/image02.png">
-/// note | "Technische Details"
+/// note | Technische Details
Sie können auch `from starlette import status` verwenden.
diff --git a/docs/de/docs/tutorial/schema-extra-example.md b/docs/de/docs/tutorial/schema-extra-example.md
index ae3b98709..f065ad4ca 100644
--- a/docs/de/docs/tutorial/schema-extra-example.md
+++ b/docs/de/docs/tutorial/schema-extra-example.md
@@ -38,7 +38,7 @@ Sie können `schema_extra` setzen, mit einem `dict`, das alle zusätzlichen Date
////
-/// tip | "Tipp"
+/// tip | Tipp
Mit derselben Technik können Sie das JSON-Schema erweitern und Ihre eigenen benutzerdefinierten Zusatzinformationen hinzufügen.
@@ -143,7 +143,7 @@ Wenn `openapi_examples` zu `Body()` hinzugefügt wird, würde `/docs` so aussehe
## Technische Details
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie bereits **FastAPI** Version **0.99.0 oder höher** verwenden, können Sie diese Details wahrscheinlich **überspringen**.
@@ -153,7 +153,7 @@ Sie können dies als eine kurze **Geschichtsstunde** zu OpenAPI und JSON Schema
///
-/// warning | "Achtung"
+/// warning | Achtung
Dies sind sehr technische Details zu den Standards **JSON Schema** und **OpenAPI**.
diff --git a/docs/de/docs/tutorial/security/first-steps.md b/docs/de/docs/tutorial/security/first-steps.md
index c552a681b..935b8ecca 100644
--- a/docs/de/docs/tutorial/security/first-steps.md
+++ b/docs/de/docs/tutorial/security/first-steps.md
@@ -38,7 +38,7 @@ Kopieren Sie das Beispiel in eine Datei `main.py`:
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -82,7 +82,7 @@ Sie werden etwa Folgendes sehen:
<img src="/img/tutorial/security/image01.png">
-/// check | "Authorize-Button!"
+/// check | Authorize-Button!
Sie haben bereits einen glänzenden, neuen „Authorize“-Button.
@@ -94,7 +94,7 @@ Und wenn Sie darauf klicken, erhalten Sie ein kleines Anmeldeformular zur Eingab
<img src="/img/tutorial/security/image02.png">
-/// note | "Hinweis"
+/// note | Hinweis
Es spielt keine Rolle, was Sie in das Formular eingeben, es wird noch nicht funktionieren. Wir kommen dahin.
@@ -172,7 +172,7 @@ Wenn wir eine Instanz der Klasse `OAuth2PasswordBearer` erstellen, übergeben wi
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -184,7 +184,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// tip | "Tipp"
+/// tip | Tipp
Hier bezieht sich `tokenUrl="token"` auf eine relative URL `token`, die wir noch nicht erstellt haben. Da es sich um eine relative URL handelt, entspricht sie `./token`.
@@ -238,7 +238,7 @@ Jetzt können Sie dieses `oauth2_scheme` als Abhängigkeit `Depends` übergeben.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -254,7 +254,7 @@ Diese Abhängigkeit stellt einen `str` bereit, der dem Parameter `token` der *Pf
**FastAPI** weiß, dass es diese Abhängigkeit verwenden kann, um ein „Sicherheitsschema“ im OpenAPI-Schema (und der automatischen API-Dokumentation) zu definieren.
-/// info | "Technische Details"
+/// info | Technische Details
**FastAPI** weiß, dass es die Klasse `OAuth2PasswordBearer` (deklariert in einer Abhängigkeit) verwenden kann, um das Sicherheitsschema in OpenAPI zu definieren, da es von `fastapi.security.oauth2.OAuth2` erbt, das wiederum von `fastapi.security.base.SecurityBase` erbt.
diff --git a/docs/de/docs/tutorial/security/get-current-user.md b/docs/de/docs/tutorial/security/get-current-user.md
index a9478a36e..5f28f231f 100644
--- a/docs/de/docs/tutorial/security/get-current-user.md
+++ b/docs/de/docs/tutorial/security/get-current-user.md
@@ -20,7 +20,7 @@ Im vorherigen Kapitel hat das Sicherheitssystem (das auf dem Dependency Injectio
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -68,7 +68,7 @@ So wie wir Pydantic zum Deklarieren von Bodys verwenden, können wir es auch üb
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -82,7 +82,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -130,7 +130,7 @@ So wie wir es zuvor in der *Pfadoperation* direkt gemacht haben, erhält unsere
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -144,7 +144,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -186,7 +186,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -200,7 +200,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -242,7 +242,7 @@ Und jetzt können wir wiederum `Depends` mit unserem `get_current_user` in der *
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -256,7 +256,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -272,7 +272,7 @@ Beachten Sie, dass wir als Typ von `current_user` das Pydantic-Modell `User` dek
Das wird uns innerhalb der Funktion bei Codevervollständigung und Typprüfungen helfen.
-/// tip | "Tipp"
+/// tip | Tipp
Sie erinnern sich vielleicht, dass Requestbodys ebenfalls mit Pydantic-Modellen deklariert werden.
@@ -346,7 +346,7 @@ Und alle diese Tausenden von *Pfadoperationen* können nur drei Zeilen lang sein
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -360,7 +360,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
diff --git a/docs/de/docs/tutorial/security/index.md b/docs/de/docs/tutorial/security/index.md
index ad0927361..b01243901 100644
--- a/docs/de/docs/tutorial/security/index.md
+++ b/docs/de/docs/tutorial/security/index.md
@@ -32,7 +32,7 @@ Heutzutage ist es nicht sehr populär und wird kaum verwendet.
OAuth2 spezifiziert nicht, wie die Kommunikation verschlüsselt werden soll, sondern erwartet, dass Ihre Anwendung mit HTTPS bereitgestellt wird.
-/// tip | "Tipp"
+/// tip | Tipp
Im Abschnitt über **Deployment** erfahren Sie, wie Sie HTTPS mithilfe von Traefik und Let's Encrypt kostenlos einrichten.
@@ -89,7 +89,7 @@ OpenAPI definiert die folgenden Sicherheitsschemas:
* Diese automatische Erkennung ist es, die in der OpenID Connect Spezifikation definiert ist.
-/// tip | "Tipp"
+/// tip | Tipp
Auch die Integration anderer Authentifizierungs-/Autorisierungsanbieter wie Google, Facebook, Twitter, GitHub, usw. ist möglich und relativ einfach.
diff --git a/docs/de/docs/tutorial/security/oauth2-jwt.md b/docs/de/docs/tutorial/security/oauth2-jwt.md
index 79e817840..25c1e1c97 100644
--- a/docs/de/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/de/docs/tutorial/security/oauth2-jwt.md
@@ -44,7 +44,7 @@ $ pip install "python-jose[cryptography]"
Hier verwenden wir das empfohlene: <a href="https://cryptography.io/" class="external-link" target="_blank">pyca/cryptography</a>.
-/// tip | "Tipp"
+/// tip | Tipp
Dieses Tutorial verwendete zuvor <a href="https://pyjwt.readthedocs.io/" class="external-link" target="_blank">PyJWT</a>.
@@ -86,7 +86,7 @@ $ pip install "passlib[bcrypt]"
</div>
-/// tip | "Tipp"
+/// tip | Tipp
Mit `passlib` können Sie sogar konfigurieren, Passwörter zu lesen, die von **Django**, einem **Flask**-Sicherheit-Plugin, oder vielen anderen erstellt wurden.
@@ -102,7 +102,7 @@ Importieren Sie die benötigten Tools aus `passlib`.
Erstellen Sie einen PassLib-„Kontext“. Der wird für das Hashen und Verifizieren von Passwörtern verwendet.
-/// tip | "Tipp"
+/// tip | Tipp
Der PassLib-Kontext kann auch andere Hashing-Algorithmen verwenden, einschließlich deprecateter Alter, um etwa nur eine Verifizierung usw. zu ermöglichen.
@@ -144,7 +144,7 @@ Und noch eine, um einen Benutzer zu authentifizieren und zurückzugeben.
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -158,7 +158,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -170,7 +170,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// note | "Hinweis"
+/// note | Hinweis
Wenn Sie sich die neue (gefakte) Datenbank `fake_users_db` anschauen, sehen Sie, wie das gehashte Passwort jetzt aussieht: `"$2b$12$EixZaYVK1fsbw1ZfbX3OXePaWxn96p36WQoeG6Lruj3vjPGga31lW"`.
@@ -230,7 +230,7 @@ Erstellen Sie eine Hilfsfunktion, um einen neuen Zugriffstoken zu generieren.
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -244,7 +244,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -290,7 +290,7 @@ Wenn der Token ungültig ist, geben Sie sofort einen HTTP-Fehler zurück.
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -304,7 +304,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -348,7 +348,7 @@ Erstellen Sie einen echten JWT-Zugriffstoken und geben Sie ihn zurück.
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -362,7 +362,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -436,7 +436,7 @@ Wenn Sie die Developer Tools öffnen, können Sie sehen, dass die gesendeten Dat
<img src="/img/tutorial/security/image10.png">
-/// note | "Hinweis"
+/// note | Hinweis
Beachten Sie den Header `Authorization` mit einem Wert, der mit `Bearer` beginnt.
diff --git a/docs/de/docs/tutorial/security/simple-oauth2.md b/docs/de/docs/tutorial/security/simple-oauth2.md
index 4c20fae55..2fa1385b0 100644
--- a/docs/de/docs/tutorial/security/simple-oauth2.md
+++ b/docs/de/docs/tutorial/security/simple-oauth2.md
@@ -78,7 +78,7 @@ Importieren Sie zunächst `OAuth2PasswordRequestForm` und verwenden Sie es als A
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -92,7 +92,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -111,7 +111,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
* Einem optionalen `scope`-Feld als langem String, bestehend aus durch Leerzeichen getrennten Strings.
* Einem optionalen `grant_type` („Art der Anmeldung“).
-/// tip | "Tipp"
+/// tip | Tipp
Die OAuth2-Spezifikation *erfordert* tatsächlich ein Feld `grant_type` mit dem festen Wert `password`, aber `OAuth2PasswordRequestForm` erzwingt dies nicht.
@@ -136,7 +136,7 @@ Da es sich jedoch um einen häufigen Anwendungsfall handelt, wird er zur Vereinf
### Die Formulardaten verwenden
-/// tip | "Tipp"
+/// tip | Tipp
Die Instanz der Klassenabhängigkeit `OAuth2PasswordRequestForm` verfügt, statt eines Attributs `scope` mit dem durch Leerzeichen getrennten langen String, über das Attribut `scopes` mit einer tatsächlichen Liste von Strings, einem für jeden gesendeten Scope.
@@ -176,7 +176,7 @@ Für den Fehler verwenden wir die Exception `HTTPException`:
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -190,7 +190,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -252,7 +252,7 @@ Der Dieb kann also nicht versuchen, die gleichen Passwörter in einem anderen Sy
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -266,7 +266,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -310,7 +310,7 @@ Und es sollte einen `access_token` haben, mit einem String, der unseren Zugriffs
In diesem einfachen Beispiel gehen wir einfach völlig unsicher vor und geben denselben `username` wie der Token zurück.
-/// tip | "Tipp"
+/// tip | Tipp
Im nächsten Kapitel sehen Sie eine wirklich sichere Implementierung mit Passwort-Hashing und <abbr title="JSON Web Tokens">JWT</abbr>-Tokens.
@@ -344,7 +344,7 @@ Aber konzentrieren wir uns zunächst auf die spezifischen Details, die wir benö
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -358,7 +358,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -370,7 +370,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
////
-/// tip | "Tipp"
+/// tip | Tipp
Gemäß der Spezifikation sollten Sie ein JSON mit einem `access_token` und einem `token_type` zurückgeben, genau wie in diesem Beispiel.
@@ -420,7 +420,7 @@ In unserem Endpunkt erhalten wir also nur dann einen Benutzer, wenn der Benutzer
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -434,7 +434,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
diff --git a/docs/de/docs/tutorial/static-files.md b/docs/de/docs/tutorial/static-files.md
index 4afd251aa..aa44e3f4e 100644
--- a/docs/de/docs/tutorial/static-files.md
+++ b/docs/de/docs/tutorial/static-files.md
@@ -11,7 +11,7 @@ Mit `StaticFiles` können Sie statische Dateien aus einem Verzeichnis automatisc
{!../../docs_src/static_files/tutorial001.py!}
```
-/// note | "Technische Details"
+/// note | Technische Details
Sie könnten auch `from starlette.staticfiles import StaticFiles` verwenden.
diff --git a/docs/de/docs/tutorial/testing.md b/docs/de/docs/tutorial/testing.md
index bda6d7d60..53459342b 100644
--- a/docs/de/docs/tutorial/testing.md
+++ b/docs/de/docs/tutorial/testing.md
@@ -30,7 +30,7 @@ Schreiben Sie einfache `assert`-Anweisungen mit den Standard-Python-Ausdrücken,
{!../../docs_src/app_testing/tutorial001.py!}
```
-/// tip | "Tipp"
+/// tip | Tipp
Beachten Sie, dass die Testfunktionen normal `def` und nicht `async def` sind.
@@ -40,7 +40,7 @@ Dadurch können Sie `pytest` ohne Komplikationen direkt nutzen.
///
-/// note | "Technische Details"
+/// note | Technische Details
Sie könnten auch `from starlette.testclient import TestClient` verwenden.
@@ -48,7 +48,7 @@ Sie könnten auch `from starlette.testclient import TestClient` verwenden.
///
-/// tip | "Tipp"
+/// tip | Tipp
Wenn Sie in Ihren Tests neben dem Senden von Anfragen an Ihre FastAPI-Anwendung auch `async`-Funktionen aufrufen möchten (z. B. asynchrone Datenbankfunktionen), werfen Sie einen Blick auf die [Async-Tests](../advanced/async-tests.md){.internal-link target=_blank} im Handbuch für fortgeschrittene Benutzer.
@@ -148,7 +148,7 @@ Beide *Pfadoperationen* erfordern einen `X-Token`-Header.
//// tab | Python 3.10+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
@@ -162,7 +162,7 @@ Bevorzugen Sie die `Annotated`-Version, falls möglich.
//// tab | Python 3.8+ nicht annotiert
-/// tip | "Tipp"
+/// tip | Tipp
Bevorzugen Sie die `Annotated`-Version, falls möglich.
diff --git a/docs/em/docs/advanced/additional-status-codes.md b/docs/em/docs/advanced/additional-status-codes.md
index 7a50e1bca..5eb2ec90e 100644
--- a/docs/em/docs/advanced/additional-status-codes.md
+++ b/docs/em/docs/advanced/additional-status-codes.md
@@ -28,7 +28,7 @@
///
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.responses import JSONResponse`.
diff --git a/docs/em/docs/advanced/behind-a-proxy.md b/docs/em/docs/advanced/behind-a-proxy.md
index e66ddccf7..36aa2e6b3 100644
--- a/docs/em/docs/advanced/behind-a-proxy.md
+++ b/docs/em/docs/advanced/behind-a-proxy.md
@@ -80,7 +80,7 @@ $ uvicorn main:app --root-path /api/v1
🚥 👆 ⚙️ Hypercorn, ⚫️ ✔️ 🎛 `--root-path`.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
🔫 🔧 🔬 `root_path` 👉 ⚙️ 💼.
diff --git a/docs/em/docs/advanced/custom-response.md b/docs/em/docs/advanced/custom-response.md
index 7147a4536..301f99957 100644
--- a/docs/em/docs/advanced/custom-response.md
+++ b/docs/em/docs/advanced/custom-response.md
@@ -121,7 +121,7 @@
✔️ 🤯 👈 👆 💪 ⚙️ `Response` 📨 🕳 🙆, ⚖️ ✍ 🛃 🎧-🎓.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.responses import HTMLResponse`.
diff --git a/docs/em/docs/advanced/middleware.md b/docs/em/docs/advanced/middleware.md
index 23d2918d7..914ce4a30 100644
--- a/docs/em/docs/advanced/middleware.md
+++ b/docs/em/docs/advanced/middleware.md
@@ -43,7 +43,7 @@ app.add_middleware(UnicornMiddleware, some_config="rainbow")
**FastAPI** 🔌 📚 🛠️ ⚠ ⚙️ 💼, 👥 🔜 👀 ⏭ ❔ ⚙️ 👫.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
⏭ 🖼, 👆 💪 ⚙️ `from starlette.middleware.something import SomethingMiddleware`.
diff --git a/docs/em/docs/advanced/path-operation-advanced-configuration.md b/docs/em/docs/advanced/path-operation-advanced-configuration.md
index 805bfdf30..47e89a90f 100644
--- a/docs/em/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/em/docs/advanced/path-operation-advanced-configuration.md
@@ -74,7 +74,7 @@
🕐❔ 👆 📣 *➡ 🛠️* 👆 🈸, **FastAPI** 🔁 🏗 🔗 🗃 🔃 👈 *➡ 🛠️* 🔌 🗄 🔗.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
🗄 🔧 ⚫️ 🤙 <a href="https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operation-object" class="external-link" target="_blank">🛠️ 🎚</a>.
diff --git a/docs/em/docs/advanced/response-cookies.md b/docs/em/docs/advanced/response-cookies.md
index 6b9e9a4d9..0fe47baec 100644
--- a/docs/em/docs/advanced/response-cookies.md
+++ b/docs/em/docs/advanced/response-cookies.md
@@ -42,7 +42,7 @@
### 🌅 ℹ
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.responses import Response` ⚖️ `from starlette.responses import JSONResponse`.
diff --git a/docs/em/docs/advanced/response-directly.md b/docs/em/docs/advanced/response-directly.md
index dcffc56c6..335c381c7 100644
--- a/docs/em/docs/advanced/response-directly.md
+++ b/docs/em/docs/advanced/response-directly.md
@@ -38,7 +38,7 @@
{!../../docs_src/response_directly/tutorial001.py!}
```
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.responses import JSONResponse`.
diff --git a/docs/em/docs/advanced/response-headers.md b/docs/em/docs/advanced/response-headers.md
index cbbbae237..d577347fe 100644
--- a/docs/em/docs/advanced/response-headers.md
+++ b/docs/em/docs/advanced/response-headers.md
@@ -28,7 +28,7 @@
{!../../docs_src/response_headers/tutorial001.py!}
```
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.responses import Response` ⚖️ `from starlette.responses import JSONResponse`.
diff --git a/docs/em/docs/advanced/security/oauth2-scopes.md b/docs/em/docs/advanced/security/oauth2-scopes.md
index 661be034e..f4d1a3b82 100644
--- a/docs/em/docs/advanced/security/oauth2-scopes.md
+++ b/docs/em/docs/advanced/security/oauth2-scopes.md
@@ -134,7 +134,7 @@ Oauth2️⃣ 👫 🎻.
{!../../docs_src/security/tutorial005.py!}
```
-/// info | "📡 ℹ"
+/// info | 📡 ℹ
`Security` 🤙 🏿 `Depends`, & ⚫️ ✔️ 1️⃣ ➕ 🔢 👈 👥 🔜 👀 ⏪.
diff --git a/docs/em/docs/advanced/templates.md b/docs/em/docs/advanced/templates.md
index 66c7484a6..53428151d 100644
--- a/docs/em/docs/advanced/templates.md
+++ b/docs/em/docs/advanced/templates.md
@@ -43,7 +43,7 @@ $ pip install jinja2
///
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.templating import Jinja2Templates`.
diff --git a/docs/em/docs/advanced/using-request-directly.md b/docs/em/docs/advanced/using-request-directly.md
index ae212364f..3eb0067ad 100644
--- a/docs/em/docs/advanced/using-request-directly.md
+++ b/docs/em/docs/advanced/using-request-directly.md
@@ -49,7 +49,7 @@
👆 💪 ✍ 🌅 ℹ 🔃 <a href="https://www.starlette.io/requests/" class="external-link" target="_blank">`Request` 🎚 🛂 💃 🧾 🕸</a>.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.requests import Request`.
diff --git a/docs/em/docs/advanced/websockets.md b/docs/em/docs/advanced/websockets.md
index 7957eba1f..4b260e20a 100644
--- a/docs/em/docs/advanced/websockets.md
+++ b/docs/em/docs/advanced/websockets.md
@@ -50,7 +50,7 @@ $ pip install websockets
{!../../docs_src/websockets/tutorial001.py!}
```
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.websockets import WebSocket`.
diff --git a/docs/em/docs/alternatives.md b/docs/em/docs/alternatives.md
index 5309de51f..59b587285 100644
--- a/docs/em/docs/alternatives.md
+++ b/docs/em/docs/alternatives.md
@@ -36,7 +36,7 @@
///
-/// check | "😮 **FastAPI** "
+/// check | 😮 **FastAPI**
✔️ 🏧 🛠️ 🧾 🕸 👩💻 🔢.
@@ -56,7 +56,7 @@
👐 🦁 🏺, ⚫️ 😑 💖 👍 🏏 🏗 🔗. ⏭ 👜 🔎 "✳ 🎂 🛠️" 🏺.
-/// check | "😮 **FastAPI** "
+/// check | 😮 **FastAPI**
◾-🛠️. ⚒ ⚫️ ⏩ 🌀 & 🏏 🧰 & 🍕 💪.
@@ -98,7 +98,7 @@ def read_url():
👀 🔀 `requests.get(...)` & `@app.get(...)`.
-/// check | "😮 **FastAPI** "
+/// check | 😮 **FastAPI**
* ✔️ 🙅 & 🏋️ 🛠️.
* ⚙️ 🇺🇸🔍 👩🔬 📛 (🛠️) 🔗, 🎯 & 🏋️ 🌌.
@@ -118,7 +118,7 @@ def read_url():
👈 ⚫️❔ 🕐❔ 💬 🔃 ⏬ 2️⃣.0️⃣ ⚫️ ⚠ 💬 "🦁", & ⏬ 3️⃣ ➕ "🗄".
-/// check | "😮 **FastAPI** "
+/// check | 😮 **FastAPI**
🛠️ & ⚙️ 📂 🐩 🛠️ 🔧, ↩️ 🛃 🔗.
@@ -147,7 +147,7 @@ def read_url():
✋️ ⚫️ ✍ ⏭ 📤 🔀 🐍 🆎 🔑. , 🔬 🔠 <abbr title="the definition of how data should be formed">🔗</abbr> 👆 💪 ⚙️ 🎯 🇨🇻 & 🎓 🚚 🍭.
-/// check | "😮 **FastAPI** "
+/// check | 😮 **FastAPI**
⚙️ 📟 🔬 "🔗" 👈 🚚 💽 🆎 & 🔬, 🔁.
@@ -169,7 +169,7 @@ Webarg ✍ 🎏 🍭 👩💻.
///
-/// check | "😮 **FastAPI** "
+/// check | 😮 **FastAPI**
✔️ 🏧 🔬 📨 📨 💽.
@@ -199,7 +199,7 @@ APISpec ✍ 🎏 🍭 👩💻.
///
-/// check | "😮 **FastAPI** "
+/// check | 😮 **FastAPI**
🐕🦺 📂 🐩 🛠️, 🗄.
@@ -231,7 +231,7 @@ APISpec ✍ 🎏 🍭 👩💻.
///
-/// check | "😮 **FastAPI** "
+/// check | 😮 **FastAPI**
🏗 🗄 🔗 🔁, ⚪️➡️ 🎏 📟 👈 🔬 🛠️ & 🔬.
@@ -251,7 +251,7 @@ APISpec ✍ 🎏 🍭 👩💻.
⚫️ 💪 🚫 🍵 🔁 🏷 📶 👍. , 🚥 🎻 💪 📨 🎻 🎚 👈 ✔️ 🔘 🏑 👈 🔄 🐦 🎻 🎚, ⚫️ 🚫🔜 ☑ 📄 & ✔.
-/// check | "😮 **FastAPI** "
+/// check | 😮 **FastAPI**
⚙️ 🐍 🆎 ✔️ 👑 👨🎨 🐕🦺.
@@ -263,7 +263,7 @@ APISpec ✍ 🎏 🍭 👩💻.
⚫️ 🕐 🥇 📶 ⏩ 🐍 🛠️ ⚓️ 🔛 `asyncio`. ⚫️ ⚒ 📶 🎏 🏺.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
⚫️ ⚙️ <a href="https://github.com/MagicStack/uvloop" class="external-link" target="_blank">`uvloop`</a> ↩️ 🔢 🐍 `asyncio` ➰. 👈 ⚫️❔ ⚒ ⚫️ ⏩.
@@ -271,7 +271,7 @@ APISpec ✍ 🎏 🍭 👩💻.
///
-/// check | "😮 **FastAPI** "
+/// check | 😮 **FastAPI**
🔎 🌌 ✔️ 😜 🎭.
@@ -287,7 +287,7 @@ APISpec ✍ 🎏 🍭 👩💻.
, 💽 🔬, 🛠️, & 🧾, ✔️ ⌛ 📟, 🚫 🔁. ⚖️ 👫 ✔️ 🛠️ 🛠️ 🔛 🔝 🦅, 💖 🤗. 👉 🎏 🔺 🔨 🎏 🛠️ 👈 😮 🦅 🔧, ✔️ 1️⃣ 📨 🎚 & 1️⃣ 📨 🎚 🔢.
-/// check | "😮 **FastAPI** "
+/// check | 😮 **FastAPI**
🔎 🌌 🤚 👑 🎭.
@@ -313,7 +313,7 @@ APISpec ✍ 🎏 🍭 👩💻.
🛣 📣 👁 🥉, ⚙️ 🔢 📣 🎏 🥉 (↩️ ⚙️ 👨🎨 👈 💪 🥉 ▶️️ 🔛 🔝 🔢 👈 🍵 🔗). 👉 🔐 ❔ ✳ 🔨 ⚫️ 🌘 ❔ 🏺 (& 💃) 🔨 ⚫️. ⚫️ 🎏 📟 👜 👈 📶 😆 🔗.
-/// check | "😮 **FastAPI** "
+/// check | 😮 **FastAPI**
🔬 ➕ 🔬 💽 🆎 ⚙️ "🔢" 💲 🏷 🔢. 👉 📉 👨🎨 🐕🦺, & ⚫️ 🚫 💪 Pydantic ⏭.
@@ -341,7 +341,7 @@ APISpec ✍ 🎏 🍭 👩💻.
///
-/// check | "💭 😮 **FastAPI**"
+/// check | 💭 😮 **FastAPI**
🤗 😮 🍕 APIStar, & 1️⃣ 🧰 👤 🔎 🏆 👍, 🌟 APIStar.
@@ -385,7 +385,7 @@ APIStar ✍ ✡ 🇺🇸🏛. 🎏 👨 👈 ✍:
///
-/// check | "😮 **FastAPI** "
+/// check | 😮 **FastAPI**
🔀.
@@ -409,7 +409,7 @@ Pydantic 🗃 🔬 💽 🔬, 🛠️ & 🧾 (⚙️ 🎻 🔗) ⚓️ 🔛
⚫️ ⭐ 🍭. 👐 ⚫️ ⏩ 🌘 🍭 📇. & ⚫️ ⚓️ 🔛 🎏 🐍 🆎 🔑, 👨🎨 🐕🦺 👑.
-/// check | "**FastAPI** ⚙️ ⚫️"
+/// check | **FastAPI** ⚙️ ⚫️
🍵 🌐 💽 🔬, 💽 🛠️ & 🏧 🏷 🧾 (⚓️ 🔛 🎻 🔗).
@@ -444,7 +444,7 @@ Pydantic 🗃 🔬 💽 🔬, 🛠️ & 🧾 (⚙️ 🎻 🔗) ⚓️ 🔛
👈 1️⃣ 👑 👜 👈 **FastAPI** 🚮 🔛 🔝, 🌐 ⚓️ 🔛 🐍 🆎 🔑 (⚙️ Pydantic). 👈, ➕ 🔗 💉 ⚙️, 💂♂ 🚙, 🗄 🔗 ⚡, ♒️.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
🔫 🆕 "🐩" ➖ 🛠️ ✳ 🐚 🏉 👨🎓. ⚫️ 🚫 "🐍 🐩" (🇩🇬), 👐 👫 🛠️ 🔨 👈.
@@ -452,7 +452,7 @@ Pydantic 🗃 🔬 💽 🔬, 🛠️ & 🧾 (⚙️ 🎻 🔗) ⚓️ 🔛
///
-/// check | "**FastAPI** ⚙️ ⚫️"
+/// check | **FastAPI** ⚙️ ⚫️
🍵 🌐 🐚 🕸 🍕. ❎ ⚒ 🔛 🔝.
@@ -470,7 +470,7 @@ Uvicorn 🌩-⏩ 🔫 💽, 🏗 🔛 uvloop & httptool.
⚫️ 👍 💽 💃 & **FastAPI**.
-/// check | "**FastAPI** 👍 ⚫️"
+/// check | **FastAPI** 👍 ⚫️
👑 🕸 💽 🏃 **FastAPI** 🈸.
diff --git a/docs/em/docs/how-to/custom-request-and-route.md b/docs/em/docs/how-to/custom-request-and-route.md
index 0425e6267..cd8811d4e 100644
--- a/docs/em/docs/how-to/custom-request-and-route.md
+++ b/docs/em/docs/how-to/custom-request-and-route.md
@@ -60,7 +60,7 @@
{!../../docs_src/custom_request_and_route/tutorial001.py!}
```
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
`Request` ✔️ `request.scope` 🔢, 👈 🐍 `dict` ⚗ 🗃 🔗 📨.
diff --git a/docs/em/docs/tutorial/bigger-applications.md b/docs/em/docs/tutorial/bigger-applications.md
index 074ab302c..68f506f27 100644
--- a/docs/em/docs/tutorial/bigger-applications.md
+++ b/docs/em/docs/tutorial/bigger-applications.md
@@ -414,7 +414,7 @@ from .routers.users import router
⚫️ 🔜 🔌 🌐 🛣 ⚪️➡️ 👈 📻 🍕 ⚫️.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
⚫️ 🔜 🤙 🔘 ✍ *➡ 🛠️* 🔠 *➡ 🛠️* 👈 📣 `APIRouter`.
@@ -477,7 +477,7 @@ from .routers.users import router
& ⚫️ 🔜 👷 ☑, 👯♂️ ⏮️ 🌐 🎏 *➡ 🛠️* 🚮 ⏮️ `app.include_router()`.
-/// info | "📶 📡 ℹ"
+/// info | 📶 📡 ℹ
**🗒**: 👉 📶 📡 ℹ 👈 👆 🎲 💪 **🚶**.
diff --git a/docs/em/docs/tutorial/body-fields.md b/docs/em/docs/tutorial/body-fields.md
index eb3093de2..be39b4a9a 100644
--- a/docs/em/docs/tutorial/body-fields.md
+++ b/docs/em/docs/tutorial/body-fields.md
@@ -50,7 +50,7 @@
`Field` 👷 🎏 🌌 `Query`, `Path` & `Body`, ⚫️ ✔️ 🌐 🎏 🔢, ♒️.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
🤙, `Query`, `Path` & 🎏 👆 🔜 👀 ⏭ ✍ 🎚 🏿 ⚠ `Param` 🎓, ❔ ⚫️ 🏿 Pydantic `FieldInfo` 🎓.
diff --git a/docs/em/docs/tutorial/cookie-params.md b/docs/em/docs/tutorial/cookie-params.md
index f4956e76f..5126eab0a 100644
--- a/docs/em/docs/tutorial/cookie-params.md
+++ b/docs/em/docs/tutorial/cookie-params.md
@@ -44,7 +44,7 @@
////
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
`Cookie` "👭" 🎓 `Path` & `Query`. ⚫️ 😖 ⚪️➡️ 🎏 ⚠ `Param` 🎓.
diff --git a/docs/em/docs/tutorial/cors.md b/docs/em/docs/tutorial/cors.md
index 5829319cb..801d66fdd 100644
--- a/docs/em/docs/tutorial/cors.md
+++ b/docs/em/docs/tutorial/cors.md
@@ -78,7 +78,7 @@
🌖 ℹ 🔃 <abbr title="Cross-Origin Resource Sharing">⚜</abbr>, ✅ <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS" class="external-link" target="_blank">🦎 ⚜ 🧾</a>.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.middleware.cors import CORSMiddleware`.
diff --git a/docs/em/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/em/docs/tutorial/dependencies/dependencies-with-yield.md
index e0d6dba24..2896be39d 100644
--- a/docs/em/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/em/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -10,7 +10,7 @@ FastAPI 🐕🦺 🔗 👈 <abbr title='sometimes also called "exit", "cleanu
///
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
🙆 🔢 👈 ☑ ⚙️ ⏮️:
@@ -97,7 +97,7 @@ FastAPI 🐕🦺 🔗 👈 <abbr title='sometimes also called "exit", "cleanu
**FastAPI** 🔜 ⚒ 💭 🌐 🏃 ☑ ✔.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👉 👷 👏 🐍 <a href="https://docs.python.org/3/library/contextlib.html" class="external-link" target="_blank">🔑 👨💼</a>.
diff --git a/docs/em/docs/tutorial/first-steps.md b/docs/em/docs/tutorial/first-steps.md
index d8cc05c40..d6762422e 100644
--- a/docs/em/docs/tutorial/first-steps.md
+++ b/docs/em/docs/tutorial/first-steps.md
@@ -139,7 +139,7 @@ INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
`FastAPI` 🐍 🎓 👈 🚚 🌐 🛠️ 👆 🛠️.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
`FastAPI` 🎓 👈 😖 🔗 ⚪️➡️ `Starlette`.
@@ -259,7 +259,7 @@ https://example.com/items/foo
* ➡ `/`
* ⚙️ <abbr title="an HTTP GET method"><code>get</code> 🛠️</abbr>
-/// info | "`@decorator` ℹ"
+/// info | `@decorator` ℹ
👈 `@something` ❕ 🐍 🤙 "👨🎨".
diff --git a/docs/em/docs/tutorial/handling-errors.md b/docs/em/docs/tutorial/handling-errors.md
index 7f6a704eb..e0edae51a 100644
--- a/docs/em/docs/tutorial/handling-errors.md
+++ b/docs/em/docs/tutorial/handling-errors.md
@@ -109,7 +109,7 @@
{"message": "Oops! yolo did something. There goes a rainbow..."}
```
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.requests import Request` & `from starlette.responses import JSONResponse`.
@@ -192,7 +192,7 @@ path -> item_id
{!../../docs_src/handling_errors/tutorial004.py!}
```
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.responses import PlainTextResponse`.
diff --git a/docs/em/docs/tutorial/header-params.md b/docs/em/docs/tutorial/header-params.md
index 34abd3a4c..d9eafe77e 100644
--- a/docs/em/docs/tutorial/header-params.md
+++ b/docs/em/docs/tutorial/header-params.md
@@ -44,7 +44,7 @@
////
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
`Header` "👭" 🎓 `Path`, `Query` & `Cookie`. ⚫️ 😖 ⚪️➡️ 🎏 ⚠ `Param` 🎓.
diff --git a/docs/em/docs/tutorial/middleware.md b/docs/em/docs/tutorial/middleware.md
index cd0777ebb..a794ab019 100644
--- a/docs/em/docs/tutorial/middleware.md
+++ b/docs/em/docs/tutorial/middleware.md
@@ -11,7 +11,7 @@
* ⚫️ 💪 🕳 👈 **📨** ⚖️ 🏃 🙆 💪 📟.
* ⤴️ ⚫️ 📨 **📨**.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
🚥 👆 ✔️ 🔗 ⏮️ `yield`, 🚪 📟 🔜 🏃 *⏮️* 🛠️.
@@ -43,7 +43,7 @@
///
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.requests import Request`.
diff --git a/docs/em/docs/tutorial/path-operation-configuration.md b/docs/em/docs/tutorial/path-operation-configuration.md
index 9529928fb..deb71c807 100644
--- a/docs/em/docs/tutorial/path-operation-configuration.md
+++ b/docs/em/docs/tutorial/path-operation-configuration.md
@@ -42,7 +42,7 @@
👈 👔 📟 🔜 ⚙️ 📨 & 🔜 🚮 🗄 🔗.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette import status`.
diff --git a/docs/em/docs/tutorial/path-params-numeric-validations.md b/docs/em/docs/tutorial/path-params-numeric-validations.md
index c25f0323e..74dbb55f7 100644
--- a/docs/em/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/em/docs/tutorial/path-params-numeric-validations.md
@@ -140,7 +140,7 @@
///
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
🕐❔ 👆 🗄 `Query`, `Path` & 🎏 ⚪️➡️ `fastapi`, 👫 🤙 🔢.
diff --git a/docs/em/docs/tutorial/request-files.md b/docs/em/docs/tutorial/request-files.md
index 102690f4b..9dcad81b4 100644
--- a/docs/em/docs/tutorial/request-files.md
+++ b/docs/em/docs/tutorial/request-files.md
@@ -99,13 +99,13 @@ contents = await myfile.read()
contents = myfile.file.read()
```
-/// note | "`async` 📡 ℹ"
+/// note | `async` 📡 ℹ
🕐❔ 👆 ⚙️ `async` 👩🔬, **FastAPI** 🏃 📁 👩🔬 🧵 & ⌛ 👫.
///
-/// note | "💃 📡 ℹ"
+/// note | 💃 📡 ℹ
**FastAPI**'Ⓜ `UploadFile` 😖 🔗 ⚪️➡️ **💃**'Ⓜ `UploadFile`, ✋️ 🚮 💪 🍕 ⚒ ⚫️ 🔗 ⏮️ **Pydantic** & 🎏 🍕 FastAPI.
@@ -117,7 +117,7 @@ contents = myfile.file.read()
**FastAPI** 🔜 ⚒ 💭 ✍ 👈 📊 ⚪️➡️ ▶️️ 🥉 ↩️ 🎻.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
📊 ⚪️➡️ 📨 🛎 🗜 ⚙️ "📻 🆎" `application/x-www-form-urlencoded` 🕐❔ ⚫️ 🚫 🔌 📁.
@@ -189,7 +189,7 @@ contents = myfile.file.read()
👆 🔜 📨, 📣, `list` `bytes` ⚖️ `UploadFile`Ⓜ.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.responses import HTMLResponse`.
diff --git a/docs/em/docs/tutorial/request-forms.md b/docs/em/docs/tutorial/request-forms.md
index cbe4e2862..d364d2c92 100644
--- a/docs/em/docs/tutorial/request-forms.md
+++ b/docs/em/docs/tutorial/request-forms.md
@@ -50,7 +50,7 @@
**FastAPI** 🔜 ⚒ 💭 ✍ 👈 📊 ⚪️➡️ ▶️️ 🥉 ↩️ 🎻.
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
📊 ⚪️➡️ 📨 🛎 🗜 ⚙️ "📻 🆎" `application/x-www-form-urlencoded`.
diff --git a/docs/em/docs/tutorial/response-status-code.md b/docs/em/docs/tutorial/response-status-code.md
index cefff708f..478060326 100644
--- a/docs/em/docs/tutorial/response-status-code.md
+++ b/docs/em/docs/tutorial/response-status-code.md
@@ -94,7 +94,7 @@ FastAPI 💭 👉, & 🔜 🏭 🗄 🩺 👈 🇵🇸 📤 🙅♂ 📨
<img src="/img/tutorial/response-status-code/image02.png">
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette import status`.
diff --git a/docs/em/docs/tutorial/security/first-steps.md b/docs/em/docs/tutorial/security/first-steps.md
index 6245f52ab..21c48757f 100644
--- a/docs/em/docs/tutorial/security/first-steps.md
+++ b/docs/em/docs/tutorial/security/first-steps.md
@@ -56,7 +56,7 @@ $ uvicorn main:app --reload
<img src="/img/tutorial/security/image01.png">
-/// check | "✔ 🔼 ❗"
+/// check | ✔ 🔼 ❗
👆 ⏪ ✔️ ✨ 🆕 "✔" 🔼.
@@ -176,7 +176,7 @@ oauth2_scheme(some, parameters)
**FastAPI** 🔜 💭 👈 ⚫️ 💪 ⚙️ 👉 🔗 🔬 "💂♂ ⚖" 🗄 🔗 (& 🏧 🛠️ 🩺).
-/// info | "📡 ℹ"
+/// info | 📡 ℹ
**FastAPI** 🔜 💭 👈 ⚫️ 💪 ⚙️ 🎓 `OAuth2PasswordBearer` (📣 🔗) 🔬 💂♂ ⚖ 🗄 ↩️ ⚫️ 😖 ⚪️➡️ `fastapi.security.oauth2.OAuth2`, ❔ 🔄 😖 ⚪️➡️ `fastapi.security.base.SecurityBase`.
diff --git a/docs/em/docs/tutorial/sql-databases.md b/docs/em/docs/tutorial/sql-databases.md
index c59d8c131..49162dd62 100644
--- a/docs/em/docs/tutorial/sql-databases.md
+++ b/docs/em/docs/tutorial/sql-databases.md
@@ -159,7 +159,7 @@ connect_args={"check_same_thread": False}
...💪 🕴 `SQLite`. ⚫️ 🚫 💪 🎏 💽.
-/// info | "📡 ℹ"
+/// info | 📡 ℹ
🔢 🗄 🔜 🕴 ✔ 1️⃣ 🧵 🔗 ⏮️ ⚫️, 🤔 👈 🔠 🧵 🔜 🍵 🔬 📨.
@@ -622,7 +622,7 @@ current_user.items
////
-/// info | "📡 ℹ"
+/// info | 📡 ℹ
🔢 `db` 🤙 🆎 `SessionLocal`, ✋️ 👉 🎓 (✍ ⏮️ `sessionmaker()`) "🗳" 🇸🇲 `Session`,, 👨🎨 🚫 🤙 💭 ⚫️❔ 👩🔬 🚚.
@@ -705,7 +705,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
///
-/// note | "📶 📡 ℹ"
+/// note | 📶 📡 ℹ
🚥 👆 😟 & ✔️ ⏬ 📡 💡, 👆 💪 ✅ 📶 📡 ℹ ❔ 👉 `async def` 🆚 `def` 🍵 [🔁](../async.md#i_2){.internal-link target=_blank} 🩺.
diff --git a/docs/em/docs/tutorial/static-files.md b/docs/em/docs/tutorial/static-files.md
index 0627031b3..c9bb9ff6a 100644
--- a/docs/em/docs/tutorial/static-files.md
+++ b/docs/em/docs/tutorial/static-files.md
@@ -11,7 +11,7 @@
{!../../docs_src/static_files/tutorial001.py!}
```
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.staticfiles import StaticFiles`.
diff --git a/docs/em/docs/tutorial/testing.md b/docs/em/docs/tutorial/testing.md
index 5f3d5e736..27cf9f16e 100644
--- a/docs/em/docs/tutorial/testing.md
+++ b/docs/em/docs/tutorial/testing.md
@@ -40,7 +40,7 @@
///
-/// note | "📡 ℹ"
+/// note | 📡 ℹ
👆 💪 ⚙️ `from starlette.testclient import TestClient`.
diff --git a/docs/en/docs/advanced/additional-status-codes.md b/docs/en/docs/advanced/additional-status-codes.md
index e39249467..077a00488 100644
--- a/docs/en/docs/advanced/additional-status-codes.md
+++ b/docs/en/docs/advanced/additional-status-codes.md
@@ -26,7 +26,7 @@ Make sure it has the data you want it to have, and that the values are valid JSO
///
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.responses import JSONResponse`.
diff --git a/docs/en/docs/advanced/behind-a-proxy.md b/docs/en/docs/advanced/behind-a-proxy.md
index 87a62e88b..1f0d0fd9f 100644
--- a/docs/en/docs/advanced/behind-a-proxy.md
+++ b/docs/en/docs/advanced/behind-a-proxy.md
@@ -82,7 +82,7 @@ $ fastapi run main.py --root-path /api/v1
If you use Hypercorn, it also has the option `--root-path`.
-/// note | "Technical Details"
+/// note | Technical Details
The ASGI specification defines a `root_path` for this use case.
diff --git a/docs/en/docs/advanced/custom-response.md b/docs/en/docs/advanced/custom-response.md
index 95152b9fe..8268dd81a 100644
--- a/docs/en/docs/advanced/custom-response.md
+++ b/docs/en/docs/advanced/custom-response.md
@@ -113,7 +113,7 @@ Here are some of the available responses.
Keep in mind that you can use `Response` to return anything else, or even create a custom sub-class.
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.responses import HTMLResponse`.
diff --git a/docs/en/docs/advanced/middleware.md b/docs/en/docs/advanced/middleware.md
index 3faf3fbf9..1d40b1c8f 100644
--- a/docs/en/docs/advanced/middleware.md
+++ b/docs/en/docs/advanced/middleware.md
@@ -43,7 +43,7 @@ app.add_middleware(UnicornMiddleware, some_config="rainbow")
**FastAPI** includes several middlewares for common use cases, we'll see next how to use them.
-/// note | "Technical Details"
+/// note | Technical Details
For the next examples, you could also use `from starlette.middleware.something import SomethingMiddleware`.
diff --git a/docs/en/docs/advanced/path-operation-advanced-configuration.md b/docs/en/docs/advanced/path-operation-advanced-configuration.md
index fea1e4db0..c4814ebd2 100644
--- a/docs/en/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/en/docs/advanced/path-operation-advanced-configuration.md
@@ -66,7 +66,7 @@ There's a whole chapter here in the documentation about it, you can read it at [
When you declare a *path operation* in your application, **FastAPI** automatically generates the relevant metadata about that *path operation* to be included in the OpenAPI schema.
-/// note | "Technical details"
+/// note | Technical details
In the OpenAPI specification it is called the <a href="https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operation-object" class="external-link" target="_blank">Operation Object</a>.
diff --git a/docs/en/docs/advanced/response-cookies.md b/docs/en/docs/advanced/response-cookies.md
index 988394d06..f6d17f35d 100644
--- a/docs/en/docs/advanced/response-cookies.md
+++ b/docs/en/docs/advanced/response-cookies.md
@@ -38,7 +38,7 @@ And also that you are not sending any data that should have been filtered by a `
### More info
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.responses import Response` or `from starlette.responses import JSONResponse`.
diff --git a/docs/en/docs/advanced/response-directly.md b/docs/en/docs/advanced/response-directly.md
index 09947a2ee..691b1e7cd 100644
--- a/docs/en/docs/advanced/response-directly.md
+++ b/docs/en/docs/advanced/response-directly.md
@@ -36,7 +36,7 @@ For those cases, you can use the `jsonable_encoder` to convert your data before
{* ../../docs_src/response_directly/tutorial001.py hl[6:7,21:22] *}
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.responses import JSONResponse`.
diff --git a/docs/en/docs/advanced/response-headers.md b/docs/en/docs/advanced/response-headers.md
index fca641d89..97e888983 100644
--- a/docs/en/docs/advanced/response-headers.md
+++ b/docs/en/docs/advanced/response-headers.md
@@ -24,7 +24,7 @@ Create a response as described in [Return a Response Directly](response-directly
{* ../../docs_src/response_headers/tutorial001.py hl[10:12] *}
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.responses import Response` or `from starlette.responses import JSONResponse`.
diff --git a/docs/en/docs/advanced/security/oauth2-scopes.md b/docs/en/docs/advanced/security/oauth2-scopes.md
index 5ba0b1c14..4cb0b39bc 100644
--- a/docs/en/docs/advanced/security/oauth2-scopes.md
+++ b/docs/en/docs/advanced/security/oauth2-scopes.md
@@ -126,7 +126,7 @@ We are doing it here to demonstrate how **FastAPI** handles scopes declared at d
{* ../../docs_src/security/tutorial005_an_py310.py hl[5,140,171] *}
-/// info | "Technical Details"
+/// info | Technical Details
`Security` is actually a subclass of `Depends`, and it has just one extra parameter that we'll see later.
diff --git a/docs/en/docs/advanced/templates.md b/docs/en/docs/advanced/templates.md
index d688c5cb7..76f0ef1de 100644
--- a/docs/en/docs/advanced/templates.md
+++ b/docs/en/docs/advanced/templates.md
@@ -45,7 +45,7 @@ By declaring `response_class=HTMLResponse` the docs UI will be able to know that
///
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.templating import Jinja2Templates`.
diff --git a/docs/en/docs/advanced/using-request-directly.md b/docs/en/docs/advanced/using-request-directly.md
index 3e35734bc..2f88c8f20 100644
--- a/docs/en/docs/advanced/using-request-directly.md
+++ b/docs/en/docs/advanced/using-request-directly.md
@@ -47,7 +47,7 @@ The same way, you can declare any other parameter as normally, and additionally,
You can read more details about the <a href="https://www.starlette.io/requests/" class="external-link" target="_blank">`Request` object in the official Starlette documentation site</a>.
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.requests import Request`.
diff --git a/docs/en/docs/advanced/websockets.md b/docs/en/docs/advanced/websockets.md
index 95a394749..ee8e901df 100644
--- a/docs/en/docs/advanced/websockets.md
+++ b/docs/en/docs/advanced/websockets.md
@@ -46,7 +46,7 @@ In your **FastAPI** application, create a `websocket`:
{* ../../docs_src/websockets/tutorial001.py hl[1,46:47] *}
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.websockets import WebSocket`.
diff --git a/docs/en/docs/alternatives.md b/docs/en/docs/alternatives.md
index f596232d3..326f0dbe1 100644
--- a/docs/en/docs/alternatives.md
+++ b/docs/en/docs/alternatives.md
@@ -36,7 +36,7 @@ Django REST Framework was created by Tom Christie. The same creator of Starlette
///
-/// check | "Inspired **FastAPI** to"
+/// check | Inspired **FastAPI** to
Have an automatic API documentation web user interface.
@@ -56,7 +56,7 @@ This decoupling of parts, and being a "microframework" that could be extended to
Given the simplicity of Flask, it seemed like a good match for building APIs. The next thing to find was a "Django REST Framework" for Flask.
-/// check | "Inspired **FastAPI** to"
+/// check | Inspired **FastAPI** to
Be a micro-framework. Making it easy to mix and match the tools and parts needed.
@@ -98,7 +98,7 @@ def read_url():
See the similarities in `requests.get(...)` and `@app.get(...)`.
-/// check | "Inspired **FastAPI** to"
+/// check | Inspired **FastAPI** to
* Have a simple and intuitive API.
* Use HTTP method names (operations) directly, in a straightforward and intuitive way.
@@ -118,7 +118,7 @@ At some point, Swagger was given to the Linux Foundation, to be renamed OpenAPI.
That's why when talking about version 2.0 it's common to say "Swagger", and for version 3+ "OpenAPI".
-/// check | "Inspired **FastAPI** to"
+/// check | Inspired **FastAPI** to
Adopt and use an open standard for API specifications, instead of a custom schema.
@@ -147,7 +147,7 @@ These features are what Marshmallow was built to provide. It is a great library,
But it was created before there existed Python type hints. So, to define every <abbr title="the definition of how data should be formed">schema</abbr> you need to use specific utils and classes provided by Marshmallow.
-/// check | "Inspired **FastAPI** to"
+/// check | Inspired **FastAPI** to
Use code to define "schemas" that provide data types and validation, automatically.
@@ -169,7 +169,7 @@ Webargs was created by the same Marshmallow developers.
///
-/// check | "Inspired **FastAPI** to"
+/// check | Inspired **FastAPI** to
Have automatic validation of incoming request data.
@@ -199,7 +199,7 @@ APISpec was created by the same Marshmallow developers.
///
-/// check | "Inspired **FastAPI** to"
+/// check | Inspired **FastAPI** to
Support the open standard for APIs, OpenAPI.
@@ -231,7 +231,7 @@ Flask-apispec was created by the same Marshmallow developers.
///
-/// check | "Inspired **FastAPI** to"
+/// check | Inspired **FastAPI** to
Generate the OpenAPI schema automatically, from the same code that defines serialization and validation.
@@ -251,7 +251,7 @@ But as TypeScript data is not preserved after compilation to JavaScript, it cann
It can't handle nested models very well. So, if the JSON body in the request is a JSON object that has inner fields that in turn are nested JSON objects, it cannot be properly documented and validated.
-/// check | "Inspired **FastAPI** to"
+/// check | Inspired **FastAPI** to
Use Python types to have great editor support.
@@ -263,7 +263,7 @@ Have a powerful dependency injection system. Find a way to minimize code repetit
It was one of the first extremely fast Python frameworks based on `asyncio`. It was made to be very similar to Flask.
-/// note | "Technical Details"
+/// note | Technical Details
It used <a href="https://github.com/MagicStack/uvloop" class="external-link" target="_blank">`uvloop`</a> instead of the default Python `asyncio` loop. That's what made it so fast.
@@ -271,7 +271,7 @@ It clearly inspired Uvicorn and Starlette, that are currently faster than Sanic
///
-/// check | "Inspired **FastAPI** to"
+/// check | Inspired **FastAPI** to
Find a way to have a crazy performance.
@@ -287,7 +287,7 @@ It is designed to have functions that receive two parameters, one "request" and
So, data validation, serialization, and documentation, have to be done in code, not automatically. Or they have to be implemented as a framework on top of Falcon, like Hug. This same distinction happens in other frameworks that are inspired by Falcon's design, of having one request object and one response object as parameters.
-/// check | "Inspired **FastAPI** to"
+/// check | Inspired **FastAPI** to
Find ways to get great performance.
@@ -313,7 +313,7 @@ The dependency injection system requires pre-registration of the dependencies an
Routes are declared in a single place, using functions declared in other places (instead of using decorators that can be placed right on top of the function that handles the endpoint). This is closer to how Django does it than to how Flask (and Starlette) does it. It separates in the code things that are relatively tightly coupled.
-/// check | "Inspired **FastAPI** to"
+/// check | Inspired **FastAPI** to
Define extra validations for data types using the "default" value of model attributes. This improves editor support, and it was not available in Pydantic before.
@@ -341,7 +341,7 @@ Hug was created by Timothy Crosley, the same creator of <a href="https://github.
///
-/// check | "Ideas inspiring **FastAPI**"
+/// check | Ideas inspiring **FastAPI**
Hug inspired parts of APIStar, and was one of the tools I found most promising, alongside APIStar.
@@ -385,7 +385,7 @@ APIStar was created by Tom Christie. The same guy that created:
///
-/// check | "Inspired **FastAPI** to"
+/// check | Inspired **FastAPI** to
Exist.
@@ -409,7 +409,7 @@ That makes it extremely intuitive.
It is comparable to Marshmallow. Although it's faster than Marshmallow in benchmarks. And as it is based on the same Python type hints, the editor support is great.
-/// check | "**FastAPI** uses it to"
+/// check | **FastAPI** uses it to
Handle all the data validation, data serialization and automatic model documentation (based on JSON Schema).
@@ -444,7 +444,7 @@ But it doesn't provide automatic data validation, serialization or documentation
That's one of the main things that **FastAPI** adds on top, all based on Python type hints (using Pydantic). That, plus the dependency injection system, security utilities, OpenAPI schema generation, etc.
-/// note | "Technical Details"
+/// note | Technical Details
ASGI is a new "standard" being developed by Django core team members. It is still not a "Python standard" (a PEP), although they are in the process of doing that.
@@ -452,7 +452,7 @@ Nevertheless, it is already being used as a "standard" by several tools. This gr
///
-/// check | "**FastAPI** uses it to"
+/// check | **FastAPI** uses it to
Handle all the core web parts. Adding features on top.
@@ -470,7 +470,7 @@ It is not a web framework, but a server. For example, it doesn't provide tools f
It is the recommended server for Starlette and **FastAPI**.
-/// check | "**FastAPI** recommends it as"
+/// check | **FastAPI** recommends it as
The main web server to run **FastAPI** applications.
diff --git a/docs/en/docs/contributing.md b/docs/en/docs/contributing.md
index 0dc07b89b..3a25b4ed5 100644
--- a/docs/en/docs/contributing.md
+++ b/docs/en/docs/contributing.md
@@ -34,7 +34,7 @@ And if you update that local FastAPI source code when you run that Python file a
That way, you don't have to "install" your local version to be able to test every change.
-/// note | "Technical Details"
+/// note | Technical Details
This only happens when you install using this included `requirements.txt` instead of running `pip install fastapi` directly.
diff --git a/docs/en/docs/how-to/custom-request-and-route.md b/docs/en/docs/how-to/custom-request-and-route.md
index 25ec0a335..9b4160d75 100644
--- a/docs/en/docs/how-to/custom-request-and-route.md
+++ b/docs/en/docs/how-to/custom-request-and-route.md
@@ -56,7 +56,7 @@ Here we use it to create a `GzipRequest` from the original request.
{* ../../docs_src/custom_request_and_route/tutorial001.py hl[18:26] *}
-/// note | "Technical Details"
+/// note | Technical Details
A `Request` has a `request.scope` attribute, that's just a Python `dict` containing the metadata related to the request.
diff --git a/docs/en/docs/management-tasks.md b/docs/en/docs/management-tasks.md
index 7e7aa3baf..05cd5d27d 100644
--- a/docs/en/docs/management-tasks.md
+++ b/docs/en/docs/management-tasks.md
@@ -171,7 +171,7 @@ Esto es un consejo.
Those don't have to be translated, but if they are, they need to be written as:
```
-/// tip | "consejo"
+/// tip | consejo
Esto es un consejo.
@@ -181,7 +181,7 @@ Esto es un consejo.
Which looks like:
-/// tip | "consejo"
+/// tip | consejo
Esto es un consejo.
diff --git a/docs/en/docs/tutorial/bigger-applications.md b/docs/en/docs/tutorial/bigger-applications.md
index 4ec9b15bd..605ced0d3 100644
--- a/docs/en/docs/tutorial/bigger-applications.md
+++ b/docs/en/docs/tutorial/bigger-applications.md
@@ -440,7 +440,7 @@ With `app.include_router()` we can add each `APIRouter` to the main `FastAPI` ap
It will include all the routes from that router as part of it.
-/// note | "Technical Details"
+/// note | Technical Details
It will actually internally create a *path operation* for each *path operation* that was declared in the `APIRouter`.
@@ -503,7 +503,7 @@ Here we do it... just to show that we can 🤷:
and it will work correctly, together with all the other *path operations* added with `app.include_router()`.
-/// info | "Very Technical Details"
+/// info | Very Technical Details
**Note**: this is a very technical detail that you probably can **just skip**.
diff --git a/docs/en/docs/tutorial/body-fields.md b/docs/en/docs/tutorial/body-fields.md
index 7f7e34fcc..3ce30cbf6 100644
--- a/docs/en/docs/tutorial/body-fields.md
+++ b/docs/en/docs/tutorial/body-fields.md
@@ -23,7 +23,7 @@ You can then use `Field` with model attributes:
`Field` works the same way as `Query`, `Path` and `Body`, it has all the same parameters, etc.
-/// note | "Technical Details"
+/// note | Technical Details
Actually, `Query`, `Path` and others you'll see next create objects of subclasses of a common `Param` class, which is itself a subclass of Pydantic's `FieldInfo` class.
diff --git a/docs/en/docs/tutorial/cookie-params.md b/docs/en/docs/tutorial/cookie-params.md
index aeeefe3f5..5341406d5 100644
--- a/docs/en/docs/tutorial/cookie-params.md
+++ b/docs/en/docs/tutorial/cookie-params.md
@@ -16,7 +16,7 @@ You can define the default value as well as all the extra validation or annotati
{* ../../docs_src/cookie_params/tutorial001_an_py310.py hl[9] *}
-/// note | "Technical Details"
+/// note | Technical Details
`Cookie` is a "sister" class of `Path` and `Query`. It also inherits from the same common `Param` class.
diff --git a/docs/en/docs/tutorial/cors.md b/docs/en/docs/tutorial/cors.md
index a5d9b763a..cf31cfcf5 100644
--- a/docs/en/docs/tutorial/cors.md
+++ b/docs/en/docs/tutorial/cors.md
@@ -77,7 +77,7 @@ Any request with an `Origin` header. In this case the middleware will pass the r
For more info about <abbr title="Cross-Origin Resource Sharing">CORS</abbr>, check the <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS" class="external-link" target="_blank">Mozilla CORS documentation</a>.
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.middleware.cors import CORSMiddleware`.
diff --git a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
index 97da668aa..430b7a73f 100644
--- a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -10,7 +10,7 @@ Make sure to use `yield` one single time per dependency.
///
-/// note | "Technical Details"
+/// note | Technical Details
Any function that is valid to use with:
@@ -149,7 +149,7 @@ You can have any combinations of dependencies that you want.
**FastAPI** will make sure everything is run in the correct order.
-/// note | "Technical Details"
+/// note | Technical Details
This works thanks to Python's <a href="https://docs.python.org/3/library/contextlib.html" class="external-link" target="_blank">Context Managers</a>.
diff --git a/docs/en/docs/tutorial/first-steps.md b/docs/en/docs/tutorial/first-steps.md
index 1c20b945a..783295933 100644
--- a/docs/en/docs/tutorial/first-steps.md
+++ b/docs/en/docs/tutorial/first-steps.md
@@ -159,7 +159,7 @@ You could also use it to generate code automatically, for clients that communica
`FastAPI` is a Python class that provides all the functionality for your API.
-/// note | "Technical Details"
+/// note | Technical Details
`FastAPI` is a class that inherits directly from `Starlette`.
@@ -245,7 +245,7 @@ The `@app.get("/")` tells **FastAPI** that the function right below is in charge
* the path `/`
* using a <abbr title="an HTTP GET method"><code>get</code> operation</abbr>
-/// info | "`@decorator` Info"
+/// info | `@decorator` Info
That `@something` syntax in Python is called a "decorator".
diff --git a/docs/en/docs/tutorial/handling-errors.md b/docs/en/docs/tutorial/handling-errors.md
index 38c15761b..537cb3e72 100644
--- a/docs/en/docs/tutorial/handling-errors.md
+++ b/docs/en/docs/tutorial/handling-errors.md
@@ -109,7 +109,7 @@ So, you will receive a clean error, with an HTTP status code of `418` and a JSON
{"message": "Oops! yolo did something. There goes a rainbow..."}
```
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.requests import Request` and `from starlette.responses import JSONResponse`.
@@ -192,7 +192,7 @@ For example, you could want to return a plain text response instead of JSON for
{!../../docs_src/handling_errors/tutorial004.py!}
```
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.responses import PlainTextResponse`.
diff --git a/docs/en/docs/tutorial/header-params.md b/docs/en/docs/tutorial/header-params.md
index e34f301a9..49ad7aa25 100644
--- a/docs/en/docs/tutorial/header-params.md
+++ b/docs/en/docs/tutorial/header-params.md
@@ -16,7 +16,7 @@ You can define the default value as well as all the extra validation or annotati
{* ../../docs_src/header_params/tutorial001_an_py310.py hl[9] *}
-/// note | "Technical Details"
+/// note | Technical Details
`Header` is a "sister" class of `Path`, `Query` and `Cookie`. It also inherits from the same common `Param` class.
diff --git a/docs/en/docs/tutorial/middleware.md b/docs/en/docs/tutorial/middleware.md
index 16d853018..4693d977a 100644
--- a/docs/en/docs/tutorial/middleware.md
+++ b/docs/en/docs/tutorial/middleware.md
@@ -11,7 +11,7 @@ A "middleware" is a function that works with every **request** before it is proc
* It can do something to that **response** or run any needed code.
* Then it returns the **response**.
-/// note | "Technical Details"
+/// note | Technical Details
If you have dependencies with `yield`, the exit code will run *after* the middleware.
@@ -41,7 +41,7 @@ But if you have custom headers that you want a client in a browser to be able to
///
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.requests import Request`.
diff --git a/docs/en/docs/tutorial/path-operation-configuration.md b/docs/en/docs/tutorial/path-operation-configuration.md
index c78d20ea6..f2b5fd795 100644
--- a/docs/en/docs/tutorial/path-operation-configuration.md
+++ b/docs/en/docs/tutorial/path-operation-configuration.md
@@ -20,7 +20,7 @@ But if you don't remember what each number code is for, you can use the shortcut
That status code will be used in the response and will be added to the OpenAPI schema.
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette import status`.
diff --git a/docs/en/docs/tutorial/path-params-numeric-validations.md b/docs/en/docs/tutorial/path-params-numeric-validations.md
index dc13a513c..9440bcc03 100644
--- a/docs/en/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/en/docs/tutorial/path-params-numeric-validations.md
@@ -149,7 +149,7 @@ All of them share the same parameters for additional validation and metadata you
///
-/// note | "Technical Details"
+/// note | Technical Details
When you import `Query`, `Path` and others from `fastapi`, they are actually functions.
diff --git a/docs/en/docs/tutorial/request-files.md b/docs/en/docs/tutorial/request-files.md
index 2b433555b..0d57f3566 100644
--- a/docs/en/docs/tutorial/request-files.md
+++ b/docs/en/docs/tutorial/request-files.md
@@ -97,13 +97,13 @@ If you are inside of a normal `def` *path operation function*, you can access th
contents = myfile.file.read()
```
-/// note | "`async` Technical Details"
+/// note | `async` Technical Details
When you use the `async` methods, **FastAPI** runs the file methods in a threadpool and awaits for them.
///
-/// note | "Starlette Technical Details"
+/// note | Starlette Technical Details
**FastAPI**'s `UploadFile` inherits directly from **Starlette**'s `UploadFile`, but adds some necessary parts to make it compatible with **Pydantic** and the other parts of FastAPI.
@@ -115,7 +115,7 @@ The way HTML forms (`<form></form>`) sends the data to the server normally uses
**FastAPI** will make sure to read that data from the right place instead of JSON.
-/// note | "Technical Details"
+/// note | Technical Details
Data from forms is normally encoded using the "media type" `application/x-www-form-urlencoded` when it doesn't include files.
@@ -157,7 +157,7 @@ To use that, declare a list of `bytes` or `UploadFile`:
You will receive, as declared, a `list` of `bytes` or `UploadFile`s.
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.responses import HTMLResponse`.
diff --git a/docs/en/docs/tutorial/request-forms.md b/docs/en/docs/tutorial/request-forms.md
index 2ccc6886e..c65e9874c 100644
--- a/docs/en/docs/tutorial/request-forms.md
+++ b/docs/en/docs/tutorial/request-forms.md
@@ -106,7 +106,7 @@ The way HTML forms (`<form></form>`) sends the data to the server normally uses
**FastAPI** will make sure to read that data from the right place instead of JSON.
-/// note | "Technical Details"
+/// note | Technical Details
Data from forms is normally encoded using the "media type" `application/x-www-form-urlencoded`.
diff --git a/docs/en/docs/tutorial/response-status-code.md b/docs/en/docs/tutorial/response-status-code.md
index a32faa40b..711042a46 100644
--- a/docs/en/docs/tutorial/response-status-code.md
+++ b/docs/en/docs/tutorial/response-status-code.md
@@ -88,7 +88,7 @@ They are just a convenience, they hold the same number, but that way you can use
<img src="/img/tutorial/response-status-code/image02.png">
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette import status`.
diff --git a/docs/en/docs/tutorial/security/first-steps.md b/docs/en/docs/tutorial/security/first-steps.md
index ead2aa799..37e37cb5b 100644
--- a/docs/en/docs/tutorial/security/first-steps.md
+++ b/docs/en/docs/tutorial/security/first-steps.md
@@ -88,7 +88,7 @@ You will see something like this:
<img src="/img/tutorial/security/image01.png">
-/// check | "Authorize button!"
+/// check | Authorize button!
You already have a shiny new "Authorize" button.
@@ -260,7 +260,7 @@ This dependency will provide a `str` that is assigned to the parameter `token` o
**FastAPI** will know that it can use this dependency to define a "security scheme" in the OpenAPI schema (and the automatic API docs).
-/// info | "Technical Details"
+/// info | Technical Details
**FastAPI** will know that it can use the class `OAuth2PasswordBearer` (declared in a dependency) to define the security scheme in OpenAPI because it inherits from `fastapi.security.oauth2.OAuth2`, which in turn inherits from `fastapi.security.base.SecurityBase`.
diff --git a/docs/en/docs/tutorial/static-files.md b/docs/en/docs/tutorial/static-files.md
index 46affd4f2..1d277a51c 100644
--- a/docs/en/docs/tutorial/static-files.md
+++ b/docs/en/docs/tutorial/static-files.md
@@ -9,7 +9,7 @@ You can serve static files automatically from a directory using `StaticFiles`.
{* ../../docs_src/static_files/tutorial001.py hl[2,6] *}
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.staticfiles import StaticFiles`.
diff --git a/docs/en/docs/tutorial/testing.md b/docs/en/docs/tutorial/testing.md
index 7f609a595..a204f596f 100644
--- a/docs/en/docs/tutorial/testing.md
+++ b/docs/en/docs/tutorial/testing.md
@@ -44,7 +44,7 @@ This allows you to use `pytest` directly without complications.
///
-/// note | "Technical Details"
+/// note | Technical Details
You could also use `from starlette.testclient import TestClient`.
diff --git a/docs/es/docs/advanced/path-operation-advanced-configuration.md b/docs/es/docs/advanced/path-operation-advanced-configuration.md
index f6813f0ff..12399d581 100644
--- a/docs/es/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/es/docs/advanced/path-operation-advanced-configuration.md
@@ -2,7 +2,7 @@
## OpenAPI operationId
-/// warning | "Advertencia"
+/// warning | Advertencia
Si no eres una persona "experta" en OpenAPI, probablemente no necesitas leer esto.
diff --git a/docs/es/docs/tutorial/cookie-params.md b/docs/es/docs/tutorial/cookie-params.md
index db3fc092e..9a3b1a00b 100644
--- a/docs/es/docs/tutorial/cookie-params.md
+++ b/docs/es/docs/tutorial/cookie-params.md
@@ -16,7 +16,7 @@ El primer valor es el valor por defecto, puedes pasar todos los parámetros adic
{* ../../docs_src/cookie_params/tutorial001_an_py310.py hl[9]*}
-/// note | "Detalles Técnicos"
+/// note | Detalles Técnicos
`Cookie` es una clase "hermana" de `Path` y `Query`. También hereda de la misma clase común `Param`.
diff --git a/docs/es/docs/tutorial/index.md b/docs/es/docs/tutorial/index.md
index 46c57c4c3..fa13450f0 100644
--- a/docs/es/docs/tutorial/index.md
+++ b/docs/es/docs/tutorial/index.md
@@ -50,7 +50,7 @@ $ pip install "fastapi[all]"
...eso también incluye `uvicorn` que puedes usar como el servidor que ejecuta tu código.
-/// note | "Nota"
+/// note | Nota
También puedes instalarlo parte por parte.
diff --git a/docs/fa/docs/tutorial/middleware.md b/docs/fa/docs/tutorial/middleware.md
index ca631d507..a3ab483fb 100644
--- a/docs/fa/docs/tutorial/middleware.md
+++ b/docs/fa/docs/tutorial/middleware.md
@@ -11,7 +11,7 @@
* می تواند کاری با **پاسخ** انجام دهید یا هر کد مورد نیازتان را اجرا کند.
* سپس **پاسخ** را برمی گرداند.
-/// توجه | "جزئیات فنی"
+/// توجه | جزئیات فنی
در صورت وجود وابستگی هایی با `yield`، کد خروجی **پس از** اجرای میانافزار اجرا خواهد شد.
@@ -40,7 +40,7 @@
///
-/// توجه | "جزئیات فنی"
+/// توجه | جزئیات فنی
شما همچنین میتوانید از `from starlette.requests import Request` استفاده کنید.
diff --git a/docs/fr/docs/advanced/additional-responses.md b/docs/fr/docs/advanced/additional-responses.md
index 12f944b12..38527aad3 100644
--- a/docs/fr/docs/advanced/additional-responses.md
+++ b/docs/fr/docs/advanced/additional-responses.md
@@ -1,6 +1,6 @@
# Réponses supplémentaires dans OpenAPI
-/// warning | "Attention"
+/// warning | Attention
Ceci concerne un sujet plutôt avancé.
@@ -28,7 +28,7 @@ Par exemple, pour déclarer une autre réponse avec un code HTTP `404` et un mod
{* ../../docs_src/additional_responses/tutorial001.py hl[18,22] *}
-/// note | "Remarque"
+/// note | Remarque
Gardez à l'esprit que vous devez renvoyer directement `JSONResponse`.
@@ -177,7 +177,7 @@ Par exemple, vous pouvez ajouter un type de média supplémentaire `image/png`,
{* ../../docs_src/additional_responses/tutorial002.py hl[19:24,28] *}
-/// note | "Remarque"
+/// note | Remarque
Notez que vous devez retourner l'image en utilisant directement un `FileResponse`.
diff --git a/docs/fr/docs/advanced/additional-status-codes.md b/docs/fr/docs/advanced/additional-status-codes.md
index 06a8043ea..c406ae8cb 100644
--- a/docs/fr/docs/advanced/additional-status-codes.md
+++ b/docs/fr/docs/advanced/additional-status-codes.md
@@ -18,7 +18,7 @@ Pour y parvenir, importez `JSONResponse` et renvoyez-y directement votre contenu
{!../../docs_src/additional_status_codes/tutorial001.py!}
```
-/// warning | "Attention"
+/// warning | Attention
Lorsque vous renvoyez une `Response` directement, comme dans l'exemple ci-dessus, elle sera renvoyée directement.
@@ -28,7 +28,7 @@ Assurez-vous qu'il contient les données souhaitées et que les valeurs soient d
///
-/// note | "Détails techniques"
+/// note | Détails techniques
Vous pouvez également utiliser `from starlette.responses import JSONResponse`.
diff --git a/docs/fr/docs/advanced/index.md b/docs/fr/docs/advanced/index.md
index 198fa8c30..d9d8ad8e6 100644
--- a/docs/fr/docs/advanced/index.md
+++ b/docs/fr/docs/advanced/index.md
@@ -6,7 +6,7 @@ Le [Tutoriel - Guide de l'utilisateur](../tutorial/index.md){.internal-link targ
Dans les sections suivantes, vous verrez des options, configurations et fonctionnalités supplémentaires.
-/// note | "Remarque"
+/// note | Remarque
Les sections de ce chapitre ne sont **pas nécessairement "avancées"**.
diff --git a/docs/fr/docs/advanced/path-operation-advanced-configuration.md b/docs/fr/docs/advanced/path-operation-advanced-configuration.md
index b00f46727..7daf0fc65 100644
--- a/docs/fr/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/fr/docs/advanced/path-operation-advanced-configuration.md
@@ -2,7 +2,7 @@
## ID d'opération OpenAPI
-/// warning | "Attention"
+/// warning | Attention
Si vous n'êtes pas un "expert" en OpenAPI, vous n'en avez probablement pas besoin.
@@ -22,13 +22,13 @@ Vous devriez le faire après avoir ajouté toutes vos *paramètres de chemin*.
{* ../../docs_src/path_operation_advanced_configuration/tutorial002.py hl[2,12:21,24] *}
-/// tip | "Astuce"
+/// tip | Astuce
Si vous appelez manuellement `app.openapi()`, vous devez mettre à jour les `operationId` avant.
///
-/// warning | "Attention"
+/// warning | Attention
Pour faire cela, vous devez vous assurer que chacun de vos *chemin* ait un nom unique.
@@ -66,7 +66,7 @@ Il y a un chapitre entier ici dans la documentation à ce sujet, vous pouvez le
Lorsque vous déclarez un *chemin* dans votre application, **FastAPI** génère automatiquement les métadonnées concernant ce *chemin* à inclure dans le schéma OpenAPI.
-/// note | "Détails techniques"
+/// note | Détails techniques
La spécification OpenAPI appelle ces métadonnées des <a href="https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operation-object" class="external-link" target="_blank">Objets d'opération</a>.
@@ -78,7 +78,7 @@ Il inclut les `tags`, `parameters`, `requestBody`, `responses`, etc.
Ce schéma OpenAPI spécifique aux *operations* est normalement généré automatiquement par **FastAPI**, mais vous pouvez également l'étendre.
-/// tip | "Astuce"
+/// tip | Astuce
Si vous avez seulement besoin de déclarer des réponses supplémentaires, un moyen plus pratique de le faire est d'utiliser les [réponses supplémentaires dans OpenAPI](additional-responses.md){.internal-link target=_blank}.
@@ -161,7 +161,7 @@ Et nous analysons directement ce contenu YAML, puis nous utilisons à nouveau le
{* ../../docs_src/path_operation_advanced_configuration/tutorial007.py hl[26:33] *}
-/// tip | "Astuce"
+/// tip | Astuce
Ici, nous réutilisons le même modèle Pydantic.
diff --git a/docs/fr/docs/advanced/response-directly.md b/docs/fr/docs/advanced/response-directly.md
index 338aee017..4ff883c77 100644
--- a/docs/fr/docs/advanced/response-directly.md
+++ b/docs/fr/docs/advanced/response-directly.md
@@ -14,7 +14,7 @@ Cela peut être utile, par exemple, pour retourner des en-têtes personnalisés
En fait, vous pouvez retourner n'importe quelle `Response` ou n'importe quelle sous-classe de celle-ci.
-/// note | "Remarque"
+/// note | Remarque
`JSONResponse` est elle-même une sous-classe de `Response`.
@@ -36,7 +36,7 @@ Pour ces cas, vous pouvez spécifier un appel à `jsonable_encoder` pour convert
{* ../../docs_src/response_directly/tutorial001.py hl[6:7,21:22] *}
-/// note | "Détails techniques"
+/// note | Détails techniques
Vous pouvez aussi utiliser `from starlette.responses import JSONResponse`.
diff --git a/docs/fr/docs/alternatives.md b/docs/fr/docs/alternatives.md
index d2438dc36..4d6037910 100644
--- a/docs/fr/docs/alternatives.md
+++ b/docs/fr/docs/alternatives.md
@@ -43,7 +43,7 @@ Django REST framework a été créé par Tom Christie. Le créateur de Starlette
///
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Avoir une interface de documentation automatique de l'API.
@@ -65,7 +65,7 @@ qui est nécessaire, était une caractéristique clé que je voulais conserver.
Compte tenu de la simplicité de Flask, il semblait bien adapté à la création d'API. La prochaine chose à trouver était un "Django REST Framework" pour Flask.
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Être un micro-framework. Il est donc facile de combiner les outils et les pièces nécessaires.
@@ -107,7 +107,7 @@ def read_url():
Notez les similitudes entre `requests.get(...)` et `@app.get(...)`.
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Avoir une API simple et intuitive.
@@ -128,7 +128,7 @@ Swagger pour une API permettrait d'utiliser cette interface utilisateur web auto
C'est pourquoi, lorsqu'on parle de la version 2.0, il est courant de dire "Swagger", et pour la version 3+ "OpenAPI".
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Adopter et utiliser une norme ouverte pour les spécifications des API, au lieu d'un schéma personnalisé.
@@ -166,7 +166,7 @@ Ces fonctionnalités sont ce pourquoi Marshmallow a été construit. C'est une e
Mais elle a été créée avant que les type hints n'existent en Python. Ainsi, pour définir chaque <abbr title="la définition de
la façon dont les données doivent être formées">schéma</abbr>, vous devez utiliser des utilitaires et des classes spécifiques fournies par Marshmallow.
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Utilisez du code pour définir des "schémas" qui fournissent automatiquement les types de données et la validation.
@@ -189,7 +189,7 @@ Webargs a été créé par les développeurs de Marshmallow.
///
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Disposer d'une validation automatique des données des requêtes entrantes.
@@ -219,7 +219,7 @@ APISpec a été créé par les développeurs de Marshmallow.
///
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Supporter la norme ouverte pour les API, OpenAPI.
@@ -252,7 +252,7 @@ Flask-apispec a été créé par les développeurs de Marshmallow.
///
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Générer le schéma OpenAPI automatiquement, à partir du même code qui définit la sérialisation et la validation.
@@ -273,7 +273,7 @@ Mais comme les données TypeScript ne sont pas préservées après la compilatio
Il ne peut pas très bien gérer les modèles imbriqués. Ainsi, si le corps JSON de la requête est un objet JSON comportant des champs internes qui sont à leur tour des objets JSON imbriqués, il ne peut pas être correctement documenté et validé.
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Utiliser les types Python pour bénéficier d'un excellent support de l'éditeur.
@@ -285,7 +285,7 @@ Disposer d'un puissant système d'injection de dépendances. Trouver un moyen de
C'était l'un des premiers frameworks Python extrêmement rapides basés sur `asyncio`. Il a été conçu pour être très similaire à Flask.
-/// note | "Détails techniques"
+/// note | Détails techniques
Il utilisait <a href="https://github.com/MagicStack/uvloop" class="external-link" target="_blank">`uvloop`</a> au lieu du système par défaut de Python `asyncio`. C'est ce qui l'a rendu si rapide.
@@ -293,7 +293,7 @@ Il a clairement inspiré Uvicorn et Starlette, qui sont actuellement plus rapide
///
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Trouvez un moyen d'avoir une performance folle.
@@ -313,7 +313,7 @@ pas possible de déclarer des paramètres de requête et des corps avec des indi
Ainsi, la validation, la sérialisation et la documentation des données doivent être effectuées dans le code, et non pas automatiquement. Ou bien elles doivent être implémentées comme un framework au-dessus de Falcon, comme Hug. Cette même distinction se retrouve dans d'autres frameworks qui s'inspirent de la conception de Falcon, qui consiste à avoir un objet de requête et un objet de réponse comme paramètres.
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Trouver des moyens d'obtenir de bonnes performances.
@@ -343,7 +343,7 @@ d'utiliser des décorateurs qui peuvent être placés juste au-dessus de la fonc
méthode est plus proche de celle de Django que de celle de Flask (et Starlette). Il sépare dans le code des choses
qui sont relativement fortement couplées.
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Définir des validations supplémentaires pour les types de données utilisant la valeur "par défaut" des attributs du modèle. Ceci améliore le support de l'éditeur, et n'était pas disponible dans Pydantic auparavant.
@@ -372,7 +372,7 @@ Hug a été créé par Timothy Crosley, le créateur de <a href="https://github.
///
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Hug a inspiré certaines parties d'APIStar, et était l'un des outils que je trouvais les plus prometteurs, à côté d'APIStar.
@@ -419,7 +419,7 @@ APIStar a été créé par Tom Christie. Le même gars qui a créé :
///
-/// check | "A inspiré **FastAPI** à"
+/// check | A inspiré **FastAPI** à
Exister.
@@ -444,7 +444,7 @@ Cela le rend extrêmement intuitif.
Il est comparable à Marshmallow. Bien qu'il soit plus rapide que Marshmallow dans les benchmarks. Et comme il est
basé sur les mêmes type hints Python, le support de l'éditeur est grand.
-/// check | "**FastAPI** l'utilise pour"
+/// check | **FastAPI** l'utilise pour
Gérer toute la validation des données, leur sérialisation et la documentation automatique du modèle (basée sur le schéma JSON).
@@ -480,7 +480,7 @@ Mais il ne fournit pas de validation automatique des données, de sérialisation
C'est l'une des principales choses que **FastAPI** ajoute par-dessus, le tout basé sur les type hints Python (en utilisant Pydantic). Cela, plus le système d'injection de dépendances, les utilitaires de sécurité, la génération de schémas OpenAPI, etc.
-/// note | "Détails techniques"
+/// note | Détails techniques
ASGI est une nouvelle "norme" développée par les membres de l'équipe principale de Django. Il ne s'agit pas encore d'une "norme Python" (un PEP), bien qu'ils soient en train de le faire.
@@ -488,7 +488,7 @@ Néanmoins, il est déjà utilisé comme "standard" par plusieurs outils. Cela a
///
-/// check | "**FastAPI** l'utilise pour"
+/// check | **FastAPI** l'utilise pour
Gérer toutes les parties web de base. Ajouter des fonctionnalités par-dessus.
@@ -507,7 +507,7 @@ quelque chose qu'un framework comme Starlette (ou **FastAPI**) fournirait par-de
C'est le serveur recommandé pour Starlette et **FastAPI**.
-/// check | "**FastAPI** le recommande comme"
+/// check | **FastAPI** le recommande comme
Le serveur web principal pour exécuter les applications **FastAPI**.
diff --git a/docs/fr/docs/async.md b/docs/fr/docs/async.md
index 0f8f34e65..0ff5fa5d1 100644
--- a/docs/fr/docs/async.md
+++ b/docs/fr/docs/async.md
@@ -393,7 +393,7 @@ Tout ceci est donc ce qui donne sa force à **FastAPI** (à travers Starlette) e
## Détails très techniques
-/// warning | "Attention !"
+/// warning | Attention !
Vous pouvez probablement ignorer cela.
diff --git a/docs/fr/docs/deployment/docker.md b/docs/fr/docs/deployment/docker.md
index 0f3b64700..05b597a2d 100644
--- a/docs/fr/docs/deployment/docker.md
+++ b/docs/fr/docs/deployment/docker.md
@@ -17,7 +17,7 @@ Cette image est dotée d'un mécanisme d'"auto-tuning", de sorte qu'il vous suff
Mais vous pouvez toujours changer et mettre à jour toutes les configurations avec des variables d'environnement ou des fichiers de configuration.
-/// tip | "Astuce"
+/// tip | Astuce
Pour voir toutes les configurations et options, rendez-vous sur la page de l'image Docker : <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
diff --git a/docs/fr/docs/deployment/manually.md b/docs/fr/docs/deployment/manually.md
index 6a737fdef..7c29242a9 100644
--- a/docs/fr/docs/deployment/manually.md
+++ b/docs/fr/docs/deployment/manually.md
@@ -39,7 +39,7 @@ $ pip install "uvicorn[standard]"
</div>
-/// tip | "Astuce"
+/// tip | Astuce
En ajoutant `standard`, Uvicorn va installer et utiliser quelques dépendances supplémentaires recommandées.
diff --git a/docs/fr/docs/deployment/versions.md b/docs/fr/docs/deployment/versions.md
index 8ea79a172..9d84274e2 100644
--- a/docs/fr/docs/deployment/versions.md
+++ b/docs/fr/docs/deployment/versions.md
@@ -48,7 +48,7 @@ des changements non rétrocompatibles.
FastAPI suit également la convention que tout changement de version "PATCH" est pour des corrections de bogues et
des changements rétrocompatibles.
-/// tip | "Astuce"
+/// tip | Astuce
Le "PATCH" est le dernier chiffre, par exemple, dans `0.2.3`, la version PATCH est `3`.
@@ -62,7 +62,7 @@ fastapi>=0.45.0,<0.46.0
Les changements non rétrocompatibles et les nouvelles fonctionnalités sont ajoutés dans les versions "MINOR".
-/// tip | "Astuce"
+/// tip | Astuce
Le "MINOR" est le numéro au milieu, par exemple, dans `0.2.3`, la version MINOR est `2`.
diff --git a/docs/fr/docs/python-types.md b/docs/fr/docs/python-types.md
index 8a0f1f3f4..99ca90827 100644
--- a/docs/fr/docs/python-types.md
+++ b/docs/fr/docs/python-types.md
@@ -161,7 +161,7 @@ Les listes étant un type contenant des types internes, mettez ces derniers entr
{*../../docs_src/python_types/tutorial006.py hl[4] *}
-/// tip | "Astuce"
+/// tip | Astuce
Ces types internes entre crochets sont appelés des "paramètres de type".
diff --git a/docs/fr/docs/tutorial/body.md b/docs/fr/docs/tutorial/body.md
index c4d493a45..760b6d80a 100644
--- a/docs/fr/docs/tutorial/body.md
+++ b/docs/fr/docs/tutorial/body.md
@@ -107,7 +107,7 @@ Mais vous auriez le même support de l'éditeur avec <a href="https://www.jetbra
<img src="/img/tutorial/body/image05.png">
-/// tip | "Astuce"
+/// tip | Astuce
Si vous utilisez <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a> comme éditeur, vous pouvez utiliser le Plugin <a href="https://github.com/koxudaxi/pydantic-pycharm-plugin/" class="external-link" target="_blank">Pydantic PyCharm Plugin</a>.
diff --git a/docs/fr/docs/tutorial/first-steps.md b/docs/fr/docs/tutorial/first-steps.md
index b2fb5181c..758145362 100644
--- a/docs/fr/docs/tutorial/first-steps.md
+++ b/docs/fr/docs/tutorial/first-steps.md
@@ -136,7 +136,7 @@ Vous pourriez aussi l'utiliser pour générer du code automatiquement, pour les
`FastAPI` est une classe Python qui fournit toutes les fonctionnalités nécessaires au lancement de votre API.
-/// note | "Détails techniques"
+/// note | Détails techniques
`FastAPI` est une classe héritant directement de `Starlette`.
@@ -249,7 +249,7 @@ Le `@app.get("/")` dit à **FastAPI** que la fonction en dessous est chargée de
* le chemin `/`
* en utilisant une <abbr title="une méthode GET HTTP">opération <code>get</code></abbr>
-/// info | "`@décorateur` Info"
+/// info | `@décorateur` Info
Cette syntaxe `@something` en Python est appelée un "décorateur".
@@ -276,7 +276,7 @@ Tout comme celles les plus exotiques :
* `@app.patch()`
* `@app.trace()`
-/// tip | "Astuce"
+/// tip | Astuce
Vous êtes libres d'utiliser chaque opération (méthode HTTP) comme vous le désirez.
diff --git a/docs/fr/docs/tutorial/path-params-numeric-validations.md b/docs/fr/docs/tutorial/path-params-numeric-validations.md
index b3635fb86..3f3280e64 100644
--- a/docs/fr/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/fr/docs/tutorial/path-params-numeric-validations.md
@@ -148,7 +148,7 @@ Tous partagent les mêmes paramètres pour des validations supplémentaires et d
///
-/// note | "Détails techniques"
+/// note | Détails techniques
Lorsque vous importez `Query`, `Path` et d'autres de `fastapi`, ce sont en fait des fonctions.
diff --git a/docs/fr/docs/tutorial/path-params.md b/docs/fr/docs/tutorial/path-params.md
index 508529fae..71c96b18e 100644
--- a/docs/fr/docs/tutorial/path-params.md
+++ b/docs/fr/docs/tutorial/path-params.md
@@ -24,7 +24,7 @@ Vous pouvez déclarer le type d'un paramètre de chemin dans la fonction, en uti
Ici, `item_id` est déclaré comme `int`.
-/// check | "vérifier"
+/// check | vérifier
Ceci vous permettra d'obtenir des fonctionnalités de l'éditeur dans votre fonction, telles
que des vérifications d'erreur, de l'auto-complétion, etc.
@@ -39,7 +39,7 @@ Si vous exécutez cet exemple et allez sur <a href="http://127.0.0.1:8000/items/
{"item_id":3}
```
-/// check | "vérifier"
+/// check | vérifier
Comme vous l'avez remarqué, la valeur reçue par la fonction (et renvoyée ensuite) est `3`,
en tant qu'entier (`int`) Python, pas la chaîne de caractères (`string`) `"3"`.
@@ -74,7 +74,7 @@ La même erreur se produira si vous passez un nombre flottant (`float`) et non u
<a href="http://127.0.0.1:8000/items/4.2" class="external-link" target="_blank">http://127.0.0.1:8000/items/4.2</a>.
-/// check | "vérifier"
+/// check | vérifier
Donc, avec ces mêmes déclarations de type Python, **FastAPI** vous fournit de la validation de données.
@@ -151,7 +151,7 @@ Créez ensuite des attributs de classe avec des valeurs fixes, qui seront les va
///
-/// tip | "Astuce"
+/// tip | Astuce
Pour ceux qui se demandent, "AlexNet", "ResNet", et "LeNet" sont juste des noms de <abbr title="Techniquement, des architectures de modèles">modèles</abbr> de Machine Learning.
@@ -185,7 +185,7 @@ Vous pouvez obtenir la valeur réel d'un membre (une chaîne de caractères ici)
{* ../../docs_src/path_params/tutorial005.py hl[20] *}
-/// tip | "Astuce"
+/// tip | Astuce
Vous pouvez aussi accéder la valeur `"lenet"` avec `ModelName.lenet.value`.
@@ -238,7 +238,7 @@ Vous pouvez donc l'utilisez comme tel :
{* ../../docs_src/path_params/tutorial004.py hl[6] *}
-/// tip | "Astuce"
+/// tip | Astuce
Vous pourriez avoir besoin que le paramètre contienne `/home/johndoe/myfile.txt`, avec un slash au début (`/`).
diff --git a/docs/fr/docs/tutorial/query-params-str-validations.md b/docs/fr/docs/tutorial/query-params-str-validations.md
index a3cf76302..c54c0c717 100644
--- a/docs/fr/docs/tutorial/query-params-str-validations.md
+++ b/docs/fr/docs/tutorial/query-params-str-validations.md
@@ -106,7 +106,7 @@ Disons que vous déclarez le paramètre `q` comme ayant une longueur minimale de
{* ../../docs_src/query_params_str_validations/tutorial005.py hl[7] *}
-/// note | "Rappel"
+/// note | Rappel
Avoir une valeur par défaut rend le paramètre optionnel.
@@ -171,7 +171,7 @@ Donc la réponse de cette URL serait :
}
```
-/// tip | "Astuce"
+/// tip | Astuce
Pour déclarer un paramètre de requête de type `list`, comme dans l'exemple ci-dessus, il faut explicitement utiliser `Query`, sinon cela sera interprété comme faisant partie du corps de la requête.
diff --git a/docs/fr/docs/tutorial/query-params.md b/docs/fr/docs/tutorial/query-params.md
index 798f84fa3..b87c26c78 100644
--- a/docs/fr/docs/tutorial/query-params.md
+++ b/docs/fr/docs/tutorial/query-params.md
@@ -65,7 +65,7 @@ De la même façon, vous pouvez définir des paramètres de requête comme optio
Ici, le paramètre `q` sera optionnel, et aura `None` comme valeur par défaut.
-/// check | "Remarque"
+/// check | Remarque
On peut voir que **FastAPI** est capable de détecter que le paramètre de chemin `item_id` est un paramètre de chemin et que `q` n'en est pas un, c'est donc un paramètre de requête.
@@ -187,7 +187,7 @@ Ici, on a donc 3 paramètres de requête :
* `skip`, un `int` avec comme valeur par défaut `0`.
* `limit`, un `int` optionnel.
-/// tip | "Astuce"
+/// tip | Astuce
Vous pouvez utiliser les `Enum`s de la même façon qu'avec les [Paramètres de chemin](path-params.md#valeurs-predefinies){.internal-link target=_blank}.
diff --git a/docs/id/docs/tutorial/index.md b/docs/id/docs/tutorial/index.md
index f0dee3d73..c01ec9a89 100644
--- a/docs/id/docs/tutorial/index.md
+++ b/docs/id/docs/tutorial/index.md
@@ -52,7 +52,7 @@ $ pip install "fastapi[all]"
...yang juga termasuk `uvicorn`, yang dapat kamu gunakan sebagai server yang menjalankan kodemu.
-/// note | "Catatan"
+/// note | Catatan
Kamu juga dapat meng-installnya bagian demi bagian.
diff --git a/docs/ja/docs/advanced/additional-status-codes.md b/docs/ja/docs/advanced/additional-status-codes.md
index 904d539e7..fb3164328 100644
--- a/docs/ja/docs/advanced/additional-status-codes.md
+++ b/docs/ja/docs/advanced/additional-status-codes.md
@@ -18,7 +18,7 @@
{!../../docs_src/additional_status_codes/tutorial001.py!}
```
-/// warning | "注意"
+/// warning | 注意
上記の例のように `Response` を明示的に返す場合、それは直接返されます。
@@ -28,7 +28,7 @@
///
-/// note | "技術詳細"
+/// note | 技術詳細
`from starlette.responses import JSONResponse` を利用することもできます。
diff --git a/docs/ja/docs/advanced/custom-response.md b/docs/ja/docs/advanced/custom-response.md
index 88269700e..15edc11ad 100644
--- a/docs/ja/docs/advanced/custom-response.md
+++ b/docs/ja/docs/advanced/custom-response.md
@@ -12,7 +12,7 @@
そしてもし、`Response` が、`JSONResponse` や `UJSONResponse` の場合のようにJSONメディアタイプ (`application/json`) ならば、データは *path operationデコレータ* に宣言したPydantic `response_model` により自動的に変換 (もしくはフィルタ) されます。
-/// note | "備考"
+/// note | 備考
メディアタイプを指定せずにレスポンスクラスを利用すると、FastAPIは何もコンテンツがないことを期待します。そのため、生成されるOpenAPIドキュメントにレスポンスフォーマットが記載されません。
@@ -28,7 +28,7 @@
{!../../docs_src/custom_response/tutorial001b.py!}
```
-/// info | "情報"
+/// info | 情報
パラメータ `response_class` は、レスポンスの「メディアタイプ」を定義するために利用することもできます。
@@ -38,7 +38,7 @@
///
-/// tip | "豆知識"
+/// tip | 豆知識
`ORJSONResponse` は、現在はFastAPIのみで利用可能で、Starletteでは利用できません。
@@ -55,7 +55,7 @@
{!../../docs_src/custom_response/tutorial002.py!}
```
-/// info | "情報"
+/// info | 情報
パラメータ `response_class` は、レスポンスの「メディアタイプ」を定義するために利用されます。
@@ -75,13 +75,13 @@
{!../../docs_src/custom_response/tutorial003.py!}
```
-/// warning | "注意"
+/// warning | 注意
*path operation関数* から直接返される `Response` は、OpenAPIにドキュメントされず (例えば、 `Content-Type` がドキュメントされない) 、自動的な対話的ドキュメントからも閲覧できません。
///
-/// info | "情報"
+/// info | 情報
もちろん、実際の `Content-Type` ヘッダーやステータスコードなどは、返された `Response` オブジェクトに由来しています。
@@ -115,7 +115,7 @@
`Response` を使って他の何かを返せますし、カスタムのサブクラスも作れることを覚えておいてください。
-/// note | "技術詳細"
+/// note | 技術詳細
`from starlette.responses import HTMLResponse` も利用できます。
@@ -168,7 +168,7 @@ FastAPI (実際にはStarlette) は自動的にContent-Lengthヘッダーを含
<a href="https://github.com/ultrajson/ultrajson" class="external-link" target="_blank">`ujson`</a>を使った、代替のJSONレスポンスです。
-/// warning | "注意"
+/// warning | 注意
`ujson` は、いくつかのエッジケースの取り扱いについて、Pythonにビルトインされた実装よりも作りこまれていません。
@@ -178,7 +178,7 @@ FastAPI (実際にはStarlette) は自動的にContent-Lengthヘッダーを含
{!../../docs_src/custom_response/tutorial001.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
`ORJSONResponse` のほうが高速な代替かもしれません。
@@ -210,7 +210,7 @@ HTTPリダイレクトを返します。デフォルトでは307ステータス
{!../../docs_src/custom_response/tutorial008.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
ここでは `async` や `await` をサポートしていない標準の `open()` を使っているので、通常の `def` でpath operationを宣言していることに注意してください。
@@ -245,7 +245,7 @@ HTTPリダイレクトを返します。デフォルトでは307ステータス
{!../../docs_src/custom_response/tutorial010.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
前に見たように、 *path operation* の中で `response_class` をオーバーライドできます。
diff --git a/docs/ja/docs/advanced/index.md b/docs/ja/docs/advanced/index.md
index da3c2a2bf..22eaf6eb8 100644
--- a/docs/ja/docs/advanced/index.md
+++ b/docs/ja/docs/advanced/index.md
@@ -6,7 +6,7 @@
以降のセクションでは、チュートリアルでは説明しきれなかったオプションや設定、および機能について説明します。
-/// tip | "豆知識"
+/// tip | 豆知識
以降のセクションは、 **必ずしも"応用編"ではありません**。
diff --git a/docs/ja/docs/advanced/path-operation-advanced-configuration.md b/docs/ja/docs/advanced/path-operation-advanced-configuration.md
index 2dab4aec1..99428bcbe 100644
--- a/docs/ja/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/ja/docs/advanced/path-operation-advanced-configuration.md
@@ -2,7 +2,7 @@
## OpenAPI operationId
-/// warning | "注意"
+/// warning | 注意
あなたがOpenAPIの「エキスパート」でなければ、これは必要ないかもしれません。
@@ -26,13 +26,13 @@ APIの関数名を `operationId` として利用したい場合、すべてのAP
{!../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
`app.openapi()` を手動でコールする場合、その前に`operationId`を更新する必要があります。
///
-/// warning | "注意"
+/// warning | 注意
この方法をとる場合、各 *path operation関数* が一意な名前である必要があります。
diff --git a/docs/ja/docs/advanced/response-directly.md b/docs/ja/docs/advanced/response-directly.md
index 167d15589..dc66e238c 100644
--- a/docs/ja/docs/advanced/response-directly.md
+++ b/docs/ja/docs/advanced/response-directly.md
@@ -14,7 +14,7 @@
実際は、`Response` やそのサブクラスを返すことができます。
-/// tip | "豆知識"
+/// tip | 豆知識
`JSONResponse` それ自体は、 `Response` のサブクラスです。
@@ -38,7 +38,7 @@
{!../../docs_src/response_directly/tutorial001.py!}
```
-/// note | "技術詳細"
+/// note | 技術詳細
また、`from starlette.responses import JSONResponse` も利用できます。
diff --git a/docs/ja/docs/advanced/websockets.md b/docs/ja/docs/advanced/websockets.md
index f7bcb6af3..365ceca9d 100644
--- a/docs/ja/docs/advanced/websockets.md
+++ b/docs/ja/docs/advanced/websockets.md
@@ -50,7 +50,7 @@ $ pip install websockets
{!../../docs_src/websockets/tutorial001.py!}
```
-/// note | "技術詳細"
+/// note | 技術詳細
`from starlette.websockets import WebSocket` を使用しても構いません.
@@ -119,7 +119,7 @@ WebSocketエンドポイントでは、`fastapi` から以下をインポート
{!../../docs_src/websockets/tutorial002.py!}
```
-/// info | "情報"
+/// info | 情報
WebSocket で `HTTPException` を発生させることはあまり意味がありません。したがって、WebSocketの接続を直接閉じる方がよいでしょう。
@@ -150,7 +150,7 @@ $ uvicorn main:app --reload
* パスで使用される「Item ID」
* クエリパラメータとして使用される「Token」
-/// tip | "豆知識"
+/// tip | 豆知識
クエリ `token` は依存パッケージによって処理されることに注意してください。
@@ -180,7 +180,7 @@ WebSocket接続が閉じられると、 `await websocket.receive_text()` は例
Client #1596980209979 left the chat
```
-/// tip | "豆知識"
+/// tip | 豆知識
上記のアプリは、複数の WebSocket 接続に対してメッセージを処理し、ブロードキャストする方法を示すための最小限のシンプルな例です。
diff --git a/docs/ja/docs/alternatives.md b/docs/ja/docs/alternatives.md
index 343ae4ed8..8129a7002 100644
--- a/docs/ja/docs/alternatives.md
+++ b/docs/ja/docs/alternatives.md
@@ -30,13 +30,13 @@ Mozilla、Red Hat、Eventbrite など多くの企業で利用されています
これは**自動的なAPIドキュメント生成**の最初の例であり、これは**FastAPI**に向けた「調査」を触発した最初のアイデアの一つでした。
-/// note | "備考"
+/// note | 備考
Django REST Framework は Tom Christie によって作成されました。StarletteとUvicornの生みの親であり、**FastAPI**のベースとなっています。
///
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
自動でAPIドキュメントを生成するWebユーザーインターフェースを持っている点。
@@ -56,7 +56,7 @@ Flask は「マイクロフレームワーク」であり、データベース
Flaskのシンプルさを考えると、APIを構築するのに適しているように思えました。次に見つけるべきは、Flask 用の「Django REST Framework」でした。
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
マイクロフレームワークであること。ツールやパーツを目的に合うように簡単に組み合わせられる点。
@@ -98,7 +98,7 @@ def read_url():
`requests.get(...)` と`@app.get(...)` には類似点が見受けられます。
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
* シンプルで直感的なAPIを持っている点。
* HTTPメソッド名を直接利用し、単純で直感的である。
@@ -118,7 +118,7 @@ def read_url():
そのため、バージョン2.0では「Swagger」、バージョン3以上では「OpenAPI」と表記するのが一般的です。
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
独自のスキーマの代わりに、API仕様のオープンな標準を採用しました。
@@ -147,7 +147,7 @@ APIが必要とするもう一つの大きな機能はデータのバリデー
しかし、それはPythonの型ヒントが存在する前に作られたものです。そのため、すべての<abbr title="データがどのように形成されるべきかの定義">スキーマ</abbr>を定義するためには、Marshmallowが提供する特定のユーティリティやクラスを使用する必要があります。
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
コードで「スキーマ」を定義し、データの型やバリデーションを自動で提供する点。
@@ -163,13 +163,13 @@ WebargsはFlaskをはじめとするいくつかのフレームワークの上
素晴らしいツールで、私も**FastAPI**を持つ前はよく使っていました。
-/// info | "情報"
+/// info | 情報
Webargsは、Marshmallowと同じ開発者により作られました。
///
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
受信したデータに対する自動的なバリデーションを持っている点。
@@ -193,13 +193,13 @@ Flask, Starlette, Responderなどにおいてはそのように動作します
エディタでは、この問題を解決することはできません。また、パラメータやMarshmallowスキーマを変更したときに、YAMLのdocstringを変更するのを忘れてしまうと、生成されたスキーマが古くなってしまいます。
-/// info | "情報"
+/// info | 情報
APISpecは、Marshmallowと同じ開発者により作成されました。
///
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
OpenAPIという、APIについてのオープンな標準をサポートしている点。
@@ -225,13 +225,13 @@ Flask、Flask-apispec、Marshmallow、Webargsの組み合わせは、**FastAPI**
そして、これらのフルスタックジェネレーターは、[**FastAPI** Project Generators](project-generation.md){.internal-link target=_blank}の元となっていました。
-/// info | "情報"
+/// info | 情報
Flask-apispecはMarshmallowと同じ開発者により作成されました。
///
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
シリアライゼーションとバリデーションを定義したコードから、OpenAPIスキーマを自動的に生成する点。
@@ -251,7 +251,7 @@ Angular 2にインスピレーションを受けた、統合された依存性
入れ子になったモデルをうまく扱えません。そのため、リクエストのJSONボディが内部フィールドを持つJSONオブジェクトで、それが順番にネストされたJSONオブジェクトになっている場合、適切にドキュメント化やバリデーションをすることができません。
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
素晴らしいエディターの補助を得るために、Pythonの型ヒントを利用している点。
@@ -263,7 +263,7 @@ Angular 2にインスピレーションを受けた、統合された依存性
`asyncio`に基づいた、Pythonのフレームワークの中でも非常に高速なものの一つです。Flaskと非常に似た作りになっています。
-/// note | "技術詳細"
+/// note | 技術詳細
Pythonの`asyncio`ループの代わりに、`uvloop`が利用されています。それにより、非常に高速です。
@@ -271,7 +271,7 @@ Pythonの`asyncio`ループの代わりに、`uvloop`が利用されています
///
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
物凄い性能を出す方法を見つけた点。
@@ -289,7 +289,7 @@ Pythonのウェブフレームワーク標準規格 (WSGI) を使用していま
そのため、データのバリデーション、シリアライゼーション、ドキュメント化は、自動的にできずコードの中で行わなければなりません。あるいは、HugのようにFalconの上にフレームワークとして実装されなければなりません。このような分断は、パラメータとして1つのリクエストオブジェクトと1つのレスポンスオブジェクトを持つというFalconのデザインにインスピレーションを受けた他のフレームワークでも起こります。
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
素晴らしい性能を得るための方法を見つけた点。
@@ -315,7 +315,7 @@ Pydanticのようなデータのバリデーション、シリアライゼーシ
ルーティングは一つの場所で宣言され、他の場所で宣言された関数を使用します (エンドポイントを扱う関数のすぐ上に配置できるデコレータを使用するのではなく) 。これはFlask (やStarlette) よりも、Djangoに近いです。これは、比較的緊密に結合されているものをコードの中で分離しています。
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
モデルの属性の「デフォルト」値を使用したデータ型の追加バリデーションを定義します。これはエディタの補助を改善するもので、以前はPydanticでは利用できませんでした。
@@ -337,13 +337,13 @@ OpenAPIやJSON Schemaのような標準に基づいたものではありませ
以前のPythonの同期型Webフレームワーク標準 (WSGI) をベースにしているため、Websocketなどは扱えませんが、それでも高性能です。
-/// info | "情報"
+/// info | 情報
HugはTimothy Crosleyにより作成されました。彼は<a href="https://github.com/timothycrosley/isort" class="external-link" target="_blank">`isort`</a>など、Pythonのファイル内のインポートの並び替えを自動的におこうなう素晴らしいツールの開発者です。
///
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
HugはAPIStarに部分的なインスピレーションを与えており、私が発見した中ではAPIStarと同様に最も期待の持てるツールの一つでした。
@@ -377,7 +377,7 @@ Hugは、**FastAPI**がヘッダーやクッキーを設定するために関数
今ではAPIStarはOpenAPI仕様を検証するためのツールセットであり、ウェブフレームワークではありません。
-/// info | "情報"
+/// info | 情報
APIStarはTom Christieにより開発されました。以下の開発者でもあります:
@@ -387,7 +387,7 @@ APIStarはTom Christieにより開発されました。以下の開発者でも
///
-/// check | "**FastAPI**へ与えたインスピレーション"
+/// check | **FastAPI**へ与えたインスピレーション
存在そのもの。
@@ -411,7 +411,7 @@ Pydanticは、Pythonの型ヒントを元にデータのバリデーション、
Marshmallowに匹敵しますが、ベンチマークではMarshmallowよりも高速です。また、Pythonの型ヒントを元にしているので、エディタの補助が素晴らしいです。
-/// check | "**FastAPI**での使用用途"
+/// check | **FastAPI**での使用用途
データのバリデーション、データのシリアライゼーション、自動的なモデルの (JSON Schemaに基づいた) ドキュメント化の全てを扱えます。
@@ -447,7 +447,7 @@ Starletteは基本的なWebマイクロフレームワークの機能をすべ
これは **FastAPI** が追加する主な機能の一つで、すべての機能は Pythonの型ヒントに基づいています (Pydanticを使用しています) 。これに加えて、依存性注入の仕組み、セキュリティユーティリティ、OpenAPIスキーマ生成などがあります。
-/// note | "技術詳細"
+/// note | 技術詳細
ASGIはDjangoのコアチームメンバーにより開発された新しい「標準」です。まだ「Pythonの標準 (PEP) 」ではありませんが、現在そうなるように進めています。
@@ -455,7 +455,7 @@ ASGIはDjangoのコアチームメンバーにより開発された新しい「
///
-/// check | "**FastAPI**での使用用途"
+/// check | **FastAPI**での使用用途
webに関するコアな部分を全て扱います。その上に機能を追加します。
@@ -473,7 +473,7 @@ Uvicornは非常に高速なASGIサーバーで、uvloopとhttptoolsにより構
Starletteや**FastAPI**のサーバーとして推奨されています。
-/// check | "**FastAPI**が推奨する理由"
+/// check | **FastAPI**が推奨する理由
**FastAPI**アプリケーションを実行するメインのウェブサーバーである点。
diff --git a/docs/ja/docs/async.md b/docs/ja/docs/async.md
index ce9dac56f..d1da1f82d 100644
--- a/docs/ja/docs/async.md
+++ b/docs/ja/docs/async.md
@@ -21,7 +21,7 @@ async def read_results():
return results
```
-/// note | "備考"
+/// note | 備考
`async def` を使用して作成された関数の内部でしか `await` は使用できません。
@@ -358,7 +358,7 @@ async def read_burgers():
## 非常に発展的な技術的詳細
-/// warning | "注意"
+/// warning | 注意
恐らくスキップしても良いでしょう。
diff --git a/docs/ja/docs/contributing.md b/docs/ja/docs/contributing.md
index 86926b213..3ee742ec2 100644
--- a/docs/ja/docs/contributing.md
+++ b/docs/ja/docs/contributing.md
@@ -95,7 +95,7 @@ some/directory/fastapi/env/bin/pip
`env/bin/pip`に`pip`バイナリが表示される場合は、正常に機能しています。🎉
-/// tip | "豆知識"
+/// tip | 豆知識
この環境で`pip`を使って新しいパッケージをインストールするたびに、仮想環境を再度有効化します。
@@ -165,7 +165,7 @@ $ bash scripts/format-imports.sh
そして、翻訳を処理するためのツール/スクリプトが、`./scripts/docs.py`に用意されています。
-/// tip | "豆知識"
+/// tip | 豆知識
`./scripts/docs.py`のコードを見る必要はなく、コマンドラインからただ使うだけです。
@@ -254,7 +254,7 @@ Uvicornはデフォルトでポート`8000`を使用するため、ポート`800
* あなたの言語の<a href="https://github.com/fastapi/fastapi/pulls" class="external-link" target="_blank">今あるプルリクエスト</a>を確認し、変更や承認をするレビューを追加します。
-/// tip | "豆知識"
+/// tip | 豆知識
すでにあるプルリクエストに<a href="https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request" class="external-link" target="_blank">修正提案つきのコメントを追加</a>できます。
@@ -282,7 +282,7 @@ Uvicornはデフォルトでポート`8000`を使用するため、ポート`800
スペイン語の場合、2文字のコードは`es`です。したがって、スペイン語のディレクトリは`docs/es/`です。
-/// tip | "豆知識"
+/// tip | 豆知識
メイン (「公式」) 言語は英語で、`docs/en/`にあります。
@@ -323,7 +323,7 @@ docs/en/docs/features.md
docs/es/docs/features.md
```
-/// tip | "豆知識"
+/// tip | 豆知識
パスとファイル名の変更は、`en`から`es`への言語コードだけであることに注意してください。
@@ -398,7 +398,7 @@ Updating en
これで、新しく作成された`docs/ht/`ディレクトリをコードエディターから確認できます。
-/// tip | "豆知識"
+/// tip | 豆知識
翻訳を追加する前に、これだけで最初のプルリクエストを作成し、新しい言語の設定をセットアップします。
diff --git a/docs/ja/docs/deployment/manually.md b/docs/ja/docs/deployment/manually.md
index c17e63728..4ea6bd8ff 100644
--- a/docs/ja/docs/deployment/manually.md
+++ b/docs/ja/docs/deployment/manually.md
@@ -20,7 +20,7 @@ $ pip install "uvicorn[standard]"
////
-/// tip | "豆知識"
+/// tip | 豆知識
`standard` を加えることで、Uvicornがインストールされ、いくつかの推奨される依存関係を利用するようになります。
diff --git a/docs/ja/docs/deployment/versions.md b/docs/ja/docs/deployment/versions.md
index 941ddb71b..7575fc4f7 100644
--- a/docs/ja/docs/deployment/versions.md
+++ b/docs/ja/docs/deployment/versions.md
@@ -42,7 +42,7 @@ PoetryやPipenvなど、他のインストール管理ツールを使用して
FastAPIでは「パッチ」バージョンはバグ修正と非破壊的な変更に留めるという規約に従っています。
-/// tip | "豆知識"
+/// tip | 豆知識
「パッチ」は最後の数字を指します。例えば、`0.2.3` ではパッチバージョンは `3` です。
@@ -56,7 +56,7 @@ fastapi>=0.45.0,<0.46.0
破壊的な変更と新機能実装は「マイナー」バージョンで加えられます。
-/// tip | "豆知識"
+/// tip | 豆知識
「マイナー」は真ん中の数字です。例えば、`0.2.3` ではマイナーバージョンは `2` です。
diff --git a/docs/ja/docs/features.md b/docs/ja/docs/features.md
index 73c0192c7..4024590cf 100644
--- a/docs/ja/docs/features.md
+++ b/docs/ja/docs/features.md
@@ -62,7 +62,7 @@ second_user_data = {
my_second_user: User = User(**second_user_data)
```
-/// info | "情報"
+/// info | 情報
`**second_user_data` は以下を意味します：
diff --git a/docs/ja/docs/python-types.md b/docs/ja/docs/python-types.md
index 7af6ce0c0..77ddf4654 100644
--- a/docs/ja/docs/python-types.md
+++ b/docs/ja/docs/python-types.md
@@ -12,7 +12,7 @@
しかしたとえまったく **FastAPI** を使用しない場合でも、それらについて少し学ぶことで利点を得ることができるでしょう。
-/// note | "備考"
+/// note | 備考
もしあなたがPythonの専門家で、すでに型ヒントについてすべて知っているのであれば、次の章まで読み飛ばしてください。
@@ -175,7 +175,7 @@ John Doe
{!../../docs_src/python_types/tutorial006.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
角括弧内の内部の型は「型パラメータ」と呼ばれています。
@@ -288,7 +288,7 @@ Pydanticの公式ドキュメントから引用:
{!../../docs_src/python_types/tutorial011.py!}
```
-/// info | "情報"
+/// info | 情報
Pydanticについてより学びたい方は<a href="https://docs.pydantic.dev/" class="external-link" target="_blank">ドキュメントを参照してください</a>.
@@ -320,7 +320,7 @@ Pydanticについてより学びたい方は<a href="https://docs.pydantic.dev/"
重要なのは、Pythonの標準的な型を使うことで、（クラスやデコレータなどを追加するのではなく）１つの場所で **FastAPI** が多くの作業を代わりにやってくれているということです。
-/// info | "情報"
+/// info | 情報
すでにすべてのチュートリアルを終えて、型についての詳細を見るためにこのページに戻ってきた場合は、<a href="https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html" class="external-link" target="_blank">`mypy`のチートシートを参照してください</a>
diff --git a/docs/ja/docs/tutorial/body-fields.md b/docs/ja/docs/tutorial/body-fields.md
index 1d386040a..5b3b3622b 100644
--- a/docs/ja/docs/tutorial/body-fields.md
+++ b/docs/ja/docs/tutorial/body-fields.md
@@ -10,7 +10,7 @@
{!../../docs_src/body_fields/tutorial001.py!}
```
-/// warning | "注意"
+/// warning | 注意
`Field`は他の全てのもの（`Query`、`Path`、`Body`など）とは違い、`fastapi`からではなく、`pydantic`から直接インポートされていることに注意してください。
@@ -26,7 +26,7 @@
`Field`は`Query`や`Path`、`Body`と同じように動作し、全く同様のパラメータなどを持ちます。
-/// note | "技術詳細"
+/// note | 技術詳細
実際には次に見る`Query`や`Path`などは、共通の`Param`クラスのサブクラスのオブジェクトを作成しますが、それ自体はPydanticの`FieldInfo`クラスのサブクラスです。
@@ -38,7 +38,7 @@
///
-/// tip | "豆知識"
+/// tip | 豆知識
型、デフォルト値、`Field`を持つ各モデルの属性が、`Path`や`Query`、`Body`の代わりに`Field`を持つ、*path operation 関数の*パラメータと同じ構造になっていることに注目してください。
diff --git a/docs/ja/docs/tutorial/body-multiple-params.md b/docs/ja/docs/tutorial/body-multiple-params.md
index 647143ee5..982c23565 100644
--- a/docs/ja/docs/tutorial/body-multiple-params.md
+++ b/docs/ja/docs/tutorial/body-multiple-params.md
@@ -12,7 +12,7 @@
{!../../docs_src/body_multiple_params/tutorial001.py!}
```
-/// note | "備考"
+/// note | 備考
この場合、ボディから取得する`item`はオプションであることに注意してください。デフォルト値は`None`です。
@@ -56,7 +56,7 @@
}
```
-/// note | "備考"
+/// note | 備考
以前と同じように`item`が宣言されていたにもかかわらず、`item`はキー`item`を持つボディの内部にあることが期待されていることに注意してください。
@@ -118,7 +118,7 @@ q: str = None
{!../../docs_src/body_multiple_params/tutorial004.py!}
```
-/// info | "情報"
+/// info | 情報
`Body`もまた、後述する `Query` や `Path` などと同様に、すべての検証パラメータとメタデータパラメータを持っています。
diff --git a/docs/ja/docs/tutorial/body-nested-models.md b/docs/ja/docs/tutorial/body-nested-models.md
index 8703a40e7..dc2d5e81a 100644
--- a/docs/ja/docs/tutorial/body-nested-models.md
+++ b/docs/ja/docs/tutorial/body-nested-models.md
@@ -162,7 +162,7 @@ Pydanticモデルを`list`や`set`などのサブタイプとして使用する
}
```
-/// info | "情報"
+/// info | 情報
`images`キーが画像オブジェクトのリストを持つようになったことに注目してください。
@@ -176,7 +176,7 @@ Pydanticモデルを`list`や`set`などのサブタイプとして使用する
{!../../docs_src/body_nested_models/tutorial007.py!}
```
-/// info | "情報"
+/// info | 情報
`Offer`は`Item`のリストであり、オプションの`Image`のリストを持っていることに注目してください。
@@ -228,7 +228,7 @@ Pydanticモデルではなく、`dict`を直接使用している場合はこの
{!../../docs_src/body_nested_models/tutorial009.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
JSONはキーとして`str`しかサポートしていないことに注意してください。
diff --git a/docs/ja/docs/tutorial/body-updates.md b/docs/ja/docs/tutorial/body-updates.md
index fde9f4f5e..fcaeb0d16 100644
--- a/docs/ja/docs/tutorial/body-updates.md
+++ b/docs/ja/docs/tutorial/body-updates.md
@@ -34,7 +34,7 @@
つまり、更新したいデータだけを送信して、残りはそのままにしておくことができます。
-/// note | "備考"
+/// note | 備考
`PATCH`は`PUT`よりもあまり使われておらず、知られていません。
@@ -89,7 +89,7 @@
{!../../docs_src/body_updates/tutorial002.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
実際には、HTTPの`PUT`操作でも同じテクニックを使用することができます。
@@ -97,7 +97,7 @@
///
-/// note | "備考"
+/// note | 備考
入力モデルがまだ検証されていることに注目してください。
diff --git a/docs/ja/docs/tutorial/body.md b/docs/ja/docs/tutorial/body.md
index 888d4388a..277ee79c8 100644
--- a/docs/ja/docs/tutorial/body.md
+++ b/docs/ja/docs/tutorial/body.md
@@ -8,7 +8,7 @@ APIはほとんどの場合 **レスポンス** ボディを送らなければ
**リクエスト** ボディを宣言するために <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic</a> モデルを使用します。そして、その全てのパワーとメリットを利用します。
-/// info | "情報"
+/// info | 情報
データを送るには、`POST` (もっともよく使われる)、`PUT`、`DELETE` または `PATCH` を使うべきです。
@@ -113,7 +113,7 @@ GET リクエストでボディを送信することは、仕様では未定義
<img src="/img/tutorial/body/image05.png">
-/// tip | "豆知識"
+/// tip | 豆知識
<a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a>エディタを使用している場合は、<a href="https://github.com/koxudaxi/pydantic-pycharm-plugin/" class="external-link" target="_blank">Pydantic PyCharm Plugin</a>が使用可能です。
@@ -161,7 +161,7 @@ GET リクエストでボディを送信することは、仕様では未定義
* パラメータが**単数型** (`int`、`float`、`str`、`bool` など)の場合は**クエリ**パラメータとして解釈されます。
* パラメータが **Pydantic モデル**型で宣言された場合、リクエスト**ボディ**として解釈されます。
-/// note | "備考"
+/// note | 備考
FastAPIは、`= None`があるおかげで、`q`がオプショナルだとわかります。
diff --git a/docs/ja/docs/tutorial/cookie-params.md b/docs/ja/docs/tutorial/cookie-params.md
index 1f45db17c..7f029b483 100644
--- a/docs/ja/docs/tutorial/cookie-params.md
+++ b/docs/ja/docs/tutorial/cookie-params.md
@@ -20,7 +20,7 @@
{!../../docs_src/cookie_params/tutorial001.py!}
```
-/// note | "技術詳細"
+/// note | 技術詳細
`Cookie`は`Path`と`Query`の「姉妹」クラスです。また、同じ共通の`Param`クラスを継承しています。
@@ -28,7 +28,7 @@
///
-/// info | "情報"
+/// info | 情報
クッキーを宣言するには、`Cookie`を使う必要があります。なぜなら、そうしないとパラメータがクエリのパラメータとして解釈されてしまうからです。
diff --git a/docs/ja/docs/tutorial/cors.md b/docs/ja/docs/tutorial/cors.md
index 9530c51bf..9834a460b 100644
--- a/docs/ja/docs/tutorial/cors.md
+++ b/docs/ja/docs/tutorial/cors.md
@@ -78,7 +78,7 @@
<abbr title="Cross-Origin Resource Sharing (オリジン間リソース共有)">CORS</abbr>についてより詳しい情報は、<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS" class="external-link" target="_blank">Mozilla CORS documentation</a> を参照して下さい。
-/// note | "技術詳細"
+/// note | 技術詳細
`from starlette.middleware.cors import CORSMiddleware` も使用できます。
diff --git a/docs/ja/docs/tutorial/debugging.md b/docs/ja/docs/tutorial/debugging.md
index be0ff81d4..7413332a8 100644
--- a/docs/ja/docs/tutorial/debugging.md
+++ b/docs/ja/docs/tutorial/debugging.md
@@ -74,7 +74,7 @@ from myapp import app
は実行されません。
-/// info | "情報"
+/// info | 情報
より詳しい情報は、<a href="https://docs.python.org/3/library/__main__.html" class="external-link" target="_blank">公式Pythonドキュメント</a>を参照してください。
diff --git a/docs/ja/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/ja/docs/tutorial/dependencies/classes-as-dependencies.md
index fb23a7b2b..55885a61f 100644
--- a/docs/ja/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/ja/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -185,7 +185,7 @@ commons: CommonQueryParams = Depends()
...そして **FastAPI** は何をすべきか知っています。
-/// tip | "豆知識"
+/// tip | 豆知識
役に立つというよりも、混乱するようであれば無視してください。それをする*必要*はありません。
diff --git a/docs/ja/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/ja/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index 59f21c3df..3b78f4e0b 100644
--- a/docs/ja/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/ja/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -20,7 +20,7 @@
これらの依存関係は、通常の依存関係と同様に実行・解決されます。しかし、それらの値（何かを返す場合）は*path operation関数*には渡されません。
-/// tip | "豆知識"
+/// tip | 豆知識
エディタによっては、未使用の関数パラメータをチェックしてエラーとして表示するものもあります。
diff --git a/docs/ja/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/ja/docs/tutorial/dependencies/dependencies-with-yield.md
index 7ef1caf0d..bd4e689bf 100644
--- a/docs/ja/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/ja/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -4,13 +4,13 @@ FastAPIは、いくつかの<abbr title='時々"exit"、"cleanup"、"teardown"
これを行うには、`return`の代わりに`yield`を使い、その後に追加のステップを書きます。
-/// tip | "豆知識"
+/// tip | 豆知識
`yield`は必ず一度だけ使用するようにしてください。
///
-/// info | "情報"
+/// info | 情報
これを動作させるには、**Python 3.7** 以上を使用するか、**Python 3.6** では"backports"をインストールする必要があります:
@@ -22,7 +22,7 @@ pip install async-exit-stack async-generator
///
-/// note | "技術詳細"
+/// note | 技術詳細
以下と一緒に使用できる関数なら何でも有効です:
@@ -57,7 +57,7 @@ pip install async-exit-stack async-generator
{!../../docs_src/dependencies/tutorial007.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
`async`や通常の関数を使用することができます。
@@ -109,7 +109,7 @@ pip install async-exit-stack async-generator
**FastAPI** は、全てが正しい順序で実行されていることを確認します。
-/// note | "技術詳細"
+/// note | 技術詳細
これはPythonの<a href="https://docs.python.org/3/library/contextlib.html" class="external-link" target="_blank">Context Managers</a>のおかげで動作します。
@@ -137,7 +137,7 @@ pip install async-exit-stack async-generator
レスポンスを返したり、レスポンスを変更したり、`HTTPException`を発生させたりする*前に*処理したいカスタム例外がある場合は、[カスタム例外ハンドラ](../handling-errors.md#_4){.internal-link target=_blank}を作成してください。
-/// tip | "豆知識"
+/// tip | 豆知識
`HTTPException`を含む例外は、`yield`の*前*でも発生させることができます。ただし、後ではできません。
@@ -183,7 +183,7 @@ participant tasks as Background tasks
end
```
-/// info | "情報"
+/// info | 情報
**１つのレスポンス** だけがクライアントに送信されます。それはエラーレスポンスの一つかもしれませんし、*path operation*からのレスポンスかもしれません。
@@ -191,7 +191,7 @@ participant tasks as Background tasks
///
-/// tip | "豆知識"
+/// tip | 豆知識
この図は`HTTPException`を示していますが、[カスタム例外ハンドラ](../handling-errors.md#_4){.internal-link target=_blank}を作成することで、他の例外を発生させることもできます。そして、その例外は依存関係の終了コードではなく、そのカスタム例外ハンドラによって処理されます。
@@ -221,7 +221,7 @@ with open("./somefile.txt") as f:
### `yield`を持つ依存関係でのコンテキストマネージャの使用
-/// warning | "注意"
+/// warning | 注意
これは多かれ少なかれ、「高度な」発想です。
@@ -237,7 +237,7 @@ Pythonでは、<a href="https://docs.python.org/3/reference/datamodel.html#conte
{!../../docs_src/dependencies/tutorial010.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
コンテキストマネージャを作成するもう一つの方法はwithです:
diff --git a/docs/ja/docs/tutorial/dependencies/index.md b/docs/ja/docs/tutorial/dependencies/index.md
index f6728ee84..8965b602f 100644
--- a/docs/ja/docs/tutorial/dependencies/index.md
+++ b/docs/ja/docs/tutorial/dependencies/index.md
@@ -75,7 +75,7 @@
そして、その関数は、*path operation関数*が行うのと同じ方法でパラメータを取ります。
-/// tip | "豆知識"
+/// tip | 豆知識
次の章では、関数以外の「もの」が依存関係として使用できるものを見ていきます。
@@ -100,7 +100,7 @@ common_parameters --> read_users
この方法では、共有されるコードを一度書き、**FastAPI** が*path operations*のための呼び出しを行います。
-/// check | "確認"
+/// check | 確認
特別なクラスを作成してどこかで **FastAPI** に渡して「登録」する必要はないことに注意してください。
@@ -118,7 +118,7 @@ common_parameters --> read_users
それは重要ではありません。**FastAPI** は何をすべきかを知っています。
-/// note | "備考"
+/// note | 備考
わからない場合は、ドキュメントの[Async: *"In a hurry?"*](../../async.md){.internal-link target=_blank}の中の`async`と`await`についてのセクションを確認してください。
diff --git a/docs/ja/docs/tutorial/dependencies/sub-dependencies.md b/docs/ja/docs/tutorial/dependencies/sub-dependencies.md
index 754ec028e..11b5ff004 100644
--- a/docs/ja/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/ja/docs/tutorial/dependencies/sub-dependencies.md
@@ -41,7 +41,7 @@
{!../../docs_src/dependencies/tutorial005.py!}
```
-/// info | "情報"
+/// info | 情報
*path operation関数*の中で宣言している依存関係は`query_or_cookie_extractor`の１つだけであることに注意してください。
@@ -81,7 +81,7 @@ async def needy_dependency(fresh_value: str = Depends(get_value, use_cache=False
しかし、それでも非常に強力で、任意の深くネストされた依存関係「グラフ」（ツリー）を宣言することができます。
-/// tip | "豆知識"
+/// tip | 豆知識
これらの単純な例では、全てが役に立つとは言えないかもしれません。
diff --git a/docs/ja/docs/tutorial/encoder.md b/docs/ja/docs/tutorial/encoder.md
index ea522f91f..3ce7e604e 100644
--- a/docs/ja/docs/tutorial/encoder.md
+++ b/docs/ja/docs/tutorial/encoder.md
@@ -30,7 +30,7 @@ Pydanticモデルのようなオブジェクトを受け取り、JSON互換版
これはJSON形式のデータを含む大きな`str`を（文字列として）返しません。JSONと互換性のある値とサブの値を持つPython標準のデータ構造（例：`dict`）を返します。
-/// note | "備考"
+/// note | 備考
`jsonable_encoder`は実際には **FastAPI** が内部的にデータを変換するために使用します。しかしこれは他の多くのシナリオで有用です。
diff --git a/docs/ja/docs/tutorial/extra-models.md b/docs/ja/docs/tutorial/extra-models.md
index f739e81b4..5ff5db47d 100644
--- a/docs/ja/docs/tutorial/extra-models.md
+++ b/docs/ja/docs/tutorial/extra-models.md
@@ -8,7 +8,7 @@
* **出力モデル**はパスワードをもつべきではありません。
* **データベースモデル**はおそらくハッシュ化されたパスワードが必要になるでしょう。
-/// danger | "危険"
+/// danger | 危険
ユーザーの平文のパスワードは絶対に保存しないでください。常に認証に利用可能な「安全なハッシュ」を保存してください。
@@ -134,7 +134,7 @@ UserInDB(
)
```
-/// warning | "注意"
+/// warning | 注意
サポートしている追加機能は、データの可能な流れをデモするだけであり、もちろん本当のセキュリティを提供しているわけではありません。
diff --git a/docs/ja/docs/tutorial/first-steps.md b/docs/ja/docs/tutorial/first-steps.md
index 77f3b5fbe..3691d13d2 100644
--- a/docs/ja/docs/tutorial/first-steps.md
+++ b/docs/ja/docs/tutorial/first-steps.md
@@ -24,7 +24,7 @@ $ uvicorn main:app --reload
</div>
-/// note | "備考"
+/// note | 備考
`uvicorn main:app`は以下を示します:
@@ -139,7 +139,7 @@ OpenAPIスキーマは、FastAPIに含まれている2つのインタラクテ
`FastAPI`は、APIのすべての機能を提供するPythonクラスです。
-/// note | "技術詳細"
+/// note | 技術詳細
`FastAPI`は`Starlette`を直接継承するクラスです。
@@ -204,7 +204,7 @@ https://example.com/items/foo
/items/foo
```
-/// info | "情報"
+/// info | 情報
「パス」は一般に「エンドポイント」または「ルート」とも呼ばれます。
@@ -257,7 +257,7 @@ APIを構築するときは、通常、これらの特定のHTTPメソッドを
* パス `/`
* <abbr title="an HTTP GET method"><code>get</code> オペレーション</abbr>
-/// info | "`@decorator` について"
+/// info | `@decorator` について
Pythonにおける`@something`シンタックスはデコレータと呼ばれます。
@@ -284,7 +284,7 @@ Pythonにおける`@something`シンタックスはデコレータと呼ばれ
* `@app.patch()`
* `@app.trace()`
-/// tip | "豆知識"
+/// tip | 豆知識
各オペレーション (HTTPメソッド)は自由に使用できます。
@@ -322,7 +322,7 @@ Pythonにおける`@something`シンタックスはデコレータと呼ばれ
{!../../docs_src/first_steps/tutorial003.py!}
```
-/// note | "備考"
+/// note | 備考
違いが分からない場合は、[Async: *"急いでいますか？"*](../async.md#_1){.internal-link target=_blank}を確認してください。
diff --git a/docs/ja/docs/tutorial/handling-errors.md b/docs/ja/docs/tutorial/handling-errors.md
index e94f16b21..d270fd75b 100644
--- a/docs/ja/docs/tutorial/handling-errors.md
+++ b/docs/ja/docs/tutorial/handling-errors.md
@@ -63,7 +63,7 @@ Pythonの例外なので、`return`ではなく、`raise`です。
}
```
-/// tip | "豆知識"
+/// tip | 豆知識
`HTTPException`を発生させる際には、`str`だけでなく、JSONに変換できる任意の値を`detail`パラメータとして渡すことができます。
@@ -109,7 +109,7 @@ Pythonの例外なので、`return`ではなく、`raise`です。
{"message": "Oops! yolo did something. There goes a rainbow..."}
```
-/// note | "技術詳細"
+/// note | 技術詳細
また、`from starlette.requests import Request`と`from starlette.responses import JSONResponse`を使用することもできます。
@@ -166,7 +166,7 @@ path -> item_id
#### `RequestValidationError`と`ValidationError`
-/// warning | "注意"
+/// warning | 注意
これらは今のあなたにとって重要でない場合は省略しても良い技術的な詳細です。
@@ -192,7 +192,7 @@ path -> item_id
{!../../docs_src/handling_errors/tutorial004.py!}
```
-/// note | "技術詳細"
+/// note | 技術詳細
また、`from starlette.responses import PlainTextResponse`を使用することもできます。
diff --git a/docs/ja/docs/tutorial/header-params.md b/docs/ja/docs/tutorial/header-params.md
index 3180b78b5..c741005d3 100644
--- a/docs/ja/docs/tutorial/header-params.md
+++ b/docs/ja/docs/tutorial/header-params.md
@@ -20,7 +20,7 @@
{!../../docs_src/header_params/tutorial001.py!}
```
-/// note | "技術詳細"
+/// note | 技術詳細
`Header`は`Path`や`Query`、`Cookie`の「姉妹」クラスです。また、同じ共通の`Param`クラスを継承しています。
@@ -28,7 +28,7 @@
///
-/// info | "情報"
+/// info | 情報
ヘッダーを宣言するには、`Header`を使う必要があります。なぜなら、そうしないと、パラメータがクエリのパラメータとして解釈されてしまうからです。
@@ -54,7 +54,7 @@
{!../../docs_src/header_params/tutorial002.py!}
```
-/// warning | "注意"
+/// warning | 注意
`convert_underscores`を`False`に設定する前に、HTTPプロキシやサーバの中にはアンダースコアを含むヘッダーの使用を許可していないものがあることに注意してください。
diff --git a/docs/ja/docs/tutorial/index.md b/docs/ja/docs/tutorial/index.md
index c5fe27259..87d3751fd 100644
--- a/docs/ja/docs/tutorial/index.md
+++ b/docs/ja/docs/tutorial/index.md
@@ -52,7 +52,7 @@ $ pip install "fastapi[all]"
...これには、コードを実行するサーバーとして使用できる `uvicorn`も含まれます。
-/// note | "備考"
+/// note | 備考
パーツ毎にインストールすることも可能です。
diff --git a/docs/ja/docs/tutorial/metadata.md b/docs/ja/docs/tutorial/metadata.md
index 8285b479e..201322cb4 100644
--- a/docs/ja/docs/tutorial/metadata.md
+++ b/docs/ja/docs/tutorial/metadata.md
@@ -47,7 +47,7 @@
説明文 (description) の中で Markdown を使用できることに注意してください。たとえば、「login」は太字 (**login**) で表示され、「fancy」は斜体 (_fancy_) で表示されます。
-/// tip | "豆知識"
+/// tip | 豆知識
使用するすべてのタグにメタデータを追加する必要はありません。
@@ -61,7 +61,7 @@
{!../../docs_src/metadata/tutorial004.py!}
```
-/// info | "情報"
+/// info | 情報
タグのより詳しい説明を知りたい場合は [Path Operation Configuration](path-operation-configuration.md#tags){.internal-link target=_blank} を参照して下さい。
diff --git a/docs/ja/docs/tutorial/middleware.md b/docs/ja/docs/tutorial/middleware.md
index f4a503720..3a3d8bb22 100644
--- a/docs/ja/docs/tutorial/middleware.md
+++ b/docs/ja/docs/tutorial/middleware.md
@@ -11,7 +11,7 @@
* その**レスポンス**に対して何かを実行したり、必要なコードを実行したりできます。
* そして、**レスポンス**を返します。
-/// note | "技術詳細"
+/// note | 技術詳細
`yield` を使った依存関係をもつ場合は、終了コードはミドルウェアの *後に* 実行されます。
@@ -35,7 +35,7 @@
{!../../docs_src/middleware/tutorial001.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers" class="external-link" target="_blank">'X-'プレフィックスを使用</a>してカスタムの独自ヘッダーを追加できます。
@@ -43,7 +43,7 @@
///
-/// note | "技術詳細"
+/// note | 技術詳細
`from starlette.requests import Request` を使用することもできます。
diff --git a/docs/ja/docs/tutorial/path-operation-configuration.md b/docs/ja/docs/tutorial/path-operation-configuration.md
index 7eceb377d..36223d35d 100644
--- a/docs/ja/docs/tutorial/path-operation-configuration.md
+++ b/docs/ja/docs/tutorial/path-operation-configuration.md
@@ -2,7 +2,7 @@
*path operationデコレータ*を設定するためのパラメータがいくつかあります。
-/// warning | "注意"
+/// warning | 注意
これらのパラメータは*path operation関数*ではなく、*path operationデコレータ*に直接渡されることに注意してください。
@@ -22,7 +22,7 @@
そのステータスコードはレスポンスで使用され、OpenAPIスキーマに追加されます。
-/// note | "技術詳細"
+/// note | 技術詳細
また、`from starlette import status`を使用することもできます。
@@ -72,13 +72,13 @@ docstringに<a href="https://en.wikipedia.org/wiki/Markdown" class="external-lin
{!../../docs_src/path_operation_configuration/tutorial005.py!}
```
-/// info | "情報"
+/// info | 情報
`respnse_description`は具体的にレスポンスを参照し、`description`は*path operation*全般を参照していることに注意してください。
///
-/// check | "確認"
+/// check | 確認
OpenAPIは*path operation*ごとにレスポンスの説明を必要としています。
diff --git a/docs/ja/docs/tutorial/path-params-numeric-validations.md b/docs/ja/docs/tutorial/path-params-numeric-validations.md
index 42fbb2ee2..7d55ad30c 100644
--- a/docs/ja/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/ja/docs/tutorial/path-params-numeric-validations.md
@@ -20,7 +20,7 @@
{!../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
-/// note | "備考"
+/// note | 備考
パスの一部でなければならないので、パスパラメータは常に必須です。
@@ -108,7 +108,7 @@ Pythonはその`*`で何かをすることはありませんが、それ以降
* `lt`: より小さい（`l`ess `t`han）
* `le`: 以下（`l`ess than or `e`qual）
-/// info | "情報"
+/// info | 情報
`Query`、`Path`などは後に共通の`Param`クラスのサブクラスを見ることになります。（使う必要はありません）
@@ -116,7 +116,7 @@ Pythonはその`*`で何かをすることはありませんが、それ以降
///
-/// note | "技術詳細"
+/// note | 技術詳細
`fastapi`から`Query`、`Path`などをインポートすると、これらは実際には関数です。
diff --git a/docs/ja/docs/tutorial/path-params.md b/docs/ja/docs/tutorial/path-params.md
index e1cb67a13..d86a27cb4 100644
--- a/docs/ja/docs/tutorial/path-params.md
+++ b/docs/ja/docs/tutorial/path-params.md
@@ -24,7 +24,7 @@ Pythonのformat文字列と同様のシンタックスで「パスパラメー
ここでは、 `item_id` は `int` として宣言されています。
-/// check | "確認"
+/// check | 確認
これにより、関数内でのエディターサポート (エラーチェックや補完など) が提供されます。
@@ -38,7 +38,7 @@ Pythonのformat文字列と同様のシンタックスで「パスパラメー
{"item_id":3}
```
-/// check | "確認"
+/// check | 確認
関数が受け取った（および返した）値は、文字列の `"3"` ではなく、Pythonの `int` としての `3` であることに注意してください。
@@ -69,7 +69,7 @@ Pythonのformat文字列と同様のシンタックスで「パスパラメー
<a href="http://127.0.0.1:8000/items/4.2" class="external-link" target="_blank">http://127.0.0.1:8000/items/4.2</a> で見られるように、intのかわりに `float` が与えられた場合にも同様なエラーが表示されます。
-/// check | "確認"
+/// check | 確認
したがって、Pythonの型宣言を使用することで、**FastAPI**はデータのバリデーションを行います。
@@ -85,7 +85,7 @@ Pythonのformat文字列と同様のシンタックスで「パスパラメー
<img src="/img/tutorial/path-params/image01.png">
-/// check | "確認"
+/// check | 確認
繰り返しになりますが、Python型宣言を使用するだけで、**FastAPI**は対話的なAPIドキュメントを自動的に生成します（Swagger UIを統合）。
@@ -143,13 +143,13 @@ Pythonのformat文字列と同様のシンタックスで「パスパラメー
{!../../docs_src/path_params/tutorial005.py!}
```
-/// info | "情報"
+/// info | 情報
<a href="https://docs.python.org/3/library/enum.html" class="external-link" target="_blank">Enumerations (もしくは、enums)はPython 3.4以降で利用できます</a>。
///
-/// tip | "豆知識"
+/// tip | 豆知識
"AlexNet"、"ResNet"そして"LeNet"は機械学習<abbr title="Technically, Deep Learning model architectures">モデル</abbr>の名前です。
@@ -189,7 +189,7 @@ Pythonのformat文字列と同様のシンタックスで「パスパラメー
{!../../docs_src/path_params/tutorial005.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
`ModelName.lenet.value` でも `"lenet"` 値にアクセスできます。
@@ -246,7 +246,7 @@ Starletteのオプションを直接使用することで、以下のURLの様
{!../../docs_src/path_params/tutorial004.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
最初のスラッシュ (`/`)が付いている `/home/johndoe/myfile.txt` をパラメータが含んでいる必要があります。
diff --git a/docs/ja/docs/tutorial/query-params-str-validations.md b/docs/ja/docs/tutorial/query-params-str-validations.md
index 9e54a6f55..6450c91c4 100644
--- a/docs/ja/docs/tutorial/query-params-str-validations.md
+++ b/docs/ja/docs/tutorial/query-params-str-validations.md
@@ -10,7 +10,7 @@
クエリパラメータ `q` は `Optional[str]` 型で、`None` を許容する `str` 型を意味しており、デフォルトは `None` です。そのため、FastAPIはそれが必須ではないと理解します。
-/// note | "備考"
+/// note | 備考
FastAPIは、 `q` はデフォルト値が `=None` であるため、必須ではないと理解します。
@@ -54,7 +54,7 @@ q: Optional[str] = None
しかし、これはクエリパラメータとして明示的に宣言しています。
-/// info | "情報"
+/// info | 情報
FastAPIは以下の部分を気にすることを覚えておいてください:
@@ -118,7 +118,7 @@ q: Union[str, None] = Query(default=None, max_length=50)
{!../../docs_src/query_params_str_validations/tutorial005.py!}
```
-/// note | "備考"
+/// note | 備考
デフォルト値を指定すると、パラメータは任意になります。
@@ -150,7 +150,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
{!../../docs_src/query_params_str_validations/tutorial006.py!}
```
-/// info | "情報"
+/// info | 情報
これまで`...`を見たことがない方へ: これは特殊な単一値です。<a href="https://docs.python.org/3/library/constants.html#Ellipsis" class="external-link" target="_blank">Pythonの一部であり、"Ellipsis"と呼ばれています</a>。
@@ -187,7 +187,7 @@ http://localhost:8000/items/?q=foo&q=bar
}
```
-/// tip | "豆知識"
+/// tip | 豆知識
上述の例のように、`list`型のクエリパラメータを宣言するには明示的に`Query`を使用する必要があります。そうしない場合、リクエストボディと解釈されます。
@@ -230,7 +230,7 @@ http://localhost:8000/items/
{!../../docs_src/query_params_str_validations/tutorial013.py!}
```
-/// note | "備考"
+/// note | 備考
この場合、FastAPIはリストの内容をチェックしないことを覚えておいてください。
@@ -244,7 +244,7 @@ http://localhost:8000/items/
その情報は、生成されたOpenAPIに含まれ、ドキュメントのユーザーインターフェースや外部のツールで使用されます。
-/// note | "備考"
+/// note | 備考
ツールによってOpenAPIのサポートのレベルが異なる可能性があることを覚えておいてください。
diff --git a/docs/ja/docs/tutorial/query-params.md b/docs/ja/docs/tutorial/query-params.md
index 6d41d3742..71f78eca5 100644
--- a/docs/ja/docs/tutorial/query-params.md
+++ b/docs/ja/docs/tutorial/query-params.md
@@ -69,7 +69,7 @@ http://127.0.0.1:8000/items/?skip=20
この場合、関数パラメータ `q` はオプショナルとなり、デフォルトでは `None` になります。
-/// check | "確認"
+/// check | 確認
パスパラメータ `item_id` はパスパラメータであり、`q` はそれとは違ってクエリパラメータであると判別できるほど**FastAPI** が賢いということにも注意してください。
@@ -191,7 +191,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
* `skip`、デフォルト値を `0` とする `int` 。
* `limit`、オプショナルな `int` 。
-/// tip | "豆知識"
+/// tip | 豆知識
[パスパラメータ](path-params.md#_8){.internal-link target=_blank}と同様に `Enum` を使用できます。
diff --git a/docs/ja/docs/tutorial/request-forms-and-files.md b/docs/ja/docs/tutorial/request-forms-and-files.md
index e03b9166d..1e4237b20 100644
--- a/docs/ja/docs/tutorial/request-forms-and-files.md
+++ b/docs/ja/docs/tutorial/request-forms-and-files.md
@@ -2,7 +2,7 @@
`File`と`Form`を同時に使うことでファイルとフォームフィールドを定義することができます。
-/// info | "情報"
+/// info | 情報
アップロードされたファイルやフォームデータを受信するには、まず<a href="https://andrew-d.github.io/python-multipart/" class="external-link" target="_blank">`python-multipart`</a>をインストールします。
@@ -28,7 +28,7 @@
また、いくつかのファイルを`bytes`として、いくつかのファイルを`UploadFile`として宣言することができます。
-/// warning | "注意"
+/// warning | 注意
*path operation*で複数の`File`と`Form`パラメータを宣言することができますが、JSONとして受け取ることを期待している`Body`フィールドを宣言することはできません。なぜなら、リクエストのボディは`application/json`の代わりに`multipart/form-data`を使ってエンコードされているからです。
diff --git a/docs/ja/docs/tutorial/request-forms.md b/docs/ja/docs/tutorial/request-forms.md
index eb453c04a..f130c067f 100644
--- a/docs/ja/docs/tutorial/request-forms.md
+++ b/docs/ja/docs/tutorial/request-forms.md
@@ -2,7 +2,7 @@
JSONの代わりにフィールドを受け取る場合は、`Form`を使用します。
-/// info | "情報"
+/// info | 情報
フォームを使うためには、まず<a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>をインストールします。
@@ -32,13 +32,13 @@ JSONの代わりにフィールドを受け取る場合は、`Form`を使用し
`Form`では`Body`（および`Query`や`Path`、`Cookie`）と同じメタデータとバリデーションを宣言することができます。
-/// info | "情報"
+/// info | 情報
`Form`は`Body`を直接継承するクラスです。
///
-/// tip | "豆知識"
+/// tip | 豆知識
フォームのボディを宣言するには、明示的に`Form`を使用する必要があります。なぜなら、これを使わないと、パラメータはクエリパラメータやボディ（JSON）パラメータとして解釈されるからです。
@@ -50,7 +50,7 @@ HTMLフォーム（`<form></form>`）がサーバにデータを送信する方
**FastAPI** は、JSONの代わりにそのデータを適切な場所から読み込むようにします。
-/// note | "技術詳細"
+/// note | 技術詳細
フォームからのデータは通常、`application/x-www-form-urlencoded`の「media type」を使用してエンコードされます。
@@ -60,7 +60,7 @@ HTMLフォーム（`<form></form>`）がサーバにデータを送信する方
///
-/// warning | "注意"
+/// warning | 注意
*path operation*で複数の`Form`パラメータを宣言することができますが、JSONとして受け取ることを期待している`Body`フィールドを宣言することはできません。なぜなら、リクエストは`application/json`の代わりに`application/x-www-form-urlencoded`を使ってボディをエンコードするからです。
diff --git a/docs/ja/docs/tutorial/response-model.md b/docs/ja/docs/tutorial/response-model.md
index 973f893de..97821f125 100644
--- a/docs/ja/docs/tutorial/response-model.md
+++ b/docs/ja/docs/tutorial/response-model.md
@@ -12,7 +12,7 @@
{!../../docs_src/response_model/tutorial001.py!}
```
-/// note | "備考"
+/// note | 備考
`response_model`は「デコレータ」メソッド（`get`、`post`など）のパラメータであることに注意してください。すべてのパラメータやボディのように、*path operation関数* のパラメータではありません。
@@ -31,7 +31,7 @@ FastAPIは`response_model`を使って以下のことをします:
* 出力データをモデルのデータに限定します。これがどのように重要なのか以下で見ていきましょう。
-/// note | "技術詳細"
+/// note | 技術詳細
レスポンスモデルは、関数の戻り値のアノテーションではなく、このパラメータで宣言されています。なぜなら、パス関数は実際にはそのレスポンスモデルを返すのではなく、`dict`やデータベースオブジェクト、あるいは他のモデルを返し、`response_model`を使用してフィールドの制限やシリアライズを行うからです。
@@ -57,7 +57,7 @@ FastAPIは`response_model`を使って以下のことをします:
しかし、同じモデルを別の*path operation*に使用すると、すべてのクライアントにユーザーのパスワードを送信してしまうことになります。
-/// danger | "危険"
+/// danger | 危険
ユーザーの平文のパスワードを保存したり、レスポンスで送信したりすることは絶対にしないでください。
@@ -130,13 +130,13 @@ FastAPIは`response_model`を使って以下のことをします:
}
```
-/// info | "情報"
+/// info | 情報
FastAPIはこれをするために、Pydanticモデルの`.dict()`を<a href="https://docs.pydantic.dev/latest/concepts/serialization/#modeldict" class="external-link" target="_blank">その`exclude_unset`パラメータ</a>で使用しています。
///
-/// info | "情報"
+/// info | 情報
以下も使用することができます:
@@ -180,7 +180,7 @@ FastAPIは十分に賢いので（実際には、Pydanticが十分に賢い）`d
そのため、それらはJSONレスポンスに含まれることになります。
-/// tip | "豆知識"
+/// tip | 豆知識
デフォルト値は`None`だけでなく、なんでも良いことに注意してください。
例えば、リスト（`[]`）や`10.5`の`float`などです。
@@ -195,7 +195,7 @@ FastAPIは十分に賢いので（実際には、Pydanticが十分に賢い）`d
これは、Pydanticモデルが１つしかなく、出力からいくつかのデータを削除したい場合のクイックショートカットとして使用することができます。
-/// tip | "豆知識"
+/// tip | 豆知識
それでも、これらのパラメータではなく、複数のクラスを使用して、上記のようなアイデアを使うことをおすすめします。
@@ -209,7 +209,7 @@ FastAPIは十分に賢いので（実際には、Pydanticが十分に賢い）`d
{!../../docs_src/response_model/tutorial005.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
`{"name", "description"}`の構文はこれら２つの値をもつ`set`を作成します。
diff --git a/docs/ja/docs/tutorial/response-status-code.md b/docs/ja/docs/tutorial/response-status-code.md
index 90b290887..56bcdaf6c 100644
--- a/docs/ja/docs/tutorial/response-status-code.md
+++ b/docs/ja/docs/tutorial/response-status-code.md
@@ -12,7 +12,7 @@
{!../../docs_src/response_status_code/tutorial001.py!}
```
-/// note | "備考"
+/// note | 備考
`status_code`は「デコレータ」メソッド（`get`、`post`など）のパラメータであることに注意してください。すべてのパラメータやボディのように、*path operation関数*のものではありません。
@@ -20,7 +20,7 @@
`status_code`パラメータはHTTPステータスコードを含む数値を受け取ります。
-/// info | "情報"
+/// info | 情報
`status_code`は代わりに、Pythonの<a href="https://docs.python.org/3/library/http.html#http.HTTPStatus" class="external-link" target="_blank">`http.HTTPStatus`</a>のように、`IntEnum`を受け取ることもできます。
@@ -33,7 +33,7 @@
<img src="https://fastapi.tiangolo.com/img/tutorial/response-status-code/image01.png">
-/// note | "備考"
+/// note | 備考
いくつかのレスポンスコード（次のセクションを参照）は、レスポンスにボディがないことを示しています。
@@ -43,7 +43,7 @@ FastAPIはこれを知っていて、レスポンスボディがないというO
## HTTPステータスコードについて
-/// note | "備考"
+/// note | 備考
すでにHTTPステータスコードが何であるかを知っている場合は、次のセクションにスキップしてください。
@@ -66,7 +66,7 @@ HTTPでは、レスポンスの一部として３桁の数字のステータス
* クライアントからの一般的なエラーについては、`400`を使用することができます。
* `500`以上はサーバーエラーのためのものです。これらを直接使うことはほとんどありません。アプリケーションコードやサーバーのどこかで何か問題が発生した場合、これらのステータスコードのいずれかが自動的に返されます。
-/// tip | "豆知識"
+/// tip | 豆知識
それぞれのステータスコードとどのコードが何のためのコードなのかについて詳細は<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" class="external-link" target="_blank"><abbr title="Mozilla Developer Network">MDN</abbr> HTTP レスポンスステータスコードについてのドキュメント</a>を参照してください。
@@ -94,7 +94,7 @@ HTTPでは、レスポンスの一部として３桁の数字のステータス
<img src="https://fastapi.tiangolo.com/img/tutorial/response-status-code/image02.png">
-/// note | "技術詳細"
+/// note | 技術詳細
また、`from starlette import status`を使うこともできます。
diff --git a/docs/ja/docs/tutorial/schema-extra-example.md b/docs/ja/docs/tutorial/schema-extra-example.md
index baf1bbedd..44dfad737 100644
--- a/docs/ja/docs/tutorial/schema-extra-example.md
+++ b/docs/ja/docs/tutorial/schema-extra-example.md
@@ -24,7 +24,7 @@ JSON Schemaの追加情報を宣言する方法はいくつかあります。
{!../../docs_src/schema_extra_example/tutorial002.py!}
```
-/// warning | "注意"
+/// warning | 注意
これらの追加引数が渡されても、文書化のためのバリデーションは追加されず、注釈だけが追加されることを覚えておいてください。
diff --git a/docs/ja/docs/tutorial/security/first-steps.md b/docs/ja/docs/tutorial/security/first-steps.md
index 51f7bf829..6ace1b542 100644
--- a/docs/ja/docs/tutorial/security/first-steps.md
+++ b/docs/ja/docs/tutorial/security/first-steps.md
@@ -26,7 +26,7 @@
## 実行
-/// info | "情報"
+/// info | 情報
まず<a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>をインストールします。
@@ -56,7 +56,7 @@ $ uvicorn main:app --reload
<img src="/img/tutorial/security/image01.png">
-/// check | "Authorizeボタン!"
+/// check | Authorizeボタン!
すでにピカピカの新しい「Authorize」ボタンがあります。
@@ -68,7 +68,7 @@ $ uvicorn main:app --reload
<img src="/img/tutorial/security/image02.png">
-/// note | "備考"
+/// note | 備考
フォームに何を入力しても、まだうまくいきません。ですが、これから動くようになります。
@@ -114,7 +114,7 @@ OAuth2は、バックエンドやAPIがユーザーを認証するサーバー
この例では、**Bearer**トークンを使用して**OAuth2**を**パスワード**フローで使用します。これには`OAuth2PasswordBearer`クラスを使用します。
-/// info | "情報"
+/// info | 情報
「bearer」トークンが、唯一の選択肢ではありません。
@@ -132,7 +132,7 @@ OAuth2は、バックエンドやAPIがユーザーを認証するサーバー
{!../../docs_src/security/tutorial001.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
ここで、`tokenUrl="token"`は、まだ作成していない相対URL`token`を指します。相対URLなので、`./token`と同じです。
@@ -146,7 +146,7 @@ OAuth2は、バックエンドやAPIがユーザーを認証するサーバー
実際のpath operationもすぐに作ります。
-/// info | "情報"
+/// info | 情報
非常に厳格な「Pythonista」であれば、パラメーター名のスタイルが`token_url`ではなく`tokenUrl`であることを気に入らないかもしれません。
@@ -176,7 +176,7 @@ oauth2_scheme(some, parameters)
**FastAPI**は、この依存関係を使用してOpenAPIスキーマ (および自動APIドキュメント) で「セキュリティスキーム」を定義できることを知っています。
-/// info | "技術詳細"
+/// info | 技術詳細
**FastAPI**は、`OAuth2PasswordBearer` クラス (依存関係で宣言されている) を使用してOpenAPIのセキュリティスキームを定義できることを知っています。これは`fastapi.security.oauth2.OAuth2`、`fastapi.security.base.SecurityBase`を継承しているからです。
diff --git a/docs/ja/docs/tutorial/security/get-current-user.md b/docs/ja/docs/tutorial/security/get-current-user.md
index 0edbd983f..898bbd797 100644
--- a/docs/ja/docs/tutorial/security/get-current-user.md
+++ b/docs/ja/docs/tutorial/security/get-current-user.md
@@ -54,7 +54,7 @@ Pydanticモデルの `User` として、 `current_user` の型を宣言するこ
その関数の中ですべての入力補完や型チェックを行う際に役に立ちます。
-/// tip | "豆知識"
+/// tip | 豆知識
リクエストボディはPydanticモデルでも宣言できることを覚えているかもしれません。
@@ -62,7 +62,7 @@ Pydanticモデルの `User` として、 `current_user` の型を宣言するこ
///
-/// check | "確認"
+/// check | 確認
依存関係システムがこのように設計されているおかげで、 `User` モデルを返却する別の依存関係（別の"dependables"）を持つことができます。
diff --git a/docs/ja/docs/tutorial/security/index.md b/docs/ja/docs/tutorial/security/index.md
index c68e7e7f2..37b8bb958 100644
--- a/docs/ja/docs/tutorial/security/index.md
+++ b/docs/ja/docs/tutorial/security/index.md
@@ -32,7 +32,7 @@ OAuth 1というものもありましたが、これはOAuth2とは全く異な
OAuth2は、通信を暗号化する方法を指定せず、アプリケーションがHTTPSで提供されることを想定しています。
-/// tip | "豆知識"
+/// tip | 豆知識
**デプロイ**のセクションでは、TraefikとLet's Encryptを使用して、無料でHTTPSを設定する方法が紹介されています。
@@ -89,7 +89,7 @@ OpenAPIでは、以下のセキュリティスキームを定義しています:
* この自動検出メカニズムは、OpenID Connectの仕様で定義されているものです。
-/// tip | "豆知識"
+/// tip | 豆知識
Google、Facebook、Twitter、GitHubなど、他の認証/認可プロバイダを統合することも可能で、比較的簡単です。
diff --git a/docs/ja/docs/tutorial/security/oauth2-jwt.md b/docs/ja/docs/tutorial/security/oauth2-jwt.md
index b2f511610..825a1b2b3 100644
--- a/docs/ja/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/ja/docs/tutorial/security/oauth2-jwt.md
@@ -44,7 +44,7 @@ $ pip install python-jose[cryptography]
ここでは、推奨されているものを使用します：<a href="https://cryptography.io/" class="external-link" target="_blank">pyca/cryptography</a>。
-/// tip | "豆知識"
+/// tip | 豆知識
このチュートリアルでは以前、<a href="https://pyjwt.readthedocs.io/" class="external-link" target="_blank">PyJWT</a>を使用していました。
@@ -86,7 +86,7 @@ $ pip install passlib[bcrypt]
</div>
-/// tip | "豆知識"
+/// tip | 豆知識
`passlib`を使用すると、**Django**や**Flask**のセキュリティプラグインなどで作成されたパスワードを読み取れるように設定できます。
@@ -102,7 +102,7 @@ $ pip install passlib[bcrypt]
PassLib の「context」を作成します。これは、パスワードのハッシュ化と検証に使用されるものです。
-/// tip | "豆知識"
+/// tip | 豆知識
PassLibのcontextには、検証だけが許された非推奨の古いハッシュアルゴリズムを含む、様々なハッシュアルゴリズムを使用した検証機能もあります。
@@ -122,7 +122,7 @@ PassLibのcontextには、検証だけが許された非推奨の古いハッシ
{!../../docs_src/security/tutorial004.py!}
```
-/// note | "備考"
+/// note | 備考
新しい（偽の）データベース`fake_users_db`を確認すると、ハッシュ化されたパスワードが次のようになっていることがわかります：`"$2b$12$EixZaYVK1fsbw1ZfbX3OXePaWxn96p36WQoeG6Lruj3vjPGga31lW"`
@@ -219,7 +219,7 @@ IDの衝突を回避するために、ユーザーのJWTトークンを作成す
Username: `johndoe`
Password: `secret`
-/// check | "確認"
+/// check | 確認
コードのどこにも平文のパスワード"`secret`"はなく、ハッシュ化されたものしかないことを確認してください。
@@ -244,7 +244,7 @@ Password: `secret`
<img src="/img/tutorial/security/image10.png">
-/// note | "備考"
+/// note | 備考
ヘッダーの`Authorization`には、`Bearer`で始まる値があります。
diff --git a/docs/ja/docs/tutorial/static-files.md b/docs/ja/docs/tutorial/static-files.md
index e6002a1fb..37ea22dd7 100644
--- a/docs/ja/docs/tutorial/static-files.md
+++ b/docs/ja/docs/tutorial/static-files.md
@@ -11,7 +11,7 @@
{!../../docs_src/static_files/tutorial001.py!}
```
-/// note | "技術詳細"
+/// note | 技術詳細
`from starlette.staticfiles import StaticFiles` も使用できます。
diff --git a/docs/ja/docs/tutorial/testing.md b/docs/ja/docs/tutorial/testing.md
index 6c5e712e8..b7e80cb8d 100644
--- a/docs/ja/docs/tutorial/testing.md
+++ b/docs/ja/docs/tutorial/testing.md
@@ -22,7 +22,7 @@
{!../../docs_src/app_testing/tutorial001.py!}
```
-/// tip | "豆知識"
+/// tip | 豆知識
テスト関数は `async def` ではなく、通常の `def` であることに注意してください。
@@ -32,7 +32,7 @@
///
-/// note | "技術詳細"
+/// note | 技術詳細
`from starlette.testclient import TestClient` も使用できます。
@@ -40,7 +40,7 @@
///
-/// tip | "豆知識"
+/// tip | 豆知識
FastAPIアプリケーションへのリクエストの送信とは別に、テストで `async` 関数 (非同期データベース関数など) を呼び出したい場合は、高度なチュートリアルの[Async Tests](../advanced/async-tests.md){.internal-link target=_blank} を参照してください。
@@ -121,7 +121,7 @@ FastAPIアプリケーションへのリクエストの送信とは別に、テ
(`httpx` または `TestClient` を使用して) バックエンドにデータを渡す方法の詳細は、<a href="https://www.python-httpx.org" class="external-link" target="_blank">HTTPXのドキュメント</a>を確認してください。
-/// info | "情報"
+/// info | 情報
`TestClient` は、Pydanticモデルではなく、JSONに変換できるデータを受け取ることに注意してください。
diff --git a/docs/ko/docs/advanced/events.md b/docs/ko/docs/advanced/events.md
index 94867c198..273c9a479 100644
--- a/docs/ko/docs/advanced/events.md
+++ b/docs/ko/docs/advanced/events.md
@@ -4,7 +4,7 @@
이 함수들은 `async def` 또는 평범하게 `def`으로 선언할 수 있습니다.
-/// warning | "경고"
+/// warning | 경고
이벤트 핸들러는 주 응용 프로그램에서만 작동합니다. [하위 응용 프로그램 - 마운트](./sub-applications.md){.internal-link target=_blank}에서는 작동하지 않습니다.
@@ -34,13 +34,13 @@
이 예제에서 `shutdown` 이벤트 핸들러 함수는 `"Application shutdown"`이라는 텍스트가 적힌 `log.txt` 파일을 추가할 것입니다.
-/// info | "정보"
+/// info | 정보
`open()` 함수에서 `mode="a"`는 "추가"를 의미합니다. 따라서 이미 존재하는 파일의 내용을 덮어쓰지 않고 새로운 줄을 추가합니다.
///
-/// tip | "팁"
+/// tip | 팁
이 예제에서는 파일과 상호작용 하기 위해 파이썬 표준 함수인 `open()`을 사용하고 있습니다.
@@ -50,7 +50,7 @@
///
-/// info | "정보"
+/// info | 정보
이벤트 핸들러에 관한 내용은 <a href="https://www.starlette.io/events/" class="external-link" target="_blank">Starlette 이벤트 문서</a>에서 추가로 확인할 수 있습니다.
diff --git a/docs/ko/docs/advanced/index.md b/docs/ko/docs/advanced/index.md
index cb628fa10..31704727c 100644
--- a/docs/ko/docs/advanced/index.md
+++ b/docs/ko/docs/advanced/index.md
@@ -6,7 +6,7 @@
이어지는 장에서는 여러분이 다른 옵션, 구성 및 추가 기능을 보실 수 있습니다.
-/// tip | "팁"
+/// tip | 팁
다음 장들이 **반드시 "심화"**인 것은 아닙니다.
diff --git a/docs/ko/docs/advanced/response-cookies.md b/docs/ko/docs/advanced/response-cookies.md
index 3f87b320a..f762e94b5 100644
--- a/docs/ko/docs/advanced/response-cookies.md
+++ b/docs/ko/docs/advanced/response-cookies.md
@@ -40,7 +40,7 @@
### 추가 정보
-/// note | "기술적 세부사항"
+/// note | 기술적 세부사항
`from starlette.responses import Response` 또는 `from starlette.responses import JSONResponse`를 사용할 수도 있습니다.
diff --git a/docs/ko/docs/advanced/response-directly.md b/docs/ko/docs/advanced/response-directly.md
index 20389ff2a..aedebff9d 100644
--- a/docs/ko/docs/advanced/response-directly.md
+++ b/docs/ko/docs/advanced/response-directly.md
@@ -38,7 +38,7 @@ Pydantic 모델로 데이터 변환을 수행하지 않으며, 내용을 다른
{!../../docs_src/response_directly/tutorial001.py!}
```
-/// note | "기술적 세부 사항"
+/// note | 기술적 세부 사항
`from starlette.responses import JSONResponse`를 사용할 수도 있습니다.
diff --git a/docs/ko/docs/advanced/response-headers.md b/docs/ko/docs/advanced/response-headers.md
index 54cf655c5..974a06969 100644
--- a/docs/ko/docs/advanced/response-headers.md
+++ b/docs/ko/docs/advanced/response-headers.md
@@ -28,7 +28,7 @@
{!../../docs_src/response_headers/tutorial001.py!}
```
-/// note | "기술적 세부사항"
+/// note | 기술적 세부사항
`from starlette.responses import Response`나 `from starlette.responses import JSONResponse`를 사용할 수도 있습니다.
diff --git a/docs/ko/docs/async.md b/docs/ko/docs/async.md
index dfc2caa78..fa0d20488 100644
--- a/docs/ko/docs/async.md
+++ b/docs/ko/docs/async.md
@@ -21,7 +21,7 @@ async def read_results():
return results
```
-/// note | "참고"
+/// note | 참고
`async def`로 생성된 함수 내부에서만 `await`를 사용할 수 있습니다.
@@ -369,7 +369,7 @@ FastAPI를 사용하지 않더라도, 높은 호환성 및 <a href="https://anyi
## 매우 세부적인 기술적 사항
-/// warning | "경고"
+/// warning | 경고
이 부분은 넘어가도 됩니다.
diff --git a/docs/ko/docs/deployment/docker.md b/docs/ko/docs/deployment/docker.md
index 502a36fc0..e8b2746c5 100644
--- a/docs/ko/docs/deployment/docker.md
+++ b/docs/ko/docs/deployment/docker.md
@@ -4,7 +4,7 @@ FastAPI 어플리케이션을 배포할 때 일반적인 접근 방법은 **리
리눅스 컨테이너를 사용하는 데에는 **보안**, **반복 가능성**, **단순함** 등의 장점이 있습니다.
-/// tip | "팁"
+/// tip | 팁
시간에 쫓기고 있고 이미 이런것들을 알고 있다면 [`Dockerfile`👇](#build-a-docker-image-for-fastapi)로 점프할 수 있습니다.
@@ -133,7 +133,7 @@ Successfully installed fastapi pydantic uvicorn
</div>
-/// info | "정보"
+/// info | 정보
패키지 종속성을 정의하고 설치하기 위한 방법과 도구는 다양합니다.
@@ -231,7 +231,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
프로그램이 `/code`에서 시작하고 그 속에 `./app` 디렉터리가 여러분의 코드와 함께 들어있기 때문에, **Uvicorn**은 이를 보고 `app`을 `app.main`으로부터 **불러 올** 것입니다.
-/// tip | "팁"
+/// tip | 팁
각 코드 라인을 코드의 숫자 버블을 클릭하여 리뷰할 수 있습니다. 👆
@@ -305,7 +305,7 @@ $ docker build -t myimage .
</div>
-/// tip | "팁"
+/// tip | 팁
맨 끝에 있는 `.` 에 주목합시다. 이는 `./`와 동등하며, 도커에게 컨테이너 이미지를 빌드하기 위한 디렉터리를 알려줍니다.
@@ -409,7 +409,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
**HTTPS**와 **인증서**의 **자동** 취득을 다루는 것은 다른 컨테이너가 될 수 있는데, 예를 들어 <a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a>을 사용하는 것입니다.
-/// tip | "팁"
+/// tip | 팁
Traefik은 도커, 쿠버네티스, 그리고 다른 도구와 통합되어 있어 여러분의 컨테이너를 포함하는 HTTPS를 셋업하고 설정하는 것이 매우 쉽습니다.
@@ -441,7 +441,7 @@ Traefik은 도커, 쿠버네티스, 그리고 다른 도구와 통합되어 있
이 요소가 요청들의 **로드**를 읽어들이고 각 워커에게 (바라건대) **균형적으로** 분배한다면, 이 요소는 일반적으로 **로드 밸런서**라고 불립니다.
-/// tip | "팁"
+/// tip | 팁
HTTPS를 위해 사용된 **TLS 종료 프록시** 요소 또한 **로드 밸런서**가 될 수 있습니다.
@@ -524,7 +524,7 @@ HTTPS를 위해 사용된 **TLS 종료 프록시** 요소 또한 **로드 밸런
만약 여러분이 **여러개의 컨테이너**를 가지고 있다면, 아마도 각각의 컨테이너는 **하나의 프로세스**를 가지고 있을 것입니다(예를 들어, **쿠버네티스** 클러스터에서). 그러면 여러분은 복제된 워커 컨테이너를 실행하기 **이전에**, 하나의 컨테이너에 있는 **이전의 단계들을** 수행하는 단일 프로세스를 가지는 **별도의 컨테이너들**을 가지고 싶을 것입니다.
-/// info | "정보"
+/// info | 정보
만약 여러분이 쿠버네티스를 사용하고 있다면, 아마도 이는 <a href="https://kubernetes.io/docs/concepts/workloads/pods/init-containers/" class="external-link" target="_blank">Init Container</a>일 것입니다.
@@ -544,7 +544,7 @@ HTTPS를 위해 사용된 **TLS 종료 프록시** 요소 또한 **로드 밸런
* <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
-/// warning | "경고"
+/// warning | 경고
여러분이 이 베이스 이미지 또는 다른 유사한 이미지를 필요로 하지 **않을** 높은 가능성이 있으며, [위에서 설명된 것처럼: FastAPI를 위한 도커 이미지 빌드하기](#build-a-docker-image-for-fastapi) 처음부터 이미지를 빌드하는 것이 더 나을 수 있습니다.
@@ -556,7 +556,7 @@ HTTPS를 위해 사용된 **TLS 종료 프록시** 요소 또한 **로드 밸런
또한 스크립트를 통해 <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker#pre_start_path" class="external-link" target="_blank">**시작하기 전 사전 단계**</a>를 실행하는 것을 지원합니다.
-/// tip | "팁"
+/// tip | 팁
모든 설정과 옵션을 보려면, 도커 이미지 페이지로 이동합니다: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
@@ -687,7 +687,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
11. `uvicorn` 커맨드를 실행하여, `app.main`에서 불러온 `app` 객체를 사용하도록 합니다.
-/// tip | "팁"
+/// tip | 팁
버블 숫자를 클릭해 각 줄이 하는 일을 알아볼 수 있습니다.
diff --git a/docs/ko/docs/deployment/server-workers.md b/docs/ko/docs/deployment/server-workers.md
index 39976faf5..b40b25cd8 100644
--- a/docs/ko/docs/deployment/server-workers.md
+++ b/docs/ko/docs/deployment/server-workers.md
@@ -17,7 +17,7 @@
지금부터 <a href="https://gunicorn.org/" class="external-link" target="_blank">**구니콘**</a>을 **유비콘 워커 프로세스**와 함께 사용하는 방법을 알려드리겠습니다.
-/// info | "정보"
+/// info | 정보
만약 도커와 쿠버네티스 같은 컨테이너를 사용하고 있다면 다음 챕터 [FastAPI와 컨테이너 - 도커](docker.md){.internal-link target=_blank}에서 더 많은 정보를 얻을 수 있습니다.
diff --git a/docs/ko/docs/deployment/versions.md b/docs/ko/docs/deployment/versions.md
index f3b3c2d7b..559a892ab 100644
--- a/docs/ko/docs/deployment/versions.md
+++ b/docs/ko/docs/deployment/versions.md
@@ -43,7 +43,7 @@ fastapi>=0.45.0,<0.46.0
FastAPI는 오류를 수정하고, 일반적인 변경사항을 위해 "패치"버전의 관습을 따릅니다.
-/// tip | "팁"
+/// tip | 팁
여기서 말하는 "패치"란 버전의 마지막 숫자로, 예를 들어 `0.2.3` 버전에서 "패치"는 `3`을 의미합니다.
@@ -57,7 +57,7 @@ fastapi>=0.45.0,<0.46.0
수정된 사항과 새로운 요소들이 "마이너" 버전에 추가되었습니다.
-/// tip | "팁"
+/// tip | 팁
"마이너"란 버전 넘버의 가운데 숫자로, 예를 들어서 `0.2.3`의 "마이너" 버전은 `2`입니다.
diff --git a/docs/ko/docs/environment-variables.md b/docs/ko/docs/environment-variables.md
index 09c2fd6d3..1e6af3ceb 100644
--- a/docs/ko/docs/environment-variables.md
+++ b/docs/ko/docs/environment-variables.md
@@ -1,6 +1,6 @@
# 환경 변수
-/// tip | "팁"
+/// tip | 팁
만약 "환경 변수"가 무엇이고, 어떻게 사용하는지 알고 계시다면, 이 챕터를 스킵하셔도 좋습니다.
@@ -63,7 +63,7 @@ name = os.getenv("MY_NAME", "World")
print(f"Hello {name} from Python")
```
-/// tip | "팁"
+/// tip | 팁
<a href="https://docs.python.org/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> 의 두 번째 인자는 반환할 기본값입니다.
@@ -151,7 +151,7 @@ Hello World from Python
</div>
-/// tip | "팁"
+/// tip | 팁
<a href="https://12factor.net/config" class="external-link" target="_blank">The Twelve-Factor App: Config</a> 에서 좀 더 자세히 알아볼 수 있습니다.
diff --git a/docs/ko/docs/features.md b/docs/ko/docs/features.md
index b6f6f7af2..5e880c298 100644
--- a/docs/ko/docs/features.md
+++ b/docs/ko/docs/features.md
@@ -63,7 +63,7 @@ second_user_data = {
my_second_user: User = User(**second_user_data)
```
-/// info | "정보"
+/// info | 정보
`**second_user_data`가 뜻하는 것:
diff --git a/docs/ko/docs/python-types.md b/docs/ko/docs/python-types.md
index 6d7346189..7cc98ba76 100644
--- a/docs/ko/docs/python-types.md
+++ b/docs/ko/docs/python-types.md
@@ -12,7 +12,7 @@
비록 **FastAPI**를 쓰지 않는다고 하더라도, 조금이라도 알아두면 도움이 될 것입니다.
-/// note | "참고"
+/// note | 참고
파이썬에 능숙하셔서 타입 힌트에 대해 모두 아신다면, 다음 챕터로 건너뛰세요.
@@ -175,7 +175,7 @@ John Doe
{!../../docs_src/python_types/tutorial006.py!}
```
-/// tip | "팁"
+/// tip | 팁
대괄호 안의 내부 타입은 "타입 매개변수(type paramters)"라고 합니다.
@@ -287,7 +287,7 @@ Pydantic 공식 문서 예시:
{!../../docs_src/python_types/tutorial011.py!}
```
-/// info | "정보"
+/// info | 정보
Pydantic<에 대해 더 배우고 싶다면 <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">공식 문서</a>를 참고하세요.</a>
@@ -319,7 +319,7 @@ Pydantic<에 대해 더 배우고 싶다면 <a href="https://docs.pydantic.dev/"
가장 중요한 건, 표준 파이썬 타입을 한 곳에서(클래스를 더하거나, 데코레이터 사용하는 대신) 사용함으로써 **FastAPI**가 당신을 위해 많은 일을 해준다는 사실이죠.
-/// info | "정보"
+/// info | 정보
만약 모든 자습서를 다 보았음에도 타입에 대해서 더 보고자 방문한 경우에는 <a href="https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html" class="external-link" target="_blank">`mypy`에서 제공하는 "cheat sheet"</a>이 좋은 자료가 될 겁니다.
diff --git a/docs/ko/docs/tutorial/body-fields.md b/docs/ko/docs/tutorial/body-fields.md
index a13159c27..f6532f369 100644
--- a/docs/ko/docs/tutorial/body-fields.md
+++ b/docs/ko/docs/tutorial/body-fields.md
@@ -32,7 +32,7 @@
//// tab | Python 3.10+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -46,7 +46,7 @@
//// tab | Python 3.8+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -58,7 +58,7 @@
////
-/// warning | "경고"
+/// warning | 경고
`Field`는 다른 것들처럼 (`Query`, `Path`, `Body` 등) `fastapi`에서가 아닌 `pydantic`에서 바로 임포트 되는 점에 주의하세요.
@@ -94,7 +94,7 @@
//// tab | Python 3.10+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -108,7 +108,7 @@
//// tab | Python 3.8+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -122,7 +122,7 @@
`Field`는 `Query`, `Path`와 `Body`와 같은 방식으로 동작하며, 모두 같은 매개변수들 등을 가집니다.
-/// note | "기술적 세부사항"
+/// note | 기술적 세부사항
실제로 `Query`, `Path`등, 여러분이 앞으로 볼 다른 것들은 공통 클래스인 `Param` 클래스의 서브클래스 객체를 만드는데, 그 자체로 Pydantic의 `FieldInfo` 클래스의 서브클래스입니다.
@@ -134,7 +134,7 @@
///
-/// tip | "팁"
+/// tip | 팁
주목할 점은 타입, 기본 값 및 `Field`로 이루어진 각 모델 어트리뷰트가 `Path`, `Query`와 `Body`대신 `Field`를 사용하는 *경로 작동 함수*의 매개변수와 같은 구조를 가진다는 점 입니다.
@@ -146,7 +146,7 @@
여러분이 예제를 선언할 때 나중에 이 공식 문서에서 별도 정보를 추가하는 방법을 배울 것입니다.
-/// warning | "경고"
+/// warning | 경고
별도 키가 전달된 `Field` 또한 여러분의 어플리케이션의 OpenAPI 스키마에 나타날 것입니다.
이런 키가 OpenAPI 명세서, [the OpenAPI validator](https://validator.swagger.io/)같은 몇몇 OpenAPI 도구들에 포함되지 못할 수 있으며, 여러분이 생성한 스키마와 호환되지 않을 수 있습니다.
diff --git a/docs/ko/docs/tutorial/body-multiple-params.md b/docs/ko/docs/tutorial/body-multiple-params.md
index 0a0f34585..569ff016e 100644
--- a/docs/ko/docs/tutorial/body-multiple-params.md
+++ b/docs/ko/docs/tutorial/body-multiple-params.md
@@ -14,7 +14,7 @@
{!../../docs_src/body_multiple_params/tutorial001.py!}
```
-/// note | "참고"
+/// note | 참고
이 경우에는 본문으로 부터 가져온 ` item`은 기본값이 `None`이기 때문에, 선택사항이라는 점을 유의해야 합니다.
@@ -58,7 +58,7 @@
}
```
-/// note | "참고"
+/// note | 참고
이전과 같이 `item`이 선언 되었더라도, 본문 내의 `item` 키가 있을 것이라고 예측합니다.
@@ -120,7 +120,7 @@ FastAPI는 요청을 자동으로 변환해, 매개변수의 `item`과 `user`를
q: Optional[str] = None
```
-/// info | "정보"
+/// info | 정보
`Body` 또한 `Query`, `Path` 그리고 이후에 볼 다른 것들처럼 동일한 추가 검증과 메타데이터 매개변수를 갖고 있습니다.
diff --git a/docs/ko/docs/tutorial/body-nested-models.md b/docs/ko/docs/tutorial/body-nested-models.md
index 12fb4e0cc..e9b1d2e18 100644
--- a/docs/ko/docs/tutorial/body-nested-models.md
+++ b/docs/ko/docs/tutorial/body-nested-models.md
@@ -161,7 +161,7 @@ Pydantic 모델의 각 어트리뷰트는 타입을 갖습니다.
}
```
-/// info | "정보"
+/// info | 정보
`images` 키가 어떻게 이미지 객체 리스트를 갖는지 주목하세요.
@@ -175,7 +175,7 @@ Pydantic 모델의 각 어트리뷰트는 타입을 갖습니다.
{!../../docs_src/body_nested_models/tutorial007.py!}
```
-/// info | "정보"
+/// info | 정보
`Offer`가 선택사항 `Image` 리스트를 차례로 갖는 `Item` 리스트를 어떻게 가지고 있는지 주목하세요
@@ -227,7 +227,7 @@ Pydantic 모델 대신에 `dict`를 직접 사용하여 작업할 경우, 이러
{!../../docs_src/body_nested_models/tutorial009.py!}
```
-/// tip | "팁"
+/// tip | 팁
JSON은 오직 `str`형 키만 지원한다는 것을 염두에 두세요.
diff --git a/docs/ko/docs/tutorial/body.md b/docs/ko/docs/tutorial/body.md
index 8df8d556e..9e614ef1c 100644
--- a/docs/ko/docs/tutorial/body.md
+++ b/docs/ko/docs/tutorial/body.md
@@ -8,7 +8,7 @@
**요청** 본문을 선언하기 위해서 모든 강력함과 이점을 갖춘 <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic</a> 모델을 사용합니다.
-/// info | "정보"
+/// info | 정보
데이터를 보내기 위해, (좀 더 보편적인) `POST`, `PUT`, `DELETE` 혹은 `PATCH` 중에 하나를 사용하는 것이 좋습니다.
@@ -149,7 +149,7 @@
<img src="/img/tutorial/body/image05.png">
-/// tip | "팁"
+/// tip | 팁
만약 <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a>를 편집기로 사용한다면, <a href="https://github.com/koxudaxi/pydantic-pycharm-plugin/" class="external-link" target="_blank">Pydantic PyCharm Plugin</a>을 사용할 수 있습니다.
@@ -233,7 +233,7 @@
* 만약 매개변수가 (`int`, `float`, `str`, `bool` 등과 같은) **유일한 타입**으로 되어있으면, **쿼리** 매개변수로 해석될 것입니다.
* 만약 매개변수가 **Pydantic 모델** 타입으로 선언되어 있으면, 요청 **본문**으로 해석될 것입니다.
-/// note | "참고"
+/// note | 참고
FastAPI는 `q`의 값이 필요없음을 알게 될 것입니다. 기본 값이 `= None`이기 때문입니다.
diff --git a/docs/ko/docs/tutorial/cookie-params.md b/docs/ko/docs/tutorial/cookie-params.md
index 1e21e069d..427539210 100644
--- a/docs/ko/docs/tutorial/cookie-params.md
+++ b/docs/ko/docs/tutorial/cookie-params.md
@@ -32,7 +32,7 @@
//// tab | Python 3.10+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -46,7 +46,7 @@
//// tab | Python 3.8+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -90,7 +90,7 @@
//// tab | Python 3.10+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -104,7 +104,7 @@
//// tab | Python 3.8+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -116,7 +116,7 @@
////
-/// note | "기술 세부사항"
+/// note | 기술 세부사항
`Cookie`는 `Path` 및 `Query`의 "자매"클래스입니다. 이 역시 동일한 공통 `Param` 클래스를 상속합니다.
@@ -124,7 +124,7 @@
///
-/// info | "정보"
+/// info | 정보
쿠키를 선언하기 위해서는 `Cookie`를 사용해야 합니다. 그렇지 않으면 해당 매개변수를 쿼리 매개변수로 해석하기 때문입니다.
diff --git a/docs/ko/docs/tutorial/cors.md b/docs/ko/docs/tutorial/cors.md
index 65357ae3f..0222e6258 100644
--- a/docs/ko/docs/tutorial/cors.md
+++ b/docs/ko/docs/tutorial/cors.md
@@ -78,7 +78,7 @@
<abbr title="교차-출처 리소스 공유">CORS</abbr>에 대한 더 많은 정보를 알고싶다면, <a href="https://developer.mozilla.org/ko/docs/Web/HTTP/CORS" class="external-link" target="_blank">Mozilla CORS 문서</a>를 참고하기 바랍니다.
-/// note | "기술적 세부 사항"
+/// note | 기술적 세부 사항
`from starlette.middleware.cors import CORSMiddleware` 역시 사용할 수 있습니다.
diff --git a/docs/ko/docs/tutorial/debugging.md b/docs/ko/docs/tutorial/debugging.md
index 27e8f9abf..fcb68b565 100644
--- a/docs/ko/docs/tutorial/debugging.md
+++ b/docs/ko/docs/tutorial/debugging.md
@@ -74,7 +74,7 @@ from myapp import app
은 실행되지 않습니다.
-/// info | "정보"
+/// info | 정보
자세한 내용은 <a href="https://docs.python.org/3/library/__main__.html" class="external-link" target="_blank">공식 Python 문서</a>를 확인하세요
diff --git a/docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md
index 7430efbb4..41e48aefc 100644
--- a/docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -266,7 +266,7 @@ commons: CommonQueryParams = Depends()
...이렇게 코드를 단축하여도 **FastAPI**는 무엇을 해야하는지 알고 있습니다.
-/// tip | "팁"
+/// tip | 팁
만약 이것이 도움이 되기보다 더 헷갈리게 만든다면, 잊어버리십시오. 이것이 반드시 필요한 것은 아닙니다.
diff --git a/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index e71ba8546..fab636b7f 100644
--- a/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -32,7 +32,7 @@
//// tab | Python 3.8 Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -46,7 +46,7 @@
이러한 의존성들은 기존 의존성들과 같은 방식으로 실행/해결됩니다. 그러나 값은 (무엇이든 반환한다면) *경로 작동 함수*에 제공되지 않습니다.
-/// tip | "팁"
+/// tip | 팁
일부 편집기에서는 사용되지 않는 함수 매개변수를 검사하고 오류로 표시합니다.
@@ -56,7 +56,7 @@
///
-/// info | "정보"
+/// info | 정보
이 예시에서 `X-Key`와 `X-Token`이라는 커스텀 헤더를 만들어 사용했습니다.
@@ -90,7 +90,7 @@
//// tab | Python 3.8 Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -124,7 +124,7 @@
//// tab | Python 3.8 Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -160,7 +160,7 @@
//// tab | Python 3.8 Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
diff --git a/docs/ko/docs/tutorial/dependencies/global-dependencies.md b/docs/ko/docs/tutorial/dependencies/global-dependencies.md
index dd6586c3e..0ad8b55fd 100644
--- a/docs/ko/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/ko/docs/tutorial/dependencies/global-dependencies.md
@@ -24,7 +24,7 @@
//// tab | Python 3.8 Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
diff --git a/docs/ko/docs/tutorial/dependencies/index.md b/docs/ko/docs/tutorial/dependencies/index.md
index f7b2f1788..1aba6e787 100644
--- a/docs/ko/docs/tutorial/dependencies/index.md
+++ b/docs/ko/docs/tutorial/dependencies/index.md
@@ -57,7 +57,7 @@
//// tab | Python 3.10+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -71,7 +71,7 @@
//// tab | Python 3.8+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -101,7 +101,7 @@
그 후 위의 값을 포함한 `dict` 자료형으로 반환할 뿐입니다.
-/// info | "정보"
+/// info | 정보
FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를 사용하기 권장합니다) 추가했습니다.
@@ -139,7 +139,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
//// tab | Python 3.10+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -153,7 +153,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
//// tab | Python 3.8+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -195,7 +195,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
//// tab | Python 3.10+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -209,7 +209,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
//// tab | Python 3.8+ Annotated가 없는 경우
-/// tip | "팁"
+/// tip | 팁
가능하다면 `Annotated`가 달린 버전을 권장합니다.
@@ -231,7 +231,7 @@ FastAPI는 0.95.0 버전부터 `Annotated`에 대한 지원을 (그리고 이를
그리고 그 함수는 *경로 작동 함수*가 작동하는 것과 같은 방식으로 매개변수를 받습니다.
-/// tip | "팁"
+/// tip | 팁
여러분은 다음 장에서 함수를 제외하고서, "다른 것들"이 어떻게 의존성으로 사용되는지 알게 될 것입니다.
@@ -256,7 +256,7 @@ common_parameters --> read_users
이렇게 하면 공용 코드를 한번만 적어도 되며, **FastAPI**는 *경로 작동*을 위해 이에 대한 호출을 처리합니다.
-/// check | "확인"
+/// check | 확인
특별한 클래스를 만들지 않아도 되며, 이러한 것 혹은 비슷한 종류를 **FastAPI**에 "등록"하기 위해 어떤 곳에 넘겨주지 않아도 됩니다.
@@ -300,7 +300,7 @@ commons: Annotated[dict, Depends(common_parameters)]
////
-/// tip | "팁"
+/// tip | 팁
이는 그저 표준 파이썬이고 "type alias"라고 부르며 사실 **FastAPI**에 국한되는 것은 아닙니다.
@@ -322,7 +322,7 @@ commons: Annotated[dict, Depends(common_parameters)]
아무 문제 없습니다. **FastAPI**는 무엇을 할지 알고 있습니다.
-/// note | "참고"
+/// note | 참고
잘 모르시겠다면, [Async: *"In a hurry?"*](../../async.md){.internal-link target=_blank} 문서에서 `async`와 `await`에 대해 확인할 수 있습니다.
diff --git a/docs/ko/docs/tutorial/encoder.md b/docs/ko/docs/tutorial/encoder.md
index 732566d6d..52277f258 100644
--- a/docs/ko/docs/tutorial/encoder.md
+++ b/docs/ko/docs/tutorial/encoder.md
@@ -30,7 +30,7 @@ Pydantic 모델과 같은 객체를 받고 JSON 호환 가능한 버전으로
길이가 긴 문자열 형태의 JSON 형식(문자열)의 데이터가 들어있는 상황에서는 `str`로 반환하지 않습니다. JSON과 모두 호환되는 값과 하위 값이 있는 Python 표준 데이터 구조 (예: `dict`)를 반환합니다.
-/// note | "참고"
+/// note | 참고
실제로 `jsonable_encoder`는 **FastAPI** 에서 내부적으로 데이터를 변환하는 데 사용하지만, 다른 많은 곳에서도 이는 유용합니다.
diff --git a/docs/ko/docs/tutorial/first-steps.md b/docs/ko/docs/tutorial/first-steps.md
index c2c48fb3e..4a689b74a 100644
--- a/docs/ko/docs/tutorial/first-steps.md
+++ b/docs/ko/docs/tutorial/first-steps.md
@@ -24,7 +24,7 @@ $ uvicorn main:app --reload
</div>
-/// note | "참고"
+/// note | 참고
`uvicorn main:app` 명령은 다음을 의미합니다:
@@ -139,7 +139,7 @@ API와 통신하는 클라이언트(프론트엔드, 모바일, IoT 애플리케
`FastAPI`는 당신의 API를 위한 모든 기능을 제공하는 파이썬 클래스입니다.
-/// note | "기술 세부사항"
+/// note | 기술 세부사항
`FastAPI`는 `Starlette`를 직접 상속하는 클래스입니다.
@@ -205,7 +205,7 @@ https://example.com/items/foo
/items/foo
```
-/// info | "정보"
+/// info | 정보
"경로"는 일반적으로 "엔드포인트" 또는 "라우트"라고도 불립니다.
@@ -259,7 +259,7 @@ API를 설계할 때 일반적으로 특정 행동을 수행하기 위해 특정
* 경로 `/`
* <abbr title="HTTP GET 메소드"><code>get</code> 작동</abbr> 사용
-/// info | "`@decorator` 정보"
+/// info | `@decorator` 정보
이 `@something` 문법은 파이썬에서 "데코레이터"라 부릅니다.
@@ -286,7 +286,7 @@ API를 설계할 때 일반적으로 특정 행동을 수행하기 위해 특정
* `@app.patch()`
* `@app.trace()`
-/// tip | "팁"
+/// tip | 팁
각 작동(HTTP 메소드)을 원하는 대로 사용해도 됩니다.
@@ -324,7 +324,7 @@ URL "`/`"에 대한 `GET` 작동을 사용하는 요청을 받을 때마다 **Fa
{!../../docs_src/first_steps/tutorial003.py!}
```
-/// note | "참고"
+/// note | 참고
차이점을 모르겠다면 [Async: *"바쁘신 경우"*](../async.md#_1){.internal-link target=_blank}을 확인하세요.
diff --git a/docs/ko/docs/tutorial/header-params.md b/docs/ko/docs/tutorial/header-params.md
index 26e198869..972f52a33 100644
--- a/docs/ko/docs/tutorial/header-params.md
+++ b/docs/ko/docs/tutorial/header-params.md
@@ -20,7 +20,7 @@
{!../../docs_src/header_params/tutorial001.py!}
```
-/// note | "기술 세부사항"
+/// note | 기술 세부사항
`Header`는 `Path`, `Query` 및 `Cookie`의 "자매"클래스입니다. 이 역시 동일한 공통 `Param` 클래스를 상속합니다.
@@ -28,7 +28,7 @@
///
-/// info | "정보"
+/// info | 정보
헤더를 선언하기 위해서 `Header`를 사용해야 합니다. 그렇지 않으면 해당 매개변수를 쿼리 매개변수로 해석하기 때문입니다.
@@ -54,7 +54,7 @@
{!../../docs_src/header_params/tutorial002.py!}
```
-/// warning | "경고"
+/// warning | 경고
`convert_underscore`를 `False`로 설정하기 전에, 어떤 HTTP 프록시들과 서버들은 언더스코어가 포함된 헤더 사용을 허락하지 않는다는 것을 명심하십시오.
diff --git a/docs/ko/docs/tutorial/index.md b/docs/ko/docs/tutorial/index.md
index a148bc76e..9f5328992 100644
--- a/docs/ko/docs/tutorial/index.md
+++ b/docs/ko/docs/tutorial/index.md
@@ -53,7 +53,7 @@ $ pip install "fastapi[all]"
...이는 코드를 실행하는 서버로 사용할 수 있는 `uvicorn` 또한 포함하고 있습니다.
-/// note | "참고"
+/// note | 참고
부분적으로 설치할 수도 있습니다.
diff --git a/docs/ko/docs/tutorial/middleware.md b/docs/ko/docs/tutorial/middleware.md
index f36f11a27..0547066f1 100644
--- a/docs/ko/docs/tutorial/middleware.md
+++ b/docs/ko/docs/tutorial/middleware.md
@@ -11,7 +11,7 @@
* **응답** 또는 다른 필요한 코드를 실행시키는 동작을 할 수 있습니다.
* **응답**를 반환합니다.
-/// note | "기술 세부사항"
+/// note | 기술 세부사항
만약 `yield`를 사용한 의존성을 가지고 있다면, 미들웨어가 실행되고 난 후에 exit이 실행됩니다.
@@ -35,7 +35,7 @@
{!../../docs_src/middleware/tutorial001.py!}
```
-/// tip | "팁"
+/// tip | 팁
사용자 정의 헤더는 <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers" class="external-link" target="_blank">'X-' 접두사를 사용</a>하여 추가할 수 있습니다.
@@ -43,7 +43,7 @@
///
-/// note | "기술적 세부사항"
+/// note | 기술적 세부사항
`from starlette.requests import request`를 사용할 수도 있습니다.
diff --git a/docs/ko/docs/tutorial/path-operation-configuration.md b/docs/ko/docs/tutorial/path-operation-configuration.md
index 6ebe613a8..75a9c71ce 100644
--- a/docs/ko/docs/tutorial/path-operation-configuration.md
+++ b/docs/ko/docs/tutorial/path-operation-configuration.md
@@ -2,7 +2,7 @@
*경로 작동 데코레이터*를 설정하기 위해서 전달할수 있는 몇 가지 매개변수가 있습니다.
-/// warning | "경고"
+/// warning | 경고
아래 매개변수들은 *경로 작동 함수*가 아닌 *경로 작동 데코레이터*에 직접 전달된다는 사실을 기억하십시오.
@@ -22,7 +22,7 @@
각 상태 코드들은 응답에 사용되며, OpenAPI 스키마에 추가됩니다.
-/// note | "기술적 세부사항"
+/// note | 기술적 세부사항
다음과 같이 임포트하셔도 좋습니다. `from starlette import status`.
@@ -72,13 +72,13 @@
{!../../docs_src/path_operation_configuration/tutorial005.py!}
```
-/// info | "정보"
+/// info | 정보
`response_description`은 구체적으로 응답을 지칭하며, `description`은 일반적인 *경로 작동*을 지칭합니다.
///
-/// check | "확인"
+/// check | 확인
OpenAPI는 각 *경로 작동*이 응답에 관한 설명을 요구할 것을 명시합니다.
diff --git a/docs/ko/docs/tutorial/path-params-numeric-validations.md b/docs/ko/docs/tutorial/path-params-numeric-validations.md
index caab2d453..736f2dc1d 100644
--- a/docs/ko/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/ko/docs/tutorial/path-params-numeric-validations.md
@@ -20,7 +20,7 @@
{!../../docs_src/path_params_numeric_validations/tutorial001.py!}
```
-/// note | "참고"
+/// note | 참고
경로 매개변수는 경로의 일부여야 하므로 언제나 필수적입니다.
@@ -108,7 +108,7 @@
* `lt`: 작거나(`l`ess `t`han)
* `le`: 작거나 같은(`l`ess than or `e`qual)
-/// info | "정보"
+/// info | 정보
`Query`, `Path`, 그리고 나중에게 보게될 것들은 (여러분이 사용할 필요가 없는) 공통 `Param` 클래스의 서브 클래스입니다.
@@ -116,7 +116,7 @@
///
-/// note | "기술 세부사항"
+/// note | 기술 세부사항
`fastapi`에서 `Query`, `Path` 등을 임포트 할 때, 이것들은 실제로 함수입니다.
diff --git a/docs/ko/docs/tutorial/path-params.md b/docs/ko/docs/tutorial/path-params.md
index 09a27a7b3..21808e2ca 100644
--- a/docs/ko/docs/tutorial/path-params.md
+++ b/docs/ko/docs/tutorial/path-params.md
@@ -24,7 +24,7 @@
위의 예시에서, `item_id`는 `int`로 선언되었습니다.
-/// check | "확인"
+/// check | 확인
이 기능은 함수 내에서 오류 검사, 자동완성 등의 편집기 기능을 활용할 수 있게 해줍니다.
@@ -38,7 +38,7 @@
{"item_id":3}
```
-/// check | "확인"
+/// check | 확인
함수가 받은(반환도 하는) 값은 문자열 `"3"`이 아니라 파이썬 `int` 형인 `3`입니다.
@@ -69,7 +69,7 @@
`int`가 아닌 `float`을 전달하는 경우에도 동일한 오류가 나타납니다: <a href="http://127.0.0.1:8000/items/4.2" class="external-link" target="_blank">http://127.0.0.1:8000/items/4.2</a>
-/// check | "확인"
+/// check | 확인
즉, 파이썬 타입 선언을 하면 **FastAPI**는 데이터 검증을 합니다.
@@ -85,7 +85,7 @@
<img src="/img/tutorial/path-params/image01.png">
-/// check | "확인"
+/// check | 확인
그저 파이썬 타입 선언을 하기만 하면 **FastAPI**는 자동 대화형 API 문서(Swagger UI)를 제공합니다.
@@ -143,13 +143,13 @@
{!../../docs_src/path_params/tutorial005.py!}
```
-/// info | "정보"
+/// info | 정보
<a href="https://docs.python.org/3/library/enum.html" class="external-link" target="_blank">열거형(또는 enums)</a>은 파이썬 버전 3.4 이후로 사용 가능합니다.
///
-/// tip | "팁"
+/// tip | 팁
혹시 궁금하다면, "AlexNet", "ResNet", 그리고 "LeNet"은 그저 기계 학습 <abbr title="기술적으로 정확히는 딥 러닝 모델 구조">모델</abbr>들의 이름입니다.
@@ -189,7 +189,7 @@
{!../../docs_src/path_params/tutorial005.py!}
```
-/// tip | "팁"
+/// tip | 팁
`ModelName.lenet.value`로도 값 `"lenet"`에 접근할 수 있습니다.
@@ -246,7 +246,7 @@ Starlette의 옵션을 직접 이용하여 다음과 같은 URL을 사용함으
{!../../docs_src/path_params/tutorial004.py!}
```
-/// tip | "팁"
+/// tip | 팁
매개변수가 가져야 하는 값이 `/home/johndoe/myfile.txt`와 같이 슬래시로 시작(`/`)해야 할 수 있습니다.
diff --git a/docs/ko/docs/tutorial/query-params-str-validations.md b/docs/ko/docs/tutorial/query-params-str-validations.md
index e44f6dd16..71f884e83 100644
--- a/docs/ko/docs/tutorial/query-params-str-validations.md
+++ b/docs/ko/docs/tutorial/query-params-str-validations.md
@@ -10,7 +10,7 @@
쿼리 매개변수 `q`는 `Optional[str]` 자료형입니다. 즉, `str` 자료형이지만 `None` 역시 될 수 있음을 뜻하고, 실제로 기본값은 `None`이기 때문에 FastAPI는 이 매개변수가 필수가 아니라는 것을 압니다.
-/// note | "참고"
+/// note | 참고
FastAPI는 `q`의 기본값이 `= None`이기 때문에 필수가 아님을 압니다.
@@ -54,7 +54,7 @@ q: Optional[str] = None
하지만 명시적으로 쿼리 매개변수를 선언합니다.
-/// info | "정보"
+/// info | 정보
FastAPI는 다음 부분에 관심이 있습니다:
@@ -118,7 +118,7 @@ q: str = Query(None, max_length=50)
{!../../docs_src/query_params_str_validations/tutorial005.py!}
```
-/// note | "참고"
+/// note | 참고
기본값을 갖는 것만으로 매개변수는 선택적이 됩니다.
@@ -150,7 +150,7 @@ q: Optional[str] = Query(None, min_length=3)
{!../../docs_src/query_params_str_validations/tutorial006.py!}
```
-/// info | "정보"
+/// info | 정보
이전에 `...`를 본적이 없다면: 특별한 단일값으로, <a href="https://docs.python.org/3/library/constants.html#Ellipsis" class="external-link" target="_blank">파이썬의 일부이며 "Ellipsis"라 부릅니다</a>.
@@ -187,7 +187,7 @@ http://localhost:8000/items/?q=foo&q=bar
}
```
-/// tip | "팁"
+/// tip | 팁
위의 예와 같이 `list` 자료형으로 쿼리 매개변수를 선언하려면 `Query`를 명시적으로 사용해야 합니다. 그렇지 않으면 요청 본문으로 해석됩니다.
@@ -230,7 +230,7 @@ http://localhost:8000/items/
{!../../docs_src/query_params_str_validations/tutorial013.py!}
```
-/// note | "참고"
+/// note | 참고
이 경우 FastAPI는 리스트의 내용을 검사하지 않음을 명심하기 바랍니다.
@@ -244,7 +244,7 @@ http://localhost:8000/items/
해당 정보는 생성된 OpenAPI에 포함되고 문서 사용자 인터페이스 및 외부 도구에서 사용됩니다.
-/// note | "참고"
+/// note | 참고
도구에 따라 OpenAPI 지원 수준이 다를 수 있음을 명심하기 바랍니다.
diff --git a/docs/ko/docs/tutorial/query-params.md b/docs/ko/docs/tutorial/query-params.md
index b2a946c09..7fa3e8c53 100644
--- a/docs/ko/docs/tutorial/query-params.md
+++ b/docs/ko/docs/tutorial/query-params.md
@@ -69,13 +69,13 @@ http://127.0.0.1:8000/items/?skip=20
이 경우 함수 매개변수 `q`는 선택적이며 기본값으로 `None` 값이 됩니다.
-/// check | "확인"
+/// check | 확인
**FastAPI**는 `item_id`가 경로 매개변수이고 `q`는 경로 매개변수가 아닌 쿼리 매개변수라는 것을 알 정도로 충분히 똑똑합니다.
///
-/// note | "참고"
+/// note | 참고
FastAPI는 `q`가 `= None`이므로 선택적이라는 것을 인지합니다.
@@ -200,7 +200,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
* `skip`, 기본값이 `0`인 `int`.
* `limit`, 선택적인 `int`.
-/// tip | "팁"
+/// tip | 팁
[경로 매개변수](path-params.md#_8){.internal-link target=_blank}와 마찬가지로 `Enum`을 사용할 수 있습니다.
diff --git a/docs/ko/docs/tutorial/request-files.md b/docs/ko/docs/tutorial/request-files.md
index 40579dd51..ca0f43978 100644
--- a/docs/ko/docs/tutorial/request-files.md
+++ b/docs/ko/docs/tutorial/request-files.md
@@ -2,7 +2,7 @@
`File`을 사용하여 클라이언트가 업로드할 파일들을 정의할 수 있습니다.
-/// info | "정보"
+/// info | 정보
업로드된 파일을 전달받기 위해 먼저 <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>를 설치해야합니다.
@@ -28,7 +28,7 @@
{!../../docs_src/request_files/tutorial001.py!}
```
-/// info | "정보"
+/// info | 정보
`File` 은 `Form` 으로부터 직접 상속된 클래스입니다.
@@ -36,7 +36,7 @@
///
-/// tip | "팁"
+/// tip | 팁
File의 본문을 선언할 때, 매개변수가 쿼리 매개변수 또는 본문(JSON) 매개변수로 해석되는 것을 방지하기 위해 `File` 을 사용해야합니다.
@@ -104,7 +104,7 @@ contents = myfile.file.read()
///
-/// note | "Starlette 기술적 세부사항"
+/// note | Starlette 기술적 세부사항
**FastAPI**의 `UploadFile` 은 **Starlette**의 `UploadFile` 을 직접적으로 상속받지만, **Pydantic** 및 FastAPI의 다른 부분들과의 호환성을 위해 필요한 부분들이 추가되었습니다.
@@ -116,7 +116,7 @@ HTML의 폼들(`<form></form>`)이 서버에 데이터를 전송하는 방식은
**FastAPI**는 JSON 대신 올바른 위치에서 데이터를 읽을 수 있도록 합니다.
-/// note | "기술적 세부사항"
+/// note | 기술적 세부사항
폼의 데이터는 파일이 포함되지 않은 경우 일반적으로 "미디어 유형" `application/x-www-form-urlencoded` 을 사용해 인코딩 됩니다.
@@ -126,7 +126,7 @@ HTML의 폼들(`<form></form>`)이 서버에 데이터를 전송하는 방식은
///
-/// warning | "경고"
+/// warning | 경고
다수의 `File` 과 `Form` 매개변수를 한 *경로 작동*에 선언하는 것이 가능하지만, 요청의 본문이 `application/json` 가 아닌 `multipart/form-data` 로 인코딩 되기 때문에 JSON으로 받아야하는 `Body` 필드를 함께 선언할 수는 없습니다.
@@ -148,7 +148,7 @@ HTML의 폼들(`<form></form>`)이 서버에 데이터를 전송하는 방식은
선언한대로, `bytes` 의 `list` 또는 `UploadFile` 들을 전송받을 것입니다.
-/// note | "참고"
+/// note | 참고
2019년 4월 14일부터 Swagger UI가 하나의 폼 필드로 다수의 파일을 업로드하는 것을 지원하지 않습니다. 더 많은 정보를 원하면, <a href="https://github.com/swagger-api/swagger-ui/issues/4276" class="external-link" target="_blank">#4276</a>과 <a href="https://github.com/swagger-api/swagger-ui/issues/3641" class="external-link" target="_blank">#3641</a>을 참고하세요.
@@ -158,7 +158,7 @@ HTML의 폼들(`<form></form>`)이 서버에 데이터를 전송하는 방식은
///
-/// note | "기술적 세부사항"
+/// note | 기술적 세부사항
`from starlette.responses import HTMLResponse` 역시 사용할 수 있습니다.
diff --git a/docs/ko/docs/tutorial/request-forms-and-files.md b/docs/ko/docs/tutorial/request-forms-and-files.md
index 24501fe34..75bca9f15 100644
--- a/docs/ko/docs/tutorial/request-forms-and-files.md
+++ b/docs/ko/docs/tutorial/request-forms-and-files.md
@@ -2,7 +2,7 @@
`File` 과 `Form` 을 사용하여 파일과 폼을 함께 정의할 수 있습니다.
-/// info | "정보"
+/// info | 정보
파일과 폼 데이터를 함께, 또는 각각 업로드하기 위해 먼저 <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>를 설치해야합니다.
@@ -28,7 +28,7 @@
어떤 파일들은 `bytes`로, 또 어떤 파일들은 `UploadFile`로 선언할 수 있습니다.
-/// warning | "경고"
+/// warning | 경고
다수의 `File`과 `Form` 매개변수를 한 *경로 작동*에 선언하는 것이 가능하지만, 요청의 본문이 `application/json`가 아닌 `multipart/form-data`로 인코딩 되기 때문에 JSON으로 받아야하는 `Body` 필드를 함께 선언할 수는 없습니다.
diff --git a/docs/ko/docs/tutorial/response-model.md b/docs/ko/docs/tutorial/response-model.md
index 74034e34d..6ba9654d6 100644
--- a/docs/ko/docs/tutorial/response-model.md
+++ b/docs/ko/docs/tutorial/response-model.md
@@ -12,7 +12,7 @@
{!../../docs_src/response_model/tutorial001.py!}
```
-/// note | "참고"
+/// note | 참고
`response_model`은 "데코레이터" 메소드(`get`, `post`, 등)의 매개변수입니다. 모든 매개변수들과 본문(body)처럼 *경로 작동 함수*가 아닙니다.
@@ -31,7 +31,7 @@ FastAPI는 이 `response_model`를 사용하여:
* 해당 모델의 출력 데이터 제한. 이것이 얼마나 중요한지 아래에서 볼 것입니다.
-/// note | "기술 세부사항"
+/// note | 기술 세부사항
응답 모델은 함수의 타입 어노테이션 대신 이 매개변수로 선언하는데, 경로 함수가 실제 응답 모델을 반환하지 않고 `dict`, 데이터베이스 객체나 기타 다른 모델을 `response_model`을 사용하여 필드 제한과 직렬화를 수행하고 반환할 수 있기 때문입니다
@@ -57,7 +57,7 @@ FastAPI는 이 `response_model`를 사용하여:
그러나 동일한 모델을 다른 *경로 작동*에서 사용할 경우, 모든 클라이언트에게 사용자의 비밀번호를 발신할 수 있습니다.
-/// danger | "위험"
+/// danger | 위험
절대로 사용자의 평문 비밀번호를 저장하거나 응답으로 발신하지 마십시오.
@@ -130,13 +130,13 @@ FastAPI는 이 `response_model`를 사용하여:
}
```
-/// info | "정보"
+/// info | 정보
FastAPI는 이를 위해 Pydantic 모델의 `.dict()`의 <a href="https://docs.pydantic.dev/latest/concepts/serialization/#modeldict" class="external-link" target="_blank"> `exclude_unset` 매개변수</a>를 사용합니다.
///
-/// info | "정보"
+/// info | 정보
아래 또한 사용할 수 있습니다:
@@ -181,7 +181,7 @@ ID가 `baz`인 항목(items)처럼 기본값과 동일한 값을 갖는다면:
따라서 JSON 스키마에 포함됩니다.
-/// tip | "팁"
+/// tip | 팁
`None` 뿐만 아니라 다른 어떤 것도 기본값이 될 수 있습니다.
@@ -197,7 +197,7 @@ ID가 `baz`인 항목(items)처럼 기본값과 동일한 값을 갖는다면:
Pydantic 모델이 하나만 있고 출력에서 일부 데이터를 제거하려는 경우 빠른 지름길로 사용할 수 있습니다.
-/// tip | "팁"
+/// tip | 팁
하지만 이러한 매개변수 대신 여러 클래스를 사용하여 위 아이디어를 사용하는 것을 추천합니다.
@@ -211,7 +211,7 @@ Pydantic 모델이 하나만 있고 출력에서 일부 데이터를 제
{!../../docs_src/response_model/tutorial005.py!}
```
-/// tip | "팁"
+/// tip | 팁
문법 `{"name", "description"}`은 두 값을 갖는 `set`을 만듭니다.
diff --git a/docs/ko/docs/tutorial/response-status-code.md b/docs/ko/docs/tutorial/response-status-code.md
index 57eef6ba1..8e3a16645 100644
--- a/docs/ko/docs/tutorial/response-status-code.md
+++ b/docs/ko/docs/tutorial/response-status-code.md
@@ -12,7 +12,7 @@
{!../../docs_src/response_status_code/tutorial001.py!}
```
-/// note | "참고"
+/// note | 참고
`status_code` 는 "데코레이터" 메소드(`get`, `post` 등)의 매개변수입니다. 모든 매개변수들과 본문처럼 *경로 작동 함수*가 아닙니다.
@@ -20,7 +20,7 @@
`status_code` 매개변수는 HTTP 상태 코드를 숫자로 입력받습니다.
-/// info | "정보"
+/// info | 정보
`status_code` 는 파이썬의 `http.HTTPStatus` 와 같은 `IntEnum` 을 입력받을 수도 있습니다.
@@ -33,7 +33,7 @@
<img src="https://fastapi.tiangolo.com/img/tutorial/response-status-code/image01.png">
-/// note | "참고"
+/// note | 참고
어떤 응답 코드들은 해당 응답에 본문이 없다는 것을 의미하기도 합니다 (다음 항목 참고).
@@ -43,7 +43,7 @@
## HTTP 상태 코드에 대하여
-/// note | "참고"
+/// note | 참고
만약 HTTP 상태 코드에 대하여 이미 알고있다면, 다음 항목으로 넘어가십시오.
@@ -66,7 +66,7 @@ HTTP는 세자리의 숫자 상태 코드를 응답의 일부로 전송합니다
* 일반적인 클라이언트 오류의 경우 `400` 을 사용할 수 있습니다.
* `5xx` 상태 코드는 서버 오류에 사용됩니다. 이것들을 직접 사용할 일은 거의 없습니다. 응용 프로그램 코드나 서버의 일부에서 문제가 발생하면 자동으로 이들 상태 코드 중 하나를 반환합니다.
-/// tip | "팁"
+/// tip | 팁
각각의 상태 코드와 이들이 의미하는 내용에 대해 더 알고싶다면 <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" class="external-link" target="_blank"><abbr title="Mozilla Developer Network">MDN</abbr> HTTP 상태 코드에 관한 문서</a> 를 확인하십시오.
@@ -94,7 +94,7 @@ HTTP는 세자리의 숫자 상태 코드를 응답의 일부로 전송합니다
<img src="https://fastapi.tiangolo.com/img/tutorial/response-status-code/image02.png">
-/// note | "기술적 세부사항"
+/// note | 기술적 세부사항
`from starlette import status` 역시 사용할 수 있습니다.
diff --git a/docs/ko/docs/tutorial/schema-extra-example.md b/docs/ko/docs/tutorial/schema-extra-example.md
index b713c8975..77e94db72 100644
--- a/docs/ko/docs/tutorial/schema-extra-example.md
+++ b/docs/ko/docs/tutorial/schema-extra-example.md
@@ -38,7 +38,7 @@ Pydantic v1에서 <a href="https://docs.pydantic.dev/1.10/usage/schema/#schema-c
////
-/// tip | "팁"
+/// tip | 팁
JSON 스키마를 확장하고 여러분의 별도의 자체 데이터를 추가하기 위해 같은 기술을 사용할 수 있습니다.
@@ -46,7 +46,7 @@ JSON 스키마를 확장하고 여러분의 별도의 자체 데이터를 추가
///
-/// info | "정보"
+/// info | 정보
(FastAPI 0.99.0부터 쓰이기 시작한) OpenAPI 3.1.0은 **JSON 스키마** 표준의 일부인 `examples`에 대한 지원을 추가했습니다.
@@ -143,7 +143,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
## 기술적 세부 사항
-/// tip | "팁"
+/// tip | 팁
이미 **FastAPI**의 **0.99.0 혹은 그 이상** 버전을 사용하고 있다면, 이 세부 사항을 **스킵**해도 상관 없을 것입니다.
@@ -153,7 +153,7 @@ Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를
///
-/// warning | "경고"
+/// warning | 경고
표준 **JSON 스키마**와 **OpenAPI**에 대한 아주 기술적인 세부사항입니다.
@@ -177,7 +177,7 @@ OpenAPI는 또한 `example`과 `examples` 필드를 명세서의 다른 부분
* `File()`
* `Form()`
-/// info | "정보"
+/// info | 정보
이 예전 OpenAPI-특화 `examples` 매개변수는 이제 FastAPI `0.103.0`부터 `openapi_examples`입니다.
@@ -193,7 +193,7 @@ OpenAPI는 또한 `example`과 `examples` 필드를 명세서의 다른 부분
JSON 스키마의 새로운 `examples` 필드는 예제 속 **단순한 `list`**이며, (위에서 상술한 것처럼) OpenAPI의 다른 곳에 존재하는 dict으로 된 추가적인 메타데이터가 아닙니다.
-/// info | "정보"
+/// info | 정보
더 쉽고 새로운 JSON 스키마와의 통합과 함께 OpenAPI 3.1.0가 배포되었지만, 잠시동안 자동 문서 생성을 제공하는 도구인 Swagger UI는 OpenAPI 3.1.0을 지원하지 않았습니다 (5.0.0 버전부터 지원합니다 🎉).
diff --git a/docs/ko/docs/tutorial/security/get-current-user.md b/docs/ko/docs/tutorial/security/get-current-user.md
index 56f5792a7..cf550735a 100644
--- a/docs/ko/docs/tutorial/security/get-current-user.md
+++ b/docs/ko/docs/tutorial/security/get-current-user.md
@@ -102,7 +102,7 @@ Pydantic 모델인 `User`로 `current_user`의 타입을 선언하는 것을 알
이것은 모든 완료 및 타입 검사를 통해 함수 내부에서 우리를 도울 것입니다.
-/// tip | "팁"
+/// tip | 팁
요청 본문도 Pydantic 모델로 선언된다는 것을 기억할 것입니다.
@@ -110,7 +110,7 @@ Pydantic 모델인 `User`로 `current_user`의 타입을 선언하는 것을 알
///
-/// check | "확인"
+/// check | 확인
이 의존성 시스템이 설계된 방식은 모두 `User` 모델을 반환하는 다양한 의존성(다른 "의존적인")을 가질 수 있도록 합니다.
diff --git a/docs/ko/docs/tutorial/static-files.md b/docs/ko/docs/tutorial/static-files.md
index 90a60d193..af785f206 100644
--- a/docs/ko/docs/tutorial/static-files.md
+++ b/docs/ko/docs/tutorial/static-files.md
@@ -11,7 +11,7 @@
{!../../docs_src/static_files/tutorial001.py!}
```
-/// note | "기술적 세부사항"
+/// note | 기술적 세부사항
`from starlette.staticfiles import StaticFiles` 를 사용할 수도 있습니다.
diff --git a/docs/pl/docs/help-fastapi.md b/docs/pl/docs/help-fastapi.md
index 4daad5e90..3ea328dc2 100644
--- a/docs/pl/docs/help-fastapi.md
+++ b/docs/pl/docs/help-fastapi.md
@@ -229,7 +229,7 @@ Jeśli możesz mi w tym pomóc, **pomożesz mi utrzymać FastAPI** i zapewnisz
Dołącz do 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" target="_blank">serwera czatu na Discordzie</a> 👥 i spędzaj czas z innymi w społeczności FastAPI.
-/// tip | "Wskazówka"
+/// tip | Wskazówka
Jeśli masz pytania, zadaj je w <a href="https://github.com/fastapi/fastapi/discussions/new?category=questions" class="external-link" target="_blank">Dyskusjach na GitHubie</a>, jest dużo większa szansa, że otrzymasz pomoc od [Ekspertów FastAPI](fastapi-people.md#fastapi-experts){.internal-link target=_blank}.
diff --git a/docs/pl/docs/tutorial/first-steps.md b/docs/pl/docs/tutorial/first-steps.md
index 9466ca84d..8fa4c75ad 100644
--- a/docs/pl/docs/tutorial/first-steps.md
+++ b/docs/pl/docs/tutorial/first-steps.md
@@ -135,7 +135,7 @@ Możesz go również użyć do automatycznego generowania kodu dla klientów, kt
`FastAPI` jest klasą, która zapewnia wszystkie funkcjonalności Twojego API.
-/// note | "Szczegóły techniczne"
+/// note | Szczegóły techniczne
`FastAPI` jest klasą, która dziedziczy bezpośrednio z `Starlette`.
@@ -249,7 +249,7 @@ Będziemy je również nazywali "**operacjami**".
* ścieżki `/`
* używając <abbr title="metoda HTTP GET">operacji <code>get</code></abbr>
-/// info | "`@decorator` Info"
+/// info | `@decorator` Info
Składnia `@something` jest w Pythonie nazywana "dekoratorem".
diff --git a/docs/pt/docs/advanced/additional-responses.md b/docs/pt/docs/advanced/additional-responses.md
index 46cf1efc3..58e75ad93 100644
--- a/docs/pt/docs/advanced/additional-responses.md
+++ b/docs/pt/docs/advanced/additional-responses.md
@@ -1,6 +1,6 @@
# Retornos Adicionais no OpenAPI
-/// warning | "Aviso"
+/// warning | Aviso
Este é um tema bem avançado.
@@ -30,13 +30,13 @@ Por exemplo, para declarar um outro retorno com o status code `404` e um modelo
{!../../docs_src/additional_responses/tutorial001.py!}
```
-/// note | "Nota"
+/// note | Nota
Lembre-se que você deve retornar o `JSONResponse` diretamente.
///
-/// info | "Informação"
+/// info | Informação
A chave `model` não é parte do OpenAPI.
@@ -181,13 +181,13 @@ Por exemplo, você pode adicionar um media type adicional de `image/png`, declar
{!../../docs_src/additional_responses/tutorial002.py!}
```
-/// note | "Nota"
+/// note | Nota
Note que você deve retornar a imagem utilizando um `FileResponse` diretamente.
///
-/// info | "Informação"
+/// info | Informação
A menos que você especifique um media type diferente explicitamente em seu parâmetro `responses`, o FastAPI assumirá que o retorno possui o mesmo media type contido na classe principal de retorno (padrão `application/json`).
diff --git a/docs/pt/docs/advanced/additional-status-codes.md b/docs/pt/docs/advanced/additional-status-codes.md
index 02bb4c015..5fe970d2a 100644
--- a/docs/pt/docs/advanced/additional-status-codes.md
+++ b/docs/pt/docs/advanced/additional-status-codes.md
@@ -40,7 +40,7 @@ Para conseguir isso, importe `JSONResponse` e retorne o seu conteúdo diretament
//// tab | Python 3.10+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Faça uso da versão `Annotated` quando possível.
@@ -54,7 +54,7 @@ Faça uso da versão `Annotated` quando possível.
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Faça uso da versão `Annotated` quando possível.
@@ -66,7 +66,7 @@ Faça uso da versão `Annotated` quando possível.
////
-/// warning | "Aviso"
+/// warning | Aviso
Quando você retorna um `Response` diretamente, como no exemplo acima, ele será retornado diretamente.
@@ -76,7 +76,7 @@ Garanta que ele tenha toda informação que você deseja, e que os valores sejam
///
-/// note | "Detalhes técnicos"
+/// note | Detalhes técnicos
Você também pode utilizar `from starlette.responses import JSONResponse`.
diff --git a/docs/pt/docs/advanced/advanced-dependencies.md b/docs/pt/docs/advanced/advanced-dependencies.md
index a656390a4..52fe121f9 100644
--- a/docs/pt/docs/advanced/advanced-dependencies.md
+++ b/docs/pt/docs/advanced/advanced-dependencies.md
@@ -36,7 +36,7 @@ Para fazer isso, nós declaramos o método `__call__`:
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Prefira utilizar a versão `Annotated` se possível.
@@ -72,7 +72,7 @@ E agora, nós podemos utilizar o `__init__` para declarar os parâmetros da inst
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Prefira utilizar a versão `Annotated` se possível.
@@ -108,7 +108,7 @@ Nós poderíamos criar uma instância desta classe com:
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Prefira utilizar a versão `Annotated` se possível.
@@ -152,7 +152,7 @@ checker(q="somequery")
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Prefira utilizar a versão `Annotated` se possível.
@@ -164,7 +164,7 @@ Prefira utilizar a versão `Annotated` se possível.
////
-/// tip | "Dica"
+/// tip | Dica
Tudo isso parece não ser natural. E pode não estar muito claro ou aparentar ser útil ainda.
diff --git a/docs/pt/docs/advanced/async-tests.md b/docs/pt/docs/advanced/async-tests.md
index c81d6124b..8fae97298 100644
--- a/docs/pt/docs/advanced/async-tests.md
+++ b/docs/pt/docs/advanced/async-tests.md
@@ -64,7 +64,7 @@ O marcador `@pytest.mark.anyio` informa ao pytest que esta função de teste dev
{!../../docs_src/async_tests/test_main.py!}
```
-/// tip | "Dica"
+/// tip | Dica
Note que a função de teste é `async def` agora, no lugar de apenas `def` como quando estávamos utilizando o `TestClient` anteriormente.
@@ -84,13 +84,13 @@ response = client.get('/')
...que nós utilizamos para fazer as nossas requisições utilizando o `TestClient`.
-/// tip | "Dica"
+/// tip | Dica
Note que nós estamos utilizando async/await com o novo `AsyncClient` - a requisição é assíncrona.
///
-/// warning | "Aviso"
+/// warning | Aviso
Se a sua aplicação depende dos eventos de vida útil (*lifespan*), o `AsyncClient` não acionará estes eventos. Para garantir que eles são acionados, utilize o `LifespanManager` do <a href="https://github.com/florimondmanca/asgi-lifespan#usage" class="external-link" target="_blank">florimondmanca/asgi-lifespan</a>.
@@ -100,7 +100,7 @@ Se a sua aplicação depende dos eventos de vida útil (*lifespan*), o `AsyncCli
Como a função de teste agora é assíncrona, você pode chamar (e `esperar`) outras funções `async` além de enviar requisições para a sua aplicação FastAPI em seus testes, exatamente como você as chamaria em qualquer outro lugar do seu código.
-/// tip | "Dica"
+/// tip | Dica
Se você se deparar com um `RuntimeError: Task attached to a different loop` ao integrar funções assíncronas em seus testes (e.g. ao utilizar o <a href="https://stackoverflow.com/questions/41584243/runtimeerror-task-attached-to-a-different-loop" class="external-link" target="_blank">MotorClient do MongoDB</a>) Lembre-se de instanciar objetos que precisam de um loop de eventos (*event loop*) apenas em funções assíncronas, e.g. um *"callback"* `'@app.on_event("startup")`.
diff --git a/docs/pt/docs/advanced/behind-a-proxy.md b/docs/pt/docs/advanced/behind-a-proxy.md
index 12fd83f3d..6837c9542 100644
--- a/docs/pt/docs/advanced/behind-a-proxy.md
+++ b/docs/pt/docs/advanced/behind-a-proxy.md
@@ -41,7 +41,7 @@ browser --> proxy
proxy --> server
```
-/// tip | "Dica"
+/// tip | Dica
O IP `0.0.0.0` é comumente usado para significar que o programa escuta em todos os IPs disponíveis naquela máquina/servidor.
@@ -82,7 +82,7 @@ $ fastapi run main.py --root-path /api/v1
Se você usar Hypercorn, ele também tem a opção `--root-path`.
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
A especificação ASGI define um `root_path` para esse caso de uso.
@@ -172,7 +172,7 @@ Então, crie um arquivo `traefik.toml` com:
Isso diz ao Traefik para escutar na porta 9999 e usar outro arquivo `routes.toml`.
-/// tip | "Dica"
+/// tip | Dica
Estamos usando a porta 9999 em vez da porta padrão HTTP 80 para que você não precise executá-lo com privilégios de administrador (`sudo`).
@@ -242,7 +242,7 @@ Agora, se você for ao URL com a porta para o Uvicorn: <a href="http://127.0.0.1
}
```
-/// tip | "Dica"
+/// tip | Dica
Perceba que, mesmo acessando em `http://127.0.0.1:8000/app`, ele mostra o `root_path` de `/api/v1`, retirado da opção `--root-path`.
@@ -289,7 +289,7 @@ Isso porque o FastAPI usa esse `root_path` para criar o `server` padrão no Open
## Servidores adicionais
-/// warning | "Aviso"
+/// warning | Aviso
Este é um caso de uso mais avançado. Sinta-se à vontade para pular.
@@ -330,7 +330,7 @@ Gerará um OpenAPI schema como:
}
```
-/// tip | "Dica"
+/// tip | Dica
Perceba o servidor gerado automaticamente com um valor `url` de `/api/v1`, retirado do `root_path`.
@@ -340,7 +340,7 @@ Na interface de documentação em <a href="http://127.0.0.1:9999/api/v1/docs" cl
<img src="/img/tutorial/behind-a-proxy/image03.png">
-/// tip | "Dica"
+/// tip | Dica
A interface de documentação interagirá com o servidor que você selecionar.
diff --git a/docs/pt/docs/advanced/events.md b/docs/pt/docs/advanced/events.md
index 02f5b6d2b..783dbfc83 100644
--- a/docs/pt/docs/advanced/events.md
+++ b/docs/pt/docs/advanced/events.md
@@ -39,7 +39,7 @@ Aqui nós estamos simulando a *inicialização* custosa do carregamento do model
E então, logo após o `yield`, descarregaremos o modelo. Esse código será executado **após** a aplicação **terminar de lidar com as requisições**, pouco antes do *encerramento*. Isso poderia, por exemplo, liberar recursos como memória ou GPU.
-/// tip | "Dica"
+/// tip | Dica
O `shutdown` aconteceria quando você estivesse **encerrando** a aplicação.
@@ -95,7 +95,7 @@ O parâmetro `lifespan` da aplicação `FastAPI` usa um **Gerenciador de Context
## Eventos alternativos (deprecados)
-/// warning | "Aviso"
+/// warning | Aviso
A maneira recomendada para lidar com a *inicialização* e o *encerramento* é usando o parâmetro `lifespan` da aplicação `FastAPI` como descrito acima.
@@ -133,13 +133,13 @@ Para adicionar uma função que deve ser executada quando a aplicação estiver
Aqui, a função de manipulação de evento `shutdown` irá escrever uma linha de texto `"Application shutdown"` no arquivo `log.txt`.
-/// info | "Informação"
+/// info | Informação
Na função `open()`, o `mode="a"` significa "acrescentar", então, a linha irá ser adicionada depois de qualquer coisa que esteja naquele arquivo, sem sobrescrever o conteúdo anterior.
///
-/// tip | "Dica"
+/// tip | Dica
Perceba que nesse caso nós estamos usando a função padrão do Python `open()` que interage com um arquivo.
@@ -165,7 +165,7 @@ Só um detalhe técnico para nerds curiosos. 🤓
Por baixo, na especificação técnica ASGI, essa é a parte do <a href="https://asgi.readthedocs.io/en/latest/specs/lifespan.html" class="external-link" target="_blank">Protocolo Lifespan</a>, e define eventos chamados `startup` e `shutdown`.
-/// info | "Informação"
+/// info | Informação
Você pode ler mais sobre o manipulador `lifespan` do Starlette na <a href="https://www.starlette.io/lifespan/" class="external-link" target="_blank">Documentação do Lifespan Starlette</a>.
diff --git a/docs/pt/docs/advanced/index.md b/docs/pt/docs/advanced/index.md
index 2569fc914..22ba2bf4a 100644
--- a/docs/pt/docs/advanced/index.md
+++ b/docs/pt/docs/advanced/index.md
@@ -6,7 +6,7 @@ O [Tutorial - Guia de Usuário](../tutorial/index.md){.internal-link target=_bla
Na próxima seção você verá outras opções, configurações, e recursos adicionais.
-/// tip | "Dica"
+/// tip | Dica
As próximas seções **não são necessáriamente "avançadas"**
diff --git a/docs/pt/docs/advanced/openapi-webhooks.md b/docs/pt/docs/advanced/openapi-webhooks.md
index 5a0226c74..344fe6371 100644
--- a/docs/pt/docs/advanced/openapi-webhooks.md
+++ b/docs/pt/docs/advanced/openapi-webhooks.md
@@ -22,7 +22,7 @@ Com o **FastAPI**, utilizando o OpenAPI, você pode definir os nomes destes webh
Isto pode facilitar bastante para os seus usuários **implementarem as APIs deles** para receber as requisições dos seus **webhooks**, eles podem inclusive ser capazes de gerar parte do código da API deles.
-/// info | "Informação"
+/// info | Informação
Webhooks estão disponíveis a partir do OpenAPI 3.1.0, e possui suporte do FastAPI a partir da versão `0.99.0`.
@@ -38,7 +38,7 @@ Quando você cria uma aplicação com o **FastAPI**, existe um atributo chamado
Os webhooks que você define aparecerão no esquema do **OpenAPI** e na **página de documentação** gerada automaticamente.
-/// info | "Informação"
+/// info | Informação
O objeto `app.webhooks` é na verdade apenas um `APIRouter`, o mesmo tipo que você utilizaria ao estruturar a sua aplicação com diversos arquivos.
diff --git a/docs/pt/docs/advanced/response-cookies.md b/docs/pt/docs/advanced/response-cookies.md
index d0821b5b2..cd8f39db3 100644
--- a/docs/pt/docs/advanced/response-cookies.md
+++ b/docs/pt/docs/advanced/response-cookies.md
@@ -42,7 +42,7 @@ E também que você não esteja enviando nenhum dado que deveria ter sido filtra
### Mais informações
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
Você também poderia usar `from starlette.responses import Response` ou `from starlette.responses import JSONResponse`.
diff --git a/docs/pt/docs/advanced/response-headers.md b/docs/pt/docs/advanced/response-headers.md
index d1958e46b..98a7e0b6d 100644
--- a/docs/pt/docs/advanced/response-headers.md
+++ b/docs/pt/docs/advanced/response-headers.md
@@ -28,7 +28,7 @@ Crie uma resposta conforme descrito em [Retornar uma resposta diretamente](respo
{!../../docs_src/response_headers/tutorial001.py!}
```
-/// note | "Detalhes técnicos"
+/// note | Detalhes técnicos
Você também pode usar `from starlette.responses import Response` ou `from starlette.responses import JSONResponse`.
diff --git a/docs/pt/docs/advanced/security/http-basic-auth.md b/docs/pt/docs/advanced/security/http-basic-auth.md
index 26983a103..28c718f64 100644
--- a/docs/pt/docs/advanced/security/http-basic-auth.md
+++ b/docs/pt/docs/advanced/security/http-basic-auth.md
@@ -38,7 +38,7 @@ Então, quando você digitar o usuário e senha, o navegador os envia automatica
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Prefira utilizar a versão `Annotated` se possível.
@@ -86,7 +86,7 @@ Então nós podemos utilizar o `secrets.compare_digest()` para garantir que o `c
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Prefira utilizar a versão `Annotated` se possível.
@@ -179,7 +179,7 @@ Após detectar que as credenciais estão incorretas, retorne um `HTTPException`
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Prefira utilizar a versão `Annotated` se possível.
diff --git a/docs/pt/docs/advanced/security/index.md b/docs/pt/docs/advanced/security/index.md
index ae63f1c96..6c7becb67 100644
--- a/docs/pt/docs/advanced/security/index.md
+++ b/docs/pt/docs/advanced/security/index.md
@@ -4,7 +4,7 @@
Existem algumas funcionalidades adicionais para lidar com segurança além das cobertas em [Tutorial - Guia de Usuário: Segurança](../../tutorial/security/index.md){.internal-link target=_blank}.
-/// tip | "Dica"
+/// tip | Dica
As próximas seções **não são necessariamente "avançadas"**.
diff --git a/docs/pt/docs/advanced/security/oauth2-scopes.md b/docs/pt/docs/advanced/security/oauth2-scopes.md
index fa4594c89..49fb75944 100644
--- a/docs/pt/docs/advanced/security/oauth2-scopes.md
+++ b/docs/pt/docs/advanced/security/oauth2-scopes.md
@@ -10,7 +10,7 @@ Toda vez que você "se autentica com" Facebook, Google, GitHub, Microsoft, Twitt
Nesta seção, você verá como gerenciar a autenticação e autorização com os mesmos escopos do OAuth2 em sua aplicação **FastAPI**.
-/// warning | "Aviso"
+/// warning | Aviso
Isso é uma seção mais ou menos avançada. Se você está apenas começando, você pode pular.
@@ -308,7 +308,7 @@ E a função de dependência `get_current_active_user` também pode declarar sub
Neste caso, ele requer o escopo `me` (poderia requerer mais de um escopo).
-/// note | "Nota"
+/// note | Nota
Você não necessariamente precisa adicionar diferentes escopos em diferentes lugares.
@@ -771,7 +771,7 @@ O mais comum é o fluxo implícito.
O mais seguro é o fluxo de código, mas ele é mais complexo para implementar, pois ele necessita mais passos. Como ele é mais complexo, muitos provedores terminam sugerindo o fluxo implícito.
-/// note | "Nota"
+/// note | Nota
É comum que cada provedor de autenticação nomeie os seus fluxos de forma diferente, para torná-lo parte de sua marca.
diff --git a/docs/pt/docs/advanced/templates.md b/docs/pt/docs/advanced/templates.md
index 88a5b940e..2314fed91 100644
--- a/docs/pt/docs/advanced/templates.md
+++ b/docs/pt/docs/advanced/templates.md
@@ -37,13 +37,13 @@ Além disso, em versões anteriores, o objeto `request` era passado como parte d
///
-/// tip | "Dica"
+/// tip | Dica
Ao declarar `response_class=HTMLResponse`, a documentação entenderá que a resposta será HTML.
///
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
Você também poderia usar `from starlette.templating import Jinja2Templates`.
diff --git a/docs/pt/docs/advanced/testing-dependencies.md b/docs/pt/docs/advanced/testing-dependencies.md
index f978350a5..94594e7e9 100644
--- a/docs/pt/docs/advanced/testing-dependencies.md
+++ b/docs/pt/docs/advanced/testing-dependencies.md
@@ -54,7 +54,7 @@ E então o **FastAPI** chamará a sobreposição no lugar da dependência origin
//// tab | Python 3.10+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Prefira utilizar a versão `Annotated` se possível.
@@ -68,7 +68,7 @@ Prefira utilizar a versão `Annotated` se possível.
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Prefira utilizar a versão `Annotated` se possível.
@@ -80,7 +80,7 @@ Prefira utilizar a versão `Annotated` se possível.
////
-/// tip | "Dica"
+/// tip | Dica
Você pode definir uma sobreposição de dependência para uma dependência que é utilizada em qualquer lugar da sua aplicação **FastAPI**.
@@ -96,7 +96,7 @@ E então você pode redefinir as suas sobreposições (removê-las) definindo o
app.dependency_overrides = {}
```
-/// tip | "Dica"
+/// tip | Dica
Se você quer sobrepor uma dependência apenas para alguns testes, você pode definir a sobreposição no início do testes (dentro da função de teste) e reiniciá-la ao final (no final da função de teste).
diff --git a/docs/pt/docs/advanced/testing-websockets.md b/docs/pt/docs/advanced/testing-websockets.md
index daa610df6..99e1a6db4 100644
--- a/docs/pt/docs/advanced/testing-websockets.md
+++ b/docs/pt/docs/advanced/testing-websockets.md
@@ -8,7 +8,7 @@ Para isso, você utiliza o `TestClient` dentro de uma instrução `with`, conect
{!../../docs_src/app_testing/tutorial002.py!}
```
-/// note | "Nota"
+/// note | Nota
Para mais detalhes, confira a documentação do Starlette para <a href="https://www.starlette.io/testclient/#testing-websocket-sessions" class="external-link" target="_blank">testar WebSockets</a>.
diff --git a/docs/pt/docs/advanced/using-request-directly.md b/docs/pt/docs/advanced/using-request-directly.md
index c2114c214..df7e01833 100644
--- a/docs/pt/docs/advanced/using-request-directly.md
+++ b/docs/pt/docs/advanced/using-request-directly.md
@@ -35,7 +35,7 @@ Para isso você precisa acessar a requisição diretamente.
Ao declarar o parâmetro com o tipo sendo um `Request` em sua *função de operação de rota*, o **FastAPI** saberá como passar o `Request` neste parâmetro.
-/// tip | "Dica"
+/// tip | Dica
Note que neste caso, nós estamos declarando o parâmetro da rota ao lado do parâmetro da requisição.
@@ -49,7 +49,7 @@ Do mesmo jeito, você pode declarar qualquer outro parâmetro normalmente, e al
Você pode ler mais sobre os detalhes do objeto <a href="https://www.starlette.io/requests/" class="external-link" target="_blank">`Request` no site da documentação oficial do Starlette.</a>.
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
Você também pode utilizar `from starlette.requests import Request`.
diff --git a/docs/pt/docs/alternatives.md b/docs/pt/docs/alternatives.md
index 2a2632bbc..29c9693bb 100644
--- a/docs/pt/docs/alternatives.md
+++ b/docs/pt/docs/alternatives.md
@@ -30,13 +30,13 @@ Ele é utilizado por muitas companhias incluindo Mozilla, Red Hat e Eventbrite.
Ele foi um dos primeiros exemplos de **documentação automática de API**, e essa foi especificamente uma das primeiras idéias que inspirou "a busca por" **FastAPI**.
-/// note | "Nota"
+/// note | Nota
Django REST Framework foi criado por Tom Christie. O mesmo criador de Starlette e Uvicorn, nos quais **FastAPI** é baseado.
///
-/// check | "**FastAPI** inspirado para"
+/// check | **FastAPI** inspirado para
Ter uma documentação automática da API em interface web.
@@ -56,7 +56,7 @@ Esse desacoplamento de partes, e sendo um "microframework" que pode ser extendid
Dada a simplicidade do Flask, parecia uma ótima opção para construção de APIs. A próxima coisa a procurar era um "Django REST Framework" para Flask.
-/// check | "**FastAPI** inspirado para"
+/// check | **FastAPI** inspirado para
Ser um microframework. Fazer ele fácil para misturar e combinar com ferramentas e partes necessárias.
@@ -98,7 +98,7 @@ def read_url():
Veja as similaridades em `requests.get(...)` e `@app.get(...)`.
-/// check | "**FastAPI** inspirado para"
+/// check | **FastAPI** inspirado para
* Ter uma API simples e intuitiva.
* Utilizar nomes de métodos HTTP (operações) diretamente, de um jeito direto e intuitivo.
@@ -118,7 +118,7 @@ Em algum ponto, Swagger foi dado para a Fundação Linux, e foi renomeado OpenAP
Isso acontece porquê quando alguém fala sobre a versão 2.0 é comum dizer "Swagger", e para a versão 3+, "OpenAPI".
-/// check | "**FastAPI** inspirado para"
+/// check | **FastAPI** inspirado para
Adotar e usar um padrão aberto para especificações API, ao invés de algum esquema customizado.
@@ -147,7 +147,7 @@ Esses recursos são o que Marshmallow foi construído para fornecer. Ele é uma
Mas ele foi criado antes da existência do _type hints_ do Python. Então, para definir todo o <abbr title="definição de como os dados devem ser formados">_schema_</abbr> você precisa utilizar específicas ferramentas e classes fornecidas pelo Marshmallow.
-/// check | "**FastAPI** inspirado para"
+/// check | **FastAPI** inspirado para
Usar código para definir "schemas" que forneçam, automaticamente, tipos de dados e validação.
@@ -169,7 +169,7 @@ Webargs foi criado pelos mesmos desenvolvedores do Marshmallow.
///
-/// check | "**FastAPI** inspirado para"
+/// check | **FastAPI** inspirado para
Ter validação automática de dados vindos de requisições.
@@ -199,7 +199,7 @@ APISpec foi criado pelos mesmos desenvolvedores do Marshmallow.
///
-/// check | "**FastAPI** inspirado para"
+/// check | **FastAPI** inspirado para
Dar suporte a padrões abertos para APIs, OpenAPI.
@@ -231,7 +231,7 @@ Flask-apispec foi criado pelos mesmos desenvolvedores do Marshmallow.
///
-/// check | "**FastAPI** inspirado para"
+/// check | **FastAPI** inspirado para
Gerar _schema_ OpenAPI automaticamente, a partir do mesmo código que define serialização e validação.
@@ -251,7 +251,7 @@ Mas como os dados TypeScript não são preservados após a compilação para o J
Ele também não controla modelos aninhados muito bem. Então, se o corpo JSON na requisição for um objeto JSON que contém campos internos que contém objetos JSON aninhados, ele não consegue ser validado e documentado apropriadamente.
-/// check | "**FastAPI** inspirado para"
+/// check | **FastAPI** inspirado para
Usar tipos Python para ter um ótimo suporte do editor.
@@ -263,7 +263,7 @@ Ter um sistema de injeção de dependência poderoso. Achar um jeito de minimiza
Ele foi um dos primeiros frameworks Python extremamente rápido baseado em `asyncio`. Ele foi feito para ser muito similar ao Flask.
-/// note | "Detalhes técnicos"
+/// note | Detalhes técnicos
Ele utiliza <a href="https://github.com/MagicStack/uvloop" class="external-link" target="_blank">`uvloop`</a> ao invés do '_loop_' `asyncio` padrão do Python. É isso que deixa ele tão rápido.
@@ -271,7 +271,7 @@ Ele claramente inspirou Uvicorn e Starlette, que são atualmente mais rápidos q
///
-/// check | "**FastAPI** inspirado para"
+/// check | **FastAPI** inspirado para
Achar um jeito de ter uma performance insana.
@@ -289,7 +289,7 @@ Ele é projetado para ter funções que recebem dois parâmetros, uma "requisiç
Então, validação de dados, serialização e documentação tem que ser feitos no código, não automaticamente. Ou eles terão que ser implementados como um framework acima do Falcon, como o Hug. Essa mesma distinção acontece em outros frameworks que são inspirados pelo design do Falcon, tendo um objeto de requisição e um objeto de resposta como parâmetros.
-/// check | "**FastAPI** inspirado para"
+/// check | **FastAPI** inspirado para
Achar jeitos de conseguir melhor performance.
@@ -315,7 +315,7 @@ O sistema de injeção de dependência exige pré-registro das dependências e a
Rotas são declaradas em um único lugar, usando funções declaradas em outros lugares (ao invés de usar decoradores que possam ser colocados diretamente acima da função que controla o _endpoint_). Isso é mais perto de como o Django faz isso do que como Flask (e Starlette) faz. Ele separa no código coisas que são relativamente amarradas.
-/// check | "**FastAPI** inspirado para"
+/// check | **FastAPI** inspirado para
Definir validações extras para tipos de dados usando valores "padrão" de atributos dos modelos. Isso melhora o suporte do editor, e não estava disponível no Pydantic antes.
@@ -343,7 +343,7 @@ Hug foi criado por Timothy Crosley, o mesmo criador do <a href="https://github.
///
-/// check | "Idéias inspiradas para o **FastAPI**"
+/// check | Idéias inspiradas para o **FastAPI**
Hug inspirou partes do APIStar, e foi uma das ferramentas que eu achei mais promissora, ao lado do APIStar.
@@ -387,7 +387,7 @@ APIStar foi criado por Tom Christie. O mesmo cara que criou:
///
-/// check | "**FastAPI** inspirado para"
+/// check | **FastAPI** inspirado para
Existir.
@@ -411,7 +411,7 @@ Isso faz dele extremamente intuitivo.
Ele é comparável ao Marshmallow. Embora ele seja mais rápido que Marshmallow em testes de performance. E ele é baseado nos mesmos Python _type hints_, o suporte ao editor é ótimo.
-/// check | "**FastAPI** usa isso para"
+/// check | **FastAPI** usa isso para
Controlar toda a validação de dados, serialização de dados e modelo de documentação automática (baseado no JSON Schema).
@@ -447,7 +447,7 @@ Mas ele não fornece validação de dados automática, serialização e document
Essa é uma das principais coisas que **FastAPI** adiciona no topo, tudo baseado em Python _type hints_ (usando Pydantic). Isso, mais o sistema de injeção de dependência, utilidades de segurança, geração de _schema_ OpenAPI, etc.
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
ASGI é um novo "padrão" sendo desenvolvido pelos membros do time central do Django. Ele ainda não está como "Padrão Python" (PEP), embora eles estejam em processo de fazer isso.
@@ -455,7 +455,7 @@ No entanto, ele já está sendo utilizado como "padrão" por diversas ferramenta
///
-/// check | "**FastAPI** usa isso para"
+/// check | **FastAPI** usa isso para
Controlar todas as partes web centrais. Adiciona recursos no topo.
@@ -473,7 +473,7 @@ Ele não é um framework web, mas sim um servidor. Por exemplo, ele não fornece
Ele é o servidor recomendado para Starlette e **FastAPI**.
-/// check | "**FastAPI** recomenda isso para"
+/// check | **FastAPI** recomenda isso para
O principal servidor web para rodar aplicações **FastAPI**.
diff --git a/docs/pt/docs/deployment/concepts.md b/docs/pt/docs/deployment/concepts.md
index 20513c366..8cf70d0b4 100644
--- a/docs/pt/docs/deployment/concepts.md
+++ b/docs/pt/docs/deployment/concepts.md
@@ -151,7 +151,7 @@ E ainda assim, você provavelmente não gostaria que o aplicativo permanecesse i
Mas nos casos com erros realmente graves que travam o **processo** em execução, você vai querer um componente externo que seja responsável por **reiniciar** o processo, pelo menos algumas vezes...
-/// tip | "Dica"
+/// tip | Dica
...Embora se o aplicativo inteiro estiver **travando imediatamente**, provavelmente não faça sentido reiniciá-lo para sempre. Mas nesses casos, você provavelmente notará isso durante o desenvolvimento, ou pelo menos logo após a implantação.
@@ -239,7 +239,7 @@ Aqui estão algumas combinações e estratégias possíveis:
* **Serviços de nuvem** que cuidam disso para você
* O serviço de nuvem provavelmente **cuidará da replicação para você**. Ele possivelmente deixaria você definir **um processo para executar**, ou uma **imagem de contêiner** para usar, em qualquer caso, provavelmente seria **um único processo Uvicorn**, e o serviço de nuvem seria responsável por replicá-lo.
-/// tip | "Dica"
+/// tip | Dica
Não se preocupe se alguns desses itens sobre **contêineres**, Docker ou Kubernetes ainda não fizerem muito sentido.
@@ -261,7 +261,7 @@ E você terá que se certificar de que é um único processo executando essas et
Claro, há alguns casos em que não há problema em executar as etapas anteriores várias vezes; nesse caso, é muito mais fácil de lidar.
-/// tip | "Dica"
+/// tip | Dica
Além disso, tenha em mente que, dependendo da sua configuração, em alguns casos você **pode nem precisar de nenhuma etapa anterior** antes de iniciar sua aplicação.
@@ -279,7 +279,7 @@ Aqui estão algumas ideias possíveis:
* Um script bash que roda os passos anteriores e então inicia seu aplicativo
* Você ainda precisaria de uma maneira de iniciar/reiniciar *aquele* script bash, detectar erros, etc.
-/// tip | "Dica"
+/// tip | Dica
Darei exemplos mais concretos de como fazer isso com contêineres em um capítulo futuro: [FastAPI em contêineres - Docker](docker.md){.internal-link target=_blank}.
diff --git a/docs/pt/docs/deployment/docker.md b/docs/pt/docs/deployment/docker.md
index df93bac2c..cf18bb153 100644
--- a/docs/pt/docs/deployment/docker.md
+++ b/docs/pt/docs/deployment/docker.md
@@ -4,7 +4,7 @@ Ao fazer o deploy de aplicações FastAPI uma abordagem comum é construir uma *
Usando contêineres Linux você tem diversas vantagens incluindo **segurança**, **replicabilidade**, **simplicidade**, entre outras.
-/// tip | "Dica"
+/// tip | Dica
Está com pressa e já sabe dessas coisas? Pode ir direto para [`Dockerfile` abaixo 👇](#construindo-uma-imagem-docker-para-fastapi).
diff --git a/docs/pt/docs/deployment/https.md b/docs/pt/docs/deployment/https.md
index 6ccc875fd..9a13977ec 100644
--- a/docs/pt/docs/deployment/https.md
+++ b/docs/pt/docs/deployment/https.md
@@ -4,7 +4,7 @@
Mas é bem mais complexo do que isso.
-/// tip | "Dica"
+/// tip | Dica
Se você está com pressa ou não se importa, continue com as seções seguintes para instruções passo a passo para configurar tudo com diferentes técnicas.
diff --git a/docs/pt/docs/deployment/manually.md b/docs/pt/docs/deployment/manually.md
index 9eff3daaa..237f4f8b9 100644
--- a/docs/pt/docs/deployment/manually.md
+++ b/docs/pt/docs/deployment/manually.md
@@ -102,7 +102,7 @@ $ pip install "uvicorn[standard]"
Um processo semelhante se aplicaria a qualquer outro programa de servidor ASGI.
-/// tip | "Dica"
+/// tip | Dica
Adicionando o `standard`, o Uvicorn instalará e usará algumas dependências extras recomendadas.
@@ -126,7 +126,7 @@ $ uvicorn main:app --host 0.0.0.0 --port 80
</div>
-/// note | "Nota"
+/// note | Nota
O comando `uvicorn main:app` refere-se a:
@@ -143,7 +143,7 @@ from main import app
Cada programa de servidor ASGI alternativo teria um comando semelhante, você pode ler mais na documentação respectiva.
-/// warning | "Aviso"
+/// warning | Aviso
Uvicorn e outros servidores suportam a opção `--reload` que é útil durante o desenvolvimento.
diff --git a/docs/pt/docs/deployment/server-workers.md b/docs/pt/docs/deployment/server-workers.md
index 0d6cd5b39..63eda56b4 100644
--- a/docs/pt/docs/deployment/server-workers.md
+++ b/docs/pt/docs/deployment/server-workers.md
@@ -17,7 +17,7 @@ Como você viu no capítulo anterior sobre [Conceitos de implantação](concepts
Aqui mostrarei como usar o **Uvicorn** com **processos de trabalho** usando o comando `fastapi` ou o comando `uvicorn` diretamente.
-/// info | "Informação"
+/// info | Informação
Se você estiver usando contêineres, por exemplo com Docker ou Kubernetes, falarei mais sobre isso no próximo capítulo: [FastAPI em contêineres - Docker](docker.md){.internal-link target=_blank}.
diff --git a/docs/pt/docs/deployment/versions.md b/docs/pt/docs/deployment/versions.md
index 79243a014..323ddbd45 100644
--- a/docs/pt/docs/deployment/versions.md
+++ b/docs/pt/docs/deployment/versions.md
@@ -42,7 +42,7 @@ Seguindo as convenções de controle de versão semântica, qualquer versão aba
FastAPI também segue a convenção de que qualquer alteração de versão "PATCH" é para correção de bugs e alterações não significativas.
-/// tip | "Dica"
+/// tip | Dica
O "PATCH" é o último número, por exemplo, em `0.2.3`, a versão PATCH é `3`.
@@ -56,7 +56,7 @@ fastapi>=0.45.0,<0.46.0
Mudanças significativas e novos recursos são adicionados em versões "MINOR".
-/// tip | "Dica"
+/// tip | Dica
O "MINOR" é o número que está no meio, por exemplo, em `0.2.3`, a versão MINOR é `2`.
diff --git a/docs/pt/docs/environment-variables.md b/docs/pt/docs/environment-variables.md
index 360d1c496..432f78af0 100644
--- a/docs/pt/docs/environment-variables.md
+++ b/docs/pt/docs/environment-variables.md
@@ -1,6 +1,6 @@
# Variáveis de Ambiente
-/// tip | "Dica"
+/// tip | Dica
Se você já sabe o que são "variáveis de ambiente" e como usá-las, pode pular esta seção.
@@ -63,7 +63,7 @@ name = os.getenv("MY_NAME", "World")
print(f"Hello {name} from Python")
```
-/// tip | "Dica"
+/// tip | Dica
O segundo argumento para <a href="https://docs.python.org/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> é o valor padrão a ser retornado.
@@ -151,7 +151,7 @@ Hello World from Python
</div>
-/// tip | "Dica"
+/// tip | Dica
Você pode ler mais sobre isso em <a href="https://12factor.net/config" class="external-link" target="_blank">The Twelve-Factor App: Config</a>.
diff --git a/docs/pt/docs/help-fastapi.md b/docs/pt/docs/help-fastapi.md
index 61eeac0dc..3d6e1f9d2 100644
--- a/docs/pt/docs/help-fastapi.md
+++ b/docs/pt/docs/help-fastapi.md
@@ -109,7 +109,7 @@ Assim podendo tentar ajudar a resolver essas questões.
Entre no 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" target="_blank">server de conversa do Discord</a> 👥 e conheça novas pessoas da comunidade
do FastAPI.
-/// tip | "Dica"
+/// tip | Dica
Para perguntas, pergunte nas <a href="https://github.com/fastapi/fastapi/issues/new/choose" class="external-link" target="_blank">questões do GitHub</a>, lá tem um chance maior de você ser ajudado sobre o FastAPI [FastAPI Experts](fastapi-people.md#especialistas){.internal-link target=_blank}.
diff --git a/docs/pt/docs/how-to/graphql.md b/docs/pt/docs/how-to/graphql.md
index 2cfd790c5..250135e23 100644
--- a/docs/pt/docs/how-to/graphql.md
+++ b/docs/pt/docs/how-to/graphql.md
@@ -4,7 +4,7 @@ Como o **FastAPI** é baseado no padrão **ASGI**, é muito fácil integrar qual
Você pode combinar *operações de rota* normais do FastAPI com GraphQL na mesma aplicação.
-/// tip | "Dica"
+/// tip | Dica
**GraphQL** resolve alguns casos de uso muito específicos.
@@ -49,7 +49,7 @@ Versões anteriores do Starlette incluiam uma classe `GraphQLApp` para integrar
Ela foi descontinuada do Starlette, mas se você tem código que a utilizava, você pode facilmente **migrar** para <a href="https://github.com/ciscorn/starlette-graphene3" class="external-link" target="_blank">starlette-graphene3</a>, que cobre o mesmo caso de uso e tem uma **interface quase idêntica**.
-/// tip | "Dica"
+/// tip | Dica
Se você precisa de GraphQL, eu ainda recomendaria que você desse uma olhada no <a href="https://strawberry.rocks/" class="external-link" target="_blank">Strawberry</a>, pois ele é baseado em type annotations em vez de classes e tipos personalizados.
diff --git a/docs/pt/docs/tutorial/bigger-applications.md b/docs/pt/docs/tutorial/bigger-applications.md
index fcc30961f..a094005fd 100644
--- a/docs/pt/docs/tutorial/bigger-applications.md
+++ b/docs/pt/docs/tutorial/bigger-applications.md
@@ -4,7 +4,7 @@ Se você está construindo uma aplicação ou uma API web, é raro que você pos
**FastAPI** oferece uma ferramenta conveniente para estruturar sua aplicação, mantendo toda a flexibilidade.
-/// info | "Informação"
+/// info | Informação
Se você vem do Flask, isso seria o equivalente aos Blueprints do Flask.
@@ -29,7 +29,7 @@ Digamos que você tenha uma estrutura de arquivos como esta:
│ └── admin.py
```
-/// tip | "Dica"
+/// tip | Dica
Existem vários arquivos `__init__.py` presentes em cada diretório ou subdiretório.
@@ -105,7 +105,7 @@ Todas as mesmas opções são suportadas.
Todos os mesmos `parameters`, `responses`, `dependencies`, `tags`, etc.
-/// tip | "Dica"
+/// tip | Dica
Neste exemplo, a variável é chamada de `router`, mas você pode nomeá-la como quiser.
@@ -139,7 +139,7 @@ Agora usaremos uma dependência simples para ler um cabeçalho `X-Token` persona
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Prefira usar a versão `Annotated` se possível.
@@ -151,7 +151,7 @@ Prefira usar a versão `Annotated` se possível.
////
-/// tip | "Dica"
+/// tip | Dica
Estamos usando um cabeçalho inventado para simplificar este exemplo.
@@ -201,7 +201,7 @@ Também podemos adicionar uma lista de `tags` e `responses` extras que serão ap
E podemos adicionar uma lista de `dependencies` que serão adicionadas a todas as *operações de rota* no roteador e serão executadas/resolvidas para cada solicitação feita a elas.
-/// tip | "Dica"
+/// tip | Dica
Observe que, assim como [dependências em *decoradores de operação de rota*](dependencies/dependencies-in-path-operation-decorators.md){.internal-link target=_blank}, nenhum valor será passado para sua *função de operação de rota*.
@@ -222,7 +222,7 @@ O resultado final é que os caminhos dos itens agora são:
* As dependências do roteador são executadas primeiro, depois as [`dependencies` no decorador](dependencies/dependencies-in-path-operation-decorators.md){.internal-link target=_blank} e, em seguida, as dependências de parâmetros normais.
* Você também pode adicionar [dependências de `Segurança` com `scopes`](../advanced/security/oauth2-scopes.md){.internal-link target=_blank}.
-/// tip | "Dica"
+/// tip | Dica
Ter `dependências` no `APIRouter` pode ser usado, por exemplo, para exigir autenticação para um grupo inteiro de *operações de rota*. Mesmo que as dependências não sejam adicionadas individualmente a cada uma delas.
@@ -248,7 +248,7 @@ Então usamos uma importação relativa com `..` para as dependências:
#### Como funcionam as importações relativas
-/// tip | "Dica"
+/// tip | Dica
Se você sabe perfeitamente como funcionam as importações, continue para a próxima seção abaixo.
@@ -319,7 +319,7 @@ Mas ainda podemos adicionar _mais_ `tags` que serão aplicadas a uma *operação
{!../../docs_src/bigger_applications/app/routers/items.py!}
```
-/// tip | "Dica"
+/// tip | Dica
Esta última operação de caminho terá a combinação de tags: `["items", "custom"]`.
@@ -381,7 +381,7 @@ Também poderíamos importá-los como:
from app.routers import items, users
```
-/// info | "Informação"
+/// info | Informação
A primeira versão é uma "importação relativa":
@@ -428,7 +428,7 @@ Agora, vamos incluir os `roteadores` dos submódulos `usuários` e `itens`:
{!../../docs_src/bigger_applications/app/main.py!}
```
-/// info | "Informação"
+/// info | Informação
`users.router` contém o `APIRouter` dentro do arquivo `app/routers/users.py`.
@@ -440,7 +440,7 @@ Com `app.include_router()` podemos adicionar cada `APIRouter` ao aplicativo prin
Ele incluirá todas as rotas daquele roteador como parte dele.
-/// note | "Detalhe Técnico"
+/// note | Detalhe Técnico
Na verdade, ele criará internamente uma *operação de rota* para cada *operação de rota* que foi declarada no `APIRouter`.
@@ -503,7 +503,7 @@ Aqui fazemos isso... só para mostrar que podemos 🤷:
e funcionará corretamente, junto com todas as outras *operações de rota* adicionadas com `app.include_router()`.
-/// info | "Detalhes Técnicos"
+/// info | Detalhes Técnicos
**Observação**: este é um detalhe muito técnico que você provavelmente pode **simplesmente pular**.
diff --git a/docs/pt/docs/tutorial/body-fields.md b/docs/pt/docs/tutorial/body-fields.md
index ab9377fdb..ac0b85ab5 100644
--- a/docs/pt/docs/tutorial/body-fields.md
+++ b/docs/pt/docs/tutorial/body-fields.md
@@ -10,7 +10,7 @@ Primeiro, você tem que importá-lo:
{!../../docs_src/body_fields/tutorial001.py!}
```
-/// warning | "Aviso"
+/// warning | Aviso
Note que `Field` é importado diretamente do `pydantic`, não do `fastapi` como todo o resto (`Query`, `Path`, `Body`, etc).
@@ -26,7 +26,7 @@ Você pode então utilizar `Field` com atributos do modelo:
`Field` funciona da mesma forma que `Query`, `Path` e `Body`, ele possui todos os mesmos parâmetros, etc.
-/// note | "Detalhes técnicos"
+/// note | Detalhes técnicos
Na realidade, `Query`, `Path` e outros que você verá em seguida, criam objetos de subclasses de uma classe `Param` comum, que é ela mesma uma subclasse da classe `FieldInfo` do Pydantic.
@@ -38,7 +38,7 @@ Lembre-se que quando você importa `Query`, `Path`, e outros de `fastapi`, esse
///
-/// tip | "Dica"
+/// tip | Dica
Note como cada atributo do modelo com um tipo, valor padrão e `Field` possuem a mesma estrutura que parâmetros de *funções de operações de rota*, com `Field` ao invés de `Path`, `Query` e `Body`.
diff --git a/docs/pt/docs/tutorial/body-multiple-params.md b/docs/pt/docs/tutorial/body-multiple-params.md
index 400813a7b..ad4931b11 100644
--- a/docs/pt/docs/tutorial/body-multiple-params.md
+++ b/docs/pt/docs/tutorial/body-multiple-params.md
@@ -24,7 +24,7 @@ E você também pode declarar parâmetros de corpo como opcionais, definindo o v
////
-/// note | "Nota"
+/// note | Nota
Repare que, neste caso, o `item` que seria capturado a partir do corpo é opcional. Visto que ele possui `None` como valor padrão.
@@ -80,7 +80,7 @@ Então, ele usará o nome dos parâmetros como chaves (nome dos campos) no corpo
}
```
-/// note | "Nota"
+/// note | Nota
Repare que mesmo que o `item` esteja declarado da mesma maneira que antes, agora é esperado que ele esteja dentro do corpo com uma chave `item`.
@@ -170,7 +170,7 @@ Por exemplo:
////
-/// info | "Informação"
+/// info | Informação
`Body` também possui todas as validações adicionais e metadados de parâmetros como em `Query`,`Path` e outras que você verá depois.
diff --git a/docs/pt/docs/tutorial/body-nested-models.md b/docs/pt/docs/tutorial/body-nested-models.md
index 3aa79d563..bbe72a744 100644
--- a/docs/pt/docs/tutorial/body-nested-models.md
+++ b/docs/pt/docs/tutorial/body-nested-models.md
@@ -165,7 +165,7 @@ Isso vai esperar(converter, validar, documentar, etc) um corpo JSON tal qual:
}
```
-/// info | "informação"
+/// info | informação
Note como o campo `images` agora tem uma lista de objetos de image.
@@ -179,7 +179,7 @@ Você pode definir modelos profundamente aninhados de forma arbitrária:
{!../../docs_src/body_nested_models/tutorial007.py!}
```
-/// info | "informação"
+/// info | informação
Note como `Offer` tem uma lista de `Item`s, que por sua vez possui opcionalmente uma lista `Image`s
@@ -232,7 +232,7 @@ Neste caso, você aceitaria qualquer `dict`, desde que tenha chaves` int` com va
{!../../docs_src/body_nested_models/tutorial009.py!}
```
-/// tip | "Dica"
+/// tip | Dica
Leve em condideração que o JSON só suporta `str` como chaves.
diff --git a/docs/pt/docs/tutorial/body.md b/docs/pt/docs/tutorial/body.md
index 429e4fd5a..f3a1fda75 100644
--- a/docs/pt/docs/tutorial/body.md
+++ b/docs/pt/docs/tutorial/body.md
@@ -8,7 +8,7 @@ Sua API quase sempre irá enviar um corpo na **resposta**. Mas os clientes não
Para declarar um corpo da **requisição**, você utiliza os modelos do <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic</a> com todos os seus poderes e benefícios.
-/// info | "Informação"
+/// info | Informação
Para enviar dados, você deve usar utilizar um dos métodos: `POST` (Mais comum), `PUT`, `DELETE` ou `PATCH`.
@@ -113,7 +113,7 @@ Mas você terá o mesmo suporte do editor no <a href="https://www.jetbrains.com/
<img src="/img/tutorial/body/image05.png">
-/// tip | "Dica"
+/// tip | Dica
Se você utiliza o <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a> como editor, você pode utilizar o <a href="https://github.com/koxudaxi/pydantic-pycharm-plugin/" class="external-link" target="_blank">Plugin do Pydantic para o PyCharm </a>.
@@ -161,7 +161,7 @@ Os parâmetros da função serão reconhecidos conforme abaixo:
* Se o parâmetro é de um **tipo único** (como `int`, `float`, `str`, `bool`, etc) será interpretado como um parâmetro de **consulta**.
* Se o parâmetro é declarado como um **modelo Pydantic**, será interpretado como o **corpo** da requisição.
-/// note | "Observação"
+/// note | Observação
O FastAPI saberá que o valor de `q` não é obrigatório por causa do valor padrão `= None`.
diff --git a/docs/pt/docs/tutorial/cors.md b/docs/pt/docs/tutorial/cors.md
index 16c4e9bf5..326101bd2 100644
--- a/docs/pt/docs/tutorial/cors.md
+++ b/docs/pt/docs/tutorial/cors.md
@@ -78,7 +78,7 @@ Qualquer solicitação com um cabeçalho `Origin`. Neste caso, o middleware pass
Para mais informações <abbr title="Cross-Origin Resource Sharing">CORS</abbr>, acesse <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS" class="external-link" target="_blank">Mozilla CORS documentation</a>.
-/// note | "Detalhes técnicos"
+/// note | Detalhes técnicos
Você também pode usar `from starlette.middleware.cors import CORSMiddleware`.
diff --git a/docs/pt/docs/tutorial/debugging.md b/docs/pt/docs/tutorial/debugging.md
index 6bac7eb85..fca162988 100644
--- a/docs/pt/docs/tutorial/debugging.md
+++ b/docs/pt/docs/tutorial/debugging.md
@@ -74,7 +74,7 @@ Então, a linha:
não será executada.
-/// info | "Informação"
+/// info | Informação
Para mais informações, consulte <a href="https://docs.python.org/3/library/__main__.html" class="external-link" target="_blank">a documentação oficial do Python</a>.
diff --git a/docs/pt/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/pt/docs/tutorial/dependencies/classes-as-dependencies.md
index 179bfefb5..fcf71d08c 100644
--- a/docs/pt/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/pt/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -32,7 +32,7 @@ No exemplo anterior, nós retornávamos um `dict` da nossa dependência ("injet
//// tab | Python 3.10+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -46,7 +46,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -145,7 +145,7 @@ Então, podemos mudar o "injetável" na dependência `common_parameters` acima p
//// tab | Python 3.10+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -159,7 +159,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -199,7 +199,7 @@ Observe o método `__init__` usado para criar uma instância da classe:
//// tab | Python 3.10+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -213,7 +213,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -253,7 +253,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.10+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -267,7 +267,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -319,7 +319,7 @@ Agora você pode declarar sua dependência utilizando essa classe.
//// tab | Python 3.10+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -333,7 +333,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -361,7 +361,7 @@ commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -397,7 +397,7 @@ commons: Annotated[CommonQueryParams, ...
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -423,7 +423,7 @@ commons: Annotated[Any, Depends(CommonQueryParams)]
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -463,7 +463,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.10+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -477,7 +477,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -507,7 +507,7 @@ commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -535,7 +535,7 @@ commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -559,7 +559,7 @@ commons: Annotated[CommonQueryParams, Depends()]
//// tab | Python 3.8 non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -601,7 +601,7 @@ O mesmo exemplo ficaria então dessa forma:
//// tab | Python 3.10+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -615,7 +615,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -629,7 +629,7 @@ Utilize a versão com `Annotated` se possível.
...e o **FastAPI** saberá o que fazer.
-/// tip | "Dica"
+/// tip | Dica
Se isso parece mais confuso do que útil, não utilize, você não *precisa* disso.
diff --git a/docs/pt/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/pt/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index 7d7086945..89c34855e 100644
--- a/docs/pt/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/pt/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -32,7 +32,7 @@ Ele deve ser uma lista de `Depends()`:
//// tab | Python 3.8 non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível
@@ -46,7 +46,7 @@ Utilize a versão com `Annotated` se possível
Essas dependências serão executadas/resolvidas da mesma forma que dependências comuns. Mas o valor delas (se existir algum) não será passado para a sua *função de operação de rota*.
-/// tip | "Dica"
+/// tip | Dica
Alguns editores de texto checam parâmetros de funções não utilizados, e os mostram como erros.
@@ -56,7 +56,7 @@ Isso também pode ser útil para evitar confundir novos desenvolvedores que ao v
///
-/// info | "Informação"
+/// info | Informação
Neste exemplo utilizamos cabeçalhos personalizados inventados `X-Keys` e `X-Token`.
@@ -90,7 +90,7 @@ Dependências podem declarar requisitos de requisições (como cabeçalhos) ou o
//// tab | Python 3.8 non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível
@@ -124,7 +124,7 @@ Essas dependências podem levantar exceções, da mesma forma que dependências
//// tab | Python 3.8 non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível
@@ -160,7 +160,7 @@ Então, você pode reutilizar uma dependência comum (que retorna um valor) que
//// tab | Python 3.8 non-Annotated
-/// tip | "Dica"
+/// tip | Dica
diff --git a/docs/pt/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/pt/docs/tutorial/dependencies/dependencies-with-yield.md
index d90bebe39..90c1e02e0 100644
--- a/docs/pt/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/pt/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -4,13 +4,13 @@ O FastAPI possui suporte para dependências que realizam <abbr title='também ch
Para fazer isso, utilize `yield` em vez de `return`, e escreva os passos extras (código) depois.
-/// tip | "Dica"
+/// tip | Dica
Garanta que `yield` é utilizado apenas uma vez.
///
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
Qualquer função que possa ser utilizada com:
@@ -45,7 +45,7 @@ O código após o `yield` é executado após a resposta ser entregue:
{!../../docs_src/dependencies/tutorial007.py!}
```
-/// tip | "Dica"
+/// tip | Dica
Você pode usar funções assíncronas (`async`) ou funções comuns.
@@ -93,7 +93,7 @@ Por exemplo, `dependency_c` pode depender de `dependency_b`, e `dependency_b` de
//// tab | python 3.8+ non-annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -129,7 +129,7 @@ E, por outro lado, `dependency_b` precisa que o valor de `dependency_a` (nomeada
//// tab | python 3.8+ non-annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -149,7 +149,7 @@ Você pode ter qualquer combinação de dependências que você quiser.
O **FastAPI** se encarrega de executá-las na ordem certa.
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
Tudo isso funciona graças aos <a href="https://docs.python.org/3/library/contextlib.html" class="external-link" target="_blank">gerenciadores de contexto</a> do Python.
@@ -163,7 +163,7 @@ Você viu que dependências podem ser utilizadas com `yield` e podem incluir blo
Da mesma forma, você pode lançar uma `httpexception` ou algo parecido no código de saída, após o `yield`
-/// tip | "Dica"
+/// tip | Dica
Essa é uma técnica relativamente avançada, e na maioria dos casos você não precisa dela totalmente, já que você pode lançar exceções (incluindo `httpexception`) dentro do resto do código da sua aplicação, por exemplo, em uma *função de operação de rota*.
@@ -189,7 +189,7 @@ Mas ela existe para ser utilizada caso você precise. 🤓
//// tab | python 3.8+ non-annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -225,7 +225,7 @@ Se você capturar uma exceção com `except` em uma dependência que utilize `yi
//// tab | Python 3.8+ non-annotated
-/// tip | "dica"
+/// tip | dica
utilize a versão com `Annotated` se possível.
@@ -263,7 +263,7 @@ Você pode relançar a mesma exceção utilizando `raise`:
//// tab | python 3.8+ non-annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -316,7 +316,7 @@ participant tasks as Tarefas de Background
end
```
-/// info | "Informação"
+/// info | Informação
Apenas **uma resposta** será enviada para o cliente. Ela pode ser uma das respostas de erro, ou então a resposta da *operação de rota*.
@@ -324,7 +324,7 @@ Após uma dessas respostas ser enviada, nenhuma outra resposta pode ser enviada
///
-/// tip | "Dica"
+/// tip | Dica
Esse diagrama mostra `HttpException`, mas você pode levantar qualquer outra exceção que você capture em uma dependência com `yield` ou um [Manipulador de exceções personalizado](../handling-errors.md#instalando-manipuladores-de-excecoes-customizados){.internal-link target=_blank}.
@@ -334,7 +334,7 @@ Se você lançar qualquer exceção, ela será passada para as dependências com
## Dependências com `yield`, `HTTPException`, `except` e Tarefas de Background
-/// warning | "Aviso"
+/// warning | Aviso
Você provavelmente não precisa desses detalhes técnicos, você pode pular essa seção e continuar na próxima seção abaixo.
@@ -356,7 +356,7 @@ Isso foi implementado dessa forma principalmente para permitir que os mesmos obj
Ainda assim, como isso exigiria esperar que a resposta navegasse pela rede enquanto mantia ativo um recurso desnecessário na dependência com yield (por exemplo, uma conexão com banco de dados), isso mudou na versão 0.106.0 do FastAPI.
-/// tip | "Dica"
+/// tip | Dica
Adicionalmente, uma tarefa de background é, normalmente, um conjunto de lógicas independentes que devem ser manipuladas separadamente, com seus próprios recursos (e.g. sua própria conexão com banco de dados).
@@ -390,7 +390,7 @@ Quando você cria uma dependência com `yield`, o **FastAPI** irá criar um gere
### Utilizando gerenciadores de contexto em dependências com `yield`
-/// warning | "Aviso"
+/// warning | Aviso
Isso é uma ideia mais ou menos "avançada".
@@ -406,7 +406,7 @@ Você também pode usá-los dentro de dependências com `yield` do **FastAPI** a
{!../../docs_src/dependencies/tutorial010.py!}
```
-/// tip | "Dica"
+/// tip | Dica
Outra forma de criar um gerenciador de contexto é utilizando:
diff --git a/docs/pt/docs/tutorial/dependencies/global-dependencies.md b/docs/pt/docs/tutorial/dependencies/global-dependencies.md
index 60a88940c..b0723d224 100644
--- a/docs/pt/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/pt/docs/tutorial/dependencies/global-dependencies.md
@@ -24,7 +24,7 @@ Nesse caso, elas serão aplicadas a todas as *operações de rota* da aplicaçã
//// tab | Python 3.8 non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
diff --git a/docs/pt/docs/tutorial/dependencies/index.md b/docs/pt/docs/tutorial/dependencies/index.md
index 2a63e7ab8..0f411ff1e 100644
--- a/docs/pt/docs/tutorial/dependencies/index.md
+++ b/docs/pt/docs/tutorial/dependencies/index.md
@@ -57,7 +57,7 @@ Ela é apenas uma função que pode receber os mesmos parâmetros de uma *funç
//// tab | Python 3.10+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -71,7 +71,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -101,7 +101,7 @@ Neste caso, a dependência espera por:
E então retorna um `dict` contendo esses valores.
-/// info | "Informação"
+/// info | Informação
FastAPI passou a suportar a notação `Annotated` (e começou a recomendá-la) na versão 0.95.0.
@@ -139,7 +139,7 @@ Certifique-se de [Atualizar a versão do FastAPI](../../deployment/versions.md#a
//// tab | Python 3.10+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -153,7 +153,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -195,7 +195,7 @@ Da mesma forma que você utiliza `Body`, `Query`, etc. Como parâmetros de sua *
//// tab | Python 3.10+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -209,7 +209,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -231,7 +231,7 @@ Você **não chama a função** diretamente (não adicione os parênteses no fin
E essa função vai receber os parâmetros da mesma forma que uma *função de operação de rota*.
-/// tip | "Dica"
+/// tip | Dica
Você verá quais outras "coisas", além de funções, podem ser usadas como dependências no próximo capítulo.
@@ -256,7 +256,7 @@ common_parameters --> read_users
Assim, você escreve um código compartilhado apenas uma vez e o **FastAPI** se encarrega de chamá-lo em suas *operações de rota*.
-/// check | "Checando"
+/// check | Checando
Perceba que você não precisa criar uma classe especial e enviar a dependência para algum outro lugar em que o **FastAPI** a "registre" ou realize qualquer operação similar.
@@ -300,7 +300,7 @@ Mas como estamos utilizando `Annotated`, podemos guardar esse valor `Annotated`
////
-/// tip | "Dica"
+/// tip | Dica
Isso é apenas Python padrão, essa funcionalidade é chamada de "type alias", e na verdade não é específica ao **FastAPI**.
@@ -322,7 +322,7 @@ E você pode declarar dependências utilizando `async def` dentro de *funções
Não faz diferença. O **FastAPI** sabe o que fazer.
-/// note | "Nota"
+/// note | Nota
Caso você não conheça, veja em [Async: *"Com Pressa?"*](../../async.md#com-pressa){.internal-link target=_blank} a sessão acerca de `async` e `await` na documentação.
diff --git a/docs/pt/docs/tutorial/dependencies/sub-dependencies.md b/docs/pt/docs/tutorial/dependencies/sub-dependencies.md
index b890fe793..4c0f42dbb 100644
--- a/docs/pt/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/pt/docs/tutorial/dependencies/sub-dependencies.md
@@ -36,7 +36,7 @@ Você pode criar uma primeira dependência (injetável) dessa forma:
//// tab | Python 3.10 non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -50,7 +50,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8 non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -96,7 +96,7 @@ Então, você pode criar uma outra função para uma dependência (um "injetáve
//// tab | Python 3.10 non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -110,7 +110,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8 non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -159,7 +159,7 @@ Então podemos utilizar a dependência com:
//// tab | Python 3.10 non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -173,7 +173,7 @@ Utilize a versão com `Annotated` se possível.
//// tab | Python 3.8 non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -185,7 +185,7 @@ Utilize a versão com `Annotated` se possível.
////
-/// info | "Informação"
+/// info | Informação
Perceba que nós estamos declarando apenas uma dependência na *função de operação de rota*, em `query_or_cookie_extractor`.
@@ -223,7 +223,7 @@ async def needy_dependency(fresh_value: Annotated[str, Depends(get_value, use_ca
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Utilize a versão com `Annotated` se possível.
@@ -244,7 +244,7 @@ Consiste apenas de funções que parecem idênticas a *funções de operação d
Mas ainda assim, é bastante poderoso, e permite que você declare grafos (árvores) de dependências com uma profundidade arbitrária.
-/// tip | "Dica"
+/// tip | Dica
Tudo isso pode não parecer muito útil com esses exemplos.
diff --git a/docs/pt/docs/tutorial/encoder.md b/docs/pt/docs/tutorial/encoder.md
index c8ce77e74..d89c71fc8 100644
--- a/docs/pt/docs/tutorial/encoder.md
+++ b/docs/pt/docs/tutorial/encoder.md
@@ -42,7 +42,7 @@ O resultado de chamar a função é algo que pode ser codificado com o padrão d
A função não retorna um grande `str` contendo os dados no formato JSON (como uma string). Mas sim, retorna uma estrutura de dados padrão do Python (por exemplo, um `dict`) com valores e subvalores compatíveis com JSON.
-/// note | "Nota"
+/// note | Nota
`jsonable_encoder` é realmente usado pelo **FastAPI** internamente para converter dados. Mas também é útil em muitos outros cenários.
diff --git a/docs/pt/docs/tutorial/first-steps.md b/docs/pt/docs/tutorial/first-steps.md
index 4990b5984..f301c18b6 100644
--- a/docs/pt/docs/tutorial/first-steps.md
+++ b/docs/pt/docs/tutorial/first-steps.md
@@ -24,7 +24,7 @@ $ uvicorn main:app --reload
</div>
-/// note | "Nota"
+/// note | Nota
O comando `uvicorn main:app` se refere a:
@@ -139,7 +139,7 @@ Você também pode usá-lo para gerar código automaticamente para clientes que
`FastAPI` é uma classe Python que fornece todas as funcionalidades para sua API.
-/// note | "Detalhes técnicos"
+/// note | Detalhes técnicos
`FastAPI` é uma classe que herda diretamente de `Starlette`.
@@ -205,7 +205,7 @@ https://example.com/items/foo
/items/foo
```
-/// info | "Informação"
+/// info | Informação
Uma "rota" também é comumente chamada de "endpoint".
@@ -259,7 +259,7 @@ O `@app.get("/")` diz ao **FastAPI** que a função logo abaixo é responsável
* a rota `/`
* usando o <abbr title="o método HTTP GET">operador <code>get</code></abbr>
-/// info | "`@decorador`"
+/// info | `@decorador`
Essa sintaxe `@alguma_coisa` em Python é chamada de "decorador".
@@ -286,7 +286,7 @@ E os mais exóticos:
* `@app.patch()`
* `@app.trace()`
-/// tip | "Dica"
+/// tip | Dica
Você está livre para usar cada operação (método HTTP) como desejar.
@@ -324,7 +324,7 @@ Você também pode defini-la como uma função normal em vez de `async def`:
{!../../docs_src/first_steps/tutorial003.py!}
```
-/// note | "Nota"
+/// note | Nota
Se você não sabe a diferença, verifique o [Async: *"Com pressa?"*](../async.md#com-pressa){.internal-link target=_blank}.
diff --git a/docs/pt/docs/tutorial/handling-errors.md b/docs/pt/docs/tutorial/handling-errors.md
index 4a042f219..0d0abbd25 100644
--- a/docs/pt/docs/tutorial/handling-errors.md
+++ b/docs/pt/docs/tutorial/handling-errors.md
@@ -66,7 +66,7 @@ Mas se o cliente faz uma requisição para `http://example.com/items/bar` (ou se
}
```
-/// tip | "Dica"
+/// tip | Dica
Quando você lançar um `HTTPException`, você pode passar qualquer valor convertível em JSON como parâmetro de `detail`, e não apenas `str`.
@@ -109,7 +109,7 @@ Dessa forma você receberá um erro "limpo", com o HTTP status code `418` e um J
{"message": "Oops! yolo did something. There goes a rainbow..."}
```
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
Você também pode usar `from starlette.requests import Request` and `from starlette.responses import JSONResponse`.
@@ -162,7 +162,7 @@ path -> item_id
### `RequestValidationError` vs `ValidationError`
-/// warning | "Aviso"
+/// warning | Aviso
Você pode pular estes detalhes técnicos caso eles não sejam importantes para você neste momento.
@@ -186,7 +186,7 @@ Por exemplo, você pode querer retornar uma *response* em *plain text* ao invés
{!../../docs_src/handling_errors/tutorial004.py!}
```
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
Você pode usar `from starlette.responses import PlainTextResponse`.
diff --git a/docs/pt/docs/tutorial/header-params.md b/docs/pt/docs/tutorial/header-params.md
index f7be2b0b7..ac61d0305 100644
--- a/docs/pt/docs/tutorial/header-params.md
+++ b/docs/pt/docs/tutorial/header-params.md
@@ -44,7 +44,7 @@ O primeiro valor é o valor padrão, você pode passar todas as validações adi
////
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
`Header` é uma classe "irmã" de `Path`, `Query` e `Cookie`. Ela também herda da mesma classe em comum `Param`.
@@ -90,7 +90,7 @@ Se por algum motivo você precisar desabilitar a conversão automática de subli
////
-/// warning | "Aviso"
+/// warning | Aviso
Antes de definir `convert_underscores` como `False`, lembre-se de que alguns proxies e servidores HTTP não permitem o uso de cabeçalhos com sublinhados.
diff --git a/docs/pt/docs/tutorial/index.md b/docs/pt/docs/tutorial/index.md
index a2f380284..4e6293bb0 100644
--- a/docs/pt/docs/tutorial/index.md
+++ b/docs/pt/docs/tutorial/index.md
@@ -52,7 +52,7 @@ $ pip install "fastapi[all]"
...isso também inclui o `uvicorn`, que você pode usar como o servidor que rodará seu código.
-/// note | "Nota"
+/// note | Nota
Você também pode instalar parte por parte.
diff --git a/docs/pt/docs/tutorial/middleware.md b/docs/pt/docs/tutorial/middleware.md
index 35c61d5fc..d1b798356 100644
--- a/docs/pt/docs/tutorial/middleware.md
+++ b/docs/pt/docs/tutorial/middleware.md
@@ -11,7 +11,7 @@ Um "middleware" é uma função que manipula cada **requisição** antes de ser
* Ele pode fazer algo com essa **resposta** ou executar qualquer código necessário.
* Então ele retorna a **resposta**.
-/// note | "Detalhes técnicos"
+/// note | Detalhes técnicos
Se você tiver dependências com `yield`, o código de saída será executado *depois* do middleware.
@@ -35,7 +35,7 @@ A função middleware recebe:
{!../../docs_src/middleware/tutorial001.py!}
```
-/// tip | "Dica"
+/// tip | Dica
Tenha em mente que cabeçalhos proprietários personalizados podem ser adicionados <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers" class="external-link" target="_blank">usando o prefixo 'X-'</a>.
@@ -43,7 +43,7 @@ Mas se você tiver cabeçalhos personalizados desejando que um cliente em um nav
///
-/// note | "Detalhes técnicos"
+/// note | Detalhes técnicos
Você também pode usar `from starlette.requests import Request`.
diff --git a/docs/pt/docs/tutorial/path-operation-configuration.md b/docs/pt/docs/tutorial/path-operation-configuration.md
index 48753d725..5f3cc82fb 100644
--- a/docs/pt/docs/tutorial/path-operation-configuration.md
+++ b/docs/pt/docs/tutorial/path-operation-configuration.md
@@ -2,7 +2,7 @@
Existem vários parâmetros que você pode passar para o seu *decorador de operação de rota* para configurá-lo.
-/// warning | "Aviso"
+/// warning | Aviso
Observe que esses parâmetros são passados diretamente para o *decorador de operação de rota*, não para a sua *função de operação de rota*.
@@ -42,7 +42,7 @@ Mas se você não se lembrar o que cada código numérico significa, pode usar a
Esse código de status será usado na resposta e será adicionado ao esquema OpenAPI.
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
Você também poderia usar `from starlette import status`.
@@ -185,7 +185,7 @@ Você pode especificar a descrição da resposta com o parâmetro `response_desc
////
-/// info | "Informação"
+/// info | Informação
Note que `response_description` se refere especificamente à resposta, a `description` se refere à *operação de rota* em geral.
diff --git a/docs/pt/docs/tutorial/path-params-numeric-validations.md b/docs/pt/docs/tutorial/path-params-numeric-validations.md
index 28c55482f..3361f86c5 100644
--- a/docs/pt/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/pt/docs/tutorial/path-params-numeric-validations.md
@@ -44,7 +44,7 @@ Por exemplo para declarar um valor de metadado `title` para o parâmetro de rota
////
-/// note | "Nota"
+/// note | Nota
Um parâmetro de rota é sempre obrigatório, como se fizesse parte da rota.
@@ -132,7 +132,7 @@ E você também pode declarar validações numéricas:
* `lt`: menor que (`l`ess `t`han)
* `le`: menor que ou igual (`l`ess than or `e`qual)
-/// info | "Informação"
+/// info | Informação
`Query`, `Path` e outras classes que você verá a frente são subclasses de uma classe comum `Param`.
@@ -140,7 +140,7 @@ Todas elas compartilham os mesmos parâmetros para validação adicional e metad
///
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
Quando você importa `Query`, `Path` e outras de `fastapi`, elas são na verdade funções.
diff --git a/docs/pt/docs/tutorial/path-params.md b/docs/pt/docs/tutorial/path-params.md
index a68354a1b..64f8a0253 100644
--- a/docs/pt/docs/tutorial/path-params.md
+++ b/docs/pt/docs/tutorial/path-params.md
@@ -24,7 +24,7 @@ Você pode declarar o tipo de um parâmetro na função usando as anotações pa
Nesse caso, `item_id` está sendo declarado como um `int`.
-/// check | "Verifique"
+/// check | Verifique
@@ -40,7 +40,7 @@ Se você rodar esse exemplo e abrir o seu navegador em <a href="http://127.0.0.1
{"item_id":3}
```
-/// check | "Verifique"
+/// check | Verifique
@@ -73,7 +73,7 @@ devido ao parâmetro da rota `item_id` ter um valor `"foo"`, que não é um `int
O mesmo erro apareceria se você tivesse fornecido um `float` ao invés de um `int`, como em: <a href="http://127.0.0.1:8000/items/4.2" class="external-link" target="_blank">http://127.0.0.1:8000/items/4.2</a>
-/// check | "Verifique"
+/// check | Verifique
@@ -91,7 +91,7 @@ Quando você abrir o seu navegador em <a href="http://127.0.0.1:8000/docs" class
<img src="/img/tutorial/path-params/image01.png">
-/// check | "Verifique"
+/// check | Verifique
@@ -151,13 +151,13 @@ Assim, crie atributos de classe com valores fixos, que serão os valores válido
{!../../docs_src/path_params/tutorial005.py!}
```
-/// info | "informação"
+/// info | informação
<a href="https://docs.python.org/3/library/enum.html" class="external-link" target="_blank">Enumerations (ou enums) estão disponíveis no Python</a> desde a versão 3.4.
///
-/// tip | "Dica"
+/// tip | Dica
@@ -199,7 +199,7 @@ Você pode ter o valor exato de enumerate (um `str` nesse caso) usando `model_na
{!../../docs_src/path_params/tutorial005.py!}
```
-/// tip | "Dica"
+/// tip | Dica
@@ -258,7 +258,7 @@ Então, você poderia usar ele com:
{!../../docs_src/path_params/tutorial004.py!}
```
-/// tip | "Dica"
+/// tip | Dica
diff --git a/docs/pt/docs/tutorial/query-params-str-validations.md b/docs/pt/docs/tutorial/query-params-str-validations.md
index e6dcf748e..2fa0eeba0 100644
--- a/docs/pt/docs/tutorial/query-params-str-validations.md
+++ b/docs/pt/docs/tutorial/query-params-str-validations.md
@@ -10,7 +10,7 @@ Vamos utilizar essa aplicação como exemplo:
O parâmetro de consulta `q` é do tipo `Union[str, None]`, o que significa que é do tipo `str` mas que também pode ser `None`, e de fato, o valor padrão é `None`, então o FastAPI saberá que não é obrigatório.
-/// note | "Observação"
+/// note | Observação
O FastAPI saberá que o valor de `q` não é obrigatório por causa do valor padrão `= None`.
@@ -54,7 +54,7 @@ q: Union[str, None] = None
Mas o declara explicitamente como um parâmetro de consulta.
-/// info | "Informação"
+/// info | Informação
Tenha em mente que o FastAPI se preocupa com a parte:
@@ -118,7 +118,7 @@ Vamos dizer que você queira que o parâmetro de consulta `q` tenha um `min_leng
{!../../docs_src/query_params_str_validations/tutorial005.py!}
```
-/// note | "Observação"
+/// note | Observação
O parâmetro torna-se opcional quando possui um valor padrão.
@@ -150,7 +150,7 @@ Então, quando você precisa declarar um parâmetro obrigatório utilizando o `Q
{!../../docs_src/query_params_str_validations/tutorial006.py!}
```
-/// info | "Informação"
+/// info | Informação
Se você nunca viu os `...` antes: é um valor único especial, faz <a href="https://docs.python.org/3/library/constants.html#Ellipsis" class="external-link" target="_blank">parte do Python e é chamado "Ellipsis"</a>.
@@ -187,7 +187,7 @@ Assim, a resposta para essa URL seria:
}
```
-/// tip | "Dica"
+/// tip | Dica
Para declarar um parâmetro de consulta com o tipo `list`, como no exemplo acima, você precisa usar explicitamente o `Query`, caso contrário será interpretado como um corpo da requisição.
@@ -230,7 +230,7 @@ Você também pode utilizar o tipo `list` diretamente em vez de `List[str]`:
{!../../docs_src/query_params_str_validations/tutorial013.py!}
```
-/// note | "Observação"
+/// note | Observação
Tenha em mente que neste caso, o FastAPI não irá validar os conteúdos da lista.
@@ -244,7 +244,7 @@ Você pode adicionar mais informações sobre o parâmetro.
Essa informações serão inclusas no esquema do OpenAPI e utilizado pela documentação interativa e ferramentas externas.
-/// note | "Observação"
+/// note | Observação
Tenha em mente que cada ferramenta oferece diferentes níveis de suporte ao OpenAPI.
diff --git a/docs/pt/docs/tutorial/query-params.md b/docs/pt/docs/tutorial/query-params.md
index 6e6699cd5..89b951de6 100644
--- a/docs/pt/docs/tutorial/query-params.md
+++ b/docs/pt/docs/tutorial/query-params.md
@@ -81,7 +81,7 @@ Da mesma forma, você pode declarar parâmetros de consulta opcionais, definindo
Nesse caso, o parâmetro da função `q` será opcional, e `None` será o padrão.
-/// check | "Verificar"
+/// check | Verificar
Você também pode notar que o **FastAPI** é esperto o suficiente para perceber que o parâmetro da rota `item_id` é um parâmetro da rota, e `q` não é, portanto, `q` é o parâmetro de consulta.
@@ -239,7 +239,7 @@ Nesse caso, existem 3 parâmetros de consulta:
* `skip`, um `int` com o valor padrão `0`.
* `limit`, um `int` opcional.
-/// tip | "Dica"
+/// tip | Dica
Você também poderia usar `Enum` da mesma forma que com [Path Parameters](path-params.md#valores-predefinidos){.internal-link target=_blank}.
diff --git a/docs/pt/docs/tutorial/request-files.md b/docs/pt/docs/tutorial/request-files.md
index d230f1feb..c22c1c513 100644
--- a/docs/pt/docs/tutorial/request-files.md
+++ b/docs/pt/docs/tutorial/request-files.md
@@ -103,7 +103,7 @@ Quando você usa os métodos `async`, o **FastAPI** executa os métodos de arqui
///
-/// note | "Detalhes Técnicos do Starlette"
+/// note | Detalhes Técnicos do Starlette
O `UploadFile` do ***FastAPI** herda diretamente do `UploadFile` do **Starlette** , mas adiciona algumas partes necessárias para torná-lo compatível com o **Pydantic** e as outras partes do FastAPI.
@@ -115,7 +115,7 @@ O jeito que os formulários HTML (`<form></form>`) enviam os dados para o servid
**FastAPI** se certificará de ler esses dados do lugar certo, ao invés de JSON.
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
Dados de formulários normalmente são codificados usando o "media type" (tipo de mídia) `application/x-www-form-urlencoded` quando não incluem arquivos.
@@ -157,7 +157,7 @@ Para usar isso, declare uma lista de `bytes` ou `UploadFile`:
Você receberá, tal como declarado, uma `list` de `bytes` ou `UploadFile`.
-/// note | "Detalhes Técnicos"
+/// note | Detalhes Técnicos
Você pode também pode usar `from starlette.responses import HTMLResponse`.
diff --git a/docs/pt/docs/tutorial/request-form-models.md b/docs/pt/docs/tutorial/request-form-models.md
index 837e24c34..7128a0ae2 100644
--- a/docs/pt/docs/tutorial/request-form-models.md
+++ b/docs/pt/docs/tutorial/request-form-models.md
@@ -2,7 +2,7 @@
Você pode utilizar **Modelos Pydantic** para declarar **campos de formulários** no FastAPI.
-/// info | "Informação"
+/// info | Informação
Para utilizar formulários, instale primeiramente o <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
@@ -14,7 +14,7 @@ $ pip install python-multipart
///
-/// note | "Nota"
+/// note | Nota
Isto é suportado desde a versão `0.113.0` do FastAPI. 🤓
@@ -42,7 +42,7 @@ Você precisa apenas declarar um **modelo Pydantic** com os campos que deseja re
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Prefira utilizar a versão `Annotated` se possível.
@@ -68,7 +68,7 @@ Você pode verificar na UI de documentação em `/docs`:
Em alguns casos de uso especiais (provavelmente não muito comum), você pode desejar **restringir** os campos do formulário para aceitar apenas os declarados no modelo Pydantic. E **proibir** qualquer campo **extra**.
-/// note | "Nota"
+/// note | Nota
Isso é suportado deste a versão `0.114.0` do FastAPI. 🤓
diff --git a/docs/pt/docs/tutorial/request-forms-and-files.md b/docs/pt/docs/tutorial/request-forms-and-files.md
index 29488b4f2..77c099eb3 100644
--- a/docs/pt/docs/tutorial/request-forms-and-files.md
+++ b/docs/pt/docs/tutorial/request-forms-and-files.md
@@ -2,7 +2,7 @@
Você pode definir arquivos e campos de formulário ao mesmo tempo usando `File` e `Form`.
-/// info | "Informação"
+/// info | Informação
Para receber arquivos carregados e/ou dados de formulário, primeiro instale <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
@@ -28,7 +28,7 @@ Os arquivos e campos de formulário serão carregados como dados de formulário
E você pode declarar alguns dos arquivos como `bytes` e alguns como `UploadFile`.
-/// warning | "Aviso"
+/// warning | Aviso
Você pode declarar vários parâmetros `File` e `Form` em uma *operação de caminho*, mas não é possível declarar campos `Body` para receber como JSON, pois a requisição terá o corpo codificado usando `multipart/form-data` ao invés de `application/json`.
diff --git a/docs/pt/docs/tutorial/request-forms.md b/docs/pt/docs/tutorial/request-forms.md
index 1e2faf269..367fca072 100644
--- a/docs/pt/docs/tutorial/request-forms.md
+++ b/docs/pt/docs/tutorial/request-forms.md
@@ -2,7 +2,7 @@
Quando você precisar receber campos de formulário ao invés de JSON, você pode usar `Form`.
-/// info | "Informação"
+/// info | Informação
Para usar formulários, primeiro instale <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
@@ -32,13 +32,13 @@ A <abbr title="especificação">spec</abbr> exige que os campos sejam exatamente
Com `Form` você pode declarar os mesmos metadados e validação que com `Body` (e `Query`, `Path`, `Cookie`).
-/// info | "Informação"
+/// info | Informação
`Form` é uma classe que herda diretamente de `Body`.
///
-/// tip | "Dica"
+/// tip | Dica
Para declarar corpos de formulário, você precisa usar `Form` explicitamente, porque sem ele os parâmetros seriam interpretados como parâmetros de consulta ou parâmetros de corpo (JSON).
@@ -50,7 +50,7 @@ A forma como os formulários HTML (`<form></form>`) enviam os dados para o servi
O **FastAPI** fará a leitura desses dados no lugar certo em vez de JSON.
-/// note | "Detalhes técnicos"
+/// note | Detalhes técnicos
Os dados dos formulários são normalmente codificados usando o "tipo de mídia" `application/x-www-form-urlencoded`.
@@ -60,7 +60,7 @@ Se você quiser ler mais sobre essas codificações e campos de formulário, vá
///
-/// warning | "Aviso"
+/// warning | Aviso
Você pode declarar vários parâmetros `Form` em uma *operação de caminho*, mas não pode declarar campos `Body` que espera receber como JSON, pois a solicitação terá o corpo codificado usando `application/x-www- form-urlencoded` em vez de `application/json`.
diff --git a/docs/pt/docs/tutorial/response-status-code.md b/docs/pt/docs/tutorial/response-status-code.md
index bc4a2cd34..2c8924925 100644
--- a/docs/pt/docs/tutorial/response-status-code.md
+++ b/docs/pt/docs/tutorial/response-status-code.md
@@ -12,7 +12,7 @@ Da mesma forma que você pode especificar um modelo de resposta, você também p
{!../../docs_src/response_status_code/tutorial001.py!}
```
-/// note | "Nota"
+/// note | Nota
Observe que `status_code` é um parâmetro do método "decorador" (get, post, etc). Não da sua função de *operação de caminho*, como todos os parâmetros e corpo.
@@ -20,7 +20,7 @@ Observe que `status_code` é um parâmetro do método "decorador" (get, post, et
O parâmetro `status_code` recebe um número com o código de status HTTP.
-/// info | "Informação"
+/// info | Informação
`status_code` também pode receber um `IntEnum`, como o do Python <a href="https://docs.python.org/3/library/http.html#http.HTTPStatus" class="external-link" target="_blank">`http.HTTPStatus`</a>.
@@ -33,7 +33,7 @@ Dessa forma:
<img src="/img/tutorial/response-status-code/image01.png">
-/// note | "Nota"
+/// note | Nota
Alguns códigos de resposta (consulte a próxima seção) indicam que a resposta não possui um corpo.
@@ -43,7 +43,7 @@ O FastAPI sabe disso e produzirá documentos OpenAPI informando que não há cor
## Sobre os códigos de status HTTP
-/// note | "Nota"
+/// note | Nota
Se você já sabe o que são códigos de status HTTP, pule para a próxima seção.
@@ -67,7 +67,7 @@ Resumidamente:
* Para erros genéricos do cliente, você pode usar apenas `400`.
* `500` e acima são para erros do servidor. Você quase nunca os usa diretamente. Quando algo der errado em alguma parte do código do seu aplicativo ou servidor, ele retornará automaticamente um desses códigos de status.
-/// tip | "Dica"
+/// tip | Dica
Para saber mais sobre cada código de status e qual código serve para quê, verifique o <a href="https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Status" class="external-link" target="_blank"><abbr title="Mozilla Developer Network">MDN</abbr> documentação sobre códigos de status HTTP</a>.
@@ -95,7 +95,7 @@ Eles são apenas uma conveniência, eles possuem o mesmo número, mas dessa form
<img src="/img/tutorial/response-status-code/image02.png">
-/// note | "Detalhes técnicos"
+/// note | Detalhes técnicos
Você também pode usar `from starlette import status`.
diff --git a/docs/pt/docs/tutorial/schema-extra-example.md b/docs/pt/docs/tutorial/schema-extra-example.md
index 2d78e4ef1..dd95d4c7d 100644
--- a/docs/pt/docs/tutorial/schema-extra-example.md
+++ b/docs/pt/docs/tutorial/schema-extra-example.md
@@ -14,7 +14,7 @@ Você pode declarar um `example` para um modelo Pydantic usando `Config` e `sche
Essas informações extras serão adicionadas como se encontram no **JSON Schema** de resposta desse modelo e serão usadas na documentação da API.
-/// tip | "Dica"
+/// tip | Dica
Você pode usar a mesma técnica para estender o JSON Schema e adicionar suas próprias informações extras de forma personalizada.
@@ -32,7 +32,7 @@ Você pode usar isso para adicionar um `example` para cada campo:
{!../../docs_src/schema_extra_example/tutorial002.py!}
```
-/// warning | "Atenção"
+/// warning | Atenção
Lembre-se de que esses argumentos extras passados não adicionarão nenhuma validação, apenas informações extras, para fins de documentação.
@@ -91,7 +91,7 @@ Com `examples` adicionado a `Body()`, os `/docs` vão ficar assim:
## Detalhes técnicos
-/// warning | "Atenção"
+/// warning | Atenção
Esses são detalhes muito técnicos sobre os padrões **JSON Schema** e **OpenAPI**.
diff --git a/docs/pt/docs/tutorial/security/first-steps.md b/docs/pt/docs/tutorial/security/first-steps.md
index 9fb94fe67..02871c90a 100644
--- a/docs/pt/docs/tutorial/security/first-steps.md
+++ b/docs/pt/docs/tutorial/security/first-steps.md
@@ -25,7 +25,7 @@ Copie o exemplo em um arquivo `main.py`:
## Execute-o
-/// info | "informação"
+/// info | informação
@@ -57,7 +57,7 @@ Você verá algo deste tipo:
<img src="/img/tutorial/security/image01.png">
-/// check | "Botão de Autorizar!"
+/// check | Botão de Autorizar!
@@ -71,7 +71,7 @@ E se você clicar, você terá um pequeno formulário de autorização para digi
<img src="/img/tutorial/security/image02.png">
-/// note | "Nota"
+/// note | Nota
@@ -119,7 +119,7 @@ Então, vamos rever de um ponto de vista simplificado:
Neste exemplo, nós vamos usar o **OAuth2** com o fluxo de **Senha**, usando um token **Bearer**. Fazemos isso usando a classe `OAuth2PasswordBearer`.
-/// info | "informação"
+/// info | informação
@@ -139,7 +139,7 @@ Quando nós criamos uma instância da classe `OAuth2PasswordBearer`, nós passam
{!../../docs_src/security/tutorial001.py!}
```
-/// tip | "Dica"
+/// tip | Dica
@@ -155,7 +155,7 @@ Esse parâmetro não cria um endpoint / *path operation*, mas declara que a URL
Em breve também criaremos o atual path operation.
-/// info | "informação"
+/// info | informação
@@ -187,7 +187,7 @@ Esse dependência vai fornecer uma `str` que é atribuído ao parâmetro `token
A **FastAPI** saberá que pode usar essa dependência para definir um "esquema de segurança" no esquema da OpenAPI (e na documentação da API automática).
-/// info | "Detalhes técnicos"
+/// info | Detalhes técnicos
diff --git a/docs/pt/docs/tutorial/security/index.md b/docs/pt/docs/tutorial/security/index.md
index 2f23aa47e..b4440ec04 100644
--- a/docs/pt/docs/tutorial/security/index.md
+++ b/docs/pt/docs/tutorial/security/index.md
@@ -32,7 +32,7 @@ Não é muito popular ou usado nos dias atuais.
OAuth2 não especifica como criptografar a comunicação, ele espera que você tenha sua aplicação em um servidor HTTPS.
-/// tip | "Dica"
+/// tip | Dica
Na seção sobre **deployment** você irá ver como configurar HTTPS de modo gratuito, usando Traefik e Let’s Encrypt.
@@ -89,7 +89,7 @@ OpenAPI define os seguintes esquemas de segurança:
* Essa descoberta automática é o que é definido na especificação OpenID Connect.
-/// tip | "Dica"
+/// tip | Dica
Integração com outros provedores de autenticação/autorização como Google, Facebook, Twitter, GitHub, etc. é bem possível e relativamente fácil.
diff --git a/docs/pt/docs/tutorial/static-files.md b/docs/pt/docs/tutorial/static-files.md
index 901fca1d2..aba4b8221 100644
--- a/docs/pt/docs/tutorial/static-files.md
+++ b/docs/pt/docs/tutorial/static-files.md
@@ -11,7 +11,7 @@ Você pode servir arquivos estáticos automaticamente de um diretório usando `S
{!../../docs_src/static_files/tutorial001.py!}
```
-/// note | "Detalhes técnicos"
+/// note | Detalhes técnicos
Você também pode usar `from starlette.staticfiles import StaticFiles`.
diff --git a/docs/pt/docs/tutorial/testing.md b/docs/pt/docs/tutorial/testing.md
index 4e28a43c0..4f8eaa299 100644
--- a/docs/pt/docs/tutorial/testing.md
+++ b/docs/pt/docs/tutorial/testing.md
@@ -8,7 +8,7 @@ Com ele, você pode usar o <a href="https://docs.pytest.org/" class="external-li
## Usando `TestClient`
-/// info | "Informação"
+/// info | Informação
Para usar o `TestClient`, primeiro instale o <a href="https://www.python-httpx.org" class="external-link" target="_blank">`httpx`</a>.
@@ -34,7 +34,7 @@ Escreva instruções `assert` simples com as expressões Python padrão que voc
{!../../docs_src/app_testing/tutorial001.py!}
```
-/// tip | "Dica"
+/// tip | Dica
Observe que as funções de teste são `def` normais, não `async def`.
@@ -44,7 +44,7 @@ Isso permite que você use `pytest` diretamente sem complicações.
///
-/// note | "Detalhes técnicos"
+/// note | Detalhes técnicos
Você também pode usar `from starlette.testclient import TestClient`.
@@ -52,7 +52,7 @@ Você também pode usar `from starlette.testclient import TestClient`.
///
-/// tip | "Dica"
+/// tip | Dica
Se você quiser chamar funções `async` em seus testes além de enviar solicitações ao seu aplicativo FastAPI (por exemplo, funções de banco de dados assíncronas), dê uma olhada em [Testes assíncronos](../advanced/async-tests.md){.internal-link target=_blank} no tutorial avançado.
@@ -152,7 +152,7 @@ Ambas as *operações de rotas* requerem um cabeçalho `X-Token`.
//// tab | Python 3.10+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Prefira usar a versão `Annotated` se possível.
@@ -166,7 +166,7 @@ Prefira usar a versão `Annotated` se possível.
//// tab | Python 3.8+ non-Annotated
-/// tip | "Dica"
+/// tip | Dica
Prefira usar a versão `Annotated` se possível.
@@ -200,7 +200,7 @@ Por exemplo:
Para mais informações sobre como passar dados para o backend (usando `httpx` ou `TestClient`), consulte a <a href="https://www.python-httpx.org" class="external-link" target="_blank">documentação do HTTPX</a>.
-/// info | "Informação"
+/// info | Informação
Observe que o `TestClient` recebe dados que podem ser convertidos para JSON, não para modelos Pydantic.
diff --git a/docs/pt/docs/virtual-environments.md b/docs/pt/docs/virtual-environments.md
index 863c8d65e..5fc1a8866 100644
--- a/docs/pt/docs/virtual-environments.md
+++ b/docs/pt/docs/virtual-environments.md
@@ -2,13 +2,13 @@
Ao trabalhar em projetos Python, você provavelmente deve usar um **ambiente virtual** (ou um mecanismo similar) para isolar os pacotes que você instala para cada projeto.
-/// info | "Informação"
+/// info | Informação
Se você já sabe sobre ambientes virtuais, como criá-los e usá-los, talvez seja melhor pular esta seção. 🤓
///
-/// tip | "Dica"
+/// tip | Dica
Um **ambiente virtual** é diferente de uma **variável de ambiente**.
@@ -18,7 +18,7 @@ Um **ambiente virtual** é um diretório com alguns arquivos.
///
-/// info | "Informação"
+/// info | Informação
Esta página lhe ensinará como usar **ambientes virtuais** e como eles funcionam.
@@ -55,7 +55,7 @@ $ cd awesome-project
Ao começar a trabalhar em um projeto Python **pela primeira vez**, crie um ambiente virtual **<abbr title="existem outras opções, esta é uma diretriz simples">dentro do seu projeto</abbr>**.
-/// tip | "Dica"
+/// tip | Dica
Você só precisa fazer isso **uma vez por projeto**, não toda vez que trabalhar.
@@ -96,7 +96,7 @@ $ uv venv
</div>
-/// tip | "Dica"
+/// tip | Dica
Por padrão, `uv` criará um ambiente virtual em um diretório chamado `.venv`.
@@ -118,7 +118,7 @@ Você pode criar o ambiente virtual em um diretório diferente, mas há uma conv
Ative o novo ambiente virtual para que qualquer comando Python que você executar ou pacote que você instalar o utilize.
-/// tip | "Dica"
+/// tip | Dica
Faça isso **toda vez** que iniciar uma **nova sessão de terminal** para trabalhar no projeto.
@@ -162,7 +162,7 @@ $ source .venv/Scripts/activate
////
-/// tip | "Dica"
+/// tip | Dica
Toda vez que você instalar um **novo pacote** naquele ambiente, **ative** o ambiente novamente.
@@ -174,7 +174,7 @@ Isso garante que, se você usar um **programa de terminal (<abbr title="interfac
Verifique se o ambiente virtual está ativo (o comando anterior funcionou).
-/// tip | "Dica"
+/// tip | Dica
Isso é **opcional**, mas é uma boa maneira de **verificar** se tudo está funcionando conforme o esperado e se você está usando o ambiente virtual pretendido.
@@ -214,7 +214,7 @@ Se ele mostrar o binário `python` em `.venv\Scripts\python`, dentro do seu proj
## Atualizar `pip`
-/// tip | "Dica"
+/// tip | Dica
Se você usar <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a>, você o usará para instalar coisas em vez do `pip`, então não precisará atualizar o `pip`. 😎
@@ -224,7 +224,7 @@ Se você estiver usando `pip` para instalar pacotes (ele vem por padrão com o P
Muitos erros exóticos durante a instalação de um pacote são resolvidos apenas atualizando o `pip` primeiro.
-/// tip | "Dica"
+/// tip | Dica
Normalmente, você faria isso **uma vez**, logo após criar o ambiente virtual.
@@ -246,13 +246,13 @@ $ python -m pip install --upgrade pip
Se você estiver usando **Git** (você deveria), adicione um arquivo `.gitignore` para excluir tudo em seu `.venv` do Git.
-/// tip | "Dica"
+/// tip | Dica
Se você usou <a href="https://github.com/astral-sh/uv" class="external-link" target="_blank">`uv`</a> para criar o ambiente virtual, ele já fez isso para você, você pode pular esta etapa. 😎
///
-/// tip | "Dica"
+/// tip | Dica
Faça isso **uma vez**, logo após criar o ambiente virtual.
@@ -286,7 +286,7 @@ Esse comando criará um arquivo `.gitignore` com o conteúdo:
Após ativar o ambiente, você pode instalar pacotes nele.
-/// tip | "Dica"
+/// tip | Dica
Faça isso **uma vez** ao instalar ou atualizar os pacotes que seu projeto precisa.
@@ -298,7 +298,7 @@ Se precisar atualizar uma versão ou adicionar um novo pacote, você **fará iss
Se estiver com pressa e não quiser usar um arquivo para declarar os requisitos de pacote do seu projeto, você pode instalá-los diretamente.
-/// tip | "Dica"
+/// tip | Dica
É uma (muito) boa ideia colocar os pacotes e versões que seu programa precisa em um arquivo (por exemplo `requirements.txt` ou `pyproject.toml`).
@@ -399,7 +399,7 @@ Por exemplo:
* <a href="https://code.visualstudio.com/docs/python/environments#_select-and-activate-an-environment" class="external-link" target="_blank">VS Code</a>
* <a href="https://www.jetbrains.com/help/pycharm/creating-virtual-environment.html" class="external-link" target="_blank">PyCharm</a>
-/// tip | "Dica"
+/// tip | Dica
Normalmente, você só precisa fazer isso **uma vez**, ao criar o ambiente virtual.
@@ -425,7 +425,7 @@ Agora você está pronto para começar a trabalhar no seu projeto.
-/// tip | "Dica"
+/// tip | Dica
Você quer entender o que é tudo isso acima?
@@ -516,7 +516,7 @@ flowchart LR
end
```
-/// tip | "Dica"
+/// tip | Dica
É muito comum em pacotes Python tentar ao máximo **evitar alterações drásticas** em **novas versões**, mas é melhor prevenir do que remediar e instalar versões mais recentes intencionalmente e, quando possível, executar os testes para verificar se tudo está funcionando corretamente.
@@ -623,7 +623,7 @@ Esse comando criará ou modificará algumas [variáveis de ambiente](envir
Uma dessas variáveis é a variável `PATH`.
-/// tip | "Dica"
+/// tip | Dica
Você pode aprender mais sobre a variável de ambiente `PATH` na seção [Variáveis de ambiente](environment-variables.md#path-environment-variable){.internal-link target=_blank}.
@@ -756,7 +756,7 @@ A parte mais importante é que quando você chama ``python`, esse é exatamente
Assim, você pode confirmar se está no ambiente virtual correto.
-/// tip | "Dica"
+/// tip | Dica
É fácil ativar um ambiente virtual, obter um Python e então **ir para outro projeto**.
diff --git a/docs/ru/docs/alternatives.md b/docs/ru/docs/alternatives.md
index f83024ad9..3c5147e79 100644
--- a/docs/ru/docs/alternatives.md
+++ b/docs/ru/docs/alternatives.md
@@ -33,14 +33,14 @@ DRF использовался многими компаниями, включа
Это был один из первых примеров **автоматического документирования API** и это была одна из первых идей, вдохновивших на создание **FastAPI**.
-/// note | "Заметка"
+/// note | Заметка
Django REST Framework был создан Tom Christie.
Он же создал Starlette и Uvicorn, на которых основан **FastAPI**.
///
-/// check | "Идея для **FastAPI**"
+/// check | Идея для **FastAPI**
Должно быть автоматическое создание документации API с пользовательским веб-интерфейсом.
@@ -62,7 +62,7 @@ Flask часто используется и для приложений, кот
Простота Flask, показалась мне подходящей для создания API.
Но ещё нужно было найти "Django REST Framework" для Flask.
-/// check | "Идеи для **FastAPI**"
+/// check | Идеи для **FastAPI**
Это будет микрофреймворк. К нему легко будет добавить необходимые инструменты и части.
@@ -108,7 +108,7 @@ def read_url():
Глядите, как похоже `requests.get(...)` и `@app.get(...)`.
-/// check | "Идеи для **FastAPI**"
+/// check | Идеи для **FastAPI**
* Должен быть простой и понятный API.
* Нужно использовать названия HTTP-методов (операций) для упрощения понимания происходящего.
@@ -129,7 +129,7 @@ def read_url():
Вот почему, когда говорят о версии 2.0, обычно говорят "Swagger", а для версии 3+ "OpenAPI".
-/// check | "Идеи для **FastAPI**"
+/// check | Идеи для **FastAPI**
Использовать открытые стандарты для спецификаций API вместо самодельных схем.
@@ -165,7 +165,7 @@ def read_url():
Итак, чтобы определить каждую <abbr title="Формат данных">схему</abbr>,
Вам нужно использовать определенные утилиты и классы, предоставляемые Marshmallow.
-/// check | "Идея для **FastAPI**"
+/// check | Идея для **FastAPI**
Использовать код программы для автоматического создания "схем", определяющих типы данных и их проверку.
@@ -181,13 +181,13 @@ Webargs - это инструмент, который был создан для
Это превосходный инструмент и я тоже часто пользовался им до **FastAPI**.
-/// info | "Информация"
+/// info | Информация
Webargs бы создан разработчиками Marshmallow.
///
-/// check | "Идея для **FastAPI**"
+/// check | Идея для **FastAPI**
Должна быть автоматическая проверка входных данных.
@@ -212,13 +212,13 @@ Marshmallow и Webargs осуществляют проверку, анализ
Редактор кода не особо может помочь в такой парадигме.
А изменив какие-то параметры или схемы для Marshmallow можно забыть отредактировать докстринг с YAML и сгенерированная схема становится недействительной.
-/// info | "Информация"
+/// info | Информация
APISpec тоже был создан авторами Marshmallow.
///
-/// check | "Идея для **FastAPI**"
+/// check | Идея для **FastAPI**
Необходима поддержка открытого стандарта для API - OpenAPI.
@@ -246,13 +246,13 @@ APISpec тоже был создан авторами Marshmallow.
Эти генераторы проектов также стали основой для [Генераторов проектов с **FastAPI**](project-generation.md){.internal-link target=_blank}.
-/// info | "Информация"
+/// info | Информация
Как ни странно, но Flask-apispec тоже создан авторами Marshmallow.
///
-/// check | "Идея для **FastAPI**"
+/// check | Идея для **FastAPI**
Схема OpenAPI должна создаваться автоматически и использовать тот же код, который осуществляет сериализацию и проверку данных.
@@ -276,7 +276,7 @@ APISpec тоже был создан авторами Marshmallow.
Кроме того, он не очень хорошо справляется с вложенными моделями.
Если в запросе имеется объект JSON, внутренние поля которого, в свою очередь, являются вложенными объектами JSON, это не может быть должным образом задокументировано и проверено.
-/// check | "Идеи для **FastAPI** "
+/// check | Идеи для **FastAPI**
Нужно использовать подсказки типов, чтоб воспользоваться поддержкой редактора кода.
@@ -289,7 +289,7 @@ APISpec тоже был создан авторами Marshmallow.
Sanic был одним из первых чрезвычайно быстрых Python-фреймворков основанных на `asyncio`.
Он был сделан очень похожим на Flask.
-/// note | "Технические детали"
+/// note | Технические детали
В нём использован <a href="https://github.com/MagicStack/uvloop" class="external-link" target="_blank">`uvloop`</a> вместо стандартного цикла событий `asyncio`, что и сделало его таким быстрым.
@@ -297,7 +297,7 @@ Sanic был одним из первых чрезвычайно быстрых
///
-/// check | "Идеи для **FastAPI**"
+/// check | Идеи для **FastAPI**
Должна быть сумасшедшая производительность.
@@ -318,7 +318,7 @@ Falcon - ещё один высокопроизводительный Python-ф
Либо эти функции должны быть встроены во фреймворк, сконструированный поверх Falcon, как в Hug.
Такая же особенность присутствует и в других фреймворках, вдохновлённых идеей Falcon, использовать только один объект запроса и один объект ответа.
-/// check | "Идея для **FastAPI**"
+/// check | Идея для **FastAPI**
Найдите способы добиться отличной производительности.
@@ -348,7 +348,7 @@ Molten мне попался на начальной стадии написан
Это больше похоже на Django, чем на Flask и Starlette.
Он разделяет в коде вещи, которые довольно тесно связаны.
-/// check | "Идея для **FastAPI**"
+/// check | Идея для **FastAPI**
Определить дополнительные проверки типов данных, используя значения атрибутов модели "по умолчанию".
Это улучшает помощь редактора и раньше это не было доступно в Pydantic.
@@ -374,13 +374,13 @@ Hug был одним из первых фреймворков, реализов
Поскольку он основан на WSGI, старом стандарте для синхронных веб-фреймворков, он не может работать с веб-сокетами и другими модными штуками, но всё равно обладает высокой производительностью.
-/// info | "Информация"
+/// info | Информация
Hug создан Timothy Crosley, автором <a href="https://github.com/timothycrosley/isort" class="external-link" target="_blank">`isort`</a>, отличного инструмента для автоматической сортировки импортов в Python-файлах.
///
-/// check | "Идеи для **FastAPI**"
+/// check | Идеи для **FastAPI**
Hug повлиял на создание некоторых частей APIStar и был одним из инструментов, которые я счел наиболее многообещающими, наряду с APIStar.
@@ -418,7 +418,7 @@ Hug вдохновил **FastAPI** объявить параметр `ответ
Ныне APIStar - это набор инструментов для проверки спецификаций OpenAPI.
-/// info | "Информация"
+/// info | Информация
APIStar был создан Tom Christie. Тот самый парень, который создал:
@@ -428,7 +428,7 @@ APIStar был создан Tom Christie. Тот самый парень, кот
///
-/// check | "Идеи для **FastAPI**"
+/// check | Идеи для **FastAPI**
Воплощение.
@@ -452,7 +452,7 @@ Pydantic - это библиотека для валидации данных,
Его можно сравнить с Marshmallow, хотя в бенчмарках Pydantic быстрее, чем Marshmallow.
И он основан на тех же подсказках типов, которые отлично поддерживаются редакторами кода.
-/// check | "**FastAPI** использует Pydantic"
+/// check | **FastAPI** использует Pydantic
Для проверки данных, сериализации данных и автоматической документации моделей (на основе JSON Schema).
@@ -488,7 +488,7 @@ Starlette обеспечивает весь функционал микрофр
**FastAPI** добавляет эти функции используя подсказки типов Python и Pydantic.
Ещё **FastAPI** добавляет систему внедрения зависимостей, утилиты безопасности, генерацию схемы OpenAPI и т.д.
-/// note | "Технические детали"
+/// note | Технические детали
ASGI - это новый "стандарт" разработанный участниками команды Django.
Он пока что не является "стандартом в Python" (то есть принятым PEP), но процесс принятия запущен.
@@ -498,7 +498,7 @@ ASGI - это новый "стандарт" разработанный учас
///
-/// check | "**FastAPI** использует Starlette"
+/// check | **FastAPI** использует Starlette
В качестве ядра веб-сервиса для обработки запросов, добавив некоторые функции сверху.
@@ -518,7 +518,7 @@ Uvicorn является сервером, а не фреймворком.
Он рекомендуется в качестве сервера для Starlette и **FastAPI**.
-/// check | "**FastAPI** рекомендует его"
+/// check | **FastAPI** рекомендует его
Как основной сервер для запуска приложения **FastAPI**.
diff --git a/docs/ru/docs/contributing.md b/docs/ru/docs/contributing.md
index c4370f9bb..67034ad03 100644
--- a/docs/ru/docs/contributing.md
+++ b/docs/ru/docs/contributing.md
@@ -106,7 +106,7 @@ $ python -m pip install --upgrade pip
</div>
-/// tip | "Подсказка"
+/// tip | Подсказка
Каждый раз, перед установкой новой библиотеки в виртуальное окружение при помощи `pip`, не забудьте активировать это виртуальное окружение.
@@ -162,7 +162,7 @@ $ bash scripts/format.sh
Также существуют дополнительные инструменты/скрипты для работы с переводами в `./scripts/docs.py`.
-/// tip | "Подсказка"
+/// tip | Подсказка
Нет необходимости заглядывать в `./scripts/docs.py`, просто используйте это в командной строке.
@@ -254,7 +254,7 @@ $ uvicorn tutorial001:app --reload
* Проверьте <a href="https://github.com/fastapi/fastapi/pulls" class="external-link" target="_blank">существующие пул-реквесты</a> для Вашего языка. Добавьте отзывы с просьбой внести изменения, если они необходимы, или одобрите их.
-/// tip | "Подсказка"
+/// tip | Подсказка
Вы можете <a href="https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request" class="external-link" target="_blank">добавлять комментарии с предложениями по изменению</a> в существующие пул-реквесты.
@@ -282,7 +282,7 @@ $ uvicorn tutorial001:app --reload
Кодом испанского языка является `es`. А значит директория для переводов на испанский язык: `docs/es/`.
-/// tip | "Подсказка"
+/// tip | Подсказка
Главный ("официальный") язык - английский, директория для него `docs/en/`.
@@ -325,7 +325,7 @@ docs/en/docs/features.md
docs/es/docs/features.md
```
-/// tip | "Подсказка"
+/// tip | Подсказка
Заметьте, что в пути файла мы изменили только код языка с `en` на `es`.
@@ -400,7 +400,7 @@ Updating en
После чего Вы можете проверить в своем редакторе кода, что появился новый каталог `docs/ht/`.
-/// tip | "Подсказка"
+/// tip | Подсказка
Создайте первый пул-реквест, который будет содержать только пустую директорию для нового языка, прежде чем добавлять переводы.
diff --git a/docs/ru/docs/deployment/concepts.md b/docs/ru/docs/deployment/concepts.md
index c41025790..7cdc29526 100644
--- a/docs/ru/docs/deployment/concepts.md
+++ b/docs/ru/docs/deployment/concepts.md
@@ -151,7 +151,7 @@
Для случаев, когда ошибки приводят к сбою в запущенном **процессе**, Вам понадобится добавить компонент, который **перезапустит** процесс хотя бы пару раз...
-/// tip | "Заметка"
+/// tip | Заметка
... Если приложение падает сразу же после запуска, вероятно бесполезно его бесконечно перезапускать. Но полагаю, вы заметите такое поведение во время разработки или, по крайней мере, сразу после развёртывания.
@@ -241,7 +241,7 @@
* **Облачные сервисы**, которые позаботятся обо всём за Вас
* Возможно, что облачный сервис умеет **управлять запуском дополнительных экземпляров приложения**. Вероятно, он потребует, чтоб вы указали - какой **процесс** или **образ** следует клонировать. Скорее всего, вы укажете **один процесс Uvicorn** и облачный сервис будет запускать его копии при необходимости.
-/// tip | "Заметка"
+/// tip | Заметка
Если вы не знаете, что такое **контейнеры**, Docker или Kubernetes, не переживайте.
@@ -263,7 +263,7 @@
Безусловно, возможны случаи, когда нет проблем при выполнении предварительной подготовки параллельно или несколько раз. Тогда Вам повезло, работать с ними намного проще.
-/// tip | "Заметка"
+/// tip | Заметка
Имейте в виду, что в некоторых случаях запуск вашего приложения **может не требовать каких-либо предварительных шагов вовсе**.
@@ -281,7 +281,7 @@
* Bash-скрипт, выполняющий предварительные шаги, а затем запускающий приложение.
* При этом Вам всё ещё нужно найти способ - как запускать/перезапускать *такой* bash-скрипт, обнаруживать ошибки и т.п.
-/// tip | "Заметка"
+/// tip | Заметка
Я приведу Вам больше конкретных примеров работы с контейнерами в главе: [FastAPI внутри контейнеров - Docker](docker.md){.internal-link target=_blank}.
diff --git a/docs/ru/docs/deployment/docker.md b/docs/ru/docs/deployment/docker.md
index 9eef5c4d2..31da01b78 100644
--- a/docs/ru/docs/deployment/docker.md
+++ b/docs/ru/docs/deployment/docker.md
@@ -4,7 +4,7 @@
Использование контейнеров на основе Linux имеет ряд преимуществ, включая **безопасность**, **воспроизводимость**, **простоту** и прочие.
-/// tip | "Подсказка"
+/// tip | Подсказка
Торопитесь или уже знакомы с этой технологией? Перепрыгните на раздел [Создать Docker-образ для FastAPI 👇](#docker-fastapi)
@@ -135,7 +135,7 @@ Successfully installed fastapi pydantic uvicorn
</div>
-/// info | "Информация"
+/// info | Информация
Существуют и другие инструменты управления зависимостями.
@@ -231,7 +231,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
Так как команда выполняется внутри директории `/code`, в которую мы поместили папку `./app` с приложением, то **Uvicorn** сможет найти и **импортировать** объект `app` из файла `app.main`.
-/// tip | "Подсказка"
+/// tip | Подсказка
Если ткнёте на кружок с плюсом, то увидите пояснения. 👆
@@ -306,7 +306,7 @@ $ docker build -t myimage .
</div>
-/// tip | "Подсказка"
+/// tip | Подсказка
Обратите внимание, что в конце написана точка - `.`, это то же самое что и `./`, тем самым мы указываем Docker директорию, из которой нужно выполнять сборку образа контейнера.
@@ -410,7 +410,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
Это может быть другой контейнер, в котором есть, например, <a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a>, работающий с **HTTPS** и **самостоятельно** обновляющий **сертификаты**.
-/// tip | "Подсказка"
+/// tip | Подсказка
Traefik совместим с Docker, Kubernetes и им подобными инструментами. Он очень прост в установке и настройке использования HTTPS для Ваших контейнеров.
@@ -442,7 +442,7 @@ Traefik совместим с Docker, Kubernetes и им подобными ин
Поскольку этот компонент **принимает запросы** и равномерно **распределяет** их между компонентами, его также называют **балансировщиком нагрузки**.
-/// tip | "Подсказка"
+/// tip | Подсказка
**Прокси-сервер завершения работы TLS** одновременно может быть **балансировщиком нагрузки**.
@@ -525,7 +525,7 @@ Traefik совместим с Docker, Kubernetes и им подобными ин
Когда вы запускаете **множество контейнеров**, в каждом из которых работает **только один процесс** (например, в кластере **Kubernetes**), может возникнуть необходимость иметь **отдельный контейнер**, который осуществит **предварительные шаги перед запуском** остальных контейнеров (например, применяет миграции к базе данных).
-/// info | "Информация"
+/// info | Информация
При использовании Kubernetes, это может быть <a href="https://kubernetes.io/docs/concepts/workloads/pods/init-containers/" class="external-link" target="_blank">Инициализирующий контейнер</a>.
@@ -545,7 +545,7 @@ Traefik совместим с Docker, Kubernetes и им подобными ин
* <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
-/// warning | "Предупреждение"
+/// warning | Предупреждение
Скорее всего у вас **нет необходимости** в использовании этого образа или подобного ему и лучше создать свой образ с нуля как описано тут: [Создать Docker-образ для FastAPI](#docker-fastapi).
@@ -557,7 +557,7 @@ Traefik совместим с Docker, Kubernetes и им подобными ин
Он также поддерживает прохождение <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker#pre_start_path" class="external-link" target="_blank">**Подготовительных шагов при запуске контейнеров**</a> при помощи скрипта.
-/// tip | "Подсказка"
+/// tip | Подсказка
Для просмотра всех возможных настроек перейдите на страницу этого Docker-образа: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
@@ -689,7 +689,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
11. Запустите `uvicorn`, указав ему использовать объект `app`, расположенный в `app.main`.
-/// tip | "Подсказка"
+/// tip | Подсказка
Если ткнёте на кружок с плюсом, то увидите объяснения, что происходит в этой строке.
diff --git a/docs/ru/docs/deployment/https.md b/docs/ru/docs/deployment/https.md
index 3d487c465..85c4cce60 100644
--- a/docs/ru/docs/deployment/https.md
+++ b/docs/ru/docs/deployment/https.md
@@ -4,7 +4,7 @@
Но всё несколько сложнее.
-/// tip | "Заметка"
+/// tip | Заметка
Если вы торопитесь или вам не интересно, можете перейти на следующую страницу этого пошагового руководства по размещению приложений на серверах с использованием различных технологий.
@@ -78,7 +78,7 @@
Обычно эту запись достаточно указать один раз, при первоначальной настройке всего сервера.
-/// tip | "Заметка"
+/// tip | Заметка
Уровни протоколов, работающих с именами доменов, намного ниже HTTPS, но об этом следует упомянуть здесь, так как всё зависит от доменов и IP-адресов.
@@ -128,7 +128,7 @@ DNS-сервера присылают браузеру определённый
Таким образом, **HTTPS** это тот же **HTTP**, но внутри **безопасного TLS-соединения** вместо чистого (незашифрованного) TCP-соединения.
-/// tip | "Заметка"
+/// tip | Заметка
Обратите внимание, что шифрование происходит на **уровне TCP**, а не на более высоком уровне HTTP.
diff --git a/docs/ru/docs/deployment/manually.md b/docs/ru/docs/deployment/manually.md
index 78363cef8..9b1d32be8 100644
--- a/docs/ru/docs/deployment/manually.md
+++ b/docs/ru/docs/deployment/manually.md
@@ -39,7 +39,7 @@ $ pip install "uvicorn[standard]"
</div>
-/// tip | "Подсказка"
+/// tip | Подсказка
С опцией `standard`, Uvicorn будет устанавливаться и использоваться с некоторыми дополнительными рекомендованными зависимостями.
@@ -99,7 +99,7 @@ Running on 0.0.0.0:8080 over http (CTRL + C to quit)
////
-/// warning | "Предупреждение"
+/// warning | Предупреждение
Не забудьте удалить опцию `--reload`, если ранее пользовались ею.
diff --git a/docs/ru/docs/deployment/versions.md b/docs/ru/docs/deployment/versions.md
index 17b6446d9..e8db30ce8 100644
--- a/docs/ru/docs/deployment/versions.md
+++ b/docs/ru/docs/deployment/versions.md
@@ -42,7 +42,7 @@ fastapi>=0.45.0,<0.46.0
FastAPI следует соглашению в том, что любые изменения "ПАТЧ"-версии предназначены для исправления багов и внесения обратно совместимых изменений.
-/// tip | "Подсказка"
+/// tip | Подсказка
"ПАТЧ" - это последнее число. Например, в `0.2.3`, ПАТЧ-версия - это `3`.
@@ -56,7 +56,7 @@ fastapi>=0.45.0,<0.46.0
Обратно несовместимые изменения и новые функции добавляются в "МИНОРНЫЕ" версии.
-/// tip | "Подсказка"
+/// tip | Подсказка
"МИНОРНАЯ" версия - это число в середине. Например, в `0.2.3` МИНОРНАЯ версия - это `2`.
diff --git a/docs/ru/docs/features.md b/docs/ru/docs/features.md
index 31f245e7a..77d6b936a 100644
--- a/docs/ru/docs/features.md
+++ b/docs/ru/docs/features.md
@@ -66,7 +66,7 @@ second_user_data = {
my_second_user: User = User(**second_user_data)
```
-/// info | "Информация"
+/// info | Информация
`**second_user_data` означает:
diff --git a/docs/ru/docs/help-fastapi.md b/docs/ru/docs/help-fastapi.md
index fa8200817..474b3d689 100644
--- a/docs/ru/docs/help-fastapi.md
+++ b/docs/ru/docs/help-fastapi.md
@@ -162,7 +162,7 @@
* Затем, используя **комментарий**, сообщите, что Вы сделали проверку, тогда я буду знать, что Вы действительно проверили код.
-/// info | "Информация"
+/// info | Информация
К сожалению, я не могу так просто доверять пул-реквестам, у которых уже есть несколько одобрений.
@@ -221,7 +221,7 @@
Подключайтесь к 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" target="_blank"> чату в Discord</a> 👥 и общайтесь с другими участниками сообщества FastAPI.
-/// tip | "Подсказка"
+/// tip | Подсказка
Вопросы по проблемам с фреймворком лучше задавать в <a href="https://github.com/fastapi/fastapi/issues/new/choose" class="external-link" target="_blank">GitHub issues</a>, так больше шансов, что Вы получите помощь от [Экспертов FastAPI](fastapi-people.md#_3){.internal-link target=_blank}.
diff --git a/docs/ru/docs/tutorial/body-fields.md b/docs/ru/docs/tutorial/body-fields.md
index f3b2c6113..0c4cbb09c 100644
--- a/docs/ru/docs/tutorial/body-fields.md
+++ b/docs/ru/docs/tutorial/body-fields.md
@@ -22,7 +22,7 @@
////
-/// warning | "Внимание"
+/// warning | Внимание
Обратите внимание, что функция `Field` импортируется непосредственно из `pydantic`, а не из `fastapi`, как все остальные функции (`Query`, `Path`, `Body` и т.д.).
@@ -50,7 +50,7 @@
Функция `Field` работает так же, как `Query`, `Path` и `Body`, у неё такие же параметры и т.д.
-/// note | "Технические детали"
+/// note | Технические детали
На самом деле, `Query`, `Path` и другие функции, которые вы увидите в дальнейшем, создают объекты подклассов общего класса `Param`, который сам по себе является подклассом `FieldInfo` из Pydantic.
@@ -62,7 +62,7 @@
///
-/// tip | "Подсказка"
+/// tip | Подсказка
Обратите внимание, что каждый атрибут модели с типом, значением по умолчанию и `Field` имеет ту же структуру, что и параметр *функции обработки пути* с `Field` вместо `Path`, `Query` и `Body`.
@@ -75,7 +75,7 @@
Вы узнаете больше о добавлении дополнительной информации позже в документации, когда будете изучать, как задавать примеры принимаемых данных.
-/// warning | "Внимание"
+/// warning | Внимание
Дополнительные ключи, переданные в функцию `Field`, также будут присутствовать в сгенерированной OpenAPI схеме вашего приложения.
Поскольку эти ключи не являются обязательной частью спецификации OpenAPI, некоторые инструменты OpenAPI, например, [валидатор OpenAPI](https://validator.swagger.io/), могут не работать с вашей сгенерированной схемой.
diff --git a/docs/ru/docs/tutorial/body-multiple-params.md b/docs/ru/docs/tutorial/body-multiple-params.md
index 53965f0ec..594e1dbca 100644
--- a/docs/ru/docs/tutorial/body-multiple-params.md
+++ b/docs/ru/docs/tutorial/body-multiple-params.md
@@ -34,7 +34,7 @@
//// tab | Python 3.10+ non-Annotated
-/// tip | "Заметка"
+/// tip | Заметка
Рекомендуется использовать `Annotated` версию, если это возможно.
@@ -48,7 +48,7 @@
//// tab | Python 3.8+ non-Annotated
-/// tip | "Заметка"
+/// tip | Заметка
Рекомендуется использовать версию с `Annotated`, если это возможно.
@@ -60,7 +60,7 @@
////
-/// note | "Заметка"
+/// note | Заметка
Заметьте, что в данном случае параметр `item`, который будет взят из тела запроса, необязателен. Так как было установлено значение `None` по умолчанию.
@@ -116,7 +116,7 @@
}
```
-/// note | "Внимание"
+/// note | Внимание
Обратите внимание, что хотя параметр `item` был объявлен таким же способом, как и раньше, теперь предпологается, что он находится внутри тела с ключом `item`.
@@ -162,7 +162,7 @@
//// tab | Python 3.10+ non-Annotated
-/// tip | "Заметка"
+/// tip | Заметка
Рекомендуется использовать `Annotated` версию, если это возможно.
@@ -176,7 +176,7 @@
//// tab | Python 3.8+ non-Annotated
-/// tip | "Заметка"
+/// tip | Заметка
Рекомендуется использовать `Annotated` версию, если это возможно.
@@ -252,7 +252,7 @@ q: str | None = None
//// tab | Python 3.10+ non-Annotated
-/// tip | "Заметка"
+/// tip | Заметка
Рекомендуется использовать `Annotated` версию, если это возможно.
@@ -266,7 +266,7 @@ q: str | None = None
//// tab | Python 3.8+ non-Annotated
-/// tip | "Заметка"
+/// tip | Заметка
Рекомендуется использовать `Annotated` версию, если это возможно.
@@ -278,7 +278,7 @@ q: str | None = None
////
-/// info | "Информация"
+/// info | Информация
`Body` также имеет все те же дополнительные параметры валидации и метаданных, как у `Query`,`Path` и других, которые вы увидите позже.
@@ -324,7 +324,7 @@ item: Item = Body(embed=True)
//// tab | Python 3.10+ non-Annotated
-/// tip | "Заметка"
+/// tip | Заметка
Рекомендуется использовать `Annotated` версию, если это возможно.
@@ -338,7 +338,7 @@ item: Item = Body(embed=True)
//// tab | Python 3.8+ non-Annotated
-/// tip | "Заметка"
+/// tip | Заметка
Рекомендуется использовать `Annotated` версию, если это возможно.
diff --git a/docs/ru/docs/tutorial/body-nested-models.md b/docs/ru/docs/tutorial/body-nested-models.md
index 780946725..9abd4f432 100644
--- a/docs/ru/docs/tutorial/body-nested-models.md
+++ b/docs/ru/docs/tutorial/body-nested-models.md
@@ -304,7 +304,7 @@ my_list: List[str]
}
```
-/// info | "Информация"
+/// info | Информация
Заметьте, что теперь у ключа `images` есть список объектов изображений.
@@ -338,7 +338,7 @@ my_list: List[str]
////
-/// info | "Информация"
+/// info | Информация
Заметьте, что у объекта `Offer` есть список объектов `Item`, которые, в свою очередь, могут содержать необязательный список объектов `Image`
@@ -420,7 +420,7 @@ images: list[Image]
////
-/// tip | "Совет"
+/// tip | Совет
Имейте в виду, что JSON поддерживает только ключи типа `str`.
diff --git a/docs/ru/docs/tutorial/body-updates.md b/docs/ru/docs/tutorial/body-updates.md
index 3ecfe52f4..c80952f70 100644
--- a/docs/ru/docs/tutorial/body-updates.md
+++ b/docs/ru/docs/tutorial/body-updates.md
@@ -54,7 +54,7 @@
Это означает, что можно передавать только те данные, которые необходимо обновить, оставляя остальные нетронутыми.
-/// note | "Технические детали"
+/// note | Технические детали
`PATCH` менее распространен и известен, чем `PUT`.
@@ -167,7 +167,7 @@
////
-/// tip | "Подсказка"
+/// tip | Подсказка
Эту же технику можно использовать и для операции HTTP `PUT`.
@@ -175,7 +175,7 @@
///
-/// note | "Технические детали"
+/// note | Технические детали
Обратите внимание, что входная модель по-прежнему валидируется.
diff --git a/docs/ru/docs/tutorial/body.md b/docs/ru/docs/tutorial/body.md
index 91b169d07..62927f0d1 100644
--- a/docs/ru/docs/tutorial/body.md
+++ b/docs/ru/docs/tutorial/body.md
@@ -8,7 +8,7 @@
Чтобы объявить тело **запроса**, необходимо использовать модели <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic</a>, со всей их мощью и преимуществами.
-/// info | "Информация"
+/// info | Информация
Чтобы отправить данные, необходимо использовать один из методов: `POST` (обычно), `PUT`, `DELETE` или `PATCH`.
@@ -113,7 +113,7 @@
<img src="/img/tutorial/body/image05.png">
-/// tip | "Подсказка"
+/// tip | Подсказка
Если вы используете <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a> в качестве редактора, то вам стоит попробовать плагин <a href="https://github.com/koxudaxi/pydantic-pycharm-plugin/" class="external-link" target="_blank">Pydantic PyCharm Plugin</a>.
@@ -161,7 +161,7 @@
* Если аннотация типа параметра содержит **примитивный тип** (`int`, `float`, `str`, `bool` и т.п.), он будет интерпретирован как параметр **запроса**.
* Если аннотация типа параметра представляет собой **модель Pydantic**, он будет интерпретирован как параметр **тела запроса**.
-/// note | "Заметка"
+/// note | Заметка
FastAPI понимает, что значение параметра `q` не является обязательным, потому что имеет значение по умолчанию `= None`.
diff --git a/docs/ru/docs/tutorial/cookie-params.md b/docs/ru/docs/tutorial/cookie-params.md
index 2a73a5918..88533f7f8 100644
--- a/docs/ru/docs/tutorial/cookie-params.md
+++ b/docs/ru/docs/tutorial/cookie-params.md
@@ -44,7 +44,7 @@
////
-/// note | "Технические детали"
+/// note | Технические детали
`Cookie` - это класс, родственный `Path` и `Query`. Он также наследуется от общего класса `Param`.
@@ -52,7 +52,7 @@
///
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Для объявления cookies, вам нужно использовать `Cookie`, иначе параметры будут интерпретированы как параметры запроса.
diff --git a/docs/ru/docs/tutorial/cors.md b/docs/ru/docs/tutorial/cors.md
index 8d415a2c1..622cd5a98 100644
--- a/docs/ru/docs/tutorial/cors.md
+++ b/docs/ru/docs/tutorial/cors.md
@@ -78,7 +78,7 @@
Для получения более подробной информации о <abbr title="Cross-Origin Resource Sharing">CORS</abbr>, обратитесь к <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS" class="external-link" target="_blank">Документации CORS от Mozilla</a>.
-/// note | "Технические детали"
+/// note | Технические детали
Вы также можете использовать `from starlette.middleware.cors import CORSMiddleware`.
diff --git a/docs/ru/docs/tutorial/debugging.md b/docs/ru/docs/tutorial/debugging.md
index 606a32bfc..0feeaa20c 100644
--- a/docs/ru/docs/tutorial/debugging.md
+++ b/docs/ru/docs/tutorial/debugging.md
@@ -74,7 +74,7 @@ from myapp import app
не будет выполнена.
-/// info | "Информация"
+/// info | Информация
Для получения дополнительной информации, ознакомьтесь с <a href="https://docs.python.org/3/library/__main__.html" class="external-link" target="_blank">официальной документацией Python</a>.
diff --git a/docs/ru/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/ru/docs/tutorial/dependencies/classes-as-dependencies.md
index 161101bb3..486ff9ea9 100644
--- a/docs/ru/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/ru/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -32,7 +32,7 @@
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -46,7 +46,7 @@
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -143,7 +143,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -157,7 +157,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -197,7 +197,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -211,7 +211,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -251,7 +251,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -265,7 +265,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -317,7 +317,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -331,7 +331,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -351,7 +351,7 @@ fluffy = Cat(name="Mr Fluffy")
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -395,7 +395,7 @@ commons: Annotated[CommonQueryParams, ...
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -421,7 +421,7 @@ commons: Annotated[Any, Depends(CommonQueryParams)]
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -461,7 +461,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -475,7 +475,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -497,7 +497,7 @@ commons = Depends(CommonQueryParams)
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -532,7 +532,7 @@ commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -556,7 +556,7 @@ commons: Annotated[CommonQueryParams, Depends()]
//// tab | Python 3.6 без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -598,7 +598,7 @@ commons: CommonQueryParams = Depends()
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -612,7 +612,7 @@ commons: CommonQueryParams = Depends()
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -626,7 +626,7 @@ commons: CommonQueryParams = Depends()
...и **FastAPI** будет знать, что делать.
-/// tip | "Подсказка"
+/// tip | Подсказка
Если это покажется вам более запутанным, чем полезным, не обращайте внимания, это вам не *нужно*.
diff --git a/docs/ru/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/ru/docs/tutorial/dependencies/dependencies-with-yield.md
index 99a86e999..83f8ec0d2 100644
--- a/docs/ru/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/ru/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -4,13 +4,13 @@ FastAPI поддерживает зависимости, которые выпо
Для этого используйте `yield` вместо `return`, а дополнительный код напишите после него.
-/// tip | "Подсказка"
+/// tip | Подсказка
Обязательно используйте `yield` один-единственный раз.
///
-/// note | "Технические детали"
+/// note | Технические детали
Любая функция, с которой может работать:
@@ -45,7 +45,7 @@ FastAPI поддерживает зависимости, которые выпо
{!../../docs_src/dependencies/tutorial007.py!}
```
-/// tip | "Подсказка"
+/// tip | Подсказка
Можно использовать как `async` так и обычные функции.
@@ -93,7 +93,7 @@ FastAPI поддерживает зависимости, которые выпо
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -129,7 +129,7 @@ FastAPI поддерживает зависимости, которые выпо
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -149,7 +149,7 @@ FastAPI поддерживает зависимости, которые выпо
**FastAPI** проследит за тем, чтобы все выполнялось в правильном порядке.
-/// note | "Технические детали"
+/// note | Технические детали
Это работает благодаря <a href="https://docs.python.org/3/library/contextlib.html" class="external-link" target="_blank">Контекстным менеджерам</a> в Python.
@@ -177,7 +177,7 @@ FastAPI поддерживает зависимости, которые выпо
Если у вас есть пользовательские исключения, которые вы хотите обрабатывать *до* возврата ответа и, возможно, модифицировать ответ, даже вызывая `HTTPException`, создайте [Cобственный обработчик исключений](../handling-errors.md#install-custom-exception-handlers){.internal-link target=_blank}.
-/// tip | "Подсказка"
+/// tip | Подсказка
Вы все еще можете вызывать исключения, включая `HTTPException`, *до* `yield`. Но не после.
@@ -225,7 +225,7 @@ participant tasks as Background tasks
end
```
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Клиенту будет отправлен только **один ответ**. Это может быть один из ответов об ошибке или это будет ответ от *операции пути*.
@@ -233,7 +233,7 @@ participant tasks as Background tasks
///
-/// tip | "Подсказка"
+/// tip | Подсказка
На этой диаграмме показано "HttpException", но вы также можете вызвать любое другое исключение, для которого вы создаете [Пользовательский обработчик исключений](../handling-errors.md#install-custom-exception-handlers){.internal-link target=_blank}.
@@ -243,7 +243,7 @@ participant tasks as Background tasks
## Зависимости с `yield`, `HTTPException` и фоновыми задачами
-/// warning | "Внимание"
+/// warning | Внимание
Скорее всего, вам не нужны эти технические подробности, вы можете пропустить этот раздел и продолжить ниже.
@@ -257,7 +257,7 @@ participant tasks as Background tasks
Тем не менее, поскольку это означало бы ожидание ответа в сети, а также ненужное удержание ресурса в зависимости от доходности (например, соединение с базой данных), это было изменено в FastAPI 0.106.0.
-/// tip | "Подсказка"
+/// tip | Подсказка
Кроме того, фоновая задача обычно представляет собой независимый набор логики, который должен обрабатываться отдельно, со своими собственными ресурсами (например, собственным подключением к базе данных).
Таким образом, вы, вероятно, получите более чистый код.
@@ -290,7 +290,7 @@ with open("./somefile.txt") as f:
### Использование менеджеров контекста в зависимостях с помощью `yield`
-/// warning | "Внимание"
+/// warning | Внимание
Это более или менее "продвинутая" идея.
@@ -307,7 +307,7 @@ with open("./somefile.txt") as f:
{!../../docs_src/dependencies/tutorial010.py!}
```
-/// tip | "Подсказка"
+/// tip | Подсказка
Другой способ создания контекстного менеджера - с помощью:
diff --git a/docs/ru/docs/tutorial/dependencies/global-dependencies.md b/docs/ru/docs/tutorial/dependencies/global-dependencies.md
index 7dbd50ae1..a4dfeb8ac 100644
--- a/docs/ru/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/ru/docs/tutorial/dependencies/global-dependencies.md
@@ -24,7 +24,7 @@
//// tab | Python 3.8 non-Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать 'Annotated' версию, если это возможно.
diff --git a/docs/ru/docs/tutorial/dependencies/index.md b/docs/ru/docs/tutorial/dependencies/index.md
index fcd9f46dc..b6cf7c780 100644
--- a/docs/ru/docs/tutorial/dependencies/index.md
+++ b/docs/ru/docs/tutorial/dependencies/index.md
@@ -55,7 +55,7 @@
//// tab | Python 3.10+ non-Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Настоятельно рекомендуем использовать `Annotated` версию насколько это возможно.
@@ -69,7 +69,7 @@
//// tab | Python 3.8+ non-Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Настоятельно рекомендуем использовать `Annotated` версию насколько это возможно.
@@ -99,7 +99,7 @@
И в конце она возвращает `dict`, содержащий эти значения.
-/// info | "Информация"
+/// info | Информация
**FastAPI** добавил поддержку для `Annotated` (и начал её рекомендовать) в версии 0.95.0.
@@ -137,7 +137,7 @@
//// tab | Python 3.10+ non-Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Настоятельно рекомендуем использовать `Annotated` версию насколько это возможно.
@@ -151,7 +151,7 @@
//// tab | Python 3.8+ non-Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Настоятельно рекомендуем использовать `Annotated` версию насколько это возможно.
@@ -193,7 +193,7 @@
//// tab | Python 3.10+ non-Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Настоятельно рекомендуем использовать `Annotated` версию насколько это возможно.
@@ -207,7 +207,7 @@
//// tab | Python 3.8+ non-Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Настоятельно рекомендуем использовать `Annotated` версию насколько это возможно.
@@ -225,7 +225,7 @@
И потом функция берёт параметры так же, как *функция обработки пути*.
-/// tip | "Подсказка"
+/// tip | Подсказка
В следующей главе вы увидите, какие другие вещи, помимо функций, можно использовать в качестве зависимостей.
@@ -250,7 +250,7 @@ common_parameters --> read_users
Таким образом, вы пишете общий код один раз, и **FastAPI** позаботится о его вызове для ваших *операций с путями*.
-/// check | "Проверка"
+/// check | Проверка
Обратите внимание, что вы не создаёте специальный класс и не передаёте его куда-то в **FastAPI** для регистрации, или что-то в этом роде.
@@ -294,7 +294,7 @@ commons: Annotated[dict, Depends(common_parameters)]
////
-/// tip | "Подсказка"
+/// tip | Подсказка
Это стандартный синтаксис python и называется "type alias", это не особенность **FastAPI**.
@@ -316,7 +316,7 @@ commons: Annotated[dict, Depends(common_parameters)]
Это всё не важно. **FastAPI** знает, что нужно сделать. 😎
-/// note | "Информация"
+/// note | Информация
Если вам эта тема не знакома, прочтите [Async: *"In a hurry?"*](../../async.md){.internal-link target=_blank} раздел о `async` и `await` в документации.
diff --git a/docs/ru/docs/tutorial/dependencies/sub-dependencies.md b/docs/ru/docs/tutorial/dependencies/sub-dependencies.md
index ae0fd0824..0e8cb20e7 100644
--- a/docs/ru/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/ru/docs/tutorial/dependencies/sub-dependencies.md
@@ -36,7 +36,7 @@
//// tab | Python 3.10 без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -50,7 +50,7 @@
//// tab | Python 3.6 без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -96,7 +96,7 @@
//// tab | Python 3.10 без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -110,7 +110,7 @@
//// tab | Python 3.6 без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -159,7 +159,7 @@
//// tab | Python 3.10 без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -173,7 +173,7 @@
//// tab | Python 3.6 без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -185,7 +185,7 @@
////
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Обратите внимание, что мы объявляем только одну зависимость в *функции операции пути* - `query_or_cookie_extractor`.
@@ -223,7 +223,7 @@ async def needy_dependency(fresh_value: Annotated[str, Depends(get_value, use_ca
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -244,7 +244,7 @@ async def needy_dependency(fresh_value: str = Depends(get_value, use_cache=False
Но, тем не менее, эта система очень мощная и позволяет вам объявлять вложенные графы (деревья) зависимостей сколь угодно глубоко.
-/// tip | "Подсказка"
+/// tip | Подсказка
Все это может показаться не столь полезным на этих простых примерах.
diff --git a/docs/ru/docs/tutorial/encoder.md b/docs/ru/docs/tutorial/encoder.md
index c9900cb2c..523644ac8 100644
--- a/docs/ru/docs/tutorial/encoder.md
+++ b/docs/ru/docs/tutorial/encoder.md
@@ -42,7 +42,7 @@
Функция не возвращает большой `str`, содержащий данные в формате JSON (в виде строки). Она возвращает стандартную структуру данных Python (например, `dict`) со значениями и подзначениями, которые совместимы с JSON.
-/// note | "Технические детали"
+/// note | Технические детали
`jsonable_encoder` фактически используется **FastAPI** внутри системы для преобразования данных. Однако он полезен и во многих других сценариях.
diff --git a/docs/ru/docs/tutorial/extra-models.md b/docs/ru/docs/tutorial/extra-models.md
index e7ff3f40f..241f70779 100644
--- a/docs/ru/docs/tutorial/extra-models.md
+++ b/docs/ru/docs/tutorial/extra-models.md
@@ -8,7 +8,7 @@
* **Модель для вывода** не должна содержать пароль.
* **Модель для базы данных**, возможно, должна содержать хэшированный пароль.
-/// danger | "Внимание"
+/// danger | Внимание
Никогда не храните пароли пользователей в чистом виде. Всегда храните "безопасный хэш", который вы затем сможете проверить.
@@ -146,7 +146,7 @@ UserInDB(
)
```
-/// warning | "Предупреждение"
+/// warning | Предупреждение
Цель использованных в примере вспомогательных функций - не более чем демонстрация возможных операций с данными, но, конечно, они не обеспечивают настоящую безопасность.
@@ -192,7 +192,7 @@ UserInDB(
Для этого используйте стандартные аннотации типов в Python <a href="https://docs.python.org/3/library/typing.html#typing.Union" class="external-link" target="_blank">`typing.Union`</a>:
-/// note | "Примечание"
+/// note | Примечание
При объявлении <a href="https://docs.pydantic.dev/latest/concepts/types/#unions" class="external-link" target="_blank">`Union`</a>, сначала указывайте наиболее детальные типы, затем менее детальные. В примере ниже более детальный `PlaneItem` стоит перед `CarItem` в `Union[PlaneItem, CarItem]`.
diff --git a/docs/ru/docs/tutorial/first-steps.md b/docs/ru/docs/tutorial/first-steps.md
index b1de217cd..309f26c4f 100644
--- a/docs/ru/docs/tutorial/first-steps.md
+++ b/docs/ru/docs/tutorial/first-steps.md
@@ -24,7 +24,7 @@ $ uvicorn main:app --reload
</div>
-/// note | "Технические детали"
+/// note | Технические детали
Команда `uvicorn main:app` обращается к:
@@ -139,7 +139,7 @@ OpenAPI описывает схему API. Эта схема содержит о
`FastAPI` это класс в Python, который предоставляет всю функциональность для API.
-/// note | "Технические детали"
+/// note | Технические детали
`FastAPI` это класс, который наследуется непосредственно от `Starlette`.
@@ -205,7 +205,7 @@ https://example.com/items/foo
/items/foo
```
-/// info | "Дополнительная иформация"
+/// info | Дополнительная иформация
Термин "path" также часто называется "endpoint" или "route".
@@ -259,7 +259,7 @@ https://example.com/items/foo
* путь `/`
* использующих <abbr title="HTTP GET метод"><code>get</code> операцию</abbr>
-/// info | "`@decorator` Дополнительная информация"
+/// info | `@decorator` Дополнительная информация
Синтаксис `@something` в Python называется "декоратор".
@@ -286,7 +286,7 @@ https://example.com/items/foo
* `@app.patch()`
* `@app.trace()`
-/// tip | "Подсказка"
+/// tip | Подсказка
Вы можете использовать каждую операцию (HTTP-метод) по своему усмотрению.
@@ -324,7 +324,7 @@ https://example.com/items/foo
{!../../docs_src/first_steps/tutorial003.py!}
```
-/// note | "Технические детали"
+/// note | Технические детали
Если не знаете в чём разница, посмотрите [Конкурентность: *"Нет времени?"*](../async.md#_1){.internal-link target=_blank}.
diff --git a/docs/ru/docs/tutorial/handling-errors.md b/docs/ru/docs/tutorial/handling-errors.md
index e7bfb85aa..a06644376 100644
--- a/docs/ru/docs/tutorial/handling-errors.md
+++ b/docs/ru/docs/tutorial/handling-errors.md
@@ -63,7 +63,7 @@
}
```
-/// tip | "Подсказка"
+/// tip | Подсказка
При вызове `HTTPException` в качестве параметра `detail` можно передавать любое значение, которое может быть преобразовано в JSON, а не только `str`.
@@ -109,7 +109,7 @@
{"message": "Oops! yolo did something. There goes a rainbow..."}
```
-/// note | "Технические детали"
+/// note | Технические детали
Также можно использовать `from starlette.requests import Request` и `from starlette.responses import JSONResponse`.
@@ -166,7 +166,7 @@ path -> item_id
#### `RequestValidationError` или `ValidationError`
-/// warning | "Внимание"
+/// warning | Внимание
Это технические детали, которые можно пропустить, если они не важны для вас сейчас.
@@ -192,7 +192,7 @@ path -> item_id
{!../../docs_src/handling_errors/tutorial004.py!}
```
-/// note | "Технические детали"
+/// note | Технические детали
Можно также использовать `from starlette.responses import PlainTextResponse`.
diff --git a/docs/ru/docs/tutorial/header-params.md b/docs/ru/docs/tutorial/header-params.md
index 18e1e60d0..904709b04 100644
--- a/docs/ru/docs/tutorial/header-params.md
+++ b/docs/ru/docs/tutorial/header-params.md
@@ -32,7 +32,7 @@
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -46,7 +46,7 @@
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -90,7 +90,7 @@
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -104,7 +104,7 @@
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -116,7 +116,7 @@
////
-/// note | "Технические детали"
+/// note | Технические детали
`Header` - это "родственный" класс `Path`, `Query` и `Cookie`. Он также наследуется от того же общего класса `Param`.
@@ -124,7 +124,7 @@
///
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Чтобы объявить заголовки, важно использовать `Header`, иначе параметры интерпретируются как query-параметры.
@@ -172,7 +172,7 @@
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -186,7 +186,7 @@
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -198,7 +198,7 @@
////
-/// warning | "Внимание"
+/// warning | Внимание
Прежде чем установить для `convert_underscores` значение `False`, имейте в виду, что некоторые HTTP-прокси и серверы запрещают использование заголовков с подчеркиванием.
@@ -240,7 +240,7 @@
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -254,7 +254,7 @@
//// tab | Python 3.9+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -268,7 +268,7 @@
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
diff --git a/docs/ru/docs/tutorial/index.md b/docs/ru/docs/tutorial/index.md
index 4cf45c0ed..ddca2fbb1 100644
--- a/docs/ru/docs/tutorial/index.md
+++ b/docs/ru/docs/tutorial/index.md
@@ -52,7 +52,7 @@ $ pip install "fastapi[all]"
...это также включает `uvicorn`, который вы можете использовать в качестве сервера, который запускает ваш код.
-/// note | "Технические детали"
+/// note | Технические детали
Вы также можете установить его по частям.
diff --git a/docs/ru/docs/tutorial/metadata.md b/docs/ru/docs/tutorial/metadata.md
index 246458f42..ae739a043 100644
--- a/docs/ru/docs/tutorial/metadata.md
+++ b/docs/ru/docs/tutorial/metadata.md
@@ -21,7 +21,7 @@
{!../../docs_src/metadata/tutorial001.py!}
```
-/// tip | "Подсказка"
+/// tip | Подсказка
Вы можете использовать Markdown в поле `description`, и оно будет отображено в выводе.
@@ -57,7 +57,7 @@
Помните, что вы можете использовать Markdown внутри описания, к примеру "login" будет отображен жирным шрифтом (**login**) и "fancy" будет отображаться курсивом (_fancy_).
-/// tip | "Подсказка"
+/// tip | Подсказка
Вам необязательно добавлять метаданные для всех используемых тегов
@@ -70,7 +70,7 @@
{!../../docs_src/metadata/tutorial004.py!}
```
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Узнайте больше о тегах в [Конфигурации операции пути](path-operation-configuration.md#_3){.internal-link target=_blank}.
diff --git a/docs/ru/docs/tutorial/path-operation-configuration.md b/docs/ru/docs/tutorial/path-operation-configuration.md
index 5f3855af2..ac12b7084 100644
--- a/docs/ru/docs/tutorial/path-operation-configuration.md
+++ b/docs/ru/docs/tutorial/path-operation-configuration.md
@@ -2,7 +2,7 @@
Существует несколько параметров, которые вы можете передать вашему *декоратору операций пути* для его настройки.
-/// warning | "Внимание"
+/// warning | Внимание
Помните, что эти параметры передаются непосредственно *декоратору операций пути*, а не вашей *функции-обработчику операций пути*.
@@ -42,7 +42,7 @@
Этот код состояния будет использован в ответе и будет добавлен в схему OpenAPI.
-/// note | "Технические детали"
+/// note | Технические детали
Вы также можете использовать `from starlette import status`.
@@ -184,13 +184,13 @@
////
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Помните, что `response_description` относится конкретно к ответу, а `description` относится к *операции пути* в целом.
///
-/// check | "Технические детали"
+/// check | Технические детали
OpenAPI указывает, что каждой *операции пути* необходимо описание ответа.
diff --git a/docs/ru/docs/tutorial/path-params-numeric-validations.md b/docs/ru/docs/tutorial/path-params-numeric-validations.md
index bf42ec725..ed19576a2 100644
--- a/docs/ru/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/ru/docs/tutorial/path-params-numeric-validations.md
@@ -32,7 +32,7 @@
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -46,7 +46,7 @@
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -58,7 +58,7 @@
////
-/// info | "Информация"
+/// info | Информация
Поддержка `Annotated` была добавлена в FastAPI начиная с версии 0.95.0 (и с этой версии рекомендуется использовать этот подход).
@@ -100,7 +100,7 @@
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -114,7 +114,7 @@
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -126,7 +126,7 @@
////
-/// note | "Примечание"
+/// note | Примечание
Path-параметр всегда является обязательным, поскольку он составляет часть пути.
@@ -138,7 +138,7 @@ Path-параметр всегда является обязательным, п
## Задайте нужный вам порядок параметров
-/// tip | "Подсказка"
+/// tip | Подсказка
Это не имеет большого значения, если вы используете `Annotated`.
@@ -160,7 +160,7 @@ Path-параметр всегда является обязательным, п
//// tab | Python 3.8 без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -192,7 +192,7 @@ Path-параметр всегда является обязательным, п
## Задайте нужный вам порядок параметров, полезные приёмы
-/// tip | "Подсказка"
+/// tip | Подсказка
Это не имеет большого значения, если вы используете `Annotated`.
@@ -261,7 +261,7 @@ Python не будет ничего делать с `*`, но он будет з
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -298,7 +298,7 @@ Python не будет ничего делать с `*`, но он будет з
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -338,7 +338,7 @@ Python не будет ничего делать с `*`, но он будет з
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -361,7 +361,7 @@ Python не будет ничего делать с `*`, но он будет з
* `lt`: меньше (`l`ess `t`han)
* `le`: меньше или равно (`l`ess than or `e`qual)
-/// info | "Информация"
+/// info | Информация
`Query`, `Path` и другие классы, которые мы разберём позже, являются наследниками общего класса `Param`.
@@ -369,7 +369,7 @@ Python не будет ничего делать с `*`, но он будет з
///
-/// note | "Технические детали"
+/// note | Технические детали
`Query`, `Path` и другие "классы", которые вы импортируете из `fastapi`, на самом деле являются функциями, которые при вызове возвращают экземпляры одноимённых классов.
diff --git a/docs/ru/docs/tutorial/path-params.md b/docs/ru/docs/tutorial/path-params.md
index d1d76cf7b..ba23ba5ea 100644
--- a/docs/ru/docs/tutorial/path-params.md
+++ b/docs/ru/docs/tutorial/path-params.md
@@ -24,7 +24,7 @@
Здесь, `item_id` объявлен типом `int`.
-/// check | "Заметка"
+/// check | Заметка
Это обеспечит поддержку редактора внутри функции (проверка ошибок, автодополнение и т.п.).
@@ -38,7 +38,7 @@
{"item_id":3}
```
-/// check | "Заметка"
+/// check | Заметка
Обратите внимание на значение `3`, которое получила (и вернула) функция. Это целочисленный Python `int`, а не строка `"3"`.
@@ -69,7 +69,7 @@
Та же ошибка возникнет, если вместо `int` передать `float` , например: <a href="http://127.0.0.1:8000/items/4.2" class="external-link" target="_blank">http://127.0.0.1:8000/items/4.2</a>
-/// check | "Заметка"
+/// check | Заметка
**FastAPI** обеспечивает проверку типов, используя всё те же определения типов.
@@ -85,7 +85,7 @@
<img src="/img/tutorial/path-params/image01.png">
-/// check | "Заметка"
+/// check | Заметка
Ещё раз, просто используя определения типов, **FastAPI** обеспечивает автоматическую интерактивную документацию (с интеграцией Swagger UI).
@@ -152,13 +152,13 @@
{!../../docs_src/path_params/tutorial005.py!}
```
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
<a href="https://docs.python.org/3/library/enum.html" class="external-link" target="_blank">Перечисления (enum) доступны в Python</a> начиная с версии 3.4.
///
-/// tip | "Подсказка"
+/// tip | Подсказка
Если интересно, то "AlexNet", "ResNet" и "LeNet" - это названия <abbr title="Технически, это архитектуры моделей глубокого обучения">моделей</abbr> машинного обучения.
@@ -198,7 +198,7 @@
{!../../docs_src/path_params/tutorial005.py!}
```
-/// tip | "Подсказка"
+/// tip | Подсказка
Значение `"lenet"` также можно получить с помощью `ModelName.lenet.value`.
@@ -254,7 +254,7 @@ OpenAPI не поддерживает способов объявления *п
{!../../docs_src/path_params/tutorial004.py!}
```
-/// tip | "Подсказка"
+/// tip | Подсказка
Возможно, вам понадобится, чтобы параметр содержал `/home/johndoe/myfile.txt` с ведущим слэшем (`/`).
diff --git a/docs/ru/docs/tutorial/query-params-str-validations.md b/docs/ru/docs/tutorial/query-params-str-validations.md
index 0054af6ed..f76570ce8 100644
--- a/docs/ru/docs/tutorial/query-params-str-validations.md
+++ b/docs/ru/docs/tutorial/query-params-str-validations.md
@@ -22,7 +22,7 @@
Query-параметр `q` имеет тип `Union[str, None]` (или `str | None` в Python 3.10). Это означает, что входной параметр будет типа `str`, но может быть и `None`. Ещё параметр имеет значение по умолчанию `None`, из-за чего FastAPI определит параметр как необязательный.
-/// note | "Технические детали"
+/// note | Технические детали
FastAPI определит параметр `q` как необязательный, потому что его значение по умолчанию `= None`.
@@ -143,7 +143,7 @@ q: Annotated[Union[str, None]] = None
В предыдущих версиях FastAPI (ниже <abbr title="ранее 2023-03">0.95.0</abbr>) необходимо было использовать `Query` как значение по умолчанию для query-параметра. Так было вместо размещения его в `Annotated`, так что велика вероятность, что вам встретится такой код. Сейчас объясню.
-/// tip | "Подсказка"
+/// tip | Подсказка
При написании нового кода и везде где это возможно, используйте `Annotated`, как было описано ранее. У этого способа есть несколько преимуществ (о них дальше) и никаких недостатков. 🍰
@@ -195,7 +195,7 @@ q: str | None = None
Но он явно объявляет его как query-параметр.
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Запомните, важной частью объявления параметра как необязательного является:
@@ -291,7 +291,7 @@ q: str = Query(default="rick")
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -305,7 +305,7 @@ q: str = Query(default="rick")
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -347,7 +347,7 @@ q: str = Query(default="rick")
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -361,7 +361,7 @@ q: str = Query(default="rick")
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -407,7 +407,7 @@ q: str = Query(default="rick")
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -419,7 +419,7 @@ q: str = Query(default="rick")
////
-/// note | "Технические детали"
+/// note | Технические детали
Наличие значения по умолчанию делает параметр необязательным.
@@ -477,7 +477,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -487,7 +487,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
{!> ../../docs_src/query_params_str_validations/tutorial006.py!}
```
-/// tip | "Подсказка"
+/// tip | Подсказка
Обратите внимание, что даже когда `Query()` используется как значение по умолчанию для параметра функции, мы не передаём `default=None` в `Query()`.
@@ -519,7 +519,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -531,7 +531,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
////
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Если вы ранее не сталкивались с `...`: это специальное значение, <a href="https://docs.python.org/3/library/constants.html#Ellipsis" class="external-link" target="_blank">часть языка Python и называется "Ellipsis"</a>.
@@ -573,7 +573,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -587,7 +587,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -599,7 +599,7 @@ q: Union[str, None] = Query(default=None, min_length=3)
////
-/// tip | "Подсказка"
+/// tip | Подсказка
Pydantic, мощь которого используется в FastAPI для валидации и сериализации, имеет специальное поведение для `Optional` или `Union[Something, None]` без значения по умолчанию. Вы можете узнать об этом больше в документации Pydantic, раздел <a href="https://docs.pydantic.dev/latest/concepts/models/#required-optional-fields" class="external-link" target="_blank">Обязательные Опциональные поля</a>.
@@ -627,7 +627,7 @@ Pydantic, мощь которого используется в FastAPI для
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -639,7 +639,7 @@ Pydantic, мощь которого используется в FastAPI для
////
-/// tip | "Подсказка"
+/// tip | Подсказка
Запомните, когда вам необходимо объявить query-параметр обязательным, вы можете просто не указывать параметр `default`. Таким образом, вам редко придётся использовать `...` или `Required`.
@@ -677,7 +677,7 @@ Pydantic, мощь которого используется в FastAPI для
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -691,7 +691,7 @@ Pydantic, мощь которого используется в FastAPI для
//// tab | Python 3.9+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -705,7 +705,7 @@ Pydantic, мощь которого используется в FastAPI для
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -736,7 +736,7 @@ http://localhost:8000/items/?q=foo&q=bar
}
```
-/// tip | "Подсказка"
+/// tip | Подсказка
Чтобы объявить query-параметр типом `list`, как в примере выше, вам нужно явно использовать `Query`, иначе он будет интерпретирован как тело запроса.
@@ -768,7 +768,7 @@ http://localhost:8000/items/?q=foo&q=bar
//// tab | Python 3.9+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -782,7 +782,7 @@ http://localhost:8000/items/?q=foo&q=bar
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -833,7 +833,7 @@ http://localhost:8000/items/
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -845,7 +845,7 @@ http://localhost:8000/items/
////
-/// note | "Технические детали"
+/// note | Технические детали
Запомните, что в таком случае, FastAPI не будет проверять содержимое списка.
@@ -859,7 +859,7 @@ http://localhost:8000/items/
Указанная информация будет включена в генерируемую OpenAPI документацию и использована в пользовательском интерфейсе и внешних инструментах.
-/// note | "Технические детали"
+/// note | Технические детали
Имейте в виду, что разные инструменты могут иметь разные уровни поддержки OpenAPI.
@@ -895,7 +895,7 @@ http://localhost:8000/items/
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -909,7 +909,7 @@ http://localhost:8000/items/
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -949,7 +949,7 @@ http://localhost:8000/items/
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -963,7 +963,7 @@ http://localhost:8000/items/
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -1019,7 +1019,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -1033,7 +1033,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -1079,7 +1079,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -1093,7 +1093,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -1139,7 +1139,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
@@ -1153,7 +1153,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать версию с `Annotated` если возможно.
diff --git a/docs/ru/docs/tutorial/query-params.md b/docs/ru/docs/tutorial/query-params.md
index edf06746b..2c697224c 100644
--- a/docs/ru/docs/tutorial/query-params.md
+++ b/docs/ru/docs/tutorial/query-params.md
@@ -81,7 +81,7 @@ http://127.0.0.1:8000/items/?skip=20
В этом случае, параметр `q` будет не обязательным и будет иметь значение `None` по умолчанию.
-/// check | "Важно"
+/// check | Важно
Также обратите внимание, что **FastAPI** достаточно умён чтобы заметить, что параметр `item_id` является path-параметром, а `q` нет, поэтому, это параметр запроса.
@@ -240,7 +240,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
* `skip`, типа `int` и со значением по умолчанию `0`.
* `limit`, необязательный `int`.
-/// tip | "Подсказка"
+/// tip | Подсказка
Вы можете использовать класс `Enum` также, как ранее применяли его с [Path-параметрами](path-params.md#_7){.internal-link target=_blank}.
diff --git a/docs/ru/docs/tutorial/request-files.md b/docs/ru/docs/tutorial/request-files.md
index 34b9c94fa..836d6efed 100644
--- a/docs/ru/docs/tutorial/request-files.md
+++ b/docs/ru/docs/tutorial/request-files.md
@@ -2,7 +2,7 @@
Используя класс `File`, мы можем позволить клиентам загружать файлы.
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Чтобы получать загруженные файлы, сначала установите <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
@@ -34,7 +34,7 @@
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -68,7 +68,7 @@
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -80,7 +80,7 @@
////
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
`File` - это класс, который наследуется непосредственно от `Form`.
@@ -88,7 +88,7 @@
///
-/// tip | "Подсказка"
+/// tip | Подсказка
Для объявления тела файла необходимо использовать `File`, поскольку в противном случае параметры будут интерпретироваться как параметры запроса или параметры тела (JSON).
@@ -124,7 +124,7 @@
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -177,13 +177,13 @@ contents = await myfile.read()
contents = myfile.file.read()
```
-/// note | "Технические детали `async`"
+/// note | Технические детали `async`
При использовании методов `async` **FastAPI** запускает файловые методы в пуле потоков и ожидает их.
///
-/// note | "Технические детали Starlette"
+/// note | Технические детали Starlette
**FastAPI** наследует `UploadFile` непосредственно из **Starlette**, но добавляет некоторые детали для совместимости с **Pydantic** и другими частями FastAPI.
@@ -195,7 +195,7 @@ contents = myfile.file.read()
**FastAPI** позаботится о том, чтобы считать эти данные из нужного места, а не из JSON.
-/// note | "Технические детали"
+/// note | Технические детали
Данные из форм обычно кодируются с использованием "media type" `application/x-www-form-urlencoded` когда он не включает файлы.
@@ -205,7 +205,7 @@ contents = myfile.file.read()
///
-/// warning | "Внимание"
+/// warning | Внимание
В операции *функции операции пути* можно объявить несколько параметров `File` и `Form`, но нельзя также объявлять поля `Body`, которые предполагается получить в виде JSON, поскольку тело запроса будет закодировано с помощью `multipart/form-data`, а не `application/json`.
@@ -243,7 +243,7 @@ contents = myfile.file.read()
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -257,7 +257,7 @@ contents = myfile.file.read()
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -291,7 +291,7 @@ contents = myfile.file.read()
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -329,7 +329,7 @@ contents = myfile.file.read()
//// tab | Python 3.9+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -343,7 +343,7 @@ contents = myfile.file.read()
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -357,7 +357,7 @@ contents = myfile.file.read()
Вы получите, как и было объявлено, список `list` из `bytes` или `UploadFile`.
-/// note | "Technical Details"
+/// note | Technical Details
Можно также использовать `from starlette.responses import HTMLResponse`.
@@ -387,7 +387,7 @@ contents = myfile.file.read()
//// tab | Python 3.9+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -401,7 +401,7 @@ contents = myfile.file.read()
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
diff --git a/docs/ru/docs/tutorial/request-forms-and-files.md b/docs/ru/docs/tutorial/request-forms-and-files.md
index 9b449bcd9..fd98ec953 100644
--- a/docs/ru/docs/tutorial/request-forms-and-files.md
+++ b/docs/ru/docs/tutorial/request-forms-and-files.md
@@ -2,7 +2,7 @@
Вы можете определять файлы и поля формы одновременно, используя `File` и `Form`.
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Чтобы получать загруженные файлы и/или данные форм, сначала установите <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
@@ -30,7 +30,7 @@
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -64,7 +64,7 @@
//// tab | Python 3.6+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -80,7 +80,7 @@
Вы можете объявить некоторые файлы как `bytes`, а некоторые - как `UploadFile`.
-/// warning | "Внимание"
+/// warning | Внимание
Вы можете объявить несколько параметров `File` и `Form` в операции *path*, но вы не можете также объявить поля `Body`, которые вы ожидаете получить в виде JSON, так как запрос будет иметь тело, закодированное с помощью `multipart/form-data` вместо `application/json`.
diff --git a/docs/ru/docs/tutorial/request-forms.md b/docs/ru/docs/tutorial/request-forms.md
index 93b44437b..cd17613de 100644
--- a/docs/ru/docs/tutorial/request-forms.md
+++ b/docs/ru/docs/tutorial/request-forms.md
@@ -2,7 +2,7 @@
Когда вам нужно получить поля формы вместо JSON, вы можете использовать `Form`.
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Чтобы использовать формы, сначала установите <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
@@ -32,7 +32,7 @@
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать 'Annotated' версию, если это возможно.
@@ -66,7 +66,7 @@
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Рекомендуется использовать 'Annotated' версию, если это возможно.
@@ -84,13 +84,13 @@
Вы можете настроить `Form` точно так же, как настраиваете и `Body` ( `Query`, `Path`, `Cookie`), включая валидации, примеры, псевдонимы (например, `user-name` вместо `username`) и т.д.
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
`Form` - это класс, который наследуется непосредственно от `Body`.
///
-/// tip | "Подсказка"
+/// tip | Подсказка
Вам необходимо явно указывать параметр `Form` при объявлении каждого поля, иначе поля будут интерпретироваться как параметры запроса или параметры тела (JSON).
@@ -102,7 +102,7 @@
**FastAPI** гарантирует правильное чтение этих данных из соответствующего места, а не из JSON.
-/// note | "Технические детали"
+/// note | Технические детали
Данные из форм обычно кодируются с использованием "типа медиа" `application/x-www-form-urlencoded`.
@@ -112,7 +112,7 @@
///
-/// warning | "Предупреждение"
+/// warning | Предупреждение
Вы можете объявлять несколько параметров `Form` в *операции пути*, но вы не можете одновременно с этим объявлять поля `Body`, которые вы ожидаете получить в виде JSON, так как запрос будет иметь тело, закодированное с использованием `application/x-www-form-urlencoded`, а не `application/json`.
diff --git a/docs/ru/docs/tutorial/response-model.md b/docs/ru/docs/tutorial/response-model.md
index 363e64676..c55be38ef 100644
--- a/docs/ru/docs/tutorial/response-model.md
+++ b/docs/ru/docs/tutorial/response-model.md
@@ -83,7 +83,7 @@ FastAPI будет использовать этот возвращаемый т
////
-/// note | "Технические детали"
+/// note | Технические детали
Помните, что параметр `response_model` является параметром именно декоратора http-методов (`get`, `post`, и т.п.). Не следует его указывать для *функций операций пути*, как вы бы поступили с другими параметрами или с телом запроса.
@@ -93,7 +93,7 @@ FastAPI будет использовать этот возвращаемый т
FastAPI будет использовать значение `response_model` для того, чтобы автоматически генерировать документацию, производить валидацию и т.п. А также для **конвертации и фильтрации выходных данных** в объявленный тип.
-/// tip | "Подсказка"
+/// tip | Подсказка
Если вы используете анализаторы типов со строгой проверкой (например, mypy), можно указать `Any` в качестве типа возвращаемого значения функции.
@@ -129,7 +129,7 @@ FastAPI будет использовать значение `response_model` д
////
-/// info | "Информация"
+/// info | Информация
Чтобы использовать `EmailStr`, прежде необходимо установить <a href="https://github.com/JoshData/python-email-validator" class="external-link" target="_blank">`email-validator`</a>.
Используйте `pip install email-validator`
@@ -161,7 +161,7 @@ FastAPI будет использовать значение `response_model` д
Но что если мы захотим использовать эту модель для какой-либо другой *операции пути*? Мы можем, сами того не желая, отправить пароль любому другому пользователю.
-/// danger | "Осторожно"
+/// danger | Осторожно
Никогда не храните пароли пользователей в открытом виде, а также никогда не возвращайте их в ответе, как в примере выше. В противном случае - убедитесь, что вы хорошо продумали и учли все возможные риски такого подхода и вам известно, что вы делаете.
@@ -444,13 +444,13 @@ FastAPI совместно с Pydantic выполнит некоторую ма
}
```
-/// info | "Информация"
+/// info | Информация
"Под капотом" FastAPI использует метод `.dict()` у объектов моделей Pydantic <a href="https://docs.pydantic.dev/latest/concepts/serialization/#modeldict" class="external-link" target="_blank">с параметром `exclude_unset`</a>, чтобы достичь такого эффекта.
///
-/// info | "Информация"
+/// info | Информация
Вы также можете использовать:
@@ -494,7 +494,7 @@ FastAPI достаточно умен (на самом деле, это засл
И поэтому, они также будут включены в JSON ответа.
-/// tip | "Подсказка"
+/// tip | Подсказка
Значением по умолчанию может быть что угодно, не только `None`.
@@ -510,7 +510,7 @@ FastAPI достаточно умен (на самом деле, это засл
Это можно использовать как быстрый способ исключить данные из ответа, не создавая отдельную модель Pydantic.
-/// tip | "Подсказка"
+/// tip | Подсказка
Но по-прежнему рекомендуется следовать изложенным выше советам и использовать несколько моделей вместо данных параметров.
@@ -536,7 +536,7 @@ FastAPI достаточно умен (на самом деле, это засл
////
-/// tip | "Подсказка"
+/// tip | Подсказка
При помощи кода `{"name","description"}` создается объект множества (`set`) с двумя строковыми значениями.
diff --git a/docs/ru/docs/tutorial/response-status-code.md b/docs/ru/docs/tutorial/response-status-code.md
index 48808bea7..f08b15379 100644
--- a/docs/ru/docs/tutorial/response-status-code.md
+++ b/docs/ru/docs/tutorial/response-status-code.md
@@ -12,7 +12,7 @@
{!../../docs_src/response_status_code/tutorial001.py!}
```
-/// note | "Примечание"
+/// note | Примечание
Обратите внимание, что `status_code` является атрибутом метода-декоратора (`get`, `post` и т.д.), а не *функции-обработчика пути* в отличие от всех остальных параметров и тела запроса.
@@ -20,7 +20,7 @@
Параметр `status_code` принимает число, обозначающее HTTP код статуса ответа.
-/// info | "Информация"
+/// info | Информация
В качестве значения параметра `status_code` также может использоваться `IntEnum`, например, из библиотеки <a href="https://docs.python.org/3/library/http.html#http.HTTPStatus" class="external-link" target="_blank">`http.HTTPStatus`</a> в Python.
@@ -33,7 +33,7 @@
<img src="/img/tutorial/response-status-code/image01.png">
-/// note | "Примечание"
+/// note | Примечание
Некоторые коды статуса ответа (см. следующий раздел) указывают на то, что ответ не имеет тела.
@@ -43,7 +43,7 @@ FastAPI знает об этом и создаст документацию Open
## Об HTTP кодах статуса ответа
-/// note | "Примечание"
+/// note | Примечание
Если вы уже знаете, что представляют собой HTTP коды статуса ответа, можете перейти к следующему разделу.
@@ -66,7 +66,7 @@ FastAPI знает об этом и создаст документацию Open
* Для общих ошибок со стороны клиента можно просто использовать код `400`.
* `5XX` – статус-коды, сообщающие о серверной ошибке. Они почти никогда не используются разработчиками напрямую. Когда что-то идет не так в какой-то части кода вашего приложения или на сервере, он автоматически вернёт один из 5XX кодов.
-/// tip | "Подсказка"
+/// tip | Подсказка
Чтобы узнать больше о HTTP кодах статуса и о том, для чего каждый из них предназначен, ознакомьтесь с <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" class="external-link" target="_blank">документацией <abbr title="Mozilla Developer Network">MDN</abbr> об HTTP кодах статуса ответа</a>.
@@ -94,7 +94,7 @@ FastAPI знает об этом и создаст документацию Open
<img src="/img/tutorial/response-status-code/image02.png">
-/// note | "Технические детали"
+/// note | Технические детали
Вы также можете использовать `from starlette import status` вместо `from fastapi import status`.
diff --git a/docs/ru/docs/tutorial/security/first-steps.md b/docs/ru/docs/tutorial/security/first-steps.md
index c98ce2c60..484dfceff 100644
--- a/docs/ru/docs/tutorial/security/first-steps.md
+++ b/docs/ru/docs/tutorial/security/first-steps.md
@@ -38,7 +38,7 @@
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -52,7 +52,7 @@
## Запуск
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Вначале, установите библиотеку <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.
@@ -82,7 +82,7 @@ $ uvicorn main:app --reload
<img src="/img/tutorial/security/image01.png">
-/// check | "Кнопка авторизации!"
+/// check | Кнопка авторизации!
У вас уже появилась новая кнопка "Authorize".
@@ -94,7 +94,7 @@ $ uvicorn main:app --reload
<img src="/img/tutorial/security/image02.png">
-/// note | "Технические детали"
+/// note | Технические детали
Неважно, что вы введете в форму, она пока не будет работать. Но мы к этому еще придем.
@@ -140,7 +140,7 @@ OAuth2 был разработан для того, чтобы бэкэнд ил
В данном примере мы будем использовать **OAuth2**, с аутентификацией по паролю, используя токен **Bearer**. Для этого мы используем класс `OAuth2PasswordBearer`.
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Токен "bearer" - не единственный вариант, но для нашего случая он является наилучшим.
@@ -170,7 +170,7 @@ OAuth2 был разработан для того, чтобы бэкэнд ил
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -182,7 +182,7 @@ OAuth2 был разработан для того, чтобы бэкэнд ил
////
-/// tip | "Подсказка"
+/// tip | Подсказка
Здесь `tokenUrl="token"` ссылается на относительный URL `token`, который мы еще не создали. Поскольку это относительный URL, он эквивалентен `./token`.
@@ -196,7 +196,7 @@ OAuth2 был разработан для того, чтобы бэкэнд ил
Вскоре мы создадим и саму операцию пути.
-/// info | "Дополнительная информация"
+/// info | Дополнительная информация
Если вы очень строгий "питонист", то вам может не понравиться стиль названия параметра `tokenUrl` вместо `token_url`.
@@ -236,7 +236,7 @@ oauth2_scheme(some, parameters)
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -252,7 +252,7 @@ oauth2_scheme(some, parameters)
**FastAPI** будет знать, что он может использовать эту зависимость для определения "схемы безопасности" в схеме OpenAPI (и автоматической документации по API).
-/// info | "Технические детали"
+/// info | Технические детали
**FastAPI** будет знать, что он может использовать класс `OAuth2PasswordBearer` (объявленный в зависимости) для определения схемы безопасности в OpenAPI, поскольку он наследуется от `fastapi.security.oauth2.OAuth2`, который, в свою очередь, наследуется от `fastapi.security.base.SecurityBase`.
diff --git a/docs/ru/docs/tutorial/security/index.md b/docs/ru/docs/tutorial/security/index.md
index bd512fde3..e4969c4cf 100644
--- a/docs/ru/docs/tutorial/security/index.md
+++ b/docs/ru/docs/tutorial/security/index.md
@@ -32,7 +32,7 @@ OAuth2 включает в себя способы аутентификации
OAuth2 не указывает, как шифровать сообщение, он ожидает, что ваше приложение будет обслуживаться по протоколу HTTPS.
-/// tip | "Подсказка"
+/// tip | Подсказка
В разделе **Развертывание** вы увидите [как настроить протокол HTTPS бесплатно, используя Traefik и Let's Encrypt.](https://fastapi.tiangolo.com/ru/deployment/https/)
@@ -89,7 +89,7 @@ OpenAPI может использовать следующие схемы авт
* Это автоматическое обнаружение определено в спецификации OpenID Connect.
-/// tip | "Подсказка"
+/// tip | Подсказка
Интеграция сторонних сервисов для аутентификации/авторизации таких как Google, Facebook, Twitter, GitHub и т.д. осуществляется достаточно легко.
diff --git a/docs/ru/docs/tutorial/static-files.md b/docs/ru/docs/tutorial/static-files.md
index 4734554f3..0287fb017 100644
--- a/docs/ru/docs/tutorial/static-files.md
+++ b/docs/ru/docs/tutorial/static-files.md
@@ -11,7 +11,7 @@
{!../../docs_src/static_files/tutorial001.py!}
```
-/// note | "Технические детали"
+/// note | Технические детали
Вы также можете использовать `from starlette.staticfiles import StaticFiles`.
diff --git a/docs/ru/docs/tutorial/testing.md b/docs/ru/docs/tutorial/testing.md
index ae045bbbe..0485ef801 100644
--- a/docs/ru/docs/tutorial/testing.md
+++ b/docs/ru/docs/tutorial/testing.md
@@ -8,7 +8,7 @@
## Использование класса `TestClient`
-/// info | "Информация"
+/// info | Информация
Для использования класса `TestClient` необходимо установить библиотеку <a href="https://www.python-httpx.org" class="external-link" target="_blank">`httpx`</a>.
@@ -30,7 +30,7 @@
{!../../docs_src/app_testing/tutorial001.py!}
```
-/// tip | "Подсказка"
+/// tip | Подсказка
Обратите внимание, что тестирующая функция является обычной `def`, а не асинхронной `async def`.
@@ -40,7 +40,7 @@
///
-/// note | "Технические детали"
+/// note | Технические детали
Также можно написать `from starlette.testclient import TestClient`.
@@ -48,7 +48,7 @@
///
-/// tip | "Подсказка"
+/// tip | Подсказка
Если для тестирования Вам, помимо запросов к приложению FastAPI, необходимо вызывать асинхронные функции (например, для подключения к базе данных с помощью асинхронного драйвера), то ознакомьтесь со страницей [Асинхронное тестирование](../advanced/async-tests.md){.internal-link target=_blank} в расширенном руководстве.
@@ -148,7 +148,7 @@
//// tab | Python 3.10+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
По возможности используйте версию с `Annotated`.
@@ -162,7 +162,7 @@
//// tab | Python 3.8+ без Annotated
-/// tip | "Подсказка"
+/// tip | Подсказка
По возможности используйте версию с `Annotated`.
@@ -196,7 +196,7 @@
Для получения дополнительной информации о передаче данных на бэкенд с помощью `httpx` или `TestClient` ознакомьтесь с <a href="https://www.python-httpx.org" class="external-link" target="_blank">документацией HTTPX</a>.
-/// info | "Информация"
+/// info | Информация
Обратите внимание, что `TestClient` принимает данные, которые можно конвертировать в JSON, но не модели Pydantic.
diff --git a/docs/tr/docs/advanced/index.md b/docs/tr/docs/advanced/index.md
index 6c057162e..836e63c8a 100644
--- a/docs/tr/docs/advanced/index.md
+++ b/docs/tr/docs/advanced/index.md
@@ -6,7 +6,7 @@
İlerleyen bölümlerde diğer seçenekler, konfigürasyonlar ve ek özellikleri göreceğiz.
-/// tip | "İpucu"
+/// tip | İpucu
Sonraki bölümler **mutlaka "gelişmiş" olmak zorunda değildir**.
diff --git a/docs/tr/docs/advanced/security/index.md b/docs/tr/docs/advanced/security/index.md
index 227674bd4..709f74c72 100644
--- a/docs/tr/docs/advanced/security/index.md
+++ b/docs/tr/docs/advanced/security/index.md
@@ -4,7 +4,7 @@
[Tutorial - User Guide: Security](../../tutorial/security/index.md){.internal-link target=_blank} sayfasında ele alınanların dışında güvenlikle ilgili bazı ek özellikler vardır.
-/// tip | "İpucu"
+/// tip | İpucu
Sonraki bölümler **mutlaka "gelişmiş" olmak zorunda değildir**.
diff --git a/docs/tr/docs/advanced/testing-websockets.md b/docs/tr/docs/advanced/testing-websockets.md
index aa8a040d0..12b6ab60f 100644
--- a/docs/tr/docs/advanced/testing-websockets.md
+++ b/docs/tr/docs/advanced/testing-websockets.md
@@ -8,7 +8,7 @@ Bu işlem için, `TestClient`'ı bir `with` ifadesinde kullanarak WebSocket'e ba
{!../../docs_src/app_testing/tutorial002.py!}
```
-/// note | "Not"
+/// note | Not
Daha fazla detay için Starlette'in <a href="https://www.starlette.io/staticfiles/" class="external-link" target="_blank">Websockets'i Test Etmek</a> dokümantasyonunu inceleyin.
diff --git a/docs/tr/docs/alternatives.md b/docs/tr/docs/alternatives.md
index 286b7897a..c98b966b5 100644
--- a/docs/tr/docs/alternatives.md
+++ b/docs/tr/docs/alternatives.md
@@ -30,13 +30,13 @@ Django REST framework'ü, Django'nun API kabiliyetlerini arttırmak için arka p
**Otomatik API dökümantasyonu**nun ilk örneklerinden biri olduğu için, **FastAPI** arayışına ilham veren ilk fikirlerden biri oldu.
-/// note | "Not"
+/// note | Not
Django REST Framework'ü, aynı zamanda **FastAPI**'ın dayandığı Starlette ve Uvicorn'un da yaratıcısı olan Tom Christie tarafından geliştirildi.
///
-/// check | "**FastAPI**'a nasıl ilham verdi?"
+/// check | **FastAPI**'a nasıl ilham verdi?
Kullanıcılar için otomatik API dökümantasyonu sunan bir web arayüzüne sahip olmalı.
@@ -56,7 +56,7 @@ Uygulama parçalarının böyle ayrılıyor oluşu ve istenilen özelliklerle ge
Flask'ın basitliği göz önünde bulundurulduğu zaman, API geliştirmek için iyi bir seçim gibi görünüyordu. Sıradaki şey ise Flask için bir "Django REST Framework"!
-/// check | "**FastAPI**'a nasıl ilham verdi?"
+/// check | **FastAPI**'a nasıl ilham verdi?
Gereken araçları ve parçaları birleştirip eşleştirmeyi kolaylaştıracak bir mikro framework olmalı.
@@ -98,7 +98,7 @@ def read_url():
`requests.get(...)` ile `@app.get(...)` arasındaki benzerliklere bakın.
-/// check | "**FastAPI**'a nasıl ilham verdi?"
+/// check | **FastAPI**'a nasıl ilham verdi?
* Basit ve sezgisel bir API'ya sahip olmalı.
* HTTP metot isimlerini (işlemlerini) anlaşılır olacak bir şekilde, direkt kullanmalı.
@@ -118,7 +118,7 @@ Swagger bir noktada Linux Foundation'a verildi ve adı OpenAPI olarak değiştir
İşte bu yüzden versiyon 2.0 hakkında konuşurken "Swagger", versiyon 3 ve üzeri için ise "OpenAPI" adını kullanmak daha yaygın.
-/// check | "**FastAPI**'a nasıl ilham verdi?"
+/// check | **FastAPI**'a nasıl ilham verdi?
API spesifikasyonları için özel bir şema yerine bir <abbr title="Open Standard: Açık Standart, Açık kaynak olarak yayınlanan standart">açık standart</abbr> benimseyip kullanmalı.
@@ -147,7 +147,7 @@ Marshmallow bu özellikleri sağlamak için geliştirilmişti. Benim de geçmiş
Ama... Python'un tip belirteçleri gelmeden önce oluşturulmuştu. Yani her <abbr title="Verilerin nasıl oluşturulması gerektiğinin tanımı">şemayı</abbr> tanımlamak için Marshmallow'un sunduğu spesifik araçları ve sınıfları kullanmanız gerekiyordu.
-/// check | "**FastAPI**'a nasıl ilham verdi?"
+/// check | **FastAPI**'a nasıl ilham verdi?
Kod kullanarak otomatik olarak veri tipini ve veri doğrulamayı belirten "şemalar" tanımlamalı.
@@ -163,13 +163,13 @@ Veri doğrulama için arka planda Marshmallow kullanıyor, hatta aynı geliştir
Webargs da harika bir araç ve onu da geçmişte henüz **FastAPI** yokken çok kullandım.
-/// info | "Bilgi"
+/// info | Bilgi
Webargs aynı Marshmallow geliştirileri tarafından oluşturuldu.
///
-/// check | "**FastAPI**'a nasıl ilham verdi?"
+/// check | **FastAPI**'a nasıl ilham verdi?
Gelen istek verisi için otomatik veri doğrulamaya sahip olmalı.
@@ -191,13 +191,13 @@ Fakat sonrasında yine mikro sözdizimi problemiyle karşılaşıyoruz. Python m
Editör bu konuda pek yardımcı olamaz. Üstelik eğer parametreleri ya da Marshmallow şemalarını değiştirip YAML kodunu güncellemeyi unutursak artık döküman geçerliliğini yitiriyor.
-/// info | "Bilgi"
+/// info | Bilgi
APISpec de aynı Marshmallow geliştiricileri tarafından oluşturuldu.
///
-/// check | "**FastAPI**'a nasıl ilham verdi?"
+/// check | **FastAPI**'a nasıl ilham verdi?
API'lar için açık standart desteği olmalı (OpenAPI gibi).
@@ -223,13 +223,13 @@ Bunu kullanmak, bir kaç <abbr title="full-stack: Hem ön uç hem de arka uç ge
Aynı full-stack üreticiler [**FastAPI** Proje Üreticileri](project-generation.md){.internal-link target=_blank}'nin de temelini oluşturdu.
-/// info | "Bilgi"
+/// info | Bilgi
Flask-apispec de aynı Marshmallow geliştiricileri tarafından üretildi.
///
-/// check | "**FastAPI**'a nasıl ilham oldu?"
+/// check | **FastAPI**'a nasıl ilham oldu?
Veri dönüşümü ve veri doğrulamayı tanımlayan kodu kullanarak otomatik olarak OpenAPI şeması oluşturmalı.
@@ -249,7 +249,7 @@ Ama TypeScript verileri kod JavaScript'e derlendikten sonra korunmadığından,
İç içe geçen derin modelleri pek iyi işleyemiyor. Yani eğer istekteki JSON gövdesi derin bir JSON objesiyse düzgün bir şekilde dökümante edilip doğrulanamıyor.
-/// check | "**FastAPI**'a nasıl ilham oldu?"
+/// check | **FastAPI**'a nasıl ilham oldu?
Güzel bir editör desteği için Python tiplerini kullanmalı.
@@ -261,7 +261,7 @@ Güçlü bir bağımlılık enjeksiyon sistemine sahip olmalı. Kod tekrarını
Sanic, `asyncio`'ya dayanan son derece hızlı Python kütüphanelerinden biriydi. Flask'a epey benzeyecek şekilde geliştirilmişti.
-/// note | "Teknik detaylar"
+/// note | Teknik detaylar
İçerisinde standart Python `asyncio` döngüsü yerine <a href="https://github.com/MagicStack/uvloop" class="external-link" target="_blank">`uvloop`</a> kullanıldı. Hızının asıl kaynağı buydu.
@@ -269,7 +269,7 @@ Uvicorn ve Starlette'e ilham kaynağı olduğu oldukça açık, şu anda ikisi d
///
-/// check | "**FastAPI**'a nasıl ilham oldu?"
+/// check | **FastAPI**'a nasıl ilham oldu?
Uçuk performans sağlayacak bir yol bulmalı.
@@ -285,7 +285,7 @@ Falcon ise bir diğer yüksek performanslı Python framework'ü. Minimal olacak
Yani veri doğrulama, veri dönüştürme ve dökümantasyonun hepsi kodda yer almalı, otomatik halledemiyoruz. Ya da Falcon üzerine bir framework olarak uygulanmaları gerekiyor, aynı Hug'da olduğu gibi. Bu ayrım Falcon'un tasarımından esinlenen, istek ve cevap objelerini parametre olarak işleyen diğer kütüphanelerde de yer alıyor.
-/// check | "**FastAPI**'a nasıl ilham oldu?"
+/// check | **FastAPI**'a nasıl ilham oldu?
Harika bir performans'a sahip olmanın yollarını bulmalı.
@@ -311,7 +311,7 @@ Biraz daha detaylı ayarlamalara gerek duyuyor. Ayrıca <abbr title="ASGI (Async
<abbr title="Route: HTTP isteğinin gittiği yol">Yol</abbr>'lar fonksiyonun üstünde endpoint'i işleyen dekoratörler yerine farklı yerlerde tanımlanan fonksiyonlarla belirlenir. Bu Flask (ve Starlette) yerine daha çok Django'nun yaklaşımına daha yakın bir metot. Bu, kodda nispeten birbiriyle sıkı ilişkili olan şeyleri ayırmaya sebep oluyor.
-/// check | "**FastAPI**'a nasıl ilham oldu?"
+/// check | **FastAPI**'a nasıl ilham oldu?
Model özelliklerinin "standart" değerlerini kullanarak veri tipleri için ekstra veri doğrulama koşulları tanımlamalı. Bu editör desteğini geliştiriyor ve daha önceden Pydantic'te yoktu.
@@ -333,13 +333,13 @@ Ayrıca ilginç ve çok rastlanmayan bir özelliği vardı: aynı framework'ü k
Senkron çalışan Python web framework'lerinin standardına (WSGI) dayandığından dolayı Websocket'leri ve diğer şeyleri işleyemiyor, ancak yine de yüksek performansa sahip.
-/// info | "Bilgi"
+/// info | Bilgi
Hug, Python dosyalarında bulunan dahil etme satırlarını otomatik olarak sıralayan harika bir araç olan <a href="https://github.com/timothycrosley/isort" class="external-link" target="_blank">`isort`</a>'un geliştiricisi Timothy Crosley tarafından geliştirildi.
///
-/// check | "**FastAPI**'a nasıl ilham oldu?"
+/// check | **FastAPI**'a nasıl ilham oldu?
Hug, APIStar'ın çeşitli kısımlarında esin kaynağı oldu ve APIStar'la birlikte en umut verici bulduğum araçlardan biriydi.
@@ -373,7 +373,7 @@ Geliştiricinin Starlette'e odaklanması gerekince proje de artık bir API web f
Artık APIStar, OpenAPI özelliklerini doğrulamak için bir dizi araç sunan bir proje haline geldi.
-/// info | "Bilgi"
+/// info | Bilgi
APIStar, aşağıdaki projeleri de üreten Tom Christie tarafından geliştirildi:
@@ -383,7 +383,7 @@ APIStar, aşağıdaki projeleri de üreten Tom Christie tarafından geliştirild
///
-/// check | "**FastAPI**'a nasıl ilham oldu?"
+/// check | **FastAPI**'a nasıl ilham oldu?
Var oldu.
@@ -407,7 +407,7 @@ Tip belirteçleri kullanıyor olması onu aşırı sezgisel yapıyor.
Marshmallow ile karşılaştırılabilir. Ancak karşılaştırmalarda Marshmallowdan daha hızlı görünüyor. Aynı Python tip belirteçlerine dayanıyor ve editör desteği de harika.
-/// check | "**FastAPI** nerede kullanıyor?"
+/// check | **FastAPI** nerede kullanıyor?
Bütün veri doğrulama, veri dönüştürme ve JSON Şemasına bağlı otomatik model dökümantasyonunu halletmek için!
@@ -442,7 +442,7 @@ Ancak otomatik veri doğrulama, veri dönüştürme ve dökümantasyon sağlamyo
Bu, **FastAPI**'ın onun üzerine tamamen Python tip belirteçlerine bağlı olarak eklediği (Pydantic ile) ana şeylerden biri. **FastAPI** bunun yanında artı olarak bağımlılık enjeksiyonu sistemi, güvenlik araçları, OpenAPI şema üretimi ve benzeri özellikler de ekliyor.
-/// note | "Teknik Detaylar"
+/// note | Teknik Detaylar
ASGI, Django'nun ana ekibi tarafından geliştirilen yeni bir "standart". Bir "Python standardı" (PEP) olma sürecinde fakat henüz bir standart değil.
@@ -450,7 +450,7 @@ Bununla birlikte, halihazırda birçok araç tarafından bir "standart" olarak k
///
-/// check | "**FastAPI** nerede kullanıyor?"
+/// check | **FastAPI** nerede kullanıyor?
Tüm temel web kısımlarında üzerine özellikler eklenerek kullanılmakta.
@@ -468,7 +468,7 @@ Bir web framework'ünden ziyade bir sunucudur, yani yollara bağlı yönlendirme
Starlette ve **FastAPI** için tavsiye edilen sunucu Uvicorndur.
-/// check | "**FastAPI** neden tavsiye ediyor?"
+/// check | **FastAPI** neden tavsiye ediyor?
**FastAPI** uygulamalarını çalıştırmak için ana web sunucusu Uvicorn!
diff --git a/docs/tr/docs/async.md b/docs/tr/docs/async.md
index 0d463a2f0..558a79cb7 100644
--- a/docs/tr/docs/async.md
+++ b/docs/tr/docs/async.md
@@ -21,7 +21,7 @@ async def read_results():
return results
```
-/// note | "Not"
+/// note | Not
Sadece `async def` ile tanımlanan fonksiyonlar içinde `await` kullanabilirsiniz.
diff --git a/docs/tr/docs/how-to/index.md b/docs/tr/docs/how-to/index.md
index 798adca61..26dd9026c 100644
--- a/docs/tr/docs/how-to/index.md
+++ b/docs/tr/docs/how-to/index.md
@@ -6,7 +6,7 @@ Bu fikirlerin büyük bir kısmı aşağı yukarı **bağımsız** olacaktır,
Projeniz için ilginç ve yararlı görünen bir şey varsa devam edin ve inceleyin, aksi halde bunları atlayabilirsiniz.
-/// tip | "İpucu"
+/// tip | İpucu
**FastAPI**'ı düzgün (ve önerilen) şekilde öğrenmek istiyorsanız [Öğretici - Kullanıcı Rehberi](../tutorial/index.md){.internal-link target=_blank}'ni bölüm bölüm okuyun.
diff --git a/docs/tr/docs/python-types.md b/docs/tr/docs/python-types.md
index 9584a5732..308dfa6fb 100644
--- a/docs/tr/docs/python-types.md
+++ b/docs/tr/docs/python-types.md
@@ -12,7 +12,7 @@ Bu pythonda tip belirteçleri için **hızlı bir başlangıç / bilgi tazeleme
**FastAPI** kullanmayacak olsanız bile tür belirteçleri hakkında bilgi edinmenizde fayda var.
-/// note | "Not"
+/// note | Not
Python uzmanıysanız ve tip belirteçleri ilgili her şeyi zaten biliyorsanız, sonraki bölüme geçin.
@@ -175,7 +175,7 @@ Liste, bazı dahili tipleri içeren bir tür olduğundan, bunları köşeli para
{!../../docs_src/python_types/tutorial006.py!}
```
-/// tip | "Ipucu"
+/// tip | Ipucu
Köşeli parantez içindeki bu dahili tiplere "tip parametreleri" denir.
diff --git a/docs/tr/docs/tutorial/cookie-params.md b/docs/tr/docs/tutorial/cookie-params.md
index 895cf9b03..56bcc0c86 100644
--- a/docs/tr/docs/tutorial/cookie-params.md
+++ b/docs/tr/docs/tutorial/cookie-params.md
@@ -32,7 +32,7 @@
//// tab | Python 3.10+ non-Annotated
-/// tip | "İpucu"
+/// tip | İpucu
Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
@@ -46,7 +46,7 @@ Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
//// tab | Python 3.8+ non-Annotated
-/// tip | "İpucu"
+/// tip | İpucu
Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
@@ -90,7 +90,7 @@ Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
//// tab | Python 3.10+ non-Annotated
-/// tip | "İpucu"
+/// tip | İpucu
Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
@@ -104,7 +104,7 @@ Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
//// tab | Python 3.8+ non-Annotated
-/// tip | "İpucu"
+/// tip | İpucu
Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
@@ -116,7 +116,7 @@ Mümkün mertebe 'Annotated' sınıfını kullanmaya çalışın.
////
-/// note | "Teknik Detaylar"
+/// note | Teknik Detaylar
`Cookie` sınıfı `Path` ve `Query` sınıflarının kardeşidir. Diğerleri gibi `Param` sınıfını miras alan bir sınıftır.
@@ -124,7 +124,7 @@ Ancak `fastapi`'dan projenize dahil ettiğiniz `Query`, `Path`, `Cookie` ve diğ
///
-/// info | "Bilgi"
+/// info | Bilgi
Çerez tanımlamak için `Cookie` sınıfını kullanmanız gerekmektedir, aksi taktirde parametreler sorgu parametreleri olarak yorumlanır.
diff --git a/docs/tr/docs/tutorial/first-steps.md b/docs/tr/docs/tutorial/first-steps.md
index 335fcaece..da9057204 100644
--- a/docs/tr/docs/tutorial/first-steps.md
+++ b/docs/tr/docs/tutorial/first-steps.md
@@ -24,7 +24,7 @@ $ uvicorn main:app --reload
</div>
-/// note | "Not"
+/// note | Not
`uvicorn main:app` komutunu şu şekilde açıklayabiliriz:
@@ -139,7 +139,7 @@ Ayrıca, API'ınızla iletişim kuracak önyüz, mobil veya IoT uygulamaları gi
`FastAPI`, API'niz için tüm işlevselliği sağlayan bir Python sınıfıdır.
-/// note | "Teknik Detaylar"
+/// note | Teknik Detaylar
`FastAPI` doğrudan `Starlette`'i miras alan bir sınıftır.
@@ -205,7 +205,7 @@ https://example.com/items/foo
/items/foo
```
-/// info | "Bilgi"
+/// info | Bilgi
"Yol" genellikle "<abbr title="Endpoint: Bitim Noktası">endpoint</abbr>" veya "<abbr title="Route: Yönlendirme/Yön">route</abbr>" olarak adlandırılır.
@@ -259,7 +259,7 @@ Biz de onları "**operasyonlar**" olarak adlandıracağız.
* <abbr title="Bir HTTP GET metodu"><code>get</code> operasyonu</abbr> ile
* `/` yoluna gelen istekler
-/// info | "`@decorator` Bilgisi"
+/// info | `@decorator` Bilgisi
Python'da `@something` sözdizimi "<abbr title="Decorator">dekoratör</abbr>" olarak adlandırılır.
@@ -286,7 +286,7 @@ Daha az kullanılanları da kullanabilirsiniz:
* `@app.patch()`
* `@app.trace()`
-/// tip | "İpucu"
+/// tip | İpucu
Her işlemi (HTTP metod) istediğiniz gibi kullanmakta özgürsünüz.
@@ -324,7 +324,7 @@ Bu fonksiyonu `async def` yerine normal bir fonksiyon olarak da tanımlayabilirs
{!../../docs_src/first_steps/tutorial003.py!}
```
-/// note | "Not"
+/// note | Not
Eğer farkı bilmiyorsanız, [Async: *"Aceleniz mi var?"*](../async.md#in-a-hurry){.internal-link target=_blank} sayfasını kontrol edebilirsiniz.
diff --git a/docs/tr/docs/tutorial/path-params.md b/docs/tr/docs/tutorial/path-params.md
index 9017d99ab..c883c2f9f 100644
--- a/docs/tr/docs/tutorial/path-params.md
+++ b/docs/tr/docs/tutorial/path-params.md
@@ -24,7 +24,7 @@ Standart Python tip belirteçlerini kullanarak yol parametresinin tipini fonksiy
Bu durumda, `item_id` bir `int` olarak tanımlanacaktır.
-/// check | "Ek bilgi"
+/// check | Ek bilgi
Bu sayede, fonksiyon içerisinde hata denetimi, kod tamamlama gibi konularda editör desteğine kavuşacaksınız.
@@ -38,7 +38,7 @@ Eğer bu örneği çalıştırıp tarayıcınızda <a href="http://127.0.0.1:800
{"item_id":3}
```
-/// check | "Ek bilgi"
+/// check | Ek bilgi
Dikkatinizi çekerim ki, fonksiyonunuzun aldığı (ve döndürdüğü) değer olan `3` bir string `"3"` değil aksine bir Python `int`'idir.
@@ -71,7 +71,7 @@ Eğer tarayıcınızda <a href="http://127.0.0.1:8000/items/foo" class="external
Aynı hata <a href="http://127.0.0.1:8000/items/4.2" class="external-link" target="_blank">http://127.0.0.1:8000/items/4.2</a> sayfasında olduğu gibi `int` yerine `float` bir değer verseydik de ortaya çıkardı.
-/// check | "Ek bilgi"
+/// check | Ek bilgi
Böylece, aynı Python tip tanımlaması ile birlikte, **FastAPI** veri doğrulama özelliği sağlar.
@@ -87,7 +87,7 @@ Ayrıca, tarayıcınızı <a href="http://127.0.0.1:8000/docs" class="external-l
<img src="/img/tutorial/path-params/image01.png">
-/// check | "Ek bilgi"
+/// check | Ek bilgi
Üstelik, sadece aynı Python tip tanımlaması ile, **FastAPI** size otomatik ve interaktif (Swagger UI ile entegre) bir dokümantasyon sağlar.
@@ -153,13 +153,13 @@ Sonrasında, sınıf içerisinde, mevcut ve geçerli değerler olacak olan sabit
{!../../docs_src/path_params/tutorial005.py!}
```
-/// info | "Bilgi"
+/// info | Bilgi
3.4 sürümünden beri <a href="https://docs.python.org/3/library/enum.html" class="external-link" target="_blank">enumerationlar (ya da enumlar) Python'da mevcuttur</a>.
///
-/// tip | "İpucu"
+/// tip | İpucu
Merak ediyorsanız söyleyeyim, "AlexNet", "ResNet" ve "LeNet" isimleri Makine Öğrenmesi <abbr title="Teknik olarak, Derin Öğrenme model mimarileri">modellerini</abbr> temsil eder.
@@ -199,7 +199,7 @@ Parametreyi, yarattığınız enum olan `ModelName` içerisindeki *enumeration
{!../../docs_src/path_params/tutorial005.py!}
```
-/// tip | "İpucu"
+/// tip | İpucu
`"lenet"` değerine `ModelName.lenet.value` tanımı ile de ulaşabilirsiniz.
@@ -256,7 +256,7 @@ Böylece şunun gibi bir kullanım yapabilirsiniz:
{!../../docs_src/path_params/tutorial004.py!}
```
-/// tip | "İpucu"
+/// tip | İpucu
Parametrenin başında `/home/johndoe/myfile.txt` yolunda olduğu gibi (`/`) işareti ile birlikte kullanmanız gerektiği durumlar olabilir.
diff --git a/docs/tr/docs/tutorial/query-params.md b/docs/tr/docs/tutorial/query-params.md
index 886f5783f..b31d13be4 100644
--- a/docs/tr/docs/tutorial/query-params.md
+++ b/docs/tr/docs/tutorial/query-params.md
@@ -81,7 +81,7 @@ Aynı şekilde, varsayılan değerlerini `None` olarak atayarak isteğe bağlı
Bu durumda, `q` fonksiyon parametresi isteğe bağlı olacak ve varsayılan değer olarak `None` alacaktır.
-/// check | "Ek bilgi"
+/// check | Ek bilgi
Ayrıca, dikkatinizi çekerim ki; **FastAPI**, `item_id` parametresinin bir yol parametresi olduğunu ve `q` parametresinin yol değil bir sorgu parametresi olduğunu fark edecek kadar beceriklidir.
@@ -242,7 +242,7 @@ Bu durumda, 3 tane sorgu parametresi var olacaktır:
* `skip`, varsayılan değeri `0` olan bir `int`.
* `limit`, isteğe bağlı bir `int`.
-/// tip | "İpucu"
+/// tip | İpucu
Ayrıca, [Yol Parametrelerinde](path-params.md#on-tanml-degerler){.internal-link target=_blank} de kullanıldığı şekilde `Enum` sınıfından faydalanabilirsiniz.
diff --git a/docs/tr/docs/tutorial/request-forms.md b/docs/tr/docs/tutorial/request-forms.md
index 19b6150ff..4ed8ac021 100644
--- a/docs/tr/docs/tutorial/request-forms.md
+++ b/docs/tr/docs/tutorial/request-forms.md
@@ -2,7 +2,7 @@
İstek gövdesinde JSON verisi yerine form alanlarını karşılamanız gerketiğinde `Form` sınıfını kullanabilirsiniz.
-/// info | "Bilgi"
+/// info | Bilgi
Formları kullanmak için öncelikle <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a> paketini indirmeniz gerekmektedir.
@@ -84,13 +84,13 @@ Bu <abbr title="Spesifikasyon: Specification">spesifikasyon</abbr> form alanlar
`Form` sınıfıyla tanımlama yaparken `Body`, `Query`, `Path` ve `Cookie` sınıflarında kullandığınız aynı validasyon, örnekler, isimlendirme (örneğin `username` yerine `user-name` kullanımı) ve daha fazla konfigurasyonu kullanabilirsiniz.
-/// info | "Bilgi"
+/// info | Bilgi
`Form` doğrudan `Body` sınıfını miras alan bir sınıftır.
///
-/// tip | "İpucu"
+/// tip | İpucu
Form gövdelerini tanımlamak için `Form` sınıfını kullanmanız gerekir; çünkü bu olmadan parametreler sorgu parametreleri veya gövde (JSON) parametreleri olarak yorumlanır.
@@ -102,7 +102,7 @@ HTML formlarının (`<form></form>`) verileri sunucuya gönderirken JSON'dan far
**FastAPI** bu verilerin JSON yerine doğru şekilde okunmasını sağlayacaktır.
-/// note | "Teknik Detaylar"
+/// note | Teknik Detaylar
Form verileri normalde `application/x-www-form-urlencoded` medya tipiyle kodlanır.
@@ -112,7 +112,7 @@ Form kodlama türleri ve form alanları hakkında daha fazla bilgi edinmek istiy
///
-/// warning | "Uyarı"
+/// warning | Uyarı
*Yol operasyonları* içerisinde birden fazla `Form` parametresi tanımlayabilirsiniz ancak bunlarla birlikte JSON verisi kabul eden `Body` alanları tanımlayamazsınız çünkü bu durumda istek gövdesi `application/json` yerine `application/x-www-form-urlencoded` ile kodlanmış olur.
diff --git a/docs/tr/docs/tutorial/static-files.md b/docs/tr/docs/tutorial/static-files.md
index 8bff59744..da8bed86a 100644
--- a/docs/tr/docs/tutorial/static-files.md
+++ b/docs/tr/docs/tutorial/static-files.md
@@ -11,7 +11,7 @@
{!../../docs_src/static_files/tutorial001.py!}
```
-/// note | "Teknik Detaylar"
+/// note | Teknik Detaylar
Projenize dahil etmek için `from starlette.staticfiles import StaticFiles` kullanabilirsiniz.
diff --git a/docs/uk/docs/alternatives.md b/docs/uk/docs/alternatives.md
index 6821ffe70..1acbe237a 100644
--- a/docs/uk/docs/alternatives.md
+++ b/docs/uk/docs/alternatives.md
@@ -30,13 +30,13 @@
Це був один із перших прикладів **автоматичної документації API**, і саме це була одна з перших ідей, яка надихнула на «пошук» **FastAPI**.
-/// note | "Примітка"
+/// note | Примітка
Django REST Framework створив Том Крісті. Той самий творець Starlette і Uvicorn, на яких базується **FastAPI**.
///
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
Мати автоматичний веб-інтерфейс документації API.
@@ -56,7 +56,7 @@ Flask — це «мікрофреймворк», він не включає ін
Враховуючи простоту Flask, він здавався хорошим підходом для створення API. Наступним, що знайшов, був «Django REST Framework» для Flask.
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
Бути мікрофреймоворком. Зробити легким комбінування та поєднання необхідних інструментів та частин.
@@ -98,7 +98,7 @@ def read_url():
Зверніть увагу на схожість у `requests.get(...)` і `@app.get(...)`.
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
* Майте простий та інтуїтивно зрозумілий API.
* Використовуйте імена (операції) методів HTTP безпосередньо, простим та інтуїтивно зрозумілим способом.
@@ -118,7 +118,7 @@ def read_url():
Тому, коли говорять про версію 2.0, прийнято говорити «Swagger», а про версію 3+ «OpenAPI».
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
Прийняти і використовувати відкритий стандарт для специфікацій API замість спеціальної схеми.
@@ -147,7 +147,7 @@ Marshmallow створено для забезпечення цих функці
Але він був створений до того, як існували підказки типу Python. Отже, щоб визначити кожну <abbr title="визначення того, як дані повинні бути сформовані">схему</abbr>, вам потрібно використовувати спеціальні утиліти та класи, надані Marshmallow.
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
Використовувати код для автоматичного визначення "схем", які надають типи даних і перевірку.
@@ -163,13 +163,13 @@ Webargs — це інструмент, створений, щоб забезпе
Це чудовий інструмент, і я також часто використовував його, перш ніж створити **FastAPI**.
-/// info | "Інформація"
+/// info | Інформація
Webargs був створений тими ж розробниками Marshmallow.
///
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
Мати автоматичну перевірку даних вхідного запиту.
@@ -193,13 +193,13 @@ Marshmallow і Webargs забезпечують перевірку, аналіз
Редактор тут нічим не може допомогти. І якщо ми змінимо параметри чи схеми Marshmallow і забудемо також змінити цю строку документа YAML, згенерована схема буде застарілою.
-/// info | "Інформація"
+/// info | Інформація
APISpec був створений тими ж розробниками Marshmallow.
///
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
Підтримувати відкритий стандарт API, OpenAPI.
@@ -225,13 +225,13 @@ APISpec був створений тими ж розробниками Marshmall
І ці самі генератори повного стеку були основою [**FastAPI** генераторів проектів](project-generation.md){.internal-link target=_blank}.
-/// info | "Інформація"
+/// info | Інформація
Flask-apispec був створений тими ж розробниками Marshmallow.
///
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
Створення схеми OpenAPI автоматично з того самого коду, який визначає серіалізацію та перевірку.
@@ -251,7 +251,7 @@ Flask-apispec був створений тими ж розробниками Mar
Він не дуже добре обробляє вкладені моделі. Отже, якщо тіло JSON у запиті є об’єктом JSON із внутрішніми полями, які, у свою чергу, є вкладеними об’єктами JSON, його неможливо належним чином задокументувати та перевірити.
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
Використовувати типи Python, щоб мати чудову підтримку редактора.
@@ -263,7 +263,7 @@ Flask-apispec був створений тими ж розробниками Mar
Це був один із перших надзвичайно швидких фреймворків Python на основі `asyncio`. Він був дуже схожий на Flask.
-/// note | "Технічні деталі"
+/// note | Технічні деталі
Він використовував <a href="https://github.com/MagicStack/uvloop" class="external-link" target="_blank">`uvloop`</a> замість стандартного циклу Python `asyncio`. Ось що зробило його таким швидким.
@@ -271,7 +271,7 @@ Flask-apispec був створений тими ж розробниками Mar
///
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
Знайти спосіб отримати божевільну продуктивність.
@@ -287,7 +287,7 @@ Falcon — ще один високопродуктивний фреймворк
Таким чином, перевірка даних, серіалізація та документація повинні виконуватися в коді, а не автоматично. Або вони повинні бути реалізовані як фреймворк поверх Falcon, як Hug. Така сама відмінність спостерігається в інших фреймворках, натхненних дизайном Falcon, що мають один об’єкт запиту та один об’єкт відповіді як параметри.
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
Знайти способи отримати чудову продуктивність.
@@ -313,7 +313,7 @@ Falcon — ще один високопродуктивний фреймворк
Маршрути оголошуються в одному місці з використанням функцій, оголошених в інших місцях (замість використання декораторів, які можна розмістити безпосередньо поверх функції, яка обробляє кінцеву точку). Це ближче до того, як це робить Django, ніж до Flask (і Starlette). Він розділяє в коді речі, які відносно тісно пов’язані.
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
Визначити додаткові перевірки для типів даних, використовуючи значення "за замовчуванням" атрибутів моделі. Це покращує підтримку редактора, а раніше вона була недоступна в Pydantic.
@@ -335,13 +335,13 @@ Hug був одним із перших фреймворків, який реа
Оскільки він заснований на попередньому стандарті для синхронних веб-фреймворків Python (WSGI), він не може працювати з Websockets та іншими речами, хоча він також має високу продуктивність.
-/// info | "Інформація"
+/// info | Інформація
Hug створив Тімоті Крослі, той самий творець <a href="https://github.com/timothycrosley/isort" class="external-link" target="_blank">`isort`</a>, чудовий інструмент для автоматичного сортування імпорту у файлах Python.
///
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
Hug надихнув частину APIStar і був одним із найбільш перспективних інструментів, поряд із APIStar.
@@ -375,7 +375,7 @@ Hug надихнув частину APIStar і був одним із найбі
Тепер APIStar — це набір інструментів для перевірки специфікацій OpenAPI, а не веб-фреймворк.
-/// info | "Інформація"
+/// info | Інформація
APIStar створив Том Крісті. Той самий хлопець, який створив:
@@ -385,7 +385,7 @@ APIStar створив Том Крісті. Той самий хлопець, я
///
-/// check | "Надихнуло **FastAPI** на"
+/// check | Надихнуло **FastAPI** на
Існувати.
@@ -407,7 +407,7 @@ Pydantic — це бібліотека для визначення переві
Його можна порівняти з Marshmallow. Хоча він швидший за Marshmallow у тестах. Оскільки він базується на тих самих підказках типу Python, підтримка редактора чудова.
-/// check | "**FastAPI** використовує його для"
+/// check | **FastAPI** використовує його для
Виконання перевірки всіх даних, серіалізації даних і автоматичної документацію моделі (на основі схеми JSON).
@@ -442,7 +442,7 @@ Starlette надає всі основні функції веб-мікрофр
Це одна з головних речей, які **FastAPI** додає зверху, все на основі підказок типу Python (з використанням Pydantic). Це, а також система впровадження залежностей, утиліти безпеки, створення схеми OpenAPI тощо.
-/// note | "Технічні деталі"
+/// note | Технічні деталі
ASGI — це новий «стандарт», який розробляється членами основної команди Django. Це ще не «стандарт Python» (PEP), хоча вони в процесі цього.
@@ -450,7 +450,7 @@ ASGI — це новий «стандарт», який розробляєтьс
///
-/// check | "**FastAPI** використовує його для"
+/// check | **FastAPI** використовує його для
Керування всіма основними веб-частинами. Додавання функцій зверху.
@@ -468,7 +468,7 @@ Uvicorn — це блискавичний сервер ASGI, побудован
Це рекомендований сервер для Starlette і **FastAPI**.
-/// check | "**FastAPI** рекомендує це як"
+/// check | **FastAPI** рекомендує це як
Основний веб-сервер для запуску програм **FastAPI**.
diff --git a/docs/uk/docs/tutorial/body-fields.md b/docs/uk/docs/tutorial/body-fields.md
index b1f645932..c286744a8 100644
--- a/docs/uk/docs/tutorial/body-fields.md
+++ b/docs/uk/docs/tutorial/body-fields.md
@@ -122,7 +122,7 @@
`Field` працює так само, як `Query`, `Path` і `Body`, у нього такі самі параметри тощо.
-/// note | "Технічні деталі"
+/// note | Технічні деталі
Насправді, `Query`, `Path` та інші, що ви побачите далі, створюють об'єкти підкласів загального класу `Param`, котрий сам є підкласом класу `FieldInfo` з Pydantic.
diff --git a/docs/uk/docs/tutorial/cookie-params.md b/docs/uk/docs/tutorial/cookie-params.md
index 40ca4f6e6..229f81b63 100644
--- a/docs/uk/docs/tutorial/cookie-params.md
+++ b/docs/uk/docs/tutorial/cookie-params.md
@@ -116,7 +116,7 @@
////
-/// note | "Технічні Деталі"
+/// note | Технічні Деталі
`Cookie` це "сестра" класів `Path` і `Query`. Вони наслідуються від одного батьківського класу `Param`.
Але пам'ятайте, що коли ви імпортуєте `Query`, `Path`, `Cookie` та інше з `fastapi`, це фактично функції, що повертають спеціальні класи.
diff --git a/docs/uk/docs/tutorial/encoder.md b/docs/uk/docs/tutorial/encoder.md
index 39dca9be8..77b0baf4d 100644
--- a/docs/uk/docs/tutorial/encoder.md
+++ b/docs/uk/docs/tutorial/encoder.md
@@ -42,7 +42,7 @@
Вона не повертає велику строку `str`, яка містить дані у форматі JSON (як строка). Вона повертає стандартну структуру даних Python (наприклад `dict`) із значеннями та підзначеннями, які є сумісними з JSON.
-/// note | "Примітка"
+/// note | Примітка
`jsonable_encoder` фактично використовується **FastAPI** внутрішньо для перетворення даних. Проте вона корисна в багатьох інших сценаріях.
diff --git a/docs/uk/docs/tutorial/first-steps.md b/docs/uk/docs/tutorial/first-steps.md
index 6f79c0d1d..63fec207d 100644
--- a/docs/uk/docs/tutorial/first-steps.md
+++ b/docs/uk/docs/tutorial/first-steps.md
@@ -163,7 +163,7 @@ OpenAPI описує схему для вашого API. І ця схема вк
`FastAPI` це клас у Python, який надає всю функціональність для API.
-/// note | "Технічні деталі"
+/// note | Технічні деталі
`FastAPI` це клас, який успадковується безпосередньо від `Starlette`.
@@ -198,7 +198,7 @@ https://example.com/items/foo
/items/foo
```
-/// info | "Додаткова інформація"
+/// info | Додаткова інформація
"Шлях" (path) також зазвичай називають "ендпоінтом" (endpoint) або "маршрутом" (route).
@@ -250,7 +250,7 @@ https://example.com/items/foo
* шлях `/`
* використовуючи <abbr title="an HTTP GET method"><code>get</code> операцію</abbr>
-/// info | "`@decorator` Додаткова інформація"
+/// info | `@decorator` Додаткова інформація
Синтаксис `@something` у Python називається "декоратором".
@@ -277,7 +277,7 @@ https://example.com/items/foo
* `@app.patch()`
* `@app.trace()`
-/// tip | "Порада"
+/// tip | Порада
Ви можете використовувати кожну операцію (HTTP-метод) на свій розсуд.
@@ -315,7 +315,7 @@ FastAPI викликатиме її щоразу, коли отримає зап
{!../../docs_src/first_steps/tutorial003.py!}
```
-/// note | "Примітка"
+/// note | Примітка
Якщо не знаєте в чому різниця, подивіться [Конкурентність: *"Поспішаєш?"*](../async.md#in-a-hurry){.internal-link target=_blank}.
diff --git a/docs/vi/docs/tutorial/first-steps.md b/docs/vi/docs/tutorial/first-steps.md
index d80d78506..934527b8e 100644
--- a/docs/vi/docs/tutorial/first-steps.md
+++ b/docs/vi/docs/tutorial/first-steps.md
@@ -139,7 +139,7 @@ Bạn cũng có thể sử dụng nó để sinh code tự động, với các c
`FastAPI` là một Python class cung cấp tất cả chức năng cho API của bạn.
-/// note | "Chi tiết kĩ thuật"
+/// note | Chi tiết kĩ thuật
`FastAPI` là một class kế thừa trực tiếp `Starlette`.
diff --git a/docs/zh/docs/advanced/additional-status-codes.md b/docs/zh/docs/advanced/additional-status-codes.md
index f79b853ef..b8f9b0837 100644
--- a/docs/zh/docs/advanced/additional-status-codes.md
+++ b/docs/zh/docs/advanced/additional-status-codes.md
@@ -18,7 +18,7 @@
{!../../docs_src/additional_status_codes/tutorial001.py!}
```
-/// warning | "警告"
+/// warning | 警告
当你直接返回一个像上面例子中的 `Response` 对象时，它会直接返回。
@@ -28,7 +28,7 @@ FastAPI 不会用模型等对该响应进行序列化。
///
-/// note | "技术细节"
+/// note | 技术细节
你也可以使用 `from starlette.responses import JSONResponse`。
diff --git a/docs/zh/docs/advanced/advanced-dependencies.md b/docs/zh/docs/advanced/advanced-dependencies.md
index f3fe1e395..bd37ecebb 100644
--- a/docs/zh/docs/advanced/advanced-dependencies.md
+++ b/docs/zh/docs/advanced/advanced-dependencies.md
@@ -60,7 +60,7 @@ checker(q="somequery")
{!../../docs_src/dependencies/tutorial011.py!}
```
-/// tip | "提示"
+/// tip | 提示
本章示例有些刻意，也看不出有什么用处。
diff --git a/docs/zh/docs/advanced/behind-a-proxy.md b/docs/zh/docs/advanced/behind-a-proxy.md
index 8c4b6bb04..5ed6baa82 100644
--- a/docs/zh/docs/advanced/behind-a-proxy.md
+++ b/docs/zh/docs/advanced/behind-a-proxy.md
@@ -37,7 +37,7 @@ browser --> proxy
proxy --> server
```
-/// tip | "提示"
+/// tip | 提示
IP `0.0.0.0` 常用于指程序监听本机或服务器上的所有有效 IP。
@@ -78,7 +78,7 @@ $ uvicorn main:app --root-path /api/v1
Hypercorn 也支持 `--root-path `选项。
-/// note | "技术细节"
+/// note | 技术细节
ASGI 规范定义的 `root_path` 就是为了这种用例。
@@ -172,7 +172,7 @@ Uvicorn 预期代理在 `http://127.0.0.1:8000/app` 访问 Uvicorn，而在顶
这个文件把 Traefik 监听端口设置为 `9999`，并设置要使用另一个文件 `routes.toml`。
-/// tip | "提示"
+/// tip | 提示
使用端口 9999 代替标准的 HTTP 端口 80，这样就不必使用管理员权限运行（`sudo`）。
@@ -242,7 +242,7 @@ $ uvicorn main:app --root-path /api/v1
}
```
-/// tip | "提示"
+/// tip | 提示
注意，就算访问 `http://127.0.0.1:8000/app`，也显示从选项 `--root-path` 中提取的 `/api/v1`，这是 `root_path` 的值。
@@ -289,7 +289,7 @@ $ uvicorn main:app --root-path /api/v1
## 附加的服务器
-/// warning | "警告"
+/// warning | 警告
此用例较难，可以跳过。
@@ -332,7 +332,7 @@ $ uvicorn main:app --root-path /api/v1
}
```
-/// tip | "提示"
+/// tip | 提示
注意，自动生成服务器时，`url` 的值 `/api/v1` 提取自 `roog_path`。
@@ -342,7 +342,7 @@ $ uvicorn main:app --root-path /api/v1
<img src="/img/tutorial/behind-a-proxy/image03.png">
-/// tip | "提示"
+/// tip | 提示
API 文档与所选的服务器进行交互。
diff --git a/docs/zh/docs/advanced/custom-response.md b/docs/zh/docs/advanced/custom-response.md
index 27c026904..85ca1d06d 100644
--- a/docs/zh/docs/advanced/custom-response.md
+++ b/docs/zh/docs/advanced/custom-response.md
@@ -12,7 +12,7 @@
并且如果该 `Response` 有一个 JSON 媒体类型（`application/json`），比如使用 `JSONResponse` 或者 `UJSONResponse` 的时候，返回的数据将使用你在路径操作装饰器中声明的任何 Pydantic 的 `response_model` 自动转换（和过滤）。
-/// note | "说明"
+/// note | 说明
如果你使用不带有任何媒体类型的响应类，FastAPI 认为你的响应没有任何内容，所以不会在生成的OpenAPI文档中记录响应格式。
@@ -28,7 +28,7 @@
{!../../docs_src/custom_response/tutorial001b.py!}
```
-/// info | "提示"
+/// info | 提示
参数 `response_class` 也会用来定义响应的「媒体类型」。
@@ -38,7 +38,7 @@
///
-/// tip | "小贴士"
+/// tip | 小贴士
`ORJSONResponse` 目前只在 FastAPI 中可用，而在 Starlette 中不可用。
@@ -55,7 +55,7 @@
{!../../docs_src/custom_response/tutorial002.py!}
```
-/// info | "提示"
+/// info | 提示
参数 `response_class` 也会用来定义响应的「媒体类型」。
@@ -75,13 +75,13 @@
{!../../docs_src/custom_response/tutorial003.py!}
```
-/// warning | "警告"
+/// warning | 警告
*路径操作函数* 直接返回的 `Response` 不会被 OpenAPI 的文档记录（比如，`Content-Type` 不会被文档记录），并且在自动化交互文档中也是不可见的。
///
-/// info | "提示"
+/// info | 提示
当然，实际的 `Content-Type` 头，状态码等等，将来自于你返回的 `Response` 对象。
@@ -115,7 +115,7 @@
要记得你可以使用 `Response` 来返回任何其他东西，甚至创建一个自定义的子类。
-/// note | "技术细节"
+/// note | 技术细节
你也可以使用 `from starlette.responses import HTMLResponse`。
@@ -170,7 +170,7 @@ FastAPI（实际上是 Starlette）将自动包含 Content-Length 的头。它
`UJSONResponse` 是一个使用 <a href="https://github.com/ultrajson/ultrajson" class="external-link" target="_blank">`ujson`</a> 的可选 JSON 响应。
-/// warning | "警告"
+/// warning | 警告
在处理某些边缘情况时，`ujson` 不如 Python 的内置实现那么谨慎。
@@ -180,7 +180,7 @@ FastAPI（实际上是 Starlette）将自动包含 Content-Length 的头。它
{!../../docs_src/custom_response/tutorial001.py!}
```
-/// tip | "小贴士"
+/// tip | 小贴士
`ORJSONResponse` 可能是一个更快的选择。
@@ -212,7 +212,7 @@ FastAPI（实际上是 Starlette）将自动包含 Content-Length 的头。它
{!../../docs_src/custom_response/tutorial008.py!}
```
-/// tip | "小贴士"
+/// tip | 小贴士
注意在这里，因为我们使用的是不支持 `async` 和 `await` 的标准 `open()`，我们使用普通的 `def` 声明了路径操作。
diff --git a/docs/zh/docs/advanced/dataclasses.md b/docs/zh/docs/advanced/dataclasses.md
index f33c05ff4..7d977a0c7 100644
--- a/docs/zh/docs/advanced/dataclasses.md
+++ b/docs/zh/docs/advanced/dataclasses.md
@@ -20,7 +20,7 @@ FastAPI 基于 **Pydantic** 构建，前文已经介绍过如何使用 Pydantic
数据类的和运作方式与 Pydantic 模型相同。实际上，它的底层使用的也是 Pydantic。
-/// info | "说明"
+/// info | 说明
注意，数据类不支持 Pydantic 模型的所有功能。
diff --git a/docs/zh/docs/advanced/events.md b/docs/zh/docs/advanced/events.md
index e5b44f321..a34c03f3f 100644
--- a/docs/zh/docs/advanced/events.md
+++ b/docs/zh/docs/advanced/events.md
@@ -4,7 +4,7 @@
事件函数既可以声明为异步函数（`async def`），也可以声明为普通函数（`def`）。
-/// warning | "警告"
+/// warning | 警告
**FastAPI** 只执行主应用中的事件处理器，不执行[子应用 - 挂载](sub-applications.md){.internal-link target=_blank}中的事件处理器。
@@ -34,13 +34,13 @@
此处，`shutdown` 事件处理器函数在 `log.txt` 中写入一行文本 `Application shutdown`。
-/// info | "说明"
+/// info | 说明
`open()` 函数中，`mode="a"` 指的是**追加**。因此这行文本会添加在文件已有内容之后，不会覆盖之前的内容。
///
-/// tip | "提示"
+/// tip | 提示
注意，本例使用 Python `open()` 标准函数与文件交互。
@@ -52,7 +52,7 @@
///
-/// info | "说明"
+/// info | 说明
有关事件处理器的详情，请参阅 <a href="https://www.starlette.io/events/" class="external-link" target="_blank">Starlette 官档 - 事件</a>。
diff --git a/docs/zh/docs/advanced/middleware.md b/docs/zh/docs/advanced/middleware.md
index 525dc89ac..78a7d559c 100644
--- a/docs/zh/docs/advanced/middleware.md
+++ b/docs/zh/docs/advanced/middleware.md
@@ -43,7 +43,7 @@ app.add_middleware(UnicornMiddleware, some_config="rainbow")
**FastAPI** 为常见用例提供了一些中间件，下面介绍怎么使用这些中间件。
-/// note | "技术细节"
+/// note | 技术细节
以下几个示例中也可以使用 `from starlette.middleware.something import SomethingMiddleware`。
diff --git a/docs/zh/docs/advanced/openapi-callbacks.md b/docs/zh/docs/advanced/openapi-callbacks.md
index dc1c2539b..601cbdb5d 100644
--- a/docs/zh/docs/advanced/openapi-callbacks.md
+++ b/docs/zh/docs/advanced/openapi-callbacks.md
@@ -35,7 +35,7 @@ API 的用户 （外部开发者）要在您的 API 内使用 POST 请求创建
{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
-/// tip | "提示"
+/// tip | 提示
`callback_url` 查询参数使用 Pydantic 的 <a href="https://pydantic-docs.helpmanual.io/usage/types/#urls" class="external-link" target="_blank">URL</a> 类型。
@@ -64,7 +64,7 @@ requests.post(callback_url, json={"description": "Invoice paid", "paid": True})
本例没有实现回调本身（只是一行代码），只有文档部分。
-/// tip | "提示"
+/// tip | 提示
实际的回调只是 HTTP 请求。
@@ -80,7 +80,7 @@ requests.post(callback_url, json={"description": "Invoice paid", "paid": True})
我们要使用与存档*外部 API* 相同的知识……通过创建外部 API 要实现的*路径操作*（您的 API 要调用的）。
-/// tip | "提示"
+/// tip | 提示
编写存档回调的代码时，假设您是*外部开发者*可能会用的上。并且您当前正在实现的是*外部 API*，不是*您自己的 API*。
@@ -163,7 +163,7 @@ JSON 请求体包含如下内容：
}
```
-/// tip | "提示"
+/// tip | 提示
注意，回调 URL包含 `callback_url` （`https://www.external.org/events`）中的查询参数，还有 JSON 请求体内部的发票 ID（`2expen51ve`）。
@@ -179,7 +179,7 @@ JSON 请求体包含如下内容：
{!../../docs_src/openapi_callbacks/tutorial001.py!}
```
-/// tip | "提示"
+/// tip | 提示
注意，不能把路由本身（`invoices_callback_router`）传递给 `callback=`，要传递 `invoices_callback_router.routes` 中的 `.routes` 属性。
diff --git a/docs/zh/docs/advanced/response-cookies.md b/docs/zh/docs/advanced/response-cookies.md
index 5772664b0..2d56c6e9b 100644
--- a/docs/zh/docs/advanced/response-cookies.md
+++ b/docs/zh/docs/advanced/response-cookies.md
@@ -40,7 +40,7 @@
### 更多信息
-/// note | "技术细节"
+/// note | 技术细节
你也可以使用`from starlette.responses import Response` 或者 `from starlette.responses import JSONResponse`。
diff --git a/docs/zh/docs/advanced/response-directly.md b/docs/zh/docs/advanced/response-directly.md
index 9d191c622..934f60ef6 100644
--- a/docs/zh/docs/advanced/response-directly.md
+++ b/docs/zh/docs/advanced/response-directly.md
@@ -14,7 +14,7 @@
事实上，你可以返回任意 `Response` 或者任意 `Response` 的子类。
-/// tip | "小贴士"
+/// tip | 小贴士
`JSONResponse` 本身是一个 `Response` 的子类。
@@ -39,7 +39,7 @@
{!../../docs_src/response_directly/tutorial001.py!}
```
-/// note | "技术细节"
+/// note | 技术细节
你也可以使用 `from starlette.responses import JSONResponse`。
diff --git a/docs/zh/docs/advanced/response-headers.md b/docs/zh/docs/advanced/response-headers.md
index d593fdccc..e7861ad0c 100644
--- a/docs/zh/docs/advanced/response-headers.md
+++ b/docs/zh/docs/advanced/response-headers.md
@@ -25,7 +25,7 @@
```
-/// note | "技术细节"
+/// note | 技术细节
你也可以使用`from starlette.responses import Response`或`from starlette.responses import JSONResponse`。
diff --git a/docs/zh/docs/advanced/security/index.md b/docs/zh/docs/advanced/security/index.md
index 836086ae2..267e7ced7 100644
--- a/docs/zh/docs/advanced/security/index.md
+++ b/docs/zh/docs/advanced/security/index.md
@@ -4,7 +4,7 @@
除 [教程 - 用户指南: 安全性](../../tutorial/security/index.md){.internal-link target=_blank} 中涵盖的功能之外，还有一些额外的功能来处理安全性.
-/// tip | "小贴士"
+/// tip | 小贴士
接下来的章节 **并不一定是 "高级的"**.
diff --git a/docs/zh/docs/advanced/security/oauth2-scopes.md b/docs/zh/docs/advanced/security/oauth2-scopes.md
index d6354230e..b26522113 100644
--- a/docs/zh/docs/advanced/security/oauth2-scopes.md
+++ b/docs/zh/docs/advanced/security/oauth2-scopes.md
@@ -10,7 +10,7 @@ OAuth2 也是脸书、谷歌、GitHub、微软、推特等第三方身份验证
本章介绍如何在 **FastAPI** 应用中使用 OAuth2 作用域管理验证与授权。
-/// warning | "警告"
+/// warning | 警告
本章内容较难，刚接触 FastAPI 的新手可以跳过。
@@ -46,7 +46,7 @@ OpenAPI 中（例如 API 文档）可以定义**安全方案**。
* 脸书和 Instagram 使用 `instagram_basic`
* 谷歌使用 `https://www.googleapis.com/auth/drive`
-/// info | "说明"
+/// info | 说明
OAuth2 中，**作用域**只是声明特定权限的字符串。
@@ -94,7 +94,7 @@ OAuth2 中，**作用域**只是声明特定权限的字符串。
这样，返回的 JWT 令牌中就包含了作用域。
-/// danger | "危险"
+/// danger | 危险
为了简明起见，本例把接收的作用域直接添加到了令牌里。
@@ -122,7 +122,7 @@ OAuth2 中，**作用域**只是声明特定权限的字符串。
本例要求使用作用域 `me`（还可以使用更多作用域）。
-/// note | "笔记"
+/// note | 笔记
不必在不同位置添加不同的作用域。
@@ -134,7 +134,7 @@ OAuth2 中，**作用域**只是声明特定权限的字符串。
{!../../docs_src/security/tutorial005.py!}
```
-/// info | "技术细节"
+/// info | 技术细节
`Security` 实际上是 `Depends` 的子类，而且只比 `Depends` 多一个参数。
@@ -231,7 +231,7 @@ OAuth2 中，**作用域**只是声明特定权限的字符串。
* `security_scopes.scopes` 包含*路径操作* `read_users_me` 的 `["me"]`，因为它在依赖项里被声明
* `security_scopes.scopes` 包含用于*路径操作* `read_system_status` 的 `[]`（空列表），并且它的依赖项 `get_current_user` 也没有声明任何 `scope`
-/// tip | "提示"
+/// tip | 提示
此处重要且**神奇**的事情是，`get_current_user` 检查每个*路径操作*时可以使用不同的 `scopes` 列表。
@@ -275,7 +275,7 @@ OAuth2 中，**作用域**只是声明特定权限的字符串。
最安全的是代码流，但实现起来更复杂，而且需要更多步骤。因为它更复杂，很多第三方身份验证应用最终建议使用隐式流。
-/// note | "笔记"
+/// note | 笔记
每个身份验证应用都会采用不同方式会命名流，以便融合入自己的品牌。
diff --git a/docs/zh/docs/advanced/templates.md b/docs/zh/docs/advanced/templates.md
index 1159302a9..7692aa47b 100644
--- a/docs/zh/docs/advanced/templates.md
+++ b/docs/zh/docs/advanced/templates.md
@@ -31,20 +31,20 @@ $ pip install jinja2
{!../../docs_src/templates/tutorial001.py!}
```
-/// note | "笔记"
+/// note | 笔记
在FastAPI 0.108.0，Starlette 0.29.0之前，`name`是第一个参数。
并且，在此之前，`request`对象是作为context的一部分以键值对的形式传递的。
///
-/// tip | "提示"
+/// tip | 提示
通过声明 `response_class=HTMLResponse`，API 文档就能识别响应的对象是 HTML。
///
-/// note | "技术细节"
+/// note | 技术细节
您还可以使用 `from starlette.templating import Jinja2Templates`。
diff --git a/docs/zh/docs/advanced/testing-dependencies.md b/docs/zh/docs/advanced/testing-dependencies.md
index c3d912e2f..b4b5b32df 100644
--- a/docs/zh/docs/advanced/testing-dependencies.md
+++ b/docs/zh/docs/advanced/testing-dependencies.md
@@ -32,7 +32,7 @@
{!../../docs_src/dependency_testing/tutorial001.py!}
```
-/// tip | "提示"
+/// tip | 提示
**FastAPI** 应用中的任何位置都可以实现覆盖依赖项。
@@ -48,7 +48,7 @@ FastAPI 可以覆盖这些位置的依赖项。
app.dependency_overrides = {}
```
-/// tip | "提示"
+/// tip | 提示
如果只在某些测试时覆盖依赖项，您可以在测试开始时（在测试函数内）设置覆盖依赖项，并在结束时（在测试函数结尾）重置覆盖依赖项。
diff --git a/docs/zh/docs/advanced/testing-websockets.md b/docs/zh/docs/advanced/testing-websockets.md
index a69053f24..b30939b97 100644
--- a/docs/zh/docs/advanced/testing-websockets.md
+++ b/docs/zh/docs/advanced/testing-websockets.md
@@ -8,7 +8,7 @@
{!../../docs_src/app_testing/tutorial002.py!}
```
-/// note | "笔记"
+/// note | 笔记
更多细节详见 <a href="https://www.starlette.io/testclient/#testing-websocket-sessions" class="external-link" target="_blank">Starlette 官档 - 测试 WebSockets</a>。
diff --git a/docs/zh/docs/advanced/using-request-directly.md b/docs/zh/docs/advanced/using-request-directly.md
index 992458217..f01644de6 100644
--- a/docs/zh/docs/advanced/using-request-directly.md
+++ b/docs/zh/docs/advanced/using-request-directly.md
@@ -35,7 +35,7 @@
把*路径操作函数*的参数类型声明为 `Request`，**FastAPI** 就能把 `Request` 传递到参数里。
-/// tip | "提示"
+/// tip | 提示
注意，本例除了声明请求参数之外，还声明了路径参数。
@@ -49,7 +49,7 @@
更多细节详见 <a href="https://www.starlette.io/requests/" class="external-link" target="_blank">Starlette 官档 - `Request` 对象</a>。
-/// note | "技术细节"
+/// note | 技术细节
您也可以使用 `from starlette.requests import Request`。
diff --git a/docs/zh/docs/advanced/websockets.md b/docs/zh/docs/advanced/websockets.md
index 15ae84c58..dcd4cd5a9 100644
--- a/docs/zh/docs/advanced/websockets.md
+++ b/docs/zh/docs/advanced/websockets.md
@@ -46,7 +46,7 @@ $ pip install websockets
{!../../docs_src/websockets/tutorial001.py!}
```
-/// note | "技术细节"
+/// note | 技术细节
您也可以使用 `from starlette.websockets import WebSocket`。
diff --git a/docs/zh/docs/contributing.md b/docs/zh/docs/contributing.md
index 85b341a8d..cad093c2a 100644
--- a/docs/zh/docs/contributing.md
+++ b/docs/zh/docs/contributing.md
@@ -138,7 +138,7 @@ $ pip install -r requirements.txt
这样，你不必再去重新"安装"你的本地版本即可测试所有更改。
-/// note | "技术细节"
+/// note | 技术细节
仅当你使用此项目中的 `requirements.txt` 安装而不是直接使用 `pip install fastapi` 安装时，才会发生这种情况。
diff --git a/docs/zh/docs/fastapi-cli.md b/docs/zh/docs/fastapi-cli.md
index 00235bd02..f532c7fb7 100644
--- a/docs/zh/docs/fastapi-cli.md
+++ b/docs/zh/docs/fastapi-cli.md
@@ -80,7 +80,7 @@ FastAPI CLI 接收你的 Python 程序路径，自动检测包含 FastAPI 的变
在大多数情况下，你会（且应该）有一个“终止代理”在上层为你处理 HTTPS，这取决于你如何部署应用程序，你的服务提供商可能会为你处理此事，或者你可能需要自己设置。
-/// tip | "提示"
+/// tip | 提示
你可以在 [deployment documentation](deployment/index.md){.internal-link target=_blank} 获得更多信息。
diff --git a/docs/zh/docs/help-fastapi.md b/docs/zh/docs/help-fastapi.md
index fc47ed89d..09f37a44b 100644
--- a/docs/zh/docs/help-fastapi.md
+++ b/docs/zh/docs/help-fastapi.md
@@ -108,7 +108,7 @@
快加入 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" target="_blank">Discord 聊天服务器</a> 👥 和 FastAPI 社区里的小伙伴一起哈皮吧。
-/// tip | "提示"
+/// tip | 提示
如有问题，请在 <a href="https://github.com/fastapi/fastapi/issues/new/choose" class="external-link" target="_blank">GitHub Issues</a> 里提问，在这里更容易得到 [FastAPI 专家](fastapi-people.md#_3){.internal-link target=_blank}的帮助。
diff --git a/docs/zh/docs/tutorial/bigger-applications.md b/docs/zh/docs/tutorial/bigger-applications.md
index 64afd99af..318e10fd7 100644
--- a/docs/zh/docs/tutorial/bigger-applications.md
+++ b/docs/zh/docs/tutorial/bigger-applications.md
@@ -414,7 +414,7 @@ from .routers.users import router
它将包含来自该路由器的所有路由作为其一部分。
-/// note | "技术细节"
+/// note | 技术细节
实际上，它将在内部为声明在 `APIRouter` 中的每个*路径操作*创建一个*路径操作*。
@@ -477,7 +477,7 @@ from .routers.users import router
它将与通过 `app.include_router()` 添加的所有其他*路径操作*一起正常运行。
-/// info | "特别的技术细节"
+/// info | 特别的技术细节
**注意**：这是一个非常技术性的细节，你也许可以**直接跳过**。
diff --git a/docs/zh/docs/tutorial/body-fields.md b/docs/zh/docs/tutorial/body-fields.md
index ac59d7e6a..9aeb481ef 100644
--- a/docs/zh/docs/tutorial/body-fields.md
+++ b/docs/zh/docs/tutorial/body-fields.md
@@ -58,7 +58,7 @@
////
-/// warning | "警告"
+/// warning | 警告
注意，与从 `fastapi` 导入 `Query`，`Path`、`Body` 不同，要直接从 `pydantic` 导入 `Field` 。
@@ -122,7 +122,7 @@ Prefer to use the `Annotated` version if possible.
`Field` 的工作方式和 `Query`、`Path`、`Body` 相同，参数也相同。
-/// note | "技术细节"
+/// note | 技术细节
实际上，`Query`、`Path` 都是 `Params` 的子类，而 `Params` 类又是 Pydantic 中 `FieldInfo` 的子类。
@@ -134,7 +134,7 @@ Pydantic 的 `Field` 返回也是 `FieldInfo` 的类实例。
///
-/// tip | "提示"
+/// tip | 提示
注意，模型属性的类型、默认值及 `Field` 的代码结构与*路径操作函数*的参数相同，只不过是用 `Field` 替换了`Path`、`Query`、`Body`。
diff --git a/docs/zh/docs/tutorial/body-updates.md b/docs/zh/docs/tutorial/body-updates.md
index 5e9008d6a..9372e1dfd 100644
--- a/docs/zh/docs/tutorial/body-updates.md
+++ b/docs/zh/docs/tutorial/body-updates.md
@@ -34,7 +34,7 @@
即，只发送要更新的数据，其余数据保持不变。
-/// note | "笔记"
+/// note | 笔记
`PATCH` 没有 `PUT` 知名，也怎么不常用。
@@ -89,14 +89,14 @@
{!../../docs_src/body_updates/tutorial002.py!}
```
-/// tip | "提示"
+/// tip | 提示
实际上，HTTP `PUT` 也可以完成相同的操作。
但本节以 `PATCH` 为例的原因是，该操作就是为了这种用例创建的。
///
-/// note | "笔记"
+/// note | 笔记
注意，输入模型仍需验证。
diff --git a/docs/zh/docs/tutorial/body.md b/docs/zh/docs/tutorial/body.md
index 67a7f28e0..bf3117beb 100644
--- a/docs/zh/docs/tutorial/body.md
+++ b/docs/zh/docs/tutorial/body.md
@@ -8,7 +8,7 @@ API 基本上肯定要发送**响应体**，但是客户端不一定发送**请
使用 <a href="https://docs.pydantic.dev/" class="external-link" target="_blank">Pydantic</a> 模型声明**请求体**，能充分利用它的功能和优点。
-/// info | "说明"
+/// info | 说明
发送数据使用 `POST`（最常用）、`PUT`、`DELETE`、`PATCH` 等操作。
@@ -149,7 +149,7 @@ Pydantic 模型的 JSON 概图是 OpenAPI 生成的概图部件，可在 API 文
<img src="/img/tutorial/body/image05.png">
-/// tip | "提示"
+/// tip | 提示
使用 <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a> 编辑器时，推荐安装 <a href="https://github.com/koxudaxi/pydantic-pycharm-plugin/" class="external-link" target="_blank">Pydantic PyCharm 插件</a>。
@@ -233,7 +233,7 @@ Pydantic 模型的 JSON 概图是 OpenAPI 生成的概图部件，可在 API 文
- 类型是（`int`、`float`、`str`、`bool` 等）**单类型**的参数，是**查询**参数
- 类型是 **Pydantic 模型**的参数，是**请求体**
-/// note | "笔记"
+/// note | 笔记
因为默认值是 `None`， FastAPI 会把 `q` 当作可选参数。
diff --git a/docs/zh/docs/tutorial/cookie-params.md b/docs/zh/docs/tutorial/cookie-params.md
index b01c28238..762dca766 100644
--- a/docs/zh/docs/tutorial/cookie-params.md
+++ b/docs/zh/docs/tutorial/cookie-params.md
@@ -117,7 +117,7 @@
////
-/// note | "技术细节"
+/// note | 技术细节
`Cookie` 、`Path` 、`Query` 是**兄弟类**，都继承自共用的 `Param` 类。
@@ -125,7 +125,7 @@
///
-/// info | "说明"
+/// info | 说明
必须使用 `Cookie` 声明 cookie 参数，否则该参数会被解释为查询参数。
diff --git a/docs/zh/docs/tutorial/cors.md b/docs/zh/docs/tutorial/cors.md
index 1166d5c97..84c435c97 100644
--- a/docs/zh/docs/tutorial/cors.md
+++ b/docs/zh/docs/tutorial/cors.md
@@ -78,7 +78,7 @@
更多关于 <abbr title="Cross-Origin Resource Sharing">CORS</abbr> 的信息，请查看 <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS" class="external-link" target="_blank">Mozilla CORS 文档</a>。
-/// note | "技术细节"
+/// note | 技术细节
你也可以使用 `from starlette.middleware.cors import CORSMiddleware`。
diff --git a/docs/zh/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/zh/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index c7cfe0531..c202c977b 100644
--- a/docs/zh/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/zh/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -20,7 +20,7 @@
路径操作装饰器依赖项（以下简称为**“路径装饰器依赖项”**）的执行或解析方式和普通依赖项一样，但就算这些依赖项会返回值，它们的值也不会传递给*路径操作函数*。
-/// tip | "提示"
+/// tip | 提示
有些编辑器会检查代码中没使用过的函数参数，并显示错误提示。
@@ -30,7 +30,7 @@
///
-/// info | "说明"
+/// info | 说明
本例中，使用的是自定义响应头 `X-Key` 和 `X-Token`。
diff --git a/docs/zh/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/zh/docs/tutorial/dependencies/dependencies-with-yield.md
index a30313719..792b6784d 100644
--- a/docs/zh/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/zh/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -10,7 +10,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
///
-/// note | "技术细节"
+/// note | 技术细节
任何一个可以与以下内容一起使用的函数：
@@ -148,7 +148,7 @@ FastAPI支持在完成后执行一些<abbr title='有时也被称为"退出"("ex
**FastAPI** 将确保按正确的顺序运行所有内容。
-/// note | "技术细节"
+/// note | 技术细节
这是由 Python 的<a href="https://docs.python.org/3/library/contextlib.html" class="external-link" target="_blank">上下文管理器</a>完成的。
diff --git a/docs/zh/docs/tutorial/dependencies/index.md b/docs/zh/docs/tutorial/dependencies/index.md
index b039e1654..e0d2c5f70 100644
--- a/docs/zh/docs/tutorial/dependencies/index.md
+++ b/docs/zh/docs/tutorial/dependencies/index.md
@@ -75,7 +75,7 @@ FastAPI 提供了简单易用，但功能强大的**<abbr title="也称为组件
该函数接收的参数和*路径操作函数*的参数一样。
-/// tip | "提示"
+/// tip | 提示
下一章介绍，除了函数还有哪些「对象」可以用作依赖项。
@@ -100,7 +100,7 @@ common_parameters --> read_users
这样，只编写一次代码，**FastAPI** 就可以为多个*路径操作*共享这段代码 。
-/// check | "检查"
+/// check | 检查
注意，无需创建专门的类，并将之传递给 **FastAPI** 以进行「注册」或执行类似的操作。
@@ -118,7 +118,7 @@ common_parameters --> read_users
上述这些操作都是可行的，**FastAPI** 知道该怎么处理。
-/// note | "笔记"
+/// note | 笔记
如里不了解异步，请参阅[异步：*“着急了？”*](../../async.md){.internal-link target=_blank} 一章中 `async` 和 `await` 的内容。
diff --git a/docs/zh/docs/tutorial/dependencies/sub-dependencies.md b/docs/zh/docs/tutorial/dependencies/sub-dependencies.md
index dd4c60857..e0b75aa0c 100644
--- a/docs/zh/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/zh/docs/tutorial/dependencies/sub-dependencies.md
@@ -41,7 +41,7 @@ FastAPI 支持创建含**子依赖项**的依赖项。
{!../../docs_src/dependencies/tutorial005.py!}
```
-/// info | "信息"
+/// info | 信息
注意，这里在*路径操作函数*中只声明了一个依赖项，即 `query_or_cookie_extractor` 。
@@ -81,7 +81,7 @@ async def needy_dependency(fresh_value: str = Depends(get_value, use_cache=False
但它依然非常强大，能够声明任意嵌套深度的「图」或树状的依赖结构。
-/// tip | "提示"
+/// tip | 提示
这些简单的例子现在看上去虽然没有什么实用价值，
diff --git a/docs/zh/docs/tutorial/extra-models.md b/docs/zh/docs/tutorial/extra-models.md
index 6649b06c7..982cf15fb 100644
--- a/docs/zh/docs/tutorial/extra-models.md
+++ b/docs/zh/docs/tutorial/extra-models.md
@@ -8,7 +8,7 @@
* **输出模型**不应含密码
* **数据库模型**需要加密的密码
-/// danger | "危险"
+/// danger | 危险
千万不要存储用户的明文密码。始终存储可以进行验证的**安全哈希值**。
@@ -146,7 +146,7 @@ UserInDB(
)
```
-/// warning | "警告"
+/// warning | 警告
辅助的附加函数只是为了演示可能的数据流，但它们显然不能提供任何真正的安全机制。
@@ -194,7 +194,7 @@ FastAPI 可以做得更好。
为此，请使用 Python 标准类型提示 <a href="https://docs.python.org/3/library/typing.html#typing.Union" class="external-link" target="_blank">`typing.Union`</a>：
-/// note | "笔记"
+/// note | 笔记
定义 <a href="https://docs.pydantic.dev/latest/concepts/types/#unions" class="external-link" target="_blank">`Union`</a> 类型时，要把详细的类型写在前面，然后是不太详细的类型。下例中，更详细的 `PlaneItem` 位于 `Union[PlaneItem，CarItem]` 中的 `CarItem` 之前。
diff --git a/docs/zh/docs/tutorial/first-steps.md b/docs/zh/docs/tutorial/first-steps.md
index b9bbca193..2f573501c 100644
--- a/docs/zh/docs/tutorial/first-steps.md
+++ b/docs/zh/docs/tutorial/first-steps.md
@@ -140,7 +140,7 @@ OpenAPI 为你的 API 定义 API 模式。该模式中包含了你的 API 发送
`FastAPI` 是一个为你的 API 提供了所有功能的 Python 类。
-/// note | "技术细节"
+/// note | 技术细节
`FastAPI` 是直接从 `Starlette` 继承的类。
@@ -260,7 +260,7 @@ https://example.com/items/foo
* 请求路径为 `/`
* 使用 <abbr title="HTTP GET 方法"><code>get</code> 操作</abbr>
-/// info | "`@decorator` Info"
+/// info | `@decorator` Info
`@something` 语法在 Python 中被称为「装饰器」。
diff --git a/docs/zh/docs/tutorial/handling-errors.md b/docs/zh/docs/tutorial/handling-errors.md
index 0820c363c..799e81eb2 100644
--- a/docs/zh/docs/tutorial/handling-errors.md
+++ b/docs/zh/docs/tutorial/handling-errors.md
@@ -67,7 +67,7 @@
```
-/// tip | "提示"
+/// tip | 提示
触发 `HTTPException` 时，可以用参数 `detail` 传递任何能转换为 JSON 的值，不仅限于 `str`。
@@ -116,7 +116,7 @@
```
-/// note | "技术细节"
+/// note | 技术细节
`from starlette.requests import Request` 和 `from starlette.responses import JSONResponse` 也可以用于导入 `Request` 和 `JSONResponse`。
@@ -176,7 +176,7 @@ path -> item_id
### `RequestValidationError` vs `ValidationError`
-/// warning | "警告"
+/// warning | 警告
如果您觉得现在还用不到以下技术细节，可以先跳过下面的内容。
@@ -203,7 +203,7 @@ path -> item_id
```
-/// note | "技术细节"
+/// note | 技术细节
还可以使用 `from starlette.responses import PlainTextResponse`。
diff --git a/docs/zh/docs/tutorial/header-params.md b/docs/zh/docs/tutorial/header-params.md
index 4de8bf4df..c45a6b095 100644
--- a/docs/zh/docs/tutorial/header-params.md
+++ b/docs/zh/docs/tutorial/header-params.md
@@ -116,7 +116,7 @@
////
-/// note | "技术细节"
+/// note | 技术细节
`Header` 是 `Path`、`Query`、`Cookie` 的**兄弟类**，都继承自共用的 `Param` 类。
@@ -124,7 +124,7 @@
///
-/// info | "说明"
+/// info | 说明
必须使用 `Header` 声明 header 参数，否则该参数会被解释为查询参数。
@@ -198,7 +198,7 @@
////
-/// warning | "警告"
+/// warning | 警告
注意，使用 `convert_underscores = False` 要慎重，有些 HTTP 代理和服务器不支持使用带有下划线的请求头。
diff --git a/docs/zh/docs/tutorial/metadata.md b/docs/zh/docs/tutorial/metadata.md
index 7252db9f6..2398f3e01 100644
--- a/docs/zh/docs/tutorial/metadata.md
+++ b/docs/zh/docs/tutorial/metadata.md
@@ -46,7 +46,7 @@
注意你可以在描述内使用 Markdown，例如「login」会显示为粗体（**login**）以及「fancy」会显示为斜体（_fancy_）。
-/// tip | "提示"
+/// tip | 提示
不必为你使用的所有标签都添加元数据。
@@ -60,7 +60,7 @@
{!../../docs_src/metadata/tutorial004.py!}
```
-/// info | "信息"
+/// info | 信息
阅读更多关于标签的信息[路径操作配置](path-operation-configuration.md#tags){.internal-link target=_blank}。
diff --git a/docs/zh/docs/tutorial/middleware.md b/docs/zh/docs/tutorial/middleware.md
index fb2874ba3..8076f8d52 100644
--- a/docs/zh/docs/tutorial/middleware.md
+++ b/docs/zh/docs/tutorial/middleware.md
@@ -11,7 +11,7 @@
* 它可以对该**响应**做些什么或者执行任何需要的代码.
* 然后它返回这个 **响应**.
-/// note | "技术细节"
+/// note | 技术细节
如果你使用了 `yield` 关键字依赖, 依赖中的退出代码将在执行中间件*后*执行.
@@ -43,7 +43,7 @@
///
-/// note | "技术细节"
+/// note | 技术细节
你也可以使用 `from starlette.requests import Request`.
diff --git a/docs/zh/docs/tutorial/path-operation-configuration.md b/docs/zh/docs/tutorial/path-operation-configuration.md
index 12e1f24ba..add370d1c 100644
--- a/docs/zh/docs/tutorial/path-operation-configuration.md
+++ b/docs/zh/docs/tutorial/path-operation-configuration.md
@@ -2,7 +2,7 @@
*路径操作装饰器*支持多种配置参数。
-/// warning | "警告"
+/// warning | 警告
注意：以下参数应直接传递给**路径操作装饰器**，不能传递给*路径操作函数*。
@@ -22,7 +22,7 @@
状态码在响应中使用，并会被添加到 OpenAPI 概图。
-/// note | "技术细节"
+/// note | 技术细节
也可以使用 `from starlette import status` 导入状态码。
@@ -72,13 +72,13 @@ OpenAPI 概图会自动添加标签，供 API 文档接口使用：
{!../../docs_src/path_operation_configuration/tutorial005.py!}
```
-/// info | "说明"
+/// info | 说明
注意，`response_description` 只用于描述响应，`description` 一般则用于描述*路径操作*。
///
-/// check | "检查"
+/// check | 检查
OpenAPI 规定每个*路径操作*都要有响应描述。
diff --git a/docs/zh/docs/tutorial/path-params-numeric-validations.md b/docs/zh/docs/tutorial/path-params-numeric-validations.md
index 29197ac53..3a1ebdbca 100644
--- a/docs/zh/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/zh/docs/tutorial/path-params-numeric-validations.md
@@ -222,7 +222,7 @@ Python 不会对该 `*` 做任何事情，但是它将知道之后的所有参
///
-/// note | "技术细节"
+/// note | 技术细节
当你从 `fastapi` 导入 `Query`、`Path` 和其他同类对象时，它们实际上是函数。
diff --git a/docs/zh/docs/tutorial/path-params.md b/docs/zh/docs/tutorial/path-params.md
index a29ee0e2b..0666783e2 100644
--- a/docs/zh/docs/tutorial/path-params.md
+++ b/docs/zh/docs/tutorial/path-params.md
@@ -24,7 +24,7 @@ FastAPI 支持使用 Python 字符串格式化语法声明**路径参数**（**
本例把 `item_id` 的类型声明为 `int`。
-/// check | "检查"
+/// check | 检查
类型声明将为函数提供错误检查、代码补全等编辑器支持。
@@ -38,7 +38,7 @@ FastAPI 支持使用 Python 字符串格式化语法声明**路径参数**（**
{"item_id":3}
```
-/// check | "检查"
+/// check | 检查
注意，函数接收并返回的值是 `3`（ `int`），不是 `"3"`（`str`）。
@@ -69,7 +69,7 @@ FastAPI 支持使用 Python 字符串格式化语法声明**路径参数**（**
值的类型不是 `int ` 而是浮点数（`float`）时也会显示同样的错误，比如： <a href="http://127.0.0.1:8000/items/4.2" class="external-link" target="_blank">http://127.0.0.1:8000/items/4.2。</a>
-/// check | "检查"
+/// check | 检查
**FastAPI** 使用 Python 类型声明实现了数据校验。
@@ -85,7 +85,7 @@ FastAPI 支持使用 Python 字符串格式化语法声明**路径参数**（**
<img src="/img/tutorial/path-params/image01.png">
-/// check | "检查"
+/// check | 检查
还是使用 Python 类型声明，**FastAPI** 提供了（集成 Swagger UI 的）API 文档。
@@ -143,13 +143,13 @@ FastAPI 充分地利用了 <a href="https://docs.pydantic.dev/" class="external-
{!../../docs_src/path_params/tutorial005.py!}
```
-/// info | "说明"
+/// info | 说明
Python 3.4 及之后版本支持<a href="https://docs.python.org/3/library/enum.html" class="external-link" target="_blank">枚举（即 enums）</a>。
///
-/// tip | "提示"
+/// tip | 提示
**AlexNet**、**ResNet**、**LeNet** 是机器学习<abbr title="技术上来说是深度学习模型架构">模型</abbr>。
@@ -189,7 +189,7 @@ Python 3.4 及之后版本支持<a href="https://docs.python.org/3/library/enum.
{!../../docs_src/path_params/tutorial005.py!}
```
-/// tip | "提示"
+/// tip | 提示
使用 `ModelName.lenet.value` 也能获取值 `"lenet"`。
@@ -246,7 +246,7 @@ OpenAPI 不支持声明包含路径的*路径参数*，因为这会导致测试
{!../../docs_src/path_params/tutorial004.py!}
```
-/// tip | "提示"
+/// tip | 提示
注意，包含 `/home/johndoe/myfile.txt` 的路径参数要以斜杠（`/`）开头。
diff --git a/docs/zh/docs/tutorial/query-params.md b/docs/zh/docs/tutorial/query-params.md
index f17d43d3a..4a9917be2 100644
--- a/docs/zh/docs/tutorial/query-params.md
+++ b/docs/zh/docs/tutorial/query-params.md
@@ -81,13 +81,13 @@ http://127.0.0.1:8000/items/?skip=20
本例中，查询参数 `q` 是可选的，默认值为 `None`。
-/// check | "检查"
+/// check | 检查
注意，**FastAPI** 可以识别出 `item_id` 是路径参数，`q` 不是路径参数，而是查询参数。
///
-/// note | "笔记"
+/// note | 笔记
因为默认值为 `= None`，FastAPI 把 `q` 识别为可选参数。
@@ -249,7 +249,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
* `skip`，默认值为 `0` 的 `int` 类型参数
* `limit`，可选的 `int` 类型参数
-/// tip | "提示"
+/// tip | 提示
还可以像在[路径参数](path-params.md#_8){.internal-link target=_blank} 中那样使用 `Enum`。
diff --git a/docs/zh/docs/tutorial/request-files.md b/docs/zh/docs/tutorial/request-files.md
index 026771495..5a68d1d3f 100644
--- a/docs/zh/docs/tutorial/request-files.md
+++ b/docs/zh/docs/tutorial/request-files.md
@@ -2,7 +2,7 @@
`File` 用于定义客户端的上传文件。
-/// info | "说明"
+/// info | 说明
因为上传文件以「表单数据」形式发送。
@@ -28,7 +28,7 @@
{!../../docs_src/request_files/tutorial001.py!}
```
-/// info | "说明"
+/// info | 说明
`File` 是直接继承自 `Form` 的类。
@@ -36,7 +36,7 @@
///
-/// tip | "提示"
+/// tip | 提示
声明文件体必须使用 `File`，否则，FastAPI 会把该参数当作查询参数或请求体（JSON）参数。
@@ -98,13 +98,13 @@ contents = await myfile.read()
contents = myfile.file.read()
```
-/// note | "`async` 技术细节"
+/// note | `async` 技术细节
使用 `async` 方法时，**FastAPI** 在线程池中执行文件方法，并 `await` 操作完成。
///
-/// note | "Starlette 技术细节"
+/// note | Starlette 技术细节
**FastAPI** 的 `UploadFile` 直接继承自 **Starlette** 的 `UploadFile`，但添加了一些必要功能，使之与 **Pydantic** 及 FastAPI 的其它部件兼容。
@@ -116,7 +116,7 @@ contents = myfile.file.read()
**FastAPI** 要确保从正确的位置读取数据，而不是读取 JSON。
-/// note | "技术细节"
+/// note | 技术细节
不包含文件时，表单数据一般用 `application/x-www-form-urlencoded`「媒体类型」编码。
@@ -126,7 +126,7 @@ contents = myfile.file.read()
///
-/// warning | "警告"
+/// warning | 警告
可在一个*路径操作*中声明多个 `File` 和 `Form` 参数，但不能同时声明要接收 JSON 的 `Body` 字段。因为此时请求体的编码是 `multipart/form-data`，不是 `application/json`。
@@ -189,7 +189,7 @@ FastAPI 支持同时上传多个文件。
接收的也是含 `bytes` 或 `UploadFile` 的列表（`list`）。
-/// note | "技术细节"
+/// note | 技术细节
也可以使用 `from starlette.responses import HTMLResponse`。
diff --git a/docs/zh/docs/tutorial/request-forms-and-files.md b/docs/zh/docs/tutorial/request-forms-and-files.md
index ae0fd82ca..bd87f5b68 100644
--- a/docs/zh/docs/tutorial/request-forms-and-files.md
+++ b/docs/zh/docs/tutorial/request-forms-and-files.md
@@ -2,7 +2,7 @@
FastAPI 支持同时使用 `File` 和 `Form` 定义文件和表单字段。
-/// info | "说明"
+/// info | 说明
接收上传文件或表单数据，要预先安装 <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>。
@@ -28,7 +28,7 @@ FastAPI 支持同时使用 `File` 和 `Form` 定义文件和表单字段。
声明文件可以使用 `bytes` 或 `UploadFile` 。
-/// warning | "警告"
+/// warning | 警告
可在一个*路径操作*中声明多个 `File` 与 `Form` 参数，但不能同时声明要接收 JSON 的 `Body` 字段。因为此时请求体的编码为 `multipart/form-data`，不是 `application/json`。
diff --git a/docs/zh/docs/tutorial/request-forms.md b/docs/zh/docs/tutorial/request-forms.md
index 94c8839b3..5938bb83d 100644
--- a/docs/zh/docs/tutorial/request-forms.md
+++ b/docs/zh/docs/tutorial/request-forms.md
@@ -2,7 +2,7 @@
接收的不是 JSON，而是表单字段时，要使用 `Form`。
-/// info | "说明"
+/// info | 说明
要使用表单，需预先安装 <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>。
@@ -32,13 +32,13 @@
使用 `Form` 可以声明与 `Body` （及 `Query`、`Path`、`Cookie`）相同的元数据和验证。
-/// info | "说明"
+/// info | 说明
`Form` 是直接继承自 `Body` 的类。
///
-/// tip | "提示"
+/// tip | 提示
声明表单体要显式使用 `Form` ，否则，FastAPI 会把该参数当作查询参数或请求体（JSON）参数。
@@ -50,7 +50,7 @@
**FastAPI** 要确保从正确的位置读取数据，而不是读取 JSON。
-/// note | "技术细节"
+/// note | 技术细节
表单数据的「媒体类型」编码一般为 `application/x-www-form-urlencoded`。
@@ -60,7 +60,7 @@
///
-/// warning | "警告"
+/// warning | 警告
可在一个*路径操作*中声明多个 `Form` 参数，但不能同时声明要接收 JSON 的 `Body` 字段。因为此时请求体的编码是 `application/x-www-form-urlencoded`，不是 `application/json`。
diff --git a/docs/zh/docs/tutorial/response-model.md b/docs/zh/docs/tutorial/response-model.md
index 40fb40720..fd0facca8 100644
--- a/docs/zh/docs/tutorial/response-model.md
+++ b/docs/zh/docs/tutorial/response-model.md
@@ -51,7 +51,7 @@ FastAPI 将使用此 `response_model` 来：
* 会将输出数据限制在该模型定义内。下面我们会看到这一点有多重要。
-/// note | "技术细节"
+/// note | 技术细节
响应模型在参数中被声明，而不是作为函数返回类型的注解，这是因为路径函数可能不会真正返回该响应模型，而是返回一个 `dict`、数据库对象或其他模型，然后再使用 `response_model` 来执行字段约束和序列化。
diff --git a/docs/zh/docs/tutorial/response-status-code.md b/docs/zh/docs/tutorial/response-status-code.md
index 55bf502ae..1e5e7964f 100644
--- a/docs/zh/docs/tutorial/response-status-code.md
+++ b/docs/zh/docs/tutorial/response-status-code.md
@@ -12,7 +12,7 @@
{!../../docs_src/response_status_code/tutorial001.py!}
```
-/// note | "笔记"
+/// note | 笔记
注意，`status_code` 是（`get`、`post` 等）**装饰器**方法中的参数。与之前的参数和请求体不同，不是*路径操作函数*的参数。
@@ -20,7 +20,7 @@
`status_code` 参数接收表示 HTTP 状态码的数字。
-/// info | "说明"
+/// info | 说明
`status_code` 还能接收 `IntEnum` 类型，比如 Python 的 <a href="https://docs.python.org/3/library/http.html#http.HTTPStatus" class="external-link" target="_blank">`http.HTTPStatus`</a>。
@@ -33,7 +33,7 @@
<img src="/img/tutorial/response-status-code/image01.png">
-/// note | "笔记"
+/// note | 笔记
某些响应状态码表示响应没有响应体（参阅下一章）。
@@ -43,7 +43,7 @@ FastAPI 可以进行识别，并生成表明无响应体的 OpenAPI 文档。
## 关于 HTTP 状态码
-/// note | "笔记"
+/// note | 笔记
如果已经了解 HTTP 状态码，请跳到下一章。
@@ -66,7 +66,7 @@ FastAPI 可以进行识别，并生成表明无响应体的 OpenAPI 文档。
* 对于来自客户端的一般错误，可以只使用 `400`
* `500` 及以上的状态码用于表示服务器端错误。几乎永远不会直接使用这些状态码。应用代码或服务器出现问题时，会自动返回这些状态代码
-/// tip | "提示"
+/// tip | 提示
状态码及适用场景的详情，请参阅 <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" class="external-link" target="_blank"><abbr title="Mozilla Developer Network">MDN 的 HTTP 状态码</abbr>文档</a>。
@@ -94,7 +94,7 @@ FastAPI 可以进行识别，并生成表明无响应体的 OpenAPI 文档。
<img src="../../../../../../img/tutorial/response-status-code/image02.png">
-/// note | "技术细节"
+/// note | 技术细节
也可以使用 `from starlette import status`。
diff --git a/docs/zh/docs/tutorial/security/first-steps.md b/docs/zh/docs/tutorial/security/first-steps.md
index 8294b6444..561721f6e 100644
--- a/docs/zh/docs/tutorial/security/first-steps.md
+++ b/docs/zh/docs/tutorial/security/first-steps.md
@@ -52,7 +52,7 @@
## 运行
-/// info | "说明"
+/// info | 说明
先安装 <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>。
@@ -82,7 +82,7 @@ $ uvicorn main:app --reload
<img src="/img/tutorial/security/image01.png">
-/// check | "Authorize 按钮！"
+/// check | Authorize 按钮！
页面右上角出现了一个「**Authorize**」按钮。
@@ -94,7 +94,7 @@ $ uvicorn main:app --reload
<img src="/img/tutorial/security/image02.png">
-/// note | "笔记"
+/// note | 笔记
目前，在表单中输入内容不会有任何反应，后文会介绍相关内容。
@@ -140,7 +140,7 @@ OAuth2 的设计目标是为了让后端或 API 独立于服务器验证用户
本例使用 **OAuth2** 的 **Password** 流以及 **Bearer** 令牌（`Token`）。为此要使用 `OAuth2PasswordBearer` 类。
-/// info | "说明"
+/// info | 说明
`Bearer` 令牌不是唯一的选择。
@@ -158,7 +158,7 @@ OAuth2 的设计目标是为了让后端或 API 独立于服务器验证用户
{!../../docs_src/security/tutorial001.py!}
```
-/// tip | "提示"
+/// tip | 提示
在此，`tokenUrl="token"` 指向的是暂未创建的相对 URL `token`。这个相对 URL 相当于 `./token`。
@@ -172,7 +172,7 @@ OAuth2 的设计目标是为了让后端或 API 独立于服务器验证用户
接下来，学习如何创建实际的路径操作。
-/// info | "说明"
+/// info | 说明
严苛的 **Pythonista** 可能不喜欢用 `tokenUrl` 这种命名风格代替 `token_url`。
@@ -202,7 +202,7 @@ oauth2_scheme(some, parameters)
**FastAPI** 使用依赖项在 OpenAPI 概图（及 API 文档）中定义**安全方案**。
-/// info | "技术细节"
+/// info | 技术细节
**FastAPI** 使用（在依赖项中声明的）类 `OAuth2PasswordBearer` 在 OpenAPI 中定义安全方案，这是因为它继承自 `fastapi.security.oauth2.OAuth2`，而该类又是继承自`fastapi.security.base.SecurityBase`。
diff --git a/docs/zh/docs/tutorial/security/get-current-user.md b/docs/zh/docs/tutorial/security/get-current-user.md
index 97461817a..e0f763b30 100644
--- a/docs/zh/docs/tutorial/security/get-current-user.md
+++ b/docs/zh/docs/tutorial/security/get-current-user.md
@@ -55,7 +55,7 @@
这有助于在函数内部使用代码补全和类型检查。
-/// tip | "提示"
+/// tip | 提示
还记得请求体也是使用 Pydantic 模型声明的吧。
@@ -63,7 +63,7 @@
///
-/// check | "检查"
+/// check | 检查
依赖系统的这种设计方式可以支持不同的依赖项返回同一个 `User` 模型。
diff --git a/docs/zh/docs/tutorial/security/oauth2-jwt.md b/docs/zh/docs/tutorial/security/oauth2-jwt.md
index 8e497b844..4bb6e6318 100644
--- a/docs/zh/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/zh/docs/tutorial/security/oauth2-jwt.md
@@ -40,7 +40,7 @@ $ pip install pyjwt
</div>
-/// info | "说明"
+/// info | 说明
如果您打算使用类似 RSA 或 ECDSA 的数字签名算法，您应该安装加密库依赖项 `pyjwt[crypto]`。
@@ -82,7 +82,7 @@ $ pip install passlib[bcrypt]
</div>
-/// tip | "提示"
+/// tip | 提示
`passlib` 甚至可以读取 Django、Flask 的安全插件等工具创建的密码。
@@ -98,7 +98,7 @@ $ pip install passlib[bcrypt]
创建用于密码哈希和身份校验的 PassLib **上下文**。
-/// tip | "提示"
+/// tip | 提示
PassLib 上下文还支持使用不同哈希算法的功能，包括只能校验的已弃用旧算法等。
@@ -166,7 +166,7 @@ Prefer to use the `Annotated` version if possible.
////
-/// note | "笔记"
+/// note | 笔记
查看新的（伪）数据库 `fake_users_db`，就能看到哈希后的密码：`"$2b$12$EixZaYVK1fsbw1ZfbX3OXePaWxn96p36WQoeG6Lruj3vjPGga31lW"`。
@@ -358,7 +358,7 @@ JWT 规范还包括 `sub` 键，值是令牌的主题。
用户名: `johndoe` 密码: `secret`
-/// check | "检查"
+/// check | 检查
注意，代码中没有明文密码**`secret`**，只保存了它的哈希值。
@@ -383,7 +383,7 @@ JWT 规范还包括 `sub` 键，值是令牌的主题。
<img src="https://fastapi.tiangolo.com/img/tutorial/security/image10.png">
-/// note | "笔记"
+/// note | 笔记
注意，请求中 `Authorization` 响应头的值以 `Bearer` 开头。
diff --git a/docs/zh/docs/tutorial/security/simple-oauth2.md b/docs/zh/docs/tutorial/security/simple-oauth2.md
index 1f031a6b2..8ce9263db 100644
--- a/docs/zh/docs/tutorial/security/simple-oauth2.md
+++ b/docs/zh/docs/tutorial/security/simple-oauth2.md
@@ -32,7 +32,7 @@ OAuth2 还支持客户端发送**`scope`**表单字段。
* 脸书和 Instagram 使用 `instagram_basic`
* 谷歌使用 `https://www.googleapis.com/auth/drive`
-/// info | "说明"
+/// info | 说明
OAuth2 中，**作用域**只是声明指定权限的字符串。
@@ -63,7 +63,7 @@ OAuth2 中，**作用域**只是声明指定权限的字符串。
* 可选的 `scope` 字段，由多个空格分隔的字符串组成的长字符串
* 可选的 `grant_type`
-/// tip | "提示"
+/// tip | 提示
实际上，OAuth2 规范*要求* `grant_type` 字段使用固定值 `password`，但 `OAuth2PasswordRequestForm` 没有作强制约束。
@@ -74,7 +74,7 @@ OAuth2 中，**作用域**只是声明指定权限的字符串。
* 可选的 `client_id`（本例未使用）
* 可选的 `client_secret`（本例未使用）
-/// info | "说明"
+/// info | 说明
`OAuth2PasswordRequestForm` 与 `OAuth2PasswordBearer` 一样，都不是 FastAPI 的特殊类。
@@ -88,7 +88,7 @@ OAuth2 中，**作用域**只是声明指定权限的字符串。
### 使用表单数据
-/// tip | "提示"
+/// tip | 提示
`OAuth2PasswordRequestForm` 类依赖项的实例没有以空格分隔的长字符串属性 `scope`，但它支持 `scopes` 属性，由已发送的 scope 字符串列表组成。
@@ -150,7 +150,7 @@ UserInDB(
)
```
-/// info | "说明"
+/// info | 说明
`user_dict` 的说明，详见[**更多模型**一章](../extra-models.md#user_indict){.internal-link target=_blank}。
@@ -166,7 +166,7 @@ UserInDB(
本例只是简单的演示，返回的 Token 就是 `username`，但这种方式极不安全。
-/// tip | "提示"
+/// tip | 提示
下一章介绍使用哈希密码和 <abbr title="JSON Web Tokens">JWT</abbr> Token 的真正安全机制。
@@ -178,7 +178,7 @@ UserInDB(
{!../../docs_src/security/tutorial003.py!}
```
-/// tip | "提示"
+/// tip | 提示
按规范的要求，应像本示例一样，返回带有 `access_token` 和 `token_type` 的 JSON 对象。
@@ -206,7 +206,7 @@ UserInDB(
{!../../docs_src/security/tutorial003.py!}
```
-/// info | "说明"
+/// info | 说明
此处返回值为 `Bearer` 的响应头 `WWW-Authenticate` 也是规范的一部分。
diff --git a/docs/zh/docs/tutorial/sql-databases.md b/docs/zh/docs/tutorial/sql-databases.md
index 379c44143..06b373e6d 100644
--- a/docs/zh/docs/tutorial/sql-databases.md
+++ b/docs/zh/docs/tutorial/sql-databases.md
@@ -167,7 +167,7 @@ connect_args={"check_same_thread": False}
...仅用于`SQLite`，在其他数据库不需要它。
-/// info | "技术细节"
+/// info | 技术细节
默认情况下，SQLite 只允许一个线程与其通信，假设有多个线程的话，也只将处理一个独立的请求。
@@ -630,7 +630,7 @@ SQLAlchemy 模型`User`包含一个`hashed_password`，它应该是一个包含
////
-/// info | "技术细节"
+/// info | 技术细节
参数`db`实际上是 type `SessionLocal`，但是这个类（用 创建`sessionmaker()`）是 SQLAlchemy 的“代理” `Session`，所以，编辑器并不真正知道提供了哪些方法。
@@ -713,7 +713,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
///
-/// note | "Very Technical Details"
+/// note | Very Technical Details
如果您很好奇并且拥有深厚的技术知识，您可以在[Async](https://fastapi.tiangolo.com/zh/async/#very-technical-details)文档中查看有关如何处理 `async def`于`def`差别的技术细节。
diff --git a/docs/zh/docs/tutorial/static-files.md b/docs/zh/docs/tutorial/static-files.md
index 37e90ad43..7580f731b 100644
--- a/docs/zh/docs/tutorial/static-files.md
+++ b/docs/zh/docs/tutorial/static-files.md
@@ -11,7 +11,7 @@
{!../../docs_src/static_files/tutorial001.py!}
```
-/// note | "技术细节"
+/// note | 技术细节
你也可以用 `from starlette.staticfiles import StaticFiles`。
diff --git a/docs/zh/docs/tutorial/testing.md b/docs/zh/docs/tutorial/testing.md
index 173e6f8a6..bb3ef8a6a 100644
--- a/docs/zh/docs/tutorial/testing.md
+++ b/docs/zh/docs/tutorial/testing.md
@@ -8,7 +8,7 @@
## 使用 `TestClient`
-/// info | "信息"
+/// info | 信息
要使用 `TestClient`，先要安装 <a href="https://www.python-httpx.org" class="external-link" target="_blank">`httpx`</a>.
@@ -30,7 +30,7 @@
{!../../docs_src/app_testing/tutorial001.py!}
```
-/// tip | "提示"
+/// tip | 提示
注意测试函数是普通的 `def`，不是 `async def`。
@@ -40,7 +40,7 @@
///
-/// note | "技术细节"
+/// note | 技术细节
你也可以用 `from starlette.testclient import TestClient`。
@@ -48,7 +48,7 @@
///
-/// tip | "提示"
+/// tip | 提示
除了发送请求之外，如果你还想测试时在FastAPI应用中调用 `async` 函数（例如异步数据库函数）， 可以在高级教程中看下 [Async Tests](../advanced/async-tests.md){.internal-link target=_blank} 。
@@ -148,7 +148,7 @@
//// tab | Python 3.10+ non-Annotated
-/// tip | "提示"
+/// tip | 提示
Prefer to use the `Annotated` version if possible.
@@ -162,7 +162,7 @@ Prefer to use the `Annotated` version if possible.
//// tab | Python 3.8+ non-Annotated
-/// tip | "提示"
+/// tip | 提示
Prefer to use the `Annotated` version if possible.
@@ -196,7 +196,7 @@ Prefer to use the `Annotated` version if possible.
关于如何传数据给后端的更多信息 (使用`httpx` 或 `TestClient`)，请查阅 <a href="https://www.python-httpx.org" class="external-link" target="_blank">HTTPX 文档</a>.
-/// info | "信息"
+/// info | 信息
注意 `TestClient` 接收可以被转化为JSON的数据，而不是Pydantic模型。
From d9119528eaf6d83dcdc906e318169d49ce0cc71b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 16:41:55 +0000
Subject: [PATCH 492/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fa66930fc..5c40995da 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Fix admonition double quotes with new syntax. PR [#12835](https://github.com/fastapi/fastapi/pull/12835) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes in `docs/zh/docs/advanced/additional-responses.md`. PR [#12828](https://github.com/fastapi/fastapi/pull/12828) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/tutorial/path-params-numeric-validations.md`. PR [#12825](https://github.com/fastapi/fastapi/pull/12825) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes for `docs/en/docs/advanced/testing-websockets.md`. PR [#12761](https://github.com/fastapi/fastapi/pull/12761) by [@hamidrasti](https://github.com/hamidrasti).
From ac4956d3a32f3046142bd987d0576bc0c07d7af0 Mon Sep 17 00:00:00 2001
From: AyushSinghal1794 <89984761+AyushSinghal1794@users.noreply.github.com>
Date: Sat, 9 Nov 2024 22:22:15 +0530
Subject: [PATCH 493/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/en/docs/advanced/generate-clients.md`=20(#12642)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/advanced/generate-clients.md | 48 ++---------------------
1 file changed, 3 insertions(+), 45 deletions(-)
diff --git a/docs/en/docs/advanced/generate-clients.md b/docs/en/docs/advanced/generate-clients.md
index 7872103c3..fe4194ac7 100644
--- a/docs/en/docs/advanced/generate-clients.md
+++ b/docs/en/docs/advanced/generate-clients.md
@@ -32,21 +32,7 @@ There are also several other companies offering similar services that you can se
Let's start with a simple FastAPI application:
-//// tab | Python 3.9+
-
-```Python hl_lines="7-9 12-13 16-17 21"
-{!> ../../docs_src/generate_clients/tutorial001_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="9-11 14-15 18 19 23"
-{!> ../../docs_src/generate_clients/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/generate_clients/tutorial001_py39.py hl[7:9,12:13,16:17,21] *}
Notice that the *path operations* define the models they use for request payload and response payload, using the models `Item` and `ResponseMessage`.
@@ -151,21 +137,7 @@ In many cases your FastAPI app will be bigger, and you will probably use tags to
For example, you could have a section for **items** and another section for **users**, and they could be separated by tags:
-//// tab | Python 3.9+
-
-```Python hl_lines="21 26 34"
-{!> ../../docs_src/generate_clients/tutorial002_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="23 28 36"
-{!> ../../docs_src/generate_clients/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/generate_clients/tutorial002_py39.py hl[21,26,34] *}
### Generate a TypeScript Client with Tags
@@ -212,21 +184,7 @@ For example, here it is using the first tag (you will probably have only one tag
You can then pass that custom function to **FastAPI** as the `generate_unique_id_function` parameter:
-//// tab | Python 3.9+
-
-```Python hl_lines="6-7 10"
-{!> ../../docs_src/generate_clients/tutorial003_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="8-9 12"
-{!> ../../docs_src/generate_clients/tutorial003.py!}
-```
-
-////
+{* ../../docs_src/generate_clients/tutorial003_py39.py hl[6:7,10] *}
### Generate a TypeScript Client with Custom Operation IDs
From 5d1cb40c5eb0fbad9ef4590f5f54be094437fdd1 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 16:52:39 +0000
Subject: [PATCH 494/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 5c40995da..8a2a0547b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/en/docs/advanced/generate-clients.md`. PR [#12642](https://github.com/fastapi/fastapi/pull/12642) by [@AyushSinghal1794](https://github.com/AyushSinghal1794).
* 📝 Fix admonition double quotes with new syntax. PR [#12835](https://github.com/fastapi/fastapi/pull/12835) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes in `docs/zh/docs/advanced/additional-responses.md`. PR [#12828](https://github.com/fastapi/fastapi/pull/12828) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/tutorial/path-params-numeric-validations.md`. PR [#12825](https://github.com/fastapi/fastapi/pull/12825) by [@zhaohan-dong](https://github.com/zhaohan-dong).
From aaab24205faf3198101e373c0b217143eaca02a9 Mon Sep 17 00:00:00 2001
From: Zhaohan Dong <65422392+zhaohan-dong@users.noreply.github.com>
Date: Sat, 9 Nov 2024 16:53:31 +0000
Subject: [PATCH 495/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20in?=
=?UTF-8?q?=20`docs/de/docs/advanced/additional-responses.md`=20(#12821)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/de/docs/advanced/additional-responses.md | 16 ++++------------
1 file changed, 4 insertions(+), 12 deletions(-)
diff --git a/docs/de/docs/advanced/additional-responses.md b/docs/de/docs/advanced/additional-responses.md
index 29a7b064a..bf38d9795 100644
--- a/docs/de/docs/advanced/additional-responses.md
+++ b/docs/de/docs/advanced/additional-responses.md
@@ -26,9 +26,7 @@ Jedes dieser Response-`dict`s kann einen Schlüssel `model` haben, welcher ein P
Um beispielsweise eine weitere Response mit dem Statuscode `404` und einem Pydantic-Modell `Message` zu deklarieren, können Sie schreiben:
-```Python hl_lines="18 22"
-{!../../docs_src/additional_responses/tutorial001.py!}
-```
+{* ../../docs_src/additional_responses/tutorial001.py hl[18,22] *}
/// note | Hinweis
@@ -177,9 +175,7 @@ Sie können denselben `responses`-Parameter verwenden, um verschiedene Medientyp
Sie können beispielsweise einen zusätzlichen Medientyp `image/png` hinzufügen und damit deklarieren, dass Ihre *Pfadoperation* ein JSON-Objekt (mit dem Medientyp `application/json`) oder ein PNG-Bild zurückgeben kann:
-```Python hl_lines="19-24 28"
-{!../../docs_src/additional_responses/tutorial002.py!}
-```
+{* ../../docs_src/additional_responses/tutorial002.py hl[19:24,28] *}
/// note | Hinweis
@@ -207,9 +203,7 @@ Sie können beispielsweise eine Response mit dem Statuscode `404` deklarieren, d
Und eine Response mit dem Statuscode `200`, die Ihr `response_model` verwendet, aber ein benutzerdefiniertes Beispiel (`example`) enthält:
-```Python hl_lines="20-31"
-{!../../docs_src/additional_responses/tutorial003.py!}
-```
+{* ../../docs_src/additional_responses/tutorial003.py hl[20:31] *}
Es wird alles kombiniert und in Ihre OpenAPI eingebunden und in der API-Dokumentation angezeigt:
@@ -243,9 +237,7 @@ Mit dieser Technik können Sie einige vordefinierte Responses in Ihren *Pfadoper
Zum Beispiel:
-```Python hl_lines="13-17 26"
-{!../../docs_src/additional_responses/tutorial004.py!}
-```
+{* ../../docs_src/additional_responses/tutorial004.py hl[13:17,26] *}
## Weitere Informationen zu OpenAPI-Responses
From a81662b3c15aaa0b2bd618296dc88c965d9aaf11 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 16:56:02 +0000
Subject: [PATCH 496/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8a2a0547b..efa480f5b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes in `docs/de/docs/advanced/additional-responses.md`. PR [#12821](https://github.com/fastapi/fastapi/pull/12821) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/advanced/generate-clients.md`. PR [#12642](https://github.com/fastapi/fastapi/pull/12642) by [@AyushSinghal1794](https://github.com/AyushSinghal1794).
* 📝 Fix admonition double quotes with new syntax. PR [#12835](https://github.com/fastapi/fastapi/pull/12835) by [@tiangolo](https://github.com/tiangolo).
* 📝 Update includes in `docs/zh/docs/advanced/additional-responses.md`. PR [#12828](https://github.com/fastapi/fastapi/pull/12828) by [@zhaohan-dong](https://github.com/zhaohan-dong).
From 6e7e6f6c5593ce7c26441317fe427bbacf67d19a Mon Sep 17 00:00:00 2001
From: Okeke Chukwuemeka Christian <okekechristian1960@yahoo.com>
Date: Sat, 9 Nov 2024 16:59:54 +0000
Subject: [PATCH 497/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/tutorial/security/first-steps.md`=20(#12643)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/security/first-steps.md | 90 +------------------
1 file changed, 3 insertions(+), 87 deletions(-)
diff --git a/docs/en/docs/tutorial/security/first-steps.md b/docs/en/docs/tutorial/security/first-steps.md
index 37e37cb5b..8f6578e12 100644
--- a/docs/en/docs/tutorial/security/first-steps.md
+++ b/docs/en/docs/tutorial/security/first-steps.md
@@ -20,35 +20,7 @@ Let's first just use the code and see how it works, and then we'll come back to
Copy the example in a file `main.py`:
-//// tab | Python 3.9+
-
-```Python
-{!> ../../docs_src/security/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python
-{!> ../../docs_src/security/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python
-{!> ../../docs_src/security/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial001_an_py39.py *}
## Run it
@@ -160,35 +132,7 @@ In that case, **FastAPI** also provides you with the tools to build it.
When we create an instance of the `OAuth2PasswordBearer` class we pass in the `tokenUrl` parameter. This parameter contains the URL that the client (the frontend running in the user's browser) will use to send the `username` and `password` in order to get a token.
-//// tab | Python 3.9+
-
-```Python hl_lines="8"
-{!> ../../docs_src/security/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="7"
-{!> ../../docs_src/security/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="6"
-{!> ../../docs_src/security/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial001_an_py39.py hl[8] *}
/// tip
@@ -226,35 +170,7 @@ So, it can be used with `Depends`.
Now you can pass that `oauth2_scheme` in a dependency with `Depends`.
-//// tab | Python 3.9+
-
-```Python hl_lines="12"
-{!> ../../docs_src/security/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="11"
-{!> ../../docs_src/security/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="10"
-{!> ../../docs_src/security/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial001_an_py39.py hl[12] *}
This dependency will provide a `str` that is assigned to the parameter `token` of the *path operation function*.
From f5b8f39ed77b1ee5b5b5474cab8f50a9868cb27f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 17:01:51 +0000
Subject: [PATCH 498/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index efa480f5b..2baba2d16 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/tutorial/security/first-steps.md`. PR [#12643](https://github.com/fastapi/fastapi/pull/12643) by [@OCE1960](https://github.com/OCE1960).
* 📝 Update includes in `docs/de/docs/advanced/additional-responses.md`. PR [#12821](https://github.com/fastapi/fastapi/pull/12821) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/advanced/generate-clients.md`. PR [#12642](https://github.com/fastapi/fastapi/pull/12642) by [@AyushSinghal1794](https://github.com/AyushSinghal1794).
* 📝 Fix admonition double quotes with new syntax. PR [#12835](https://github.com/fastapi/fastapi/pull/12835) by [@tiangolo](https://github.com/tiangolo).
From f26a1b638536a672a83ff29d4ace8543b51032c2 Mon Sep 17 00:00:00 2001
From: Okeke Chukwuemeka Christian <okekechristian1960@yahoo.com>
Date: Sat, 9 Nov 2024 17:03:01 +0000
Subject: [PATCH 499/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20includes=20for?=
=?UTF-8?q?=20`docs/en/docs/tutorial/security/get-current-user.md`=20(#126?=
=?UTF-8?q?45)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../tutorial/security/get-current-user.md | 290 +-----------------
1 file changed, 6 insertions(+), 284 deletions(-)
diff --git a/docs/en/docs/tutorial/security/get-current-user.md b/docs/en/docs/tutorial/security/get-current-user.md
index 069806621..5de3a8e7d 100644
--- a/docs/en/docs/tutorial/security/get-current-user.md
+++ b/docs/en/docs/tutorial/security/get-current-user.md
@@ -2,35 +2,7 @@
In the previous chapter the security system (which is based on the dependency injection system) was giving the *path operation function* a `token` as a `str`:
-//// tab | Python 3.9+
-
-```Python hl_lines="12"
-{!> ../../docs_src/security/tutorial001_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="11"
-{!> ../../docs_src/security/tutorial001_an.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="10"
-{!> ../../docs_src/security/tutorial001.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial001_an_py39.py hl[12] *}
But that is still not that useful.
@@ -42,57 +14,7 @@ First, let's create a Pydantic user model.
The same way we use Pydantic to declare bodies, we can use it anywhere else:
-//// tab | Python 3.10+
-
-```Python hl_lines="5 12-16"
-{!> ../../docs_src/security/tutorial002_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="5 12-16"
-{!> ../../docs_src/security/tutorial002_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="5 13-17"
-{!> ../../docs_src/security/tutorial002_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="3 10-14"
-{!> ../../docs_src/security/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="5 12-16"
-{!> ../../docs_src/security/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial002_an_py310.py hl[5,12:6] *}
## Create a `get_current_user` dependency
@@ -104,169 +26,19 @@ Remember that dependencies can have sub-dependencies?
The same as we were doing before in the *path operation* directly, our new dependency `get_current_user` will receive a `token` as a `str` from the sub-dependency `oauth2_scheme`:
-//// tab | Python 3.10+
-
-```Python hl_lines="25"
-{!> ../../docs_src/security/tutorial002_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="25"
-{!> ../../docs_src/security/tutorial002_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="26"
-{!> ../../docs_src/security/tutorial002_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="23"
-{!> ../../docs_src/security/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="25"
-{!> ../../docs_src/security/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial002_an_py310.py hl[25] *}
## Get the user
`get_current_user` will use a (fake) utility function we created, that takes a token as a `str` and returns our Pydantic `User` model:
-//// tab | Python 3.10+
-
-```Python hl_lines="19-22 26-27"
-{!> ../../docs_src/security/tutorial002_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="19-22 26-27"
-{!> ../../docs_src/security/tutorial002_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="20-23 27-28"
-{!> ../../docs_src/security/tutorial002_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="17-20 24-25"
-{!> ../../docs_src/security/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="19-22 26-27"
-{!> ../../docs_src/security/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial002_an_py310.py hl[19:22,26:27] *}
## Inject the current user
So now we can use the same `Depends` with our `get_current_user` in the *path operation*:
-//// tab | Python 3.10+
-
-```Python hl_lines="31"
-{!> ../../docs_src/security/tutorial002_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="31"
-{!> ../../docs_src/security/tutorial002_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="32"
-{!> ../../docs_src/security/tutorial002_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="29"
-{!> ../../docs_src/security/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="31"
-{!> ../../docs_src/security/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial002_an_py310.py hl[31] *}
Notice that we declare the type of `current_user` as the Pydantic model `User`.
@@ -320,57 +92,7 @@ And all of them (or any portion of them that you want) can take advantage of re-
And all these thousands of *path operations* can be as small as 3 lines:
-//// tab | Python 3.10+
-
-```Python hl_lines="30-32"
-{!> ../../docs_src/security/tutorial002_an_py310.py!}
-```
-
-////
-
-//// tab | Python 3.9+
-
-```Python hl_lines="30-32"
-{!> ../../docs_src/security/tutorial002_an_py39.py!}
-```
-
-////
-
-//// tab | Python 3.8+
-
-```Python hl_lines="31-33"
-{!> ../../docs_src/security/tutorial002_an.py!}
-```
-
-////
-
-//// tab | Python 3.10+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="28-30"
-{!> ../../docs_src/security/tutorial002_py310.py!}
-```
-
-////
-
-//// tab | Python 3.8+ non-Annotated
-
-/// tip
-
-Prefer to use the `Annotated` version if possible.
-
-///
-
-```Python hl_lines="30-32"
-{!> ../../docs_src/security/tutorial002.py!}
-```
-
-////
+{* ../../docs_src/security/tutorial002_an_py310.py hl[30:32] *}
## Recap
From 5df1415feee3522e3716ec88311498757c34fa8b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 17:04:00 +0000
Subject: [PATCH 500/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2baba2d16..0fa073bcd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* 📝 Update includes for `docs/en/docs/tutorial/security/get-current-user.md`. PR [#12645](https://github.com/fastapi/fastapi/pull/12645) by [@OCE1960](https://github.com/OCE1960).
* 📝 Update includes for `docs/en/docs/tutorial/security/first-steps.md`. PR [#12643](https://github.com/fastapi/fastapi/pull/12643) by [@OCE1960](https://github.com/OCE1960).
* 📝 Update includes in `docs/de/docs/advanced/additional-responses.md`. PR [#12821](https://github.com/fastapi/fastapi/pull/12821) by [@zhaohan-dong](https://github.com/zhaohan-dong).
* 📝 Update includes in `docs/en/docs/advanced/generate-clients.md`. PR [#12642](https://github.com/fastapi/fastapi/pull/12642) by [@AyushSinghal1794](https://github.com/AyushSinghal1794).
From 40912999d1e28caf49a7eb5295b662a72dff2e4a Mon Sep 17 00:00:00 2001
From: Alejandra <90076947+alejsdev@users.noreply.github.com>
Date: Sat, 9 Nov 2024 17:07:05 +0000
Subject: [PATCH 501/504] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20error=20in?=
=?UTF-8?q?=20`docs/en/docs/tutorial/middleware.md`=20(#12819)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/en/docs/tutorial/middleware.md | 1 -
1 file changed, 1 deletion(-)
diff --git a/docs/en/docs/tutorial/middleware.md b/docs/en/docs/tutorial/middleware.md
index 4693d977a..53c47a085 100644
--- a/docs/en/docs/tutorial/middleware.md
+++ b/docs/en/docs/tutorial/middleware.md
@@ -60,7 +60,6 @@ For example, you could add a custom header `X-Process-Time` containing the time
{* ../../docs_src/middleware/tutorial001.py hl[10,12:13] *}
/// tip
-```Python hl_lines="10 12-13"
Here we use <a href="https://docs.python.org/3/library/time.html#time.perf_counter" class="external-link" target="_blank">`time.perf_counter()`</a> instead of `time.time()` because it can be more precise for these use cases. 🤓
From 5d03558363d91e6addd65c611b80742ec681187c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 17:07:31 +0000
Subject: [PATCH 502/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 0fa073bcd..ce96154e9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
### Docs
+* ✏️ Fix error in `docs/en/docs/tutorial/middleware.md`. PR [#12819](https://github.com/fastapi/fastapi/pull/12819) by [@alejsdev](https://github.com/alejsdev).
* 📝 Update includes for `docs/en/docs/tutorial/security/get-current-user.md`. PR [#12645](https://github.com/fastapi/fastapi/pull/12645) by [@OCE1960](https://github.com/OCE1960).
* 📝 Update includes for `docs/en/docs/tutorial/security/first-steps.md`. PR [#12643](https://github.com/fastapi/fastapi/pull/12643) by [@OCE1960](https://github.com/OCE1960).
* 📝 Update includes in `docs/de/docs/advanced/additional-responses.md`. PR [#12821](https://github.com/fastapi/fastapi/pull/12821) by [@zhaohan-dong](https://github.com/zhaohan-dong).
From 98182d02ce01c0fe074107e55d5f82bea6d35d30 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 9 Nov 2024 21:13:48 +0100
Subject: [PATCH 503/504] =?UTF-8?q?=F0=9F=94=A8=20Update=20docs=20preview?=
=?UTF-8?q?=20script=20to=20show=20previous=20version=20and=20English=20ve?=
=?UTF-8?q?rsion=20(#12856)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
scripts/deploy_docs_status.py | 36 ++++++++++++++++++++++++++---------
1 file changed, 27 insertions(+), 9 deletions(-)
diff --git a/scripts/deploy_docs_status.py b/scripts/deploy_docs_status.py
index 19dffbcb9..c652cdb6e 100644
--- a/scripts/deploy_docs_status.py
+++ b/scripts/deploy_docs_status.py
@@ -2,7 +2,7 @@ import logging
import re
from github import Github
-from pydantic import SecretStr
+from pydantic import BaseModel, SecretStr
from pydantic_settings import BaseSettings
@@ -15,7 +15,13 @@ class Settings(BaseSettings):
is_done: bool = False
-def main():
+class LinkData(BaseModel):
+ previous_link: str
+ preview_link: str
+ en_link: str | None = None
+
+
+def main() -> None:
logging.basicConfig(level=logging.INFO)
settings = Settings()
@@ -60,7 +66,7 @@ def main():
docs_files = [f for f in files if f.filename.startswith("docs/")]
deploy_url = settings.deploy_url.rstrip("/")
- lang_links: dict[str, list[str]] = {}
+ lang_links: dict[str, list[LinkData]] = {}
for f in docs_files:
match = re.match(r"docs/([^/]+)/docs/(.*)", f.filename)
if not match:
@@ -71,15 +77,22 @@ def main():
path = path.replace("index.md", "")
else:
path = path.replace(".md", "/")
+ en_path = path
if lang == "en":
- link = f"{deploy_url}/{path}"
+ use_path = en_path
else:
- link = f"{deploy_url}/{lang}/{path}"
+ use_path = f"{lang}/{path}"
+ link = LinkData(
+ previous_link=f"https://fastapi.tiangolo.com/{use_path}",
+ preview_link=f"{deploy_url}/{use_path}",
+ )
+ if lang != "en":
+ link.en_link = f"https://fastapi.tiangolo.com/{en_path}"
lang_links.setdefault(lang, []).append(link)
- links: list[str] = []
+ links: list[LinkData] = []
en_links = lang_links.get("en", [])
- en_links.sort()
+ en_links.sort(key=lambda x: x.preview_link)
links.extend(en_links)
langs = list(lang_links.keys())
@@ -88,14 +101,19 @@ def main():
if lang == "en":
continue
current_lang_links = lang_links[lang]
- current_lang_links.sort()
+ current_lang_links.sort(key=lambda x: x.preview_link)
links.extend(current_lang_links)
message = f"📝 Docs preview for commit {settings.commit_sha} at: {deploy_url}"
if links:
message += "\n\n### Modified Pages\n\n"
- message += "\n".join([f"* {link}" for link in links])
+ for link in links:
+ message += f"* {link.preview_link}"
+ message += f" - ([before]({link.previous_link}))"
+ if link.en_link:
+ message += f" - ([English]({link.en_link}))"
+ message += "\n"
print(message)
use_pr.as_issue().create_comment(message)
From df6d1de3e6d5266d73a6eb9d7b2f12262927a6e1 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 9 Nov 2024 20:14:12 +0000
Subject: [PATCH 504/504] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[skip ci]
---
docs/en/docs/release-notes.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ce96154e9..50518f8e4 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -106,6 +106,7 @@ hide:
### Internal
+* 🔨 Update docs preview script to show previous version and English version. PR [#12856](https://github.com/fastapi/fastapi/pull/12856) by [@tiangolo](https://github.com/tiangolo).
* ⬆ Bump tiangolo/latest-changes from 0.3.1 to 0.3.2. PR [#12794](https://github.com/fastapi/fastapi/pull/12794) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump pypa/gh-action-pypi-publish from 1.12.0 to 1.12.2. PR [#12788](https://github.com/fastapi/fastapi/pull/12788) by [@dependabot[bot]](https://github.com/apps/dependabot).
* ⬆ Bump pypa/gh-action-pypi-publish from 1.11.0 to 1.12.0. PR [#12781](https://github.com/fastapi/fastapi/pull/12781) by [@dependabot[bot]](https://github.com/apps/dependabot).