omlish 0.0.0.dev304__py3-none-any.whl → 0.0.0.dev305__py3-none-any.whl

omlish/__about__.py

@@ -1,5 +1,5 @@
-__version__ = '0.0.0.dev304'
-__revision__ = '0ecc67df99993947b491b2d6d6163fd00b00202e'
+__version__ = '0.0.0.dev305'
+__revision__ = '13f1bfc223e6af63310421aa4ac6133b3f1e0110'
 
 
 #

omlish/dataclasses/__init__.py

@@ -60,6 +60,7 @@ from .api import (  # noqa
     extra_field_params,
     set_field_metadata,
     update_extra_field_params,
+    with_extra_field_params,
 )
 
 from .errors import (  # noqa
@@ -108,6 +109,10 @@ from .tools.modifiers import (  # noqa
     update_fields,
 )
 
+from .tools.only_ import (  # noqa
+    only,
+)
+
 from .tools.replace import (  # noqa
     deep_replace,
 )

omlish/dataclasses/api/__init__.py

@@ -18,6 +18,7 @@ from .fields.metadata import (  # noqa
     extra_field_params,
     set_field_metadata,
     update_extra_field_params,
+    with_extra_field_params,
 )
 
 from .fields.constructor import (  # noqa

omlish/dataclasses/api/fields/metadata.py

@@ -5,6 +5,7 @@ from .... import check
 from .... import lang
 from ...debug import DEBUG
 from ...specs import FieldSpec
+from ...tools.modifiers import field_modifier
 from ...utils import chain_mapping_proxy
 
 
@@ -92,3 +93,10 @@ def update_extra_field_params(
             **(fe if unless_non_default else {}),
         },
     })
+
+
+def with_extra_field_params(**kwargs: ta.Any) -> field_modifier:
+    @field_modifier
+    def inner(f: dc.Field) -> dc.Field:
+        return update_extra_field_params(f, **kwargs)
+    return inner

omlish/dataclasses/tools/only_.py

@@ -0,0 +1,45 @@
+import collections.abc
+import typing as ta
+
+from .iter import fields_dict
+
+
+##
+
+
+def _only_test(v: ta.Any) -> bool:
+    if v is None:
+        return False
+    elif isinstance(v, collections.abc.Iterable):
+        return bool(v)
+    else:
+        return True
+
+
+def only(
+        obj: ta.Any,
+        *flds: str,
+        all: bool = False,  # noqa
+        test: ta.Callable[[ta.Any], bool] = _only_test,
+) -> bool:
+    fdct = fields_dict(obj)
+    for fn in flds:
+        if fn not in fdct:
+            raise KeyError(fn)
+
+    rem = set(flds)
+    for fn, f in fdct.items():
+        if not f.compare and fn not in rem:
+            continue
+
+        v = getattr(obj, fn)
+        if test(v):
+            if fn in rem:
+                rem.remove(fn)
+            else:
+                return False
+
+    if rem and all:
+        return False
+
+    return True

omlish/diag/_pycharm/runhack.py

@@ -24,7 +24,10 @@ DEBUG_ENV_VAR = 'OMLISH_PYCHARM_RUNHACK_DEBUG'
 
 #
 
-_DEFAULT_PTH_FILE_NAME = 'omlish-pycharm-runhack.pth'
+# This hack must run first, before things like '__editable__.foo.pth' files installed by setuptools. pth file processing
+# is sorted by name, so prepend with underscores:
+#   https://github.com/python/cpython/blob/aeb3a6f61af53ed3fbf31f0b3704f49b71ac553c/Lib/site.py#L246
+_DEFAULT_PTH_FILE_NAME = '___omlish-pycharm-runhack.pth'
 
 _DEFAULT_DEBUG = False
 _DEFAULT_ENABLED = True

omlish/graphs/trees.py

@@ -19,6 +19,9 @@ NodeWalker = ta.Callable[[NodeT], ta.Iterable[NodeT]]
 NodeGenerator = ta.Generator[NodeT, None, None]
 
 
+##
+
+
 class NodeError(ta.Generic[NodeT], Exception):
     def __init__(self, node: NodeT, msg: str, *args, **kwargs) -> None:
         super().__init__(msg, *args, **kwargs)  # noqa
@@ -39,6 +42,9 @@ class UnknownNodeError(NodeError[NodeT]):
         super().__init__(node, f'Unknown node: {node!r}', *args, **kwargs)
 
 
+#
+
+
 class BasicTreeAnalysis(ta.Generic[NodeT]):
     def __init__(
             self,

omlish/lang/__init__.py

@@ -231,6 +231,7 @@ from .maybes import (  # noqa
 )
 
 from .objects import (  # noqa
+    Identity,
     SimpleProxy,
     anon_object,
     arg_repr,
@@ -269,6 +270,12 @@ from .params import (  # noqa
     param_render,
 )
 
+from .recursion import (  # noqa
+    LimitedRecursionError,
+    recursion_limiting,
+    recursion_limiting_context,
+)
+
 from .resolving import (  # noqa
     Resolvable,
     ResolvableClassNameError,

omlish/lang/cached/function.py

@@ -15,6 +15,8 @@ TODO:
    - and must be transient?
  - use __transient_dict__ to support common state nuking
  - use __set_name__ ?
+ - on_compute
+ - max_recursion?
 """
 import dataclasses as dc
 import functools
@@ -201,6 +203,9 @@ class _CachedFunction(ta.Generic[T], Abstract):
         except KeyError:
             pass
 
+        def call_value_fn():
+            return self._value_fn(*args, **kwargs)
+
         if self._lock is not None:
             with self._lock:
                 try:
@@ -208,10 +213,10 @@ class _CachedFunction(ta.Generic[T], Abstract):
                 except KeyError:
                     pass
 
-                value = self._value_fn(*args, **kwargs)
+                value = call_value_fn()
 
         else:
-            value = self._value_fn(*args, **kwargs)
+            value = call_value_fn()
 
         self._values[k] = value
         return value

omlish/lang/objects.py

@@ -222,3 +222,31 @@ class _AnonObject:
 
 def anon_object(**attrs: ta.Any) -> ta.Any:
     return _AnonObject(**attrs)
+
+
+##
+
+
+class Identity(ta.Generic[T]):
+    def __init__(self, obj: T) -> None:
+        super().__init__()
+
+        self._obj = obj
+
+    def __bool__(self):
+        raise TypeError
+
+    @property
+    def obj(self) -> T:
+        return self._obj
+
+    def __repr__(self) -> str:
+        return f'{self.__class__.__name__}({self._obj!r})'
+
+    def __hash__(self) -> int:
+        return id(self._obj)
+
+    def __eq__(self, other):
+        if type(other) is not type(self):
+            return NotImplemented
+        return self._obj is other._obj  # noqa

omlish/lang/recursion.py

@@ -0,0 +1,109 @@
+import contextlib
+import dataclasses as dc
+import functools
+import threading
+import typing as ta
+
+
+T = ta.TypeVar('T')
+P = ta.ParamSpec('P')
+
+
+##
+
+
+_LOCK = threading.RLock()
+
+_LOCAL: threading.local
+
+
+def _local() -> threading.local:
+    global _LOCAL
+
+    try:
+        return _LOCAL
+    except NameError:
+        pass
+
+    with _LOCK:
+        try:
+            return _LOCAL
+        except NameError:
+            pass
+
+        _LOCAL = threading.local()
+        return _LOCAL
+
+
+def _depth_map() -> dict[ta.Any, int]:
+    lo = _local()
+    try:
+        return lo.depth_map
+    except AttributeError:
+        dm = lo.depth_map = {}
+        return dm
+
+
+##
+
+
+@dc.dataclass()
+class LimitedRecursionError(RecursionError):
+    key: ta.Any
+    depth: int
+
+
+@contextlib.contextmanager
+def recursion_limiting_context(key: ta.Any, limit: int | None) -> ta.Iterator[int | None]:
+    if limit is None:
+        yield None
+        return
+
+    dm = _depth_map()
+
+    try:
+        pd: int | None = dm[key]
+    except KeyError:
+        pd = None
+    else:
+        if not isinstance(pd, int) and pd > 0:  # type: ignore[operator]
+            raise RuntimeError
+
+    if pd is not None and pd >= limit:
+        raise LimitedRecursionError(key, pd)
+
+    nd = (pd or 0) + 1
+    dm[key] = nd
+
+    try:
+        yield nd
+
+    finally:
+        if dm.get(key) != nd:
+            raise RuntimeError
+
+        if pd is not None:
+            dm[key] = pd
+        else:
+            del dm[key]
+
+
+##
+
+
+def recursion_limiting(limit: int | None) -> ta.Callable[[ta.Callable[P, T]], ta.Callable[P, T]]:
+    def outer(fn):
+        if not callable(fn):
+            raise TypeError(fn)
+
+        if limit is None:
+            return fn
+
+        @functools.wraps(fn)
+        def inner(*args, **kwargs):
+            with recursion_limiting_context(fn, limit):
+                return fn(*args, **kwargs)
+
+        return inner
+
+    return outer

omlish/marshal/__init__.py

@@ -82,9 +82,9 @@ from .objects.dataclasses import (  # noqa
 )
 
 from .objects.helpers import (  # noqa
-    update_field_metadata,
     update_fields_metadata,
     update_object_metadata,
+    with_field_metadata,
 )
 
 from .objects.marshal import (  # noqa

omlish/marshal/objects/helpers.py

@@ -11,7 +11,7 @@ T = ta.TypeVar('T')
 ##
 
 
-def update_field_metadata(**kwargs: ta.Any) -> dc.field_modifier:
+def with_field_metadata(**kwargs: ta.Any) -> dc.field_modifier:
     @dc.field_modifier
     def inner(f: dc.Field) -> dc.Field:
         return dc.set_field_metadata(f, {

omlish/sql/api/__init__.py

@@ -35,9 +35,16 @@ from .errors import (  # noqa
 )
 
 from .funcs import (  # noqa
+    exec,  # noqa
+
     query,
     query_all,
-    exec,  # noqa
+    query_first,
+    query_opt_first,
+    query_one,
+    query_opt_one,
+    query_scalar,
+    query_maybe_scalar,
 )
 
 from .queries import (  # noqa

omlish/sql/api/base.py

@@ -30,7 +30,7 @@ class Querier(ContextCloser, lang.Abstract):
 ##
 
 
-class Rows(ContextCloser, lang.Abstract):
+class Rows(ContextCloser, ta.Iterator[Row], lang.Abstract):
     @property
     @abc.abstractmethod
     def columns(self) -> Columns:

omlish/sql/api/funcs.py

@@ -1,5 +1,7 @@
 import typing as ta
 
+from ... import check
+from ... import lang
 from .asquery import as_query
 from .base import Querier
 from .base import Rows
@@ -10,6 +12,25 @@ from .rows import Row
 ##
 
 
+def exec(  # noqa
+        querier: Querier,
+        obj: ta.Any,
+        *args: ta.Any,
+) -> None:
+    q = as_query(
+        obj,
+        *args,
+        mode=QueryMode.EXEC,
+        querier=querier,
+    )
+
+    with querier.query(q):
+        pass
+
+
+##
+
+
 def query(
         querier: Querier,
         obj: ta.Any,
@@ -37,20 +58,58 @@ def query_all(
         return list(rows)
 
 
-##
+def query_first(
+        querier: Querier,
+        obj: ta.Any,
+        *args: ta.Any,
+) -> Row:
+    with query(querier, obj, *args) as rows:
+        return next(rows)
 
 
-def exec(  # noqa
+def query_opt_first(
         querier: Querier,
         obj: ta.Any,
         *args: ta.Any,
-) -> None:
-    q = as_query(
-        obj,
-        *args,
-        mode=QueryMode.EXEC,
-        querier=querier,
-    )
+) -> Row | None:
+    with query(querier, obj, *args) as rows:
+        return next(rows, None)
 
-    with querier.query(q):
-        pass
+
+def query_one(
+        querier: Querier,
+        obj: ta.Any,
+        *args: ta.Any,
+) -> Row:
+    with query(querier, obj, *args) as rows:
+        return check.single(rows)
+
+
+def query_opt_one(
+        querier: Querier,
+        obj: ta.Any,
+        *args: ta.Any,
+) -> Row | None:
+    with query(querier, obj, *args) as rows:
+        return check.opt_single(rows)
+
+
+def query_scalar(
+        querier: Querier,
+        obj: ta.Any,
+        *args: ta.Any,
+) -> ta.Any:
+    row = query_one(querier, obj, *args)
+    return check.single(row.values)
+
+
+def query_maybe_scalar(
+        querier: Querier,
+        obj: ta.Any,
+        *args: ta.Any,
+) -> lang.Maybe[ta.Any]:
+    row = query_opt_one(querier, obj, *args)
+    if row is not None:
+        return lang.just(check.single(row.values))
+    else:
+        return lang.empty()

omlish/sql/qualifiedname.py

@@ -1,23 +1,31 @@
 import collections.abc
-import dataclasses as dc
 import typing as ta
 
+from .. import dataclasses as dc
+from .. import lang
+
 
 ##
 
 
+def coerce_parts(parts: ta.Sequence[str]) -> tuple[str, ...]:
+    if not parts:
+        raise ValueError
+    if isinstance(parts, str):
+        raise TypeError(parts)
+    if not isinstance(parts, tuple):
+        parts = tuple(parts)
+    if not all(parts) and all(isinstance(p, str) for p in parts):
+        raise ValueError(parts)
+    return parts
+
+
+#
+
+
 @dc.dataclass(frozen=True)
-class QualifiedName(ta.Sequence[str]):
-    parts: ta.Sequence[str]
-
-    def __post_init__(self) -> None:
-        if not (
-                self.parts and
-                not isinstance(self.parts, str) and
-                all(self.parts) and
-                all(isinstance(p, str) for p in self.parts)
-        ):
-            raise ValueError(self)
+class QualifiedName(ta.Sequence[str], lang.Final):
+    parts: ta.Sequence[str] = dc.field() | dc.with_extra_field_params(coerce=coerce_parts)
 
     def __repr__(self) -> str:
         return f'{self.__class__.__name__}([{", ".join(map(repr, self.parts))}])'

omlish/sql/queries/__init__.py

@@ -1,5 +1,6 @@
 from .base import (  # noqa
     Builder,
+    HasQn,
     Node,
     NodeComparisonTypeError,
     Value,
@@ -56,6 +57,8 @@ from .params import (  # noqa
 from .relations import (  # noqa
     CanRelation,
     CanTable,
+    Join,
+    JoinKind,
     Relation,
     RelationBuilder,
     Table,

omlish/sql/queries/base.py

@@ -1,8 +1,10 @@
+import abc
 import types
 import typing as ta
 
 from ... import dataclasses as dc
 from ... import lang
+from ..qualifiedname import QualifiedName
 
 
 ##
@@ -45,6 +47,10 @@ class Node(
     def __ne__(self, other) -> ta.NoReturn:
         raise NodeComparisonTypeError(type(self))
 
+    @ta.final
+    def __bool__(self) -> ta.NoReturn:
+        raise TypeError
+
     #
 
     @dc.dataclass(frozen=True)
@@ -130,3 +136,13 @@ class Node(
 
 class Builder(lang.Abstract):
     pass
+
+
+##
+
+
+class HasQn(lang.Abstract):
+    @property
+    @abc.abstractmethod
+    def qn(self) -> QualifiedName:
+        raise NotImplementedError

omlish/sql/queries/idents.py

@@ -1,9 +1,16 @@
+"""
+TODO:
+ - clamp down on as_ident / CanIdent - no strs allowed
+"""
 import abc
 import functools
 import typing as ta
 
+from ... import cached
 from ... import lang
+from ..qualifiedname import QualifiedName
 from .base import Builder
+from .base import HasQn
 from .base import Node
 
 
@@ -17,9 +24,13 @@ class IdentLike(abc.ABC):  # noqa
 ##
 
 
-class Ident(Node, IdentLike, lang.Final):
+class Ident(Node, IdentLike, HasQn, lang.Final):
     s: str
 
+    @cached.property
+    def qn(self) -> QualifiedName:
+        return QualifiedName((self.s,))
+
 
 ##
 

omlish/sql/queries/names.py

@@ -2,9 +2,12 @@ import abc
 import functools
 import typing as ta
 
+from ... import cached
 from ... import check
 from ... import dataclasses as dc
 from ... import lang
+from ..qualifiedname import QualifiedName
+from .base import HasQn
 from .base import Node
 from .idents import CanIdent
 from .idents import Ident
@@ -27,9 +30,13 @@ def _coerce_name_parts(o: ta.Iterable[Ident]) -> ta.Sequence[Ident]:
     return check.not_empty(tuple(check.isinstance(e, Ident) for e in o))
 
 
-class Name(Node, NameLike, lang.Final):
+class Name(Node, NameLike, HasQn, lang.Final):
     ps: ta.Sequence[Ident] = dc.xfield(coerce=_coerce_name_parts)
 
+    @cached.property
+    def qn(self) -> QualifiedName:
+        return QualifiedName(tuple(p.s for p in self.ps))
+
 
 ##
 

omlish/sql/queries/relations.py

@@ -39,11 +39,8 @@ class JoinKind(enum.Enum):
     DEFAULT = enum.auto()
     INNER = enum.auto()
     LEFT = enum.auto()
-    LEFT_OUTER = enum.auto()
     RIGHT = enum.auto()
-    RIGHT_OUTER = enum.auto()
     FULL = enum.auto()
-    FULL_OUTER = enum.auto()
     CROSS = enum.auto()
     NATURAL = enum.auto()
 
@@ -95,21 +92,12 @@ class RelationBuilder(MultiBuilder):
     def left_join(self, l: CanRelation, r: CanRelation, *cs: CanExpr) -> Join:
         return self.join(JoinKind.LEFT, l, r, *cs)
 
-    def left_outer_join(self, l: CanRelation, r: CanRelation, *cs: CanExpr) -> Join:
-        return self.join(JoinKind.LEFT_OUTER, l, r, *cs)
-
     def right_join(self, l: CanRelation, r: CanRelation, *cs: CanExpr) -> Join:
         return self.join(JoinKind.RIGHT, l, r, *cs)
 
-    def right_outer_join(self, l: CanRelation, r: CanRelation, *cs: CanExpr) -> Join:
-        return self.join(JoinKind.RIGHT_OUTER, l, r, *cs)
-
     def full_join(self, l: CanRelation, r: CanRelation, *cs: CanExpr) -> Join:
         return self.join(JoinKind.FULL, l, r, *cs)
 
-    def full_outer_join(self, l: CanRelation, r: CanRelation, *cs: CanExpr) -> Join:
-        return self.join(JoinKind.FULL_OUTER, l, r, *cs)
-
     def cross_join(self, l: CanRelation, r: CanRelation, *cs: CanExpr) -> Join:
         return self.join(JoinKind.CROSS, l, r, *cs)
 

omlish/sql/queries/rendering.py

@@ -225,11 +225,8 @@ class StdRenderer(Renderer):
         JoinKind.DEFAULT: 'join',
         JoinKind.INNER: 'inner join',
         JoinKind.LEFT: 'left join',
-        JoinKind.LEFT_OUTER: 'left outer join',
         JoinKind.RIGHT: 'right join',
-        JoinKind.RIGHT_OUTER: 'right outer join',
         JoinKind.FULL: 'full join',
-        JoinKind.FULL_OUTER: 'full outer join',
         JoinKind.CROSS: 'cross join',
         JoinKind.NATURAL: 'natural join',
     }

{omlish-0.0.0.dev304.dist-info → omlish-0.0.0.dev305.dist-info}/METADATA

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

{omlish-0.0.0.dev304.dist-info → omlish-0.0.0.dev305.dist-info}/RECORD

@@ -1,5 +1,5 @@
 omlish/.manifests.json,sha256=pjGUyLHaoWpPqRP3jz2u1fC1qoRc2lvrEcpU_Ax2tdg,8253
-omlish/__about__.py,sha256=F6X4fib8qJRwj4c8ttKlheoGULweTMxejclgu8k0w64,3478
+omlish/__about__.py,sha256=LvSNEgc-zfbkykExJmNhbtQkXdEXRqPSJufulYnCjfw,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
@@ -202,7 +202,7 @@ omlish/daemons/services.py,sha256=YYp2SMkJ71WgzOcYSXjWHeAyKKxu3j1dfuJvWkl0Dgw,34
 omlish/daemons/spawning.py,sha256=psR73zOYjMKTqNpx1bMib8uU9wAZz62tw5TaWHrTdyY,5337
 omlish/daemons/targets.py,sha256=00KmtlknMhQ5PyyVAhWl3rpeTMPym0GxvHHq6mYPZ7c,3051
 omlish/daemons/waiting.py,sha256=RfgD1L33QQVbD2431dkKZGE4w6DUcGvYeRXXi8puAP4,1676
-omlish/dataclasses/__init__.py,sha256=xo5rJYrQ2JE5jcX4fHv5e9bC6RIXFd-K8yurUP20oO8,1834
+omlish/dataclasses/__init__.py,sha256=NQc2jnXOaKia04px011joPMuB98YHOWk_SAUgaqL_T0,1911
 omlish/dataclasses/debug.py,sha256=giBiv6aXvX0IagwNCW64qBzNjfOFr3-VmgDy_KYlb-k,29
 omlish/dataclasses/errors.py,sha256=tyv3WR6az66uGGiq9FIuCHvy1Ef-G7zeMY7mMG6hy2Y,2527
 omlish/dataclasses/inspect.py,sha256=BlpPghVCU3w_YDnONEqqE99YHzJM2q3eoqe39YX25Ko,4596
@@ -210,7 +210,7 @@ omlish/dataclasses/internals.py,sha256=vIGCZnStgD3ef4drYRtVOrxhxmAPa0vJpo4pXcDcQ
 omlish/dataclasses/reflection.py,sha256=5N4acL27xwSnQJvoks6ts2JseGfwL_P9D2gM9vqtAFM,2243
 omlish/dataclasses/specs.py,sha256=r9hpIWy83ODiB1n7wTf7JL5fiCeeT8fWbMvxs7c4e3g,6148
 omlish/dataclasses/utils.py,sha256=gv6za6oJYBr1VaeGd7oXqq9lhBs_sxkpC27XYzJggno,1870
-omlish/dataclasses/api/__init__.py,sha256=GFodt19CKrfuBpdv1EUqVUCPAFIlHPnabE2G8QJElBY,426
+omlish/dataclasses/api/__init__.py,sha256=k5iS9QOwf_f4iOfGffYhnqDOcmEIwEUUTp00u11kIPM,455
 omlish/dataclasses/api/classes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 omlish/dataclasses/api/classes/conversion.py,sha256=x1Ayo5W3t8lVh10KGH_ZBJ_kK7HqcdI2LdJA6mR_WXQ,810
 omlish/dataclasses/api/classes/decorator.py,sha256=q-m05j6VhJ9_00TmrXBvwmv0_TFPTD8OURi1KbKo9-4,3933
@@ -221,7 +221,7 @@ omlish/dataclasses/api/fields/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5N
 omlish/dataclasses/api/fields/building.py,sha256=YVAJZ2c318vK0YWz9VU8_MdjA5qNjqsI3N85K-bD0TI,3314
 omlish/dataclasses/api/fields/constructor.py,sha256=T2GeczTz9uy2EOTDlU4VJoiXp-I6jvlxnYXChvQqHxk,1533
 omlish/dataclasses/api/fields/conversion.py,sha256=Pye4KOON78CBgDzwTqNb5fx8wE7uvlKcwVfQ2nhDzrM,5134
-omlish/dataclasses/api/fields/metadata.py,sha256=4hGRvG96qPNeipbnHlnbDNWqCANGCuE9BmjKUzTEzRQ,1689
+omlish/dataclasses/api/fields/metadata.py,sha256=9y8-M12pbOuEBC2gciuTeENrTV1AZheoHH2sKfq_Fuo,1933
 omlish/dataclasses/concerns/__init__.py,sha256=4Goga5wAOAbK6KcoHWC8jDC8M9ywgH7PfmXXxgCYCC8,208
 omlish/dataclasses/concerns/abc.py,sha256=ok2qE9ltgZXdf34YtLElTr7A-IYErJvVfP1-G2t2Sbc,391
 omlish/dataclasses/concerns/copy.py,sha256=U8kSHEvVupvXArS3OPB7GK_M7aPO9R3_Uk1nqHqxmJ8,1761
@@ -266,6 +266,7 @@ omlish/dataclasses/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 omlish/dataclasses/tools/as_.py,sha256=3mTFXf563Z4ZZnbCzJHv83WizOYBs2mpigJCamxTlpQ,2893
 omlish/dataclasses/tools/iter.py,sha256=JQUFG4Gn-xthhJ3OEqXLOWkq2KhRMuIqvEow0HcFPZg,540
 omlish/dataclasses/tools/modifiers.py,sha256=xo6D4yl58HhJrFwV1JeoNrLrgC4MUA6SAXCGoyV-gnM,1212
+omlish/dataclasses/tools/only_.py,sha256=hPpqzr9YW09YmlX_QJNU2aePHYJEIrbGCPwmnvVS_to,849
 omlish/dataclasses/tools/replace.py,sha256=izM9lPT6AhEtjqn22auqaofa0j69KO7iootF-2Uj4cY,396
 omlish/dataclasses/tools/repr.py,sha256=KFvF6uv2YYIKq8O3ZNbEAS1tqRQALsJ-SUlBNPd5_GI,190
 omlish/dataclasses/tools/static.py,sha256=4TOwUmSthWUin0UMtZYw0O8APJYRAD39O3TW7WZShic,8665
@@ -281,7 +282,7 @@ omlish/diag/pycharm.py,sha256=Z2W-Viqw5xq08ZC4z36skpozfYw_qNNhWQx_GYr2D0k,4695
 omlish/diag/pydevd.py,sha256=UN55ZjkWLCVyHxE2CNRRYamuvSKfzWsn0D5oczRTXO4,7536
 omlish/diag/threads.py,sha256=1-x02VCDZ407gfbtXm1pWK-ubqhqfePm9PMqkHCVoqk,3642
 omlish/diag/_pycharm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-omlish/diag/_pycharm/runhack.py,sha256=JFz4GVN4AXndJo38iwnK5X_vH2MS6wyO8YmVZss5YRE,35157
+omlish/diag/_pycharm/runhack.py,sha256=O37sduvkx99uQaEg_XWLDBJlUxaqgd2LkjmdGaUT6e4,35432
 omlish/diag/replserver/__init__.py,sha256=uLo6V2aQ29v9z3IMELlPDSlG3_2iOT4-_X8VniF-EgE,235
 omlish/diag/replserver/__main__.py,sha256=LmU41lQ58bm1h4Mx7S8zhE_uEBSC6kPcp9mn5JRpulA,32
 omlish/diag/replserver/console.py,sha256=XzBDVhYlr8FY6ym4OwoaIHuFOHnGK3dTYlMDIOMUUlA,7410
@@ -366,7 +367,7 @@ omlish/funcs/pipes.py,sha256=E7Sz8Aj8ke_vCs5AMNwg1I36kRdHVGTnzxVQaDyn43U,2490
 omlish/graphs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 omlish/graphs/dags.py,sha256=7ee4GfzHcAVUA5-LMJyT7odwxoooh4cTwz4H8qi8Anc,3045
 omlish/graphs/domination.py,sha256=N-rCzB3uAug964Tx4YGew1Nuh7GvzGjA598GcOj-Who,7571
-omlish/graphs/trees.py,sha256=IA2lMbPec-4UrkYFUjUqqxAKeww6YMV35xj8uQhILYk,8188
+omlish/graphs/trees.py,sha256=dPlIBqWNqPn-kGHBeTkSgmZ_3haq5nEmsdBY1fYnvgE,8197
 omlish/graphs/dot/__init__.py,sha256=Y1MZRQBZkcYyG1Tn7K2FhL8aYbm4v4tk6f5g9AqEkUw,359
 omlish/graphs/dot/items.py,sha256=7c-lvB2pp6LKWDI2di-S6Zh4vlUZt97eJeNQzuGilGc,4082
 omlish/graphs/dot/make.py,sha256=RN30gHfJPiXx5Q51kbDdhVJYf59Fr84Lz9J-mXRt9sI,360
@@ -464,7 +465,7 @@ omlish/iterators/iterators.py,sha256=RxW35yQ5ed8vBQ22IqpDXFx-i5JiLQdp7-pkMZXhJJ8
 omlish/iterators/recipes.py,sha256=wOwOZg-zWG9Zc3wcAxJFSe2rtavVBYwZOfG09qYEx_4,472
 omlish/iterators/tools.py,sha256=c4hArZEVV8y9_dFfmRwakusv1cWJLT4MkTkGRjnGN5U,2556
 omlish/iterators/unique.py,sha256=Nw0pSaNEcHAkve0ugfLPvJcirDOn9ECyC5wIL8JlJKI,1395
-omlish/lang/__init__.py,sha256=1m2Kc4CBk_C_B7ydPcGWTdCY00JRMrGtX_RlFvyVTo8,5729
+omlish/lang/__init__.py,sha256=ldzz3bIIkYhUd-Xmzn62NTOJ6av09vWfJSudkQJvz3M,5862
 omlish/lang/attrs.py,sha256=i7euRF81uNF8QDmUVXSK_BtqLGshaMi4VVdUnMjiMwg,5050
 omlish/lang/casing.py,sha256=cFUlbDdXLhwnWwcYx4qnM5c4zGX7hIRUfcjiZbxUD28,4636
 omlish/lang/clsdct.py,sha256=HAGIvBSbCefzRjXriwYSBLO7QHKRv2UsE78jixOb-fA,1828
@@ -479,16 +480,17 @@ omlish/lang/generators.py,sha256=5tbjVAywiZH6oAdj1sJLRMtIkC9y3rAkecLT7Z3m7_g,525
 omlish/lang/imports.py,sha256=y9W9Y-d_cQ35QCLuSIPoa6vnEqSErFCz8b-34IH128U,10552
 omlish/lang/iterables.py,sha256=HOjcxOwyI5bBApDLsxRAGGhTTmw7fdZl2kEckxRVl-0,1994
 omlish/lang/maybes.py,sha256=pb1YrxmpXy-hWKmWR89GxXqZq1MoUD1uuTaTX30peh0,3697
-omlish/lang/objects.py,sha256=q1T26cxLkejU5XMl5iEVC9IIhjib0VBpe7JCo2bz2Ws,5411
+omlish/lang/objects.py,sha256=nbxBHfQHVw0OG4qeSTP2GvIiFIcH2tbbitY8y-mYPPo,5959
 omlish/lang/outcomes.py,sha256=mpFy_VoM-b74L1aCFsjsZVUHx_icZ1AHMOKeVesjOp4,8628
 omlish/lang/params.py,sha256=QmNVBfJsfxjDG5ilDPgHV7sK4UwRztkSQdLTo0umb8I,6648
+omlish/lang/recursion.py,sha256=1VfSqzKO-8Is3t9LKw0W4jwPfE0aBS70EUlbUxAx4eE,1900
 omlish/lang/resolving.py,sha256=ei9LDyJexsMMHB9z8diUkNmynWhd_da7h7TqrMYM6lA,1611
 omlish/lang/resources.py,sha256=WKkAddC3ctMK1bvGw-elGe8ZxAj2IaUTKVSu2nfgHTo,2839
 omlish/lang/strings.py,sha256=kJmRFd1D36xXcjd9MdB12BCwF_-MVhNr-TpWj7hMi_4,4252
 omlish/lang/sys.py,sha256=b4qOPiJZQru_mbb04FNfOjYWUxlV2becZOoc-yya_rQ,411
 omlish/lang/typing.py,sha256=Zdad9Zv0sa-hIaUXPrzPidT7sDVpRcussAI7D-j-I1c,3296
 omlish/lang/cached/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-omlish/lang/cached/function.py,sha256=Nqr7XDVQdD21TawF-O9YG4jU4RwlBri-E1SusrDrmzo,9560
+omlish/lang/cached/function.py,sha256=0uTtDR1uaxwB2uTB_JTFcCr2c9NxsiWVvCLKVWUUHUw,9641
 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=n4rDlDraUKxPF0GtOWEFZ6mEzEDmP7Z8LSI6Jww_thw,3715
@@ -546,7 +548,7 @@ omlish/manifests/base.py,sha256=D1WvJYcBR_njkc0gpALpFCWh1h3agb9qgqphnbbPlm4,935
 omlish/manifests/load.py,sha256=9mdsS3egmSX9pymO-m-y2Fhs4p6ruOdbsYaKT1-1Hwg,6655
 omlish/manifests/static.py,sha256=7YwOVh_Ek9_aTrWsWNO8kWS10_j4K7yv3TpXZSHsvDY,501
 omlish/manifests/types.py,sha256=IOt9dOe0r8okCHSL82ryi3sn4VZ6AT80g_QQR6oZtCE,306
-omlish/marshal/__init__.py,sha256=vZX1PPOJZ9kFafZySmvCoxH6YT3qJ0pUj94vVUD7QOc,3368
+omlish/marshal/__init__.py,sha256=6nTREepo0aGQZcJdeOUkJRnSZ9Mx2Q1ok2XoE4dqijM,3366
 omlish/marshal/base.py,sha256=Q0ZRsz5z0NTI6PeWPc9mdMstJryDDbeIAdpKH9-SDps,11427
 omlish/marshal/errors.py,sha256=g5XJyTHd__8lfwQ4KwgK-E5WR6MoNTMrqKP2U_QRQQQ,307
 omlish/marshal/factories.py,sha256=Q926jSVjaQLEmStnHLhm_c_vqEysN1LnDCwAsFLIzXw,2970
@@ -566,7 +568,7 @@ omlish/marshal/composite/optionals.py,sha256=MnecrmrJYjQvYJipIHNCDq78oH09dOjnw5p
 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
-omlish/marshal/objects/helpers.py,sha256=H3K0J4fsJTaBVi7m6Be066YmlsRmOet48sop3LBr1wU,1104
+omlish/marshal/objects/helpers.py,sha256=hj5I1pILt3QFSVkYJNrSO3wiCaalAopEYWPL17Ip4zs,1102
 omlish/marshal/objects/marshal.py,sha256=JarKGecMgaFYSUHUj-ZUYVP9HK6u2rjpBb3DWX9Uhh0,2648
 omlish/marshal/objects/metadata.py,sha256=2_rESnslP5fwtEW1xy9ECJg64uA4cQBuYcGkRfPElts,3342
 omlish/marshal/objects/namedtuples.py,sha256=8de8L7rwmvr_LLBHHfOl2wHObxc_1yZ8fC_J25yZi7Q,2866
@@ -727,7 +729,7 @@ omlish/sql/abc.py,sha256=3hrCjB4jnPVMef_YXClCblzYUZ9l9yaxJJdd5_Nu9GM,4043
 omlish/sql/dbapi.py,sha256=DfMxCyltpMj6hUiLti1omUvJyMGbrkGxcz2ywolOpPA,2979
 omlish/sql/dbs.py,sha256=65e388987upJpsFX8bNL7uhiYv2sCsmk9Y04V0MXdsI,1873
 omlish/sql/params.py,sha256=Z4VPet6GhNqD1T_MXSWSHkdy3cpUEhST-OplC4B_fYI,4433
-omlish/sql/qualifiedname.py,sha256=c3GQzxh9sNyE_TP32PnlCun_F2bKXvX1ohtt6esTsjo,2269
+omlish/sql/qualifiedname.py,sha256=KdWOozaxsCi5hhsW6KwFM0HD3lTtBtJHDJ5HOx4DsWc,2447
 omlish/sql/alchemy/__init__.py,sha256=mZiu0F4Y_5qQpl-xz4xnb0feVGZTDp3I4R6k7SVY_7M,760
 omlish/sql/alchemy/apiadapter.py,sha256=QrkvlzqMl_S2nxOPQ8-g1UaWRSTZNna1-8XouOn8xdY,2696
 omlish/sql/alchemy/asyncs.py,sha256=MwZwWIaZsUCQLcTA8mdHUPZmR-pXEVSAsvd15FCm3W4,3692
@@ -735,14 +737,14 @@ omlish/sql/alchemy/duckdb.py,sha256=kr7pIhiBLNAuZrcigHDtFg9zHkVcrRW3LfryO9VJ4mk,
 omlish/sql/alchemy/exprs.py,sha256=gO4Fj4xEY-PuDgV-N8hBMy55glZz7O-4H7v1LWabfZY,323
 omlish/sql/alchemy/secrets.py,sha256=WEeaec1ejQcE3Yaa7p5BSP9AMGEzy1lwr7QMSRL0VBw,180
 omlish/sql/alchemy/sqlean.py,sha256=RbkuOuFIfM4fowwKk8-sQ6Dxk-tTUwxS94nY5Kxt52s,403
-omlish/sql/api/__init__.py,sha256=Ee-DgQPo_fUqlYL3NBzk6kmj_cXlnZIua5jk85UHWHI,951
+omlish/sql/api/__init__.py,sha256=VJo12MNFn0-GfSrbnve_l6Uo9bOYePKpZNQ9nApaPcg,1066
 omlish/sql/api/_queries.py,sha256=FqIrtU6JdzQD4S4zv9tdDuzCLHSgJjK8WSfT7Ag4umI,530
 omlish/sql/api/asquery.py,sha256=8eBoJyyu0kHW3k3yytEcT-B6UAI_slKB0QtSK_WQS7g,1203
-omlish/sql/api/base.py,sha256=E_t54OFr0BX604vOfQZGxh_n6EdOBF2Tvnrg25dMKXo,1314
+omlish/sql/api/base.py,sha256=oYFywk1fraINEyCeuZ3TvGaEcI6CdSojYX8iuHaSSow,1332
 omlish/sql/api/columns.py,sha256=UBol4bfwZ1nhcjv2gE1JhUMzRFeqtiCDo2T9CUGYb64,1943
 omlish/sql/api/dbapi.py,sha256=bDVqmljmLMdurMhIy3vx-dJvK1KiZ7XBhZ2Zx6W9aBs,2627
 omlish/sql/api/errors.py,sha256=YtC2gz5DqRTT3uCJniUOufVH1GEnFIc5ElkYLK3BHwM,230
-omlish/sql/api/funcs.py,sha256=kOMMzODkJHyKVmGKFS-6GIgil5I6ha1qjqA3IecgCvI,819
+omlish/sql/api/funcs.py,sha256=Raa8kL65l1JprMsJupFw-8EPO6MxxDhm0OPSwecMLOI,2045
 omlish/sql/api/queries.py,sha256=OVsVqNyXXJQVDPfV3GFE2gwnHyGEenS65rTQRTNGx1Y,735
 omlish/sql/api/resources.py,sha256=DTVQmKjhaLi27jHWYkF20VhwGvIazZWxyKzF0Wn9-dc,2228
 omlish/sql/api/rows.py,sha256=Jo3AA_6Wt7tlwLO6-rp0arzYFqZXSxPudGPkW2xCYgQ,1346
@@ -754,19 +756,19 @@ omlish/sql/parsing/_antlr/MinisqlListener.py,sha256=2py_bfDQeEtJaJh9rtpKghbSrQlE
 omlish/sql/parsing/_antlr/MinisqlParser.py,sha256=y9SFjXdQlWYJa2PbPm30d5SfcYM_8M8ts46IHhENbNc,132457
 omlish/sql/parsing/_antlr/MinisqlVisitor.py,sha256=NCPorucLLOZ-Q99BtNbDOAfHytQl8wyroR8pI1uVovg,10030
 omlish/sql/parsing/_antlr/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-omlish/sql/queries/__init__.py,sha256=LpBnJOGoT5Dw2C043yo1XXIg0C_eHda-u6DR2ZAKT7c,1530
-omlish/sql/queries/base.py,sha256=pQ6p8dSsHwsWa-lmK2h8RY2UJ1mwJRhByOgrCIW3dBs,3229
+omlish/sql/queries/__init__.py,sha256=m4sjtdWN7_9f70rc3vf7CuHgKJvf1QBcfGW_GDHb3hM,1565
+omlish/sql/queries/base.py,sha256=nsavenCsZgzpITSI1zGEAi95K3cRDfAxRgNJKJmYul0,3502
 omlish/sql/queries/binary.py,sha256=dcEzeEn104AMPuQ7QrJU2O-YCN3SUdxB5S4jaWKOUqY,2253
 omlish/sql/queries/exprs.py,sha256=dG9L218QtJM1HtDYIMWqHimK03N6AL1WONk3FvVRcXY,1480
-omlish/sql/queries/idents.py,sha256=w2RxO6SR3K-u30S259OtnAZaPv7YA70PzY9R7RtuCQ8,891
+omlish/sql/queries/idents.py,sha256=T9aFK8sia09ibkKdAWOUvCVeLqI9JLwXjUDPBAvDf6w,1153
 omlish/sql/queries/inserts.py,sha256=pSQXDSR1oDUmxjeIYuSbxpAZXvYQ-EJF6a62ON5Un-k,1299
 omlish/sql/queries/marshal.py,sha256=yVfN5VgYMYDaYTE6FZ8Sea7GrRobn40Hc8kogrfKmjE,3016
 omlish/sql/queries/multi.py,sha256=7x6x-4jnPzxA6ZasBjnjFuhHFpWt5rGCua3UvuTMIJ0,837
-omlish/sql/queries/names.py,sha256=4sDvgRobMEt_6mDeuYVbCqHzLCOwpXUdEyyB4-QjxKo,1996
+omlish/sql/queries/names.py,sha256=ko5ADruhhma9xfm4T7-UEd2uXRgGchfUeiz-xgiZlFE,2207
 omlish/sql/queries/ops.py,sha256=pDZ_2Jo_Fa8DDbtYkc6-9eehkWsZPI-jh-KFlubcY6Y,134
 omlish/sql/queries/params.py,sha256=FXgZO6F_fmRQb9CVo4PkRoypm_fSB_AB_JoM3PxRkKM,1206
-omlish/sql/queries/relations.py,sha256=7YrEC9IjoVpRGLAFKRSRsHHnTmx-g7hBNXsOgP2HOuI,2998
-omlish/sql/queries/rendering.py,sha256=iEQGVP1nOhaZy9FYNwKkOUgqFH0pxfvsCsJpHX8E9Vw,7662
+omlish/sql/queries/relations.py,sha256=_uOFcv_bfS0jfAexagxNMqMftmDWuWWWeRMzEQ3g_Oc,2479
+omlish/sql/queries/rendering.py,sha256=Js0ad4gAUOP9ZmkXQmjYWItwg62nDols5lEz50F1h-c,7516
 omlish/sql/queries/selects.py,sha256=5CD4qmlv5hysQKmoZuF1bbikA-VcC9opN94Ea1QE3mU,1577
 omlish/sql/queries/std.py,sha256=7kF76kq_b6Qaki-lYiBlZiZmtpWYqRqAcLU8x-bBZn0,648
 omlish/sql/queries/stmts.py,sha256=pBqwD7dRlqMu6uh6vR3xaWOEgbZCcFWbOQ9ryYd17T4,441
@@ -845,9 +847,9 @@ omlish/typedvalues/holder.py,sha256=ZTnHiw-K38ciOBLEdwgrltr7Xp8jjEs_0Lp69DH-G-o,
 omlish/typedvalues/marshal.py,sha256=hWHRLcrGav7lvXJDtb9bNI0ickl4SKPQ6F4BbTpqw3A,4219
 omlish/typedvalues/reflect.py,sha256=Ih1YgU-srUjsvBn_P7C66f73_VCvcwqE3ffeBnZBgt4,674
 omlish/typedvalues/values.py,sha256=ym46I-q2QJ_6l4UlERqv3yj87R-kp8nCKMRph0xQ3UA,1307
-omlish-0.0.0.dev304.dist-info/licenses/LICENSE,sha256=B_hVtavaA8zCYDW99DYdcpDLKz1n3BBRjZrcbv8uG8c,1451
-omlish-0.0.0.dev304.dist-info/METADATA,sha256=pBvxWE8MwSuga9H9NPi6L6YuxZ-EuSu4jYXGAn36N0Q,4416
-omlish-0.0.0.dev304.dist-info/WHEEL,sha256=wXxTzcEDnjrTwFYjLPcsW_7_XihufBwmpiBeiXNBGEA,91
-omlish-0.0.0.dev304.dist-info/entry_points.txt,sha256=Lt84WvRZJskWCAS7xnQGZIeVWksprtUHj0llrvVmod8,35
-omlish-0.0.0.dev304.dist-info/top_level.txt,sha256=pePsKdLu7DvtUiecdYXJ78iO80uDNmBlqe-8hOzOmfs,7
-omlish-0.0.0.dev304.dist-info/RECORD,,
+omlish-0.0.0.dev305.dist-info/licenses/LICENSE,sha256=B_hVtavaA8zCYDW99DYdcpDLKz1n3BBRjZrcbv8uG8c,1451
+omlish-0.0.0.dev305.dist-info/METADATA,sha256=xv6KDihpZe0TCjJOQAtfs6Yld4oOHnwCwhVuHNkBYR4,4416
+omlish-0.0.0.dev305.dist-info/WHEEL,sha256=wXxTzcEDnjrTwFYjLPcsW_7_XihufBwmpiBeiXNBGEA,91
+omlish-0.0.0.dev305.dist-info/entry_points.txt,sha256=Lt84WvRZJskWCAS7xnQGZIeVWksprtUHj0llrvVmod8,35
+omlish-0.0.0.dev305.dist-info/top_level.txt,sha256=pePsKdLu7DvtUiecdYXJ78iO80uDNmBlqe-8hOzOmfs,7
+omlish-0.0.0.dev305.dist-info/RECORD,,