FastAPI — это современный веб-фреймворк для создания API с Python 3.7+ на базе стандартных Python типов. Он спроектирован для обеспечения высокой производительности, аналогичной той, что предоставляют Node.js и Go, и легкости в использовании, что делает его подходящим для различных задач — от простых приложений до высоконагруженных сервисов.

Навигация по статье

Основные концепции и преимущества FastAPI

Высокая производительность: FastAPI построен на базе Starlette для веб-части и Pydantic для обработки данных. Это обеспечивает высокую скорость обработки запросов, что критично для API с большим количеством запросов.
Меньше ошибок: Благодаря использованию аннотаций типов Python, разработчики получают автоматическую проверку типов на этапе разработки. Это значительно уменьшает количество ошибок и улучшает качество кода.
Легкость использования: Простота и логичность API-интерфейсов позволяют быстро осваивать фреймворк даже новичкам. Примеры кода выглядят чисто и понятно.
Богатая документация: FastAPI автоматически генерирует интерактивную документацию для вашего API, используя OpenAPI и JSON Schema. Это упрощает разработку и тестирование API.
Поддержка асинхронного программирования: FastAPI поддерживает асинхронные запросы, что позволяет значительно улучшить производительность приложения.

Требования и зависимости

Для начала работы с FastAPI вам потребуется:

Python 3.7 или выше: Если у вас еще не установлен Python, его можно скачать с официального сайта Python.
Uvicorn: Это ASGI-сервер для запуска FastAPI приложений. Он обеспечивает высокую производительность и поддержку асинхронного программирования.

Установка FastAPI и Uvicorn

Первым шагом в установке FastAPI является создание и активация виртуального окружения. Виртуальное окружение позволяет изолировать зависимости вашего проекта от системных пакетов Python, что упрощает управление зависимостями и предотвращает конфликты версий.

Шаг 1: Создание и активация виртуального окружения

# Создание виртуального окружения
python -m venv venv

# Активация виртуального окружения (для Windows)
venv\Scripts\activate

# Активация виртуального окружения (для macOS/Linux)
source venv/bin/activate

После активации виртуального окружения вы заметите, что в командной строке появится префикс (venv), указывающий на активированное окружение.

Шаг 2: Установка FastAPI и Uvicorn

С установленным и активированным виртуальным окружением, следующим шагом будет установка необходимых зависимостей.

# Установка FastAPI
pip install fastapi[all]

# Установка Uvicorn
pip install uvicorn[standard]

Эти команды установят FastAPI и Uvicorn, а также все необходимые зависимости.

Шаг 4: Создание первого приложения

Теперь, когда все зависимости установлены, мы можем создать наше первое простое приложение на FastAPI. Создадим файл main.py с минимальным кодом для запуска сервера.

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def read_root():
return {"Hello": "World"}

Этот код создает экземпляр FastAPI и определяет один маршрут (эндпоинт) /, который возвращает JSON-ответ с сообщением «Hello, World».

Шаг 4: Запуск приложения

Для запуска приложения используйте команду Uvicorn:

uvicorn main:app --reload

main указывает имя файла (без расширения .py), где находится наш код.
app — это имя экземпляра FastAPI, созданного в файле main.py.
—reload позволяет автоматическую перезагрузку сервера при изменении кода. Это очень удобно для разработки.

После запуска команды в консоли вы увидите информацию о запущенном сервере, включая URL, по которому доступно ваше приложение (обычно это http://127.0.0.1:8000).

Шаг 5: Проверка работы сервера

Откройте ваш браузер и перейдите по адресу http://127.0.0.1:8000. Вы должны увидеть JSON-ответ:

{
"Hello": "World"
}

Поздравляю! Вы только что создали и запустили свое первое приложение на FastAPI.

Заключение

В этой статье мы познакомились с основными концепциями FastAPI, его преимуществами и установкой. Мы также создали и запустили простое приложение «Hello, World». В следующих статьях мы углубимся в более сложные аспекты создания API с использованием FastAPI, включая работу с базами данных, валидацию данных, аутентификацию и авторизацию, а также деплой приложения.

FastAPI открывает множество возможностей для быстрой и эффективной разработки современных веб-приложений, и освоение этого фреймворка станет важным шагом в вашем пути как разработчика.