unihttp は、宣言的な API クライアントを作成するモダンなライブラリです。

ドキュメント

コンテンツの表

• 特徴
• インストール
• シリアル化バックエンド
• クイックスタート
• 1. メソッドを定義する
• 2. クライアントの実装戦略
• マーカーの参照
• ストリーミング方法
• ミドルウェア
• Per-CallとPer-Methodミドルウェア
• エラー処理
• 1. 方法レベルの処理
• 2. クライアントレベルの処理
• 3. ミドルウェアレベルの処理
• 4. 応答体検証
• カスタムJSONシリアライズ
• アダプテックスのパワー
• Pydanticの統合
• msgspecの統合
• エージェントスキル

##特徴

-Declarative:標準のPythonタイプのヒントを使用してAPIメソッドを定義します。

• タイプ安全:静的タイプの点検のための完全なサポート。
• **アグノスティック **: httpx, httpx2], [aiohttp]], [requests]], [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).