Промпт для изучения FastAPI c DeepSeek

Отлично! Я буду вашим ментором по FastAPI. Этот план рассчитан на 4-6 недель интенсивного обучения. Давайте начнем.

Общий план обучения FastAPI

Неделя 1: Основы и первое API

• Модуль 1.1: Введение в веб-фреймворки, ASGI и асинхронность.
• Модуль 1.2: Установка, настройка и создание первого эндпоинта.

Неделя 2: Данные и логика

• Модуль 2.1: Валидация данных с Pydantic.
• Модуль 2.2: Работа с базой данных (SQLAlchemy Core + asyncpg).

Неделя 3: Безопасность и качество

• Модуль 3.1: Аутентификация и авторизация (OAuth2, JWT).
• Модуль 3.2: Тестирование API.

Неделя 4: Финальные штрихи и деплой

• Модуль 4.1: Документирование API (OpenAPI, Swagger UI).
• Модуль 4.2: Развёртывание на сервере.

Модуль 1.2: Установка и первое API

Цель: Создать работающее "Hello World" API.

Темы:

1. Установка Python 3.10+ и создание виртуального окружения.
2. Установка пакетов: fastapi, uvicorn.
3. Структура простейшего приложения FastAPI.
4. Запуск сервера разработки.
5. HTTP-методы (GET, POST) и эндпоинты.

Ресурсы:

• Официальная документация: FastAPI - First Steps

Практическое задание:

Создайте эндпоинт GET /items/{item_id}, который возвращает {"item_id": item_id}.

Пример кода:

Создайте файл examples/module_1_2_example.py

# Импорт необходимых классов из фреймворка
from fastapi import FastAPI

# Создание экземпляра приложения. Это центральный объект.
app = FastAPI()

# Декоратор, который превращает функцию в эндпоинт.
# Указывает HTTP-метод и URL-путь.
@app.get("/")
async def read_root():
    # Простая асинхронная функция, возвращающая JSON-объект.
    return {"message": "Hello World"}

@app.get("/items/{item_id}")
async def read_item(item_id: int):  # FastAPI автоматически преобразует item_id в int и валидирует его.
    return {"item_id": item_id}

# Для запуска из командной строки:
# uvicorn examples.module_1_2_example:app --reload

• @app.get("/"): Декоратор. Говорит FastAPI: "Функция ниже отвечает на GET-запросы по URL /".
• async def: Объявляет асинхронную функцию. Позволяет эффективно обрабатывать множество одновременных запросов.
• item_id: int: Аннотация типа. FastAPI использует её для автоматической проверки, преобразования и документирования параметра.

Возможные ошибки:

• ImportError: Не установлены пакеты fastapi или uvicorn. Решение: pip install fastapi uvicorn.
• Address already in use: Порт 8000 занят. Решение: запустите с опцией --port 8001.

Запуск:

# Активируйте виртуальное окружение (например, для Windows)
# .venv\Scripts\activate

# Запустите сервер
uvicorn examples.module_1_2_example:app --reload

Перейдите по адресу http://127.0.0.1:8000 и http://127.0.0.1:8000/items/42.

Тест к Модулю 1.2

1. Какая команда устанавливает FastAPI и Uvicorn?

   • A) pip install django
   • B) python install fastapi uvicorn
   • C) pip install fastapi uvicorn
   • D) uvicorn install fastapi

2. Что делает декоратор @app.get("/home")?

   • A) Создает HTML-страницу
   • B) Определяет функцию для обработки GET-запросов по пути "/home"
   • C) Удаляет все файлы в папке "/home"

3. Как объявить параметр пути user_id, который должен быть целым числом?

   • A) async def read_user(user_id: str): ...
   • B) async def read_user(user_id: int): ...
   • C) async def read_user(user_id): ...

4. Что означает опция --reload при запуске Uvicorn?

   • A) Стирает базу данных
   • B) Перезагружает сервер при изменении кода (для разработки)
   • C) Блокирует возможность писать код

5. Преобразуйте следующий код в асинхронный эндпоинт для пути /user/{name}: def get_user(name): return {"user_name": name}

....