Python для начинающих

Создание серверных приложений с использованием FastAPI.

174 views00:25

Создание серверных приложений с использованием FastAPI.

164 views01:28

Создание серверных приложений с использованием FastAPI

Встречали ли вы технологии, которые не только облегчают вам жизнь, но и заставляют вас искренне удивляться? Если вы еще ни разу не пробовали FastAPI, приготовьтесь открыть для себя один из самых эффективных инструментов для создания серверных приложений. Это не просто фреймворк, это целый мир возможностей, который невероятно прост в освоении.

FastAPI — это современный веб-фреймворк для создания API на Python. Разработчики влюбляются в него благодаря невероятной простоте и скорости, ведь название говорит само за себя — "быстрый API". FastAPI построен на основе Starlette и Pydantic, что делает его не только молниеносным, но и надежным.

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

---

### Почему именно FastAPI?
FastAPI был создан для того, чтобы сделать разработку серверной части проще и удобнее. Основные преимущества:
- Скорость работы: Фреймворк использует асинхронное программирование на базе asyncio, что делает его на порядок быстрее многих аналогов.
- Автоматизированная документация: Swagger UI и ReDoc генерируются автоматически. Это значит, что вы получаете интерфейс для тестирования вашего API прямо "из коробки".
- Поддержка аннотаций типов: Хотите меньше ошибок? FastAPI позволяет эффективно использовать типизацию Python, что помогает выявлять проблемы на раннем этапе.

Теперь перейдем от теории к практике.

---

### Создаем серверное приложение: ваш первый API

Для начала убедимся, что у вас установлен FastAPI и Uvicorn (ASGI-сервер, который используется для запуска приложения). Установить их можно с помощью pip:

pip install fastapi uvicorn

Теперь создадим файл main.py с простым примером:

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "Welcome to FastAPI!"}

@app.get("/items/{item_id}")
def read_item(item_id: int, detail: bool = False):
    return {"item_id": item_id, "detail": detail}

Что здесь происходит:
1. Создаем объект FastAPI. Это наш "движок", который будет управлять запросами и возвращать ответы.
2. Определяем два эндпоинта (или маршрута).
- / возвращает приветствие.
- /items/{item_id} принимает item_id как параметр пути и параметр запроса detail.

Запустить сервер можно командой:

uvicorn main:app --reload

После этого перейдите на http://127.0.0.1:8000/docs. Вы увидите автоматически созданную интерактивную документацию в стиле Swagger UI!

---

### Работаем с POST-запросами

А как насчет обработки новых данных? Например, добавления информации в базу данных? Для этого используется метод POST.

Давайте расширим наш сервер:

from pydantic import BaseModel

class Item(BaseModel):
    name: str
    price: float
    description: str | None = None

@app.post("/items/")
def create_item(item: Item):
    return {"name": item.name, "price": item.price, "description": item.description}

Теперь, заходя в /docs, вы увидите форму, где можно отправить данные в формате JSON. Удобно протестировать и убедиться, что сервер работает так, как нужно.

---

### Асинхронность — сила FastAPI

FastAPI поддерживает асинхронные функции (корутины) буквально "из коробки". Это значит, что вы можете, например, обращаться к базе данных без блокировки приложения.

Попробуем добавить асинхронный эндпоинт:

import asyncio

@app.get("/wait/")
async def wait_for_response():
    await asyncio.sleep(3)
    return {"message": "Thanks for waiting!"}

Когда вы зайдете на этот маршрут, сервер "задумается" на три секунды, а затем вернет ответ. Это полезно для выполнения длительных операций.

---

### Пара слов о безопасности

FastAPI предоставляет инструменты для безопасной разработки.

👍1

142 views01:28