File Manager

X7ROOT File Manager

Current Path: /opt/alt/python37/lib/python3.7/site-packages/attr

opt / alt / python37 / lib / python3.7 / site-packages / attr /

ðŸ“ ..
ðŸ“„ __init__.py(1.58 KB)
ðŸ“„ __init__.pyi(14.49 KB)
ðŸ“ __pycache__
ðŸ“„ _cmp.py(4.04 KB)
ðŸ“„ _cmp.pyi(318 B)
ðŸ“„ _compat.py(7.38 KB)
ðŸ“„ _config.py(514 B)
ðŸ“„ _funcs.py(13.08 KB)
ðŸ“„ _make.py(95.45 KB)
ðŸ“„ _next_gen.py(3.98 KB)
ðŸ“„ _version_info.py(2.11 KB)
ðŸ“„ _version_info.pyi(209 B)
ðŸ“„ converters.py(2.97 KB)
ðŸ“„ converters.pyi(382 B)
ðŸ“„ exceptions.py(1.9 KB)
ðŸ“„ exceptions.pyi(540 B)
ðŸ“„ filters.py(1.07 KB)
ðŸ“„ filters.pyi(216 B)
ðŸ“„ py.typed(0 B)
ðŸ“„ setters.py(1.4 KB)
ðŸ“„ setters.pyi(574 B)
ðŸ“„ validators.py(11.23 KB)
ðŸ“„ validators.pyi(1.83 KB)

Editing: converters.py

"""
Commonly useful converters.
"""

from __future__ import absolute_import, division, print_function

from ._compat import PY2
from ._make import NOTHING, Factory, pipe

if not PY2:
    import inspect
    import typing

__all__ = [
    "pipe",
    "optional",
    "default_if_none",
]

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)

if not PY2:
        sig = None
        try:
            sig = inspect.signature(converter)
        except (ValueError, TypeError):  # inspect failed
            pass
        if sig:
            params = list(sig.parameters.values())
            if params and params[0].annotation is not inspect.Parameter.empty:
                optional_converter.__annotations__["val"] = typing.Optional[
                    params[0].annotation
                ]
            if sig.return_annotation is not inspect.Signature.empty:
                optional_converter.__annotations__["return"] = typing.Optional[
                    sig.return_annotation
                ]

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 `attr.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 `attr.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

X7ROOT File Manager

Editing: converters.py

Upload File

Create Folder