Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Adopt the deferred private EPUB ingestion prototype into the canonical Reader

Đã đóng
  • Có gì không ổn?
#289 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
24/100
Loại issue
Tính năng
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
python
Lĩnh vực
backend, cli, security, testing

Hướng nghiên cứu

Start by locating and inspecting any surviving EPUB handoff, then compare it with the canonical ingestion layer and current analyzer. Define the supported EPUB subset, reading order, identities, and archive safety limits before integrating useful code. Run the installed CLI through HTML, JSON, and CSV tests using small synthetic fixtures; done means the listed acceptance checks pass and the input subset and failures are documented.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Recovered product debt

Current README and the historical #274 delivery record explicitly retain unpublished EPUB/batch Workbench work. It was not part of the accepted UTF-8 Reader integration (#273/#276), nor of #288's report comparator. Open/closed issue and PR searches found no delivered EPUB integration. The prototype bytes were not recovered in this session; the historical claim is not implementation or test evidence.

User outcome

Analyze a locally supplied, unencrypted EPUB with the same canonical metrics, without uploading the book, executing embedded content or silently treating a container file as its literary body.

Acceptance

  • First locate and inspect any surviving handoff; deduplicate against current source. Recover only useful code into the canonical ingestion layer, not a parallel Workbench/analyzer.
  • Explicit supported EPUB subset and reading-order policy; separate raw archive, extracted body and normalized-text identities and versions. Preserve editions/translations as distinct inputs.
  • Bounded archive/member counts, compressed and expanded bytes; reject traversal, duplicate/ambiguous members, encrypted input, unsupported structures and unsafe XML. Never execute scripts, follow remote resources, write archive paths or bypass DRM.
  • Reuse the actual analyzer and current privacy/error/create-only output semantics; short-text representativeness remains explicit.
  • Real installed CLI -> HTML/JSON/CSV tests with small original synthetic fixtures: reading order, Unicode, missing spine, malformed archives and size/path attacks. No full copyrighted books in fixtures or reports.
  • Document the accepted input subset and failures. No corpus admission, FantLab-input match, new backend or parity claim. M2 remains 0/5.

Independent of #280 browser report comparison. Keep execution ordering in the existing compact project queue; do not create a competing worker or speculative integration branch.

Ngôn ngữ chính
Python
Star
4
Fork
0
Merge trung bình
1 ngày 8 giờ
Pull request đã merge (30 ngày)
36

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của drevendev/Scriptorium

Tất cả issue của drevendev/Scriptorium

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.