omdev 0.0.0.dev537__tar.gz → 0.0.0.dev538__tar.gz

{omdev-0.0.0.dev537/omdev.egg-info → omdev-0.0.0.dev538}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: omdev
-Version: 0.0.0.dev537
+Version: 0.0.0.dev538
 Summary: omdev
 Author: wrmsr
 License-Expression: BSD-3-Clause
@@ -14,7 +14,7 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: omlish==0.0.0.dev537
+Requires-Dist: omlish==0.0.0.dev538
 Provides-Extra: all
 Requires-Dist: black~=26.3; extra == "all"
 Requires-Dist: pycparser~=3.0; extra == "all"

{omdev-0.0.0.dev537 → omdev-0.0.0.dev538}/omdev/dockerdev/config.toml

@@ -11,7 +11,7 @@ jdks = [
     'zulu25-ca-jdk',
 ]
 
-go_version = '1.26.0'
+go_version = '1.26.1'
 
 zig_version = '0.15.2'
 

{omdev-0.0.0.dev537 → omdev-0.0.0.dev538}/omdev/scripts/lib/io/pipelines.py

@@ -43,17 +43,18 @@ def __omlish_amalg__():  # noqa
             dict(path='../../lite/namespaces.py', sha1='27b12b6592403c010fb8b2a0af7c24238490d3a1'),
             dict(path='../../logs/levels.py', sha1='91405563d082a5eba874da82aac89d83ce7b6152'),
             dict(path='../../logs/warnings.py', sha1='c4eb694b24773351107fcc058f3620f1dbfb6799'),
-            dict(path='core.py', sha1='ddac59c8d08b2602c2f1a9d1e4fde19d9f390c1d'),
+            dict(path='core.py', sha1='d9c24e9b85536086a93fc6f00ae02cdba2824e55'),
             dict(path='../streams/types.py', sha1='8959d244de95eaf9f118cc3fd2d713d85e55ff36'),
             dict(path='../../logs/infos.py', sha1='4dd104bd468a8c438601dd0bbda619b47d2f1620'),
             dict(path='../../logs/metrics/base.py', sha1='95120732c745ceec5333f81553761ab6ff4bb3fb'),
             dict(path='../../logs/protocols.py', sha1='05ca4d1d7feb50c4e3b9f22ee371aa7bf4b3dbd1'),
             dict(path='asyncs.py', sha1='a78bd64bada44716809c19e95d6ca4a96f3a28d7'),
             dict(path='bytes/buffering.py', sha1='c19bddb05ef9449aa1a1c228901cab0d2d927946'),
-            dict(path='flow/types.py', sha1='713bd98b7ecb094655439d8517c43147a25ff9a1'),
+            dict(path='drivers/metadata.py', sha1='44e49cb87136933ffe867087897eab5004034a93'),
+            dict(path='flow/types.py', sha1='f6d06c7d6ca41a88930811507c966eeb073c15b3'),
             dict(path='handlers/fns.py', sha1='6dd1901ebdbdb31caeffab06d239f1c41e3f2726'),
             dict(path='handlers/queues.py', sha1='f49d19c5dd7de77299bedbfb3a77a36479fd1edf'),
-            dict(path='sched/types.py', sha1='0ef85c6cce69bdf8a6cd9c85eb806d52808f7e0d'),
+            dict(path='sched/types.py', sha1='854b3f0f8ed5da2132a516f787b9019f5cb4eef5'),
             dict(path='../streams/base.py', sha1='bdeaff419684dec34fd0dc59808a9686131992bc'),
             dict(path='../streams/framing.py', sha1='dc2d7f638b042619fd3d95789c71532a29fd5fe4'),
             dict(path='../streams/utils.py', sha1='eb08fa1d56284b078f973eea6796747b9bbdffdf'),
@@ -70,7 +71,7 @@ def __omlish_amalg__():  # noqa
             dict(path='../../logs/std/loggers.py', sha1='dbdfc66188e6accb75d03454e43221d3fba0f011'),
             dict(path='bytes/decoders.py', sha1='6f6d8bc1adc6a5277543389814bc26ef63e34561'),
             dict(path='../../logs/modules.py', sha1='dd7d5f8e63fe8829dfb49460f3929ab64b68ee14'),
-            dict(path='drivers/asyncio.py', sha1='f48bd74d34b70b1f9da20ac67e0cc92bc0d7f19c'),
+            dict(path='drivers/asyncio.py', sha1='59e80c4ac127e727676f17e956783f3aa39b4088'),
             dict(path='_amalg.py', sha1='14b67747b1e3b3c1483050a7948a29888d732ed9'),
         ],
     )
@@ -1605,14 +1606,14 @@ class IoPipelineHandlerContext:
             _pipeline: 'IoPipeline',
             _handler: 'IoPipelineHandler',
 
-            name: ta.Optional[str] = None,
+            _name: ta.Optional[str] = None,
     ) -> None:
         super().__init__()
 
         self._pipeline: ta.Final[IoPipeline] = _pipeline
         self._handler: ta.Final[IoPipelineHandler] = _handler
 
-        self._name: ta.Final[ta.Optional[str]] = name
+        self._name: ta.Final[ta.Optional[str]] = _name
 
         self._ref: IoPipelineHandlerRef_ = IoPipelineHandlerRef(_context=self)
 
@@ -1960,13 +1961,21 @@ class ShareableIoPipelineHandler(IoPipelineHandler, Abstract):
 ##
 
 
-IoPipelineDirection = ta.Literal['inbound', 'outbound']  # ta.TypeAlias  # omlish-amalg-typing-no-move
+IoPipelineDirection = ta.Literal[  # ta.TypeAlias  # omlish-amalg-typing-no-move
+    'inbound',
+    'outbound',
+]
 
 IoPipelineDirectionOrDuplex = ta.Literal[  # ta.TypeAlias  # omlish-amalg-typing-no-move
     IoPipelineDirection,
     'duplex',
 ]
 
+IoPipelineUpdate = ta.Literal[  # ta.TypeAlias  # omlish-amalg-typing-no-move
+    'added',
+    'removed',
+]
+
 IoPipelineHandlerUpdate = ta.Literal[  # ta.TypeAlias  # omlish-amalg-typing-no-move
     'adding',
     'added',
@@ -1979,6 +1988,9 @@ IoPipelineHandlerUpdate = ta.Literal[  # ta.TypeAlias  # omlish-amalg-typing-no-
 
 
 class IoPipelineService(Abstract):
+    def pipeline_update(self, pipeline: 'IoPipeline', kind: IoPipelineUpdate) -> None:
+        pass
+
     def handler_update(self, handler_ref: IoPipelineHandlerRef, kind: IoPipelineHandlerUpdate) -> None:
         pass
 
@@ -1997,12 +2009,15 @@ class IoPipelineServices:
         self._by_type_cache: ta.Dict[type, ta.Sequence[ta.Any]] = {}
         self._single_by_type_cache: ta.Dict[type, ta.Optional[ta.Any]] = {}
 
+        self._handles_pipeline_update = handles_pipeline_update = []
         self._handles_handler_update = handles_handler_update = []
         self._handles_pipeline_enter = handles_pipeline_enter = []
         self._handles_pipeline_exit = handles_pipeline_exit = []
 
         for svc in lst:
             sty = type(svc)
+            if sty.pipeline_update is not IoPipelineService.pipeline_update:
+                handles_pipeline_update.append(sty)
             if sty.handler_update is not IoPipelineService.handler_update:
                 handles_handler_update.append(sty)
             if sty.pipeline_enter is not IoPipelineService.pipeline_enter:
@@ -2010,14 +2025,19 @@ class IoPipelineServices:
             if sty.pipeline_exit is not IoPipelineService.pipeline_exit:
                 handles_pipeline_exit.append(sty)
 
+    _handles_pipeline_update: ta.Sequence[IoPipelineService]
     _handles_handler_update: ta.Sequence[IoPipelineService]
     _handles_pipeline_enter: ta.Sequence[IoPipelineService]
     _handles_pipeline_exit: ta.Sequence[IoPipelineService]
 
+    _EMPTY: ta.ClassVar['IoPipelineServices']
+
     @classmethod
     def of(cls, obj: ta.Union['IoPipelineServices', ta.Sequence[IoPipelineService]]) -> 'IoPipelineServices':  # noqa
         if isinstance(obj, cls):
             return obj
+        elif not obj:
+            return cls._EMPTY
         else:
             return cls(list(obj))
 
@@ -2066,6 +2086,9 @@ class IoPipelineServices:
         return svc
 
 
+IoPipelineServices._EMPTY = IoPipelineServices([])  # noqa
+
+
 ##
 
 
@@ -2083,10 +2106,14 @@ class IoPipelineMetadatas:
             dct[mty] = md
         self._dct = dct
 
+    _EMPTY: ta.ClassVar['IoPipelineMetadatas']
+
     @classmethod
     def of(cls, obj: ta.Union['IoPipelineMetadatas', ta.Sequence[IoPipelineMetadata]]) -> 'IoPipelineMetadatas':  # noqa
         if isinstance(obj, cls):
             return obj
+        elif not obj:
+            return cls._EMPTY
         else:
             return cls(list(obj))
 
@@ -2148,6 +2175,9 @@ class IoPipelineMetadatas:
         return self._dct.get(ty, default)
 
 
+IoPipelineMetadatas._EMPTY = IoPipelineMetadatas([])  # noqa
+
+
 ##
 
 
@@ -2362,8 +2392,6 @@ class IoPipeline:
             *never_handle_exceptions,
         )
 
-        self._execution_depth = 0
-
         self._propagation: _IoPipelinePropagation = _IoPipelinePropagation(self)
 
         #
@@ -2393,16 +2421,14 @@ class IoPipeline:
 
         #
 
-        self._saw_any_input = False
-        self._saw_initial_input = False
-        self._saw_final_input = False
-        self._saw_final_output = False
-
         self._state = IoPipeline.State.READY
 
         #
 
         try:
+            for svc in self._services._handles_pipeline_update:  # noqa
+                svc.pipeline_update(self, 'added')
+
             for h in spec.handlers:
                 self.add_innermost(h)
 
@@ -2435,8 +2461,17 @@ class IoPipeline:
     def state(self) -> State:
         return self._state
 
+    @property
+    def is_ready(self) -> bool:
+        return self._state is IoPipeline.State.READY
+
     #
 
+    _saw_any_input = False
+    _saw_initial_input = False
+    _saw_final_input = False
+    _saw_final_output = False
+
     @property
     def saw_any_input(self) -> bool:
         return self._saw_any_input
@@ -2467,6 +2502,8 @@ class IoPipeline:
     ##
     # execution
 
+    _execution_depth = 0
+
     def _step_in(self) -> None:
         self._execution_depth += 1
 
@@ -2717,7 +2754,7 @@ class IoPipeline:
             _pipeline=self,
             _handler=handler,
 
-            name=name,
+            _name=name,
         )
 
         self._handler_update(ctx, 'adding')  # noqa
@@ -3062,6 +3099,9 @@ class IoPipeline:
         finally:
             self._step_out()
 
+        for svc in self._services._handles_pipeline_update:  # noqa
+            svc.pipeline_update(self, 'removed')
+
         self._state = IoPipeline.State.DESTROYED
 
 
@@ -3940,6 +3980,18 @@ class OutboundBytesBufferingIoPipelineHandler(IoPipelineHandler, Abstract):
         raise NotImplementedError
 
 
+########################################
+# ../drivers/metadata.py
+
+
+##
+
+
+@dc.dataclass(frozen=True)
+class DriverIoPipelineMetadata(IoPipelineMetadata):
+    driver: ta.Any
+
+
 ########################################
 # ../flow/types.py
 
@@ -4005,14 +4057,31 @@ class IoPipelineFlowMessages(NamespaceClass):
 ##
 
 
-class IoPipelineFlow(IoPipelineService, Abstract):
+class IoPipelineFlow(Abstract):
     @abc.abstractmethod
-    def is_auto_read(self) -> bool:
-        raise NotImplementedError
+    def is_auto_read(
+            self: ta.Union[
+                'IoPipelineFlow',
+                IoPipeline,
+                IoPipelineHandlerContext,
+                None,
+            ],
+    ) -> bool:
+        # This strange construct grants the ability to do `IoPipelineFlow.is_auto_read(opt_flow)`, which is becoming
+        # increasingly frequently useful in real code.
+        if self is None:
+            return False
 
-    @staticmethod
-    def is_auto_read_context(ctx: IoPipelineHandlerContext) -> bool:
-        return (fc := ctx.services.find(IoPipelineFlow)) is None or fc.is_auto_read()
+        if isinstance(self, IoPipelineFlow):
+            return self.is_auto_read()
+
+        if isinstance(self, IoPipelineHandlerContext):
+            self = self._pipeline  # noqa
+
+        if isinstance(self, IoPipeline):
+            return (fc := self.services.find(IoPipelineFlow)) is None or fc.is_auto_read()
+
+        raise TypeError(self)
 
 
 ########################################
@@ -4299,7 +4368,7 @@ class DuplexQueueIoPipelineHandler(
 ##
 
 
-class IoPipelineScheduling(IoPipelineService, Abstract):
+class IoPipelineScheduling(Abstract):
     class Handle(Abstract):
         @abc.abstractmethod
         def cancel(self) -> None:
@@ -7995,7 +8064,7 @@ class AsyncioStreamIoPipelineDriver(Abstract):
     ##
     # init
 
-    _sched: 'AsyncioStreamIoPipelineDriver._Scheduling'
+    _sched: 'AsyncioStreamIoPipelineDriver._SchedulingService'
 
     _pipeline: IoPipeline
 
@@ -8005,7 +8074,7 @@ class AsyncioStreamIoPipelineDriver(Abstract):
     _output_handlers: ta.Mapping[type, ta.Callable[[ta.Any], ta.Awaitable[None]]]
 
     async def _init(self) -> None:
-        self._sched = self._Scheduling(self)
+        self._sched = self._SchedulingService(self)
 
         services = IoPipelineServices.of(self._spec.services)
         self._flow = services.find(IoPipelineFlow)
@@ -8017,6 +8086,7 @@ class AsyncioStreamIoPipelineDriver(Abstract):
 
         self._pipeline = IoPipeline(dc.replace(
             self._spec,
+            metadata=(*self._spec.metadata, DriverIoPipelineMetadata(self)),
             services=(*self._spec.services, self._sched),
         ))
 
@@ -8237,7 +8307,7 @@ class AsyncioStreamIoPipelineDriver(Abstract):
     ##
     # scheduling
 
-    class _Scheduling(IoPipelineScheduling):
+    class _SchedulingService(IoPipelineScheduling, IoPipelineService):
         def __init__(self, d: 'AsyncioStreamIoPipelineDriver') -> None:
             super().__init__()
 

{omdev-0.0.0.dev537 → omdev-0.0.0.dev538/omdev.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: omdev
-Version: 0.0.0.dev537
+Version: 0.0.0.dev538
 Summary: omdev
 Author: wrmsr
 License-Expression: BSD-3-Clause
@@ -14,7 +14,7 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: omlish==0.0.0.dev537
+Requires-Dist: omlish==0.0.0.dev538
 Provides-Extra: all
 Requires-Dist: black~=26.3; extra == "all"
 Requires-Dist: pycparser~=3.0; extra == "all"

{omdev-0.0.0.dev537 → omdev-0.0.0.dev538}/omdev.egg-info/requires.txt

@@ -1,4 +1,4 @@
-omlish==0.0.0.dev537
+omlish==0.0.0.dev538
 
 [all]
 black~=26.3

{omdev-0.0.0.dev537 → omdev-0.0.0.dev538}/pyproject.toml

@@ -13,7 +13,7 @@ urls = {source = 'https://github.com/wrmsr/omlish'}
 license = 'BSD-3-Clause'
 readme = 'README.md'
 requires-python = '>=3.13'
-version = '0.0.0.dev537'
+version = '0.0.0.dev538'
 classifiers = [
     'Development Status :: 2 - Pre-Alpha',
     'Intended Audience :: Developers',
@@ -24,7 +24,7 @@ classifiers = [
 ]
 description = 'omdev'
 dependencies = [
-    'omlish == 0.0.0.dev537',
+    'omlish == 0.0.0.dev538',
 ]
 
 [project.optional-dependencies]