X7ROOT File Manager
Current Path:
/opt/cloudlinux/venv/lib/python3.11/site-packages/attr
opt
/
cloudlinux
/
venv
/
lib
/
python3.11
/
site-packages
/
attr
/
ðŸ“
..
📄
__init__.py
(3.17 KB)
📄
__init__.pyi
(17.2 KB)
ðŸ“
__pycache__
📄
_cmp.py
(4 KB)
📄
_cmp.pyi
(399 B)
📄
_compat.py
(5.67 KB)
📄
_config.py
(826 B)
📄
_funcs.py
(16.34 KB)
📄
_make.py
(94.71 KB)
📄
_next_gen.py
(6.12 KB)
📄
_typing_compat.pyi
(469 B)
📄
_version_info.py
(2.07 KB)
📄
_version_info.pyi
(209 B)
📄
converters.py
(3.52 KB)
📄
converters.pyi
(406 B)
📄
exceptions.py
(1.85 KB)
📄
exceptions.pyi
(539 B)
📄
filters.py
(1.44 KB)
📄
filters.pyi
(225 B)
📄
py.typed
(0 B)
📄
setters.py
(1.37 KB)
📄
setters.pyi
(567 B)
📄
validators.py
(20.22 KB)
📄
validators.pyi
(2.52 KB)
Editing: converters.py
# SPDX-License-Identifier: MIT """ Commonly useful converters. """ import typing from ._compat import _AnnotationExtractor from ._make import NOTHING, Factory, pipe __all__ = [ "default_if_none", "optional", "pipe", "to_bool", ] def optional(converter): """ 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 """ def optional_converter(val): if val is None: return None return converter(val) xtr = _AnnotationExtractor(converter) t = xtr.get_first_param_type() if t: optional_converter.__annotations__["val"] = typing.Optional[t] rt = xtr.get_return_type() if rt: optional_converter.__annotations__["return"] = typing.Optional[rt] return optional_converter def default_if_none(default=NOTHING, factory=None): """ 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 """ if default is NOTHING and factory is None: raise TypeError("Must pass either `default` or `factory`.") if default is not NOTHING and factory is not None: raise TypeError( "Must pass either `default` or `factory` but not both." ) if factory is not None: default = Factory(factory) if isinstance(default, Factory): if default.takes_self: raise ValueError( "`takes_self` is not supported by default_if_none." ) def default_if_none_converter(val): if val is not None: return val return default.factory() else: def default_if_none_converter(val): if val is not None: return val return default return default_if_none_converter def to_bool(val): """ 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 """ if isinstance(val, str): val = val.lower() truthy = {True, "true", "t", "yes", "y", "on", "1", 1} falsy = {False, "false", "f", "no", "n", "off", "0", 0} try: if val in truthy: return True if val in falsy: return False except TypeError: # Raised when "val" is not hashable (e.g., lists) pass raise ValueError(f"Cannot convert value to bool: {val}")
Upload File
Create Folder