�
�c � �R � d Z ddlZddlmZ ddlmZmZmZ g d�Zd� Z edfd�Z
d � Z dS )
z
Commonly useful converters.
� N� )�_AnnotationExtractor)�NOTHING�Factory�pipe)�default_if_none�optionalr �to_boolc �� � � � fd�}t � � � }|� � � }|rt j | |j d< |� � � }|rt j | |j d< |S )aO
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.
:param callable converter: the converter that is used for non-``None``
values.
.. versionadded:: 17.1.0
c �" �� | �d S �| � � S �N� )�val� converters ��1/usr/lib/python3/dist-packages/attr/converters.py�optional_converterz$optional.<locals>.optional_converter$ s �� � �;��4��y��~�~� � r �return)r �get_first_param_type�typing�Optional�__annotations__�get_return_type)r r �xtr�t�rts ` r r r s� �� � � � � � �
�y�
)�
)�C� � � �"�"�A�� G�4:�O�A�4F��*�5�1� � � � � �B� � K�7=��r�7J��*�8�4� � r c � � � � t u r|�t d� � �� t ur|�t d� � �|�t |� � � t � t � � r � j rt d� � �� fd�}n� fd�}|S )a�
A converter that allows to replace ``None`` values by *default* or the
result of *factory*.
:param default: Value to be used if ``None`` is passed. Passing an instance
of `attrs.Factory` is supported, however the ``takes_self`` option
is *not*.
:param callable factory: A callable that takes no parameters whose result
is used if ``None`` is passed.
:raises TypeError: If **neither** *default* or *factory* is passed.
:raises TypeError: If **both** *default* and *factory* are passed.
:raises 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 �4 �� | �| S �� � � S r
)�factory�r �defaults �r �default_if_none_converterz2default_if_none.<locals>.default_if_none_converterY s �� ����
��?�?�$�$� $r c � �� | �| S �S r
r r s �r r" z2default_if_none.<locals>.default_if_none_convertera s �� ����
��Nr )r � TypeErrorr �
isinstance�
takes_self�
ValueError)r! r r" s ` r r r 6 s� �� �$ �'���g�o��B�C�C�C��g� � �'�"5�� C�
�
�
� ���'�"�"���'�7�#�#� � � � � �C�� �
� %� %� %� %� %� %� � � � � � %�$r c �� � t | t � � r| � � � } h d�}h d�} | |v rdS | |v rdS n# t $ r Y nw xY wt d| � �� � �)a
Convert "boolean" strings (e.g., from env. vars.) to real booleans.
Values mapping to :code:`True`:
- :code:`True`
- :code:`"true"` / :code:`"t"`
- :code:`"yes"` / :code:`"y"`
- :code:`"on"`
- :code:`"1"`
- :code:`1`
Values mapping to :code:`False`:
- :code:`False`
- :code:`"false"` / :code:`"f"`
- :code:`"no"` / :code:`"n"`
- :code:`"off"`
- :code:`"0"`
- :code:`0`
:raises ValueError: for any other value.
.. versionadded:: 21.3.0
> T�1r �y�on�yes�true> F�0�f�n�no�off�falseTFz Cannot convert value to bool: )r% �str�lowerr$ r' )r �truthy�falsys r r
r
j s� � �4 �#�s��� ��i�i�k�k��
:�
:�
:�F� ;� ;� ;�E�
� �&�=�=��4� �%�<�<��5� �� �
�
�
� ��
���� �;�c�;�;�
<�
<�<s �A �A �
A
� A
) �__doc__r �_compatr �_maker r r �__all__r r r
r r r �<module>r< s� ��� �
�
�
�
� )� )� )� )� )� )� )� )� )� )� )� )� )� )� )� )� � � �� � � �@ $�T� 1%� 1%� 1%� 1%�h&=� &=� &=� &=� &=r |