devdoctor 0.2.0

Professional CLI tool for developer environment diagnostics and auto-fixing

🩺 DevEnv Doctor

DevEnv Doctor — это профессиональный CLI-инструмент для автоматической диагностики и настройки окружения разработчика. Он проверяет инструменты, порты, переменные окружения и помогает исправить проблемы одной командой.

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

1. Установка:

   pip install devdoctor
   # или с поддержкой AI советов
   pip install "devdoctor[ai]"
   

2. Инициализация:

   devdoctor init
   

3. Запуск диагностики:

   devdoctor check
   

4. Авто-исправление:

   devdoctor check --fix
   

🛠 Возможности

• Проверка инструментов: Наличие и версии Git, Python, Docker, Node.js и др.
• Свободные порты: Поиск процессов, занимающих порты (PostgreSQL, Redis, и т.д.).
• Дисковое пространство: Контроль свободного места и наличия необходимых папок.
• Environment: Проверка .env файлов и обязательных переменных.
• Custom Checks: Возможность добавлять свои проверки прямо в YAML.
• AI Advisor: Получение советов по исправлению ошибок через GPT-4.

⚙️ Конфигурация (.devdoctor.yaml)

tools:
  - name: git
    min_version: "2.30.0"

ports:
  - number: 5432
    description: "PostgreSQL"

env_files: [".env"]
required_env_vars: ["DATABASE_URL", "SECRET_KEY"]

custom_checks:
  - name: "Check Redis"
    command: "redis-cli ping"
    expected_output_contains: "PONG"

👨‍💻 Разработка

Инструкции по развертыванию и тестированию находятся в CONTRIBUTING.md.

---

Автор: Стариков А.В. — преподаватель БПОУ ОО "СПК"
GitHub: AttackBeaver/devdoctor
Лицензия: MIT

Установка

poetry install

Использование

# Инициализация конфига
poetry run devdoctor init

# Проверка окружения
poetry run devdoctor check

# Попытка исправления (MVP: заглушка)
poetry run devdoctor check --fix