Разработка и Git

Аудит lock-файлов проекта

Проверяет, есть ли lock-файлы у npm, Poetry, Pipenv, Cargo, Go и Composer, и не устарели ли они.

Python Windows macOS Linux Продвинутый
Скачать lockfile_audit.py
Описание

Что делает скрипт

Скрипт сопоставляет манифесты с известными 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
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux 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())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get dev-lockfile-audit
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Разработка и Git

Git, сборка, тесты, зависимости, логи и обслуживание проектов.