o

;j&�@sVdZd
dl
Z
ddlmZ
ddlmZmZmZ
gd�
Zdd�Z	edfd	d
�
Z
dd�ZdS)
z
Commonly useful converters.
�N�
)
�_AnnotationExtractor)�NOTHING�Factory�pipe)�default_if_none�optionalr�to_boolc
sP�f
d
d�}
t��
}|�
�}|rtj||
jd<|��}|r&tj||
jd<|
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

s|durdS�|�
S�
N��
�val�
�	converterr�C/opt/saltstack/salt/lib/python3.10/site-packages/attr/converters.py�optional_converter$s


z$optional.<locals>.optional_converterr
�return)rZget_first_param_type�typing�Optional�__annotations__Zget_return_type)rrZxtr�
tZrtrrrrs



rcs��tur|
d
urd}t
|�
�
�tu
r|
d
u
rd}t
|�
�
|
d
u
r$t|
�
�t�t�r:�jr2d}t|�
�
�f
dd�}|S�f
dd�}|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

s|du
r|S���Sr
)
�factoryr�
�defaultrr�default_if_none_converterXs

z2default_if_none.<locals>.default_if_none_converterc

s|du
r|S�Sr
rrrrrr`s

)r�	TypeErrorr�
isinstanceZ
takes_self�
ValueError)rr�msgrrrrr6s 








�rc
Csht|t
�r	|��}hd
�
}
hd�
}z||
vrWdS||vr WdSWn	ty*


Yn
wd|��}t|�
�
)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
    >TrZyes�
y�on�
1�true>F�no�
n�
f�false�
0ZoffTFzCannot convert value to bool: )r�str�lowerrr)r
ZtruthyZfalsyrrrrr	is








��

r	)�__doc__rZ_compatr�_makerrr�__all__rrr	rrrr�<module>
s
 3