Skip to content
You're viewing docs for v2.8. See the latest version →

Aliases

Support for alias configurations.

AliasPath

Usage docs: https://docs.pydantic.dev/2.8/concepts/alias#aliaspath-and-aliaschoices

A data class used by validation_alias as a convenience to create aliases.

Attributes

path

Type: list[int | str] Default: [first_arg] + list(args)

Methods

convert_to_aliases

def convert_to_aliases() -> list[str | int]

Converts arguments to a list of string or integer aliases.

Returns

list[str | int] — The list of aliases.

search_dict_for_path

def search_dict_for_path(d: dict) -> Any

Searches a dictionary for the path specified by the alias.

Returns

Any — The value at the specified path, or PydanticUndefined if the path is not found.


AliasChoices

Usage docs: https://docs.pydantic.dev/2.8/concepts/alias#aliaspath-and-aliaschoices

A data class used by validation_alias as a convenience to create aliases.

Attributes

choices

Type: list[str | AliasPath] Default: [first_choice] + list(choices)

Methods

convert_to_aliases

def convert_to_aliases() -> list[list[str | int]]

Converts arguments to a list of lists containing string or integer aliases.

Returns

list[list[str | int]] — The list of aliases.


AliasGenerator

Usage docs: https://docs.pydantic.dev/2.8/concepts/alias#using-an-aliasgenerator

A data class used by alias_generator as a convenience to create various aliases.

Attributes

alias

Type: Callable[[str], str] | None Default: None

validation_alias

Type: Callable[[str], str | AliasPath | AliasChoices] | None Default: None

serialization_alias

Type: Callable[[str], str] | None Default: None

Methods

generate_aliases

def generate_aliases(
    field_name: str,
) -> tuple[str | None, str | AliasPath | AliasChoices | None, str | None]

Generate alias, validation_alias, and serialization_alias for a field.

Returns

tuple[str | None, str | AliasPath | AliasChoices | None, str | None] — A tuple of three aliases - validation, alias, and serialization.