forgeqe-cli 2.2.1__py3-none-any.whl → 2.2.2__py3-none-any.whl

forgeqe_cli/__init__.py

@@ -4,4 +4,4 @@ The agent itself is the npm package ``@capagents/forgeqe`` (OpenTUI + Bun).
 This distribution only puts a ``forgeqe`` command on PATH.
 """
 
-__version__ = "2.2.1"
+__version__ = "2.2.2"

forgeqe_cli/pytest_plugin.py

@@ -0,0 +1,132 @@
+"""ForgeQE plugin for pytest: an HTML report after every run, from the terminal, an IDE's test runner, or CI.
+
+pytest loads it by itself from the forgeqe-cli wheel (the pytest11 entry point). It is on in a folder with
+forgeqe.yaml or .forgeqe/, or with ``pytest --forgeqe-report`` or FORGEQE_REPORT=1; FORGEQE_REPORT=0 turns it off.
+At the end of the run it writes the results, with each failure's message and traceback, to
+.pytest_cache/forgeqe/results.json and runs ``forgeqe report`` on it.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import re
+import subprocess
+import sys
+import tempfile
+import time
+from datetime import datetime, timezone
+from pathlib import Path
+
+ANSI = re.compile(r"\x1b\[[0-9;]*[A-Za-z]")
+
+
+def _clean(text: str) -> str:
+    return ANSI.sub("", text or "")
+
+
+def pytest_addoption(parser):
+    parser.getgroup("forgeqe").addoption(
+        "--forgeqe-report", action="store_true", default=False, help="write a ForgeQE HTML report after the run"
+    )
+
+
+def _active(config) -> bool:
+    flag = os.environ.get("FORGEQE_REPORT")
+    if flag == "0":
+        return False
+    if flag == "1" or config.getoption("forgeqe_report", False):
+        return True
+    root = Path(str(config.rootpath))
+    return (root / "forgeqe.yaml").exists() or (root / ".forgeqe").is_dir()
+
+
+def pytest_configure(config):
+    # An xdist worker sends its results to the controller, which writes the one report.
+    if hasattr(config, "workerinput") or not _active(config):
+        return
+    config.pluginmanager.register(_Collector(config), "forgeqe-collector")
+
+
+def _message(report) -> str:
+    crash = getattr(getattr(report, "longrepr", None), "reprcrash", None)
+    text = crash.message if crash is not None else str(getattr(report, "longrepr", "") or "")
+    first = next((line.strip() for line in _clean(text).splitlines() if line.strip()), "")
+    return first[:300]
+
+
+class _Collector:
+    def __init__(self, config):
+        self.config = config
+        self.tests: dict[str, dict] = {}
+        self.started = datetime.now(timezone.utc)
+        self.t0 = time.monotonic()
+        self.line = ""
+
+    def pytest_runtest_logreport(self, report):
+        nodeid = report.nodeid
+        test = self.tests.setdefault(
+            nodeid, {"name": " › ".join(nodeid.split("::")), "status": "passed", "seconds": 0.0, "file": report.location[0]}
+        )
+        if report.outcome == "rerun":
+            # pytest-rerunfailures: a failure that is run again; passing later makes the test flaky, not failed.
+            test["rerun"] = True
+            test.setdefault("message", _message(report))
+            test.setdefault("details", _clean(report.longreprtext))
+            return
+        test["seconds"] = round(test["seconds"] + (report.duration or 0), 3)
+        if report.failed:
+            if test["status"] != "failed":
+                test["message"] = _message(report)
+                test["details"] = _clean(report.longreprtext)
+            test["status"] = "failed"
+        elif report.skipped and test["status"] == "passed" and report.when in ("setup", "call"):
+            test["status"] = "skipped"
+
+    def pytest_sessionfinish(self, session):
+        if not self.tests:
+            return
+        tests = []
+        for test in self.tests.values():
+            rerun = test.pop("rerun", False)
+            if test["status"] == "passed" and rerun:
+                test["flaky"] = True
+            elif test["status"] != "failed" and not test.get("flaky"):
+                test.pop("message", None)
+                test.pop("details", None)
+            tests.append({k: v for k, v in test.items() if v not in ("", None)})
+        doc = {
+            "format": "forgeqe-results",
+            "version": 1,
+            "framework": "pytest",
+            "startedAt": self.started.isoformat(),
+            "ms": round((time.monotonic() - self.t0) * 1000),
+            "command": " ".join(["pytest", *self.config.invocation_params.args])[:500],
+            "tests": tests,
+        }
+        cache = getattr(self.config, "cache", None)
+        folder = Path(cache.mkdir("forgeqe")) if cache is not None else Path(tempfile.mkdtemp(prefix="forgeqe-"))
+        path = folder / "results.json"
+        path.write_text(json.dumps(doc, indent=2) + "\n", encoding="utf-8")
+        self.line = _report(path, Path(str(self.config.rootpath)))
+
+    def pytest_terminal_summary(self, terminalreporter):
+        if self.line:
+            terminalreporter.write_line(self.line)
+
+
+def _report(path: Path, root: Path) -> str:
+    """Run forgeqe report on the results; the line to show."""
+    # This wheel's own launcher, by the Python running pytest: no PATH lookup and no .cmd shim on Windows.
+    bin_ = os.environ.get("FORGEQE_BIN")
+    cmd = [bin_, "report", str(path)] if bin_ else [sys.executable, "-m", "forgeqe_cli", "report", str(path)]
+    try:
+        run = subprocess.run(cmd, cwd=str(root), capture_output=True, text=True, timeout=300)
+    except (OSError, subprocess.TimeoutExpired) as exc:
+        return f"ForgeQE: no report ({exc.__class__.__name__}). Build it with: forgeqe report {path}"
+    # forgeqe report exits 1 when a test failed: that is a report, not an error.
+    line = next((l for l in _clean(run.stdout).splitlines() if l.startswith("Report")), "") if run.returncode <= 1 else ""
+    if line:
+        return "ForgeQE report: " + line[len("Report"):].strip()
+    why = (_clean(run.stderr).strip().splitlines() or ["it did not finish"])[-1]
+    return f"ForgeQE: no report ({why}). Build it with: forgeqe report {path}"

{forgeqe_cli-2.2.1.dist-info → forgeqe_cli-2.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forgeqe-cli
-Version: 2.2.1
+Version: 2.2.2
 Summary: pip launcher for the ForgeQE browser agent (npm package: @capagents/forgeqe)
 Author: CLI-Agents
 License: MIT

forgeqe_cli-2.2.2.dist-info/RECORD

@@ -0,0 +1,10 @@
+forgeqe_cli/__init__.py,sha256=P8v4jSY_ROSVD98F0zQcv49wFe88He6hTop3NqlqJrg,200
+forgeqe_cli/__main__.py,sha256=frkRQzq1Cd7HI3aiw0W0eJ-w1r8VkXOJrv0wIR-on9Y,46
+forgeqe_cli/launcher.py,sha256=GKmbo1W4xpNz2I3smM0CXGbnAYRdwhrX8Pe48Gr4kgs,6413
+forgeqe_cli/pytest_plugin.py,sha256=f_hH2JXv059oJwHBBdR-TZAhuFYqM2LMr6vAAcRpC5o,5570
+forgeqe_cli-2.2.2.dist-info/licenses/LICENSE,sha256=Z_3_KODt79ZZl4nLelIVBSsVsL6AhEypl7HouMkKjYA,3079
+forgeqe_cli-2.2.2.dist-info/METADATA,sha256=LB2sIwF4wFAVpWvZgpbo42iftHYyk4fXcQDbnDBkQ84,50190
+forgeqe_cli-2.2.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+forgeqe_cli-2.2.2.dist-info/entry_points.txt,sha256=KphefM5TY2MOIbABNg2UJJQsEZUZgrNM4ZD3lrIphVg,139
+forgeqe_cli-2.2.2.dist-info/top_level.txt,sha256=YrCSJdE_QY2GlHw_tgRYsQpZ1cSiIejC9swAUcRLpD8,12
+forgeqe_cli-2.2.2.dist-info/RECORD,,

{forgeqe_cli-2.2.1.dist-info → forgeqe_cli-2.2.2.dist-info}/entry_points.txt

@@ -1,3 +1,6 @@
 [console_scripts]
 forgeqe = forgeqe_cli.launcher:main
 webpilot = forgeqe_cli.launcher:main
+
+[pytest11]
+forgeqe = forgeqe_cli.pytest_plugin

forgeqe_cli-2.2.1.dist-info/RECORD

@@ -1,9 +0,0 @@
-forgeqe_cli/__init__.py,sha256=RuUCEANfbsqtwHS91AF7Tut7cJrNq7Ui3h50bGu6aXk,200
-forgeqe_cli/__main__.py,sha256=frkRQzq1Cd7HI3aiw0W0eJ-w1r8VkXOJrv0wIR-on9Y,46
-forgeqe_cli/launcher.py,sha256=GKmbo1W4xpNz2I3smM0CXGbnAYRdwhrX8Pe48Gr4kgs,6413
-forgeqe_cli-2.2.1.dist-info/licenses/LICENSE,sha256=Z_3_KODt79ZZl4nLelIVBSsVsL6AhEypl7HouMkKjYA,3079
-forgeqe_cli-2.2.1.dist-info/METADATA,sha256=RmpSV-v_5NpO2Gnc-0fi5ur1IUjwAc6vfkWwhZvEmqo,50190
-forgeqe_cli-2.2.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-forgeqe_cli-2.2.1.dist-info/entry_points.txt,sha256=1IHZSsCnhKZfoCBsdScd7pRKwRzQ5bruc1Nk_FA5SI4,91
-forgeqe_cli-2.2.1.dist-info/top_level.txt,sha256=YrCSJdE_QY2GlHw_tgRYsQpZ1cSiIejC9swAUcRLpD8,12
-forgeqe_cli-2.2.1.dist-info/RECORD,,