omcore-mypyc 0.0.42__tar.gz

omcore_mypyc-0.0.42/LICENSE

@@ -0,0 +1,21 @@
+Copyright 2023- wrmsr
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
+following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following
+disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
+disclaimer in the documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products
+derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

omcore_mypyc-0.0.42/MANIFEST.in

@@ -0,0 +1,7 @@
+recursive-include omcore/lang *.py
+recursive-include omcore/lite *.py
+recursive-include omcore/reflect/core *.py
+include omcore/*.py
+include omcore/reflect/*.py
+recursive-exclude **/tests *.py
+global-exclude **/conftest.py

omcore_mypyc-0.0.42/PKG-INFO

@@ -0,0 +1,209 @@
+Metadata-Version: 2.4
+Name: omcore-mypyc
+Version: 0.0.42
+Summary: omcore
+Author: wrmsr
+License-Expression: BSD-3-Clause
+Project-URL: source, https://github.com/wrmsr/om
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: omcore==0.0.42
+Requires-Dist: librt
+Dynamic: license-file
+
+# Overview
+
+Core utilities and foundational code. It's relatively large but completely self-contained, and has **no required
+dependencies of any kind**.
+
+# Notable packages
+
+- **[lang](https://github.com/wrmsr/om/blob/master/omcore/lang)** - The standard library of this standard library.
+  Usually imported as a whole (`from omcore 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/om/blob/master/omcore/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/om/blob/master/omcore/lang/imports.py)** - Import tools like:
+    - `proxy_import` - For late-loaded imports.
+    - `proxy_init` - For late-loaded module globals.
+    - `auto_proxy_init` - For automatic late-loaded package exports.
+  - **[classes](https://github.com/wrmsr/om/blob/master/omcore/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/om/blob/master/omcore/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/om/blob/master/omcore/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/om/blob/master/omcore/bootstrap/main.py).
+
+- **[collections](https://github.com/wrmsr/om/blob/master/omcore/collections)** - A handful of collection utilities and
+  simple implementations, including:
+
+  - **[cache](https://github.com/wrmsr/om/blob/master/omcore/collections/cache)** - A configurable LRU / LFU cache with
+    options like ttl and  max size / weight.
+  - **[hasheq](https://github.com/wrmsr/om/blob/master/omcore/collections/hasheq.py)** - A dict taking an external
+    `__hash__` / `__eq__` implementation.
+  - **[identity](https://github.com/wrmsr/om/blob/master/omcore/collections/identity.py)** - Identity-keyed collections.
+  - **[sorted](https://github.com/wrmsr/om/blob/master/omcore/collections/sorted)** - Interfaces for value-sorted
+    collections and key-sorted mappings, and a simple but correct skiplist-backed implementation.
+  - **[persistent](https://github.com/wrmsr/om/blob/master/omcore/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/om/blob/master/omcore/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/om/blob/master/omcore/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/om/blob/master/omcore/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/om/blob/master/omcore/dataclasses/metaclass/bases.py).
+  - Support for ahead-of-time / build-time code generation, significantly 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/om/blob/master/omcore/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/om/blob/master/omcore/formats)** - Tools for various data formats, including:
+
+  - **[json](https://github.com/wrmsr/om/blob/master/omcore/formats/json)** - Tools for json, including abstraction over
+    various backends and a self-contained streaming / incremental parser.
+  - **[json5](https://github.com/wrmsr/om/blob/master/omcore/formats/json5)** - A self-contained and tested
+    [Json5](https://json5.org/) parser.
+  - **[toml](https://github.com/wrmsr/om/blob/master/omcore/formats/toml)** - Toml tools, including a [lite](#lite-code)
+    version of the stdlib parser (for use in older pythons).
+  - **[goyaml](https://github.com/wrmsr/om/blob/master/omcore/formats/yaml/goyaml)** - A **manual**, near-direct,
+    'lite'-compatible translation of [go-yaml](https://github.com/goccy/go-yaml/).
+
+  https://github.com/goccy/go-yaml/tree/8dd51ebb7f36f616b85f7b0e54539afa4341f22a
+
+- **[http](https://github.com/wrmsr/om/blob/master/omcore/http)** - HTTP code, including:
+
+  - **[clients](https://github.com/wrmsr/om/blob/master/omcore/http/clients)** - An abstraction over HTTP clients, with
+    urllib and httpx implementations.
+
+- **[inject](https://github.com/wrmsr/om/blob/master/omcore/inject)** - A [guice](https://github.com/google/guice)-style
+  dependency injector.
+
+- **[io](https://github.com/wrmsr/om/blob/master/omcore/io)** - IO tools, including:
+
+  - **[compress](https://github.com/wrmsr/om/blob/master/omcore/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/om/blob/master/omcore/io/compress/gzip.py).
+  - **[fdio](https://github.com/wrmsr/om/blob/master/omcore/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/uni
+    x_events.py#L1349) making it [unsuitable for forking processes](https://rachelbythebay.com/w/2011/06/07/forked/).
+
+- **[jmespath](https://github.com/wrmsr/om/blob/master/omcore/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/om/blob/master/omcore/marshal)** - A
+  [jackson](https://github.com/FasterXML/jackson)-style serde system.
+
+- **[manifests](https://github.com/wrmsr/om/blob/master/omcore/manifests)** - A system for sharing lightweight metadata
+  within / across codebases.
+
+- **[reflect](https://github.com/wrmsr/om/blob/master/omcore/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.14+).
+
+- **[sql](https://github.com/wrmsr/om/blob/master/omcore/sql)** - A collection of SQL utilities, including:
+
+  - **[api](https://github.com/wrmsr/om/blob/master/omcore/sql/api)** - An abstracted api for SQL interaction, with
+    support for dbapi compatible drivers (and a SQLAlchemy adapter).
+  - **[queries](https://github.com/wrmsr/om/blob/master/omcore/sql/queries)** - A SQL query builder with a fluent
+    interface.
+  - **[alchemy](https://github.com/wrmsr/om/blob/master/omcore/sql/alchemy)** - SQLAlchemy utilities. The codebase has
+    moved away from SQLAlchemy in favor of its own internal SQL api, but it will likely still remain as an optional dep
+    for the api adapter.
+
+- **[testing](https://github.com/wrmsr/om/blob/master/omcore/testing)** - Test - primarily pytest - helpers, including:
+
+  - **['harness'](https://github.com/wrmsr/om/blob/master/omcore/testing/pytest/inject/harness.py)** - An all-in-one
+    fixture marrying it to the codebase's dependency injector.
+  - **[plugins/async](https://github.com/wrmsr/om/blob/master/omcore/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/om/blob/master/omcore/testing/pytest/plugins)** - Various other plugins.
+
+- **[typedvalues](https://github.com/wrmsr/om/blob/master/omcore/typedvalues)** - A little toolkit around 'boxed'
+  values, whose 'box' types convey more information than the bare values themselves. A rebellion against kwargs / env
+  vars / giant config objects: instead of `foo(bar=1, baz=2)`, you do `foo(Bar(1), Baz(2))`.
+
+- **[lite](https://github.com/wrmsr/om/blob/master/omcore/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/om/blob/master/omcore/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/om/blob/master/omcore/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.14+, 'lite' code is written for 3.8+, and is written in a style conducive to
+[amalgamation](https://github.com/wrmsr/om/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
+  [`omcore.inject.keys.Key`](https://github.com/wrmsr/om/blob/master/omcore/inject/keys.py), a lite equivalent might be
+  [`omcore.lite.inject.InjectorKey`](https://github.com/wrmsr/om/blob/master/omcore/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.14+, 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/om/blob/master/omcore/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 some optional integrations - see
+[`__about__.py`](https://github.com/wrmsr/om/blob/master/omcore/__about__.py) for a full list, but some specific
+examples are:
+
+- **asttokens / executing** - For getting runtime source representations of function call arguments, an optional
+  capability of [check](https://github.com/wrmsr/om/blob/master/omcore/check.py).
+- **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).
+- **anyio** - While lite code must use only asyncio, some async standard code sometimes is written to anyio.
+- **sqlalchemy** - The codebase has migrated away from SQLAlchemy in favor of the internal api but it retains it as an
+  optional dep to support adapting the internal api to it.
+
+Additionally, some catchall dep categories include:
+
+- **compression** - Various preferred compression backends like lz4, python-snappy, and brotli.
+- **formats** - Various preferred data format backends like orjson/ujson, pyyaml, cbor2, and cloudpickle.
+- **sql drivers** - Various preferred and tested sql drivers.

omcore_mypyc-0.0.42/README.md

@@ -0,0 +1,189 @@
+# Overview
+
+Core utilities and foundational code. It's relatively large but completely self-contained, and has **no required
+dependencies of any kind**.
+
+# Notable packages
+
+- **[lang](https://github.com/wrmsr/om/blob/master/omcore/lang)** - The standard library of this standard library.
+  Usually imported as a whole (`from omcore 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/om/blob/master/omcore/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/om/blob/master/omcore/lang/imports.py)** - Import tools like:
+    - `proxy_import` - For late-loaded imports.
+    - `proxy_init` - For late-loaded module globals.
+    - `auto_proxy_init` - For automatic late-loaded package exports.
+  - **[classes](https://github.com/wrmsr/om/blob/master/omcore/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/om/blob/master/omcore/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/om/blob/master/omcore/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/om/blob/master/omcore/bootstrap/main.py).
+
+- **[collections](https://github.com/wrmsr/om/blob/master/omcore/collections)** - A handful of collection utilities and
+  simple implementations, including:
+
+  - **[cache](https://github.com/wrmsr/om/blob/master/omcore/collections/cache)** - A configurable LRU / LFU cache with
+    options like ttl and  max size / weight.
+  - **[hasheq](https://github.com/wrmsr/om/blob/master/omcore/collections/hasheq.py)** - A dict taking an external
+    `__hash__` / `__eq__` implementation.
+  - **[identity](https://github.com/wrmsr/om/blob/master/omcore/collections/identity.py)** - Identity-keyed collections.
+  - **[sorted](https://github.com/wrmsr/om/blob/master/omcore/collections/sorted)** - Interfaces for value-sorted
+    collections and key-sorted mappings, and a simple but correct skiplist-backed implementation.
+  - **[persistent](https://github.com/wrmsr/om/blob/master/omcore/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/om/blob/master/omcore/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/om/blob/master/omcore/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/om/blob/master/omcore/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/om/blob/master/omcore/dataclasses/metaclass/bases.py).
+  - Support for ahead-of-time / build-time code generation, significantly 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/om/blob/master/omcore/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/om/blob/master/omcore/formats)** - Tools for various data formats, including:
+
+  - **[json](https://github.com/wrmsr/om/blob/master/omcore/formats/json)** - Tools for json, including abstraction over
+    various backends and a self-contained streaming / incremental parser.
+  - **[json5](https://github.com/wrmsr/om/blob/master/omcore/formats/json5)** - A self-contained and tested
+    [Json5](https://json5.org/) parser.
+  - **[toml](https://github.com/wrmsr/om/blob/master/omcore/formats/toml)** - Toml tools, including a [lite](#lite-code)
+    version of the stdlib parser (for use in older pythons).
+  - **[goyaml](https://github.com/wrmsr/om/blob/master/omcore/formats/yaml/goyaml)** - A **manual**, near-direct,
+    'lite'-compatible translation of [go-yaml](https://github.com/goccy/go-yaml/).
+
+  https://github.com/goccy/go-yaml/tree/8dd51ebb7f36f616b85f7b0e54539afa4341f22a
+
+- **[http](https://github.com/wrmsr/om/blob/master/omcore/http)** - HTTP code, including:
+
+  - **[clients](https://github.com/wrmsr/om/blob/master/omcore/http/clients)** - An abstraction over HTTP clients, with
+    urllib and httpx implementations.
+
+- **[inject](https://github.com/wrmsr/om/blob/master/omcore/inject)** - A [guice](https://github.com/google/guice)-style
+  dependency injector.
+
+- **[io](https://github.com/wrmsr/om/blob/master/omcore/io)** - IO tools, including:
+
+  - **[compress](https://github.com/wrmsr/om/blob/master/omcore/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/om/blob/master/omcore/io/compress/gzip.py).
+  - **[fdio](https://github.com/wrmsr/om/blob/master/omcore/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/uni
+    x_events.py#L1349) making it [unsuitable for forking processes](https://rachelbythebay.com/w/2011/06/07/forked/).
+
+- **[jmespath](https://github.com/wrmsr/om/blob/master/omcore/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/om/blob/master/omcore/marshal)** - A
+  [jackson](https://github.com/FasterXML/jackson)-style serde system.
+
+- **[manifests](https://github.com/wrmsr/om/blob/master/omcore/manifests)** - A system for sharing lightweight metadata
+  within / across codebases.
+
+- **[reflect](https://github.com/wrmsr/om/blob/master/omcore/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.14+).
+
+- **[sql](https://github.com/wrmsr/om/blob/master/omcore/sql)** - A collection of SQL utilities, including:
+
+  - **[api](https://github.com/wrmsr/om/blob/master/omcore/sql/api)** - An abstracted api for SQL interaction, with
+    support for dbapi compatible drivers (and a SQLAlchemy adapter).
+  - **[queries](https://github.com/wrmsr/om/blob/master/omcore/sql/queries)** - A SQL query builder with a fluent
+    interface.
+  - **[alchemy](https://github.com/wrmsr/om/blob/master/omcore/sql/alchemy)** - SQLAlchemy utilities. The codebase has
+    moved away from SQLAlchemy in favor of its own internal SQL api, but it will likely still remain as an optional dep
+    for the api adapter.
+
+- **[testing](https://github.com/wrmsr/om/blob/master/omcore/testing)** - Test - primarily pytest - helpers, including:
+
+  - **['harness'](https://github.com/wrmsr/om/blob/master/omcore/testing/pytest/inject/harness.py)** - An all-in-one
+    fixture marrying it to the codebase's dependency injector.
+  - **[plugins/async](https://github.com/wrmsr/om/blob/master/omcore/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/om/blob/master/omcore/testing/pytest/plugins)** - Various other plugins.
+
+- **[typedvalues](https://github.com/wrmsr/om/blob/master/omcore/typedvalues)** - A little toolkit around 'boxed'
+  values, whose 'box' types convey more information than the bare values themselves. A rebellion against kwargs / env
+  vars / giant config objects: instead of `foo(bar=1, baz=2)`, you do `foo(Bar(1), Baz(2))`.
+
+- **[lite](https://github.com/wrmsr/om/blob/master/omcore/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/om/blob/master/omcore/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/om/blob/master/omcore/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.14+, 'lite' code is written for 3.8+, and is written in a style conducive to
+[amalgamation](https://github.com/wrmsr/om/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
+  [`omcore.inject.keys.Key`](https://github.com/wrmsr/om/blob/master/omcore/inject/keys.py), a lite equivalent might be
+  [`omcore.lite.inject.InjectorKey`](https://github.com/wrmsr/om/blob/master/omcore/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.14+, 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/om/blob/master/omcore/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 some optional integrations - see
+[`__about__.py`](https://github.com/wrmsr/om/blob/master/omcore/__about__.py) for a full list, but some specific
+examples are:
+
+- **asttokens / executing** - For getting runtime source representations of function call arguments, an optional
+  capability of [check](https://github.com/wrmsr/om/blob/master/omcore/check.py).
+- **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).
+- **anyio** - While lite code must use only asyncio, some async standard code sometimes is written to anyio.
+- **sqlalchemy** - The codebase has migrated away from SQLAlchemy in favor of the internal api but it retains it as an
+  optional dep to support adapting the internal api to it.
+
+Additionally, some catchall dep categories include:
+
+- **compression** - Various preferred compression backends like lz4, python-snappy, and brotli.
+- **formats** - Various preferred data format backends like orjson/ujson, pyyaml, cbor2, and cloudpickle.
+- **sql drivers** - Various preferred and tested sql drivers.

omcore_mypyc-0.0.42/omcore/__about__.py

@@ -0,0 +1,202 @@
+__version__ = '0.0.42'
+__revision__ = '57873a26b65d0e7b2ba3934bc9897a84b4b137f8'
+
+
+#
+
+
+class ProjectBase:
+    name: str | None = None
+    authors = [{'name': 'wrmsr'}]
+    urls = {'source': 'https://github.com/wrmsr/om'}
+    license = 'BSD-3-Clause'
+    readme = 'README.md'
+    requires_python = '>=3.14'
+
+    version = __version__
+
+    classifiers = [
+        'Intended Audience :: Developers',
+
+        'Operating System :: OS Independent',
+        'Operating System :: POSIX',
+
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.14',
+        'Programming Language :: Python :: 3.15',
+    ]
+
+
+class Project(ProjectBase):
+    name = 'omcore'
+    description = 'omcore'
+
+    #
+
+    optional_dependencies = {
+        'async': [
+            'anyio ~= 4.14',
+            'sniffio ~= 1.3',
+
+            'trio ~= 0.33',
+            'trio-asyncio ~= 0.15',
+        ],
+
+        'compress': [
+            'lz4 ~= 4.4',
+
+            'python-snappy ~= 0.7',
+
+            'brotli ~= 1.2',
+        ],
+
+        'diag': [
+            'asttokens ~= 3.0',
+            'executing ~= 2.2',
+
+            'psutil ~= 7.2',
+
+            'memray ~= 1.20',
+        ],
+
+        'formats': [
+            'orjson ~= 3.11',
+            'ujson ~= 5.13',
+
+            'pyyaml ~= 6.0',
+
+            'cbor2 ~= 6.1',
+
+            'cloudpickle ~= 3.1',
+        ],
+
+        'http': [
+            'httpx[http2] ~= 0.28',
+        ],
+
+        'mypy': [
+            'mypy ~= 2.3',
+        ],
+
+        'secrets': [
+            'cryptography ~= 50.0',
+        ],
+
+        'sqlalchemy': [
+            'sqlalchemy[asyncio] ~= 2.0',
+        ],
+
+        'sqldrivers': [
+            'pg8000 ~= 1.31',
+            'psycopg2 ~= 2.9',
+            'psycopg ~= 3.3',
+
+            'pymysql ~= 1.2',
+            'mysql-connector-python ~= 26.7',
+            'mysqlclient ~= 2.2',
+
+            'snowflake-connector-python ~= 4.7',
+
+            'aiomysql ~= 0.3',
+            'aiosqlite ~= 0.22',
+            'asyncpg ~= 0.31',
+
+            'apsw ~= 3.53',
+
+            'sqlean.py ~= 3.50',
+
+            'duckdb ~= 1.5',
+        ],
+
+        'templates': [
+            'markupsafe ~= 3.0',
+
+            'jinja2 ~= 3.1',
+        ],
+
+        'testing': [
+            'pytest ~= 9.1',
+        ],
+    }
+
+    #
+
+    _plus_dependencies = [
+        'asttokens',
+        'executing',
+
+        'orjson',
+        'pyyaml',
+    ]
+
+    _dependency_specs_by_name = (lambda od: {  # noqa
+        s.split()[0]: s
+        for l in od.values() for s in l
+    })(optional_dependencies)
+
+    optional_dependencies['plus'] = (lambda ds, pd: [  # noqa
+        ds[n] for n in pd
+    ])(_dependency_specs_by_name, _plus_dependencies)
+
+    #
+
+    entry_points = {
+        'omcore.manifests': {name: name},
+    }
+
+
+#
+
+
+class SetuptoolsBase:
+    cext = False
+    mypyc = False
+    rs = False
+
+    manifest_in = [
+        'global-exclude **/conftest.py',
+    ]
+
+    find_packages = {
+        'exclude': [
+            '*.tests',
+            '*.tests.*',
+        ],
+    }
+
+    package_data = {
+        '*': [
+            '*.c',
+            '*.cc',
+            '*.cu',
+            '*.h',
+            '*.hh',
+
+            '*.abnf',
+            '*.g4',
+
+            '.om-manifests.json',
+
+            'py.typed',
+
+            '*.md',
+
+            'README',
+            'README.rst',
+
+            'LICENSE',
+            'LICENSE.txt',
+
+            'AUTHORS',
+        ],
+    }
+
+
+class Setuptools(SetuptoolsBase):
+    cext = True
+    mypyc = True
+
+    find_packages = {
+        'include': [Project.name, f'{Project.name}.*'],
+        'exclude': [*SetuptoolsBase.find_packages['exclude']],
+    }

omcore_mypyc-0.0.42/omcore/__init__.py

@@ -0,0 +1,3 @@
+# While the library as a whole only supports modern python, the 'lite' package is importable and usable down to python
+# 3.8. As a result this file needs to be kept basically empty as anything it would otherwise do would likely involve
+# non-lite code.