omdev 0.0.51__tar.gz → 0.0.52__tar.gz

{omdev-0.0.51/omdev.egg-info → omdev-0.0.52}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: omdev
-Version: 0.0.51
+Version: 0.0.52
 Summary: omdev
 Author: wrmsr
 License-Expression: BSD-3-Clause
@@ -14,11 +14,11 @@ Classifier: Programming Language :: Python :: 3.15
 Requires-Python: >=3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: omcore==0.0.51
+Requires-Dist: omcore==0.0.52
 Provides-Extra: ominfra
-Requires-Dist: ominfra==0.0.51; extra == "ominfra"
+Requires-Dist: ominfra==0.0.52; extra == "ominfra"
 Provides-Extra: omllm
-Requires-Dist: omllm==0.0.51; extra == "omllm"
+Requires-Dist: omllm==0.0.52; extra == "omllm"
 Provides-Extra: black
 Requires-Dist: black~=26.5; extra == "black"
 Provides-Extra: c
@@ -64,14 +64,14 @@ Requires-Dist: tree-sitter-toml~=0.7; extra == "tui-syntax"
 Requires-Dist: tree-sitter-xml~=0.7; extra == "tui-syntax"
 Requires-Dist: tree-sitter-yaml~=0.7; extra == "tui-syntax"
 Provides-Extra: cext
-Requires-Dist: omdev-cext==0.0.51; extra == "cext"
+Requires-Dist: omdev-cext==0.0.52; extra == "cext"
 Provides-Extra: rs
-Requires-Dist: omdev-rs==0.0.51; extra == "rs"
+Requires-Dist: omdev-rs==0.0.52; extra == "rs"
 Provides-Extra: cli
-Requires-Dist: omdev-cli==0.0.51; extra == "cli"
+Requires-Dist: omdev-cli==0.0.52; extra == "cli"
 Provides-Extra: all
-Requires-Dist: ominfra==0.0.51; extra == "all"
-Requires-Dist: omllm==0.0.51; extra == "all"
+Requires-Dist: ominfra==0.0.52; extra == "all"
+Requires-Dist: omllm==0.0.52; extra == "all"
 Requires-Dist: black~=26.5; extra == "all"
 Requires-Dist: pycparser~=3.0; extra == "all"
 Requires-Dist: pcpp~=1.30; extra == "all"
@@ -104,9 +104,9 @@ Requires-Dist: tree-sitter-sql~=0.3; extra == "all"
 Requires-Dist: tree-sitter-toml~=0.7; extra == "all"
 Requires-Dist: tree-sitter-xml~=0.7; extra == "all"
 Requires-Dist: tree-sitter-yaml~=0.7; extra == "all"
-Requires-Dist: omdev-cext==0.0.51; extra == "all"
-Requires-Dist: omdev-rs==0.0.51; extra == "all"
-Requires-Dist: omdev-cli==0.0.51; extra == "all"
+Requires-Dist: omdev-cext==0.0.52; extra == "all"
+Requires-Dist: omdev-rs==0.0.52; extra == "all"
+Requires-Dist: omdev-cli==0.0.52; extra == "all"
 Dynamic: license-file
 
 # Overview

{omdev-0.0.51 → omdev-0.0.52}/omdev/.om-manifests.json

@@ -319,7 +319,7 @@
     "module": ".scripts.slowcat",
     "attr": "_CLI_MODULE",
     "file": "omdev/scripts/slowcat.py",
-    "line": 117,
+    "line": 120,
     "value": {
       "!.cli.types.CliModule": {
         "name": "slowcat",
@@ -331,7 +331,7 @@
     "module": ".scripts.tmpexec",
     "attr": "_CLI_MODULE",
     "file": "omdev/scripts/tmpexec.py",
-    "line": 50,
+    "line": 53,
     "value": {
       "!.cli.types.CliModule": {
         "name": "tmpexec",

{omdev-0.0.51 → omdev-0.0.52}/omdev/dockerdev/resources/.python-versions.json

@@ -12,8 +12,8 @@
   "14d": "3.14.7d",
   "14t": "3.14.7t",
   "14dt": "3.14.7dt",
-  "15": "3.15.0rc1",
-  "15d": "3.15.0rc1d",
-  "15t": "3.15.0rc1t",
-  "15dt": "3.15.0rc1dt"
+  "15": "3.15.0rc2",
+  "15d": "3.15.0rc2d",
+  "15t": "3.15.0rc2t",
+  "15dt": "3.15.0rc2dt"
 }

omdev-0.0.52/omdev/scripts/ghajunit.py

@@ -0,0 +1,477 @@
+#!/usr/bin/env python3
+# @om-script
+# @om-precheck-allow-any-unicode
+"""
+Pure-stdlib JUnit XML -> GitHub Actions job summary + optional annotations.
+
+====
+
+https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-commands
+"""
+import argparse
+import collections
+import dataclasses as dc
+import glob
+import os
+import pathlib
+import sys
+import typing as ta
+import xml.etree.ElementTree as ET
+
+
+##
+# GitHub Actions helpers
+
+
+def _gha_escape_data(s: object) -> str:
+    # Escaping convention used by the Actions command protocol.
+    return (
+        str(s)
+        .replace('%', '%25')
+        .replace('\r', '%0D')
+        .replace('\n', '%0A')
+    )
+
+
+def _gha_escape_prop(s: object) -> str:
+    return (
+        _gha_escape_data(s)
+        .replace(':', '%3A')
+        .replace(',', '%2C')
+    )
+
+
+def gha_command(name: str, message: str = '', **props: object) -> None:
+    """
+    Emit a GitHub Actions workflow command to stdout.
+
+    Example:
+        gha_command("error", "boom", file="tests/test_foo.py", line=12)
+    """
+
+    prop_s = ''
+    clean_props = {k: v for k, v in props.items() if v is not None and v != ''}
+    if clean_props:
+        prop_s = ' ' + ','.join(
+            f'{k}={_gha_escape_prop(v)}'
+            for k, v in clean_props.items()
+        )
+
+    print(f'::{name}{prop_s}::{_gha_escape_data(message)}', flush=True)
+
+
+def append_step_summary(markdown: str) -> bool:
+    """
+    Append Markdown to GITHUB_STEP_SUMMARY when running in GitHub Actions.
+
+    Returns True if written to the summary file, False if not in GHA.
+    """
+
+    path = os.environ.get('GITHUB_STEP_SUMMARY')
+    if not path:
+        return False
+
+    with open(path, 'a', encoding='utf-8') as f:
+        f.write(markdown)
+        if not markdown.endswith('\n'):
+            f.write('\n')
+    return True
+
+
+##
+# JUnit parsing
+
+
+@dc.dataclass(frozen=True)
+class TestCase:
+    source: pathlib.Path
+    suite: str
+    classname: str
+    name: str
+    time: float
+    status: str  # passed | failure | error | skipped
+    message: str = ''
+    details: str = ''
+    file: str = ''
+    line: int | None = None
+
+    @property
+    def display_name(self) -> str:
+        if self.classname:
+            return f'{self.classname}.{self.name}'
+        return self.name
+
+
+def _local_name(tag: str) -> str:
+    return tag.rsplit('}', 1)[-1]
+
+
+def _float_attr(el: ET.Element, name: str, default: float = 0.0) -> float:
+    try:
+        return float(el.get(name, default))
+    except (TypeError, ValueError):
+        return default
+
+
+def _int_attr_any(el: ET.Element, names: ta.Iterable[str]) -> int | None:
+    for name in names:
+        raw = el.get(name)
+        if raw is None or raw == '':
+            continue
+        try:
+            return int(raw)
+        except ValueError:
+            continue
+    return None
+
+
+def _first_direct_child(el: ET.Element, *names: str) -> ET.Element | None:
+    wanted = set(names)
+    for child in list(el):
+        if _local_name(child.tag) in wanted:
+            return child
+    return None
+
+
+def _all_text(el: ET.Element | None) -> str:
+    if el is None:
+        return ''
+    return ''.join(el.itertext()).strip()
+
+
+def _preview(s: str, n: int = 300) -> str:
+    s = ' '.join(s.split())
+    if len(s) <= n:
+        return s
+    return s[: n - 1] + '…'
+
+
+def iter_testsuites(root: ET.Element) -> ta.Iterator[ET.Element]:
+    if _local_name(root.tag) == 'testsuite':
+        yield root
+
+    for el in root.iter():
+        if el is root:
+            continue
+        if _local_name(el.tag) == 'testsuite':
+            yield el
+
+
+def parse_junit_file(path: pathlib.Path) -> list[TestCase]:
+    root = ET.parse(path).getroot()  # noqa  #  FIXME: defuesedxml?
+    out: list[TestCase] = []
+
+    for suite_el in iter_testsuites(root):
+        suite_name = suite_el.get('name') or path.name
+
+        # JUnit normally has testcases as direct children of testsuite.
+        for tc_el in list(suite_el):
+            if _local_name(tc_el.tag) != 'testcase':
+                continue
+
+            classname = tc_el.get('classname') or ''
+            name = tc_el.get('name') or '<unnamed>'
+            time = _float_attr(tc_el, 'time')
+
+            status = 'passed'
+            problem_el = _first_direct_child(tc_el, 'error')
+            if problem_el is not None:
+                status = 'error'
+            else:
+                problem_el = _first_direct_child(tc_el, 'failure')
+                if problem_el is not None:
+                    status = 'failure'
+                else:
+                    problem_el = _first_direct_child(tc_el, 'skipped')
+                    if problem_el is not None:
+                        status = 'skipped'
+
+            details = _all_text(problem_el)
+            message = ''
+            if problem_el is not None:
+                message = (
+                    problem_el.get('message')
+                    or problem_el.get('type')
+                    or _preview(details)
+                    or status
+                )
+
+            out.append(TestCase(
+                source=path,
+                suite=suite_name,
+                classname=classname,
+                name=name,
+                time=time,
+                status=status,
+                message=message,
+                details=details,
+                file=tc_el.get('file') or '',
+                line=_int_attr_any(tc_el, ('line', 'lineno')),
+            ))
+
+    return out
+
+
+def expand_paths(patterns: list[str]) -> list[pathlib.Path]:
+    paths: list[pathlib.Path] = []
+    for pattern in patterns:
+        matches = glob.glob(pattern, recursive=True)
+        if matches:
+            paths.extend(pathlib.Path(m) for m in matches)
+        else:
+            paths.append(pathlib.Path(pattern))
+
+    seen: set[pathlib.Path] = set()
+    out: list[pathlib.Path] = []
+    for p in paths:
+        p = p.resolve()
+        if p not in seen:
+            seen.add(p)
+            out.append(p)
+    return out
+
+
+##
+# Markdown rendering
+
+
+def md_cell(s: object) -> str:
+    """Escape enough for GitHub Markdown tables."""
+
+    return (
+        str(s)
+        .replace('\\', '\\\\')
+        .replace('|', '\\|')
+        .replace('\r', '')
+        .replace('\n', '<br>')
+    )
+
+
+def fmt_time(seconds: float) -> str:
+    if seconds < 1:
+        return f'{seconds * 1000:.0f} ms'
+    if seconds < 60:
+        return f'{seconds:.2f} s'
+    m, s = divmod(seconds, 60)
+    return f'{int(m)}m {s:.1f}s'
+
+
+def fenced(text: str, lang: str = 'text') -> str:
+    fence = '```'
+    while fence in text:
+        fence += '`'
+    return f'{fence}{lang}\n{text.rstrip()}\n{fence}'
+
+
+def count_status(cases: list[TestCase]) -> dict[str, int]:
+    d = {
+        'passed': 0,
+        'failure': 0,
+        'error': 0,
+        'skipped': 0,
+    }
+    for c in cases:
+        d[c.status] = d.get(c.status, 0) + 1
+    return d
+
+
+def render_summary(
+    cases: list[TestCase],
+    sources: list[pathlib.Path],
+    *,
+    max_failures: int = 25,
+    max_detail_chars: int = 4000,
+) -> str:
+    counts = count_status(cases)
+    total = len(cases)
+    bad = counts['failure'] + counts['error']
+    passed = counts['passed']
+    skipped = counts['skipped']
+    total_time = sum(c.time for c in cases)
+
+    icon = '✅' if bad == 0 else '❌'
+    pass_rate = 100.0 * passed / total if total else 0.0
+
+    lines: list[str] = []
+    lines.append(f'## {icon} Test results')
+    lines.append('')
+    lines.append('| Total | Passed | Failed | Errors | Skipped | Pass rate | Time |')
+    lines.append('|---:|---:|---:|---:|---:|---:|---:|')
+    lines.append(
+        f"| {total} | {passed} | {counts['failure']} | {counts['error']} | "
+        f"{skipped} | {pass_rate:.1f}% | {fmt_time(total_time)} |",
+    )
+    lines.append('')
+
+    if sources:
+        lines.append('<details>')
+        lines.append('<summary>JUnit XML files</summary>')
+        lines.append('')
+        for p in sources:
+            lines.append(f'- `{p}`')
+        lines.append('')
+        lines.append('</details>')
+        lines.append('')
+
+    by_suite: dict[str, list[TestCase]] = collections.defaultdict(list)
+    for c in cases:
+        by_suite[c.suite].append(c)
+
+    if by_suite:
+        lines.append('### Suites')
+        lines.append('')
+        lines.append('| Suite | Total | Passed | Failed | Errors | Skipped | Time |')
+        lines.append('|---|---:|---:|---:|---:|---:|---:|')
+
+        def suite_sort_key(item: tuple[str, list[TestCase]]) -> tuple[int, int, str]:
+            name, suite_cases = item
+            sc = count_status(suite_cases)
+            return (-(sc['failure'] + sc['error']), -len(suite_cases), name)
+
+        for suite, suite_cases in sorted(by_suite.items(), key=suite_sort_key):
+            sc = count_status(suite_cases)
+            lines.append(
+                f"| {md_cell(suite)} | {len(suite_cases)} | {sc['passed']} | "
+                f"{sc['failure']} | {sc['error']} | {sc['skipped']} | "
+                f"{fmt_time(sum(c.time for c in suite_cases))} |",
+            )
+        lines.append('')
+
+    failed_cases = [c for c in cases if c.status in {'failure', 'error'}]
+    if failed_cases:
+        shown = failed_cases[:max_failures]
+
+        lines.append('### Failed tests')
+        lines.append('')
+        lines.append('| Status | Test | Message | Location |')
+        lines.append('|---|---|---|---|')
+
+        for c in shown:
+            location = ''
+            if c.file:
+                location = c.file
+                if c.line:
+                    location += f':{c.line}'
+
+            lines.append(
+                f'| {md_cell(c.status)} | `{md_cell(c.display_name)}` | '
+                f'{md_cell(_preview(c.message, 500))} | {md_cell(location)} |',
+            )
+
+        if len(failed_cases) > len(shown):
+            lines.append('')
+            lines.append(f'_Showing {len(shown)} of {len(failed_cases)} failing tests._')
+
+        lines.append('')
+        lines.append('<details>')
+        lines.append('<summary>Failure details</summary>')
+        lines.append('')
+
+        for c in shown:
+            lines.append(f'#### `{c.display_name}`')
+            lines.append('')
+            if c.file:
+                loc = c.file + (f':{c.line}' if c.line else '')
+                lines.append(f'`{loc}`')
+                lines.append('')
+
+            detail = c.details or c.message
+            if len(detail) > max_detail_chars:
+                detail = detail[:max_detail_chars] + '\n… truncated …'
+
+            lines.append(fenced(detail))
+            lines.append('')
+
+        lines.append('</details>')
+        lines.append('')
+
+    return '\n'.join(lines).rstrip() + '\n'
+
+
+##
+# Annotations
+
+
+def emit_failure_annotations(cases: list[TestCase], *, max_annotations: int) -> None:
+    n = 0
+    for c in cases:
+        if c.status not in {'failure', 'error'}:
+            continue
+        if n >= max_annotations:
+            gha_command(
+                'warning',
+                f'Not emitting further test annotations; hit max_annotations={max_annotations}',
+                title='JUnit summary',
+            )
+            return
+
+        gha_command(
+            'error',
+            c.message or c.status,
+            title=f'{c.status}: {c.display_name}',
+            file=c.file or None,
+            line=c.line,
+        )
+        n += 1
+
+
+##
+# Main
+
+
+def main(argv: list[str]) -> int:
+    ap = argparse.ArgumentParser()
+    ap.add_argument('xml', nargs='+', help='JUnit XML path(s) or glob(s)')
+    ap.add_argument('--annotations', action='store_true')
+    ap.add_argument('--max-annotations', type=int, default=50)
+    ap.add_argument('--max-failures', type=int, default=25)
+    ap.add_argument('--fail-on-failure', action='store_true')
+    ap.add_argument('--allow-missing', action='store_true')
+    ns = ap.parse_args(argv)
+
+    paths = expand_paths(ns.xml)
+    existing = [p for p in paths if p.exists()]
+
+    if not existing:
+        msg = 'No JUnit XML files found: ' + ', '.join(ns.xml)
+        if ns.allow_missing:
+            gha_command('warning', msg, title='JUnit summary')
+            append_step_summary(f'## ⚠️ Test results\n\n{msg}\n')
+            return 0
+        gha_command('error', msg, title='JUnit summary')
+        return 2
+
+    cases: list[TestCase] = []
+    parse_errors: list[tuple[pathlib.Path, Exception]] = []
+
+    for p in existing:
+        try:
+            cases.extend(parse_junit_file(p))
+        except Exception as ex:  # noqa
+            parse_errors.append((p, ex))
+
+    if parse_errors:
+        for p, e in parse_errors:
+            gha_command('error', f'{type(e).__name__}: {e}', title='Failed to parse JUnit XML', file=str(p))
+        return 2
+
+    if ns.annotations:
+        emit_failure_annotations(cases, max_annotations=ns.max_annotations)
+
+    markdown = render_summary(cases, existing, max_failures=ns.max_failures)
+    wrote_summary = append_step_summary(markdown)
+
+    # Useful when running locally.
+    if not wrote_summary:
+        print(markdown)
+
+    counts = count_status(cases)
+    bad = counts['failure'] + counts['error']
+    if ns.fail_on_failure and bad:
+        return 1
+
+    return 0
+
+
+if __name__ == '__main__':
+    raise SystemExit(main(sys.argv[1:]))

{omdev-0.0.51 → omdev-0.0.52}/omdev/scripts/slowcat.py

@@ -12,6 +12,9 @@ import typing as ta
 T = ta.TypeVar('T')
 
 
+##
+
+
 DEFAULT_SLEEP_N = 128
 DEFAULT_SLEEP_S = .5
 

{omdev-0.0.51 → omdev-0.0.52}/omdev/scripts/tmpexec.py

@@ -11,6 +11,9 @@ import sys
 import tempfile
 
 
+##
+
+
 def _main() -> None:
     parser = argparse.ArgumentParser()
     parser.add_argument('-I', '--replstr', default='%')

{omdev-0.0.51 → omdev-0.0.52}/omdev/tui/minitui/README.md

@@ -11,12 +11,12 @@ Built primarily for llm coding-agent chat TUIs, deliberately generalized for any
 ## Try it
 
 ```bash
-./python -m omdev.tui.minitui.apps.chatdemo               # streaming markdown chat: tool cards (f10/f2), /help, history, search
-./python -m omdev.tui.minitui.apps.chatdemo --md=pdcmark  # swap the streaming markdown backend (internal|pdcmark|markdown-it)
-./python -m omdev.tui.minitui.apps.chatdemo --mouse       # + click-to-expand cards / click suggestions (trades wheel scrollback)
-./python -m omdev.tui.minitui.apps.inputdemo              # minimal typing-while-streaming proof
-./python -m omdev.tui.minitui.apps.streamdemo             # the bare commit model, no input
-./python -m omdev.tui.minitui.apps.vimdemo f.py           # fullscreen vim clone (:w/:q, ctrl+v blocks, %/~/zz), tree-sitter highlighted
+./python -m omdev.tui.minitui.tests.apps.chatdemo               # streaming markdown chat: tool cards (f10/f2), /help, history, search
+./python -m omdev.tui.minitui.tests.apps.chatdemo --md=pdcmark  # swap the streaming markdown backend (internal|pdcmark|markdown-it)
+./python -m omdev.tui.minitui.tests.apps.chatdemo --mouse       # + click-to-expand cards / click suggestions (trades wheel scrollback)
+./python -m omdev.tui.minitui.tests.apps.inputdemo              # minimal typing-while-streaming proof
+./python -m omdev.tui.minitui.tests.apps.streamdemo             # the bare commit model, no input
+./python -m omdev.tui.minitui.tests.apps.vimdemo f.py           # fullscreen vim clone (:w/:q, :set nu, ctrl+v blocks, %/~/zz), tree-sitter highlighted
 ```
 
 Run them in tmux and scroll back; add `--visualize-redraws` to streamdemo to watch damage regions.
@@ -42,12 +42,13 @@ Run them in tmux and scroll back; add `--visualize-redraws` to streamdemo to wat
   undo/redo, CMDLINE mode with incremental search, blockwise visual (ctrl+v) with live multi-cursor I/A/c replication,
   `%`/`~`, `status()`/`decorations()` as its only outputs. Never renders, never reads a keyboard.
 - **controls/** - small and passive: `TextArea` (a scrolled vim window - grows to a max height, then the viewport
-  follows the cursor; optional syntax highlighting under engine decorations; ctrl+d/u, zz/zt/zb, H/M/L viewport ops),
-  status bar, statics, spinner, suggestions popup, markdown tail, lifecycle cards, input history, stack layout with
-  mouse hit regions.
+  follows the cursor; optional syntax highlighting under engine decorations; ctrl+d/u, zz/zt/zb, H/M/L viewport ops;
+  vim's line number column), status bar, statics, spinner, suggestions popup, markdown tail, lifecycle cards, input
+  history, stack layout with mouse hit regions.
 - **runtime/** - `SyncDriver` (poll + self-pipe) and `AsyncioDriver` (asyncio; `post()` is the sole thread-safe entry).
   Both share the `App` contract: `render(width, max_height) -> Frame` + `handle_event(event)`, with coalescing
-  invalidation.
+  invalidation. Both do job control: ctrl+z / SIGTSTP hands the terminal back clean before the stop, SIGCONT re-enters
+  application mode and re-anchors the inline origin, and the app sees `SuspendEvent` / `ResumeEvent`.
 
 ## Notes
 

{omdev-0.0.51 → omdev-0.0.52}/omdev/tui/minitui/__init__.py

@@ -47,6 +47,7 @@ with _lang.auto_proxy_init(
     )
 
     from .controls.textarea import (  # noqa
+        LINENR_TAG,
         TextArea,
     )
 
@@ -128,6 +129,8 @@ with _lang.auto_proxy_init(
         MouseEvent,
         FocusEvent,
         ResizeEvent,
+        SuspendEvent,
+        ResumeEvent,
         CursorPositionEvent,
         ModeReportEvent,
         KittyFlagsEvent,
@@ -164,6 +167,10 @@ with _lang.auto_proxy_init(
         App,
     )
 
+    from .runtime.jobcontrol import (  # noqa
+        JobControl,
+    )
+
     from .runtime.sync import (  # noqa
         SyncDriver,
     )