pguangya 0.1.0__tar.gz

pguangya-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pguangya-0.1.0/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: pguangya
+Version: 0.1.0
+Summary: Sync-first Python client for Guangya cloud drive Web APIs.
+Author: KC
+License-Expression: MIT
+Keywords: guangya,cloud-drive,sync,filesystem
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx<1,>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest<9,>=8; extra == "dev"
+Requires-Dist: mypy<2,>=1.11; extra == "dev"
+Requires-Dist: build<2,>=1.2; extra == "dev"
+Requires-Dist: twine<7,>=5; extra == "dev"
+Dynamic: license-file
+
+# pguangya
+
+`pguangya` 是面向项目直接集成的光鸭云盘同步 Python 客户端。
+
+它复用光鸭 Windows PC Web 协议，提供纯同步 Python API。项目覆盖账号、
+文件、资产、下载、分享、离线任务和上传主链路；不包含官方开发者
+`dapi.guangyapan.com` OpenAPI、本地 Web 服务、WebDAV 或 HDHive 集成。
+
+> 本项目不是光鸭官方 SDK。逆向协议可能随上游版本变化。请仅在获准账号和
+> 数据范围内使用，并自行遵守服务条款与适用法律。
+
+## 特性
+
+- `PGuangyaClient`：全部已确认的非 Open Web 端点
+- `PGuangyaFileSystem`：ID/路径查询、遍历及文件操作
+- `GuangyaLogin`：扫码、短信登录及会话刷新
+- `PGuangyaHelper`：下载、打包、分享和离线任务工作流
+- `PGuangyaUploadHelper`：GCID 秒传、OSS 单 PUT、multipart 和断点续传
+- 完整响应 envelope 保留，未知字段不丢失
+- 纯同步调用，无 CLI、Web 服务或异步双栈
+
+## 安装
+
+```bash
+pip install pguangya
+```
+
+本地开发：
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+## 快速开始
+
+```python
+from pguangya import GuangyaSession, PGuangyaClient, PGuangyaFileSystem
+
+session = GuangyaSession(
+    access_token="...",
+    refresh_token="...",
+    device_id="0123456789abcdef0123456789abcdef",
+)
+
+with PGuangyaClient(session=session) as client:
+    fs = PGuangyaFileSystem(client)
+    for item in fs.iter_entries("/"):
+        print(item)
+```
+
+登录所得 `access_token`、`refresh_token` 和稳定 `device_id` 只保存在内存中。
+调用方可通过会话导出接口自行持久化；库不会默认写入磁盘。
+
+## 安全边界
+
+- PC OAuth 默认画像可由构造参数或环境变量覆盖。
+- OAuth secret、Bearer token、refresh token 和 OSS STS 不进入日志或异常文本。
+- 鉴权失效只刷新并重放一次，不作无界重试。
+- 删除、清空回收站、取消分享等方法不会弹出交互确认。
+- 上传 checkpoint 不保存任何临时密钥。
+- live smoke 仅用于显式、只读验证，不属于默认测试。
+
+## 状态
+
+当前版本为 `0.1.0`。API 仍处 Alpha 阶段。
+
+发布前执行模拟协议测试、类型检查与安装包检查。短信登录进入网页验证后可继续原登录，
+不会重复校验已消费的短信验证码。尚未完成真实账号的登录、转存及上传全流程验证。

pguangya-0.1.0/README.md

@@ -0,0 +1,69 @@
+# pguangya
+
+`pguangya` 是面向项目直接集成的光鸭云盘同步 Python 客户端。
+
+它复用光鸭 Windows PC Web 协议，提供纯同步 Python API。项目覆盖账号、
+文件、资产、下载、分享、离线任务和上传主链路；不包含官方开发者
+`dapi.guangyapan.com` OpenAPI、本地 Web 服务、WebDAV 或 HDHive 集成。
+
+> 本项目不是光鸭官方 SDK。逆向协议可能随上游版本变化。请仅在获准账号和
+> 数据范围内使用，并自行遵守服务条款与适用法律。
+
+## 特性
+
+- `PGuangyaClient`：全部已确认的非 Open Web 端点
+- `PGuangyaFileSystem`：ID/路径查询、遍历及文件操作
+- `GuangyaLogin`：扫码、短信登录及会话刷新
+- `PGuangyaHelper`：下载、打包、分享和离线任务工作流
+- `PGuangyaUploadHelper`：GCID 秒传、OSS 单 PUT、multipart 和断点续传
+- 完整响应 envelope 保留，未知字段不丢失
+- 纯同步调用，无 CLI、Web 服务或异步双栈
+
+## 安装
+
+```bash
+pip install pguangya
+```
+
+本地开发：
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+## 快速开始
+
+```python
+from pguangya import GuangyaSession, PGuangyaClient, PGuangyaFileSystem
+
+session = GuangyaSession(
+    access_token="...",
+    refresh_token="...",
+    device_id="0123456789abcdef0123456789abcdef",
+)
+
+with PGuangyaClient(session=session) as client:
+    fs = PGuangyaFileSystem(client)
+    for item in fs.iter_entries("/"):
+        print(item)
+```
+
+登录所得 `access_token`、`refresh_token` 和稳定 `device_id` 只保存在内存中。
+调用方可通过会话导出接口自行持久化；库不会默认写入磁盘。
+
+## 安全边界
+
+- PC OAuth 默认画像可由构造参数或环境变量覆盖。
+- OAuth secret、Bearer token、refresh token 和 OSS STS 不进入日志或异常文本。
+- 鉴权失效只刷新并重放一次，不作无界重试。
+- 删除、清空回收站、取消分享等方法不会弹出交互确认。
+- 上传 checkpoint 不保存任何临时密钥。
+- live smoke 仅用于显式、只读验证，不属于默认测试。
+
+## 状态
+
+当前版本为 `0.1.0`。API 仍处 Alpha 阶段。
+
+发布前执行模拟协议测试、类型检查与安装包检查。短信登录进入网页验证后可继续原登录，
+不会重复校验已消费的短信验证码。尚未完成真实账号的登录、转存及上传全流程验证。

pguangya-0.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pguangya"
+version = "0.1.0"
+description = "Sync-first Python client for Guangya cloud drive Web APIs."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "KC" }]
+keywords = ["guangya", "cloud-drive", "sync", "filesystem"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Internet :: WWW/HTTP",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = ["httpx>=0.27,<1"]
+
+[project.optional-dependencies]
+dev = ["pytest>=8,<9", "mypy>=1.11,<2", "build>=1.2,<2", "twine>=5,<7"]
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.package-data]
+pguangya = ["py.typed"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["pguangya", "pguangya.*"]
+namespaces = false
+
+[tool.pytest.ini_options]
+addopts = "--import-mode=importlib"
+python_files = ["*_test.py"]
+testpaths = ["tests"]

pguangya-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pguangya-0.1.0/src/pguangya/__init__.py

@@ -0,0 +1,22 @@
+from .client import GuangyaSession, PGuangyaClient
+from .filesystem import PGuangyaFileSystem
+from .helpers import PGuangyaHelper
+from .login import GuangyaLogin
+from .oss_upload import OssError, OssUploader, choose_part_size, upload_file_to_oss
+from .upload import PGuangyaUploadHelper, UploadError
+from .version import __version__
+
+__all__ = [
+    "GuangyaLogin",
+    "GuangyaSession",
+    "OssError",
+    "OssUploader",
+    "PGuangyaClient",
+    "PGuangyaFileSystem",
+    "PGuangyaHelper",
+    "PGuangyaUploadHelper",
+    "UploadError",
+    "__version__",
+    "choose_part_size",
+    "upload_file_to_oss",
+]