Metadata-Version: 2.5
Name: fundrive-baidu
Version: 2.0.91
Summary: 百度网盘（BaiduPCS）云存储 API 封装
Project-URL: Organization, https://github.com/farfarfun
Project-URL: Repository, https://github.com/farfarfun/fundrive-baidu
Project-URL: Releases, https://github.com/farfarfun/fundrive-baidu/releases
Author-email: 牛哥 <niuliangtao@qq.com>, farfarfun <farfarfun@qq.com>
Maintainer-email: 牛哥 <niuliangtao@qq.com>, farfarfun <farfarfun@qq.com>
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: cryptography>=44.0.0
Requires-Dist: farcache>=2.0.3
Requires-Dist: farlog>=1.1.7
Requires-Dist: passlib>=1.7.4
Requires-Dist: pillow>=10.4.0
Requires-Dist: requests-toolbelt>=1.0.0
Requires-Dist: requests>=2.32.3
Requires-Dist: rich>=13.9.4
Description-Content-Type: text/markdown

# fundrive-baidu

百度网盘（BaiduPCS）Python API 封装，提供文件列表/搜索、上传下载、移动复制、
离线下载、分享与转存等常用能力，供 [fundrive](https://github.com/farfarfun/fundrive)
及其他项目以统一接口接入百度网盘。

## 安装

```bash
pip install fundrive-baidu
# 或
uv add fundrive-baidu
```

## 快速开始

请先通过环境变量提供凭据，避免把敏感信息写入源码或命令历史：

```bash
export BDUSS="从百度账号获取的 BDUSS"
export STOKEN="分享接口需要的 STOKEN"
```

客户端会自动读取 `BDUSS`、`STOKEN` 和可选的 `PTOKEN`；也可以在受信任的凭据管理器中读取后显式传入。

```python
from fundrives.baidu import BaiduPCSApi

api = BaiduPCSApi()

# 列出网盘根目录文件
for pcs_file in api.list("/"):
    print(pcs_file.path, pcs_file.is_dir, pcs_file.size)
```

## 主要能力

- 文件列表、元数据查询、搜索
- 上传（含分片上传、秒传）、下载链接与流式下载
- 移动、复制、重命名、删除、新建目录
- 离线下载任务（普通链接、磁力链接）
- 分享链接创建/查询/取消，以及分享内容转存

## 来源说明

本项目源码来自 [PeterDing/BaiduPCS-Py](https://github.com/PeterDing/BaiduPCS-Py)
（[MIT](https://github.com/PeterDing/BaiduPCS-Py/blob/master/LICENSE) 协议，
Copyright (c) 2021 Peter Ding），在此基础上去除了命令行界面代码与部分服务端代码，
减少相关依赖，只保留可编程调用的 API 部分。

---

## 关于 farfarfun

[farfarfun](https://github.com/farfarfun) 是一个专注于实用工具库的开源组织，
涵盖云存储、数据处理、AI、多媒体与开发工具链等方向。

- 🏠 组织主页：<https://github.com/farfarfun>
- 📦 PyPI：<https://pypi.org/user/niuliangtao/>
- 📧 联系：farfarfun@qq.com

本项目基于 [MIT](LICENSE) 协议开源。
