omlish 0.0.0.dev301__tar.gz → 0.0.0.dev302__tar.gz

{omlish-0.0.0.dev301/omlish.egg-info → omlish-0.0.0.dev302}/PKG-INFO

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

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302}/README.md

@@ -28,7 +28,7 @@ Core utilities and foundational code. It's relatively large but completely self-
   - **[cache](collections/cache)** - A configurable LRU / LFU cache with options like ttl and  max size / weight.
   - **[hasheq](collections/hasheq.py)** - A dict taking an external `__hash__` / `__eq__` implementation.
   - **[identity](collections/identity.py)** - Identity-keyed collections.
-  - **[sorted](collections/sorted)** - interfaces for value-sorted collections and mappings, and a simple but correct
+  - **[sorted](collections/sorted)** - Interfaces for value-sorted collections and mappings, and a simple but correct
     skiplist-backed implementation.
   - **[persistent](collections/persistent)** - Interfaces for [persistent](https://en.wikipedia.org/wiki/Persistent_data_structure)
     maps, and a simple but correct treap-backed implementation.
@@ -44,7 +44,7 @@ Core utilities and foundational code. It's relatively large but completely self-
     inheritance of dataclass parameters like `frozen`), and some basic [base classes](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 be direct aliases for the stdlib API itself, simplifying
+  The stdlib-equivalent api is exported in such a way as to be direct aliases for the stdlib api itself, simplifying
   tool support.
 
 - **[dispatch](dispatch)** - A beefed-up version of [functools.singledispatch](https://docs.python.org/3/library/functools.html#functools.singledispatch),
@@ -70,7 +70,7 @@ Core utilities and foundational code. It's relatively large but completely self-
 - **[io](io)** - IO tools, including:
 
   - **[compress](io/compress)** - Abstraction over various compression schemes, with particular attention to incremental
-    operation. For example it includes an incremental reformulation of stdlib's [gzip](io/compress/gzip.py).
+    operation. For example it includes [an incremental reformulation of stdlib's gzip](io/compress/gzip.py).
   - **[coro](io/coro)** - Utilities for coroutine / sans-io style code.
   - **[fdio](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
@@ -94,7 +94,7 @@ Core utilities and foundational code. It's relatively large but completely self-
 
   - **[alchemy](sql/alchemy)** - SQLAlchemy utilities. The codebase is moving away from SQLAlchemy however in favor of
     its own internal SQL api.
-  - **[api](sql/api)** - An abstracted API for SQL interaction, with support for dbapi compatible drivers (and a 
+  - **[api](sql/api)** - An abstracted api for SQL interaction, with support for dbapi compatible drivers (and a 
     SQLAlchemy adapter).
   - **[queries](sql/queries)** - A SQL query builder with a fluent interface.
 
@@ -107,30 +107,31 @@ Core utilities and foundational code. It's relatively large but completely self-
     (*[I know, I know](https://xkcd.com/927/)*).
   - **[plugins](testing/pytest/plugins)** - Various other plugins.
 
-- **[lite](lite)** - The standard library of 'lite' code, this is the only package beneath `lang`, and parts of it are
+- **[lite](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](lite/inject.py)** - The lite injector, which is more conservative with features and reflection
-    than the core injector.
+    than the core injector. The codebase's
+    [MiniGuice](https://github.com/google/guice/commit/70248eafa90cd70a68b293763e53f6aec656e73c).
   - **[lite/marshal.py](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 - while most of the code is written for python 3.12+, 'lite' code
+A subset of this codebase is written in a 'lite' style. While most of the code is written for python 3.12+, 'lite' code
 is written for 3.8+, and is written in a style conducive to
-[amalgamation](https://github.com/wrmsr/omlish/tree/master/omdev#amalgamation), in which multiple python source files are
+[amalgamation](https://github.com/wrmsr/omlish/tree/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 this process, which means (among other things) that code must be written expecting to be
+- 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 non-lite class might be [`omlish.inject.keys.Key`](inject/keys.py),
   a lite equivalent might be [`omlish.lite.inject.InjectorKey`](lite/inject.py).
-- All internal imports import each individual item out of modules rather than importing the modules and referencing
-  their contents. Where non-lite code would `from .. import x; x.y`, lite code would `from ..x import y`. As a result
-  there are frequently 'API' non-instantiated namespace classes serving the purpose of modules - just handy bags of
+- All internal imports `import` each individual item out of modules rather than importing the modules and referencing
+  their contents. Where non-lite 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.12+, packages containing lite code can't import anything
   non-lite in their (and their ancestors') `__init__.py`'s. Furthermore, `__init__.py` files are omitted outright in
@@ -141,7 +142,7 @@ Code written in this style has notable differences from standard code, including
 
 # Dependencies
 
-This package has no required dependencies of any kind, but there are numerous optional integrations - see
+This library has no required dependencies of any kind, but there are numerous optional integrations - see
 [`__about__.py`](__about__.py) for a full list, but some specific examples are:
 
 - **anyio** - While lite code must use only asyncio, non-trivial async non-lite code prefers to be written to anyio.

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302}/omlish/__about__.py

@@ -1,5 +1,5 @@
-__version__ = '0.0.0.dev301'
-__revision__ = '1567cf674d01bddcf7c1ad426e2677fe25730bd0'
+__version__ = '0.0.0.dev302'
+__revision__ = '0b4f820252a0f7a3e020da512ead1e112d150cd2'
 
 
 #

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302}/omlish/asyncs/anyio/streams.py

@@ -54,8 +54,8 @@ def staple_memory_object_stream(
 ) -> MemoryStapledObjectStream[T]:
     send, receive = args
     return MemoryStapledObjectStream(
-        check.isinstance(send, MemoryObjectSendStream),  # type: ignore
-        check.isinstance(receive, MemoryObjectReceiveStream),  # type: ignore
+        check.isinstance(send, MemoryObjectSendStream),
+        check.isinstance(receive, MemoryObjectReceiveStream),
     )
 
 
@@ -64,6 +64,6 @@ def staple_memory_object_stream(
 def staple_memory_object_stream2[T](max_buffer_size: float = 0) -> MemoryStapledObjectStream[T]:
     send, receive = anyio.create_memory_object_stream[T](max_buffer_size)
     return MemoryStapledObjectStream(
-        check.isinstance(send, MemoryObjectSendStream),  # type: ignore
-        check.isinstance(receive, MemoryObjectReceiveStream),  # type: ignore
+        check.isinstance(send, MemoryObjectSendStream),
+        check.isinstance(receive, MemoryObjectReceiveStream),
     )

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302}/omlish/asyncs/bridge.py

@@ -1,10 +1,21 @@
 """
-https://github.com/kubernetes/kubernetes/blob/60c4c2b2521fb454ce69dee737e3eb91a25e0535/pkg/controller/volume/persistentvolume/pv_controller.go#L60-L63
+A system for bridging sync and async code. Supports nesting / reentrancy. Robust, but not the most efficient
+implementation - its primary usecase are heavy and init-time ops like lock management and connection establishment, not
+so much for packet-level ops.
 
-==================================================================
-PLEASE DO NOT ATTEMPT TO SIMPLIFY THIS CODE.
-KEEP THE SPACE SHUTTLE FLYING.
-==================================================================
+==
+
+The code is written in a very dumb, simple, explicit style to keep the bookkeeping center-stage and front-of-mind. To
+quote kubernetes:
+
+  https://github.com/kubernetes/kubernetes/blob/60c4c2b2521fb454ce69dee737e3eb91a25e0535/pkg/controller/volume/persistentvolume/pv_controller.go#L60-L63
+
+  ==================================================================
+  PLEASE DO NOT ATTEMPT TO SIMPLIFY THIS CODE.
+  KEEP THE SPACE SHUTTLE FLYING.
+  ==================================================================
+
+==
 
 TODO:
  - reuse greenlet if nested somehow?

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302}/omlish/io/fdio/handlers.py

@@ -7,6 +7,9 @@ from ...lite.check import check
 from ...sockets.addresses import SocketAddress
 
 
+##
+
+
 class FdioHandler(abc.ABC):
     @abc.abstractmethod
     def fd(self) -> int:

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302}/omlish/io/fdio/kqueue.py

@@ -7,6 +7,9 @@ import typing as ta
 from .pollers import FdioPoller
 
 
+##
+
+
 KqueueFdioPoller: ta.Optional[ta.Type[FdioPoller]]
 if sys.platform == 'darwin' or sys.platform.startswith('freebsd'):
 

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302}/omlish/io/fdio/manager.py

@@ -5,6 +5,9 @@ from .handlers import FdioHandler
 from .pollers import FdioPoller
 
 
+##
+
+
 class FdioManager:
     def __init__(
             self,

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302}/omlish/io/trampoline.py

@@ -24,8 +24,8 @@ T = ta.TypeVar('T')
 
 BytesLike: ta.TypeAlias = ta.Any
 
-BufferedReader = io.BufferedReader
-# BufferedReader = pyio.BufferedReader
+BufferedReader: ta.TypeAlias = io.BufferedReader
+# BufferedReader: ta.TypeAlias = pyio.BufferedReader
 
 
 ##

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302}/omlish/lang/collections.py

@@ -18,7 +18,9 @@ def yield_dict_init(*args: ta.Any, **kwargs: ta.Any) -> ta.Iterable[tuple[ta.Any
 
         # Prefer .items() as it's potentially faster.
         if isinstance(src, collections.abc.Mapping):
-            yield from src.items()
+            # Not yield-from, explicitly enforce 2ple-ness
+            for k, v in src.items():
+                yield (k, v)
 
         # Support keys() duck-typed dict init behavior:
         #  https://docs.python.org/3/library/stdtypes.html#dict

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302}/omlish/lang/imports.py

@@ -1,6 +1,7 @@
 """
 TODO:
  - proxy_init 'as' alias support - attrs of (src, dst)
+ - use importlib.util.resolve_name
 """
 import contextlib
 import functools
@@ -189,6 +190,7 @@ def try_import(spec: str) -> types.ModuleType | None:
 
 
 def resolve_import_name(name: str, package: str | None = None) -> str:
+    # FIXME: importlib.util.resolve_name
     level = 0
 
     if name.startswith('.'):

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302}/omlish/lite/check.py

@@ -143,7 +143,15 @@ class Checks:
             spec = (object,)
         return spec
 
-    def isinstance(self, v: ta.Any, spec: ta.Union[ta.Type[T], tuple], msg: CheckMessage = None) -> T:  # noqa
+    @ta.overload
+    def isinstance(self, v: ta.Any, spec: ta.Type[T], msg: CheckMessage = None) -> T:
+        ...
+
+    @ta.overload
+    def isinstance(self, v: ta.Any, spec: ta.Any, msg: CheckMessage = None) -> ta.Any:
+        ...
+
+    def isinstance(self, v, spec, msg=None):
         if not isinstance(v, self._unpack_isinstance_spec(spec)):
             self._raise(
                 TypeError,
@@ -155,7 +163,15 @@ class Checks:
 
         return v
 
-    def of_isinstance(self, spec: ta.Union[ta.Type[T], tuple], msg: CheckMessage = None) -> ta.Callable[[ta.Any], T]:
+    @ta.overload
+    def of_isinstance(self, spec: ta.Type[T], msg: CheckMessage = None) -> ta.Callable[[ta.Any], T]:
+        ...
+
+    @ta.overload
+    def of_isinstance(self, spec: ta.Any, msg: CheckMessage = None) -> ta.Callable[[ta.Any], ta.Any]:
+        ...
+
+    def of_isinstance(self, spec, msg=None):
         def inner(v):
             return self.isinstance(v, self._unpack_isinstance_spec(spec), msg)
 

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302}/omlish/subprocesses/editor.py

@@ -1,5 +1,9 @@
 # ruff: noqa: UP006 UP007
 # @omlish-lite
+"""
+TODO:
+  - git var GIT_EDITOR ?
+"""
 import dataclasses as dc
 import os
 import tempfile
@@ -16,6 +20,18 @@ from .run import SubprocessRunOutput
 ##
 
 
+DEFAULT_USER_TEXT_EDITOR = 'vi'
+
+
+def get_user_text_editor(default: ta.Optional[str] = None) -> str:
+    if default is None:
+        default = DEFAULT_USER_TEXT_EDITOR
+    return os.environ.get('EDITOR', default)
+
+
+##
+
+
 class EditTextWithUserEditor(SubprocessRunnable, ExitStacked):
     def __init__(self, initial_text: str = '') -> None:
         super().__init__()
@@ -46,11 +62,10 @@ class EditTextWithUserEditor(SubprocessRunnable, ExitStacked):
 
     def make_run(self) -> SubprocessRun:
         tf = self._temp_file()
-
-        editor = os.environ.get('EDITOR', 'vi')
+        ed = get_user_text_editor()
 
         return SubprocessRun.of(
-            editor,
+            ed,
             tf.path,
         )
 

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302/omlish.egg-info}/PKG-INFO

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

{omlish-0.0.0.dev301 → omlish-0.0.0.dev302}/pyproject.toml

@@ -12,7 +12,7 @@ authors = [
 urls = {source = 'https://github.com/wrmsr/omlish'}
 license = {text = 'BSD-3-Clause'}
 requires-python = '>=3.12'
-version = '0.0.0.dev301'
+version = '0.0.0.dev302'
 classifiers = [
     'License :: OSI Approved :: BSD License',
     'Development Status :: 2 - Pre-Alpha',