omlish 0.0.0.dev337__py3-none-any.whl → 0.0.0.dev339__py3-none-any.whl

omlish/__about__.py

@@ -1,5 +1,5 @@
-__version__ = '0.0.0.dev337'
-__revision__ = '6f1500f0f97a2650c7df1a7127e2688a0ef300cf'
+__version__ = '0.0.0.dev339'
+__revision__ = '0d8d4714d9a9ea7145586e0bce55833b86e980bd'
 
 
 #

omlish/lang/__init__.py

@@ -61,12 +61,21 @@ from .classes.abstract import (  # noqa
     unabstract_class,
 )
 
+from .classes.bindable import (  # noqa
+    BindableClass,
+)
+
 from .classes.namespaces import (  # noqa
     GenericNamespaceMeta,
     Namespace,
     NamespaceMeta,
 )
 
+from .classes.protocols import (  # noqa
+    ProtocolForbiddenAsBaseClass,
+    ProtocolForbiddenAsBaseClassTypeError,
+)
+
 from .classes.restrict import (  # noqa
     AnySensitive,
     Final,

omlish/lang/classes/bindable.py

@@ -0,0 +1,41 @@
+import typing as ta
+
+
+T = ta.TypeVar('T')
+
+
+##
+
+
+class _ClassOrInstanceMethod:
+    def __init__(self, func):
+        super().__init__()
+
+        self.__func__ = func
+
+    def __get__(self, instance, owner=None):
+        return self.__func__.__get__(instance if instance is not None else owner)
+
+
+class BindableClass(ta.Generic[T]):
+    # FIXME: apparently can't have TypeVars in ClassVars, but could stick in a @classmethod (which gets transformed)...
+    _bound: ta.ClassVar[type[T] | None] = None  # type: ignore[misc]
+
+    def __init__(self, *, _bound):
+        super().__init__()
+
+        setattr(self, '_bound', _bound)
+
+    def __class_getitem__(cls, *args, **kwargs):
+        if cls is BindableClass:
+            return super().__class_getitem__(*args, **kwargs)  # type: ignore[misc]
+
+        [bind_cls] = args
+        return cls(_bound=bind_cls)
+
+    def __init_subclass__(cls, **kwargs):
+        super().__init_subclass__(**kwargs)
+
+        for k, v in cls.__dict__.items():
+            if isinstance(v, classmethod):
+                setattr(cls, k, _ClassOrInstanceMethod(v.__func__))

omlish/lang/classes/protocols.py

@@ -0,0 +1,26 @@
+import typing as ta
+
+
+##
+
+
+class ProtocolForbiddenAsBaseClass(ta.Protocol):
+    pass
+
+
+class ProtocolForbiddenAsBaseClassTypeError(TypeError):
+    pass
+
+
+def _ProtocolForbiddenAsBaseClass__init_subclass__(cls: ta.Any, **kwargs: ta.Any) -> None:  # noqa
+    if ta.Protocol not in cls.__mro__:
+        raise TypeError(f'Class {cls} must be a Protocol')
+
+    super(ProtocolForbiddenAsBaseClass, cls).__init_subclass__(**kwargs)  # noqa
+
+    # TODO: ta.Protocol not in cls.__bases__ ?
+    if not cls.__dict__['_is_protocol']:
+        raise ProtocolForbiddenAsBaseClassTypeError(cls)
+
+
+setattr(ProtocolForbiddenAsBaseClass, '__init_subclass__', classmethod(_ProtocolForbiddenAsBaseClass__init_subclass__))

omlish/marshal/composite/special.py

@@ -0,0 +1,33 @@
+import collections.abc
+
+from ... import check
+from ... import lang
+from ... import reflect as rfl
+from ...funcs import match as mfs
+from ..base import MarshalContext
+from ..base import Marshaler
+from ..base import MarshalerFactoryMatchClass
+from ..base import UnmarshalContext
+from ..base import Unmarshaler
+from ..base import UnmarshalerFactoryMatchClass
+from .iterables import DEFAULT_ITERABLE_CONCRETE_TYPES
+from .iterables import IterableMarshaler
+from .iterables import IterableUnmarshaler
+
+
+##
+
+
+class SequenceNotStrMarshalerFactory(MarshalerFactoryMatchClass):
+    @mfs.simple(lambda _, ctx, rty: isinstance(rty, rfl.Protocol) and rty.cls is lang.SequenceNotStr)
+    def _build_generic(self, ctx: MarshalContext, rty: rfl.Type) -> Marshaler:
+        gty = check.isinstance(rty, rfl.Protocol)
+        return IterableMarshaler(ctx.make(check.single(gty.args)))
+
+
+class SequenceNotStrUnmarshalerFactory(UnmarshalerFactoryMatchClass):
+    @mfs.simple(lambda _, ctx, rty: isinstance(rty, rfl.Protocol) and rty.cls is lang.SequenceNotStr)
+    def _build_generic(self, ctx: UnmarshalContext, rty: rfl.Type) -> Unmarshaler:
+        gty = check.isinstance(rty, rfl.Protocol)
+        cty = DEFAULT_ITERABLE_CONCRETE_TYPES[collections.abc.Sequence]  # type: ignore[type-abstract]
+        return IterableUnmarshaler(cty, ctx.make(check.single(gty.args)))

omlish/marshal/standard.py

@@ -18,6 +18,8 @@ from .composite.newtypes import NewtypeMarshalerFactory
 from .composite.newtypes import NewtypeUnmarshalerFactory
 from .composite.optionals import OptionalMarshalerFactory
 from .composite.optionals import OptionalUnmarshalerFactory
+from .composite.special import SequenceNotStrMarshalerFactory
+from .composite.special import SequenceNotStrUnmarshalerFactory
 from .objects.dataclasses import DataclassMarshalerFactory
 from .objects.dataclasses import DataclassUnmarshalerFactory
 from .objects.namedtuples import NamedtupleMarshalerFactory
@@ -58,6 +60,7 @@ STANDARD_MARSHALER_FACTORIES: list[MarshalerFactory] = [
     DATETIME_MARSHALER_FACTORY,
     MaybeMarshalerFactory(),
     MappingMarshalerFactory(),
+    SequenceNotStrMarshalerFactory(),
     IterableMarshalerFactory(),
     ANY_MARSHALER_FACTORY,
 ]
@@ -91,6 +94,7 @@ STANDARD_UNMARSHALER_FACTORIES: list[UnmarshalerFactory] = [
     DATETIME_UNMARSHALER_FACTORY,
     MaybeUnmarshalerFactory(),
     MappingUnmarshalerFactory(),
+    SequenceNotStrUnmarshalerFactory(),
     IterableUnmarshalerFactory(),
     ANY_UNMARSHALER_FACTORY,
 ]

omlish/reflect/__init__.py

@@ -28,8 +28,10 @@ from .types import (  # noqa
     Any,
     DEFAULT_REFLECTOR,
     Generic,
+    GenericLike,
     Literal,
     NewType,
+    Protocol,
     ReflectTypeError,
     Reflector,
     TYPES,

omlish/reflect/ops.py

@@ -1,9 +1,12 @@
+import dataclasses as dc
 import typing as ta
 
 from .types import Annotated
 from .types import Any
 from .types import Generic
+from .types import GenericLike
 from .types import NewType
+from .types import Protocol
 from .types import Type
 from .types import Union
 from .types import get_type_var_bound
@@ -15,13 +18,13 @@ def strip_objs(ty: Type) -> Type:
         return ty
 
     if isinstance(ty, Union):
-        return Union(frozenset(map(strip_objs, ty.args)))
+        return dc.replace(ty, args=frozenset(map(strip_objs, ty.args)))
 
-    if isinstance(ty, Generic):
-        return Generic(ty.cls, tuple(map(strip_objs, ty.args)), ty.params, None)
+    if isinstance(ty, GenericLike):
+        return dc.replace(ty, args=tuple(map(strip_objs, ty.args)), obj=None)
 
     if isinstance(ty, Annotated):
-        return Annotated(strip_objs(ty.ty), ty.md, None)
+        return dc.replace(ty, ty=strip_objs(ty.ty), obj=None)
 
     raise TypeError(ty)
 
@@ -31,10 +34,10 @@ def strip_annotations(ty: Type) -> Type:
         return ty
 
     if isinstance(ty, Union):
-        return Union(frozenset(map(strip_annotations, ty.args)))
+        return dc.replace(ty, args=frozenset(map(strip_annotations, ty.args)))
 
-    if isinstance(ty, Generic):
-        return Generic(ty.cls, tuple(map(strip_annotations, ty.args)), ty.params, ty.obj)
+    if isinstance(ty, GenericLike):
+        return dc.replace(ty, args=tuple(map(strip_annotations, ty.args)))
 
     if isinstance(ty, Annotated):
         return strip_annotations(ty.ty)
@@ -74,7 +77,7 @@ def get_concrete_type(
 
             return None
 
-        if isinstance(cur, (Union, Any)):
+        if isinstance(cur, (Union, Any, Protocol)):
             return None
 
         raise TypeError(cur)
@@ -89,6 +92,9 @@ def to_annotation(ty: Type) -> ta.Any:
     if isinstance(ty, Union):
         return ta.Union[*tuple(to_annotation(e) for e in ty.args)]
 
+    if isinstance(ty, Protocol):
+        return ta.Protocol[*ty.params]
+
     if isinstance(ty, (type, ta.TypeVar, NewType)):
         return ty
 

omlish/reflect/types.py

@@ -3,6 +3,7 @@ TODO:
  - visitor / transformer
  - uniform collection isinstance - items() for mappings, iter() for other
  - also check instance type in isinstance not just items lol
+TODO:
  - ta.Generic in mro causing trouble - omit? no longer 1:1
  - cache this shit, esp generic_mro shit
   - cache __hash__ in Generic/Union
@@ -22,6 +23,7 @@ _AnnotatedAlias = ta._AnnotatedAlias  # type: ignore  # noqa
 _CallableGenericAlias = ta._CallableGenericAlias  # type: ignore  # noqa
 _GenericAlias = ta._GenericAlias  # type: ignore  # noqa
 _LiteralGenericAlias = ta._LiteralGenericAlias  # type: ignore  # noqa
+_ProtocolMeta = ta._ProtocolMeta  # noqa
 _SpecialGenericAlias = ta._SpecialGenericAlias  # type: ignore  # noqa
 _UnionGenericAlias = ta._UnionGenericAlias   # type: ignore  # noqa
 
@@ -29,6 +31,16 @@ _UnionGenericAlias = ta._UnionGenericAlias   # type: ignore  # noqa
 ##
 
 
+_Protocol = getattr(ta, 'Protocol')
+_Generic = getattr(ta, 'Generic')
+
+if not isinstance(_Protocol, type) or not issubclass(_Protocol, _Generic):
+    raise TypeError(f'typing.Protocol is not a proper typing.Generic subtype')
+
+
+##
+
+
 @dc.dataclass(frozen=True)
 class _Special:
     name: str
@@ -95,6 +107,10 @@ def get_params(obj: ta.Any) -> tuple[ta.TypeVar, ...]:
     raise TypeError(obj)
 
 
+def _is_immediate_protocol(obj: ta.Any) -> bool:
+    return isinstance(obj, _ProtocolMeta) and obj.__dict__['_is_protocol']
+
+
 def is_union_type(cls: ta.Any) -> bool:
     if hasattr(ta, 'UnionType'):
         return ta.get_origin(cls) in {ta.Union, getattr(ta, 'UnionType')}
@@ -163,22 +179,30 @@ class Union(TypeInfo):
 #
 
 
+GenericLikeCls = ta.TypeVar('GenericLikeCls')
+
+
 @dc.dataclass(frozen=True)
-class Generic(TypeInfo):
-    cls: type
-    args: tuple[Type, ...]                                                # map[int, V] = (int, V) | map[T, T] = (T, T)
+class GenericLike(TypeInfo, abc.ABC, ta.Generic[GenericLikeCls]):
+    cls: GenericLikeCls
 
-    params: tuple[ta.TypeVar, ...] = dc.field(compare=False, repr=False)  # map[int, V] = (_0, _1) | map[T, T] = (_0, _1)  # noqa
-    # params2: tuple[ta.TypeVar, ...]                                     # map[int, V] = (V,)     | map[T, T] = (T,)
+    # args and params are the same length - params maps to the generic origin's params:
+    # args   : map[int, V] = (int, V) | map[T, T] = (T, T)
+    # params : map[int, V] = (_0, _1) | map[T, T] = (_0, _1)
+    args: tuple[Type, ...]
+    params: tuple[ta.TypeVar, ...] = dc.field(compare=False, repr=False)
 
     obj: ta.Any = dc.field(compare=False, repr=False)
 
-    # def __post_init__(self) -> None:
-    #     if not isinstance(self.cls, type):
-    #         raise TypeError(self.cls)
+    def __post_init__(self) -> None:
+        if not isinstance(self.cls, type):
+            raise ReflectTypeError(f'GenericLike {self.cls=} must be a type')
+        if len(self.args) != len(self.params):
+            raise ReflectTypeError(f'GenericLike {self.args=} must be same length as {self.params=}')
 
-    def full_eq(self, other: 'Generic') -> bool:
+    def full_eq(self, other: 'GenericLike') -> bool:
         return (
+            type(self) is type(other) and
             self.cls == other.cls and
             self.args == other.args and
             self.params == other.params and
@@ -186,6 +210,18 @@ class Generic(TypeInfo):
         )
 
 
+@dc.dataclass(frozen=True)
+class Generic(GenericLike[type]):
+    pass
+
+
+@dc.dataclass(frozen=True)
+class Protocol(GenericLike[ta.Any]):
+    # cls will still be a type - it will be the topmost _is_protocol=True class.
+    # it may however be ta.Protocol, which *is* a type, but not according to mypy.
+    pass
+
+
 #
 
 
@@ -311,9 +347,13 @@ class Reflector:
                 return None
 
             origin = ta.get_origin(obj)
+
             args = ta.get_args(obj)
 
-            if oty is _CallableGenericAlias:
+            if origin is ta.Protocol:
+                params = get_params(obj)
+
+            elif oty is _CallableGenericAlias:
                 p, r = args
                 if p is Ellipsis or isinstance(p, ta.ParamSpec):
                     raise ReflectTypeError(f'Callable argument not yet supported for {obj=}')
@@ -332,6 +372,27 @@ class Reflector:
             if len(args) != len(params):
                 raise ReflectTypeError(f'Mismatched {args=} and {params=} for {obj=}')
 
+            if not isinstance(origin, type):
+                raise ReflectTypeError(f'Generic origin {origin!r} is not a type')
+
+            if origin is ta.Protocol:
+                if args != params:
+                    raise ReflectTypeError(f'Protocol argument not yet supported for {args=}, {params=}')
+                return Protocol(
+                    ta.Protocol,
+                    args,
+                    params,
+                    obj,
+                )
+
+            if _is_immediate_protocol(origin):
+                return Protocol(
+                    origin,
+                    args,
+                    params,
+                    obj,
+                )
+
             return Generic(
                 origin,
                 tuple(self.type(a) for a in args),
@@ -346,6 +407,15 @@ class Reflector:
             if check_only:
                 return None
 
+            if _is_immediate_protocol(obj):
+                params = get_params(obj)
+                return Protocol(
+                    obj,
+                    params,
+                    params,
+                    obj,
+                )
+
             if issubclass(obj, ta.Generic):  # type: ignore
                 params = get_params(obj)
                 if params:

omlish/testing/pytest/plugins/switches/__init__.py

@@ -0,0 +1 @@
+from .plugin import SwitchesPlugin  # noqa

omlish/testing/pytest/plugins/{switches.py → switches/plugin.py}

@@ -3,17 +3,20 @@ TODO:
  - inheritance
  - dynamic registration
  - dynamic switching (skip docker if not running, skip online if not online, ...)
+ - probably make IF_SINGLE understand parametErization
 """
 import dataclasses as dc
-import enum
 import typing as ta
 
 import pytest
 
-from .... import check
-from .... import collections as col
-from ....docker import all as docker
-from ._registry import register
+from ..... import check
+from ..... import collections as col
+from .._registry import register
+from .switches import SWITCHES
+from .switches import SWITCHES_BY_NAME
+from .switches import Switch
+from .switches import SwitchState
 
 
 Configable: ta.TypeAlias = pytest.FixtureRequest | pytest.Config
@@ -22,80 +25,6 @@ Configable: ta.TypeAlias = pytest.FixtureRequest | pytest.Config
 ##
 
 
-class SwitchState(enum.Enum):
-    ENABLED = enum.auto()
-    DISABLED = enum.auto()
-    ONLY = enum.auto()
-    IF_SINGLE = enum.auto()
-
-
-@dc.dataclass(frozen=True, eq=False)
-class Switch:
-    name: str
-    _default_state: SwitchState | ta.Callable[[pytest.Session], SwitchState]
-
-    _: dc.KW_ONLY
-
-    add_marks: ta.Sequence[ta.Any] | None = None
-
-    def default_state(self, session: pytest.Session) -> SwitchState:
-        if isinstance(e := self._default_state, SwitchState):
-            return e
-        elif callable(e):
-            return check.isinstance(e(session), SwitchState)
-        else:
-            raise TypeError(e)
-
-    @property
-    def attr(self) -> str:
-        return self.name.replace('-', '_')
-
-
-SWITCHES: ta.Sequence[Switch] = [
-    Switch(
-        'name',
-        lambda _: SwitchState.ENABLED if docker.has_cli() else SwitchState.DISABLED,
-    ),
-
-    Switch(
-        'docker-guest',
-        lambda _: SwitchState.ENABLED if docker.is_likely_in_docker() else SwitchState.DISABLED,
-    ),
-
-    Switch(
-        'online',
-        SwitchState.ENABLED,
-    ),
-
-    Switch(
-        'integration',
-        SwitchState.ENABLED,
-    ),
-
-    Switch(
-        'high-mem',
-        SwitchState.ENABLED,
-        add_marks=[
-            # https://pytest-xdist.readthedocs.io/en/latest/distribution.html
-            pytest.mark.xdist_group('high-mem'),
-            pytest.mark.gc_collect_after(),
-        ],
-    ),
-
-    Switch(
-        'slow',
-        SwitchState.IF_SINGLE,
-    ),
-]
-
-
-SWITCHES_BY_NAME: ta.Mapping[str, Switch] = col.make_map_by(lambda sw: sw.name, SWITCHES, strict=True)
-SWITCHES_BY_ATTR: ta.Mapping[str, Switch] = col.make_map_by(lambda sw: sw.attr, SWITCHES, strict=True)
-
-
-##
-
-
 SWITCH_STATE_OPT_PREFIXES: ta.Mapping[SwitchState, str] = {
     SwitchState.ENABLED: '--',
     SwitchState.DISABLED: '--no-',
@@ -193,6 +122,7 @@ class SwitchesPlugin:
     def pytest_sessionstart(self, session):
         session.stash[self._states_key] = self._States(session)
 
+    @pytest.hookimpl(tryfirst=True)
     def pytest_collection_modifyitems(self, config, items):
         def process_item(item):
             state: SwitchesPlugin._States = item.session.stash[self._states_key]

omlish/testing/pytest/plugins/switches/switches.py

@@ -0,0 +1,89 @@
+import dataclasses as dc
+import enum
+import typing as ta
+
+import pytest
+
+from ..... import check
+from ..... import collections as col
+from .....docker import all as docker
+
+
+##
+
+
+class SwitchState(enum.Enum):
+    ENABLED = enum.auto()
+    DISABLED = enum.auto()
+    ONLY = enum.auto()
+    IF_SINGLE = enum.auto()
+
+
+@dc.dataclass(frozen=True, eq=False)
+class Switch:
+    name: str
+    _default_state: SwitchState | ta.Callable[[pytest.Session], SwitchState]
+
+    _: dc.KW_ONLY
+
+    add_marks: ta.Sequence[ta.Any] | None = None
+
+    def default_state(self, session: pytest.Session) -> SwitchState:
+        if isinstance(e := self._default_state, SwitchState):
+            return e
+        elif callable(e):
+            return check.isinstance(e(session), SwitchState)
+        else:
+            raise TypeError(e)
+
+    @property
+    def attr(self) -> str:
+        return self.name.replace('-', '_')
+
+
+##
+
+
+SWITCHES: ta.Sequence[Switch] = [
+    Switch(
+        'name',
+        lambda _: SwitchState.ENABLED if docker.has_cli() else SwitchState.DISABLED,
+    ),
+
+    Switch(
+        'docker-guest',
+        lambda _: SwitchState.ENABLED if docker.is_likely_in_docker() else SwitchState.DISABLED,
+    ),
+
+    Switch(
+        'online',
+        SwitchState.ENABLED,
+    ),
+
+    Switch(
+        'integration',
+        SwitchState.ENABLED,
+    ),
+
+    Switch(
+        'high-mem',
+        SwitchState.ENABLED,
+        add_marks=[
+            # https://pytest-xdist.readthedocs.io/en/latest/distribution.html
+            pytest.mark.xdist_group('high-mem'),
+            pytest.mark.gc_collect_after(),
+        ],
+    ),
+
+    Switch(
+        'slow',
+        SwitchState.IF_SINGLE,
+    ),
+]
+
+
+##
+
+
+SWITCHES_BY_NAME: ta.Mapping[str, Switch] = col.make_map_by(lambda sw: sw.name, SWITCHES, strict=True)
+SWITCHES_BY_ATTR: ta.Mapping[str, Switch] = col.make_map_by(lambda sw: sw.attr, SWITCHES, strict=True)

omlish/testing/pytest/skip.py

@@ -1,3 +1,7 @@
+"""
+TODO:
+ - if_not_single? switches does this
+"""
 import shutil
 import sys
 import sysconfig
@@ -11,8 +15,9 @@ from ... import lang
 ##
 
 
-def if_cant_import(module: str, *args, **kwargs):
-    return pytest.mark.skipif(not lang.can_import(module, *args, **kwargs), reason=f'requires import {module}')
+def if_cant_import(*modules: str, **kwargs):
+    missing = [m for m in modules if not lang.can_import(m, **kwargs)]
+    return pytest.mark.skipif(bool(missing), reason=f'requires import {", ".join(missing)}')
 
 
 def if_not_on_path(exe: str):
@@ -27,11 +32,5 @@ def if_not_platform(*platforms: str):
     return pytest.mark.skipif(sys.platform not in platforms, reason=f'requires platform in {platforms}')
 
 
-def if_not_single():
-    # FIXME
-    # [resolve_collection_argument(a) for a in session.config.args]
-    raise NotImplementedError
-
-
 def if_nogil():
     return pytest.mark.skipif(sysconfig.get_config_var('Py_GIL_DISABLED'), reason='requires gil build')

omlish/typedvalues/__init__.py

@@ -22,6 +22,10 @@ from .holder import (  # noqa
     TypedValueHolder,
 )
 
+from .of_ import (  # noqa
+    of,
+)
+
 from .reflect import (  # noqa
     reflect_typed_values_impls,
 )

omlish/typedvalues/accessor.py

@@ -27,7 +27,11 @@ class _NOT_SET(lang.Marker):  # noqa
     pass
 
 
-class TypedValuesAccessor(lang.Abstract, ta.Sequence[TypedValueT0]):
+class TypedValuesAccessor(
+    lang.Abstract,
+    ta.Sequence[TypedValueT0],
+    ta.Generic[TypedValueT0],
+):
     def __iter__(self):
         raise TypeError(
             'TypedValuesAccessor does not implement __iter__ - it is reserved for implementation by subclasses.',

omlish/typedvalues/collection.py

@@ -10,6 +10,7 @@ from .values import UniqueTypedValue
 
 
 TypedValueT = ta.TypeVar('TypedValueT', bound='TypedValue')
+TypedValueU = ta.TypeVar('TypedValueU', bound='TypedValue')
 
 UniqueTypedValueT = ta.TypeVar('UniqueTypedValueT', bound='UniqueTypedValue')
 

omlish/typedvalues/of_.py

@@ -0,0 +1,51 @@
+import typing as ta
+
+from .. import lang
+from .collection import TypedValues
+from .consumer import TypedValuesConsumer
+from .values import TypedValue
+
+
+TypedValueT = ta.TypeVar('TypedValueT', bound=TypedValue)
+
+
+##
+
+
+class _TypedValuesOf(lang.BindableClass[TypedValueT]):  # noqa
+    @classmethod
+    def collect(
+            cls,
+            *tvs: TypedValueT,
+            override: bool = False,
+            check_type: bool | type | tuple[type, ...] | None = None,
+    ) -> TypedValues[TypedValueT]:  # noqa
+        if isinstance(check_type, bool):
+            if check_type:
+                if cls._bound is None:
+                    raise TypeError('TypedValues.of unbound, cannot use check_type=True')
+                check_type = cls._bound
+            else:
+                check_type = None
+
+        return TypedValues(
+            *tvs,
+            override=override,
+            check_type=check_type,
+        )
+
+    @classmethod
+    def consume(
+            cls,
+            *tvs: TypedValueT,
+            override: bool = False,
+            check_type: bool | type | tuple[type, ...] | None = None,
+    ) -> TypedValuesConsumer[TypedValueT]:
+        return cls.collect(
+            *tvs,
+            override=override,
+            check_type=check_type,
+        ).consume()
+
+
+of = _TypedValuesOf

{omlish-0.0.0.dev337.dist-info → omlish-0.0.0.dev339.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: omlish
-Version: 0.0.0.dev337
+Version: 0.0.0.dev339
 Summary: omlish
 Author: wrmsr
 License: BSD-3-Clause

{omlish-0.0.0.dev337.dist-info → omlish-0.0.0.dev339.dist-info}/RECORD

@@ -1,5 +1,5 @@
 omlish/.manifests.json,sha256=orgsRvtpHu8tdhaCvlP9v3P495OJopYYiHKjK68WtWg,8587
-omlish/__about__.py,sha256=KX15Afr3q_41AMHBirEWkVoeDET0_cVN3bOOP8Y_q0k,3478
+omlish/__about__.py,sha256=9rj0m3n7RBQVQZMvY6T23ySBhV_U7yrnp5EbbcfsW48,3478
 omlish/__init__.py,sha256=SsyiITTuK0v74XpKV8dqNaCmjOlan1JZKrHQv5rWKPA,253
 omlish/c3.py,sha256=rer-TPOFDU6fYq_AWio_AmA-ckZ8JDY5shIzQ_yXfzA,8414
 omlish/cached.py,sha256=MLap_p0rdGoDIMVhXVHm1tsbcWobJF0OanoodV03Ju8,542
@@ -404,7 +404,7 @@ omlish/iterators/iterators.py,sha256=RxW35yQ5ed8vBQ22IqpDXFx-i5JiLQdp7-pkMZXhJJ8
 omlish/iterators/recipes.py,sha256=wOwOZg-zWG9Zc3wcAxJFSe2rtavVBYwZOfG09qYEx_4,472
 omlish/iterators/tools.py,sha256=tdtWhwkPQq3sg7Brakrcbf8e1cOBg6e0TtwnSMnvEpg,2582
 omlish/iterators/unique.py,sha256=Nw0pSaNEcHAkve0ugfLPvJcirDOn9ECyC5wIL8JlJKI,1395
-omlish/lang/__init__.py,sha256=YuPEZ3sIP6q5gGbISbQQ_CsOU5Zlu_IXHqxjO7muI-4,6251
+omlish/lang/__init__.py,sha256=nFH_r4AnosVDh6gyQ-2-y5OBgWiRik_Mx5hcN0TItdg,6434
 omlish/lang/attrs.py,sha256=i7euRF81uNF8QDmUVXSK_BtqLGshaMi4VVdUnMjiMwg,5050
 omlish/lang/casing.py,sha256=cFUlbDdXLhwnWwcYx4qnM5c4zGX7hIRUfcjiZbxUD28,4636
 omlish/lang/clsdct.py,sha256=HAGIvBSbCefzRjXriwYSBLO7QHKRv2UsE78jixOb-fA,1828
@@ -433,7 +433,9 @@ omlish/lang/cached/function.py,sha256=su9QxYECK9NK-UfMFKbgx4lqH2WoGBiYshnEfaGvfh
 omlish/lang/cached/property.py,sha256=WHYyg4-6EA86TcNMfbXTjVhjEZPc0kngt9hfY3WN5w8,2768
 omlish/lang/classes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 omlish/lang/classes/abstract.py,sha256=A-Jg5X8o_WvFryN0Cm2TpVkrZoTT1SYKQnv_pXjZk7o,3808
+omlish/lang/classes/bindable.py,sha256=ekVyOxrM9kQ9AtI9Zzc89zP_JBfJizIThKFNw4YZtS8,1096
 omlish/lang/classes/namespaces.py,sha256=_FBLekx2gNLql1C1ZRlpBtxuLWbcdFEzBm8CrD5XeOA,3589
+omlish/lang/classes/protocols.py,sha256=T98ZsHLgzw8hPvvNluxoreevoF8fD4zs8SwcnTXkLuY,701
 omlish/lang/classes/restrict.py,sha256=Ki-UOc2yUVteqC7i_EgIVpeEcnvRHVczjts5Fyiz7Mk,4125
 omlish/lang/classes/simple.py,sha256=2C7u8k0K75xzcr6DT8zYd8U-1Yr_Xq1pfF3a0J6wo3g,2538
 omlish/lang/classes/virtual.py,sha256=z0MYQD9Q5MkX8DzF325wDB4J9XoYbsB09jZ1omC62To,3366
@@ -496,7 +498,7 @@ omlish/marshal/global_.py,sha256=nTJmC17O8SJNURScIdYqEY72h-dRy6D-SaDSUQCp-cY,152
 omlish/marshal/naming.py,sha256=7jQ204u_Kpc3-OGr-ctUHSv997DdWYRLh643qLHJhks,852
 omlish/marshal/proxy.py,sha256=puKJpwPpuDlMOIrKMcLTRLJyMiL6n_Xs-p59AuDEymA,543
 omlish/marshal/registries.py,sha256=FvC6qXHCizNB2QmU_N3orxW7iqfGYkiUXYYdTRWS6HA,2353
-omlish/marshal/standard.py,sha256=TADR75Hd9VSUpuN_Tnu74Bzmvby42P2bzwFwUBC0l-Q,4283
+omlish/marshal/standard.py,sha256=C1AawI1IrSb_mH6xBhZWHnqdjviVpk5-Cm9g-9aY02A,4487
 omlish/marshal/values.py,sha256=ssHiWdg_L6M17kAn8GiGdPW7UeQOm3RDikWkvwblf5I,263
 omlish/marshal/composite/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 omlish/marshal/composite/iterables.py,sha256=YdkdWNUe_AzdUqiAsr7z3kaDcPeg7Znj3AuQepY_qaA,2647
@@ -505,6 +507,7 @@ omlish/marshal/composite/mappings.py,sha256=HoqUKe4kyCYRdMpQMWW0DLPi0-DEsxt-nk4p
 omlish/marshal/composite/maybes.py,sha256=NfQ2cIHHIvohTl4iYPYbEvhNVq3L3JCu2GEbt4DM5DA,2216
 omlish/marshal/composite/newtypes.py,sha256=5-te247TiPYf84oFhf59tqIOOByXj8i9KaHT8gn72fU,878
 omlish/marshal/composite/optionals.py,sha256=MnecrmrJYjQvYJipIHNCDq78oH09dOjnw5pvaMKqoeU,1537
+omlish/marshal/composite/special.py,sha256=s0PcOmDiQyCjoxcdaGSORTqNoXNp6uuBz_NJs2kHzRM,1350
 omlish/marshal/composite/wrapped.py,sha256=jOsn3h1vLIqcoSTB-0KObnsdbV8jSVWJYbf7Kg9AUwg,750
 omlish/marshal/objects/__init__.py,sha256=F4wej8L_tedC8ETYxAnmKfdPR9TjsqIus9Z3nZofYuc,182
 omlish/marshal/objects/dataclasses.py,sha256=klXXY1zOKh_FYlw6L5ZNPjpXSk0ntUGxSOrm309WoiY,8953
@@ -563,11 +566,11 @@ omlish/os/pidfiles/cli.py,sha256=2SSsP4O3VdpsDIMAkWgWSjh_YNIPzCD9l5LNN2qrIjo,207
 omlish/os/pidfiles/manager.py,sha256=QphQxIENVVwvBWynLCNU31NwOfLkV43VoTVeYFn2Hac,2351
 omlish/os/pidfiles/pidfile.py,sha256=9tI5IMVwfPfnni0XMn4x5ptNQgm36n8tLeUNPf50UqU,4394
 omlish/os/pidfiles/pinning.py,sha256=aQgCmvcAqN0lvI70GcSB2TKVX1G4vwbyN_AOHF3-eKE,6630
-omlish/reflect/__init__.py,sha256=64eHbD6zL6Fhp7FfXb8n9ZHywlODjBN3rm1LMvZ081A,822
+omlish/reflect/__init__.py,sha256=9pzXLXXNMHkLhhI79iUr-o0SMOtR6HMUmAEUplZkIdE,853
 omlish/reflect/inspect.py,sha256=WCo2YpBYauKw6k758FLlZ_H4Q05rgVPs96fEv9w6zHQ,1538
-omlish/reflect/ops.py,sha256=9F369zrp6dNJUiGLLrYhb2O-Zss0BhTcpo3dzdLCq-I,2424
+omlish/reflect/ops.py,sha256=RxUc9sFZxYP_f5y-jU2DujFLkzhzx8DsyITShPSpW3U,2614
 omlish/reflect/subst.py,sha256=jpBgYR1_JyH9fz5b-gmOg7OhFKk7jIxEh7hwtKYKC9Q,3691
-omlish/reflect/types.py,sha256=Cn9FYGoiCNt0FS0YLiTTAR12WKcesWMapCrVYcb8IDo,9225
+omlish/reflect/types.py,sha256=C3NsAQFam_9mXhvSUa0H0RnJxhVAzIbY1Z_WHXHcNcs,11213
 omlish/secrets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 omlish/secrets/all.py,sha256=gv_d9SfyMxso30HsrSz9XmIrSZOdl3rLA5MSH0ZXfgM,486
 omlish/secrets/crypto.py,sha256=9D21lnvPhStwu8arD4ssT0ih0bDG-nlqIRdVgYL40xA,3708
@@ -742,7 +745,7 @@ omlish/testing/testing.py,sha256=zmBHw5gw1ZUUcDYC0uonSThjhRn0HNuorjpo0jLvju8,288
 omlish/testing/pytest/__init__.py,sha256=i4ti6Q2rVYJ-XBk9UYDfUUagCrEDTC5jOeSykBjYYZQ,234
 omlish/testing/pytest/helpers.py,sha256=HxiKvpJQ4b6WCiQXOqQTqKbmr7CMAgCF6hViT6pfIuw,202
 omlish/testing/pytest/marks.py,sha256=qhVnq-3LlQ5uRLS1LXYkh8Xk-8aQGOgs2Nr49T8YqOA,280
-omlish/testing/pytest/skip.py,sha256=imDrBhQKQkEmStaSn0Js-zsfyKMPmNod-mW1ANdIhak,989
+omlish/testing/pytest/skip.py,sha256=tra8FM5CZTh4M7ZWVf9YPmKUX4yhesf61XRoIkO4s9c,954
 omlish/testing/pytest/inject/__init__.py,sha256=pdRKv1HcDmJ_yArKJbYITPXXZthRSGgBJWqITr0Er38,117
 omlish/testing/pytest/inject/harness.py,sha256=_Qf7lLcYc_dpauYOE68u_a65jPCFWmQUYv9m_OOdNqs,5724
 omlish/testing/pytest/plugins/__init__.py,sha256=ys1zXrYrNm7Uo6YOIVJ6Bd3dQo6kv387k7MbTYlqZSI,467
@@ -754,7 +757,6 @@ omlish/testing/pytest/plugins/pydevd.py,sha256=5moE64LrNRV6gKRaeCuONDiwuh-4UFxJP
 omlish/testing/pytest/plugins/repeat.py,sha256=jiZCI-17042jBvUEbZCxNwqWtr7s3EhTBSeSHh_Uz4E,497
 omlish/testing/pytest/plugins/skips.py,sha256=eMir_n777Kk2BvOwjQzRROKL4iAMYKSHFwWCHJ-bdPI,1040
 omlish/testing/pytest/plugins/spacing.py,sha256=tzq-L-exegHe2BImumkYIsVcUwpUUhLJJOuSrsKDuCU,706
-omlish/testing/pytest/plugins/switches.py,sha256=z3TKe2NHBOaa_cmarWTRJo519iCNDff4e0XSfHkajHU,7365
 omlish/testing/pytest/plugins/utils.py,sha256=L5C622UXcA_AUKDcvyh5IMiRfqSGGz0McdhwZWvfMlU,261
 omlish/testing/pytest/plugins/asyncs/__init__.py,sha256=TTNhFmP_krug1973sq_bpWBTIvg68-1nbuVLSs92Z6k,41
 omlish/testing/pytest/plugins/asyncs/consts.py,sha256=0NOCkzV43dOu3u97BqYMQ4mPG8JuFncpWibkOZpCqX4,55
@@ -766,6 +768,9 @@ omlish/testing/pytest/plugins/asyncs/backends/asyncio.py,sha256=0b8pmbXNW2qI8qo1
 omlish/testing/pytest/plugins/asyncs/backends/base.py,sha256=fTZ6R_iKpAp-8DVw8js8rxC_VNqj6onFD4KKBWnmtXk,587
 omlish/testing/pytest/plugins/asyncs/backends/trio.py,sha256=xty9TR7-Kk6n0cdOqErLilPLLCchJe6zmEyhpypTmKM,3330
 omlish/testing/pytest/plugins/asyncs/backends/trio_asyncio.py,sha256=VcGVwf4V-1ZFK_70FrFS9b11EU1dOy1ozhhIDXGNSEo,3169
+omlish/testing/pytest/plugins/switches/__init__.py,sha256=KTdm9xe8AYQvNT-IKSGr9O8q_hgRGEqhK3zcto0EbWk,43
+omlish/testing/pytest/plugins/switches/plugin.py,sha256=RBxjefl9RDJuSmT_W0lTSd9DlAT-nkyy_U2fBYzdWNs,5835
+omlish/testing/pytest/plugins/switches/switches.py,sha256=lj8S9RMwUAW7a93ZqqTjoD4dRVkeGts2sl8Cn-H17hc,1890
 omlish/text/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 omlish/text/asdl.py,sha256=AS3irh-sag5pqyH3beJif78PjCbOaFso1NeKq-HXuTs,16867
 omlish/text/decoding.py,sha256=sQWGckWzRslRHYKpj1SBeoo6AVqXm5HFlWFRARN1QpM,1286
@@ -849,18 +854,19 @@ omlish/text/antlr/_runtime/xpath/XPathLexer.py,sha256=WvGKQjQnu7pX5C4CFKtsCzba2B
 omlish/text/antlr/_runtime/xpath/__init__.py,sha256=lMd_BbXYdlDhZQN_q0TKN978XW5G0pq618F0NaLkpFE,71
 omlish/text/go/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 omlish/text/go/quoting.py,sha256=N9EYdnFdEX_A8fOviH-1w4jwV3XOQ7VU2WsoUNubYVY,9137
-omlish/typedvalues/__init__.py,sha256=nzpnoRW_wScMPit5Xz37ky3nKBdzzkgtnQA4SfVHN8E,684
-omlish/typedvalues/accessor.py,sha256=_NEGBmQ84-h_rDfYeoq7DA20fhj3dogQuvzxXKhjx54,3121
-omlish/typedvalues/collection.py,sha256=TjNuEEyTXbGfbsk7nvBB_Jhgz94R5JSs0u6ocNAlj3Y,5511
+omlish/typedvalues/__init__.py,sha256=Br1vFbV-dEjAfBbZ9Zg2xCGO87U6kduxxq69lrMRODw,722
+omlish/typedvalues/accessor.py,sha256=959QsdK1zildcBTvFKSA6uAgi7SSo2RPKqcKWsuEZrM,3162
+omlish/typedvalues/collection.py,sha256=QxQwaSmJGF2oAWAv2CZkgpOljbnxor104XOrCD0v1a8,5571
 omlish/typedvalues/consumer.py,sha256=peDQAgriSyBx_Hc8QHAhEgYy0oSS52qQ_7Tqdssl2AE,4375
 omlish/typedvalues/generic.py,sha256=ft-x4X3k1oFirtYnDfsvrI3ZQikWM8lGLrvrOEbcGq0,742
 omlish/typedvalues/holder.py,sha256=vu-umn-h1nvUqmtV5T9ZfQ_OoOYsERu8PhI2N48Ryns,1133
 omlish/typedvalues/marshal.py,sha256=AtBz7Jq-BfW8vwM7HSxSpR85JAXmxK2T0xDblmm1HI0,4956
+omlish/typedvalues/of_.py,sha256=UXkxSj504WI2UrFlqdZJbu2hyDwBhL7XVrc2qdR02GQ,1309
 omlish/typedvalues/reflect.py,sha256=PAvKW6T4cW7u--iX80w3HWwZUS3SmIZ2_lQjT65uAyk,1026
 omlish/typedvalues/values.py,sha256=ym46I-q2QJ_6l4UlERqv3yj87R-kp8nCKMRph0xQ3UA,1307
-omlish-0.0.0.dev337.dist-info/licenses/LICENSE,sha256=B_hVtavaA8zCYDW99DYdcpDLKz1n3BBRjZrcbv8uG8c,1451
-omlish-0.0.0.dev337.dist-info/METADATA,sha256=szcv8KfqOgZ4IO8pvgfNNoBkvv4Rvl1FqtQtLZK0fFA,4416
-omlish-0.0.0.dev337.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-omlish-0.0.0.dev337.dist-info/entry_points.txt,sha256=Lt84WvRZJskWCAS7xnQGZIeVWksprtUHj0llrvVmod8,35
-omlish-0.0.0.dev337.dist-info/top_level.txt,sha256=pePsKdLu7DvtUiecdYXJ78iO80uDNmBlqe-8hOzOmfs,7
-omlish-0.0.0.dev337.dist-info/RECORD,,
+omlish-0.0.0.dev339.dist-info/licenses/LICENSE,sha256=B_hVtavaA8zCYDW99DYdcpDLKz1n3BBRjZrcbv8uG8c,1451
+omlish-0.0.0.dev339.dist-info/METADATA,sha256=Bx0Qfyj8FjWFBV_s8fjqv2aA13OgX8R1SCRM5RKTMSU,4416
+omlish-0.0.0.dev339.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+omlish-0.0.0.dev339.dist-info/entry_points.txt,sha256=Lt84WvRZJskWCAS7xnQGZIeVWksprtUHj0llrvVmod8,35
+omlish-0.0.0.dev339.dist-info/top_level.txt,sha256=pePsKdLu7DvtUiecdYXJ78iO80uDNmBlqe-8hOzOmfs,7
+omlish-0.0.0.dev339.dist-info/RECORD,,