parsehub 2.0.4__tar.gz → 2.0.6__tar.gz

{parsehub-2.0.4 → parsehub-2.0.6}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 梓澪
-
-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.
+MIT License
+
+Copyright (c) 2024 梓澪
+
+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.

{parsehub-2.0.4/src/parsehub.egg-info → parsehub-2.0.6}/PKG-INFO

@@ -1,178 +1,197 @@
-Metadata-Version: 2.4
-Name: parsehub
-Version: 2.0.4
-Summary: 轻量、异步、开箱即用的社交媒体聚合解析库
-Author-email: 梓澪 <zilingmio@gmail.com>
-License: MIT
-Project-URL: Repository, https://github.com/z-mio/parsehub
-Project-URL: Issues, https://github.com/z-mio/parsehub/issues
-Keywords: parser,video-downloader,social-media,crawler,parsehub
-Classifier: Programming Language :: Python :: 3.12
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Multimedia :: Video
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.12.0
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: aiofiles>=23.2
-Requires-Dist: beautifulsoup4>=4.12.3
-Requires-Dist: loguru>=0.6.0
-Requires-Dist: opencv-python>=4.10.0.84
-Requires-Dist: pydub>=0.25.1
-Requires-Dist: python-dotenv>=1.0.1
-Requires-Dist: tenacity>=8.5.0
-Requires-Dist: urlextract>=1.9.0
-Requires-Dist: yt-dlp[default]
-Requires-Dist: lxml>=5.3.0
-Requires-Dist: instaloader>=4.14
-Requires-Dist: pydantic>=1.10.19
-Requires-Dist: markdownify>=1.1.0
-Requires-Dist: markdown>=3.7
-Requires-Dist: requests
-Requires-Dist: httpx>=0.24.1
-Requires-Dist: pillow>=12.1.0
-Requires-Dist: python-slugify[unidecode]>=8.0.4
-Dynamic: license-file
-
-<div align="center">
-
-# 🔗 ParseHub
-
-**社交媒体聚合解析器**
-
-[![PyPI version](https://img.shields.io/pypi/v/parsehub?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/parsehub/)
-[![Python](https://img.shields.io/badge/python-3.12+-blue?logo=python&logoColor=white)](https://www.python.org/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![GitHub stars](https://img.shields.io/github/stars/z-mio/parsehub?style=social)](https://github.com/z-mio/parsehub)
-
-轻量、异步、开箱即用的社交媒体聚合解析库，支持 16+ 平台 🚀
-
-[快速开始](#-快速开始) · [支持平台](#-支持平台) · [高级用法](#-高级用法) · [TG Bot](https://github.com/z-mio/parse_hub_bot)
-
-</div>
-
----
-
-## ✨ 特性
-
-- 🌍 **广泛的平台支持** — 覆盖国内外 16+ 主流社交媒体
-- 🧹 **隐私保护** — 自动清除链接中的跟踪参数, 返回干净的原始链接
-- 🎬 **多媒体支持** — 视频 / 图文 / 动图 / 实况照片，一网打尽
-- 📦 **开箱即用** — `async/await` 原生支持，API 极简
-- 🤖 **Telegram Bot** — 基于本项目的 Bot 已上线 → [@ParsehuBot](https://t.me/ParsehuBot)
-
-## 📦 安装
-
-```bash
-# pip
-pip install parsehub
-
-# uv (推荐)
-uv add parsehub
-```
-
-> 要求 Python ≥ 3.12
-
-## 🚀 快速开始
-
-```python
-from parsehub import ParseHub
-
-result = ParseHub().parse_sync("https://www.xiaoheihe.cn/app/bbs/link/174972336")
-print(result)
-# ImageParseResult(platform=小黑盒, title=名为希望和绝望的红包, content=[cube_doge][cube_doge][cube_doge], media=[17], raw_url=https://www.xiaoheihe.cn/app/bbs/link/174972336)
-```
-
-### 下载媒体
-
-```python
-from parsehub import ParseHub
-
-result = ParseHub().download_sync("https://www.xiaoheihe.cn/app/bbs/link/174972336")
-print(result)
-# DownloadResult(media=[ImageFile(path='D:\\downloads\\名为希望和绝望的红包\\0.jpg', width=1773, height=2364), ...], output_dir=D:\downloads\名为希望和绝望的红包)
-```
-
-## 🌐 支持平台
-
-| 平台              | 视频 | 图文 |  其他   |
-|:----------------|:--:|:--:|:-----:|
-| **Twitter / X** | ✅  | ✅  |       |
-| **Instagram**   | ✅  | ✅  |       |
-| **YouTube**     | ✅  |    | 🎵 音乐 |
-| **Facebook**    | ✅  |    |       |
-| **Threads**     | ✅  | ✅  |       |
-| **Bilibili**    | ✅  |    | 📝 动态 |
-| **抖音 / TikTok** | ✅  | ✅  |       |
-| **微博**          | ✅  | ✅  |       |
-| **小红书**         | ✅  | ✅  |       |
-| **贴吧**          | ✅  | ✅  |       |
-| **微信公众号**       |    | ✅  |       |
-| **快手**          | ✅  |    |       |
-| **酷安**          | ✅  | ✅  |       |
-| **皮皮虾**         | ✅  | ✅  |       |
-| **最右**          | ✅  | ✅  |       |
-| **小黑盒**         | ✅  | ✅  |       |
-
-> 🔧 更多平台持续接入中...
-
-## 🔑 高级用法
-
-### Cookie 登录 & 代理
-
-部分平台的内容需要登录才能访问，通过 Cookie 即可解锁：
-
-```python
-from parsehub import ParseHub
-
-ph = ParseHub(cookie="key1=value1; key2=value2", proxy="http://127.0.0.1:7890",)
-```
-
-Cookie 支持多种格式传入：
-
-```python
-# 字符串
-ParseHub(cookie="key1=value1; key2=value2")
-
-# JSON 字符串
-ParseHub(cookie='{"key1": "value1", "key2": "value2"}')
-
-# 字典
-ParseHub(cookie={"key1": "value1", "key2": "value2"})
-```
-
-目前支持 Cookie 登录的平台:
-
-`Twitter` · `Instagram` · `Kuaishou` · `Bilibili` · `YouTube`
-
-### 全局配置
-
-```python
-from parsehub.config import GlobalConfig
-
-# 自定义默认下载目录
-GlobalConfig.default_save_dir = "./my_downloads"
-```
-
-## 🤝 参考项目
-
-- [Evil0ctal/Douyin_TikTok_Download_API](https://github.com/Evil0ctal/Douyin_TikTok_Download_API)
-- [yt-dlp/yt-dlp](https://github.com/yt-dlp/yt-dlp)
-- [instaloader/instaloader](https://github.com/instaloader/instaloader)
-- [SocialSisterYi/bilibili-API-collect](https://github.com/SocialSisterYi/bilibili-API-collect)
-- [Nemo2011/bilibili-api](https://github.com/Nemo2011/bilibili-api)
-
-## 📜 开源协议
-
-本项目基于 [MIT License](LICENSE) 开源。
-
----
-
-<div align="center">
-
-**如果这个项目对你有帮助，欢迎点个 ⭐ Star！**
-
-</div>
-
-
+Metadata-Version: 2.4
+Name: parsehub
+Version: 2.0.6
+Summary: 轻量、异步、开箱即用的社交媒体聚合解析库
+Author-email: 梓澪 <zilingmio@gmail.com>
+License: MIT
+Project-URL: Repository, https://github.com/z-mio/parsehub
+Project-URL: Issues, https://github.com/z-mio/parsehub/issues
+Keywords: parser,video-downloader,social-media,crawler,parsehub
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.12.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiofiles>=23.2
+Requires-Dist: beautifulsoup4>=4.12.3
+Requires-Dist: loguru>=0.6.0
+Requires-Dist: opencv-python>=4.10.0.84
+Requires-Dist: pydub>=0.25.1
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: tenacity>=8.5.0
+Requires-Dist: urlextract>=1.9.0
+Requires-Dist: yt-dlp[default]
+Requires-Dist: lxml>=5.3.0
+Requires-Dist: instaloader>=4.14
+Requires-Dist: pydantic>=1.10.19
+Requires-Dist: markdownify>=1.1.0
+Requires-Dist: markdown>=3.7
+Requires-Dist: requests
+Requires-Dist: httpx>=0.24.1
+Requires-Dist: pillow>=12.1.0
+Requires-Dist: python-slugify[unidecode]>=8.0.4
+Dynamic: license-file
+
+<div align="center">
+
+# 🔗 ParseHub
+
+**社交媒体聚合解析器**
+
+[![PyPI version](https://img.shields.io/pypi/v/parsehub?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/parsehub/)
+[![Python](https://img.shields.io/badge/python-3.12+-blue?logo=python&logoColor=white)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/z-mio/parsehub?style=social)](https://github.com/z-mio/parsehub)
+
+轻量、异步、开箱即用的社交媒体聚合解析库，支持 16+ 平台 🚀
+
+[快速开始](#-快速开始) · [支持平台](#-支持平台) · [高级用法](#-高级用法) · [TG Bot](https://github.com/z-mio/parse_hub_bot)
+
+</div>
+
+---
+
+## ✨ 特性
+
+- 🌍 **广泛的平台支持** — 覆盖国内外 16+ 主流社交媒体
+- 🧹 **隐私保护** — 自动清除链接中的跟踪参数, 返回干净的原始链接
+- 🎬 **多媒体支持** — 视频 / 图文 / 动图 / 实况照片，一网打尽
+- 📦 **开箱即用** — `async/await` 原生支持，API 极简
+- 🤖 **Telegram Bot** — 基于本项目的 Bot 已上线 → [@ParsehuBot](https://t.me/ParsehuBot)
+
+## 📦 安装
+
+```bash
+# pip
+pip install parsehub
+
+# uv (推荐)
+uv add parsehub
+```
+
+> 要求 Python ≥ 3.12
+
+## 🚀 快速开始
+
+```python
+from parsehub import ParseHub
+
+result = ParseHub().parse_sync("https://www.xiaoheihe.cn/app/bbs/link/174972336")
+print(result)
+# ImageParseResult(platform=小黑盒, title=名为希望和绝望的红包, content=[cube_doge][cube_doge][cube_doge], media=[17], raw_url=https://www.xiaoheihe.cn/app/bbs/link/174972336)
+```
+
+### 下载媒体
+
+```python
+from parsehub import ParseHub
+
+result = ParseHub().download_sync("https://www.xiaoheihe.cn/app/bbs/link/174972336")
+print(result)
+# DownloadResult(media=[ImageFile(path='D:\\downloads\\名为希望和绝望的红包\\0.jpg', width=1773, height=2364), ...], output_dir=D:\downloads\名为希望和绝望的红包)
+```
+
+## 🌐 支持平台
+
+| 平台              | 视频 | 图文 |  其他   |
+|:----------------|:--:|:--:|:-----:|
+| **Twitter / X** | ✅  | ✅  |       |
+| **Instagram**   | ✅  | ✅  |       |
+| **YouTube**     | ✅  |    | 🎵 音乐 |
+| **Facebook**    | ✅  |    |       |
+| **Threads**     | ✅  | ✅  |       |
+| **Bilibili**    | ✅  |    | 📝 动态 |
+| **抖音 / TikTok** | ✅  | ✅  |       |
+| **微博**          | ✅  | ✅  |       |
+| **小红书**         | ✅  | ✅  |       |
+| **贴吧**          | ✅  | ✅  |       |
+| **微信公众号**       |    | ✅  |       |
+| **快手**          | ✅  |    |       |
+| **酷安**          | ✅  | ✅  |       |
+| **皮皮虾**         | ✅  | ✅  |       |
+| **最右**          | ✅  | ✅  |       |
+| **小黑盒**         | ✅  | ✅  |       |
+
+> 🔧 更多平台持续接入中...
+
+## 🔑 高级用法
+
+### 下载进度回调
+
+```python
+from parsehub import ParseHub
+
+
+class ProgressTracker:
+    async def __call__(self, current: int, total: int, unit: str, *args, task_name: str = "", **kwargs):
+        print(f"[{task_name}] {current}/{total} ({unit})")
+
+
+result = ParseHub().download_sync(
+    "https://example.com",
+    callback=ProgressTracker(),
+    callback_args=("extra_arg",),
+    callback_kwargs={"task_name": "demo"},
+)
+```
+
+### Cookie 登录 & 代理
+
+部分平台的内容需要登录才能访问，通过 Cookie 即可解锁：
+
+```python
+from parsehub import ParseHub
+
+ph = ParseHub(cookie="key1=value1; key2=value2", proxy="http://127.0.0.1:7890", )
+```
+
+Cookie 支持多种格式传入：
+
+```python
+# 字符串
+ParseHub(cookie="key1=value1; key2=value2")
+
+# JSON 字符串
+ParseHub(cookie='{"key1": "value1", "key2": "value2"}')
+
+# 字典
+ParseHub(cookie={"key1": "value1", "key2": "value2"})
+```
+
+目前支持 Cookie 登录的平台:
+
+`Twitter` · `Instagram` · `Kuaishou` · `Bilibili` · `YouTube`
+
+### 全局配置
+
+```python
+from parsehub.config import GlobalConfig
+
+# 自定义默认下载目录
+GlobalConfig.default_save_dir = "./my_downloads"
+```
+
+## 🤝 参考项目
+
+- [Evil0ctal/Douyin_TikTok_Download_API](https://github.com/Evil0ctal/Douyin_TikTok_Download_API)
+- [yt-dlp/yt-dlp](https://github.com/yt-dlp/yt-dlp)
+- [instaloader/instaloader](https://github.com/instaloader/instaloader)
+- [SocialSisterYi/bilibili-API-collect](https://github.com/SocialSisterYi/bilibili-API-collect)
+- [Nemo2011/bilibili-api](https://github.com/Nemo2011/bilibili-api)
+
+## 📜 开源协议
+
+本项目基于 [MIT License](LICENSE) 开源。
+
+---
+
+<div align="center">
+
+**如果这个项目对你有帮助，欢迎点个 ⭐ Star！**
+
+</div>
+
+