devdoctor 0.2.0__tar.gz

devdoctor-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 DevEnv Doctor Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

devdoctor-0.2.0/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: devdoctor
+Version: 0.2.0
+Summary: Professional CLI tool for developer environment diagnostics and auto-fixing
+License-File: LICENSE
+Keywords: cli,devops,environment,setup,diagnostics
+Author: Starikov A.V.
+Requires-Python: >=3.9,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Provides-Extra: ai
+Requires-Dist: click (>=8.1.7,<9.0.0)
+Requires-Dist: openai (>=1.12.0,<2.0.0) ; extra == "ai"
+Requires-Dist: psutil (>=5.9.8,<6.0.0)
+Requires-Dist: pyyaml (>=6.0.1,<7.0.0)
+Requires-Dist: rich (>=13.7.0,<14.0.0)
+Project-URL: Documentation, https://AttackBeaver.github.io/devdoctor
+Project-URL: Homepage, https://github.com/AttackBeaver/devdoctor
+Project-URL: Repository, https://github.com/AttackBeaver/devdoctor
+Description-Content-Type: text/markdown
+
+# 🩺 DevEnv Doctor
+
+[![CI](https://github.com/AttackBeaver/devdoctor/actions/workflows/ci.yml/badge.svg)](https://github.com/AttackBeaver/devdoctor/actions)
+[![PyPI version](https://img.shields.io/pypi/v/devdoctor.svg)](https://pypi.org/project/devdoctor/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**DevEnv Doctor** — это профессиональный CLI-инструмент для автоматической диагностики и настройки окружения разработчика. Он проверяет инструменты, порты, переменные окружения и помогает исправить проблемы одной командой.
+
+## 🚀 Быстрый старт
+
+1. **Установка**:
+   ```bash
+   pip install devdoctor
+   # или с поддержкой AI советов
+   pip install "devdoctor[ai]"
+   ```
+
+2. **Инициализация**:
+   ```bash
+   devdoctor init
+   ```
+
+3. **Запуск диагностики**:
+   ```bash
+   devdoctor check
+   ```
+
+4. **Авто-исправление**:
+   ```bash
+   devdoctor check --fix
+   ```
+
+## 🛠 Возможности
+
+- **Проверка инструментов**: Наличие и версии Git, Python, Docker, Node.js и др.
+- **Свободные порты**: Поиск процессов, занимающих порты (PostgreSQL, Redis, и т.д.).
+- **Дисковое пространство**: Контроль свободного места и наличия необходимых папок.
+- **Environment**: Проверка `.env` файлов и обязательных переменных.
+- **Custom Checks**: Возможность добавлять свои проверки прямо в YAML.
+- **AI Advisor**: Получение советов по исправлению ошибок через GPT-4.
+
+## ⚙️ Конфигурация (.devdoctor.yaml)
+
+```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](docs/development.md).
+
+---
+**Автор**: [Стариков А.В.](https://github.com/AttackBeaver) — преподаватель БПОУ ОО "СПК"  
+**GitHub**: [AttackBeaver/devdoctor](https://github.com/AttackBeaver/devdoctor)  
+**Лицензия**: MIT
+## Установка
+
+```bash
+poetry install
+```
+
+## Использование
+
+```bash
+# Инициализация конфига
+poetry run devdoctor init
+
+# Проверка окружения
+poetry run devdoctor check
+
+# Попытка исправления (MVP: заглушка)
+poetry run devdoctor check --fix
+```
+

devdoctor-0.2.0/README.md

@@ -0,0 +1,87 @@
+# 🩺 DevEnv Doctor
+
+[![CI](https://github.com/AttackBeaver/devdoctor/actions/workflows/ci.yml/badge.svg)](https://github.com/AttackBeaver/devdoctor/actions)
+[![PyPI version](https://img.shields.io/pypi/v/devdoctor.svg)](https://pypi.org/project/devdoctor/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**DevEnv Doctor** — это профессиональный CLI-инструмент для автоматической диагностики и настройки окружения разработчика. Он проверяет инструменты, порты, переменные окружения и помогает исправить проблемы одной командой.
+
+## 🚀 Быстрый старт
+
+1. **Установка**:
+   ```bash
+   pip install devdoctor
+   # или с поддержкой AI советов
+   pip install "devdoctor[ai]"
+   ```
+
+2. **Инициализация**:
+   ```bash
+   devdoctor init
+   ```
+
+3. **Запуск диагностики**:
+   ```bash
+   devdoctor check
+   ```
+
+4. **Авто-исправление**:
+   ```bash
+   devdoctor check --fix
+   ```
+
+## 🛠 Возможности
+
+- **Проверка инструментов**: Наличие и версии Git, Python, Docker, Node.js и др.
+- **Свободные порты**: Поиск процессов, занимающих порты (PostgreSQL, Redis, и т.д.).
+- **Дисковое пространство**: Контроль свободного места и наличия необходимых папок.
+- **Environment**: Проверка `.env` файлов и обязательных переменных.
+- **Custom Checks**: Возможность добавлять свои проверки прямо в YAML.
+- **AI Advisor**: Получение советов по исправлению ошибок через GPT-4.
+
+## ⚙️ Конфигурация (.devdoctor.yaml)
+
+```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](docs/development.md).
+
+---
+**Автор**: [Стариков А.В.](https://github.com/AttackBeaver) — преподаватель БПОУ ОО "СПК"  
+**GitHub**: [AttackBeaver/devdoctor](https://github.com/AttackBeaver/devdoctor)  
+**Лицензия**: MIT
+## Установка
+
+```bash
+poetry install
+```
+
+## Использование
+
+```bash
+# Инициализация конфига
+poetry run devdoctor init
+
+# Проверка окружения
+poetry run devdoctor check
+
+# Попытка исправления (MVP: заглушка)
+poetry run devdoctor check --fix
+```

devdoctor-0.2.0/pyproject.toml

@@ -0,0 +1,52 @@
+[tool.poetry]
+name = "devdoctor"
+version = "0.2.0"
+description = "Professional CLI tool for developer environment diagnostics and auto-fixing"
+authors = ["Starikov A.V."]
+readme = "README.md"
+homepage = "https://github.com/AttackBeaver/devdoctor"
+repository = "https://github.com/AttackBeaver/devdoctor"
+documentation = "https://AttackBeaver.github.io/devdoctor"
+keywords = ["cli", "devops", "environment", "setup", "diagnostics"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Build Tools",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+packages = [{include = "devdoctor", from = "src"}]
+
+[tool.poetry.dependencies]
+python = "^3.9"
+click = "^8.1.7"
+rich = "^13.7.0"
+pyyaml = "^6.0.1"
+psutil = "^5.9.8"
+openai = {version = "^1.12.0", optional = true}
+
+[tool.poetry.extras]
+ai = ["openai"]
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.0.0"
+pytest-mock = "^3.12.0"
+black = "^24.2.0"
+isort = "^5.13.2"
+flake8 = "^7.0.0"
+mypy = "^1.8.0"
+pre-commit = "^3.6.1"
+types-psutil = "^5.9.5.20240205"
+types-PyYAML = "^6.0.12.12"
+mkdocs = "^1.5.3"
+mkdocs-material = "^9.5.10"
+
+[tool.poetry.scripts]
+devdoctor = "devdoctor.cli:main"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

devdoctor-0.2.0/src/devdoctor/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

devdoctor-0.2.0/src/devdoctor/ai_advisor.py

@@ -0,0 +1,32 @@
+import os
+from typing import List, Dict
+
+def get_ai_suggestions(results: List[Dict]) -> str:
+    try:
+        from openai import OpenAI
+    except ImportError:
+        return "OpenAI library not installed. Use 'pip install devdoctor[ai]'."
+
+    api_key = os.getenv("OPENAI_API_KEY")
+    if not api_key:
+        return "OPENAI_API_KEY not found in environment."
+
+    client = OpenAI(api_key=api_key)
+    
+    failed_checks = [r for r in results if r["status"] != "OK"]
+    if not failed_checks:
+        return "Everything looks great! No AI suggestions needed."
+
+    prompt = "I have the following issues in my development environment:\n"
+    for r in failed_checks:
+        prompt += f"- {r['check']}: {r['message']}\n"
+    prompt += "\nProvide concise, expert advice on how to fix these issues."
+
+    try:
+        response = client.chat.completions.create(
+            model="gpt-3.5-turbo",
+            messages=[{"role": "user", "content": prompt}]
+        )
+        return response.choices[0].message.content or "No suggestions received."
+    except Exception as e:
+        return f"AI Error: {str(e)}"

devdoctor-0.2.0/src/devdoctor/checks/__init__.py

@@ -0,0 +1,7 @@
+from .tools import ToolCheck
+from .ports import PortsCheck
+from .disk import DiskCheck
+from .path import PathCheck
+from .env import EnvCheck
+
+__all__ = ["ToolCheck", "PortsCheck", "DiskCheck", "PathCheck", "EnvCheck"]

devdoctor-0.2.0/src/devdoctor/checks/base.py

@@ -0,0 +1,16 @@
+from abc import ABC, abstractmethod
+
+class Check(ABC):
+    def __init__(self, name: str, description: str):
+        self.name = name
+        self.description = description
+
+    @abstractmethod
+    def run(self) -> tuple[bool, str]:
+        """Returns (success, message)"""
+        pass
+
+    @abstractmethod
+    def fix(self) -> bool:
+        """Attempts to fix the issue. Returns True if fixed."""
+        pass

devdoctor-0.2.0/src/devdoctor/checks/custom.py

@@ -0,0 +1,49 @@
+import subprocess
+from pathlib import Path
+from typing import Tuple
+from .base import Check
+
+class CustomCheck(Check):
+    def __init__(self, config: dict):
+        name = config.get("name", "Custom Check")
+        super().__init__(name=name, description=config.get("description", ""))
+        self.config = config
+        self.check_type = config.get("type", "command")
+
+    def run(self) -> Tuple[bool, str]:
+        if self.check_type == "command":
+            return self._run_command()
+        elif self.check_type == "file_exists":
+            return self._run_file_exists()
+        return False, f"Unknown check type: {self.check_type}"
+
+    def _run_command(self) -> Tuple[bool, str]:
+        cmd = self.config.get("command")
+        expected = self.config.get("expected_output_contains")
+        try:
+            result = subprocess.run(cmd, shell=True, capture_output=True, text=True)
+            if result.returncode == 0:
+                if not expected or expected in result.stdout:
+                    return True, "Command executed successfully"
+                return False, f"Output mismatch. Expected: {expected}"
+            return False, f"Command failed with exit code {result.returncode}"
+        except Exception as e:
+            return False, str(e)
+
+    def _run_file_exists(self) -> Tuple[bool, str]:
+        path = Path(self.config.get("path", ""))
+        should_exist = self.config.get("should_exist", True)
+        exists = path.exists()
+        if exists == should_exist:
+            return True, f"Path {path} {'exists' if exists else 'does not exist'} as expected"
+        return False, f"Path {path} {'exists' if exists else 'does not exist'} (unexpected)"
+
+    def fix(self) -> bool:
+        fix_cmd = self.config.get("fix_command") or self.config.get("fix")
+        if not fix_cmd:
+            return False
+        try:
+            subprocess.run(fix_cmd, shell=True, check=True)
+            return True
+        except Exception:
+            return False

devdoctor-0.2.0/src/devdoctor/checks/disk.py

@@ -0,0 +1,34 @@
+import shutil
+from pathlib import Path
+from .base import Check
+from ..fixers.create_dirs import ensure_directories
+
+class DiskCheck(Check):
+    def __init__(self, path: str, min_gb: float = 1.0, dirs_to_create: list[str] = None):
+        super().__init__(
+            name=f"Disk: {path}",
+            description=f"Check free space (min {min_gb}GB) and required directories"
+        )
+        self.path = path
+        self.min_gb = min_gb
+        self.dirs_to_create = dirs_to_create or []
+
+    def run(self) -> tuple[bool, str]:
+        try:
+            usage = shutil.disk_usage(self.path)
+            free_gb = usage.free / (1024**3)
+            if free_gb < self.min_gb:
+                return False, f"Low disk space: {free_gb:.2f}GB free (required {self.min_gb}GB)"
+            
+            missing = [d for d in self.dirs_to_create if not Path(d).exists()]
+            if missing:
+                return False, f"Missing directories: {', '.join(missing)}"
+                
+            return True, f"{free_gb:.2f}GB free, all directories exist"
+        except FileNotFoundError:
+            return False, f"Path not found: {self.path}"
+
+    def fix(self) -> bool:
+        if self.dirs_to_create:
+            return ensure_directories(self.dirs_to_create)
+        return False

devdoctor-0.2.0/src/devdoctor/checks/env.py

@@ -0,0 +1,30 @@
+from pathlib import Path
+from .base import Check
+from ..fixers.env_generator import generate_env_if_missing
+
+class EnvCheck(Check):
+    def __init__(self, env_path: str, required_vars: list[str]):
+        super().__init__(
+            name=f"Env: {env_path}",
+            description=f"Check if {env_path} exists and contains required variables"
+        )
+        self.env_path = Path(env_path)
+        self.required_vars = required_vars
+
+    def run(self) -> tuple[bool, str]:
+        if not self.env_path.exists():
+            return False, f"File {self.env_path} is missing"
+        
+        content = self.env_path.read_text()
+        missing = []
+        for var in self.required_vars:
+            if f"{var}=" not in content:
+                missing.append(var)
+        
+        if missing:
+            return False, f"Missing variables: {', '.join(missing)}"
+        
+        return True, "All required variables present"
+
+    def fix(self) -> bool:
+        return generate_env_if_missing(str(self.env_path), self.required_vars)

devdoctor-0.2.0/src/devdoctor/checks/path.py

@@ -0,0 +1,19 @@
+import shutil
+from .base import Check
+
+class PathCheck(Check):
+    def __init__(self, bin_name: str):
+        super().__init__(
+            name=f"PATH: {bin_name}",
+            description=f"Check if {bin_name} is in PATH and executable"
+        )
+        self.bin_name = bin_name
+
+    def run(self) -> tuple[bool, str]:
+        path = shutil.which(self.bin_name)
+        if path:
+            return True, f"Found at: {path}"
+        return False, f"'{self.bin_name}' not found in PATH"
+
+    def fix(self) -> bool:
+        return False

devdoctor-0.2.0/src/devdoctor/checks/ports.py

@@ -0,0 +1,24 @@
+import psutil
+from .base import Check
+from ..fixers.kill_port import kill_process_on_port
+
+class PortsCheck(Check):
+    def __init__(self, port: int, description: str = ""):
+        super().__init__(
+            name=f"Port: {port}",
+            description=f"Check if port {port} ({description}) is free"
+        )
+        self.port = port
+
+    def run(self) -> tuple[bool, str]:
+        for conn in psutil.net_connections():
+            if conn.laddr.port == self.port and conn.status == 'LISTEN':
+                try:
+                    process = psutil.Process(conn.pid)
+                    return False, f"Port {self.port} is occupied by '{process.name()}' (PID: {conn.pid})"
+                except (psutil.NoSuchProcess, psutil.AccessDenied):
+                    return False, f"Port {self.port} is occupied (PID: {conn.pid})"
+        return True, f"Port {self.port} is free"
+
+    def fix(self) -> bool:
+        return kill_process_on_port(self.port)

devdoctor-0.2.0/src/devdoctor/checks/tools.py

@@ -0,0 +1,23 @@
+from .base import Check
+from ..utils.system import get_tool_version
+
+class ToolCheck(Check):
+    def __init__(self, tool_name: str, min_version: str = None):
+        super().__init__(
+            name=f"Tool: {tool_name}",
+            description=f"Check if {tool_name} is installed (min version: {min_version or 'any'})"
+        )
+        self.tool_name = tool_name
+        self.min_version = min_version
+
+    def run(self) -> tuple[bool, str]:
+        version = get_tool_version(self.tool_name)
+        if not version:
+            return False, f"{self.tool_name} is not installed"
+        
+        # В MVP просто проверяем наличие. Сравнение версий можно добавить позже.
+        return True, f"Found: {version}"
+
+    def fix(self) -> bool:
+        # Авто-фикс для инструментов обычно требует пакетного менеджера (brew, apt)
+        return False

devdoctor-0.2.0/src/devdoctor/cli.py

@@ -0,0 +1,110 @@
+import click
+import shutil
+from pathlib import Path
+from typing import List, Any
+from rich.progress import Progress, SpinnerColumn, TextColumn
+from rich.panel import Panel
+
+from .config import load_config, DEFAULT_CONFIG_NAME
+from .reporter import Reporter
+from .checks import ToolCheck, PortsCheck, DiskCheck, PathCheck, EnvCheck
+from .checks.custom import CustomCheck
+from .checks.base import Check
+
+@click.group()
+@click.version_option()
+def main() -> None:
+    """DevEnv Doctor: Professional diagnostic tool for your development environment."""
+    pass
+
+@main.command()
+@click.option('--fix', is_flag=True, help='Try to fix issues automatically.')
+@click.option('--verbose', is_flag=True, help='Show detailed debug info.')
+@click.option('--quiet', is_flag=True, help='Only show summary.')
+@click.option('--ai', is_flag=True, help='Get AI suggestions for failed checks.')
+def check(fix: bool, verbose: bool, quiet: bool, ai: bool) -> None:
+    """Run environment diagnostics and optionally fix issues."""
+    config = load_config()
+    reporter = Reporter()
+    checks: List[Check] = []
+    
+    # 1. Tools
+    for t in config.get('tools', []):
+        checks.append(ToolCheck(t['name'], t.get('min_version')))
+        checks.append(PathCheck(t['name']))
+    
+    # 2. Ports
+    for p in config.get('ports', []):
+        port_num = p if isinstance(p, int) else p.get('number')
+        desc = "" if isinstance(p, int) else p.get('description', '')
+        checks.append(PortsCheck(port_num, desc))
+        
+    # 3. Disk & Dirs
+    dirs = config.get('directories_to_create', [])
+    for path in config.get('disk_paths', ['.']):
+        checks.append(DiskCheck(path, dirs_to_create=dirs))
+        
+    # 4. Env
+    env_vars = config.get('required_env_vars', [])
+    for env_file in config.get('env_files', ['.env']):
+        checks.append(EnvCheck(env_file, env_vars))
+
+    # 5. Custom
+    for cc in config.get('custom_checks', []):
+        checks.append(CustomCheck(cc))
+
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[progress.description]{task.description}"),
+        transient=True,
+    ) as progress:
+        task = progress.add_task("[cyan]Running diagnostics...", total=len(checks))
+        
+        for c in checks:
+            if verbose:
+                progress.console.print(f"Checking: [bold]{c.name}[/bold]")
+            
+            success, message = c.run()
+            if not success and fix:
+                if c.fix():
+                    reporter.add_fix(c.name, True)
+                    success, message = c.run() # Re-run after fix
+                else:
+                    reporter.add_fix(c.name, False)
+            
+            status = "OK" if success else "FAIL"
+            reporter.add_result(c.name, status, message)
+            progress.advance(task)
+
+    if not quiet:
+        reporter.print_report()
+    else:
+        failed = [r for r in reporter.results if r["status"] != "OK"]
+        click.echo(f"Status: {'FAIL' if failed else 'OK'} ({len(failed)} issues)")
+
+    if ai:
+        from .ai_advisor import get_ai_suggestions
+        with progress.console.status("[bold yellow]Consulting AI advisor..."):
+            advice = get_ai_suggestions(reporter.results)
+        progress.console.print(Panel(advice, title="AI Suggestions", border_style="yellow"))
+
+@main.command()
+def init() -> None:
+    """Initialize .devdoctor.yaml from example template."""
+    example = Path(".devdoctor.yaml.example")
+    target = Path(DEFAULT_CONFIG_NAME)
+    
+    if target.exists():
+        click.confirm(f"{DEFAULT_CONFIG_NAME} already exists. Overwrite?", abort=True)
+    
+    if example.exists():
+        shutil.copy(example, target)
+        click.echo(f"Successfully created {DEFAULT_CONFIG_NAME} from example.")
+    else:
+        with open(target, 'w', encoding='utf-8') as f:
+            f.write("tools:\n  - name: git\n")
+        click.echo(f"Created default {DEFAULT_CONFIG_NAME} (example not found).")
+
+
+if __name__ == "__main__":
+    main()

devdoctor-0.2.0/src/devdoctor/config.py

@@ -0,0 +1,27 @@
+import yaml
+from pathlib import Path
+from typing import Any, Dict
+
+DEFAULT_CONFIG_NAME = ".devdoctor.yaml"
+
+def load_config(path: str | Path | None = None) -> Dict[str, Any]:
+    config_path = Path(path or DEFAULT_CONFIG_NAME)
+    if not config_path.exists():
+        return {}
+    
+    with open(config_path, 'r', encoding='utf-8') as f:
+        config = yaml.safe_load(f) or {}
+    
+    # Дефолтные значения для новых ключей
+    defaults = {
+        "tools": [],
+        "ports": [],
+        "disk_paths": ["."],
+        "directories_to_create": [],
+        "env_files": [".env"],
+        "required_env_vars": []
+    }
+    for key, value in defaults.items():
+        config.setdefault(key, value)
+        
+    return config

devdoctor-0.2.0/src/devdoctor/fixers/__init__.py

@@ -0,0 +1 @@
+# Placeholder for future fixers

devdoctor-0.2.0/src/devdoctor/fixers/create_dirs.py

@@ -0,0 +1,11 @@
+import os
+from pathlib import Path
+
+def ensure_directories(dirs: list[str]) -> bool:
+    success = True
+    for d in dirs:
+        try:
+            Path(d).mkdir(parents=True, exist_ok=True)
+        except Exception:
+            success = False
+    return success

devdoctor-0.2.0/src/devdoctor/fixers/env_generator.py

@@ -0,0 +1,20 @@
+from pathlib import Path
+
+def generate_env_if_missing(env_path: str, required_vars: list[str]) -> bool:
+    path = Path(env_path)
+    try:
+        existing_content = path.read_text() if path.exists() else ""
+        new_lines = []
+        
+        for var in required_vars:
+            if f"{var}=" not in existing_content:
+                new_lines.append(f"{var}=YOUR_{var}_HERE")
+        
+        if new_lines:
+            with open(path, "a") as f:
+                if existing_content and not existing_content.endswith("\n"):
+                    f.write("\n")
+                f.write("\n".join(new_lines) + "\n")
+        return True
+    except Exception:
+        return False

devdoctor-0.2.0/src/devdoctor/fixers/kill_port.py

@@ -0,0 +1,15 @@
+import psutil
+import click
+
+def kill_process_on_port(port: int) -> bool:
+    for conn in psutil.net_connections():
+        if conn.laddr.port == port and conn.status == 'LISTEN':
+            try:
+                process = psutil.Process(conn.pid)
+                if click.confirm(f"Kill process '{process.name()}' (PID: {conn.pid}) on port {port}?", default=False):
+                    process.terminate()
+                    process.wait(timeout=3)
+                    return True
+            except (psutil.NoSuchProcess, psutil.AccessDenied, psutil.TimeoutExpired):
+                return False
+    return False

devdoctor-0.2.0/src/devdoctor/reporter.py

@@ -0,0 +1,50 @@
+from rich.console import Console
+from rich.table import Table
+from rich.panel import Panel
+
+class Reporter:
+    def __init__(self):
+        self.console = Console()
+        self.results = []
+        self.fixes = []
+
+    def add_result(self, check_name: str, status: str, message: str):
+        self.results.append({
+            "check": check_name,
+            "status": status,
+            "message": message
+        })
+
+    def add_fix(self, check_name: str, success: bool):
+        self.fixes.append({
+            "check": check_name,
+            "success": success
+        })
+
+    def print_report(self):
+        table = Table(title="DevEnv Doctor Report")
+        table.add_column("Check", style="cyan")
+        table.add_column("Status", style="bold")
+        table.add_column("Message")
+
+        for res in self.results:
+            color = "green" if res["status"] == "OK" else "red"
+            table.add_row(res["check"], f"[{color}]{res['status']}[/{color}]", res["message"])
+
+        self.console.print(table)
+        
+        if self.fixes:
+            fix_table = Table(title="Fixes Applied")
+            fix_table.add_column("Check", style="cyan")
+            fix_table.add_column("Result", style="bold")
+            for fix in self.fixes:
+                color = "green" if fix["success"] else "yellow"
+                status = "FIXED" if fix["success"] else "FAILED"
+                fix_table.add_row(fix["check"], f"[{color}]{status}[/{color}]")
+            self.console.print(fix_table)
+
+        failed = [r for r in self.results if r["status"] != "OK"]
+        if failed and not self.fixes:
+            self.console.print(Panel(f"Found {len(failed)} issues!", style="red"))
+        elif not failed:
+            self.console.print(Panel("All checks passed!", style="green"))

devdoctor-0.2.0/src/devdoctor/utils/system.py

@@ -0,0 +1,30 @@
+import shutil
+import subprocess
+import socket
+import psutil
+from pathlib import Path
+
+def get_tool_version(tool: str) -> str | None:
+    try:
+        result = subprocess.run(
+            [tool, "--version"], 
+            capture_output=True, 
+            text=True, 
+            check=False
+        )
+        output = result.stdout.strip() or result.stderr.strip()
+        # Простой парсинг первой строки (например, "git version 2.34.1")
+        return output.split('\n')[0] if output else None
+    except FileNotFoundError:
+        return None
+
+def is_port_open(port: int) -> bool:
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        return s.connect_ex(('localhost', port)) == 0
+
+def get_free_disk_space(path: str = ".") -> float:
+    usage = psutil.disk_usage(path)
+    return usage.free / (1024**3)  # GB
+
+def check_path_for_binary(bin_name: str) -> bool:
+    return shutil.which(bin_name) is not None