unihttp 是一个用于创建声明式 API 客户端的现代库。

文献资料

目录

• 特色
• 安装
• 序列化后端
• 快速入门
• 1.定义方法
• 2.客户实施策略
• 标记参考
• 流式方法
• 中间件
• 按调用和按方法进行中间件
• 错误处理
• 1.方法级处理
• 2.客户端级处理
• 3.中间件级别处理
• 4.响应体验证
• 自定义 JSON 序列化
• 由Adaptix提供技术支持
• 皮丹积分
• MSGSPEC 集成
• 特工技能

特色

• 声明式：使用标准 Python 类型提示定义 API 方法。
• 类型安全：完全支持静态类型检查。
• 后端无关性：可与 httpx、httpx2、aiohttp、requests、niquests、zapros 及标准库 urllib 使用。
• 可扩展：强大的中间件和错误处理系统。

安装

为了包含特定的HTTP后端（推荐）：

标准库 urllib 后端（UrllibSyncClient）不需要额外的—— 它开箱即用普通的 pip install unihttp，这很方便于 无依赖环境。

序列化后端

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).