Add export metadata signature and security tools

This commit is contained in:
2026-06-29 15:05:19 +08:00
parent 6509d8a6f2
commit edeae5df5a
5 changed files with 331 additions and 7 deletions
+103
View File
@@ -37,6 +37,9 @@ class PdfDocument:
self.close()
self.path = Path(path)
self._doc = fitz.open(self.path)
if self._doc.needs_pass:
self.close()
raise RuntimeError("该 PDF 需要密码,当前版本暂不支持打开加密 PDF。")
def close(self) -> None:
if self._doc:
@@ -131,6 +134,20 @@ class PdfDocument:
rect = fitz.Rect(72, 120, 72 + width, 120 + height)
page.insert_image(rect, filename=str(image_path), keep_proportion=True)
def add_signature(self, page_index: int, image_path: str | Path) -> None:
page = self._page(page_index)
page_rect = page.rect
width = page_rect.width * 0.28
height = width * 0.42
margin = 54
rect = fitz.Rect(
page_rect.width - width - margin,
page_rect.height - height - margin,
page_rect.width - margin,
page_rect.height - margin,
)
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)
@@ -231,6 +248,74 @@ class PdfDocument:
finally:
merged.close()
def export_page_image(self, page_index: int, target_path: str | Path, zoom: float = 2.0) -> None:
page = self._page(page_index)
pixmap = page.get_pixmap(matrix=fitz.Matrix(zoom, zoom), alpha=False)
pixmap.save(target_path)
def export_pages_images(
self,
page_numbers: list[int],
target_folder: str | Path,
zoom: float = 2.0,
) -> None:
folder = Path(target_folder)
folder.mkdir(parents=True, exist_ok=True)
base_name = self.path.stem if self.path else "PDFReaderLite"
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}")
self.export_page_image(page_index, folder / f"{base_name}_第{page_number}页.png", zoom)
@staticmethod
def images_to_pdf(image_paths: list[str | Path], target_path: str | Path) -> None:
if not image_paths:
raise ValueError("没有选择图片文件")
document = fitz.open()
try:
for image_path in image_paths:
image_doc = fitz.open(image_path)
try:
rect = image_doc[0].rect
pdf_bytes = image_doc.convert_to_pdf()
finally:
image_doc.close()
image_pdf = fitz.open("pdf", pdf_bytes)
try:
page = document.new_page(width=rect.width, height=rect.height)
page.show_pdf_page(page.rect, image_pdf, 0)
finally:
image_pdf.close()
document.save(target_path, garbage=4, deflate=True)
finally:
document.close()
def metadata(self) -> dict[str, str]:
if not self._doc:
raise RuntimeError("没有打开 PDF")
return {key: value or "" for key, value in self._doc.metadata.items()}
def update_metadata(
self,
title: str = "",
author: str = "",
subject: str = "",
keywords: str = "",
) -> None:
if not self._doc:
raise RuntimeError("没有打开 PDF")
metadata = self.metadata()
metadata.update(
{
"title": title,
"author": author,
"subject": subject,
"keywords": keywords,
}
)
self._doc.set_metadata(metadata)
def delete_page(self, page_index: int) -> None:
if not self._doc:
raise RuntimeError("没有打开 PDF")
@@ -266,6 +351,24 @@ class PdfDocument:
if temp_path.exists():
temp_path.unlink()
def save_encrypted(self, path: str | Path, password: str) -> None:
if not self._doc:
raise RuntimeError("没有打开 PDF")
if not password:
raise ValueError("密码不能为空")
target = Path(path)
target.parent.mkdir(parents=True, exist_ok=True)
self._doc.save(
target,
garbage=4,
deflate=True,
encryption=fitz.PDF_ENCRYPT_AES_256,
owner_pw=password,
user_pw=password,
permissions=fitz.PDF_PERM_ACCESSIBILITY | fitz.PDF_PERM_PRINT,
)
def _page(self, page_index: int) -> fitz.Page:
if not self._doc:
raise RuntimeError("没有打开 PDF")