aliases.cpython-310.pyc•5.44 kB
o
�I�gI � @ s� d Z ddlmZ ddlZddlmZmZmZ ddlm Z ddl
m Z dZ ej
di e j��G d d
� d
��Zej
di e j��G d d � d ��Zej
di e j��G d
d� d��ZdS )z!Support for alias configurations.� )� annotationsN)�Any�Callable�Literal)�PydanticUndefined� )�_internal_dataclass)�AliasGenerator� AliasPath� AliasChoicesc @ s8 e Zd ZU dZded< dd
d �Zdd
d�Zddd�ZdS )r
a !!! abstract "Usage Documentation"
[`AliasPath` and `AliasChoices`](../concepts/alias.md#aliaspath-and-aliaschoices)
A data class used by `validation_alias` as a convenience to create aliases.
Attributes:
path: A list of string or integer aliases.
zlist[int | str]�path� first_arg�str�args� str | int�return�Nonec G � |gt |� | _d S �N)�listr )�selfr
r � r �^C:\Users\apqls\Documents\Github\tkbase\api-docs-mcp\venv\Lib\site-packages\pydantic/aliases.py�__init__ � zAliasPath.__init__�list[str | int]c C s | j S )zvConverts arguments to a list of string or integer aliases.
Returns:
The list of aliases.
N)r )r r r r �convert_to_aliases s z AliasPath.convert_to_aliases�d�dictr c C sR |}| j D ]!}t|t�rt S z|| }W q tttfy& t Y S w |S )z�Searches a dictionary for the path specified by the alias.
Returns:
The value at the specified path, or `PydanticUndefined` if the path is not found.
N)r �
isinstancer r �KeyError�
IndexError� TypeError)r r �v�kr r r �search_dict_for_path' s
�z AliasPath.search_dict_for_pathN)r
r r r r r )r r )r r r r )�__name__�
__module__� __qualname__�__doc__�__annotations__r r r% r r r r r
s
r
c @ s. e Zd ZU dZded< ddd �Zdd d �Zd
S )r a !!! abstract "Usage Documentation"
[`AliasPath` and `AliasChoices`](../concepts/alias.md#aliaspath-and-aliaschoices)
A data class used by `validation_alias` as a convenience to create aliases.
Attributes:
choices: A list containing a string or `AliasPath`.
zlist[str | AliasPath]�choices� first_choice�str | AliasPathr r c G r r )r r+ )r r, r+ r r r r F r zAliasChoices.__init__�list[list[str | int]]c C s: g }| j D ]}t|t�r|�|�� � q|�|g� q|S )z�Converts arguments to a list of lists containing string or integer aliases.
Returns:
The list of aliases.
N)r+ r r
�appendr )r �aliases�cr r r r I s
z AliasChoices.convert_to_aliasesN)r, r- r+ r- r r )r r. )r& r' r( r) r* r r r r r r r 9 s
r c @ sJ e Zd ZU dZdZded< dZded< dZded< ddd�Zddd�Z dS )r a� !!! abstract "Usage Documentation"
[Using an `AliasGenerator`](../concepts/alias.md#using-an-aliasgenerator)
A data class used by `alias_generator` as a convenience to create various aliases.
Attributes:
alias: A callable that takes a field name and returns an alias for it.
validation_alias: A callable that takes a field name and returns a validation alias for it.
serialization_alias: A callable that takes a field name and returns a serialization alias for it.
NzCallable[[str], str] | None�aliasz6Callable[[str], str | AliasPath | AliasChoices] | None�validation_alias�serialization_alias�
alias_kind�;Literal['alias', 'validation_alias', 'serialization_alias']�
allowed_types�<tuple[type[str] | type[AliasPath] | type[AliasChoices], ...]�
field_namer r �%str | AliasPath | AliasChoices | Nonec C sH d}t | |� }r"||�}|r"t||�s"td|� d|� d|� d���|S )z�Generate an alias of the specified kind. Returns None if the alias generator is None.
Raises:
TypeError: If the alias generator produces an invalid type.
Nz Invalid `z ` type. `z!` generator must produce one of `�`)�getattrr r" )r r5 r7 r9 r2 Zalias_generatorr r r �_generate_aliasi s �z AliasGenerator._generate_alias�Dtuple[str | None, str | AliasPath | AliasChoices | None, str | None]c C s> | � dtf|�}| � dtttf|�}| � dtf|�}|||fS )z�Generate `alias`, `validation_alias`, and `serialization_alias` for a field.
Returns:
A tuple of three aliases - validation, alias, and serialization.
r2 r3 r4 N)r= r r r
)r r9 r2 r3 r4 r r r �generate_aliases} s
z AliasGenerator.generate_aliases)r5 r6 r7 r8 r9 r r r: )r9 r r r> )
r& r' r( r) r2 r* r3 r4 r= r? r r r r r X s
r r )r) �
__future__r � dataclasses�typingr r r Z
pydantic_corer � _internalr �__all__� dataclassZ
slots_truer
r r r r r r �<module> s )