%_q R d Z ddlZddlmZ ddlmZmZmZ g dZd Z edfdZ
d Z dS )
z
Commonly useful converters.
N )_AnnotationExtractor)NOTHINGFactorypipe)default_if_noneoptionalr 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 a/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/attr/converters.pyoptional_converterz$optional..optional_converter$ s ;4y~~ r return)r get_first_param_typetypingOptional__annotations__get_return_type)r r xtrtrts ` r r r s
y
)
)C ""A G4:OA4F*51 B K7=r7J*84 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
)factoryr defaults r default_if_none_converterz2default_if_none..default_if_none_converterY s
??$$ $r c | | S S r
r r s r r" z2default_if_none..default_if_none_convertera s
Nr )r TypeErrorr
isinstance
takes_self
ValueError)r! r r" s ` r r r 6 s $ 'goBCCCg '"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
> T1r yonyestrue> F0fnnoofffalseTFz Cannot convert value to bool: )r% strlowerr$ r' )r truthyfalsys r r
r
j s 4 #s iikk
:
:
:F ; ; ;E
&==4 %<<5
;c;;
<
<r< s
) ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) @ $T 1% 1% 1% 1%h&= &= &= &= &=r