Разработка на Python

# Разработка на Python

Создавайте Python-скрипты, сервисы FastAPI и тестовые наборы с современными инструментами — uv, PEP 723 и лучшие практики pytest.

10 минут, чтобы запустить сервис FastAPI с тестами.

## Возможности плагина

Три навыка, охватывающих полный процесс бэкенд-разработки на Python:

| Навык | Назначение |
|-------|---------|
| **Python Scripting** | Автономные скрипты с использованием uv и встроенных зависимостей PEP 723 — не требуется настройка virtualenv |
| **FastAPI Mastery** | Создание REST API с маршрутизацией, валидацией запросов, middleware, аутентификацией и интеграцией с базой данных |
| **pytest Mastery** | Тестовые наборы с fixtures, parametrize, mocking, асинхронным тестированием и покрытием |

## Полный пример: создание API для сокращения ссылок с тестами

### Шаг 1: Создание каркаса сервиса FastAPI

```
Create a FastAPI URL shortener service with:
- POST /shorten — accepts {"url": "https://..."}, returns {"short_code": "abc123", "short_url": "http://localhost:8000/abc123"}
- GET /{short_code} — redirects to original URL
- GET /stats/{short_code} — returns click count
- Use SQLite via SQLAlchemy for storage
- Add input validation: reject invalid URLs, max URL length 2048
- Include proper error responses (404 for unknown codes, 422 for invalid input)
```

### Шаг 2: Добавление комплексных тестов

```
Write pytest tests for the URL shortener:
- Test POST /shorten with valid URL returns 201 + short_code
- Test POST /shorten with invalid URL returns 422
- Test GET /{short_code} redirects correctly (status 307)
- Test GET /{short_code} with unknown code returns 404
- Test GET /stats/{short_code} returns correct click count after multiple visits
- Use httpx AsyncClient as test client
- Use a separate test database (SQLite in-memory)
- Add fixtures for: app client, sample shortened URL, database setup/teardown
```

### Шаг 3: Добавление служебного скрипта

```
Create a Python script with PEP 723 inline dependencies that:
- Reads a CSV file of URLs (one per line)
- Calls the /shorten endpoint for each URL
- Outputs a new CSV with original_url, short_url, short_code columns
- Use uv for dependency management (httpx, csv are dependencies)
- Add retry logic for failed requests
- Include a --dry-run flag that validates URLs without shortening
```

**Результат:** Полный, протестированный API-сервис + пакетный служебный скрипт — всё создано на основе естественных языковых запросов, готово к развёртыванию.

## Требования к окружению

- **Python 3.10+** (рекомендуется 3.12)
- **Менеджер пакетов uv** для быстрого разрешения зависимостей:
  ```bash
  curl -LsSf https://astral.sh/uv/install.sh | sh
  ```
- Для проектов FastAPI зависимости управляются через `pyproject.toml` или `requirements.txt`
- Для автономных скриптов встроенные метаданные PEP 723 позволяют объявлять зависимости непосредственно в файле скрипта — отдельная конфигурация не требуется

### Быстрая проверка

```bash
python3 --version   # 3.10+
uv --version        # любая недавняя версия
```

## Обработка ошибок

### uv не установлен

```
command not found: uv
```
**Исправление:** Установите uv: `curl -LsSf https://astral.sh/uv/install.sh | sh`
Альтернативно, используйте pip: `pip install -r requirements.txt`

### Ошибки импорта в тестах

```
ModuleNotFoundError: No module named 'httpx'
```
**Исправление:** Установите зависимости для тестов: `uv pip install httpx pytest pytest-asyncio`

### Сервер FastAPI не запускается

Распространённые причины:
- Порт уже занят: `uvicorn app:app --port 8001`
- Отсутствующие зависимости: `uv pip install fastapi uvicorn sqlalchemy`
- Слишком старая версия Python: обновите до 3.10+

### pytest fixtures не найдены

Если тесты fail с ошибкой `fixture not found`, убедитесь:
- `conftest.py` находится в тестовой директории
- Функции fixtures декорированы `@pytest.fixture`
- Асинхронные fixtures используют `@pytest_asyncio.fixture`