converters.cpython-310.pyc•3.75 kB
o
�I�g � @ sZ d Z ddlZddlmZ ddlmZmZmZmZ g d�Z dd� Z
edfd d
�Z d d � Z dS )
z
Commonly useful converters.
� N� )�_AnnotationExtractor)�NOTHING� Converter�Factory�pipe)�default_if_none�optionalr �to_boolc s� t � t�r � fdd�}n� fdd�}t� �}|�� }|r$tj| |jd< |�� }|r2tj| |jd< t � t�r>t|ddd�S |S ) a_
A converter that allows an attribute to be optional. An optional attribute
is one which can be set to `None`.
Type annotations will be inferred from the wrapped converter's, if it has
any.
Args:
converter (typing.Callable):
the converter that is used for non-`None` values.
.. versionadded:: 17.1.0
c s | d u rd S � | ||�S �N� )�val�inst�field�� converterr �]C:\Users\apqls\Documents\Github\tkbase\api-docs-mcp\venv\Lib\site-packages\attr/converters.py�optional_converter& s z$optional.<locals>.optional_converterc s | d u rd S � | �S r r �r
r r r r - s r
�returnT)�
takes_selfZ takes_fieldN)�
isinstancer r Zget_first_param_type�typing�Optional�__annotations__Zget_return_type)r r Zxtr�t�rtr r r r s
r c s� � t u r|du rd}t|��� t ur |dur d}t|��|dur$t|�� t� t�r:� jr2d}t|��� fdd�}|S � fdd�}|S )a�
A converter that allows to replace `None` values by *default* or the result
of *factory*.
Args:
default:
Value to be used if `None` is passed. Passing an instance of
`attrs.Factory` is supported, however the ``takes_self`` option is
*not*.
factory (typing.Callable):
A callable that takes no parameters whose result is used if `None`
is passed.
Raises:
TypeError: If **neither** *default* or *factory* is passed.
TypeError: If **both** *default* and *factory* are passed.
ValueError:
If an instance of `attrs.Factory` is passed with
``takes_self=True``.
.. versionadded:: 18.2.0
Nz(Must pass either `default` or `factory`.z5Must pass either `default` or `factory` but not both.z1`takes_self` is not supported by default_if_none.c s | d ur| S � � � S r )�factoryr ��defaultr r �default_if_none_converterl s z2default_if_none.<locals>.default_if_none_converterc s | d ur| S � S r r r r r r r t s )r � TypeErrorr r r �
ValueError)r r �msgr r r r r B s
�r c C s< t | t�r | �� } | dv rdS | dv rdS d| ��}t|��)a�
Convert "boolean" strings (for example, from environment variables) to real
booleans.
Values mapping to `True`:
- ``True``
- ``"true"`` / ``"t"``
- ``"yes"`` / ``"y"``
- ``"on"``
- ``"1"``
- ``1``
Values mapping to `False`:
- ``False``
- ``"false"`` / ``"f"``
- ``"no"`` / ``"n"``
- ``"off"``
- ``"0"``
- ``0``
Raises:
ValueError: For any other value.
.. versionadded:: 21.3.0
)T�truer �yes�y�on�1r T)F�false�f�no�n�off�0r Fz Cannot convert value to bool: N)r �str�lowerr" )r
r# r r r r
} s
r
)
�__doc__r Z_compatr �_maker r r r �__all__r r r
r r r r �<module> s - ;