omlish 0.0.0.dev381__py3-none-any.whl → 0.0.0.dev383__py3-none-any.whl

omlish/__about__.py

@@ -1,5 +1,5 @@
-__version__ = '0.0.0.dev381'
-__revision__ = 'f73e0ce8b22e02761d8deafb17e4cead2919af33'
+__version__ = '0.0.0.dev383'
+__revision__ = '30ecc2e778f892f6705283104b83b95626c3c24d'
 
 
 #
@@ -9,18 +9,22 @@ class ProjectBase:
     name: str | None = None
     authors = [{'name': 'wrmsr'}]
     urls = {'source': 'https://github.com/wrmsr/omlish'}
-    license = {'text': 'BSD-3-Clause'}
+    license = 'BSD-3-Clause'
+    readme = 'README.md'
     requires_python = '>=3.13'
 
     version = __version__
 
     classifiers = [
-        'License :: OSI Approved :: BSD License',
         'Development Status :: 2 - Pre-Alpha',
+
         'Intended Audience :: Developers',
 
         'Operating System :: OS Independent',
         'Operating System :: POSIX',
+
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.13',
     ]
 
 

omlish/inject/__init__.py

@@ -4,6 +4,8 @@
 from .binder import (  # noqa
     bind,
     bind_as_fn,
+    bind_map_entry_const,
+    bind_set_entry_const,
 )
 
 from .bindings import (  # noqa
@@ -112,6 +114,10 @@ from .scopes import (  # noqa
     enter_seeded_scope,
 )
 
+from .tags import (  # noqa
+    Id,
+)
+
 from .types import (  # noqa
     Scope,
     Tag,
@@ -120,5 +126,4 @@ from .types import (  # noqa
 
 from .utils import (  # noqa
     ConstFn,
-    Id,
 )

omlish/inject/binder.py

@@ -11,8 +11,13 @@ from .bindings import Binding
 from .eagers import Eager
 from .elements import Element
 from .elements import Elements
+from .elements import as_elements
 from .keys import Key
 from .keys import as_key
+from .multis import MapBinding
+from .multis import SetBinding
+from .multis import is_map_multi_key
+from .multis import is_set_multi_key
 from .privates import Expose
 from .providers import ConstProvider
 from .providers import CtorProvider
@@ -21,6 +26,7 @@ from .providers import LinkProvider
 from .providers import Provider
 from .scopes import SCOPE_ALIASES
 from .scopes import Singleton
+from .tags import Id
 from .types import Scope
 from .types import Unscoped
 
@@ -180,3 +186,45 @@ def bind(
         return elements[0]
     else:
         return Elements(frozenset(elements))
+
+
+##
+
+
+def bind_set_entry_const(
+        multi_key: ta.Any,
+        obj: ta.Any,
+        *,
+        tag: ta.Any | None = None,
+) -> Elements:
+    multi_key = as_key(multi_key)
+    check.arg(is_set_multi_key(multi_key))
+
+    if tag is None:
+        tag = Id(id(obj), tag=multi_key.tag)
+    obj_key: Key = Key(type(obj), tag=tag)
+
+    return as_elements(
+        bind(obj_key, to_const=obj),
+        SetBinding(multi_key, obj_key),
+    )
+
+
+def bind_map_entry_const(
+        multi_key: ta.Any,
+        map_key: ta.Any,
+        obj: ta.Any,
+        *,
+        tag: ta.Any | None = None,
+) -> Elements:
+    multi_key = as_key(multi_key)
+    check.arg(is_map_multi_key(multi_key))
+
+    if tag is None:
+        tag = Id(id(obj), tag=multi_key.tag)
+    obj_key: Key = Key(type(obj), tag=tag)
+
+    return as_elements(
+        bind(obj_key, to_const=obj),
+        MapBinding(multi_key, map_key, obj_key),
+    )

omlish/inject/keys.py

@@ -14,7 +14,7 @@ T = ta.TypeVar('T')
 
 
 @dc.dataclass(frozen=True)
-@dc.extra_class_params(cache_hash=True)
+@dc.extra_class_params(cache_hash=True, terse_repr=True)
 class Key(lang.Final, ta.Generic[T]):
     ty: rfl.Type = dc.xfield(coerce=rfl.type_)
 

omlish/inject/multis.py

@@ -25,34 +25,34 @@ V = ta.TypeVar('V')
 ##
 
 
-def _check_set_multi_key(mk: Key) -> bool:
+def is_set_multi_key(mk: Key) -> bool:
     return rfl.get_concrete_type(mk.ty) is collections.abc.Set
 
 
 @dc.dataclass(frozen=True)
 @dc.extra_class_params(cache_hash=True)
 class SetBinding(Element, lang.Final):
-    multi_key: Key = dc.xfield(validate=_check_set_multi_key)
+    multi_key: Key = dc.xfield(validate=is_set_multi_key)
     dst: Key = dc.xfield(coerce=check.of_isinstance(Key))
 
 
 @dc.dataclass(frozen=True)
 @dc.extra_class_params(cache_hash=True)
 class SetProvider(Provider):
-    multi_key: Key = dc.xfield(validate=_check_set_multi_key)
+    multi_key: Key = dc.xfield(validate=is_set_multi_key)
 
 
-##
+#
 
 
-def _check_map_multi_key(mk: Key) -> bool:
+def is_map_multi_key(mk: Key) -> bool:
     return rfl.get_concrete_type(mk.ty) is collections.abc.Mapping
 
 
 @dc.dataclass(frozen=True)
 @dc.extra_class_params(cache_hash=True)
 class MapBinding(Element, lang.Final):
-    multi_key: Key = dc.xfield(validate=_check_map_multi_key)
+    multi_key: Key = dc.xfield(validate=is_map_multi_key)
     map_key: ta.Any = dc.xfield()
     dst: Key = dc.xfield(coerce=check.of_isinstance(Key))
 
@@ -60,7 +60,7 @@ class MapBinding(Element, lang.Final):
 @dc.dataclass(frozen=True)
 @dc.extra_class_params(cache_hash=True)
 class MapProvider(Provider):
-    multi_key: Key = dc.xfield(validate=_check_map_multi_key)
+    multi_key: Key = dc.xfield(validate=is_map_multi_key)
 
 
 ##
@@ -94,6 +94,9 @@ class SetBinder(ElementGenerator, ta.Generic[T]):
         yield from self._sbs
 
 
+#
+
+
 class MapBinder(ElementGenerator, ta.Generic[K, V]):
     def __init__(self, *, tag: ta.Any = None) -> None:
         super().__init__()

omlish/inject/tags.py

@@ -0,0 +1,22 @@
+import typing as ta
+
+from .. import dataclasses as dc
+from .types import Tag
+
+
+##
+
+
+@dc.dataclass(frozen=True)
+@dc.extra_class_params(cache_hash=True, terse_repr=True)
+class Id:
+    """A utility dataclass intended to be used as a key tag for disambiguation."""
+
+    v: int
+
+    tag: ta.Any = dc.xfield(
+        default=None,
+        kw_only=True,
+        validate=lambda o: not isinstance(o, Tag),
+        repr_fn=dc.opt_repr,
+    )

omlish/inject/utils.py

@@ -19,14 +19,3 @@ class ConstFn(HasOriginsImpl, lang.Final, ta.Generic[T]):
 
     def __call__(self) -> T:
         return self.v
-
-
-##
-
-
-@dc.dataclass(frozen=True)
-@dc.extra_class_params(terse_repr=True)
-class Id:
-    """A utility dataclass intended to be used as a key tag for disambiguation."""
-
-    v: int

omlish/manifests/load.py

@@ -130,6 +130,7 @@ class ManifestLoader:
                 spec is not None and
                 isinstance(spec.loader, importlib.machinery.SourceFileLoader) and
                 spec.origin is not None and
+                len(spec.submodule_search_locations or []) == 1 and
                 os.path.basename(spec.origin) == '__init__.py' and
                 os.path.isfile(spec.origin)
         ):

omlish-0.0.0.dev383.dist-info/METADATA

@@ -0,0 +1,302 @@
+Metadata-Version: 2.4
+Name: omlish
+Version: 0.0.0.dev383
+Summary: omlish
+Author: wrmsr
+License-Expression: BSD-3-Clause
+Project-URL: source, https://github.com/wrmsr/omlish
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: all
+Requires-Dist: anyio~=4.10; extra == "all"
+Requires-Dist: sniffio~=1.3; extra == "all"
+Requires-Dist: greenlet~=3.2; extra == "all"
+Requires-Dist: trio~=0.30; extra == "all"
+Requires-Dist: trio-asyncio~=0.15; extra == "all"
+Requires-Dist: lz4~=4.4; extra == "all"
+Requires-Dist: python-snappy~=0.7; extra == "all"
+Requires-Dist: zstandard~=0.23; extra == "all"
+Requires-Dist: brotli~=1.1; extra == "all"
+Requires-Dist: asttokens~=3.0; extra == "all"
+Requires-Dist: executing~=2.2; extra == "all"
+Requires-Dist: psutil~=7.0; extra == "all"
+Requires-Dist: orjson~=3.11; extra == "all"
+Requires-Dist: ujson~=5.10; extra == "all"
+Requires-Dist: pyyaml~=6.0; extra == "all"
+Requires-Dist: cbor2~=5.6; extra == "all"
+Requires-Dist: cloudpickle~=3.1; extra == "all"
+Requires-Dist: httpx[http2]~=0.28; extra == "all"
+Requires-Dist: wrapt~=1.17; extra == "all"
+Requires-Dist: cryptography~=45.0; extra == "all"
+Requires-Dist: sqlalchemy[asyncio]~=2.0; extra == "all"
+Requires-Dist: pg8000~=1.31; extra == "all"
+Requires-Dist: pymysql~=1.1; extra == "all"
+Requires-Dist: aiomysql~=0.2; extra == "all"
+Requires-Dist: aiosqlite~=0.21; extra == "all"
+Requires-Dist: asyncpg~=0.30; extra == "all"
+Requires-Dist: apsw~=3.50; extra == "all"
+Requires-Dist: sqlean.py~=3.49; extra == "all"
+Requires-Dist: duckdb~=1.3; extra == "all"
+Requires-Dist: markupsafe~=3.0; extra == "all"
+Requires-Dist: jinja2~=3.1; extra == "all"
+Requires-Dist: pytest~=8.4; extra == "all"
+Requires-Dist: anyio~=4.10; extra == "all"
+Requires-Dist: sniffio~=1.3; extra == "all"
+Requires-Dist: asttokens~=3.0; extra == "all"
+Requires-Dist: executing~=2.2; extra == "all"
+Requires-Dist: orjson~=3.11; extra == "all"
+Requires-Dist: pyyaml~=6.0; extra == "all"
+Requires-Dist: wrapt~=1.17; extra == "all"
+Provides-Extra: async
+Requires-Dist: anyio~=4.10; extra == "async"
+Requires-Dist: sniffio~=1.3; extra == "async"
+Requires-Dist: greenlet~=3.2; extra == "async"
+Requires-Dist: trio~=0.30; extra == "async"
+Requires-Dist: trio-asyncio~=0.15; extra == "async"
+Provides-Extra: compress
+Requires-Dist: lz4~=4.4; extra == "compress"
+Requires-Dist: python-snappy~=0.7; extra == "compress"
+Requires-Dist: zstandard~=0.23; extra == "compress"
+Requires-Dist: brotli~=1.1; extra == "compress"
+Provides-Extra: diag
+Requires-Dist: asttokens~=3.0; extra == "diag"
+Requires-Dist: executing~=2.2; extra == "diag"
+Requires-Dist: psutil~=7.0; extra == "diag"
+Provides-Extra: formats
+Requires-Dist: orjson~=3.11; extra == "formats"
+Requires-Dist: ujson~=5.10; extra == "formats"
+Requires-Dist: pyyaml~=6.0; extra == "formats"
+Requires-Dist: cbor2~=5.6; extra == "formats"
+Requires-Dist: cloudpickle~=3.1; extra == "formats"
+Provides-Extra: http
+Requires-Dist: httpx[http2]~=0.28; extra == "http"
+Provides-Extra: misc
+Requires-Dist: wrapt~=1.17; extra == "misc"
+Provides-Extra: secrets
+Requires-Dist: cryptography~=45.0; extra == "secrets"
+Provides-Extra: sqlalchemy
+Requires-Dist: sqlalchemy[asyncio]~=2.0; extra == "sqlalchemy"
+Provides-Extra: sqldrivers
+Requires-Dist: pg8000~=1.31; extra == "sqldrivers"
+Requires-Dist: pymysql~=1.1; extra == "sqldrivers"
+Requires-Dist: aiomysql~=0.2; extra == "sqldrivers"
+Requires-Dist: aiosqlite~=0.21; extra == "sqldrivers"
+Requires-Dist: asyncpg~=0.30; extra == "sqldrivers"
+Requires-Dist: apsw~=3.50; extra == "sqldrivers"
+Requires-Dist: sqlean.py~=3.49; extra == "sqldrivers"
+Requires-Dist: duckdb~=1.3; extra == "sqldrivers"
+Provides-Extra: templates
+Requires-Dist: markupsafe~=3.0; extra == "templates"
+Requires-Dist: jinja2~=3.1; extra == "templates"
+Provides-Extra: testing
+Requires-Dist: pytest~=8.4; extra == "testing"
+Provides-Extra: plus
+Requires-Dist: anyio~=4.10; extra == "plus"
+Requires-Dist: sniffio~=1.3; extra == "plus"
+Requires-Dist: asttokens~=3.0; extra == "plus"
+Requires-Dist: executing~=2.2; extra == "plus"
+Requires-Dist: orjson~=3.11; extra == "plus"
+Requires-Dist: pyyaml~=6.0; extra == "plus"
+Requires-Dist: wrapt~=1.17; extra == "plus"
+Dynamic: license-file
+
+# Overview
+
+Core utilities and foundational code. It's relatively large but completely self-contained.
+
+# Notable packages
+
+- **[lang](https://github.com/wrmsr/omlish/blob/master/omlish/lang)** - The standard library of this standard library.
+  Usually imported as a whole (`from omlish import lang`), it contains an array of general purpose utilities used
+  practically everywhere. It is kept relatively lightweight: its heaviest import is stdlib dataclasses and its
+  transitives. Some of its contents include:
+
+  - **[cached](https://github.com/wrmsr/omlish/blob/master/omlish/lang/cached)** - The standard `cached_function` /
+    `cached_property` tools, which are more capable than
+    [`functools.lru_cache`](https://docs.python.org/3/library/functools.html#functools.lru_cache).
+  - **[imports](https://github.com/wrmsr/omlish/blob/master/omlish/lang/imports.py)** - Import tools like `proxy_import`
+    for late-loaded imports and `proxy_init` for late-loaded module globals.
+  - **[classes](https://github.com/wrmsr/omlish/blob/master/omlish/lang/classes)** - Class tools and bases, such as
+    `Abstract` (which checks at subclass definition not instantiation), `Sealed` / `PackageSealed`, and `Final`.
+  - **[maybes](https://github.com/wrmsr/omlish/blob/master/omlish/lite/maybes.py)** - A simple, nestable formalization
+    of the presence or absence of an object, as in [many](https://en.cppreference.com/w/cpp/utility/optional)
+    [other](https://docs.oracle.com/javase/8/docs/api/java/util/Optional.html)
+    [languages](https://doc.rust-lang.org/std/option/).
+
+- **[bootstrap](https://github.com/wrmsr/omlish/blob/master/omlish/bootstrap)** - A centralized, configurable,
+  all-in-one collection of various process-initialization minutiae like resource limiting, profiling, remote debugging,
+  log configuration, environment variables, et cetera. Usable as a context manager or via its
+  [cli](https://github.com/wrmsr/omlish/blob/master/omlish/bootstrap/main.py).
+
+- **[collections](https://github.com/wrmsr/omlish/blob/master/omlish/collections)** - A handful of collection utilities
+  and simple implementations, including:
+
+  - **[cache](https://github.com/wrmsr/omlish/blob/master/omlish/collections/cache)** - A configurable LRU / LFU cache
+    with options like ttl and  max size / weight.
+  - **[hasheq](https://github.com/wrmsr/omlish/blob/master/omlish/collections/hasheq.py)** - A dict taking an external
+    `__hash__` / `__eq__` implementation.
+  - **[identity](https://github.com/wrmsr/omlish/blob/master/omlish/collections/identity.py)** - Identity-keyed
+    collections.
+  - **[sorted](https://github.com/wrmsr/omlish/blob/master/omlish/collections/sorted)** - Interfaces for value-sorted
+    collections and key-sorted mappings, and a simple but - correct skiplist-backed implementation.
+  - **[persistent](https://github.com/wrmsr/omlish/blob/master/omlish/collections/persistent)** - Interfaces for
+    [persistent](https://en.wikipedia.org/wiki/Persistent_data_structure) maps, and a simple but correct treap-backed
+    implementation.
+
+- **[dataclasses](https://github.com/wrmsr/omlish/blob/master/omlish/dataclasses)** - A fully-compatible
+  reimplementation of stdlib [dataclasses](https://docs.python.org/3/library/dataclasses.html) with numerous
+  enhancements and additional features. The
+  [full stdlib test suite](https://github.com/wrmsr/omlish/blob/master/omlish/dataclasses/tests/cpython) is run against
+  it ensuring compatibility - they *are* dataclasses. Current enhancements include:
+
+  - Simple field coercion and validation.
+  - Any number of `@dc.init` or `@dc.validate` methods, not just a central `__post_init__`.
+  - Optional generic type parameter substitution in generated `__init__` methods, enabling accurate reflection.
+  - An optional [metaclass](https://github.com/wrmsr/omlish/blob/master/omlish/dataclasses/metaclass) which removes the
+    need for re-decorating subclasses (with support for inheritance of dataclass parameters like `frozen`), and some
+    basic [base classes](https://github.com/wrmsr/omlish/blob/master/omlish/dataclasses/metaclass/bases.py).
+  - (Nearly finished) support for ahead-of-time / build-time code generation, greatly reducing import times.
+
+  The stdlib-equivalent api is exported in such a way as to appear to be direct aliases for the stdlib api itself,
+  simplifying tool support.
+
+- **[dispatch](https://github.com/wrmsr/omlish/blob/master/omlish/dispatch)** - A beefed-up version of
+  [functools.singledispatch](https://docs.python.org/3/library/functools.html#functools.singledispatch), most notably
+  supporting MRO-honoring method impl dispatch.
+
+- **[formats](https://github.com/wrmsr/omlish/blob/master/omlish/formats)** - Tools for various data formats, including:
+
+  - **[json](https://github.com/wrmsr/omlish/blob/master/omlish/formats/json)** - Tools for json, including abstraction
+    over various backends and a self-contained streaming / incremental parser.
+  - **[json5](https://github.com/wrmsr/omlish/blob/master/omlish/formats/json5)** - A self-contained and tested
+    [Json5](https://json5.org/) parser.
+  - **[toml](https://github.com/wrmsr/omlish/blob/master/omlish/formats/toml)** - Toml tools, including a
+    [lite](#lite-code) version of the stdlib parser (for use in older pythons).
+
+- **[http](https://github.com/wrmsr/omlish/blob/master/omlish/http)** - HTTP code, including:
+
+  - **[clients](https://github.com/wrmsr/omlish/blob/master/omlish/http/clients)** - An abstraction over HTTP clients,
+    with urllib and httpx implementations.
+  - **[coro](https://github.com/wrmsr/omlish/blob/master/omlish/http/coro)** - Coroutine /
+    [sans-io](https://sans-io.readthedocs.io/) style reformulation of some stdlib http machinery - namely `http.server`
+    (and soon `http.client`). This style of code can run the same in sync, async, or
+    [any](https://docs.python.org/3/library/selectors.html)
+    [other](https://github.com/wrmsr/omlish/blob/master/omlish/asyncs/bluelet) context.
+
+- **[inject](https://github.com/wrmsr/omlish/blob/master/omlish/inject)** - A
+  [guice](https://github.com/google/guice)-style dependency injector.
+
+- **[io](https://github.com/wrmsr/omlish/blob/master/omlish/io)** - IO tools, including:
+
+  - **[compress](https://github.com/wrmsr/omlish/blob/master/omlish/io/compress)** - Abstraction over various
+    compression schemes, with particular attention to incremental operation. For example it includes
+    [an incremental reformulation of stdlib's gzip](https://github.com/wrmsr/omlish/blob/master/omlish/io/compress/gzip.py).
+  - **[coro](https://github.com/wrmsr/omlish/blob/master/omlish/io/coro)** - Utilities for coroutine / sans-io style
+    code.
+  - **[fdio](https://github.com/wrmsr/omlish/blob/master/omlish/io/fdio)** - An implementation of classic
+    [selector](https://docs.python.org/3/library/selectors.html)-style IO dispatch, akin to the deprecated
+    [asyncore](https://docs.python.org/3.11/library/asyncore.html). While more modern asyncio style code is generally
+    preferred, it nearly always involves
+    [background threads](https://github.com/python/cpython/blob/95d9dea1c4ed1b1de80074b74301cee0b38d5541/Lib/asyncio/unix_events.py#L1349)
+    making it [unsuitable for forking processes](https://rachelbythebay.com/w/2011/06/07/forked/) like
+    [process supervisors](https://github.com/wrmsr/omlish/blob/master/ominfra/supervisor).
+
+- **[jmespath](https://github.com/wrmsr/omlish/blob/master/omlish/specs/jmespath)** - A vendoring of
+  [jmespath community edition](https://github.com/jmespath-community/python-jmespath), modernized and adapted to this
+  codebase.
+
+- **[marshal](https://github.com/wrmsr/omlish/blob/master/omlish/marshal)** - A
+  [jackson](https://github.com/FasterXML/jackson)-style serde system.
+
+- **[manifests](https://github.com/wrmsr/omlish/blob/master/omlish/manifests)** - A system for sharing lightweight
+  metadata within / across codebases.
+
+- **[reflect](https://github.com/wrmsr/omlish/blob/master/omlish/reflect)** - Reflection utilities, including primarily
+  a formalization of stdlib type annotations for use at runtime, decoupled from stdlib impl detail. Keeping this working
+  is notoriously difficult across python versions (one of the primary reasons for only supporting 3.13+).
+
+- **[sql](https://github.com/wrmsr/omlish/blob/master/omlish/sql)** - A collection of SQL utilities, including:
+
+  - **[alchemy](https://github.com/wrmsr/omlish/blob/master/omlish/sql/alchemy)** - SQLAlchemy utilities. The codebase
+    is moving away from SQLAlchemy however in favor of its own internal SQL api.
+  - **[api](https://github.com/wrmsr/omlish/blob/master/omlish/sql/api)** - An abstracted api for SQL interaction, with
+    support for dbapi compatible drivers (and a SQLAlchemy adapter).
+  - **[queries](https://github.com/wrmsr/omlish/blob/master/omlish/sql/queries)** - A SQL query builder with a fluent
+    interface.
+
+- **[testing](https://github.com/wrmsr/omlish/blob/master/omlish/testing)** - Test - primarily pytest - helpers,
+  including:
+
+  - **['harness'](https://github.com/wrmsr/omlish/blob/master/omlish/testing/pytest/inject/harness.py)** - An all-in-one
+    fixture marrying it to the codebase's dependency injector.
+  - **[plugins/async](https://github.com/wrmsr/omlish/blob/master/omlish/testing/pytest/plugins/asyncs)** - An in-house
+    async-backend abstraction plugin, capable of handling all of asyncio / trio / trio-asyncio /
+    *any-future-event-loop-impl* without having multiple fighting plugins (*[I know, I know](https://xkcd.com/927/)*).
+  - **[plugins](https://github.com/wrmsr/omlish/blob/master/omlish/testing/pytest/plugins)** - Various other plugins.
+
+- **[lite](https://github.com/wrmsr/omlish/blob/master/omlish/lite)** - The standard library of 'lite' code. This is the
+  only package beneath `lang`, and parts of it are re-exported by it for deduplication. On top of miscellaneous
+  utilities it contains a handful of independent, self-contained, significantly simplified 'lite' equivalents of some
+  major core packages:
+
+  - **[lite/inject.py](https://github.com/wrmsr/omlish/blob/master/omlish/lite/inject.py)** - The lite injector, which
+    is more conservative with features and reflection than the core injector. The codebase's
+    [MiniGuice](https://github.com/google/guice/commit/70248eafa90cd70a68b293763e53f6aec656e73c).
+  - **[lite/marshal.py](https://github.com/wrmsr/omlish/blob/master/omlish/lite/marshal.py)** - The lite marshalling
+    system, which is a classic canned setup of simple type-specific 2-method classes and limited generic handling.
+
+# Lite code
+
+A subset of this codebase is written in a 'lite' style (non-'lite' code is referred to as *standard* code). While
+standard code is written for python 3.13+, 'lite' code is written for 3.8+, and is written in a style conducive to
+[amalgamation](https://github.com/wrmsr/omlish/blob/master/omdev#amalgamation) in which multiple python source files are
+stitched together into one single self-contained python script.
+
+Code written in this style has notable differences from standard code, including (but not limited to):
+
+- No name mangling is done in amalgamation, which means (among other things) that code must be written expecting to be
+  all dumped into the same giant namespace. Where a standard class might be
+  [`omlish.inject.keys.Key`](https://github.com/wrmsr/omlish/blob/master/omlish/inject/keys.py), a lite equivalent might
+  be [`omlish.lite.inject.InjectorKey`](https://github.com/wrmsr/omlish/blob/master/omlish/lite/inject.py).
+- All internal imports `import` each individual item out of modules rather than importing the modules and referencing
+  their contents. Where standard code would `from .. import x; x.y`, lite code would `from ..x import y; y`. As a result
+  there are frequently 'api' non-instantiated namespace classes serving the purpose of modules - just handy bags of
+  stuff with shortened names.
+- As lite code is tested in 3.8+ but core code requires 3.13+, packages containing lite code can't import anything
+  standard in their (and their ancestors') `__init__.py`'s. Furthermore, `__init__.py` files are omitted outright in
+  amalgamation, so they effectively must be empty in any package containing any lite code. As a result there are
+  frequently [`all.py`](https://github.com/wrmsr/omlish/blob/master/omlish/configs/all.py) files in mixed-lite packages
+  which serve the purpose of `__init__.py` for standard usage - where importing standard packages from standard code
+  would be done via `from .. import lang`, importing mixed-lite packages from standard code would be done via
+  `from ..configs import all as cfgs`.
+
+# Dependencies
+
+This library has no required dependencies of any kind, but there are numerous optional integrations - see
+[`__about__.py`](https://github.com/wrmsr/omlish/blob/master/omlish/__about__.py) for a full list, but some specific
+examples are:
+
+- **anyio** - While lite code must use only asyncio, non-trivial async standard code prefers to be written to anyio.
+- **pytest** - What is used for all standard testing - as lite code has no dependencies of any kind its testing uses
+  stdlib's [unittest](https://docs.python.org/3/library/unittest.html).
+- **asttokens / executing** - For getting runtime source representations of function call arguments, an optional
+  capability of [check](https://github.com/wrmsr/omlish/blob/master/omlish/check.py).
+- **wrapt** - For (optionally-enabled) injector circular proxies.
+- **greenlet** - For some gnarly stuff like the
+  [sync<->async bridge](https://github.com/wrmsr/omlish/blob/master/omlish/asyncs/bridge.py) and the
+  [io trampoline](https://github.com/wrmsr/omlish/blob/master/omlish/io/trampoline.py).
+- **sqlalchemy** - Parts of the codebase use SQLAlchemy for db stuff, but it is being migrated away from in favor of the
+  internal api. It will however likely still remain as an optional dep for the api adapter.
+
+Additionally, some catchall dep categories include:
+
+- **compression** - Various preferred compression backends like lz4, python-snappy, zstandard, and brotli.
+- **formats** - Various preferred data format backends like orjson/ujson, pyyaml, cbor2, and cloudpickle.
+- **sql drivers** - Various preferred and tested sql drivers.

{omlish-0.0.0.dev381.dist-info → omlish-0.0.0.dev383.dist-info}/RECORD

@@ -1,5 +1,5 @@
 omlish/.manifests.json,sha256=aT8yZ-Zh-9wfHl5Ym5ouiWC1i0cy7Q7RlhzavB6VLPI,8587
-omlish/__about__.py,sha256=-DbjDvgqe02JsxIgL09pN_yzW3I3ZTmjXb0au6bPnpc,3479
+omlish/__about__.py,sha256=Yil-QN8yQQLqT5l8X5v9Sl63EhaDi8gETS8Kj8YbX8o,3543
 omlish/__init__.py,sha256=SsyiITTuK0v74XpKV8dqNaCmjOlan1JZKrHQv5rWKPA,253
 omlish/c3.py,sha256=rer-TPOFDU6fYq_AWio_AmA-ckZ8JDY5shIzQ_yXfzA,8414
 omlish/cached.py,sha256=MLap_p0rdGoDIMVhXVHm1tsbcWobJF0OanoodV03Ju8,542
@@ -355,25 +355,26 @@ omlish/http/coro/server/fdio.py,sha256=qZE4g5y4XESsTObSKyVggI-yzig57gSGJb4Z0rcHv
 omlish/http/coro/server/server.py,sha256=5gvueSCUzqBqQRf0GJ6wGroD9DiWxQNi6N17MlEtBLU,18660
 omlish/http/coro/server/simple.py,sha256=j1RZ3niKrgGM2qFnjdYWn_eniZzay5j49Ca4L3u8vO4,3296
 omlish/http/coro/server/sockets.py,sha256=24gU6wpIZuzYWKQD8UsHyYfTZlbcUFvkqXq5KVgWpQo,2261
-omlish/inject/__init__.py,sha256=pY-A8Q4v08-Xa4a-XdZ3lSFC3OwCO2T9HhesB67Q4tQ,1895
-omlish/inject/binder.py,sha256=3-6KMOcSgFE5bvthy3YUrRzCX5w7YSGmdJ3Tv2yXZGw,4022
+omlish/inject/__init__.py,sha256=Ou6_wAovmxOpbdhGKsV8GbYRH0_S_h0XQSBDPeYpP0g,1978
+omlish/inject/binder.py,sha256=woOK7I5fk4K4kDF684Ia003jE_lviGQXacNKAmXqx5M,5114
 omlish/inject/bindings.py,sha256=PlvOnUREjvc6F8nOJdzl1k9SAf80icRB4qWFqDop87M,536
 omlish/inject/eagers.py,sha256=JBY7PcjXt-Rg9scQ1ol9xpcoTLXkXC_Ie9uwTWdzUkA,340
 omlish/inject/elements.py,sha256=y4luEO_-eOlVnLcUDiNGSyMXee4pusl46ZGr0JFhbcY,1405
 omlish/inject/errors.py,sha256=_wkN2tF55gQzmMOMKJC_9jYHBZzaBiCDcyqI9Sf2UZs,626
 omlish/inject/injector.py,sha256=fyvaRoJXo_oibx1_IiGkncP9oXnZSKtDm7-ULNKRXHE,1071
 omlish/inject/inspect.py,sha256=Uq4KMloGWF_YS2mgZbrx-JXhZQnYHHKJSr68i9yoBVc,597
-omlish/inject/keys.py,sha256=bkpaE_hXFZ1pX8xPU_Km4jPJh8rkk07fs5aA_8bpC5M,665
+omlish/inject/keys.py,sha256=7jnI2cw7cvLlzZAfe5SC50O3oPOpOB6iGZGTigyfQvs,682
 omlish/inject/listeners.py,sha256=wyPsAJsl45fZHmrFwsVBxaCiT7r_Riw1I8Eowwg5NHE,592
 omlish/inject/managed.py,sha256=-9aBm1vRPOjNz4kgOmpt8S2T55s727t9RiggFBH8maU,2096
-omlish/inject/multis.py,sha256=JzHTBr9LTy7hRTSax9GOo0Lxw7fk401uRgeHm8Mv4d8,3357
+omlish/inject/multis.py,sha256=Dn63jE8P5ahSKc1IDBdzzx6ByBCgVOth5t4frG9m4UA,3336
 omlish/inject/origins.py,sha256=-qXa18rIIkNwBdTrvASRDjgPYnoY6n6OPC222jJDrXg,551
 omlish/inject/overrides.py,sha256=ybEcq9cDf6kvqu5mqnwi6Evj0MFjKNeE3r0oUlGw5E4,546
 omlish/inject/privates.py,sha256=CyE-hvQ-F_uyCzcwfdiYVtfm9IF1WZvMDOYilFyZmWk,658
 omlish/inject/providers.py,sha256=GDjSEN6iLsc-Tdu_OCPvFHWu4yP0Vn0pAyH_xjw1DPg,783
 omlish/inject/scopes.py,sha256=MqGus6vCogQVRJlZUnoXFwEeHuGMSYv2NF23_OFxWHE,1995
+omlish/inject/tags.py,sha256=gRDLa-WdZc9DC7KwwmoIPAi8g_qdGpRWuMT7HCd7CL0,433
 omlish/inject/types.py,sha256=Z-ZEdgtCpHBNrbxxKaMVvfeD7hYXdL4rC7A9_VGxZ6g,256
-omlish/inject/utils.py,sha256=5Xm6LEelY7QujhMK7oD5vqEtY7Ymg_oG1Y-ZdEGD3bc,592
+omlish/inject/utils.py,sha256=Gc2qq45KgkyqDt03WSvOEZBCiuqQ6ESwplx5ZRBcY5M,413
 omlish/inject/impl/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 omlish/inject/impl/bindings.py,sha256=xSvUcoDz8NH-aNHPwBPEZsFg73K2WcF_A63npVbGt_k,420
 omlish/inject/impl/elements.py,sha256=PM_055moROskSTQqmohEa6I0tt1OQ-VRNArXCMG6vyk,5947
@@ -504,7 +505,7 @@ omlish/logs/timing.py,sha256=qsQ3DB6swts1pxrFlmLWQzhH-3nzDrq1MUu7PxjjUyU,1519
 omlish/logs/utils.py,sha256=OkFWf1exmWImmT7BaSiIC7c0Fk9tAis-PRqo8H4ny3c,398
 omlish/manifests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 omlish/manifests/base.py,sha256=5CmayiuzdXXv9hB5tDnWqfAosAoEQ26YG0B-emkiTXU,941
-omlish/manifests/load.py,sha256=NLpD8eBz078MNjQ9bEafhbpPBPfM_cVQVnkdmtQv7Gk,7666
+omlish/manifests/load.py,sha256=baPBZJRSmFVH9lWlWXAredmJFFYc3X0W2C6Z8a4M05E,7734
 omlish/manifests/static.py,sha256=7YwOVh_Ek9_aTrWsWNO8kWS10_j4K7yv3TpXZSHsvDY,501
 omlish/manifests/types.py,sha256=5hQuY-WZ9VMqHZXr-9Dayg380JsnX2vJzXyw6vC6UDs,317
 omlish/marshal/__init__.py,sha256=QeWqXKb6_Jk8vpX9Z-apWlM3nUbJY3uCPOm0k8Lw8b8,3584
@@ -890,9 +891,9 @@ omlish/typedvalues/marshal.py,sha256=AtBz7Jq-BfW8vwM7HSxSpR85JAXmxK2T0xDblmm1HI0
 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.dev381.dist-info/licenses/LICENSE,sha256=B_hVtavaA8zCYDW99DYdcpDLKz1n3BBRjZrcbv8uG8c,1451
-omlish-0.0.0.dev381.dist-info/METADATA,sha256=1yVdXIDoTT1W06OUpeqhGjLyUOCOT_GEDMOTVjI78jU,4420
-omlish-0.0.0.dev381.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-omlish-0.0.0.dev381.dist-info/entry_points.txt,sha256=Lt84WvRZJskWCAS7xnQGZIeVWksprtUHj0llrvVmod8,35
-omlish-0.0.0.dev381.dist-info/top_level.txt,sha256=pePsKdLu7DvtUiecdYXJ78iO80uDNmBlqe-8hOzOmfs,7
-omlish-0.0.0.dev381.dist-info/RECORD,,
+omlish-0.0.0.dev383.dist-info/licenses/LICENSE,sha256=B_hVtavaA8zCYDW99DYdcpDLKz1n3BBRjZrcbv8uG8c,1451
+omlish-0.0.0.dev383.dist-info/METADATA,sha256=fYxhjZpQl76w3-2r6HEE2Bqwpv02nDe9vtEA664UhRA,18825
+omlish-0.0.0.dev383.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+omlish-0.0.0.dev383.dist-info/entry_points.txt,sha256=Lt84WvRZJskWCAS7xnQGZIeVWksprtUHj0llrvVmod8,35
+omlish-0.0.0.dev383.dist-info/top_level.txt,sha256=pePsKdLu7DvtUiecdYXJ78iO80uDNmBlqe-8hOzOmfs,7
+omlish-0.0.0.dev383.dist-info/RECORD,,

omlish-0.0.0.dev381.dist-info/METADATA

@@ -1,106 +0,0 @@
-Metadata-Version: 2.4
-Name: omlish
-Version: 0.0.0.dev381
-Summary: omlish
-Author: wrmsr
-License: BSD-3-Clause
-Project-URL: source, https://github.com/wrmsr/omlish
-Classifier: License :: OSI Approved :: BSD License
-Classifier: Development Status :: 2 - Pre-Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Operating System :: OS Independent
-Classifier: Operating System :: POSIX
-Requires-Python: >=3.13
-License-File: LICENSE
-Provides-Extra: all
-Requires-Dist: anyio~=4.10; extra == "all"
-Requires-Dist: sniffio~=1.3; extra == "all"
-Requires-Dist: greenlet~=3.2; extra == "all"
-Requires-Dist: trio~=0.30; extra == "all"
-Requires-Dist: trio-asyncio~=0.15; extra == "all"
-Requires-Dist: lz4~=4.4; extra == "all"
-Requires-Dist: python-snappy~=0.7; extra == "all"
-Requires-Dist: zstandard~=0.23; extra == "all"
-Requires-Dist: brotli~=1.1; extra == "all"
-Requires-Dist: asttokens~=3.0; extra == "all"
-Requires-Dist: executing~=2.2; extra == "all"
-Requires-Dist: psutil~=7.0; extra == "all"
-Requires-Dist: orjson~=3.11; extra == "all"
-Requires-Dist: ujson~=5.10; extra == "all"
-Requires-Dist: pyyaml~=6.0; extra == "all"
-Requires-Dist: cbor2~=5.6; extra == "all"
-Requires-Dist: cloudpickle~=3.1; extra == "all"
-Requires-Dist: httpx[http2]~=0.28; extra == "all"
-Requires-Dist: wrapt~=1.17; extra == "all"
-Requires-Dist: cryptography~=45.0; extra == "all"
-Requires-Dist: sqlalchemy[asyncio]~=2.0; extra == "all"
-Requires-Dist: pg8000~=1.31; extra == "all"
-Requires-Dist: pymysql~=1.1; extra == "all"
-Requires-Dist: aiomysql~=0.2; extra == "all"
-Requires-Dist: aiosqlite~=0.21; extra == "all"
-Requires-Dist: asyncpg~=0.30; extra == "all"
-Requires-Dist: apsw~=3.50; extra == "all"
-Requires-Dist: sqlean.py~=3.49; extra == "all"
-Requires-Dist: duckdb~=1.3; extra == "all"
-Requires-Dist: markupsafe~=3.0; extra == "all"
-Requires-Dist: jinja2~=3.1; extra == "all"
-Requires-Dist: pytest~=8.4; extra == "all"
-Requires-Dist: anyio~=4.10; extra == "all"
-Requires-Dist: sniffio~=1.3; extra == "all"
-Requires-Dist: asttokens~=3.0; extra == "all"
-Requires-Dist: executing~=2.2; extra == "all"
-Requires-Dist: orjson~=3.11; extra == "all"
-Requires-Dist: pyyaml~=6.0; extra == "all"
-Requires-Dist: wrapt~=1.17; extra == "all"
-Provides-Extra: async
-Requires-Dist: anyio~=4.10; extra == "async"
-Requires-Dist: sniffio~=1.3; extra == "async"
-Requires-Dist: greenlet~=3.2; extra == "async"
-Requires-Dist: trio~=0.30; extra == "async"
-Requires-Dist: trio-asyncio~=0.15; extra == "async"
-Provides-Extra: compress
-Requires-Dist: lz4~=4.4; extra == "compress"
-Requires-Dist: python-snappy~=0.7; extra == "compress"
-Requires-Dist: zstandard~=0.23; extra == "compress"
-Requires-Dist: brotli~=1.1; extra == "compress"
-Provides-Extra: diag
-Requires-Dist: asttokens~=3.0; extra == "diag"
-Requires-Dist: executing~=2.2; extra == "diag"
-Requires-Dist: psutil~=7.0; extra == "diag"
-Provides-Extra: formats
-Requires-Dist: orjson~=3.11; extra == "formats"
-Requires-Dist: ujson~=5.10; extra == "formats"
-Requires-Dist: pyyaml~=6.0; extra == "formats"
-Requires-Dist: cbor2~=5.6; extra == "formats"
-Requires-Dist: cloudpickle~=3.1; extra == "formats"
-Provides-Extra: http
-Requires-Dist: httpx[http2]~=0.28; extra == "http"
-Provides-Extra: misc
-Requires-Dist: wrapt~=1.17; extra == "misc"
-Provides-Extra: secrets
-Requires-Dist: cryptography~=45.0; extra == "secrets"
-Provides-Extra: sqlalchemy
-Requires-Dist: sqlalchemy[asyncio]~=2.0; extra == "sqlalchemy"
-Provides-Extra: sqldrivers
-Requires-Dist: pg8000~=1.31; extra == "sqldrivers"
-Requires-Dist: pymysql~=1.1; extra == "sqldrivers"
-Requires-Dist: aiomysql~=0.2; extra == "sqldrivers"
-Requires-Dist: aiosqlite~=0.21; extra == "sqldrivers"
-Requires-Dist: asyncpg~=0.30; extra == "sqldrivers"
-Requires-Dist: apsw~=3.50; extra == "sqldrivers"
-Requires-Dist: sqlean.py~=3.49; extra == "sqldrivers"
-Requires-Dist: duckdb~=1.3; extra == "sqldrivers"
-Provides-Extra: templates
-Requires-Dist: markupsafe~=3.0; extra == "templates"
-Requires-Dist: jinja2~=3.1; extra == "templates"
-Provides-Extra: testing
-Requires-Dist: pytest~=8.4; extra == "testing"
-Provides-Extra: plus
-Requires-Dist: anyio~=4.10; extra == "plus"
-Requires-Dist: sniffio~=1.3; extra == "plus"
-Requires-Dist: asttokens~=3.0; extra == "plus"
-Requires-Dist: executing~=2.2; extra == "plus"
-Requires-Dist: orjson~=3.11; extra == "plus"
-Requires-Dist: pyyaml~=6.0; extra == "plus"
-Requires-Dist: wrapt~=1.17; extra == "plus"
-Dynamic: license-file