unihttp — современная библиотека для создания декларативных API-клиентов.

Документация

Таблица содержимого

• Особенности
• Установка Сериализация Backends Быстрый старт 1.Определить методы 2.Стратегии реализации клиентов
• Ссылка на маркеры
• Методы потоковой передачи Промежуточное ПО
• Per-Call и Per-Method Middleware Обработка ошибок
• 1. Обработка на уровне метода
• 2. Обработка клиентского уровня
• 3. Обработка на уровне промежуточного ПО
• 4. Проверка тела ответа.
• Пользовательская сериализация JSON Производитель: Adaptix Пидантическая интеграция msgspec интеграция
• Агентские навыки

Особенности

** Декларативный **: Определение методов API с использованием стандартных подсказок типа Python. Безопасный тип: полная поддержка статической проверки типа. Backend Agnostic: Работает с httpx, httpx2, aiohttp, requests, niquests, zapros и стандартной библиотекой urllib. Extensible: Мощное промежуточное ПО и системы обработки ошибок.

##Установка

Чтобы включить конкретный HTTP-бэкенд (рекомендуется):

Стандартная библиотека urllib backend UrllibSyncClient не требует дополнительных — В этом случае он будет работать из коробки с простой [9], которая удобна для Среды, свободные от зависимости.

Сериализация Backends

unihttp

unihttp is a modern library for creating declarative API clients.

Documentation

Table of Contents

• Features
• Installation
• Serialization Backends
• Quick Start
  • 1. Define Methods
  • 2. Client Implementation Strategies
• Markers Reference
• Streaming Methods
• Middleware
  • Per-Call and Per-Method Middleware
• Error Handling
  • 1. Method-Level Handling
  • 2. Client-Level Handling
  • 3. Middleware-Level Handling
  • 4. Response Body Validation
• Custom JSON Serialization
• Powered by Adaptix
• Pydantic Integration
• msgspec Integration
• Agent Skills

Features

• Declarative: Define API methods using standard Python type hints.
• Type-Safe: Full support for static type checking.
• Backend Agnostic: Works with httpx, httpx2, aiohttp, requests, niquests, zapros and the standard library urllib.
• Extensible: Powerful middleware and error handling systems.

Installation

pip install unihttp

To include a specific HTTP backend (recommended):

pip install "unihttp[httpx]"    # For HTTPX (Sync/Async) support
# OR
pip install "unihttp[httpx2]"   # For HTTPX2 (Sync/Async) support
# OR
pip install "unihttp[niquests]"  # For niquests (Sync/Async) support
# OR
pip install "unihttp[requests]" # For Requests (Sync) support
# OR
pip install "unihttp[aiohttp]"  # For Aiohttp (Async) support
# OR
pip install "unihttp[zapros]"   # For Zapros (Sync/Async) support

The standard library urllib backend (UrllibSyncClient) requires no extra — it works out of the box with a plain pip install unihttp, which is handy for dependency-free environments.

Serialization Backends

unihttp allows you to choose your preferred serialization framework:

1. Adaptix (recommended): High-performance serialization for standard Python types (dataclasses, TypedDict).