testql 1.2.2__tar.gz → 1.2.4__tar.gz

{testql-1.2.2 → testql-1.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: testql
-Version: 1.2.2
+Version: 1.2.4
 Summary: TestQL — Multi-DSL Test Platform: TestTOON / NL / SQL / Proto / GraphQL adapters with Unified IR, generator engine, and meta-testing
 License-Expression: Apache-2.0
 Requires-Python: >=3.10
@@ -40,11 +40,11 @@ Dynamic: license-file
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-1.2.2-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$6.60-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-27.9h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-1.2.4-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$6.75-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-27.9h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $6.6000 (44 commits)
-- 👤 **Human dev:** ~$2786 (27.9h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $6.7500 (45 commits)
+- 👤 **Human dev:** ~$2791 (27.9h @ $100/h, 30min dedup)
 
 Generated on 2026-04-25 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
@@ -52,7 +52,7 @@ Generated on 2026-04-25 using [openrouter/qwen/qwen3-coder-next](https://openrou
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-testql-blue) ![Version](https://img.shields.io/badge/version-1.2.2-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-testql-blue) ![Version](https://img.shields.io/badge/version-1.2.4-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 
 TestQL is a declarative DSL (Domain Specific Language) for testing GUI, REST API, and hardware encoder interfaces. It provides a simple, readable syntax for writing automated tests without programming overhead.
 
@@ -150,11 +150,22 @@ Example:
 examples/web-inspection-dot-testql/run.sh https://tom.sapletta.com/
 ```
 
+Current capabilities:
+
+- **Asset classification**: script, stylesheet, image, icon, preload, link.
+- **Bounded link validation**: HEAD checks for all internal links (up to 100).
+- **Bounded asset validation**: HEAD checks for all extracted assets.
+- **Broken resource detection**: assets or links returning error status are flagged as findings.
+- **Bounded sitemap crawl**: fetches up to 10 internal subpages, extracts titles and link counts, adds `subpage` nodes to the topology.
+- **Sitemap checks**: crawl coverage, broken subpage detection, duplicate title warnings.
+- **Playwright browser inspection** (`--browser`): renders the page in a headless browser, captures console errors, network calls (REST/GraphQL/WebSocket), and JS-rendered DOM.
+- **Browser checks**: render detection, console error count, network call capture.
+
 Current limitations:
 
 - Browser execution is not yet Playwright-backed.
 - JavaScript-rendered DOM is not evaluated yet.
-- Links/assets are extracted but not individually fetched and validated yet.
+- Per-resource validation uses HEAD requests only; full page content is not fetched for linked pages.
 - Console errors, screenshots, performance, accessibility, REST/GraphQL/WebSocket network logs, and auth flows are planned next.
 
 ## API Endpoint Detection

{testql-1.2.2 → testql-1.2.4}/README.md

@@ -3,11 +3,11 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-1.2.2-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$6.60-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-27.9h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-1.2.4-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$6.75-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-27.9h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $6.6000 (44 commits)
-- 👤 **Human dev:** ~$2786 (27.9h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $6.7500 (45 commits)
+- 👤 **Human dev:** ~$2791 (27.9h @ $100/h, 30min dedup)
 
 Generated on 2026-04-25 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
@@ -15,7 +15,7 @@ Generated on 2026-04-25 using [openrouter/qwen/qwen3-coder-next](https://openrou
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-testql-blue) ![Version](https://img.shields.io/badge/version-1.2.2-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-testql-blue) ![Version](https://img.shields.io/badge/version-1.2.4-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 
 TestQL is a declarative DSL (Domain Specific Language) for testing GUI, REST API, and hardware encoder interfaces. It provides a simple, readable syntax for writing automated tests without programming overhead.
 
@@ -113,11 +113,22 @@ Example:
 examples/web-inspection-dot-testql/run.sh https://tom.sapletta.com/
 ```
 
+Current capabilities:
+
+- **Asset classification**: script, stylesheet, image, icon, preload, link.
+- **Bounded link validation**: HEAD checks for all internal links (up to 100).
+- **Bounded asset validation**: HEAD checks for all extracted assets.
+- **Broken resource detection**: assets or links returning error status are flagged as findings.
+- **Bounded sitemap crawl**: fetches up to 10 internal subpages, extracts titles and link counts, adds `subpage` nodes to the topology.
+- **Sitemap checks**: crawl coverage, broken subpage detection, duplicate title warnings.
+- **Playwright browser inspection** (`--browser`): renders the page in a headless browser, captures console errors, network calls (REST/GraphQL/WebSocket), and JS-rendered DOM.
+- **Browser checks**: render detection, console error count, network call capture.
+
 Current limitations:
 
 - Browser execution is not yet Playwright-backed.
 - JavaScript-rendered DOM is not evaluated yet.
-- Links/assets are extracted but not individually fetched and validated yet.
+- Per-resource validation uses HEAD requests only; full page content is not fetched for linked pages.
 - Console errors, screenshots, performance, accessibility, REST/GraphQL/WebSocket network logs, and auth flows are planned next.
 
 ## API Endpoint Detection

{testql-1.2.2 → testql-1.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "testql"
-version = "1.2.2"
+version = "1.2.4"
 description = "TestQL — Multi-DSL Test Platform: TestTOON / NL / SQL / Proto / GraphQL adapters with Unified IR, generator engine, and meta-testing"
 readme = "README.md"
 requires-python = ">=3.10"

{testql-1.2.2 → testql-1.2.4}/testql/__init__.py

@@ -6,4 +6,4 @@ external artifacts into IR; meta-testing (`testql.meta`) analyses the
 generated plans for coverage, confidence and mutation resilience.
 """
 
-__version__ = "1.2.2"
+__version__ = "1.2.4"

{testql-1.2.2 → testql-1.2.4}/testql/adapters/sql/sql_adapter.py

@@ -37,7 +37,7 @@ from testql.interpreter._testtoon_parser import (
     ToonSection,
     parse_testtoon as _parse_testtoon,
 )
-from testql.ir import Assertion, Fixture, ScenarioMetadata, SqlStep, Step, TestPlan
+from testql.ir import Assertion, Capture, Fixture, ScenarioMetadata, SqlStep, Step, TestPlan
 
 from ..base import BaseDSLAdapter, DSLDetectionResult, SourceLike, read_source
 from .dialect_resolver import DEFAULT_DIALECT, normalize_dialect
@@ -170,11 +170,25 @@ def _h_assert(section: ToonSection, plan: TestPlan,
     plan.steps.extend(_assert_section(section, {s.name: s for s in sql_steps if s.name}))
 
 
+def _h_capture(section: ToonSection, plan: TestPlan,
+               sql_steps: list[SqlStep], dialect: str) -> None:
+    """Attach `Capture`s to SqlSteps by `query` name (matches assert lookup style)."""
+    by_name = {s.name: s for s in sql_steps if s.name}
+    for row in section.rows:
+        target = str(row.get("query", "") or row.get("step", "")).strip()
+        var = str(row.get("var", "")).strip()
+        from_path = str(row.get("from", "")).strip()
+        owner = by_name.get(target)
+        if owner is not None and var and from_path:
+            owner.captures.append(Capture(var_name=var, from_path=from_path))
+
+
 _SECTION_HANDLERS = {
     "CONFIG": _h_config,
     "SCHEMA": _h_schema,
     "QUERY": _h_query,
     "ASSERT": _h_assert,
+    "CAPTURE": _h_capture,
 }
 
 
@@ -246,6 +260,22 @@ def _render_asserts(plan: TestPlan) -> list[str]:
     return lines
 
 
+def _render_captures(plan: TestPlan) -> list[str]:
+    """Emit `CAPTURE[N]{query, var, from}` rows referencing the SqlStep name."""
+    rows: list[tuple[str, str, str]] = []
+    for s in plan.steps:
+        if not isinstance(s, SqlStep) or not s.name:
+            continue
+        for c in s.captures:
+            rows.append((s.name, c.var_name, c.from_path))
+    if not rows:
+        return []
+    lines = [f"CAPTURE[{len(rows)}]" + "{query, var, from}:"]
+    for q, var, frm in rows:
+        lines.append(f"  {q}, {var}, {frm}")
+    return lines
+
+
 def _render_plan(plan: TestPlan) -> str:
     parts = _render_meta(plan.metadata)
     if parts:
@@ -254,6 +284,7 @@ def _render_plan(plan: TestPlan) -> str:
     parts.extend(_render_schema(plan))
     parts.extend(_render_queries(plan))
     parts.extend(_render_asserts(plan))
+    parts.extend(_render_captures(plan))
     return "\n".join(parts) + ("\n" if parts else "")
 
 

{testql-1.2.2 → testql-1.2.4}/testql/adapters/testtoon_adapter.py

@@ -20,6 +20,7 @@ from testql.interpreter._testtoon_parser import (
 from testql.ir import (
     ApiStep,
     Assertion,
+    Capture,
     EncoderStep,
     GuiStep,
     ScenarioMetadata,
@@ -46,7 +47,9 @@ def _api_section_to_steps(section: ToonSection) -> list[Step]:
         ak, av = row.get("assert_key"), row.get("assert_value") or row.get("assert_val")
         if ak and av:
             asserts.append(Assertion(field=str(ak), op="==", expected=av))
+        name = str(row.get("name", "")).strip() or None
         steps.append(ApiStep(
+            name=name,
             method=str(row.get("method", "GET")).upper(),
             path=str(row.get("endpoint", "/")),
             expect_status=int(status) if isinstance(status, (int, str)) and str(status).isdigit() else None,
@@ -95,6 +98,36 @@ def _assert_section_to_steps(section: ToonSection) -> list[Step]:
     return [Step(kind="assert", name="ASSERT", asserts=asserts)]
 
 
+def _capture_section_apply(section: ToonSection, plan: TestPlan) -> None:
+    """`CAPTURE[N]{step, var, from}` rows attach `Capture`s to existing plan steps.
+
+    `step` matches `Step.name` if non-numeric; otherwise it is treated as a
+    1-based index into `plan.steps`. Unresolved references are silently dropped
+    (mirrors the orphan-assert behaviour of `_assert_section_to_steps`).
+    """
+    by_name = {s.name: s for s in plan.steps if s.name}
+    for row in section.rows:
+        target = str(row.get("step", "")).strip()
+        var_name = str(row.get("var", "")).strip()
+        from_path = str(row.get("from", "")).strip()
+        if not (target and var_name and from_path):
+            continue
+        owner = _resolve_capture_target(target, by_name, plan.steps)
+        if owner is not None:
+            owner.captures.append(Capture(var_name=var_name, from_path=from_path))
+
+
+def _resolve_capture_target(target: str, by_name: dict[str, Step],
+                            steps: list[Step]) -> Step | None:
+    if target in by_name:
+        return by_name[target]
+    if target.isdigit():
+        idx = int(target) - 1
+        if 0 <= idx < len(steps):
+            return steps[idx]
+    return None
+
+
 def _generic_section_to_steps(section: ToonSection) -> list[Step]:
     """Fallback for section types we don't yet model in the IR (FLOW, OQL, ...)."""
     steps: list[Step] = []
@@ -129,10 +162,16 @@ def _toon_to_plan(toon: ToonScript) -> TestPlan:
         extra={k: v for k, v in toon.meta.items() if k not in {"scenario", "type", "version", "lang"}},
     )
     plan = TestPlan(metadata=md)
+    capture_sections: list[ToonSection] = []
     for section in toon.sections:
+        if section.type == "CAPTURE":
+            capture_sections.append(section)  # apply after all steps are loaded
+            continue
         steps, cfg = _translate_section(section)
         plan.steps.extend(steps)
         plan.config.update(cfg)
+    for section in capture_sections:
+        _capture_section_apply(section, plan)
     return plan
 
 
@@ -204,6 +243,24 @@ def _render_assertions(steps: list[Step]) -> list[str]:
     return lines
 
 
+def _render_captures(steps: list[Step]) -> list[str]:
+    """Emit a `CAPTURE[N]{step, var, from}` section for any step with captures.
+
+    Uses the 1-based step index so round-trip is lossless even when the API
+    renderer (which has fixed columns) doesn't emit step names.
+    """
+    rows: list[tuple[str, str, str]] = []
+    for idx, step in enumerate(steps, start=1):
+        for c in step.captures:
+            rows.append((str(idx), c.var_name, c.from_path))
+    if not rows:
+        return []
+    lines = [f"CAPTURE[{len(rows)}]" + "{step, var, from}:"]
+    for step_ref, var, frm in rows:
+        lines.append(f"  {step_ref}, {var}, {frm}")
+    return lines
+
+
 def _render_plan(plan: TestPlan) -> str:
     """Lossy renderer covering CONFIG / API / NAVIGATE / ENCODER / ASSERT.
 
@@ -223,6 +280,7 @@ def _render_plan(plan: TestPlan) -> str:
     encoder_steps = [s for s in plan.steps if isinstance(s, EncoderStep)]
     parts.extend(_render_encoder_steps(encoder_steps))
     parts.extend(_render_assertions(plan.steps))
+    parts.extend(_render_captures(plan.steps))
     return "\n".join(parts) + ("\n" if parts else "")
 
 

{testql-1.2.2 → testql-1.2.4}/testql/cli.py

@@ -8,6 +8,7 @@ from testql.commands.discover_cmd import discover
 from testql.commands.endpoints_cmd import endpoints, openapi
 from testql.commands.generate_cmd import analyze, generate
 from testql.commands.generate_ir_cmd import generate_ir
+from testql.commands.generate_topology_cmd import generate_topology
 from testql.commands.inspect_cmd import inspect
 from testql.commands.misc_cmds import create, echo, from_sumd, init, report, watch
 from testql.commands.run_cmd import run
@@ -27,6 +28,7 @@ def cli():
 cli.add_command(run)
 cli.add_command(run_ir)
 cli.add_command(generate)
+cli.add_command(generate_topology)
 cli.add_command(generate_ir)
 cli.add_command(discover)
 cli.add_command(topology)

{testql-1.2.2 → testql-1.2.4}/testql/commands/__init__.py

@@ -4,6 +4,7 @@ from testql.commands.discover_cmd import discover
 from testql.commands.echo import echo
 from testql.commands.endpoints_cmd import endpoints, openapi
 from testql.commands.generate_cmd import analyze, generate
+from testql.commands.generate_topology_cmd import generate_topology
 from testql.commands.inspect_cmd import inspect
 from testql.commands.misc_cmds import create
 from testql.commands.misc_cmds import echo as cli_echo
@@ -22,6 +23,7 @@ __all__ = [
     "openapi",
     "analyze",
     "generate",
+    "generate_topology",
     "create",
     "from_sumd",
     "init",

{testql-1.2.2 → testql-1.2.4}/testql/commands/generate_cmd.py

@@ -7,75 +7,88 @@ from pathlib import Path
 
 import click
 
+from testql.pipeline import GenerationPipeline
+
 
 def _is_workspace(target_path: Path) -> bool:
-    """True only when target_path is a monorepo workspace, not a single Python project."""
-    # If it has its own pyproject.toml, it's a standalone project
-    if (target_path / "pyproject.toml").exists() or (target_path / "setup.py").exists():
-        return False
-    workspace_dirs = ["doql", "oql", "oqlos", "testql", "weboql", "www"]
-    return any(
-        (target_path / d).exists() and not (target_path / d / "__init__.py").exists()
-        for d in workspace_dirs
-    )
+    """Backward-compat re-export — delegates to GenerationPipeline."""
+    return GenerationPipeline._is_workspace(target_path)  # type: ignore[arg-type]
 
 
-@click.command()
-@click.argument("path", type=click.Path(exists=True), default=".")
-@click.option("--output-dir", "-o", help="Output directory for generated tests")
-@click.option("--analyze-only", is_flag=True, help="Only analyze, don't generate")
-@click.option("--format", "fmt", type=click.Choice(["testql", "json"]), default="testql")
-def generate(path: str, output_dir: str | None, analyze_only: bool, fmt: str) -> None:
-    """Generate TestQL scenarios from project structure."""
-    from testql.generator import TestGenerator, MultiProjectTestGenerator
-
-    target_path = Path(path)
-
-    if _is_workspace(target_path):
+def _echo_analysis(ctx, target_path: Path) -> None:
+    if ctx.is_workspace:
         click.echo(f"🔄 Analyzing workspace: {target_path}")
-        gen = MultiProjectTestGenerator(target_path)
-        profiles = gen.analyze_all()
-
+        profiles = ctx.workspace_profiles
         click.echo(f"📊 Discovered {len(profiles)} projects:")
         for name, profile in profiles.items():
             click.echo(f"  • {name}: {profile.project_type}")
             click.echo(f"    - Test patterns: {len(profile.test_patterns)}")
             click.echo(f"    - Config files: {len(profile.config)}")
-
-        if analyze_only:
-            return
-
-        results = gen.generate_all()
-        total = sum(len(files) for files in results.values())
-        click.echo(f"\n✅ Generated {total} test files across {len(results)} projects")
-
-        cross_file = gen.generate_cross_project_tests(target_path / "testql-scenarios")
-        click.echo(f"🌐 Cross-project tests: {cross_file}")
-
     else:
         click.echo(f"🔄 Analyzing project: {target_path}")
-        gen = TestGenerator(target_path)
-        profile = gen.analyze()
-        if profile is None:
-            profile = gen.profile
-
+        profile = ctx.profile
         click.echo(f"📊 Project type: {profile.project_type}")
         click.echo(f"📊 Test patterns: {len(profile.test_patterns)}")
         click.echo(f"📊 Discovered files: {sum(len(v) for v in profile.discovered_files.values())}")
 
-        if analyze_only:
-            return
-
-        out_dir = Path(output_dir) if output_dir else None
-        generated = gen.generate_tests(out_dir)
 
+def _echo_generation(ctx, generated: list[Path]) -> None:
+    if ctx.is_workspace:
+        click.echo(f"\n✅ Generated {len(generated)} test files")
+    else:
         click.echo(f"\n✅ Generated {len(generated)} test files:")
         for f in generated:
             click.echo(f"  • {f}")
 
+
+@click.command()
+@click.argument("path", type=click.Path(exists=True), default=".")
+@click.option("--output-dir", "-o", help="Output directory for generated tests")
+@click.option("--analyze-only", is_flag=True, help="Only analyze, don't generate")
+@click.option("--format", "fmt", type=click.Choice(["testql", "json"]), default="testql")
+@click.option("--to-ir", is_flag=True, help="Parse generated TestTOON into IR JSON")
+def generate(path: str, output_dir: str | None, analyze_only: bool, fmt: str, to_ir: bool) -> None:
+    """Generate TestQL scenarios from project structure."""
+    from testql.pipeline import GenerationPipeline
+
+    target_path = Path(path)
+    pipeline = GenerationPipeline(target_path)
+    ctx = pipeline._collect()
+    _echo_analysis(ctx, target_path)
+
+    if analyze_only:
+        return
+
+    out_dir = Path(output_dir) if output_dir else None
+    generated = pipeline.run(output_dir=out_dir, analyze_only=False)
+    _echo_generation(ctx, generated)
+
+    if to_ir and generated:
+        _emit_ir_json(generated, fmt)
+
     sys.exit(0)
 
 
+def _emit_ir_json(paths: list[Path], fmt: str) -> None:
+    """Parse each generated TestTOON file into IR and re-emit as JSON."""
+    import json
+    from testql.adapters.testtoon_adapter import TestToonAdapter
+
+    adapter = TestToonAdapter()
+    for p in paths:
+        if not str(p).endswith(".testql.toon.yaml"):
+            continue
+        try:
+            plan = adapter.parse(str(p))
+            ir_path = p.with_suffix("").with_suffix(".ir.json")
+            ir_path.write_text(
+                json.dumps(plan.to_dict(), indent=2, default=str), encoding="utf-8"
+            )
+            click.echo(f"  📦 IR: {ir_path}")
+        except Exception as exc:
+            click.echo(f"  ⚠️  IR conversion failed for {p}: {exc}")
+
+
 @click.command()
 @click.argument("path", type=click.Path(exists=True), default=".")
 def analyze(path: str) -> None:

testql-1.2.4/testql/commands/generate_topology_cmd.py

@@ -0,0 +1,58 @@
+"""CLI: testql generate-topology — convert topology traces to executable scenarios."""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+import click
+
+from testql.topology import build_topology
+from testql.topology.generator import TopologyScenarioGenerator
+
+
+@click.command(name="generate-topology")
+@click.argument("source", type=click.Path(exists=True), default=".")
+@click.option("--trace-id", "-t", help="Trace ID to convert (default: first trace)")
+@click.option("--output", "-o", type=click.Path(), help="Output file path")
+@click.option("--format", "fmt", type=click.Choice(["testtoon", "ir-json"]), default="testtoon")
+@click.option("--scan-network", is_flag=True, help="Include live network scanning")
+def generate_topology(source: str, trace_id: str | None, output: str | None, fmt: str, scan_network: bool) -> None:
+    """Generate an executable scenario from a topology trace."""
+    import json
+
+    topology = build_topology(source, scan_network=scan_network)
+
+    trace = _pick_trace(topology, trace_id)
+    if trace is None:
+        click.echo(f"❌ No trace found (requested: {trace_id or 'first'})")
+        sys.exit(1)
+
+    gen = TopologyScenarioGenerator(topology)
+    plan = gen.from_trace(trace)
+
+    if fmt == "testtoon":
+        content = gen.to_testtoon(plan)
+    else:
+        content = json.dumps(plan.to_dict(), indent=2, default=str) + "\n"
+
+    if output:
+        out_path = Path(output)
+        out_path.parent.mkdir(parents=True, exist_ok=True)
+        out_path.write_text(content, encoding="utf-8")
+        click.echo(f"✅ Written {out_path}")
+    else:
+        click.echo(content, nl=False)
+
+    sys.exit(0)
+
+
+def _pick_trace(topology, trace_id: str | None):
+    if not topology.traces:
+        return None
+    if trace_id is None:
+        return topology.traces[0]
+    return next((t for t in topology.traces if t.id == trace_id), None)
+
+
+__all__ = ["generate_topology"]

{testql-1.2.2 → testql-1.2.4}/testql/commands/inspect_cmd.py

@@ -12,12 +12,13 @@ from testql.results import inspect_source, render_inspection, render_refactor_pl
 @click.option("--format", "fmt", type=click.Choice(["toon", "yaml", "json", "nlp"]), default="toon")
 @click.option("--artifact", type=click.Choice(["inspection", "result", "refactor-plan"]), default="inspection")
 @click.option("--scan-network", is_flag=True, help="Enable network probes for URL sources")
+@click.option("--browser", is_flag=True, help="Enable Playwright browser probe for URL sources")
 @click.option("--out-dir", type=click.Path(file_okay=False, dir_okay=True), default=None, help="Write full inspection bundle, e.g. .testql")
-def inspect(source: str, fmt: str, artifact: str, scan_network: bool, out_dir: str | None) -> None:
+def inspect(source: str, fmt: str, artifact: str, scan_network: bool, browser: bool, out_dir: str | None) -> None:
     source_path = Path(source)
     if not source.startswith(("http://", "https://")) and not source_path.exists():
         raise click.ClickException(f"source does not exist: {source}")
-    topology, envelope, plan = inspect_source(source, scan_network=scan_network)
+    topology, envelope, plan = inspect_source(source, scan_network=scan_network, use_browser=browser)
     if out_dir:
         written = write_inspection_artifacts(topology, envelope, plan, out_dir)
         click.echo(f"wrote {len(written)} files to {out_dir}")

testql-1.2.4/testql/discovery/probes/browser/__init__.py

@@ -0,0 +1,7 @@
+"""Browser probes using Playwright."""
+
+from __future__ import annotations
+
+from .playwright_page import PlaywrightPageProbe
+
+__all__ = ["PlaywrightPageProbe"]