#!/usr/bin/env python3 """Проверка иерархии заголовков страницы.""" from __future__ import annotations import argparse import json from pathlib import Path import requests from bs4 import BeautifulSoup def main() -> int: parser = argparse.ArgumentParser(description="Проверить заголовки") parser.add_argument("url", nargs="?", default="https://example.com/") parser.add_argument("--max-length", type=int, default=90) parser.add_argument("--timeout", type=float, default=15.0) parser.add_argument("--json", type=Path, help="Сохранить отчёт") args = parser.parse_args() try: response = requests.get(args.url, timeout=args.timeout, headers={"User-Agent": "popovdev-scriptdock/1.0"}) response.raise_for_status() except requests.RequestException as error: print(f"Не удалось загрузить страницу: {error}") return 2 soup = BeautifulSoup(response.content, "html.parser") headings = [] for tag in soup.find_all(["h1", "h2", "h3", "h4", "h5", "h6"]): text = " ".join(tag.get_text(" ", strip=True).split()) headings.append({"level": int(tag.name[1]), "text": text, "id": tag.get("id")}) problems = [] h1_count = sum(1 for item in headings if item["level"] == 1) if h1_count == 0: problems.append("нет ни одного h1") elif h1_count > 1: problems.append(f"несколько h1: {h1_count}") previous = 0 for item in headings: level = item["level"] if previous and level > previous + 1: problems.append(f"пропуск уровня: h{previous} -> h{level} ({item['text'][:40]})") if not item["text"]: problems.append(f"пустой h{level}") elif len(item["text"]) > args.max_length: problems.append(f"длинный h{level}: {len(item['text'])} символов") previous = level for item in headings: print(f"{' ' * (item['level'] - 1)}h{item['level']}: {item['text'][:80]}") print(f"Всего заголовков: {len(headings)}, h1: {h1_count}") if problems: print("Замечания:") for problem in problems: print(f" - {problem}") if args.json: report = {"url": args.url, "headings": headings, "problems": problems} args.json.write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n", encoding="utf-8") print(f"Отчёт: {args.json}") return 0 if h1_count == 1 and not any("пропуск" in item or "пустой" in item for item in problems) else 1 if __name__ == "__main__": raise SystemExit(main())