U ¾¸bîã@szdZddlmZmZmZddlmZddlmZm Z m Z esLddl Z ddl Z ddd d gZ d d„Zedfd d„Zd d „ZdS)z Commonly useful converters. é)Úabsolute_importÚdivisionÚprint_functioné)ÚPY2)ÚNOTHINGÚFactoryÚpipeNÚdefault_if_noneÚoptionalr Úto_boolc sž‡fdd„}tsšd}zt ˆ¡}Wnttfk r:YnX|ršt|j ¡ƒ}|rz|djtj j k rzt j |dj|j d<|jtjj k ršt j |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 cs|dkr dSˆ|ƒS©N©©Úval©Ú converterrú3/tmp/pip-unpacked-wheel-9rkxrohn/attr/converters.pyÚoptional_converter(sz$optional..optional_converterNrrÚreturn)rÚinspectÚ signatureÚ ValueErrorÚ TypeErrorÚlistÚ parametersÚvaluesÚ annotationÚ ParameterÚemptyÚtypingÚOptionalÚ__annotations__Úreturn_annotationÚ Signature)rrÚsigÚparamsrrrr s$ ÿ ÿ csvˆtkr|dkrtdƒ‚ˆtk r0|dk r0tdƒ‚|dk r@t|ƒ‰tˆtƒrfˆjrXtdƒ‚‡fdd„}n ‡fdd„}|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.cs|dk r |Sˆ ¡Sr )Úfactoryr©ÚdefaultrrÚdefault_if_none_converterdsz2default_if_none..default_if_none_convertercs|dk r |SˆSr rrr(rrr*ls)rrrÚ isinstanceZ takes_selfr)r)r'r*rr(rr As ÿ ÿ cCs‚t|tƒr| ¡}ddddddddh}d d d d d dddh}z ||krJWdS||krXWd SWntk rnYnXtd |¡ƒ‚dS)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ÚtrueÚtÚyesÚyÚonÚ1rFÚfalseÚfÚnoÚnÚoffÚ0rz Cannot convert value to bool: {}N)r+ÚstrÚlowerrrÚformat)rZtruthyZfalsyrrrr us  )Ú__doc__Ú __future__rrrÚ_compatrÚ_makerrr rr Ú__all__r r r rrrrÚs ü'4