#!/usr/bin/env python3 """Создание и проверка манифеста контрольных сумм.""" from __future__ import annotations import argparse import hashlib import json import os import sys from datetime import datetime, timezone from pathlib import Path DEFAULT_EXCLUDES = {".git", "__pycache__", "node_modules", ".venv", "venv"} def file_hash(path: Path, algorithm: str, chunk_size: int = 1024 * 1024) -> str: digest = hashlib.new(algorithm) with path.open("rb") as handle: while True: chunk = handle.read(chunk_size) if not chunk: break digest.update(chunk) return digest.hexdigest() def iter_files(root: Path, excludes: set[str]): for dirpath, dirnames, filenames in os.walk(root, followlinks=False): dirnames[:] = sorted(d for d in dirnames if d not in excludes) for name in sorted(filenames): path = Path(dirpath) / name if path.is_symlink() or not path.is_file(): continue yield path def collect(root: Path, algorithm: str, excludes: set[str], manifest: Path) -> dict[str, dict[str, object]]: files: dict[str, dict[str, object]] = {} for path in iter_files(root, excludes): if path.resolve() == manifest.resolve(): continue try: info = path.stat() relative = path.relative_to(root).as_posix() files[relative] = {"hash": file_hash(path, algorithm), "size": info.st_size} except OSError as error: print(f"Пропуск {path}: {error}", file=sys.stderr) return files def command_create(args: argparse.Namespace) -> int: root = args.path.expanduser().resolve() manifest = args.manifest.expanduser().resolve() if not root.is_dir(): print(f"Каталог не найден: {root}") return 2 excludes = set(DEFAULT_EXCLUDES) | set(args.exclude) files = collect(root, args.algorithm, excludes, manifest) payload = { "version": 1, "algorithm": args.algorithm, "root": str(root), "created": datetime.now(timezone.utc).isoformat(), "exclude": sorted(excludes), "files": files, } manifest.write_text(json.dumps(payload, ensure_ascii=False, indent=2, sort_keys=True) + "\n", encoding="utf-8") print(f"Файлов в манифесте: {len(files)}") print(f"Алгоритм: {args.algorithm}") print(f"Манифест: {manifest}") return 0 def command_verify(args: argparse.Namespace) -> int: root = args.path.expanduser().resolve() manifest = args.manifest.expanduser().resolve() if not root.is_dir(): print(f"Каталог не найден: {root}") return 2 try: payload = json.loads(manifest.read_text(encoding="utf-8")) recorded = payload["files"] algorithm = payload.get("algorithm", "sha256") except (OSError, ValueError, KeyError, AttributeError) as error: print(f"Не удалось прочитать манифест: {error}") return 2 excludes = set(DEFAULT_EXCLUDES) | set(payload.get("exclude", [])) | set(args.exclude) current = collect(root, algorithm, excludes, manifest) changed = [] missing = [] for relative, item in recorded.items(): if relative not in current: missing.append(relative) elif current[relative]["hash"] != item.get("hash"): changed.append({"path": relative, "expected": item.get("hash"), "actual": current[relative]["hash"]}) new = sorted(set(current) - set(recorded)) print(f"Каталог: {root}") print(f"Записей в манифесте: {len(recorded)}") print(f"Изменено: {len(changed)}") print(f"Удалено: {len(missing)}") print(f"Новых: {len(new)}") for item in changed[: args.limit]: print(f" изменён: {item['path']}") for relative in missing[: args.limit]: print(f" удалён: {relative}") for relative in new[: args.limit]: print(f" новый: {relative}") if args.report: report = { "root": str(root), "manifest": str(manifest), "changed": changed, "missing": missing, "new": new, } args.report.write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n", encoding="utf-8") print(f"Отчёт сохранён: {args.report}") return 1 if changed or missing or new else 0 def main() -> int: parser = argparse.ArgumentParser(description="Манифест контрольных сумм") subparsers = parser.add_subparsers(dest="command", required=True) for name in ("create", "verify"): sub = subparsers.add_parser(name) sub.add_argument("--path", type=Path, required=True, help="Каталог для проверки") sub.add_argument("--manifest", type=Path, required=True, help="Файл манифеста") sub.add_argument("--exclude", action="append", default=[], help="Исключить каталог по имени") sub.add_argument("--limit", type=int, default=30, help="Сколько строк показать") if name == "create": sub.add_argument("--algorithm", choices=("sha256", "sha512"), default="sha256") else: sub.add_argument("--report", type=Path, help="Сохранить отчёт о расхождениях") args = parser.parse_args() if args.limit < 1: parser.error("--limit должен быть положительным") if args.command == "create": return command_create(args) return command_verify(args) if __name__ == "__main__": raise SystemExit(main())