omdev 0.0.24__tar.gz → 0.0.26__tar.gz

{omdev-0.0.24/omdev.egg-info → omdev-0.0.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: omdev
-Version: 0.0.24
+Version: 0.0.26
 Summary: omdev
 Author: wrmsr
 License-Expression: BSD-3-Clause
@@ -14,10 +14,10 @@ Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: omlish==0.0.24
+Requires-Dist: omlish==0.0.26
 Provides-Extra: all
-Requires-Dist: ominfra==0.0.24; extra == "all"
-Requires-Dist: ommlds==0.0.24; extra == "all"
+Requires-Dist: ominfra==0.0.26; extra == "all"
+Requires-Dist: ommlds==0.0.26; extra == "all"
 Requires-Dist: black~=26.5; extra == "all"
 Requires-Dist: pycparser~=3.0; extra == "all"
 Requires-Dist: pcpp~=1.30; extra == "all"
@@ -25,7 +25,7 @@ Requires-Dist: docutils~=0.23; extra == "all"
 Requires-Dist: markdown-it-py~=4.2; extra == "all"
 Requires-Dist: mdit-py-plugins~=0.6; extra == "all"
 Requires-Dist: pygments~=2.20; extra == "all"
-Requires-Dist: mypy~=2.1; extra == "all"
+Requires-Dist: mypy~=2.2; extra == "all"
 Requires-Dist: gprof2dot~=2025.4; extra == "all"
 Requires-Dist: segno~=1.6; extra == "all"
 Requires-Dist: rich~=15.0; extra == "all"
@@ -33,9 +33,9 @@ Requires-Dist: textual~=8.2; extra == "all"
 Requires-Dist: textual-dev~=1.8; extra == "all"
 Requires-Dist: textual-speedups~=0.2; extra == "all"
 Provides-Extra: ominfra
-Requires-Dist: ominfra==0.0.24; extra == "ominfra"
+Requires-Dist: ominfra==0.0.26; extra == "ominfra"
 Provides-Extra: ommlds
-Requires-Dist: ommlds==0.0.24; extra == "ommlds"
+Requires-Dist: ommlds==0.0.26; extra == "ommlds"
 Provides-Extra: black
 Requires-Dist: black~=26.5; extra == "black"
 Provides-Extra: c
@@ -47,7 +47,7 @@ Requires-Dist: markdown-it-py~=4.2; extra == "doc"
 Requires-Dist: mdit-py-plugins~=0.6; extra == "doc"
 Requires-Dist: pygments~=2.20; extra == "doc"
 Provides-Extra: mypy
-Requires-Dist: mypy~=2.1; extra == "mypy"
+Requires-Dist: mypy~=2.2; extra == "mypy"
 Provides-Extra: prof
 Requires-Dist: gprof2dot~=2025.4; extra == "prof"
 Provides-Extra: qr

{omdev-0.0.24 → omdev-0.0.26}/omdev/__about__.py

@@ -41,7 +41,7 @@ class Project(ProjectBase):
         ],
 
         'mypy': [
-            'mypy ~= 2.1',
+            'mypy ~= 2.2',
         ],
 
         'prof': [

{omdev-0.0.24 → omdev-0.0.26}/omdev/dataclasses/_dumping.py

@@ -21,6 +21,7 @@ import json
 import os.path
 import sys
 import threading
+import traceback
 import types
 import typing as ta
 import uuid
@@ -45,7 +46,7 @@ def __omlish_amalg__():  # noqa
             dict(path='../../omlish/lite/strings.py', sha1='89631bb5cfd6496176db71ab3abd58b89872068b'),
             dict(path='../../omlish/lite/json.py', sha1='01124e62093ebd4078602f16df0ec04cb724a612'),
             dict(path='../../omlish/lite/marshal.py', sha1='66bc88d705df274e9fa1168d2aab20c7e3935cf6'),
-            dict(path='dumping.py', sha1='ae4148f671d2cb1e7bf1a819b78ca388b4680bbc'),
+            dict(path='dumping.py', sha1='3a116abfd0a6c5abc2e2ad3f2ff48ce8c114ac07'),
         ],
     )
 
@@ -1985,6 +1986,7 @@ class _DataclassCodegenDumper:
             init_file_path: str,
             out_file_path: str,
             cfg_pkg_name: ta.Optional[str] = None,
+            debug: bool = False,
     ) -> None:
         from omlish.dataclasses.impl.configs import PACKAGE_CONFIG_CACHE  # noqa
         from omlish.dataclasses.impl.generation.compilation import OpCompiler  # noqa
@@ -1992,6 +1994,8 @@ class _DataclassCodegenDumper:
         from omlish.dataclasses.impl.generation.ops import OpRef  # noqa
         from omlish.dataclasses.impl.generation.processor import Codegen  # noqa
         from omlish.dataclasses.impl.generation.processor import GeneratorProcessor  # noqa
+        from omlish.dataclasses.impl.generation.processor import ProcessingOption  # noqa
+        from omlish.dataclasses.impl.generation.processor import Verbosity  # noqa
         from omlish.dataclasses.impl.processing.base import ProcessingContext  # noqa
         from omlish.dataclasses.impl.processing.driving import processing_options_context  # noqa
 
@@ -2060,7 +2064,7 @@ class _DataclassCodegenDumper:
                 try:
                     __import__(spec)
                 except Exception as e:  # noqa
-                    import_errors[spec] = repr(e)
+                    import_errors[spec] = ''.join(traceback.format_exc())
 
             finally:
                 cur_module = None
@@ -2113,11 +2117,20 @@ class _DataclassCodegenDumper:
 
         #
 
-        with processing_options_context(Codegen(
-                style='aot',
-                force=True,
-                callback=callback,
-        )):
+        proc_opts: list[ProcessingOption] = []
+
+        proc_opts.append(Codegen(
+            style='aot',
+            force=True,
+            callback=callback,
+        ))
+
+        if debug:
+            proc_opts.append(Verbosity(
+                debug=True,
+            ))
+
+        with processing_options_context(*proc_opts):
             process_dir(os.path.dirname(init_file_path))
 
         #

{omdev-0.0.24 → omdev-0.0.26}/omdev/dataclasses/cli.py

@@ -13,6 +13,7 @@ class Cli(ap.Cli):
         ap.arg('--dump-inline', action='store_true'),
         ap.arg('--dry-run', action='store_true'),
         ap.arg('--print-code', action='store_true'),
+        ap.arg('--debug', action='store_true'),
         ap.arg('-j', '--jobs', type=int),
     )
     def codegen(self) -> None:
@@ -20,8 +21,9 @@ class Cli(ap.Cli):
 
         asyncio.run(DataclassCodeGen(
             dump_inline=self.args.dump_inline,
-            print_code=self.args.print_code,
             dry_run=self.args.dry_run,
+            print_code=self.args.print_code,
+            debug=self.args.debug,
         ).run(
             self.args.roots,
             **(dict(concurrency=self.args.jobs) if self.args.jobs is not None else {}),

{omdev-0.0.24 → omdev-0.0.26}/omdev/dataclasses/codegen.py

@@ -74,16 +74,18 @@ class DataclassCodeGen:
             *,
             target_line_width: int | None = None,
             dump_inline: bool = False,
-            print_code: bool = False,
             dry_run: bool = False,
+            print_code: bool = False,
+            debug: bool = False,
             subprocess_kwargs: ta.Mapping[str, ta.Any] | None = None,
     ) -> None:
         super().__init__()
 
         self._target_line_width = target_line_width or self.DEFAULT_TARGET_LINE_WIDTH
         self._dump_inline = dump_inline
-        self._print_code = print_code
         self._dry_run = dry_run
+        self._print_code = print_code
+        self._debug = debug
         self._subprocess_kwargs = subprocess_kwargs
 
     #
@@ -203,6 +205,7 @@ class DataclassCodeGen:
             init_file_path=cfg_pkg.init_file_path,
             out_file_path=out_file_path,
             cfg_pkg_name=cfg_pkg.name,
+            **(dict(debug=True) if self._debug else {}),
         )
 
         start_time = time.time()
@@ -235,6 +238,9 @@ class DataclassCodeGen:
     ) -> None:
         gen_file_path = os.path.join(os.path.dirname(cfg_pkg.init_file_path), '_dataclasses.py')
 
+        for err_mod, err_str in output.import_errors.items():
+            log.error(lambda: f'Failed to import {err_mod}: {err_str}')
+
         if os.path.isfile(gen_file_path):
             if not _is_generated_py_file(gen_file_path):
                 raise RuntimeError(f'Refusing to overwrite non-generated file: {gen_file_path!r}')
@@ -315,21 +321,6 @@ class DataclassCodeGen:
                 f'    plan_repr_sha1={pr_sha1!r},',
             ])
 
-            op_ref_idents = [r.ident for r in x.refs if r.kind == 'op']
-            if op_ref_idents:
-                lines.extend([
-                    f'    op_ref_idents=(',
-                    *[
-                        f'        {r!r},'
-                        for r in sorted(op_ref_idents)
-                    ],
-                    f'    ),',
-                ])
-            else:
-                lines.append(
-                    '    op_ref_idents=(),',
-                )
-
             lines.extend([
                 f'    cls_names=(',
                 *[

{omdev-0.0.24 → omdev-0.0.26}/omdev/dataclasses/dumping.py

@@ -3,6 +3,7 @@
 # @omlish-amalg _dumping.py
 import dataclasses as dc
 import os.path
+import traceback
 import typing as ta
 
 from omlish.lite.check import check
@@ -57,6 +58,7 @@ class _DataclassCodegenDumper:
             init_file_path: str,
             out_file_path: str,
             cfg_pkg_name: ta.Optional[str] = None,
+            debug: bool = False,
     ) -> None:
         from omlish.dataclasses.impl.configs import PACKAGE_CONFIG_CACHE  # noqa
         from omlish.dataclasses.impl.generation.compilation import OpCompiler  # noqa
@@ -64,6 +66,8 @@ class _DataclassCodegenDumper:
         from omlish.dataclasses.impl.generation.ops import OpRef  # noqa
         from omlish.dataclasses.impl.generation.processor import Codegen  # noqa
         from omlish.dataclasses.impl.generation.processor import GeneratorProcessor  # noqa
+        from omlish.dataclasses.impl.generation.processor import ProcessingOption  # noqa
+        from omlish.dataclasses.impl.generation.processor import Verbosity  # noqa
         from omlish.dataclasses.impl.processing.base import ProcessingContext  # noqa
         from omlish.dataclasses.impl.processing.driving import processing_options_context  # noqa
 
@@ -132,7 +136,7 @@ class _DataclassCodegenDumper:
                 try:
                     __import__(spec)
                 except Exception as e:  # noqa
-                    import_errors[spec] = repr(e)
+                    import_errors[spec] = ''.join(traceback.format_exc())
 
             finally:
                 cur_module = None
@@ -185,11 +189,20 @@ class _DataclassCodegenDumper:
 
         #
 
-        with processing_options_context(Codegen(
-                style='aot',
-                force=True,
-                callback=callback,
-        )):
+        proc_opts: list[ProcessingOption] = []
+
+        proc_opts.append(Codegen(
+            style='aot',
+            force=True,
+            callback=callback,
+        ))
+
+        if debug:
+            proc_opts.append(Verbosity(
+                debug=True,
+            ))
+
+        with processing_options_context(*proc_opts):
             process_dir(os.path.dirname(init_file_path))
 
         #

{omdev-0.0.24 → omdev-0.0.26}/omdev/packaging/marshal.py

@@ -45,7 +45,7 @@ class RequiresMarkerListMarshaler(msh.Marshaler):
 
 class RequiresMarkerListMarshalerFactory(msh.MarshalerFactory):
     def make_marshaler(self, ctx: msh.MarshalFactoryContext, rty: rfl.Type) -> ta.Callable[[], msh.Marshaler] | None:
-        if rty is not MarshalRequiresMarkerList:
+        if rty.runtime_object is not MarshalRequiresMarkerList:
             return None
         return lambda: RequiresMarkerListMarshaler(
             ctx.make_marshaler(RequiresMarkerItem),

{omdev-0.0.24 → omdev-0.0.26}/omdev/packaging/wheelfile.py

@@ -129,7 +129,7 @@ class WheelFile(zipfile.ZipFile):
     def open(  # type: ignore  # noqa
             self,
             name_or_info: ta.Union[str, zipfile.ZipInfo],
-            mode: str = 'r',  # ta.Literal["r", "w"]
+            mode: ta.Literal['r', 'w'] = 'r',
             pwd: ta.Optional[bytes] = None,
     ) -> ta.IO[bytes]:
         def _update_crc(newdata: bytes) -> None:

{omdev-0.0.24 → omdev-0.0.26}/omdev/scripts/ci.py

@@ -134,7 +134,7 @@ def __omlish_amalg__():  # noqa
             dict(path='../../omlish/argparse/parsers.py', sha1='51044d7b7d1b1ca27173be2d3c007d574827a188'),
             dict(path='../../omlish/formats/yaml/goyaml/errors.py', sha1='c4dda09d78bc14d9824e45e3d5d434185ee5598b'),
             dict(path='../../omlish/http/headers.py', sha1='aa2182505c9b09e2b658df8f8b3d927bc5fae13b'),
-            dict(path='../../omlish/http/parsing.py', sha1='4477d00145b207dd0397ecfbc8fef5ae8c641bb3'),
+            dict(path='../../omlish/http/parsing.py', sha1='1adee35518ee930557f2c3b19fd4253df98a5b3c'),
             dict(path='../../omlish/http/pipelines/compression/codings.py', sha1='b88bf055dff1b040ecde17d98484559e9078b8cf'),  # noqa
             dict(path='../../omlish/io/pipelines/core.py', sha1='cec21cacb85a0f443ea4caa021b33184d3816cf2'),
             dict(path='../../omlish/io/streams/types.py', sha1='6a3167bf66a0a8817e19115b9c31973b2ff77788'),
@@ -163,7 +163,7 @@ def __omlish_amalg__():  # noqa
             dict(path='../../omlish/http/simple/types.py', sha1='8e31b8c442603b396523884ff554d3df6e7f4c1a'),
             dict(path='../../omlish/io/pipelines/bytes/buffering.py', sha1='c19bddb05ef9449aa1a1c228901cab0d2d927946'),
             dict(path='../../omlish/io/pipelines/drivers/metadata.py', sha1='44e49cb87136933ffe867087897eab5004034a93'),  # noqa
-            dict(path='../../omlish/io/pipelines/flow/types.py', sha1='ac9a91d0a8115443984a75a63ffac51a7acef580'),
+            dict(path='../../omlish/io/pipelines/flow/types.py', sha1='4353968e5bd490f4121eadf9e391076bd2673f28'),
             dict(path='../../omlish/io/pipelines/sched/types.py', sha1='854b3f0f8ed5da2132a516f787b9019f5cb4eef5'),
             dict(path='../../omlish/io/streams/base.py', sha1='bdeaff419684dec34fd0dc59808a9686131992bc'),
             dict(path='../../omlish/io/streams/framing.py', sha1='dc2d7f638b042619fd3d95789c71532a29fd5fe4'),
@@ -176,7 +176,7 @@ def __omlish_amalg__():  # noqa
             dict(path='../../omlish/sockets/handlers/simple.py', sha1='78e1a4c419c8f82d10577f19654a3d8ce28d757f'),
             dict(path='../../omlish/sockets/handlers/ssl.py', sha1='94c0acedffe5b581419a7a92c2f1c4e4a58b7a83'),
             dict(path='../../omlish/sockets/handlers/threading.py', sha1='24d7815c7bf8fcf3480267020785a3edc90b32f9'),
-            dict(path='../../omlish/subprocesses/run.py', sha1='1d2a78b18bcc601c8b28269d792cc38bbf25a078'),
+            dict(path='../../omlish/subprocesses/run.py', sha1='9b7e1265cd59c58d30d8915f96ba84f80797ef42'),
             dict(path='../../omlish/subprocesses/wrap.py', sha1='8a9b7d2255481fae15c05f5624b0cdc0766f4b3f'),
             dict(path='../dataserver/handlers.py', sha1='ce0a208cbd7f66b26b9539ec6d5e7ef1041a4886'),
             dict(path='../dataserver/routes.py', sha1='97379cba6a531ca1bde33de0eb432bd9b36791c1'),
@@ -4924,6 +4924,7 @@ class SemanticHeaderHttpParseErrorCode(enum.Enum):
     INVALID_AUTHORIZATION = enum.auto()
     TE_WITHOUT_CHUNKED_LAST = enum.auto()
     TE_IN_HTTP10 = enum.auto()
+    INVALID_TE = enum.auto()
 
 
 class EncodingHttpParseErrorCode(enum.Enum):
@@ -5203,14 +5204,14 @@ class HttpParser:
         """Strictness knobs. Defaults are maximally strict."""
 
         allow_obs_fold: bool = False
-        allow_space_before_colon: bool = False  # DANGEROUS - upstreams may not handle well
+        dangerous_allow_space_before_colon: bool = False  # DANGEROUS - upstreams may not handle well
         allow_multiple_content_lengths: bool = False
         allow_content_length_with_te: bool = False
         allow_bare_lf: bool = False
         allow_missing_host: bool = False
         allow_multiple_hosts: bool = False
         allow_unknown_transfer_encoding: bool = False
-        allow_empty_header_values: bool = True
+        reject_empty_header_values: bool = False
         allow_bare_cr_in_value: bool = False
         allow_te_without_chunked_in_response: bool = False
         allow_transfer_encoding_http10: bool = False
@@ -5879,7 +5880,7 @@ class _HttpParseContext:
 
         # Check for space before colon
         if name_bytes[-1] in self._OWS_CHARS:
-            if not self.config.allow_space_before_colon:
+            if not self.config.dangerous_allow_space_before_colon:
                 raise HeaderFieldHttpParseError(
                     code=HeaderFieldHttpParseErrorCode.SPACE_BEFORE_COLON,
                     message='Whitespace between field-name and colon',
@@ -5930,7 +5931,7 @@ class _HttpParseContext:
         value_stripped = self._strip_ows(value_bytes)
 
         # Check for empty value
-        if not value_stripped and not self.config.allow_empty_header_values:
+        if not value_stripped and self.config.reject_empty_header_values:
             raise HeaderFieldHttpParseError(
                 code=HeaderFieldHttpParseErrorCode.INVALID_FIELD_VALUE,
                 message='Empty header field value not allowed',
@@ -6050,7 +6051,10 @@ class _HttpParseContext:
             for part in v.split(','):
                 stripped = part.strip()
 
-                if not stripped.isdigit():
+                # NOTE: must be ASCII digits only. str.isdigit() is True for non-ASCII numerics present in the
+                # latin-1-decoded value (e.g. superscripts U+00B2/B3/B9), but int() rejects those with a ValueError -
+                # which would escape as an uncaught exception rather than a clean parse error.
+                if not (stripped.isascii() and stripped.isdigit()):
                     raise SemanticHeaderHttpParseError(
                         code=SemanticHeaderHttpParseErrorCode.INVALID_CONTENT_LENGTH,
                         message=f'Content-Length value is not a valid non-negative integer: {stripped!r}',
@@ -6410,16 +6414,28 @@ class _HttpParseContext:
         if q_str is not None:
             q = float(q_str)  # caller wraps ValueError
 
+            # float() also accepts 'nan'/'inf'/overflowing exponents; reject those and any out-of-range value. The
+            # chained comparison is False for NaN and +/-inf, so this single check covers non-finite and range at once.
+            # (RFC 9110 qvalue is 0 <= q <= 1.)
+            if not (0.0 <= q <= 1.0):
+                raise ValueError(f'q-value out of range [0, 1]: {q_str!r}')
+
         return token, q, params
 
     def _prepare_te(self, headers: ParsedHttpHeaders, prepared: PreparedParsedHttpHeaders) -> None:
         if 'te' not in headers:
             return
 
-        codings = [
-            self._split_header_element(p)[0]
-            for p in self._parse_comma_list(headers['te'])
-        ]
+        try:
+            codings = [
+                self._split_header_element(p)[0]
+                for p in self._parse_comma_list(headers['te'])
+            ]
+        except ValueError:
+            raise SemanticHeaderHttpParseError(
+                code=SemanticHeaderHttpParseErrorCode.INVALID_TE,
+                message=f'Invalid q-value in TE header: {headers["te"]!r}',
+            ) from None
 
         prepared.te = [c for c in codings if c]
 
@@ -13526,25 +13542,36 @@ class IoPipelineFlowMessages(NamespaceClass):
     ):
         pass
 
+    ##
+    # TODO / WIP:
+    #  - Level-triggered writability, edge-notified: emitters send one message per *transition*, never repeats.
+    #    ReadyForOutput means 'output may flow'; PauseOutput means 'stop producing output'.
+    #  - They flow INBOUND (transport -> app), originated by the transport head (or a dedicated watermark handler
+    #    watching an OutboundBytesBufferingIoPipelineHandler) from its unflushed backlog vs high/low watermarks.
+    #  - Handlers that buffer outbound data (ssl, compression, ...) do not forward these blindly: they combine the
+    #    transport-side signal with their own buffer level and re-announce the COMBINED value inbound, again only on
+    #    change. Pass-through handlers just propagate.
+    #  - The implied initial state is writable; a pipeline that never sends either message behaves as if ReadyForOutput
+    #    were always in effect. As with the other flow messages, these are only ever sent when an IoPipelineFlow service
+    #    is present.
+
     #
 
-    # # TODO:
-    # @ta.final
-    # @dc.dataclass(frozen=True)
-    # class ReadyForOutput(  # ~ Netty `ChannelOutboundInvoker::fireChannelWritabilityChanged`  # noqa
-    #     IoPipelineMessages.MayPropagate,
-    #     IoPipelineMessages.NeverOutbound,
-    # ):
-    #     pass
+    @ta.final
+    @dc.dataclass(frozen=True)
+    class ReadyForOutput(  # ~ Netty `ChannelInboundInvoker::fireChannelWritabilityChanged` # noqa
+        IoPipelineMessages.MayPropagate,
+        IoPipelineMessages.NeverOutbound,
+    ):
+        pass
 
-    # # TODO:
-    # @ta.final
-    # @dc.dataclass(frozen=True)
-    # class PauseOutput(  # ~ Netty `ChannelOutboundInvoker::fireChannelWritabilityChanged`  # noqa
-    #     IoPipelineMessages.MayPropagate,
-    #     IoPipelineMessages.NeverOutbound,
-    # ):
-    #     pass
+    @ta.final
+    @dc.dataclass(frozen=True)
+    class PauseOutput(  # ~ Netty `ChannelInboundInvoker::fireChannelWritabilityChanged` # noqa
+        IoPipelineMessages.MayPropagate,
+        IoPipelineMessages.NeverOutbound,
+    ):
+        pass
 
 
 ##
@@ -16017,17 +16044,6 @@ class SubprocessRun:
             async_subprocesses = self._DEFAULT_ASYNC_SUBPROCESSES
         return await check.not_none(async_subprocesses).run_(self.replace(**kwargs))
 
-    _DEFAULT_MAYSYNC_SUBPROCESSES: ta.ClassVar[ta.Optional[ta.Any]] = None  # AbstractMaysyncSubprocesses
-
-    async def maysync_run(
-            self,
-            maysync_subprocesses: ta.Optional[ta.Any] = None,  # AbstractMaysyncSubprocesses
-            **kwargs: ta.Any,
-    ) -> SubprocessRunOutput:
-        if maysync_subprocesses is None:
-            maysync_subprocesses = self._DEFAULT_MAYSYNC_SUBPROCESSES
-        return await check.not_none(maysync_subprocesses).run_(self.replace(**kwargs))
-
 
 SubprocessRun._FIELD_NAMES = frozenset(fld.name for fld in dc.fields(SubprocessRun))  # noqa
 
@@ -16060,13 +16076,6 @@ class SubprocessRunnable(Abstract, ta.Generic[T]):
     ) -> T:
         return self.handle_run_output(await self.make_run().async_run(async_subprocesses, **kwargs))
 
-    async def maysync_run(
-            self,
-            maysync_subprocesses: ta.Optional[ta.Any] = None,  # AbstractMaysyncSubprocesses
-            **kwargs: ta.Any,
-    ) -> T:
-        return self.handle_run_output(await self.make_run().maysync_run(maysync_subprocesses, **kwargs))
-
 
 ########################################
 # ../../../omlish/subprocesses/wrap.py

{omdev-0.0.24 → omdev-0.0.26}/omdev/scripts/interp.py

@@ -77,7 +77,7 @@ def __omlish_amalg__():  # noqa
             dict(path='../../omlish/asyncs/asyncio/timeouts.py', sha1='4d31b02b3c39b8f2fa7e94db36552fde6942e36a'),
             dict(path='../../omlish/lite/inject.py', sha1='172296edc98b32e51fdaa44ccc0a05b56e94f3ba'),
             dict(path='../../omlish/logs/std/json.py', sha1='2a75553131e4d5331bb0cedde42aa183f403fc3b'),
-            dict(path='../../omlish/subprocesses/run.py', sha1='1d2a78b18bcc601c8b28269d792cc38bbf25a078'),
+            dict(path='../../omlish/subprocesses/run.py', sha1='9b7e1265cd59c58d30d8915f96ba84f80797ef42'),
             dict(path='../../omlish/subprocesses/wrap.py', sha1='8a9b7d2255481fae15c05f5624b0cdc0766f4b3f'),
             dict(path='providers/base.py', sha1='f5d068c21f230d742e9015b033cd6320f4c68898'),
             dict(path='../../omlish/logs/std/standard.py', sha1='472f1f0623d6bcd301612551432afa7e3a661a34'),
@@ -4790,17 +4790,6 @@ class SubprocessRun:
             async_subprocesses = self._DEFAULT_ASYNC_SUBPROCESSES
         return await check.not_none(async_subprocesses).run_(self.replace(**kwargs))
 
-    _DEFAULT_MAYSYNC_SUBPROCESSES: ta.ClassVar[ta.Optional[ta.Any]] = None  # AbstractMaysyncSubprocesses
-
-    async def maysync_run(
-            self,
-            maysync_subprocesses: ta.Optional[ta.Any] = None,  # AbstractMaysyncSubprocesses
-            **kwargs: ta.Any,
-    ) -> SubprocessRunOutput:
-        if maysync_subprocesses is None:
-            maysync_subprocesses = self._DEFAULT_MAYSYNC_SUBPROCESSES
-        return await check.not_none(maysync_subprocesses).run_(self.replace(**kwargs))
-
 
 SubprocessRun._FIELD_NAMES = frozenset(fld.name for fld in dc.fields(SubprocessRun))  # noqa
 
@@ -4833,13 +4822,6 @@ class SubprocessRunnable(Abstract, ta.Generic[T]):
     ) -> T:
         return self.handle_run_output(await self.make_run().async_run(async_subprocesses, **kwargs))
 
-    async def maysync_run(
-            self,
-            maysync_subprocesses: ta.Optional[ta.Any] = None,  # AbstractMaysyncSubprocesses
-            **kwargs: ta.Any,
-    ) -> T:
-        return self.handle_run_output(await self.make_run().maysync_run(maysync_subprocesses, **kwargs))
-
 
 ########################################
 # ../../../omlish/subprocesses/wrap.py

{omdev-0.0.24 → omdev-0.0.26}/omdev/scripts/lib/io/pipelines.py

@@ -52,7 +52,7 @@ def __omlish_amalg__():  # noqa
             dict(path='asyncs.py', sha1='a78bd64bada44716809c19e95d6ca4a96f3a28d7'),
             dict(path='bytes/buffering.py', sha1='c19bddb05ef9449aa1a1c228901cab0d2d927946'),
             dict(path='drivers/metadata.py', sha1='44e49cb87136933ffe867087897eab5004034a93'),
-            dict(path='flow/types.py', sha1='ac9a91d0a8115443984a75a63ffac51a7acef580'),
+            dict(path='flow/types.py', sha1='4353968e5bd490f4121eadf9e391076bd2673f28'),
             dict(path='handlers/fns.py', sha1='6dd1901ebdbdb31caeffab06d239f1c41e3f2726'),
             dict(path='handlers/queues.py', sha1='f49d19c5dd7de77299bedbfb3a77a36479fd1edf'),
             dict(path='sched/types.py', sha1='854b3f0f8ed5da2132a516f787b9019f5cb4eef5'),
@@ -4145,25 +4145,36 @@ class IoPipelineFlowMessages(NamespaceClass):
     ):
         pass
 
+    ##
+    # TODO / WIP:
+    #  - Level-triggered writability, edge-notified: emitters send one message per *transition*, never repeats.
+    #    ReadyForOutput means 'output may flow'; PauseOutput means 'stop producing output'.
+    #  - They flow INBOUND (transport -> app), originated by the transport head (or a dedicated watermark handler
+    #    watching an OutboundBytesBufferingIoPipelineHandler) from its unflushed backlog vs high/low watermarks.
+    #  - Handlers that buffer outbound data (ssl, compression, ...) do not forward these blindly: they combine the
+    #    transport-side signal with their own buffer level and re-announce the COMBINED value inbound, again only on
+    #    change. Pass-through handlers just propagate.
+    #  - The implied initial state is writable; a pipeline that never sends either message behaves as if ReadyForOutput
+    #    were always in effect. As with the other flow messages, these are only ever sent when an IoPipelineFlow service
+    #    is present.
+
     #
 
-    # # TODO:
-    # @ta.final
-    # @dc.dataclass(frozen=True)
-    # class ReadyForOutput(  # ~ Netty `ChannelOutboundInvoker::fireChannelWritabilityChanged`  # noqa
-    #     IoPipelineMessages.MayPropagate,
-    #     IoPipelineMessages.NeverOutbound,
-    # ):
-    #     pass
-
-    # # TODO:
-    # @ta.final
-    # @dc.dataclass(frozen=True)
-    # class PauseOutput(  # ~ Netty `ChannelOutboundInvoker::fireChannelWritabilityChanged`  # noqa
-    #     IoPipelineMessages.MayPropagate,
-    #     IoPipelineMessages.NeverOutbound,
-    # ):
-    #     pass
+    @ta.final
+    @dc.dataclass(frozen=True)
+    class ReadyForOutput(  # ~ Netty `ChannelInboundInvoker::fireChannelWritabilityChanged` # noqa
+        IoPipelineMessages.MayPropagate,
+        IoPipelineMessages.NeverOutbound,
+    ):
+        pass
+
+    @ta.final
+    @dc.dataclass(frozen=True)
+    class PauseOutput(  # ~ Netty `ChannelInboundInvoker::fireChannelWritabilityChanged` # noqa
+        IoPipelineMessages.MayPropagate,
+        IoPipelineMessages.NeverOutbound,
+    ):
+        pass
 
 
 ##

{omdev-0.0.24 → omdev-0.0.26}/omdev/scripts/pidfiles.py

@@ -72,7 +72,7 @@ def __omlish_amalg__():  # noqa
             dict(path='../../logs/protocols.py', sha1='05ca4d1d7feb50c4e3b9f22ee371aa7bf4b3dbd1'),
             dict(path='../../argparse/cli.py', sha1='aef500dd2d8f5a65c4c04ede11355ac8eb513f2e'),
             dict(path='../../lite/args.py', sha1='ae96b0baeb376617a63c0e64632ab2c5ff4171a8'),
-            dict(path='../../subprocesses/run.py', sha1='1d2a78b18bcc601c8b28269d792cc38bbf25a078'),
+            dict(path='../../subprocesses/run.py', sha1='9b7e1265cd59c58d30d8915f96ba84f80797ef42'),
             dict(path='../../subprocesses/wrap.py', sha1='8a9b7d2255481fae15c05f5624b0cdc0766f4b3f'),
             dict(path='../../diag/cmds/lslocks.py', sha1='b1e09c9374f9007cb19c2c5009937e7d2f4c0a7b'),
             dict(path='../../diag/cmds/lsof.py', sha1='0a58d3c05ce0038690ce8c5b64dd96e7b21b5853'),
@@ -3700,17 +3700,6 @@ class SubprocessRun:
             async_subprocesses = self._DEFAULT_ASYNC_SUBPROCESSES
         return await check.not_none(async_subprocesses).run_(self.replace(**kwargs))
 
-    _DEFAULT_MAYSYNC_SUBPROCESSES: ta.ClassVar[ta.Optional[ta.Any]] = None  # AbstractMaysyncSubprocesses
-
-    async def maysync_run(
-            self,
-            maysync_subprocesses: ta.Optional[ta.Any] = None,  # AbstractMaysyncSubprocesses
-            **kwargs: ta.Any,
-    ) -> SubprocessRunOutput:
-        if maysync_subprocesses is None:
-            maysync_subprocesses = self._DEFAULT_MAYSYNC_SUBPROCESSES
-        return await check.not_none(maysync_subprocesses).run_(self.replace(**kwargs))
-
 
 SubprocessRun._FIELD_NAMES = frozenset(fld.name for fld in dc.fields(SubprocessRun))  # noqa
 
@@ -3743,13 +3732,6 @@ class SubprocessRunnable(Abstract, ta.Generic[T]):
     ) -> T:
         return self.handle_run_output(await self.make_run().async_run(async_subprocesses, **kwargs))
 
-    async def maysync_run(
-            self,
-            maysync_subprocesses: ta.Optional[ta.Any] = None,  # AbstractMaysyncSubprocesses
-            **kwargs: ta.Any,
-    ) -> T:
-        return self.handle_run_output(await self.make_run().maysync_run(maysync_subprocesses, **kwargs))
-
 
 ########################################
 # ../../../subprocesses/wrap.py