yema 0.1.0__tar.gz

yema-0.1.0/.gitignore

@@ -0,0 +1,27 @@
+.DS_Store
+.python-version
+
+.venv/
+venv/
+env/
+
+__pycache__/
+*.py[cod]
+*.so
+
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+
+build/
+dist/
+*.egg-info/
+
+tmp/
+*.tmp
+*.torrent
+
+.yema/

yema-0.1.0/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: yema
+Version: 0.1.0
+Summary: yemapt/qBittorrent helper for seeding and torrent checks
+Author-email: mustangpt <admin@yemapt.org>
+License: MIT
+Requires-Python: >=3.11
+Requires-Dist: typer>=0.9.0
+Requires-Dist: wcwidth>=0.2.6
+Description-Content-Type: text/markdown
+
+# yema
+
+`yema` 是一个面向 yemapt 和 qBittorrent 的命令行辅助工具，用来管理保种、检查站点收录情况，并辅助半自动转种。
+
+## 功能
+
+- 配置 yemapt `auth` 和 qBittorrent Web API 登录信息。
+- 查看 qBittorrent 中的种子列表和种子详情。
+- 基于 Pieces Hash 查找 qBittorrent 中内容完全相同的重复种子。
+- 检查 qBittorrent 中的种子是否已经被 yemapt 收录。
+- 显示已收录种子的 yemapt 种子 ID 和当前做种状态。
+- 辅助补种：对已被 yemapt 收录但当前用户未做种的项目，下载新种并添加到 qBittorrent。
+- 辅助转种：列出 qBittorrent 中尚未被 yemapt 收录的种子，并尽量展示来源站点详情页。
+
+## 安装
+
+从 PyPI 安装：
+
+```bash
+pip install yema
+```
+
+如果使用 `uv`：
+
+```bash
+uv tool install yema
+```
+
+源码运行：
+
+```bash
+git clone <repo-url>
+cd yema
+uv sync
+uv run yema --help
+```
+
+## 初始化
+
+首次使用建议运行交互式初始化：
+
+```bash
+yema init
+```
+
+初始化会依次配置：
+
+- yemapt auth
+- qBittorrent Web API 地址、用户名和密码
+
+配置会保存到：
+
+```text
+~/.yema/setting.json
+```
+
+也可以用命令单独配置：
+
+```bash
+yema config yemapt --auth "YOUR_YEMAPT_AUTH"
+yema config qb --host "http://127.0.0.1:8080" --username "qbuser" --password "qbpass"
+```
+
+查看当前配置：
+
+```bash
+yema config
+```
+
+## 常用命令
+
+进入 qBittorrent 操作菜单：
+
+```bash
+yema qb
+```
+
+菜单中支持：
+
+- `list`：查看 qBittorrent 当前种子列表。
+- `pieces_dedup`：按 Pieces Hash 查找重复内容。
+
+检查 qBittorrent 种子是否已被 yemapt 收录：
+
+```bash
+yema check
+```
+
+辅助保种：
+
+```bash
+yema seed
+```
+
+`seed` 会分析 qBittorrent 中的种子，找出已被 yemapt 收录但当前用户未做种的项目。执行前会逐个确认，不会自动批量修改。
+
+辅助转种：
+
+```bash
+yema pub
+```
+
+`pub` 会列出 qBittorrent 中尚未被 yemapt 收录的种子，并显示 tracker 来源。对于部分站点，工具会尝试解析并展示详情页 URL，方便手动转种。
+
+## Debug
+
+启用 debug：
+
+```bash
+yema config debug enable
+```
+
+关闭 debug：
+
+```bash
+yema config debug disable
+```
+
+debug 模式会输出 qBittorrent 和 yemapt 请求过程，适合排查登录失败、接口失败、下载种子失败等问题。较长的响应内容会写入当前目录的 `tmp/` 下。
+
+## 缓存
+
+工具会在 `~/.yema/` 下保存本地缓存，用于减少重复请求：
+
+- qBittorrent 种子的 Pieces Hash
+- tracker 信息
+- yemapt Pieces Hash 查询结果
+
+如果发现结果明显不符合预期，可以删除 `~/.yema/` 下对应缓存文件后重试。
+
+## 注意事项
+
+- 需要先启用 qBittorrent Web UI，并确保当前机器可以访问 Web API。
+- `seed` 添加新种时会使用原 qBittorrent 种子的保存路径，并开启跳过校验添加。
+- 替换已有非当前用户 yemapt 做种时，工具只删除 qBittorrent 中的旧任务，不删除本地文件。
+- `pub` 只是辅助列出未收录种子，不会自动发布到 yemapt。
+
+## 配置示例
+
+```json
+{
+  "yemapt": {
+    "auth": "YOUR_YEMAPT_AUTH"
+  },
+  "qb": {
+    "host": "http://127.0.0.1:8080",
+    "username": "qbuser",
+    "password": "qbpass"
+  },
+  "debug": false
+}
+```

yema-0.1.0/README.md

@@ -0,0 +1,152 @@
+# yema
+
+`yema` 是一个面向 yemapt 和 qBittorrent 的命令行辅助工具，用来管理保种、检查站点收录情况，并辅助半自动转种。
+
+## 功能
+
+- 配置 yemapt `auth` 和 qBittorrent Web API 登录信息。
+- 查看 qBittorrent 中的种子列表和种子详情。
+- 基于 Pieces Hash 查找 qBittorrent 中内容完全相同的重复种子。
+- 检查 qBittorrent 中的种子是否已经被 yemapt 收录。
+- 显示已收录种子的 yemapt 种子 ID 和当前做种状态。
+- 辅助补种：对已被 yemapt 收录但当前用户未做种的项目，下载新种并添加到 qBittorrent。
+- 辅助转种：列出 qBittorrent 中尚未被 yemapt 收录的种子，并尽量展示来源站点详情页。
+
+## 安装
+
+从 PyPI 安装：
+
+```bash
+pip install yema
+```
+
+如果使用 `uv`：
+
+```bash
+uv tool install yema
+```
+
+源码运行：
+
+```bash
+git clone <repo-url>
+cd yema
+uv sync
+uv run yema --help
+```
+
+## 初始化
+
+首次使用建议运行交互式初始化：
+
+```bash
+yema init
+```
+
+初始化会依次配置：
+
+- yemapt auth
+- qBittorrent Web API 地址、用户名和密码
+
+配置会保存到：
+
+```text
+~/.yema/setting.json
+```
+
+也可以用命令单独配置：
+
+```bash
+yema config yemapt --auth "YOUR_YEMAPT_AUTH"
+yema config qb --host "http://127.0.0.1:8080" --username "qbuser" --password "qbpass"
+```
+
+查看当前配置：
+
+```bash
+yema config
+```
+
+## 常用命令
+
+进入 qBittorrent 操作菜单：
+
+```bash
+yema qb
+```
+
+菜单中支持：
+
+- `list`：查看 qBittorrent 当前种子列表。
+- `pieces_dedup`：按 Pieces Hash 查找重复内容。
+
+检查 qBittorrent 种子是否已被 yemapt 收录：
+
+```bash
+yema check
+```
+
+辅助保种：
+
+```bash
+yema seed
+```
+
+`seed` 会分析 qBittorrent 中的种子，找出已被 yemapt 收录但当前用户未做种的项目。执行前会逐个确认，不会自动批量修改。
+
+辅助转种：
+
+```bash
+yema pub
+```
+
+`pub` 会列出 qBittorrent 中尚未被 yemapt 收录的种子，并显示 tracker 来源。对于部分站点，工具会尝试解析并展示详情页 URL，方便手动转种。
+
+## Debug
+
+启用 debug：
+
+```bash
+yema config debug enable
+```
+
+关闭 debug：
+
+```bash
+yema config debug disable
+```
+
+debug 模式会输出 qBittorrent 和 yemapt 请求过程，适合排查登录失败、接口失败、下载种子失败等问题。较长的响应内容会写入当前目录的 `tmp/` 下。
+
+## 缓存
+
+工具会在 `~/.yema/` 下保存本地缓存，用于减少重复请求：
+
+- qBittorrent 种子的 Pieces Hash
+- tracker 信息
+- yemapt Pieces Hash 查询结果
+
+如果发现结果明显不符合预期，可以删除 `~/.yema/` 下对应缓存文件后重试。
+
+## 注意事项
+
+- 需要先启用 qBittorrent Web UI，并确保当前机器可以访问 Web API。
+- `seed` 添加新种时会使用原 qBittorrent 种子的保存路径，并开启跳过校验添加。
+- 替换已有非当前用户 yemapt 做种时，工具只删除 qBittorrent 中的旧任务，不删除本地文件。
+- `pub` 只是辅助列出未收录种子，不会自动发布到 yemapt。
+
+## 配置示例
+
+```json
+{
+  "yemapt": {
+    "auth": "YOUR_YEMAPT_AUTH"
+  },
+  "qb": {
+    "host": "http://127.0.0.1:8080",
+    "username": "qbuser",
+    "password": "qbpass"
+  },
+  "debug": false
+}
+```

yema-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "yema"
+version = "0.1.0"
+description = "yemapt/qBittorrent helper for seeding and torrent checks"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [
+    { name = "mustangpt", email = "admin@yemapt.org" }
+  ]
+dependencies = [
+    "typer>=0.9.0",
+    "wcwidth>=0.2.6",
+]
+
+[project.scripts]
+yema = "yema.main:main"
+
+[build-system]
+requires = ["hatchling>=1.16.0"]
+build-backend = "hatchling.build"
+
+[tool.uv]
+# uv 会自动识别 pyproject.toml 中的项目依赖。
+# 这里可以添加 uv 特定配置，例如运行环境、锁文件位置等。
+
+[tool.hatch.build.targets.wheel]
+packages = ["yema"]
+
+[dependency-groups]
+dev = [
+    "build>=1.5.0",
+    "twine>=6.2.0",
+]