Metadata-Version: 2.4
Name: py-123pan-client
Version: 0.1.9
Summary: Unnoficial Python SDK for 123Pan Open Platform
Requires-Python: >=3.9
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic
Provides-Extra: dagster
Requires-Dist: dagster>=1.10.0; extra == 'dagster'
Description-Content-Type: text/markdown

# py-123pan-client

**123云盘开放平台 (123Pan Open Platform) 非官方 Python SDK**

基于 `httpx` 和 `pydantic` 构建，提供现代化、类型安全且易于使用的接口封装。支持自动鉴权、智能断点续传、大文件上传、直链管理、离线下载等核心功能。

## ✨ 特性

- **🔐 自动鉴权**：自动管理 Access Token 生命周期，过期自动刷新，开发者无需操心。
- **🚀 智能上传**：
    - 小文件 (<100MB) 自动使用单步上传。
    - 大文件自动切换为分片上传 (Chunked Upload)，支持秒传检测。
    - 自动计算 MD5，内存占用低（流式处理）。
- **⚡ 高性能**：底层使用 `httpx`，支持 HTTP/2 (依赖服务端支持)，为未来异步化预留空间。
- **📦 类型安全**：所有请求与响应均通过 `Pydantic` 模型验证，提供完美的 IDE 代码补全体验。
- **🛠 全功能覆盖**：文件管理、分享管理（含付费分享）、离线下载、直链加速、开发者安全配置。

## 📦 安装

推荐使用 `uv` 或 `pip` 进行安装：

```bash
# 使用 pip
pip install py-123pan-client

# 或者使用 uv (推荐)
uv add py-123pan-client