isbnx
从 PDF、图片、EPUB、MOBI 和压缩包中智能提取 ISBN 号
安装
pip install isbnx
# 或
uv add isbnx
系统依赖
pyzbar（条形码解码）:
- Windows: 需要安装 Visual C++ 运行库
- macOS: 设置环境变量
export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH
pdf-inspector（可选，PDF 类型检测）: 参考安装
快速开始
from isbnx import extract
result = extract("cover.png")
if result.success:
print(result.bookinfo.isbn13) # 9787123456789
# 优先从文件名提取（跳过内容扫描，更快）
result = extract("9787123456789_三体.epub", filename=True)
CLI
isbnx cover.png # 提取并打印结果
isbnx --json book.pdf # JSON 格式输出
isbnx --strict 2 book.zip
isbnx --filename 9787123456789.epub # 从文件名提取
支持格式
| 类型 | 格式 | 提取策略 |
|---|---|---|
| 图片 | PNG / JPG / WebP / BMP / PDG | ONNX 检测 → OCR / 条码 |
| 文本搜索 / 渲染检测 | ||
| EPUB | EPUB | OPF 元数据 → XHTML 扫描 |
| MOBI | MOBI | EXTH 元数据 → 文本扫描 |
| 压缩包 | ZIP / RAR / 7Z / UVZ | meta.xml → bookinfo.dat → PDG 图片 |
批量处理
对整个目录进行批量 ISBN 提取与文件整理：
from isbnx.batch import Batch
result = Batch(
source_dir="D:/books",
success_dir="D:/books/done",
failed_dir="D:/books/unrecognized",
).run()
print(result)
也可配合 BatchConfig 自定义行为：
from isbnx.batch import Batch, BatchConfig
config = BatchConfig(
rename_mode=3, # 替换旧标识再追加（默认）
extensions={".epub", ".pdf"},
max_workers=4,
keep_tree=True, # 保留源目录结构
)
result = Batch(
source_dir="D:/books",
success_dir="D:/done",
failed_dir="D:/fail",
config=config,
try_run=True, # 先预览不实际移动
).run()
支持 4 种重命名模式、多线程并行、文件去重、干运行预览、CSV 报告导出、进度回调、优雅终止和源目录结构保留。
详细文档
完整文档、API 参考、提取流程请访问：
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
isbnx-0.0.13.tar.gz
(10.0 MB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
isbnx-0.0.13-py3-none-any.whl
(10.0 MB
view details)
File details
Details for the file isbnx-0.0.13.tar.gz.
File metadata
- Download URL: isbnx-0.0.13.tar.gz
- Upload date:
- Size: 10.0 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
310e83c1018b937c72e97e80ea6a752ad72a449241bf30a1e90c749988ab49c1
|
|
| MD5 |
fed8f50520d702bc25c384f315b7c42c
|
|
| BLAKE2b-256 |
167627f39a61f81bcb1bbbf3a9f2c4b16d4921bcb2f2feaf45b118137889c4cf
|
File details
Details for the file isbnx-0.0.13-py3-none-any.whl.
File metadata
- Download URL: isbnx-0.0.13-py3-none-any.whl
- Upload date:
- Size: 10.0 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
32ef1cdc189b924f0b89eddd76c6e72cb0fb88a58a6a338e476b6db53e196493
|
|
| MD5 |
80a496bccbb264dea3673b5fd0319d31
|
|
| BLAKE2b-256 |
f4dbd2f492843878b6c1bf9d116ec1d2f45fc6a9472dcdbf4bb99c1883c9ab3d
|
