2iPdZddlZddlmZddlmZmZmZgdZdZ edfdZ d Z y) z Commonly useful converters. N)_AnnotationExtractor)NOTHINGFactorypipe)default_if_noneoptionalrto_boolcfd}t}|j}|r tj||jd<|j }|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|y|SN)val converters F/var/www/html/acx/venv/lib/python3.12/site-packages/attr/converters.pyoptional_converterz$optional..optional_converter$s ;~rreturn)rget_first_param_typetypingOptional__annotations__get_return_type)rrxtrtrts` rr r sp y )C   "A4:OOA4F**51   B 7=r7J**84 rctur | tdtur | td| t|ttrjr t dfd}|Sfd}|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 z(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,||SjSr )factoryrdefaults rdefault_if_none_converterz2default_if_none..default_if_none_converterYs ??$ $rc||SSr rr s rr"z2default_if_none..default_if_none_converteras Nr)r TypeErrorr isinstance takes_self ValueError)r!rr"s` rrr6s$'goBCCg'"5 C  '"'7#   C  % %$   %$rct|tr|j}hd}hd} ||vry||vry t d|#t$rYwxYw)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 >T1ryonyestrue>F0fnnoofffalseTFzCannot convert value to bool: )r%strlowerr$r')rtruthyfalsys rr r jsj4#siik :F ;E &= %<  5cU; <<    sAA AA) __doc__r_compatr_makerrr__all__r rr rrrr<s7 ))) @$T1%h&=r