testql 0.5.2__tar.gz → 0.6.2__tar.gz

{testql-0.5.2 → testql-0.6.2}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: testql
-Version: 0.5.2
-Summary: TestQL with endpoint detection, OpenAPI, and SUMD generation
+Version: 0.6.2
+Summary: TestQL with endpoint detection, OpenAPI, SUMD generation, SUMD parser and HTML report generation
 License-Expression: Apache-2.0
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -30,16 +30,16 @@ Dynamic: license-file
 
 ## AI Cost Tracking
 
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$2.40-green) ![AI Model](https://img.shields.io/badge/AI%20Model-openrouter%2Fqwen%2Fqwen3-coder-next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.6.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-$2.70-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-17.2h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-This project uses AI-generated code. Total cost: **$2.4000** with **16** AI commits.
+- 🤖 **LLM usage:** $2.7000 (18 commits)
+- 👤 **Human dev:** ~$1715 (17.2h @ $100/h, 30min dedup)
 
-Generated on 2026-04-18 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/models/openrouter/qwen/qwen3-coder-next)
+Generated on 2026-04-19 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-
-
 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.
 
 ## Installation

{testql-0.5.2 → testql-0.6.2}/README.md

@@ -3,16 +3,16 @@
 
 ## AI Cost Tracking
 
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$2.40-green) ![AI Model](https://img.shields.io/badge/AI%20Model-openrouter%2Fqwen%2Fqwen3-coder-next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.6.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-$2.70-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-17.2h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-This project uses AI-generated code. Total cost: **$2.4000** with **16** AI commits.
+- 🤖 **LLM usage:** $2.7000 (18 commits)
+- 👤 **Human dev:** ~$1715 (17.2h @ $100/h, 30min dedup)
 
-Generated on 2026-04-18 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/models/openrouter/qwen/qwen3-coder-next)
+Generated on 2026-04-19 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-
-
 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.
 
 ## Installation

{testql-0.5.2 → testql-0.6.2}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "testql"
-version = "0.5.2"
-description = "TestQL with endpoint detection, OpenAPI, and SUMD generation"
+version = "0.6.2"
+description = "TestQL with endpoint detection, OpenAPI, SUMD generation, SUMD parser and HTML report generation"
 readme = "README.md"
 requires-python = ">=3.10"
 license = "Apache-2.0"

{testql-0.5.2 → testql-0.6.2}/testql/__init__.py

@@ -1,3 +1,3 @@
 """TestQL — Interface Query Language for GUI/API/encoder testing."""
 
-__version__ = "0.5.2"
+__version__ = "0.6.2"

testql-0.6.2/testql/cli.py

@@ -0,0 +1,41 @@
+"""TestQL CLI — run .testql.toon.yaml scenarios from the command line."""
+
+from __future__ import annotations
+
+import click
+
+from testql.commands.endpoints_cmd import endpoints, openapi
+from testql.commands.generate_cmd import analyze, generate
+from testql.commands.misc_cmds import create, echo, from_sumd, init, report, watch
+from testql.commands.run_cmd import run
+from testql.commands.suite_cmd import list_tests, suite
+
+
+@click.group()
+@click.version_option(version="0.2.0")
+def cli():
+    """TestQL — Interface Query Language for Testing."""
+    pass
+
+
+cli.add_command(run)
+cli.add_command(generate)
+cli.add_command(analyze)
+cli.add_command(endpoints)
+cli.add_command(openapi)
+cli.add_command(suite)
+cli.add_command(list_tests, name="list")
+cli.add_command(init)
+cli.add_command(create)
+cli.add_command(watch)
+cli.add_command(from_sumd)
+cli.add_command(report)
+cli.add_command(echo)
+
+def main():
+    """Entry point for console script."""
+    cli()
+
+
+if __name__ == "__main__":
+    main()

testql-0.6.2/testql/commands/__init__.py

@@ -0,0 +1,27 @@
+"""TestQL commands package."""
+
+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.misc_cmds import create
+from testql.commands.misc_cmds import echo as cli_echo
+from testql.commands.misc_cmds import from_sumd, init, report, watch
+from testql.commands.run_cmd import run
+from testql.commands.suite_cmd import list_tests, suite
+
+__all__ = [
+    "echo",
+    "cli_echo",
+    "endpoints",
+    "openapi",
+    "analyze",
+    "generate",
+    "create",
+    "from_sumd",
+    "init",
+    "report",
+    "watch",
+    "run",
+    "list_tests",
+    "suite",
+]

testql-0.6.2/testql/commands/endpoints_cmd.py

@@ -0,0 +1,137 @@
+"""CLI commands: testql endpoints, testql openapi — endpoint detection & OpenAPI generation."""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+import click
+
+
+@click.command()
+@click.argument("path", type=click.Path(exists=True), default=".")
+@click.option("--format", "fmt", type=click.Choice(["table", "json", "csv"]), default="table")
+@click.option("--framework", help="Filter by framework (fastapi, flask, django, express)")
+@click.option("--type", "endpoint_type", help="Filter by type (rest, graphql, websocket)")
+@click.option("--output", "-o", type=click.Path(), help="Save to file")
+def endpoints(
+    path: str,
+    fmt: str,
+    framework: str | None,
+    endpoint_type: str | None,
+    output: str | None,
+) -> None:
+    """List all detected API endpoints in a project."""
+    import csv
+    import io
+    import json
+
+    from testql.endpoint_detector import UnifiedEndpointDetector
+
+    target_path = Path(path)
+    detector = UnifiedEndpointDetector(target_path)
+    eps = detector.detect_all()
+
+    if framework:
+        eps = [ep for ep in eps if ep.framework == framework]
+    if endpoint_type:
+        eps = [ep for ep in eps if ep.endpoint_type == endpoint_type]
+
+    if not eps:
+        click.echo("❌ No endpoints detected")
+        sys.exit(1)
+
+    output_str = _format_endpoints(eps, fmt, target_path, detector)
+
+    if output:
+        Path(output).write_text(output_str)
+        click.echo(f"✅ Saved {len(eps)} endpoints to {output}")
+    else:
+        click.echo(output_str)
+
+
+def _format_endpoints(eps, fmt: str, target_path: Path, detector) -> str:
+    import csv
+    import io
+    import json
+
+    if fmt == "json":
+        data = [
+            {
+                "path": ep.path,
+                "method": ep.method,
+                "framework": ep.framework,
+                "type": ep.endpoint_type,
+                "handler": ep.handler_name,
+                "file": str(ep.source_file.relative_to(target_path)) if ep.source_file else None,
+                "line": ep.line_number,
+                "summary": ep.summary,
+            }
+            for ep in eps
+        ]
+        return json.dumps(data, indent=2)
+
+    if fmt == "csv":
+        buf = io.StringIO()
+        writer = csv.writer(buf)
+        writer.writerow(["method", "path", "framework", "type", "handler", "file", "line", "summary"])
+        for ep in eps:
+            writer.writerow([
+                ep.method,
+                ep.path,
+                ep.framework,
+                ep.endpoint_type,
+                ep.handler_name or "",
+                str(ep.source_file.relative_to(target_path)) if ep.source_file else "",
+                ep.line_number,
+                ep.summary or "",
+            ])
+        return buf.getvalue()
+
+    lines = [f"{'Method':<8} {'Path':<40} {'Framework':<12} {'Handler':<30}", "-" * 90]
+    for ep in eps:
+        handler = ep.handler_name or "-"
+        if len(handler) > 28:
+            handler = handler[:25] + "..."
+        ep_path = ep.path if len(ep.path) < 38 else ep.path[:35] + "..."
+        lines.append(f"{ep.method:<8} {ep_path:<40} {ep.framework:<12} {handler:<30}")
+    lines.append("")
+    lines.append(f"Total: {len(eps)} endpoints (detectors: {', '.join(detector.detectors_used)})")
+    return "\n".join(lines)
+
+
+@click.command()
+@click.argument("path", type=click.Path(exists=True), default=".")
+@click.option("--output", "-o", type=click.Path(), help="Output file (default: openapi.yaml)")
+@click.option("--format", type=click.Choice(["yaml", "json"]), default="yaml", help="Output format")
+@click.option("--title", help="API title (default: project name)")
+@click.option("--version", default="1.0.0", help="API version")
+@click.option("--contract-tests", is_flag=True, help="Also generate contract tests")
+def openapi(
+    path: str,
+    output: str | None,
+    format: str,
+    title: str | None,
+    version: str,
+    contract_tests: bool,
+) -> None:
+    """Generate OpenAPI spec from detected endpoints."""
+    from testql.openapi_generator import ContractTestGenerator, OpenAPIGenerator
+
+    target_path = Path(path)
+    generator = OpenAPIGenerator(target_path)
+
+    click.echo(f"🔍 Detecting endpoints in {target_path}...")
+    spec = generator.generate(title=title, version=version)
+
+    out_path = Path(output) if output else target_path / f"openapi.{format}"
+    generator.save(out_path, format)
+    click.echo(f"✅ OpenAPI spec saved: {out_path}")
+    click.echo(f"   Endpoints: {len(spec.paths)}")
+    click.echo(f"   Format: {format}")
+
+    if contract_tests:
+        test_file = out_path.parent / "testql-contracts.testql.toon.yaml"
+        contract_gen = ContractTestGenerator(spec)
+        contract_gen.generate_contract_tests(test_file)
+        click.echo(f"✅ Contract tests saved: {test_file}")

testql-0.6.2/testql/commands/generate_cmd.py

@@ -0,0 +1,140 @@
+"""CLI commands: testql generate, testql analyze — project test generation."""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+import click
+
+
+@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 any((target_path / d).exists() for d in ["doql", "oql", "oqlos", "testql", "weboql", "www"]):
+        click.echo(f"🔄 Analyzing workspace: {target_path}")
+        gen = MultiProjectTestGenerator(target_path)
+        profiles = gen.analyze_all()
+
+        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()
+
+        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)
+
+        click.echo(f"\n✅ Generated {len(generated)} test files:")
+        for f in generated:
+            click.echo(f"  • {f}")
+
+    sys.exit(0)
+
+
+@click.command()
+@click.argument("path", type=click.Path(exists=True), default=".")
+def analyze(path: str) -> None:
+    """Analyze project structure and show testability report."""
+    from testql.generator import TestGenerator
+
+    target_path = Path(path)
+    gen = TestGenerator(target_path)
+    profile = gen.analyze()
+
+    click.echo(f"\n📁 Project: {profile.name}")
+    click.echo(f"📂 Path: {profile.root_path}")
+    click.echo(f"🔧 Type: {profile.project_type}")
+    click.echo("\n📊 Discovered Files:")
+
+    for category, files in sorted(profile.discovered_files.items()):
+        click.echo(f"  • {category}: {len(files)} files")
+
+    click.echo(f"\n🧪 Test Patterns Found: {len(profile.test_patterns)}")
+    for pattern in profile.test_patterns[:10]:
+        click.echo(f"  • {pattern.name} ({pattern.pattern_type})")
+    if len(profile.test_patterns) > 10:
+        click.echo(f"  ... and {len(profile.test_patterns) - 10} more")
+
+    _print_routes_section(profile)
+    _print_scenarios_section(profile)
+
+
+def _print_routes_section(profile) -> None:
+    if not profile.config.get("discovered_routes"):
+        return
+
+    routes = profile.config["discovered_routes"]
+    frameworks = profile.config.get("endpoint_frameworks", [])
+
+    click.echo(f"\n🌐 API Routes Discovered: {len(routes)}")
+    if frameworks:
+        click.echo(f"   Detectors used: {', '.join(frameworks)}")
+
+    routes_by_fw: dict[str, int] = {}
+    routes_by_type: dict[str, int] = {}
+    for route in routes:
+        fw = route.get("framework", "unknown")
+        et = route.get("endpoint_type", "rest")
+        routes_by_fw[fw] = routes_by_fw.get(fw, 0) + 1
+        routes_by_type[et] = routes_by_type.get(et, 0) + 1
+
+    if routes_by_fw:
+        click.echo("   By Framework:")
+        for fw, count in sorted(routes_by_fw.items(), key=lambda x: -x[1]):
+            click.echo(f"     • {fw}: {count} endpoints")
+
+    if len(routes_by_type) > 1:
+        click.echo("   By Type:")
+        for et, count in routes_by_type.items():
+            click.echo(f"     • {et}: {count}")
+
+    click.echo("   Sample Endpoints:")
+    for route in routes[:8]:
+        fw = route.get("framework", "?")
+        handler = route.get("handler", "")
+        info = f"{route['method']} {route['path']}"
+        if handler:
+            info += f" → {handler}"
+        click.echo(f"     • [{fw}] {info}")
+    if len(routes) > 8:
+        click.echo(f"     ... and {len(routes) - 8} more")
+
+
+def _print_scenarios_section(profile) -> None:
+    if not profile.config.get("scenario_patterns"):
+        return
+    scenarios = profile.config["scenario_patterns"]
+    click.echo(f"\n⚙️ OQL/CQL Scenarios: {len(scenarios)}")
+    for s in scenarios[:5]:
+        click.echo(f"  • {s['name']}")