You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
135 lines
3.2 KiB
135 lines
3.2 KiB
# 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__)
|