diff --git a/README.md b/README.md index 685af99..0bf206c 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,17 @@ PDFReaderLite 是一个面向 Windows 的轻量 PDF 阅读与编辑工具,目 - 中文界面 - Acrobat 风格布局 +## 已加入的增强功能 + +- 下划线、删除线 +- 矩形、圆形、线条、箭头 +- 遮盖区域 +- 插入空白页 +- 插入其他 PDF +- 提取指定页面 +- 按页拆分 PDF +- 合并多个 PDF + ## 本地开发 ```powershell @@ -26,3 +37,9 @@ python -m venv .venv python -m pip install -r requirements.txt python main.py ``` + +运行烟测: + +```powershell +python scripts\smoke_test.py +``` diff --git a/pdfreaderlite/core/document.py b/pdfreaderlite/core/document.py index fbf9929..f313b38 100644 --- a/pdfreaderlite/core/document.py +++ b/pdfreaderlite/core/document.py @@ -96,6 +96,22 @@ class PdfDocument: annot.update() return len(rects) + def underline_text(self, page_index: int, text: str) -> int: + page = self._page(page_index) + rects = page.search_for(text.strip()) + for rect in rects: + annot = page.add_underline_annot(rect) + annot.update() + return len(rects) + + def strikeout_text(self, page_index: int, text: str) -> int: + page = self._page(page_index) + rects = page.search_for(text.strip()) + for rect in rects: + annot = page.add_strikeout_annot(rect) + annot.update() + return len(rects) + def add_note(self, page_index: int, text: str) -> None: page = self._page(page_index) point = fitz.Point(72, 72) @@ -115,6 +131,106 @@ class PdfDocument: rect = fitz.Rect(72, 120, 72 + width, 120 + height) page.insert_image(rect, filename=str(image_path), keep_proportion=True) + def add_rectangle(self, page_index: int) -> None: + page = self._page(page_index) + rect = self._default_rect(page) + annot = page.add_rect_annot(rect) + annot.set_colors(stroke=(0.9, 0.1, 0.1)) + annot.set_border(width=2) + annot.update() + + def add_circle(self, page_index: int) -> None: + page = self._page(page_index) + rect = self._default_rect(page) + annot = page.add_circle_annot(rect) + annot.set_colors(stroke=(0.1, 0.3, 0.9)) + annot.set_border(width=2) + annot.update() + + def add_line(self, page_index: int, arrow: bool = False) -> None: + page = self._page(page_index) + rect = self._default_rect(page) + start = fitz.Point(rect.x0, rect.y0) + end = fitz.Point(rect.x1, rect.y1) + annot = page.add_line_annot(start, end) + annot.set_colors(stroke=(0.1, 0.1, 0.1)) + annot.set_border(width=2) + if arrow: + annot.set_line_ends(fitz.PDF_ANNOT_LE_NONE, fitz.PDF_ANNOT_LE_CLOSED_ARROW) + annot.update() + + def add_cover_area(self, page_index: int) -> None: + page = self._page(page_index) + rect = self._default_rect(page) + annot = page.add_rect_annot(rect) + annot.set_colors(stroke=(1, 1, 1), fill=(1, 1, 1)) + annot.set_border(width=0) + annot.update() + + def insert_blank_page(self, after_page_index: int | None = None) -> int: + if not self._doc: + raise RuntimeError("没有打开 PDF") + if self.page_count: + source = self._page(after_page_index if after_page_index is not None else self.page_count - 1) + width = source.rect.width + height = source.rect.height + else: + width = 595 + height = 842 + insert_at = self.page_count if after_page_index is None else after_page_index + 1 + self._doc.new_page(pno=insert_at, width=width, height=height) + return insert_at + + def insert_pdf(self, source_path: str | Path, after_page_index: int | None = None) -> int: + if not self._doc: + raise RuntimeError("没有打开 PDF") + insert_at = self.page_count if after_page_index is None else after_page_index + 1 + with fitz.open(source_path) as source: + count = source.page_count + self._doc.insert_pdf(source, start_at=insert_at) + return count + + def extract_pages(self, page_numbers: list[int], target_path: str | Path) -> None: + if not self._doc: + raise RuntimeError("没有打开 PDF") + new_doc = fitz.open() + try: + for page_number in page_numbers: + page_index = page_number - 1 + if page_index < 0 or page_index >= self.page_count: + raise ValueError(f"页码超出范围:{page_number}") + new_doc.insert_pdf(self._doc, from_page=page_index, to_page=page_index) + new_doc.save(target_path, garbage=4, deflate=True) + finally: + new_doc.close() + + def split_to_folder(self, target_folder: str | Path) -> None: + if not self._doc: + raise RuntimeError("没有打开 PDF") + folder = Path(target_folder) + folder.mkdir(parents=True, exist_ok=True) + base_name = self.path.stem if self.path else "PDFReaderLite" + for page_index in range(self.page_count): + new_doc = fitz.open() + try: + new_doc.insert_pdf(self._doc, from_page=page_index, to_page=page_index) + new_doc.save(folder / f"{base_name}_第{page_index + 1}页.pdf", garbage=4, deflate=True) + finally: + new_doc.close() + + @staticmethod + def merge_pdfs(source_paths: list[str | Path], target_path: str | Path) -> None: + if not source_paths: + raise ValueError("没有选择 PDF 文件") + merged = fitz.open() + try: + for source_path in source_paths: + with fitz.open(source_path) as source: + merged.insert_pdf(source) + merged.save(target_path, garbage=4, deflate=True) + finally: + merged.close() + def delete_page(self, page_index: int) -> None: if not self._doc: raise RuntimeError("没有打开 PDF") @@ -156,3 +272,11 @@ class PdfDocument: if page_index < 0 or page_index >= len(self._doc): raise IndexError("页码超出范围") return self._doc.load_page(page_index) + + @staticmethod + def _default_rect(page: fitz.Page) -> fitz.Rect: + width = min(220, page.rect.width * 0.45) + height = min(120, page.rect.height * 0.2) + x0 = max(36, page.rect.width * 0.12) + y0 = max(36, page.rect.height * 0.16) + return fitz.Rect(x0, y0, x0 + width, y0 + height) diff --git a/pdfreaderlite/ui/main_window.py b/pdfreaderlite/ui/main_window.py index 0c97386..debc259 100644 --- a/pdfreaderlite/ui/main_window.py +++ b/pdfreaderlite/ui/main_window.py @@ -93,9 +93,7 @@ class MainWindow(QMainWindow): if not self._ensure_document(): return self.document.rotate_page(self.viewer.page_index) - self.viewer.render() - self.sidebar.load_document(self.document) - self.sidebar.select_page(self.viewer.page_index) + self._refresh_document_view() self.statusBar().showMessage("页面已旋转,记得保存", 3000) def delete_page(self) -> None: @@ -114,11 +112,89 @@ class MainWindow(QMainWindow): return self.document.delete_page(self.viewer.page_index) self.viewer.page_index = min(self.viewer.page_index, self.document.page_count - 1) - self.viewer.render() - self.sidebar.load_document(self.document) - self.sidebar.select_page(self.viewer.page_index) + self._refresh_document_view() self.statusBar().showMessage("页面已删除,记得保存", 3000) + def insert_blank_page(self) -> None: + if not self._ensure_document(): + return + new_index = self.document.insert_blank_page(self.viewer.page_index) + self.viewer.go_to_page(new_index) + self._refresh_document_view() + self.statusBar().showMessage("已插入空白页,记得保存", 3000) + + def insert_pdf(self) -> None: + if not self._ensure_document(): + return + selected, _ = QFileDialog.getOpenFileName( + self, "插入 PDF", "", "PDF 文件 (*.pdf);;所有文件 (*.*)" + ) + if not selected: + return + try: + count = self.document.insert_pdf(selected, self.viewer.page_index) + self._refresh_document_view() + self.statusBar().showMessage(f"已插入 {count} 页,记得保存", 3000) + except Exception as exc: + QMessageBox.critical(self, "插入失败", f"无法插入 PDF:\n{exc}") + + def extract_pages(self) -> None: + if not self._ensure_document(): + return + text, ok = QInputDialog.getText( + self, + "提取页面", + "输入页码,例如 1,3,5-8:", + ) + if not ok or not text.strip(): + return + try: + page_numbers = self._parse_page_numbers(text) + except ValueError as exc: + QMessageBox.warning(self, "页码错误", str(exc)) + return + selected, _ = QFileDialog.getSaveFileName( + self, "保存提取页面", "提取页面.pdf", "PDF 文件 (*.pdf)" + ) + if not selected: + return + if not selected.lower().endswith(".pdf"): + selected += ".pdf" + try: + self.document.extract_pages(page_numbers, selected) + self.statusBar().showMessage("页面已提取", 3000) + except Exception as exc: + QMessageBox.critical(self, "提取失败", f"无法提取页面:\n{exc}") + + def split_pdf(self) -> None: + if not self._ensure_document(): + return + folder = QFileDialog.getExistingDirectory(self, "选择拆分保存文件夹") + if not folder: + return + try: + self.document.split_to_folder(folder) + self.statusBar().showMessage("PDF 已按页拆分", 3000) + except Exception as exc: + QMessageBox.critical(self, "拆分失败", f"无法拆分 PDF:\n{exc}") + + def merge_pdfs(self) -> None: + selected_files, _ = QFileDialog.getOpenFileNames( + self, "选择要合并的 PDF", "", "PDF 文件 (*.pdf);;所有文件 (*.*)" + ) + if not selected_files: + return + target, _ = QFileDialog.getSaveFileName(self, "保存合并 PDF", "合并文件.pdf", "PDF 文件 (*.pdf)") + if not target: + return + if not target.lower().endswith(".pdf"): + target += ".pdf" + try: + PdfDocument.merge_pdfs(selected_files, target) + self.statusBar().showMessage("PDF 已合并", 3000) + except Exception as exc: + QMessageBox.critical(self, "合并失败", f"无法合并 PDF:\n{exc}") + def go_to_page_dialog(self) -> None: if not self._ensure_document(): return @@ -195,10 +271,22 @@ class MainWindow(QMainWindow): self.go_to_page_action = QAction("跳转", self) self.rotate_action = QAction("旋转", self) self.delete_action = QAction("删除页", self) + self.insert_blank_action = QAction("插入空白页", self) + self.insert_pdf_action = QAction("插入 PDF", self) + self.extract_pages_action = QAction("提取页面", self) + self.split_pdf_action = QAction("拆分 PDF", self) + self.merge_pdfs_action = QAction("合并 PDF", self) self.highlight_action = QAction("高亮", self) + self.underline_action = QAction("下划线", self) + self.strikeout_action = QAction("删除线", self) self.note_action = QAction("批注", self) self.add_text_action = QAction("添加文本", self) self.insert_image_action = QAction("插入图片", self) + self.rectangle_action = QAction("矩形", self) + self.circle_action = QAction("圆形", self) + self.line_action = QAction("线条", self) + self.arrow_action = QAction("箭头", self) + self.cover_action = QAction("遮盖", self) file_menu = self.menuBar().addMenu("文件") file_menu.addAction(self.open_action) @@ -219,12 +307,24 @@ class MainWindow(QMainWindow): page_menu.addAction(self.go_to_page_action) page_menu.addAction(self.rotate_action) page_menu.addAction(self.delete_action) + page_menu.addAction(self.insert_blank_action) + page_menu.addAction(self.insert_pdf_action) + page_menu.addAction(self.extract_pages_action) + page_menu.addAction(self.split_pdf_action) + page_menu.addAction(self.merge_pdfs_action) edit_menu = self.menuBar().addMenu("编辑") edit_menu.addAction(self.highlight_action) + edit_menu.addAction(self.underline_action) + edit_menu.addAction(self.strikeout_action) edit_menu.addAction(self.note_action) edit_menu.addAction(self.add_text_action) edit_menu.addAction(self.insert_image_action) + edit_menu.addAction(self.rectangle_action) + edit_menu.addAction(self.circle_action) + edit_menu.addAction(self.line_action) + edit_menu.addAction(self.arrow_action) + edit_menu.addAction(self.cover_action) def _build_toolbar(self) -> None: toolbar = QToolBar("主工具栏") @@ -244,11 +344,17 @@ class MainWindow(QMainWindow): self.fit_page_action, self.go_to_page_action, self.highlight_action, + self.underline_action, + self.strikeout_action, self.note_action, self.add_text_action, self.insert_image_action, + self.rectangle_action, + self.circle_action, + self.arrow_action, self.rotate_action, self.delete_action, + self.insert_blank_action, ]: toolbar.addAction(action) @@ -265,10 +371,22 @@ class MainWindow(QMainWindow): self.go_to_page_action.triggered.connect(self.go_to_page_dialog) self.rotate_action.triggered.connect(self.rotate_page) self.delete_action.triggered.connect(self.delete_page) + self.insert_blank_action.triggered.connect(self.insert_blank_page) + self.insert_pdf_action.triggered.connect(self.insert_pdf) + self.extract_pages_action.triggered.connect(self.extract_pages) + self.split_pdf_action.triggered.connect(self.split_pdf) + self.merge_pdfs_action.triggered.connect(self.merge_pdfs) self.highlight_action.triggered.connect(self.highlight_current_page) + self.underline_action.triggered.connect(self.underline_current_page) + self.strikeout_action.triggered.connect(self.strikeout_current_page) self.note_action.triggered.connect(self.add_note) self.add_text_action.triggered.connect(self.add_text) self.insert_image_action.triggered.connect(self.insert_image) + self.rectangle_action.triggered.connect(self.add_rectangle) + self.circle_action.triggered.connect(self.add_circle) + self.line_action.triggered.connect(self.add_line) + self.arrow_action.triggered.connect(self.add_arrow) + self.cover_action.triggered.connect(self.add_cover_area) self.sidebar.page_selected.connect(self.viewer.go_to_page) self.viewer.page_changed.connect(self.sidebar.select_page) @@ -291,6 +409,26 @@ class MainWindow(QMainWindow): self.viewer.render() self.statusBar().showMessage(f"已高亮 {count} 处,记得保存", 3000) + def underline_current_page(self) -> None: + if not self._ensure_document(): + return + text, ok = QInputDialog.getText(self, "下划线", "输入要在当前页标记的文本:") + if not ok or not text.strip(): + return + count = self.document.underline_text(self.viewer.page_index, text) + self.viewer.render() + self.statusBar().showMessage(f"已添加下划线 {count} 处,记得保存", 3000) + + def strikeout_current_page(self) -> None: + if not self._ensure_document(): + return + text, ok = QInputDialog.getText(self, "删除线", "输入要在当前页标记的文本:") + if not ok or not text.strip(): + return + count = self.document.strikeout_text(self.viewer.page_index, text) + self.viewer.render() + self.statusBar().showMessage(f"已添加删除线 {count} 处,记得保存", 3000) + def add_note(self) -> None: if not self._ensure_document(): return @@ -329,6 +467,41 @@ class MainWindow(QMainWindow): except Exception as exc: QMessageBox.critical(self, "插入失败", f"无法插入图片:\n{exc}") + def add_rectangle(self) -> None: + if not self._ensure_document(): + return + self.document.add_rectangle(self.viewer.page_index) + self.viewer.render() + self.statusBar().showMessage("矩形已添加,记得保存", 3000) + + def add_circle(self) -> None: + if not self._ensure_document(): + return + self.document.add_circle(self.viewer.page_index) + self.viewer.render() + self.statusBar().showMessage("圆形已添加,记得保存", 3000) + + def add_line(self) -> None: + if not self._ensure_document(): + return + self.document.add_line(self.viewer.page_index) + self.viewer.render() + self.statusBar().showMessage("线条已添加,记得保存", 3000) + + def add_arrow(self) -> None: + if not self._ensure_document(): + return + self.document.add_line(self.viewer.page_index, arrow=True) + self.viewer.render() + self.statusBar().showMessage("箭头已添加,记得保存", 3000) + + def add_cover_area(self) -> None: + if not self._ensure_document(): + return + self.document.add_cover_area(self.viewer.page_index) + self.viewer.render() + self.statusBar().showMessage("遮盖区域已添加,记得保存", 3000) + def _remember_file(self, path: str) -> None: files = [item for item in self.recent_files if item != path] files.insert(0, path) @@ -357,6 +530,34 @@ class MainWindow(QMainWindow): return False return True + def _refresh_document_view(self) -> None: + self.viewer.render() + self.sidebar.load_document(self.document) + self.sidebar.select_page(self.viewer.page_index) + self._update_status() + + def _parse_page_numbers(self, text: str) -> list[int]: + pages: set[int] = set() + for part in text.replace(",", ",").split(","): + part = part.strip() + if not part: + continue + if "-" in part: + start_text, end_text = part.split("-", 1) + start = int(start_text.strip()) + end = int(end_text.strip()) + if start > end: + raise ValueError("页码范围起始值不能大于结束值。") + pages.update(range(start, end + 1)) + else: + pages.add(int(part)) + if not pages: + raise ValueError("请输入至少一个页码。") + for page in pages: + if page < 1 or page > self.document.page_count: + raise ValueError(f"页码超出范围:{page}") + return sorted(pages) + def _update_title(self) -> None: self.setWindowTitle(f"{self.document.title} - PDFReaderLite") diff --git a/scripts/smoke_test.py b/scripts/smoke_test.py new file mode 100644 index 0000000..7c54c8e --- /dev/null +++ b/scripts/smoke_test.py @@ -0,0 +1,79 @@ +from __future__ import annotations + +import shutil +import tempfile +import sys +from pathlib import Path + +import fitz +from PIL import Image + +PROJECT_ROOT = Path(__file__).resolve().parents[1] +sys.path.insert(0, str(PROJECT_ROOT)) + +from pdfreaderlite.core.document import PdfDocument + + +def create_pdf(path: Path, text: str = "PDFReaderLite feature test") -> None: + doc = fitz.open() + try: + page = doc.new_page() + page.insert_text((72, 72), text) + doc.save(path) + finally: + doc.close() + + +def main() -> int: + temp_dir = Path(tempfile.mkdtemp(prefix="pdfreaderlite_")) + try: + source_pdf = temp_dir / "source.pdf" + insert_pdf = temp_dir / "insert.pdf" + image_path = temp_dir / "image.png" + extracted_pdf = temp_dir / "extract.pdf" + merged_pdf = temp_dir / "merged.pdf" + split_folder = temp_dir / "split" + + create_pdf(source_pdf) + create_pdf(insert_pdf, "inserted page") + Image.new("RGB", (80, 60), (80, 130, 220)).save(image_path) + + document = PdfDocument() + document.open(source_pdf) + assert document.render_page(0, 1.0).width() > 0 + assert document.search("feature") + assert document.highlight_text(0, "feature") == 1 + assert document.underline_text(0, "feature") == 1 + assert document.strikeout_text(0, "feature") == 1 + + document.add_note(0, "note") + document.add_text(0, "PDFReaderLite") + document.insert_image(0, image_path) + document.add_rectangle(0) + document.add_circle(0) + document.add_line(0) + document.add_line(0, arrow=True) + document.add_cover_area(0) + + blank_index = document.insert_blank_page(0) + assert blank_index == 1 + assert document.insert_pdf(insert_pdf, blank_index) == 1 + assert document.page_count == 3 + + document.extract_pages([1, 3], extracted_pdf) + document.split_to_folder(split_folder) + PdfDocument.merge_pdfs([source_pdf, insert_pdf], merged_pdf) + document.save() + document.close() + + assert extracted_pdf.exists() + assert merged_pdf.exists() + assert len(list(split_folder.glob("*.pdf"))) == 3 + print("PDFReaderLite smoke test passed.") + return 0 + finally: + shutil.rmtree(temp_dir, ignore_errors=True) + + +if __name__ == "__main__": + raise SystemExit(main())