+
+
{{ document.title }}
+
Design by TeaForge.🍵
+
+
+
+
+
+
+
+ | C0 定義 |
+ {{ document.c0_definition }} |
+
+
+ | C1 定義 |
+ {{ document.c1_definition }} |
+
+
+
+
+
カバレッジ概要
+
+
+
+ | 指標 |
+ 割合 |
+ Covered |
+ Total |
+ Missing |
+
+
+
+
+ | C0 (行カバレッジ) |
+ {% if document.c0.applicable %}{{ "%.1f"|format(document.c0.percent) }}%{% else %}N/A{% endif %} |
+ {{ document.c0.covered }} |
+ {{ document.c0.total }} |
+ {{ document.c0.missing }} |
+
+
+ | C1 (分岐カバレッジ) |
+ {% if document.c1.applicable %}{{ "%.1f"|format(document.c1.percent) }}%{% else %}N/A{% endif %} |
+ {{ document.c1.covered }} |
+ {{ document.c1.total }} |
+ {{ document.c1.missing }} |
+
+
+
+
+
関数別ページ一覧
+
+
+
+ | No. |
+ 関数 |
+ 行範囲 |
+ C0 |
+ C1 |
+ ページ |
+ Mermaid |
+
+
+
+ {% for function in document.functions %}
+
+ | {{ loop.index }} |
+ {{ function.name }} |
+ {{ function.lineno }} - {{ function.end_lineno }} |
+ {% if function.c0.applicable %}{{ "%.1f"|format(function.c0.percent) }}%{% else %}N/A{% endif %} |
+ {% if function.c1.applicable %}{{ "%.1f"|format(function.c1.percent) }}%{% else %}N/A{% endif %} |
+
+ {% if function.diagrams %}
+ {% for diagram in function.diagrams %}{{ diagram.page_number }}{% if not loop.last %}, {% endif %}{% endfor %}
+ {% elif function.page_number %}{{ function.page_number }}{% else %}-{% endif %}
+ |
+
+ {% if function.diagrams %}
+ {% for diagram in function.diagrams %}{{ diagram.kind }}: {{ diagram.mermaid_path }}{% if not loop.last %}
{% endif %}{% endfor %}
+ {% elif function.diagram_included %}{{ function.mermaid_path }}{% else %}Not requested{% endif %}
+ |
+
+ {% endfor %}
+
+
+
+ {% if not document.requested_functions %}
+
業務図
+
+
+
+ | 状態 |
+ このレポートはカバレッジ概要のみです。必要な業務関数だけ `--function` を指定してフロー図を、`--sequence` を指定してシーケンス図を追加してください。 |
+
+
+
+ {% endif %}
+
+
+
+ {% else %}
+
+ {% endif %}
+
+
{{ document.title }} - {{ function.name.split('.')[-1] }}
+
Design by TeaForge.🍵
+
+
+
+
+
関数別カバレッジ
+
+
+
+ | 指標 |
+ 割合 |
+ Covered |
+ Total |
+ Missing |
+
+
+
+
+ | C0 (行カバレッジ) |
+ {% if function.c0.applicable %}{{ "%.1f"|format(function.c0.percent) }}%{% else %}N/A{% endif %} |
+ {{ function.c0.covered }} |
+ {{ function.c0.total }} |
+ {{ function.c0.missing }} |
+
+
+ | C1 (分岐カバレッジ) |
+ {% if function.c1.applicable %}{{ "%.1f"|format(function.c1.percent) }}%{% else %}N/A{% endif %} |
+ {{ function.c1.covered }} |
+ {{ function.c1.total }} |
+ {{ function.c1.missing }} |
+
+
+
+
+
未カバー詳細
+
+
+
+ | 未カバー行 |
+
+ {% if function.missing_lines %}
+ {{ function.missing_lines|join(", ") }}
+ {% else %}
+ なし
+ {% endif %}
+ |
+
+
+ | 未カバー分岐 |
+
+ {% if function.missing_branches %}
+ {{ function.missing_branches|join(", ") }}
+ {% else %}
+ なし
+ {% endif %}
+ |
+
+
+
+
+
{% if diagram.kind == "sequence" %}シーケンス図{% else %}ロジックフロー図{% endif %}
+
+
+
+
+
+
+ {% endfor %}
+ {% endfor %}
+
+
+
+
+
diff --git a/src/teaforge/templates/pcl.html b/src/teaforge/templates/pcl.html
new file mode 100644
index 0000000..5b00223
--- /dev/null
+++ b/src/teaforge/templates/pcl.html
@@ -0,0 +1,460 @@
+
+
+
+
+
+
+
{{ document.title }}
+
+
+
+
+
+
+
{{ document.title }}
+
Design by TeaForge.🍵
+
+
+
+
+
テストケース一覧
+
+
+
+ | 番号 |
+ コード |
+ 区分 |
+ テストケース |
+ テスト名 |
+ 実施日 |
+ Bug No. |
+
+
+
+ {% for case in case_columns %}
+
+ | {{ case.index }} |
+ {{ case.testcasecode }} |
+ {{ case.type }} |
+ {{ case.testcase }} |
+ {{ case.testname }} |
+ {{ case.executed_date }} |
+ {{ case.bug_number }} |
+
+ {% endfor %}
+
+
+
+ {% if runtime_cases %}
+
Jest 実行証拠
+
+
+
+ | コード |
+ 実行テスト名 |
+ 状態 |
+ Matcher |
+ 期待値 |
+ 実際値 |
+ エラー |
+
+
+
+ {% for case in runtime_cases %}
+ {% for evidence in case.assertion_evidence %}
+
+ | {{ case.testcasecode }} |
+ {{ case.runtime_test_name }} |
+
+ {% if evidence.passed %}PASS{% else %}FAIL{% endif %}
+ |
+ {% if evidence.negated %}not.{% endif %}{{ evidence.matcher }} |
+ {{ evidence.expected|join(", ") }} |
+ {{ evidence.actual }} |
+ {{ evidence.error }} |
+
+ {% endfor %}
+ {% endfor %}
+
+
+ {% endif %}
+
+ {% if frontend_cases %}
+
前端ページUT補足
+
+
+
+ | 番号 |
+ コード |
+ 画面名 |
+ 入口URL |
+ 確認方法 |
+ 前提条件 |
+ 操作入力 |
+ 画面出力 |
+ 遷移出力 |
+
+
+
+ {% for case in frontend_cases %}
+
+ | {{ case.index }} |
+ {{ case.testcasecode }} |
+ {{ case.screen_name }} |
+ {{ case.entry_url }} |
+ {% if case.verification_mode %}{{ case.verification_mode }}{% endif %} |
+
+ {% if case.preconditions %}
+
+ {% for item in case.preconditions %}
+ - {{ item }}
+ {% endfor %}
+
+ {% endif %}
+ |
+
+ {% if case.input_actions %}
+
+ {% for item in case.input_actions %}
+ - {{ item }}
+ {% endfor %}
+
+ {% endif %}
+ |
+
+ {% if case.ui_outputs %}
+
+ {% for item in case.ui_outputs %}
+ - {{ item }}
+ {% endfor %}
+
+ {% endif %}
+ |
+
+ {% if case.navigation_outputs %}
+
+ {% for item in case.navigation_outputs %}
+ - {{ item }}
+ {% endfor %}
+
+ {% endif %}
+ |
+
+ {% endfor %}
+
+
+ {% endif %}
+
+
判定表
+
+
+
+ | テスト項目番号 |
+ {% for case in decision_columns %}
+ {{ loop.index }} |
+ {% endfor %}
+
+
+
+ {% for row in input_rows %}
+
+ {% if loop.first %}
+ | 条件 |
+ {% endif %}
+ {% if row.show_item %}
+ {{ row.item }} |
+ {% endif %}
+ {{ row.value }} |
+ {% for case in decision_columns %}
+ {% if case and row["values"].get(case.testcasecode) %}◯{% endif %} |
+ {% endfor %}
+
+ {% endfor %}
+
+ {% for row in output_rows %}
+
+ {% if loop.first %}
+ | 結果 |
+ {% endif %}
+ {% if row.show_item %}
+ {{ row.item }} |
+ {% endif %}
+ {{ row.value }} |
+ {% for case in decision_columns %}
+ {% if case and row["values"].get(case.testcasecode) %}◯{% endif %} |
+ {% endfor %}
+
+ {% endfor %}
+
+
+
+
記入欄
+
+
+
+ | 実施日 |
+ |
+ 担当者 |
+ |
+
+
+ | レビュー |
+ |
+ 備考 |
+ |
+
+
+
+
+
+
+
+
+
+
+
diff --git a/tests/conftest.py b/tests/conftest.py
new file mode 100644
index 0000000..46701aa
--- /dev/null
+++ b/tests/conftest.py
@@ -0,0 +1,2 @@
+# This directory is an external target-project fixture with its own pytest root.
+collect_ignore = ["fixtures/coverage_project/tests/test_app.py"]
diff --git a/tests/fixtures/coverage_project/app.py b/tests/fixtures/coverage_project/app.py
new file mode 100644
index 0000000..8f777bc
--- /dev/null
+++ b/tests/fixtures/coverage_project/app.py
@@ -0,0 +1,2 @@
+def double(value: int) -> int:
+ return value * 2
diff --git a/tests/fixtures/coverage_project/pyproject.toml b/tests/fixtures/coverage_project/pyproject.toml
new file mode 100644
index 0000000..80abd51
--- /dev/null
+++ b/tests/fixtures/coverage_project/pyproject.toml
@@ -0,0 +1,6 @@
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.coverage.run]
+relative_files = true
+source = ["unrelated_target"]
diff --git a/tests/fixtures/coverage_project/tests/test_app.py b/tests/fixtures/coverage_project/tests/test_app.py
new file mode 100644
index 0000000..58fb70b
--- /dev/null
+++ b/tests/fixtures/coverage_project/tests/test_app.py
@@ -0,0 +1,5 @@
+from app import double
+
+
+def test_double():
+ assert double(3) == 6
diff --git a/tests/test_artifacts.py b/tests/test_artifacts.py
new file mode 100644
index 0000000..2ba2d81
--- /dev/null
+++ b/tests/test_artifacts.py
@@ -0,0 +1,44 @@
+from pathlib import Path
+
+import pytest
+
+import teaforge.artifacts as artifacts_module
+from teaforge.artifacts import json_for_html_script, write_text_atomic
+
+
+def test_json_for_html_script_preserves_data_without_closing_script_element():
+ serialized = json_for_html_script(
+ {"test": "", "separator": "\u2028"}
+ )
+
+ assert "" not in serialized
+ assert "\\u003c/script\\u003e" in serialized
+ assert "\\u2028" in serialized
+
+
+def test_atomic_write_replaces_complete_artifact(tmp_path):
+ target = tmp_path / "report.json"
+ target.write_text("old", encoding="utf-8")
+
+ write_text_atomic(target, "new content")
+
+ assert target.read_text(encoding="utf-8") == "new content"
+ assert list(tmp_path.glob(".report.json.*.tmp")) == []
+
+
+def test_atomic_write_preserves_old_artifact_when_replace_fails(
+ tmp_path, monkeypatch
+):
+ target = tmp_path / "report.html"
+ target.write_text("valid old report", encoding="utf-8")
+
+ def fail_replace(source: Path, destination: Path) -> None:
+ raise OSError("disk refused replacement")
+
+ monkeypatch.setattr(artifacts_module.os, "replace", fail_replace)
+
+ with pytest.raises(OSError, match="disk refused replacement"):
+ write_text_atomic(target, "partial new report")
+
+ assert target.read_text(encoding="utf-8") == "valid old report"
+ assert list(tmp_path.glob(".report.html.*.tmp")) == []
diff --git a/tests/test_cli_integration.py b/tests/test_cli_integration.py
index 386f489..2f18272 100644
--- a/tests/test_cli_integration.py
+++ b/tests/test_cli_integration.py
@@ -1,12 +1,27 @@
+import json
from pathlib import Path
+import pytest
from typer.testing import CliRunner
+from teaforge import __version__
from teaforge.cli import app
+from teaforge.coverage.service import (
+ CoverageThresholdError,
+ CoverageThresholdViolation,
+)
+from teaforge.pcl.models import PCLDocument
runner = CliRunner()
+def test_version_option_matches_package_version():
+ result = runner.invoke(app, ["--version"])
+
+ assert result.exit_code == 0
+ assert result.stdout.strip() == __version__
+
+
def test_generate_and_get_commands(tmp_path):
html_path = tmp_path / "pcl.html"
source = Path("tests/fixtures/test_sample_pytest.py")
@@ -170,3 +185,141 @@ def test_generate_pcl_rejects_unknown_framework(tmp_path):
assert result.exit_code == 1
assert "Unsupported framework: unknown" in result.stderr
+
+
+def test_generate_pcl_reports_missing_custom_template_without_traceback(tmp_path):
+ missing_template = tmp_path / "missing-template.html"
+
+ result = runner.invoke(
+ app,
+ [
+ "pcl",
+ "generate",
+ "--path",
+ "tests/fixtures/test_sample_pytest.py",
+ "--output",
+ str(tmp_path / "pcl.html"),
+ "--template",
+ str(missing_template),
+ ],
+ )
+
+ assert result.exit_code == 1
+ assert "PCL template does not exist" in result.stderr
+ assert "Traceback" not in result.stderr
+
+
+def test_runtime_report_returns_distinct_exit_code_when_jest_tests_failed(
+ tmp_path, monkeypatch
+):
+ html_path = tmp_path / "pcl.html"
+ json_path = tmp_path / "pcl.json"
+ document = PCLDocument.create(
+ file="user.js",
+ method="createUser",
+ source_path="src/user.js",
+ )
+ document.evidence_mode = "runtime"
+ document.runtime_exit_code = 1
+ document.runtime_tests_passed = False
+ html_path.write_text("", encoding="utf-8")
+ json_path.write_text(
+ json.dumps(document.to_dict(), ensure_ascii=False),
+ encoding="utf-8",
+ )
+ monkeypatch.setattr(
+ "teaforge.cli.generate_pcl",
+ lambda **kwargs: [(html_path, json_path)],
+ )
+
+ result = runner.invoke(
+ app,
+ [
+ "pcl",
+ "generate",
+ "--framework",
+ "jest",
+ "--evidence-mode",
+ "runtime",
+ "--path",
+ "tests/fixtures/test_sample_jest.test.ts",
+ "--output",
+ str(html_path),
+ ],
+ )
+
+ assert result.exit_code == 2
+ assert "Reports were generated with failure evidence" in result.stderr
+
+ accepted = runner.invoke(
+ app,
+ [
+ "pcl",
+ "generate",
+ "--framework",
+ "jest",
+ "--evidence-mode",
+ "runtime",
+ "--allow-test-failures",
+ "--path",
+ "tests/fixtures/test_sample_jest.test.ts",
+ "--output",
+ str(html_path),
+ ],
+ )
+
+ assert accepted.exit_code == 0
+
+
+def test_pcl_document_rejects_unknown_future_schema():
+ document = PCLDocument.create(
+ file="user.py",
+ method="create_user",
+ source_path="src/user.py",
+ )
+ payload = document.to_dict()
+ payload["schema_version"] = 999
+
+ with pytest.raises(ValueError, match="Unsupported PCL schema version: 999"):
+ PCLDocument.from_dict(payload)
+
+
+def test_coverage_gate_preserves_report_and_returns_exit_code_three(
+ tmp_path, monkeypatch
+):
+ output = tmp_path / "coverage.html"
+ output.write_text("coverage report", encoding="utf-8")
+
+ def fail_gate(**_kwargs):
+ raise CoverageThresholdError(
+ [output],
+ [
+ CoverageThresholdViolation(
+ output_path=output,
+ metric="C1",
+ actual=75.0,
+ required=100.0,
+ )
+ ],
+ )
+
+ monkeypatch.setattr("teaforge.cli.generate_coverage_reports", fail_gate)
+
+ result = runner.invoke(
+ app,
+ [
+ "coverage",
+ "generate",
+ "--path",
+ "demo/fastapi_crud/tests",
+ "--output",
+ str(output),
+ "--min-c1",
+ "100",
+ ],
+ )
+
+ assert result.exit_code == 3
+ assert output.exists()
+ assert f"Generated coverage HTML: {output}" in result.stdout
+ assert "C1 75.0% is below the required 100.0%" in result.stderr
diff --git a/tests/test_coverage_report.py b/tests/test_coverage_report.py
index d496b16..7d320ab 100644
--- a/tests/test_coverage_report.py
+++ b/tests/test_coverage_report.py
@@ -7,13 +7,193 @@
from typer.testing import CliRunner
from teaforge.cli import app
+from teaforge.coverage import mermaid as mermaid_module
from teaforge.coverage import service as coverage_service
-from teaforge.coverage.analyzer import parse_source_functions
+from teaforge.coverage.analyzer import analyze_coverage
from teaforge.coverage.mermaid import save_mermaid_diagram
+from teaforge.coverage.models import CoverageDocument, CoverageMetric
+from teaforge.coverage.render import render_coverage_html
+from teaforge.coverage.service import find_coverage_threshold_violations
+from teaforge.jest.coverage import _collect_branch_sets
+from teaforge.jest.project import JestProject
runner = CliRunner()
+def test_coverage_embedded_json_cannot_close_its_script_element():
+ document = CoverageDocument.create(
+ file=".py",
+ source_path="src/app.py",
+ test_path="tests/test_app.py",
+ c0=CoverageMetric(covered=1, total=1, percent=100.0),
+ c1=CoverageMetric(covered=0, total=0, percent=0.0),
+ requested_functions=[],
+ functions=[],
+ evidence_source="coverage.py JSON",
+ c0_definition="covered statements / measurable statements",
+ c1_definition="executed branches / measurable branches",
+ )
+
+ html = render_coverage_html(document)
+ embedded_json = html.split(
+ '", 1)[0]
+
+ assert "