+ XhcsXRt^RIt^RIHt^RIHtHtHtHt.ROt Rt ]R3Rlt Rt R#)z Commonly useful converters. N)_AnnotationExtractor)NOTHING ConverterFactorypipecsa\S\4'dV3RlpMV3Rlp\S4pVP4pV'd%\P V,VP R&VP4pV'd%\P V,VP R&\S\4'd\VRRR7#V#)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 cs"<VfR#S!WV4#N)valZinstZfield converters&&&4/usr/lib/python3.14/site-packages/attr/converters.pyoptional_converter$optional..optional_converter&s{S. .cs <VfR#S!V4#rr)rr&r r r -s{S> !r rZreturnT) takes_selfZ takes_field) isinstancerrZget_first_param_typetypingZOptionalZ__annotations__Zget_return_type)rr ZxtrtZrtsf r optionalrs)Y'' / " y )C   "A4:OOA4F**51   B 7=r7J**84)Y''+$OO r csaS\JdVfRp\V4hS\JdVeRp\V4hVe \V4o\S\4'd(SP'dRp\ V4hV3RlpV#V3RlpV#)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 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.cs0<VeV#SP4#r)factoryrdefaultr r default_if_none_converter2default_if_none..default_if_none_converterls ??$ $r cs<VeV#S#rrrr r rrts Nr )rZ TypeErrorrrr ValueError)rrmsgrsf& r default_if_nonerBs4'go8ng'"5En'"'7##    ECS/ ! % %$   %$r cs\V\4'dVP4pVR9dR#VR9dR#RV: 2p\V4h)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 TFzCannot convert value to bool: )TZtruerZyesZyZonZ1i)FZfalseZfZnoZnZoffZ0i)rZstrZlowerr)rrs& r to_boolr}sJ8#siik ;; == *3' 2C S/r )rrrr) Z__doc__rZ_compatrZ_makerrrrZ__all__rrrrr r rs7)44 *Z$T8%v%r