Манифест контрольных сумм
Создаёт и проверяет SHA-256 или SHA-512 манифест каталога.
Что делает скрипт
Скрипт умеет создавать JSON-манифест с хешами и размерами файлов, а затем сравнивать каталог с ним. При проверке отдельно показываются изменённые, удалённые и новые файлы, поэтому отчёт подходит для контроля целостности конфигураций и релизов. Символические ссылки и служебные каталоги по умолчанию пропускаются.
Быстрый старт
python hash_manifest.py create --path ./etc --manifest manifest.json
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python hash_manifest.py create --path . --manifest manifest.json --algorithm sha512python hash_manifest.py verify --path . --manifest manifest.json --report diff.json
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
hash_manifest.py
#!/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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.