Аудит lock-файлов проекта
Проверяет, есть ли lock-файлы у npm, Poetry, Pipenv, Cargo, Go и Composer, и не устарели ли они.
Что делает скрипт
Скрипт сопоставляет манифесты с известными lock-файлами, сравнивает даты изменения и проверяет версию формата package-lock. Это быстрый способ заметить забытый npm install или poetry lock. Никакие пакеты не устанавливаются и файлы не меняются.
Быстрый старт
python lockfile_audit.py --path .
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python lockfile_audit.py --path .python lockfile_audit.py --path . --json locks.json
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
lockfile_audit.py
#!/usr/bin/env python3
"""Проверка наличия и свежести lock-файлов."""
from __future__ import annotations
import argparse
import json
import time
from pathlib import Path
CHECKS = [
("npm", "package.json", ["package-lock.json", "yarn.lock", "pnpm-lock.yaml", "bun.lockb"]),
("poetry", "pyproject.toml", ["poetry.lock", "uv.lock"]),
("pipenv", "Pipfile", ["Pipfile.lock"]),
("cargo", "Cargo.toml", ["Cargo.lock"]),
("go", "go.mod", ["go.sum"]),
("composer", "composer.json", ["composer.lock"]),
]
def age_days(path: Path) -> int:
try:
delta = time.time() - path.stat().st_mtime
except OSError:
return -1
return max(0, int(delta // 86400))
def main() -> int:
parser = argparse.ArgumentParser(description="Аудит lock-файлов")
parser.add_argument("--path", type=Path, default=Path("."), help="Папка проекта")
parser.add_argument("--json", type=Path, help="Сохранить отчёт в JSON")
args = parser.parse_args()
root = args.path.expanduser().resolve()
if not root.is_dir():
print(f"Папка не найдена: {root}")
return 2
rows = []
problems = 0
for manager, manifest_name, lock_names in CHECKS:
manifest = root / manifest_name
if not manifest.is_file():
continue
found = [root / name for name in lock_names if (root / name).is_file()]
if not found:
rows.append(
{
"manager": manager,
"manifest": manifest_name,
"lock": "",
"status": "missing",
"manifest_age": age_days(manifest),
"lock_age": None,
}
)
problems += 1
continue
lock = found[0]
status = "ok"
if manifest.stat().st_mtime > lock.stat().st_mtime + 1:
status = "stale"
problems += 1
rows.append(
{
"manager": manager,
"manifest": manifest_name,
"lock": lock.name,
"status": status,
"manifest_age": age_days(manifest),
"lock_age": age_days(lock),
}
)
if not rows:
print("Манифесты известных пакетных менеджеров не найдены.")
return 0
print(f"Проект: {root}")
for row in rows:
mark = "OK" if row["status"] == "ok" else "ВНИМАНИЕ"
print(
f"{mark:9} {row['manager']:8} lock={row['lock'] or 'нет':20} "
f"manifest={row['manifest_age']}д, lock={row['lock_age']}д"
)
npm_lock = root / "package-lock.json"
if npm_lock.is_file():
try:
data = json.loads(npm_lock.read_text(encoding="utf-8"))
version = data.get("lockfileVersion")
print(f"package-lock.json: lockfileVersion={version}")
except (OSError, ValueError):
print("package-lock.json не удалось разобрать.")
if args.json:
args.json.write_text(
json.dumps({"root": str(root), "rows": rows}, ensure_ascii=False, indent=2)
+ "\n",
encoding="utf-8",
)
if problems:
print(f"Проблемных записей: {problems}. Обновите lock-файлы штатной командой менеджера.")
else:
print("Lock-файлы на месте и не старше манифестов.")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.