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

Проверить проект линтерами

Определяет Ruff, ShellCheck и ESLint, показывает нарушения и умеет применять автоисправления.

Python Windows macOS Linux Средний
Скачать lint_runner.py
Описание

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

Скрипт ищет признаки Python, shell и JavaScript проектов и запускает только доступные линтеры. По умолчанию проверка ничего не меняет. Флаг --fix разрешает автоисправления для Ruff и ESLint, а ShellCheck всегда работает в режиме отчёта.

Перед запуском
  • С --fix Ruff и ESLint могут изменить файлы. Проверьте git diff.
Запуск

Быстрый старт

python lint_runner.py --path .

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python lint_runner.py --path .
  • python lint_runner.py --path ./src --fix
  • python lint_runner.py --path . --tool ruff
Зависимости

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

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Ruff Форматирование и проверка Python
Windows py -m pip install ruff
macOS python3 -m pip install ruff
Linux python3 -m pip install ruff
ShellCheck Статический анализ shell-скриптов
Windows winget install koalaman.shellcheck
macOS brew install shellcheck
Linux sudo apt install shellcheck
Node.js 20+ Включает npm
Windows winget install OpenJS.NodeJS.LTS
macOS brew install node
Linux sudo apt install nodejs npm
ESLint Линтер JavaScript и TypeScript
Windows npm install -g eslint
macOS npm install -g eslint
Linux sudo npm install -g eslint
Исходник

lint_runner.py

#!/usr/bin/env python3
"""Запуск доступных линтеров по типам файлов проекта."""
from __future__ import annotations

import argparse
import os
import shutil
import subprocess
from pathlib import Path

EXCLUDES = {".git", ".venv", "venv", "node_modules", "dist", "build", "target", "vendor"}


def find_files(root: Path, suffixes: tuple[str, ...], limit: int = 300) -> list[Path]:
    result = []
    for current, dirs, files in os.walk(root):
        current_path = Path(current)
        dirs[:] = [
            name
            for name in dirs
            if name not in EXCLUDES and not (current_path / name).is_symlink()
        ]
        for name in files:
            path = current_path / name
            if path.is_symlink() or path.suffix.lower() not in suffixes:
                continue
            result.append(path)
            if len(result) >= limit:
                return result
    return result


def run(command: list[str], cwd: Path) -> int:
    print("$ " + " ".join(str(item) for item in command))
    result = subprocess.run(command, cwd=cwd, text=True)
    return result.returncode


def main() -> int:
    parser = argparse.ArgumentParser(description="Запустить линтеры проекта")
    parser.add_argument("--path", type=Path, default=Path("."), help="Папка проекта")
    parser.add_argument("--fix", action="store_true", help="Применить автоисправления")
    parser.add_argument(
        "--tool",
        choices=["auto", "ruff", "shellcheck", "eslint"],
        default="auto",
        help="Ограничить одним инструментом",
    )
    args = parser.parse_args()

    root = args.path.expanduser().resolve()
    if not root.is_dir():
        print(f"Папка не найдена: {root}")
        return 2

    selected = {args.tool} if args.tool != "auto" else {"ruff", "shellcheck", "eslint"}
    failures = 0
    ran = 0

    if "ruff" in selected:
        has_python = (root / "pyproject.toml").exists() or bool(find_files(root, (".py",), 1))
        if has_python:
            if shutil.which("ruff"):
                ran += 1
                command = ["ruff", "check", str(root)]
                if args.fix:
                    command.append("--fix")
                if run(command, root) != 0:
                    failures += 1
            else:
                print("Ruff не установлен, проверка Python пропущена.")

    if "shellcheck" in selected:
        shells = find_files(root, (".sh", ".bash"))
        if shells:
            if shutil.which("shellcheck"):
                ran += 1
                command = ["shellcheck", *[str(path) for path in shells]]
                if run(command, root) != 0:
                    failures += 1
            else:
                print("ShellCheck не установлен, проверка shell пропущена.")

    if "eslint" in selected:
        if (root / "package.json").exists():
            if shutil.which("eslint"):
                ran += 1
                command = ["eslint", str(root), "--ext", ".js,.jsx,.ts,.tsx"]
                if args.fix:
                    command.append("--fix")
                if run(command, root) != 0:
                    failures += 1
            else:
                print("ESLint не установлен, проверка JavaScript пропущена.")

    print()
    if ran == 0:
        print("Не найдено подходящих линтеров или файлов.")
        return 0
    if failures:
        print(f"Линтеры сообщили об ошибках в {failures} запусках.")
        return 1
    print("Проверки линтеров пройдены.")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

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

CLI 1.0.0

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

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

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

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

Категория

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

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