coverage.py
покрыто: 84 из 11672.4%
1"""Покрытие тестами без внешних зависимостей: ``sys.monitoring`` + HTML-сайт.23Запускает pytest программно, ловит события LINE и раскладывает результат в4статический сайт: индекс со сводкой и страницу на каждый файл с подсветкой5покрытых и пропущенных строк.6"""78from __future__ import annotations910import ast11import json12import sys13from dataclasses import dataclass, field14from pathlib import Path15from typing import Any, Iterable, Sequence1617TOOL_ID = 418TOOL_NAME = "sql-lint-coverage"192021@dataclass22class Collector:23 """Собирает исполненные строки только для файлов приложения.2425 Для чужих файлов обработчик возвращает ``sys.monitoring.DISABLE``: событие26 для этой строки больше не приходит, иначе pytest с его миллионами строк27 замедляет прогон в десятки раз.28 """2930 root: Path31 hits: dict[str, set[int]] = field(default_factory=dict)32 active: bool = False33 exclude: tuple[str, ...] = ("tests",)3435 def _own(self, filename: Path) -> bool:36 try:37 relative: Path | None = filename.relative_to(self.root.resolve())38 except ValueError:39 relative = None40 return relative is not None and not any(part in self.exclude for part in relative.parts)4142 def _callback(self, code: Any, line: int) -> Any:43 filename = Path(code.co_filename).resolve()44 if self._own(filename):45 self.hits.setdefault(str(filename), set()).add(line)46 return sys.monitoring.DISABLE4748 def start(self) -> None:49 monitor = sys.monitoring50 monitor.use_tool_id(TOOL_ID, TOOL_NAME)51 monitor.register_callback(TOOL_ID, monitor.events.LINE, self._callback)52 monitor.set_events(TOOL_ID, monitor.events.LINE)53 self.active = True5455 def stop(self) -> None:56 if not self.active:57 return58 monitor = sys.monitoring59 monitor.set_events(TOOL_ID, 0)60 monitor.register_callback(TOOL_ID, monitor.events.LINE, None)61 monitor.free_tool_id(TOOL_ID)62 self.active = False636465def executable_lines(source: str) -> set[int]:66 try:67 tree: ast.AST | None = ast.parse(source)68 except SyntaxError:69 tree = None70 nodes = ast.walk(tree) if tree is not None else []71 return {node.lineno for node in nodes if isinstance(node, ast.stmt)}727374def percent(covered: int, total: int) -> float:75 return round(100.0 * covered / total, 1) if total else 100.0767778def file_report(path: Path, hits: Iterable[int]) -> dict:79 source = path.read_text(encoding="utf-8")80 statements = executable_lines(source)81 covered = statements & set(hits)82 return {83 "file": str(path),84 "source": source,85 "statements": sorted(statements),86 "covered": sorted(covered),87 "missing": sorted(statements - covered),88 "total": len(statements),89 "hit": len(covered),90 "percent": percent(len(covered), len(statements)),91 }929394def collect_files(root: Path, hits: dict[str, set[int]]) -> list[dict]:95 reports: list[dict] = []96 for raw, lines in sorted(hits.items()):97 path = Path(raw)98 if path.suffix == ".py" and path.exists():99 reports.append(file_report(path, lines))100 return reports101102103def _bar(value: float) -> str:104 width = max(0, min(100, int(round(value))))105 color = "#6ee7b7" if value >= 85 else "#fbbf24" if value >= 60 else "#f87171"106 return (107 f'<span class="bar"><span style="width:{width}%;background:{color}"></span></span>'108 f'<span class="pct">{value:.1f}%</span>'109 )110111112PAGE = """<!DOCTYPE html>113<html lang="ru"><head><meta charset="utf-8">114<meta name="viewport" content="width=device-width, initial-scale=1">115<title>{title}</title>116<style>117 body {{ margin:0; background:#0b1220; color:#e6edf7; font-family:"Segoe UI",Roboto,Arial,sans-serif; line-height:1.55; }}118 .wrap {{ width:min(1080px,94vw); margin:0 auto; padding:26px 0 48px; }}119 h1 {{ font-size:24px; margin:0 0 6px; }}120 .muted {{ color:#93a4bd; font-size:13.5px; }}121 table {{ width:100%; border-collapse:collapse; margin-top:18px; font-size:13.5px; }}122 th, td {{ text-align:left; padding:8px 10px; border-bottom:1px solid #24344c; }}123 th {{ color:#93a4bd; font-weight:600; font-size:12px; text-transform:uppercase; letter-spacing:.05em; }}124 a {{ color:#6ee7b7; text-decoration:none; }}125 a:hover {{ text-decoration:underline; }}126 .bar {{ display:inline-block; width:150px; height:8px; background:#1b2b41; border-radius:4px; overflow:hidden; vertical-align:middle; }}127 .bar span {{ display:block; height:100%; }}128 .pct {{ font-family:ui-monospace,Consolas,monospace; font-size:12px; margin-left:8px; }}129 pre {{ margin:0; padding:14px 16px; background:#0e1626; border:1px solid #24344c; border-radius:12px;130 font-family:ui-monospace,Consolas,monospace; font-size:12.5px; overflow:auto; }}131 .ln {{ display:block; }}132 .ln.hit {{ background:rgba(110,231,183,.10); }}133 .ln.miss {{ background:rgba(248,113,113,.16); }}134 .num {{ display:inline-block; width:42px; color:#5b6c85; user-select:none; }}135 .stat {{ display:flex; gap:18px; flex-wrap:wrap; margin-top:10px; font-family:ui-monospace,Consolas,monospace; font-size:12.5px; color:#93a4bd; }}136 .stat b {{ color:#e6edf7; }}137</style></head><body><div class="wrap">138{body}139</div></body></html>140"""141142143def render_file_page(report: dict) -> str:144 covered = set(report["covered"])145 missing = set(report["missing"])146 lines: list[str] = []147 for number, text in enumerate(report["source"].splitlines(), start=1):148 css = "hit" if number in covered else "miss" if number in missing else ""149 lines.append(f'<span class="ln {css}"><span class="num">{number}</span>{_escape(text)}</span>')150 body = (151 f'<h1>{_escape(Path(report["file"]).name)}</h1>'152 f'<div class="stat"><span>покрыто: <b>{report["hit"]}</b> из <b>{report["total"]}</b></span>'153 f'<span>{_bar(report["percent"])}</span></div>'154 f'<pre>{"".join(lines)}</pre>'155 '<p class="muted"><a href="index.html">← ко всем файлам</a></p>'156 )157 return PAGE.format(title=f'Покрытие — {Path(report["file"]).name}', body=body)158159160def render_index(reports: Sequence[dict]) -> str:161 total = sum(item["total"] for item in reports)162 covered = sum(item["hit"] for item in reports)163 rows = "".join(164 f'<tr><td><a href="{page_name(item["file"])}">{_escape(item["file"])}</a></td>'165 f'<td>{item["total"]}</td><td>{item["hit"]}</td><td>{_bar(item["percent"])}</td></tr>'166 for item in reports167 )168 body = (169 "<h1>Покрытие тестами · sql-lint</h1>"170 f'<div class="muted">Собрано собственным сборщиком на <code>sys.monitoring</code>, без внешних зависимостей.</div>'171 f'<div class="stat"><span>файлов: <b>{len(reports)}</b></span>'172 f'<span>операторов: <b>{total}</b></span><span>покрыто: <b>{covered}</b></span>'173 f'<span>итого: <b>{percent(covered, total):.1f}%</b></span></div>'174 '<table><thead><tr><th>файл</th><th>операторов</th><th>покрыто</th><th>покрытие</th></tr></thead>'175 f"<tbody>{rows}</tbody></table>"176 )177 return PAGE.format(title="Покрытие тестами — sql-lint", body=body)178179180def _escape(text: str) -> str:181 return text.replace("&", "&").replace("<", "<").replace(">", ">")182183184def page_name(file: str) -> str:185 return Path(file).name.replace(".py", "") + ".html"186187188def build_site(reports: Sequence[dict], target: Path) -> Path:189 target.mkdir(parents=True, exist_ok=True)190 for report in reports:191 (target / page_name(report["file"])).write_text(render_file_page(report), encoding="utf-8")192 (target / "index.html").write_text(render_index(reports), encoding="utf-8")193 summary = [194 {key: value for key, value in report.items() if key != "source"}195 for report in reports196 ]197 (target / "coverage.json").write_text(json.dumps(summary, ensure_ascii=False, indent=2), encoding="utf-8")198 return target199200201def run_tests(root: Path, pytest_args: Sequence[str], target: Path) -> dict:202 import pytest203204 collector = Collector(root=root)205 collector.start()206 try:207 exit_code = int(pytest.main(list(pytest_args)))208 finally:209 collector.stop()210 reports = collect_files(root, collector.hits)211 build_site(reports, target)212 total = sum(item["total"] for item in reports)213 covered = sum(item["hit"] for item in reports)214 return {215 "exit_code": exit_code,216 "files": len(reports),217 "statements": total,218 "covered": covered,219 "percent": percent(covered, total),220 "site": str(target),221 }222223224def main(argv: Sequence[str] | None = None) -> int:225 import argparse226227 parser = argparse.ArgumentParser(prog="sql-lint-coverage", description="Покрытие тестами и HTML-сайт")228 parser.add_argument("--root", default="apps/sql_lint")229 parser.add_argument("--target", default="docs/coverage")230 parser.add_argument("tests", nargs="?", default="apps/sql_lint/tests")231 args = parser.parse_args(list(argv) if argv is not None else None)232233 summary = run_tests(Path(args.root), ["-q", args.tests], Path(args.target))234 print(json.dumps(summary, ensure_ascii=False, indent=2))235 return 0 if summary["exit_code"] == 0 else 1236237238if __name__ == "__main__":239 raise SystemExit(main())← ко всем файлам