Form
No overview available.
def Form(
default: Any = Undefined,
default_factory: Callable[[], Any] | None = _Unset,
media_type: str = "application/x-www-form-urlencoded",
alias: str | None = None,
alias_priority: int | None = _Unset,
validation_alias: str | AliasPath | AliasChoices | None = None,
serialization_alias: str | None = None,
title: str | None = None,
description: str | None = None,
gt: float | None = None,
ge: float | None = None,
lt: float | None = None,
le: float | None = None,
min_length: int | None = None,
max_length: int | None = None,
pattern: str | None = None,
regex: str | None = None,
discriminator: str | None = None,
strict: bool | None = _Unset,
multiple_of: float | None = _Unset,
allow_inf_nan: bool | None = _Unset,
max_digits: int | None = _Unset,
decimal_places: int | None = _Unset,
examples: list[Any] | None = None,
example: Any | None = _Unset,
openapi_examples: dict[str, Example] | None = None,
deprecated: deprecated | str | bool | None = None,
include_in_schema: bool = True,
json_schema_extra: dict[str, Any] | None = None,
extra: Any = deprecated
) - > Any
Creates a Form parameter field with various validation and OpenAPI generation options. This function is used to define how a form field should be processed, including its default value, validation rules, and how it appears in generated API documentation.
Parameters
| Name | Type | Description |
|---|---|---|
| default | Any = Undefined | The default value to use if the parameter field is not explicitly set by the caller. |
| default_factory | `Callable[[], Any] | None` = _Unset |
| media_type | str = "application/x-www-form-urlencoded" | The media type associated with this parameter field. While it influences the generated OpenAPI documentation, it does not currently affect how the data is parsed. |
| alias | `str | None` = None |
| alias_priority | `int | None` = _Unset |
| validation_alias | `str | AliasPath |
| serialization_alias | `str | None` = None |
| title | `str | None` = None |
| description | `str | None` = None |
| gt | `float | None` = None |
| ge | `float | None` = None |
| lt | `float | None` = None |
| le | `float | None` = None |
| min_length | `int | None` = None |
| max_length | `int | None` = None |
| pattern | `str | None` = None |
| regex | `str | None` = None |
| discriminator | `str | None` = None |
| strict | `bool | None` = _Unset |
| multiple_of | `float | None` = _Unset |
| allow_inf_nan | `bool | None` = _Unset |
| max_digits | `int | None` = _Unset |
| decimal_places | `int | None` = _Unset |
| examples | `list[Any] | None` = None |
| example | `Any | None` = _Unset |
| openapi_examples | `dict[str, Example] | None` = None |
| deprecated | `deprecated | str |
| include_in_schema | bool = True | Determines whether this parameter field should be included in the generated OpenAPI schema. |
| json_schema_extra | `dict[str, Any] | None` = None |
| extra | Any = deprecated | Additional fields used by the JSON Schema. This parameter is deprecated; use json_schema_extra instead. |
Returns
| Type | Description |
|---|---|
Any | A parameter field configured with the specified options. |