Spaces:
Runtime error
Runtime error
# SPDX-License-Identifier: MIT | |
""" | |
Classes Without Boilerplate | |
""" | |
from functools import partial | |
from typing import Callable | |
from . import converters, exceptions, filters, setters, validators | |
from ._cmp import cmp_using | |
from ._compat import Protocol | |
from ._config import get_run_validators, set_run_validators | |
from ._funcs import asdict, assoc, astuple, evolve, has, resolve_types | |
from ._make import ( | |
NOTHING, | |
Attribute, | |
Factory, | |
attrib, | |
attrs, | |
fields, | |
fields_dict, | |
make_class, | |
validate, | |
) | |
from ._next_gen import define, field, frozen, mutable | |
from ._version_info import VersionInfo | |
s = attributes = attrs | |
ib = attr = attrib | |
dataclass = partial(attrs, auto_attribs=True) # happy Easter ;) | |
class AttrsInstance(Protocol): | |
pass | |
__all__ = [ | |
"Attribute", | |
"AttrsInstance", | |
"Factory", | |
"NOTHING", | |
"asdict", | |
"assoc", | |
"astuple", | |
"attr", | |
"attrib", | |
"attributes", | |
"attrs", | |
"cmp_using", | |
"converters", | |
"define", | |
"evolve", | |
"exceptions", | |
"field", | |
"fields", | |
"fields_dict", | |
"filters", | |
"frozen", | |
"get_run_validators", | |
"has", | |
"ib", | |
"make_class", | |
"mutable", | |
"resolve_types", | |
"s", | |
"set_run_validators", | |
"setters", | |
"validate", | |
"validators", | |
] | |
def _make_getattr(mod_name: str) -> Callable: | |
""" | |
Create a metadata proxy for packaging information that uses *mod_name* in | |
its warnings and errors. | |
""" | |
def __getattr__(name: str) -> str: | |
dunder_to_metadata = { | |
"__title__": "Name", | |
"__copyright__": "", | |
"__version__": "version", | |
"__version_info__": "version", | |
"__description__": "summary", | |
"__uri__": "", | |
"__url__": "", | |
"__author__": "", | |
"__email__": "", | |
"__license__": "license", | |
} | |
if name not in dunder_to_metadata: | |
msg = f"module {mod_name} has no attribute {name}" | |
raise AttributeError(msg) | |
import sys | |
import warnings | |
if sys.version_info < (3, 8): | |
from importlib_metadata import metadata | |
else: | |
from importlib.metadata import metadata | |
if name not in ("__version__", "__version_info__"): | |
warnings.warn( | |
f"Accessing {mod_name}.{name} is deprecated and will be " | |
"removed in a future release. Use importlib.metadata directly " | |
"to query for attrs's packaging metadata.", | |
DeprecationWarning, | |
stacklevel=2, | |
) | |
meta = metadata("attrs") | |
if name == "__license__": | |
return "MIT" | |
if name == "__copyright__": | |
return "Copyright (c) 2015 Hynek Schlawack" | |
if name in ("__uri__", "__url__"): | |
return meta["Project-URL"].split(" ", 1)[-1] | |
if name == "__version_info__": | |
return VersionInfo._from_version_string(meta["version"]) | |
if name == "__author__": | |
return meta["Author-email"].rsplit(" ", 1)[0] | |
if name == "__email__": | |
return meta["Author-email"].rsplit("<", 1)[1][:-1] | |
return meta[dunder_to_metadata[name]] | |
return __getattr__ | |
__getattr__ = _make_getattr(__name__) | |