ituring-fetch 0.1.0__tar.gz

ituring_fetch-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+*.pdf
+*.epub

ituring_fetch-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

ituring_fetch-0.1.0/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: ituring-fetch
+Version: 0.1.0
+Summary: CLI tool to scrape purchased ebooks from ituring.com.cn
+Author-email: yms_hi <yms_hi@Outlook.com>
+Requires-Python: >=3.11
+Requires-Dist: click>=8
+Requires-Dist: httpx>=0.27
+Requires-Dist: playwright>=1.40
+Requires-Dist: rich>=13
+Description-Content-Type: text/markdown
+
+# ituring-fetch
+
+把图灵社区已购电子书扒下来，转成 epub/pdf/html。
+
+## 安装
+
+```bash
+git clone <repo>
+cd ituring_fetch
+uv sync
+playwright install chromium   # 或者用系统自带的 Chrome
+```
+
+依赖：Python 3.11+、pandoc（epub 格式需要）、Chrome/Chromium。
+
+## 使用
+
+```bash
+# 登录（会弹出浏览器窗口）
+uv run ituring-fetch login
+
+# 看看登录没
+uv run ituring-fetch status
+
+# 列出已购电子书
+uv run ituring-fetch list
+
+# 抓取一本书
+uv run ituring-fetch fetch 1143 --type=epub
+uv run ituring-fetch fetch 1143 --type=pdf
+uv run ituring-fetch fetch 1143 --type=html
+
+# 指定输出文件名
+uv run ituring-fetch fetch 1143 --type=pdf -o mybook.pdf
+
+# 登出
+uv run ituring-fetch logout
+```
+
+`list` 输出的第一列就是书籍 ID。
+
+## 调试
+
+出问题时设个环境变量看详细日志：
+
+```bash
+ITURING_DEBUG=1 uv run ituring-fetch fetch 1143 --type=pdf
+```
+
+会往 stderr 打请求/响应细节。
+
+## 原理
+
+登录时用 Playwright 打开浏览器，你手动登录后，程序从 localStorage 里取出 access token，跟 cookie 一起存到 `~/.ituring/credentials.json`。
+
+后续操作：
+- `list` 和书籍信息直接调 `api.ituring.com.cn` 的接口，带 Bearer token
+- 章节内容用 Playwright headless 渲染页面，抽 `.article-content` 的 HTML
+- 合并所有章节，pandoc 转 epub，Playwright 内置 PDF 引擎出 pdf

ituring_fetch-0.1.0/README.en.md

@@ -0,0 +1,58 @@
+# ituring-fetch
+
+Download purchased ebooks from ituring.com.cn and convert to epub/pdf/html.
+
+## Install
+
+```bash
+git clone <repo>
+cd ituring_fetch
+uv sync
+playwright install chromium   # or use system Chrome
+```
+
+Requires Python 3.11+, pandoc (for epub output), Chrome/Chromium.
+
+## Usage
+
+```bash
+# Login (opens a browser window)
+uv run ituring-fetch login
+
+# Check login status
+uv run ituring-fetch status
+
+# List purchased ebooks
+uv run ituring-fetch list
+
+# Download a book
+uv run ituring-fetch fetch 1143 --type=epub
+uv run ituring-fetch fetch 1143 --type=pdf
+uv run ituring-fetch fetch 1143 --type=html
+
+# Custom output filename
+uv run ituring-fetch fetch 1143 --type=pdf -o mybook.pdf
+
+# Logout
+uv run ituring-fetch logout
+```
+
+The first column from `list` is the book ID.
+
+## Debugging
+
+Set `ITURING_DEBUG=1` to see request/response details on stderr:
+
+```bash
+ITURING_DEBUG=1 uv run ituring-fetch fetch 1143 --type=pdf
+```
+
+## How it works
+
+Login opens a browser via Playwright. After you sign in manually, the tool extracts the access token from localStorage and saves it alongside cookies to `~/.ituring/credentials.json`.
+
+From there:
+
+- `list` and book metadata use the `api.ituring.com.cn` REST API with Bearer auth
+- Chapter content is scraped by rendering each chapter page in headless Playwright and extracting `.article-content` innerHTML
+- All chapters are assembled into a single HTML document, then converted via pandoc (epub) or Playwright's built-in PDF engine (pdf)

ituring_fetch-0.1.0/README.md

@@ -0,0 +1,59 @@
+# ituring-fetch
+
+把图灵社区已购电子书扒下来，转成 epub/pdf/html。
+
+## 安装
+
+```bash
+git clone <repo>
+cd ituring_fetch
+uv sync
+playwright install chromium   # 或者用系统自带的 Chrome
+```
+
+依赖：Python 3.11+、pandoc（epub 格式需要）、Chrome/Chromium。
+
+## 使用
+
+```bash
+# 登录（会弹出浏览器窗口）
+uv run ituring-fetch login
+
+# 看看登录没
+uv run ituring-fetch status
+
+# 列出已购电子书
+uv run ituring-fetch list
+
+# 抓取一本书
+uv run ituring-fetch fetch 1143 --type=epub
+uv run ituring-fetch fetch 1143 --type=pdf
+uv run ituring-fetch fetch 1143 --type=html
+
+# 指定输出文件名
+uv run ituring-fetch fetch 1143 --type=pdf -o mybook.pdf
+
+# 登出
+uv run ituring-fetch logout
+```
+
+`list` 输出的第一列就是书籍 ID。
+
+## 调试
+
+出问题时设个环境变量看详细日志：
+
+```bash
+ITURING_DEBUG=1 uv run ituring-fetch fetch 1143 --type=pdf
+```
+
+会往 stderr 打请求/响应细节。
+
+## 原理
+
+登录时用 Playwright 打开浏览器，你手动登录后，程序从 localStorage 里取出 access token，跟 cookie 一起存到 `~/.ituring/credentials.json`。
+
+后续操作：
+- `list` 和书籍信息直接调 `api.ituring.com.cn` 的接口，带 Bearer token
+- 章节内容用 Playwright headless 渲染页面，抽 `.article-content` 的 HTML
+- 合并所有章节，pandoc 转 epub，Playwright 内置 PDF 引擎出 pdf

ituring_fetch-0.1.0/TODO.md

@@ -0,0 +1,11 @@
+# Implementation Tasks
+
+- [x] Task 1: Project Setup + Models
+- [x] Task 2: Auth Module (cookie handling)
+- [x] Task 3: API Client
+- [x] Task 4: Auth Operations (login/logout/status)
+- [x] Task 5: CLI (login, logout, status, list)
+- [x] Task 6: Scraper (chapter content)
+- [x] Task 7: Converter (HTML + pandoc)
+- [x] Task 8: CLI fetch command
+- [x] Task 9: Integration Verification