pdf2img2pdf 1.0.0__tar.gz

pdf2img2pdf-1.0.0/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: pdf2img2pdf
+Version: 1.0.0
+Summary: A tool to convert PDF to images and back to PDF
+Home-page: https://github.com/yourusername/pdf2img2pdf
+Author: siwen.huang
+Author-email: 594047189@qq.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pdf2image
+Requires-Dist: img2pdf
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# PDF to Image to PDF Converter (pdf2img2pdf)
+
+这是一个轻量级的 Python 工具，用于将 PDF 文件转换为图像，然后再将这些图像合并回 PDF 文件。适用于需要处理 PDF 内容或修复损坏 PDF 的场景。
+
+### 功能特性
+
+- 支持将 PDF 文件逐页转换为 PNG 图像。
+- 将多张图像合并为一个新的 PDF 文件。
+- 跨平台支持（Windows / Linux / macOS）。
+- 自动检测依赖项（如 Poppler）并提供清晰的安装指引。
+- 支持 PyInstaller 打包后的可执行文件运行。
+
+### 安装依赖
+
+1. Python 依赖库
+   确保已安装以下 Python 库
+
+```bash
+pip install pdf2image img2pdf
+```
+
+2. Poppler（必需）
+   pdf2image 依赖于 poppler 工具集中的 pdftoppm 命令
+
+##### Windows 用户：
+
+- 下载预编译版本：[Poppler for Windows](https://github.com/oschwartz10612/poppler-windows/releases/)
+- 解压后将 poppler-x.x.x\Library\bin 添加到系统 PATH 环境变量中。
+- 或者在代码中显式指定路径（见下方示例）。
+
+##### Linux 用户：
+
+使用包管理器安装：
+
+```bash
+# Ubuntu/Debian
+sudo apt-get install poppler-utils
+# CentOS/RHEL
+sudo yum install poppler-utils
+```
+
+##### macOS 用户：
+
+使用 Homebrew 安装：
+
+```bash
+brew install poppler
+```
+
+### 使用方法
+
+##### 命令行调用
+
+```bash
+python pdf2img2pdf.py <input.pdf> <output.pdf>
+```
+
+##### 作为模块调用
+
+```bash
+from pdf2img2pdf import convert
+# 转换 PDF 文件
+convert("example_input.pdf", "example_output.pdf")
+```
+
+### 注意事项
+
+- Poppler 必须安装：
+
+  如果未安装 poppler，程序会自动检测并提示安装方法。
+  确保 pdftoppm 或 pdfinfo 命令可在系统中运行。
+
+- 权限问题：
+
+  确保脚本对输入文件有读取权限，对输出目录有写入权限。
+
+- 临时文件：
+
+  转换过程中会在 tmp/imgs 目录下生成临时图像文件，结束后会自动清理。
+
+- PyInstaller 支持：
+
+  此工具支持打包为独立可执行文件，打包时需确保资源文件路径正确
+
+### 目录结构
+
+```bash
+pdf2img2pdf/
+├── pdf2img2pdf.py     # 主程序文件
+├── tmp/               # 临时文件目录（运行时自动生成）
+│   └── imgs/          # 存放转换过程中的图像文件
+└── README.md          # 本文档
+```

pdf2img2pdf-1.0.0/README.md

@@ -0,0 +1,93 @@
+# PDF to Image to PDF Converter (pdf2img2pdf)
+
+这是一个轻量级的 Python 工具，用于将 PDF 文件转换为图像，然后再将这些图像合并回 PDF 文件。适用于需要处理 PDF 内容或修复损坏 PDF 的场景。
+
+### 功能特性
+
+- 支持将 PDF 文件逐页转换为 PNG 图像。
+- 将多张图像合并为一个新的 PDF 文件。
+- 跨平台支持（Windows / Linux / macOS）。
+- 自动检测依赖项（如 Poppler）并提供清晰的安装指引。
+- 支持 PyInstaller 打包后的可执行文件运行。
+
+### 安装依赖
+
+1. Python 依赖库
+   确保已安装以下 Python 库
+
+```bash
+pip install pdf2image img2pdf
+```
+
+2. Poppler（必需）
+   pdf2image 依赖于 poppler 工具集中的 pdftoppm 命令
+
+##### Windows 用户：
+
+- 下载预编译版本：[Poppler for Windows](https://github.com/oschwartz10612/poppler-windows/releases/)
+- 解压后将 poppler-x.x.x\Library\bin 添加到系统 PATH 环境变量中。
+- 或者在代码中显式指定路径（见下方示例）。
+
+##### Linux 用户：
+
+使用包管理器安装：
+
+```bash
+# Ubuntu/Debian
+sudo apt-get install poppler-utils
+# CentOS/RHEL
+sudo yum install poppler-utils
+```
+
+##### macOS 用户：
+
+使用 Homebrew 安装：
+
+```bash
+brew install poppler
+```
+
+### 使用方法
+
+##### 命令行调用
+
+```bash
+python pdf2img2pdf.py <input.pdf> <output.pdf>
+```
+
+##### 作为模块调用
+
+```bash
+from pdf2img2pdf import convert
+# 转换 PDF 文件
+convert("example_input.pdf", "example_output.pdf")
+```
+
+### 注意事项
+
+- Poppler 必须安装：
+
+  如果未安装 poppler，程序会自动检测并提示安装方法。
+  确保 pdftoppm 或 pdfinfo 命令可在系统中运行。
+
+- 权限问题：
+
+  确保脚本对输入文件有读取权限，对输出目录有写入权限。
+
+- 临时文件：
+
+  转换过程中会在 tmp/imgs 目录下生成临时图像文件，结束后会自动清理。
+
+- PyInstaller 支持：
+
+  此工具支持打包为独立可执行文件，打包时需确保资源文件路径正确
+
+### 目录结构
+
+```bash
+pdf2img2pdf/
+├── pdf2img2pdf.py     # 主程序文件
+├── tmp/               # 临时文件目录（运行时自动生成）
+│   └── imgs/          # 存放转换过程中的图像文件
+└── README.md          # 本文档
+```

pdf2img2pdf-1.0.0/pdf2img2pdf/__init__.py

@@ -0,0 +1,9 @@
+
+from .pdf2img2pdf import convert
+
+__version__ = "0.1.0"
+__author__ = "siwen.huang"
+__license__ = "MIT"
+__description__ = "Convert PDF to image and back to PDF"
+
+__all__ = ['convert']

pdf2img2pdf-1.0.0/pdf2img2pdf/pdf2img2pdf.py

@@ -0,0 +1,107 @@
+#!/usr/bin/env python3
+
+def get_resource_path(filename):
+    """Get absolute path to resource, works for dev and for PyInstaller"""
+    import os, sys
+    try:
+        base_path = sys._MEIPASS
+    except AttributeError:
+        base_path = os.path.dirname(os.path.abspath(__file__)) 
+    return os.path.join(base_path, filename)
+
+def get_base_path():
+    """Get absolute path to executable, works for dev and for PyInstaller"""
+    import os, sys
+    if hasattr(sys, 'frozen'):
+        base_path = os.path.dirname(sys.executable)
+    else:
+        base_path = os.path.dirname(os.path.abspath('.'))
+    return base_path
+           
+def pdf_to_img(input_pdf_path, dpi=300):
+    """Convert pdf to images"""
+    import os
+    import pdf2image
+    img_paths = []
+    try: 
+        images = pdf2image.convert_from_path(input_pdf_path, dpi=dpi)  
+        img_dir = os.path.join(get_base_path(), 'tmp', 'imgs')
+        os.makedirs(img_dir, exist_ok=True)
+        for i, image in enumerate(images):
+            img_path = os.path.join(img_dir, 'img_%03d.png' % i)
+            image.save(img_path, 'PNG')
+            img_paths.append(img_path)
+    except Exception as e:
+        print(e)        
+    return img_paths    
+        
+def imgs_to_pdf(img_paths, output_pdf_path,):
+    """Convert images to pdf"""
+    import os
+    import img2pdf
+    output_path = os.path.dirname(output_pdf_path)
+    os.makedirs(output_path, exist_ok=True)
+    
+    # A4尺寸 - 21cm×29.7cm（210mm×297mm）
+    A4_WIDTH = img2pdf.mm_to_pt(210)
+    A4_HEIGHT = img2pdf.mm_to_pt(180)
+    page_size = (A4_WIDTH, A4_HEIGHT)
+    
+    layout_fun = img2pdf.get_layout_fun(page_size)
+    with open(output_pdf_path, "wb") as f:
+        # 指定 fit='into' 以保持宽高比
+        f.write(img2pdf.convert(img_paths, layout_fun=layout_fun))
+    for img_path in img_paths:
+        os.remove(img_path) 
+    os.removedirs(os.path.dirname(img_paths[0]))        
+        
+def convert(input_pdf_path, output_pdf_path, dpi=300):    
+    img_paths = pdf_to_img(input_pdf_path, dpi)
+    imgs_to_pdf(img_paths, output_pdf_path)
+
+def check_poppler_installed():
+    import shutil
+    import platform
+
+    """Check if poppler is installed on the system."""
+    # Check for pdftoppm or pdfinfo (part of poppler-utils)
+    if shutil.which("pdftoppm") is None and shutil.which("pdfinfo") is None:
+        system = platform.system()
+        if system == "Windows":
+            raise RuntimeError(
+                "Poppler is not installed. Please install Poppler for Windows:\n"
+                "https://github.com/oschwartz10612/poppler-windows/releases/"
+            )
+        elif system == "Linux":
+            raise RuntimeError(
+                "Poppler is not installed. Please install Poppler using your package manager:\n"
+                "Ubuntu/Debian: sudo apt-get install poppler-utils\n"
+                "CentOS/RHEL: sudo yum install poppler-utils"
+            )
+        elif system == "Darwin":  # macOS
+            raise RuntimeError(
+                "Poppler is not installed. Please install Poppler using Homebrew:\n"
+                "brew install poppler"
+            )
+        else:
+            raise RuntimeError("Unsupported operating system. Please manually install Poppler.")
+
+def remove_pycache(root_dir='.'):
+    import os
+    for dirpath, dirnames, filenames in os.walk(root_dir):
+        print(dirpath, dirnames, filenames)
+        # for dirname in dirnames:
+        #     if dirname.endswith("__pycache__"):
+        #         os.rmdir(os.path.join(dirpath, dirname))
+
+if __name__ == "__main__":
+    import sys
+    if len(sys.argv) < 3:
+        print("Usage: pdf2img2pdf.py <input.pdf> <output.pdf> <dpi>")
+    else:
+        try:
+            # Check if poppler is installed before proceeding
+            check_poppler_installed()
+            convert(sys.argv[1], sys.argv[2], sys.argv[3] if len(sys.argv) > 3 else 100)
+        except Exception as e:
+            print(e)    

pdf2img2pdf-1.0.0/pdf2img2pdf.egg-info/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: pdf2img2pdf
+Version: 1.0.0
+Summary: A tool to convert PDF to images and back to PDF
+Home-page: https://github.com/yourusername/pdf2img2pdf
+Author: siwen.huang
+Author-email: 594047189@qq.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pdf2image
+Requires-Dist: img2pdf
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# PDF to Image to PDF Converter (pdf2img2pdf)
+
+这是一个轻量级的 Python 工具，用于将 PDF 文件转换为图像，然后再将这些图像合并回 PDF 文件。适用于需要处理 PDF 内容或修复损坏 PDF 的场景。
+
+### 功能特性
+
+- 支持将 PDF 文件逐页转换为 PNG 图像。
+- 将多张图像合并为一个新的 PDF 文件。
+- 跨平台支持（Windows / Linux / macOS）。
+- 自动检测依赖项（如 Poppler）并提供清晰的安装指引。
+- 支持 PyInstaller 打包后的可执行文件运行。
+
+### 安装依赖
+
+1. Python 依赖库
+   确保已安装以下 Python 库
+
+```bash
+pip install pdf2image img2pdf
+```
+
+2. Poppler（必需）
+   pdf2image 依赖于 poppler 工具集中的 pdftoppm 命令
+
+##### Windows 用户：
+
+- 下载预编译版本：[Poppler for Windows](https://github.com/oschwartz10612/poppler-windows/releases/)
+- 解压后将 poppler-x.x.x\Library\bin 添加到系统 PATH 环境变量中。
+- 或者在代码中显式指定路径（见下方示例）。
+
+##### Linux 用户：
+
+使用包管理器安装：
+
+```bash
+# Ubuntu/Debian
+sudo apt-get install poppler-utils
+# CentOS/RHEL
+sudo yum install poppler-utils
+```
+
+##### macOS 用户：
+
+使用 Homebrew 安装：
+
+```bash
+brew install poppler
+```
+
+### 使用方法
+
+##### 命令行调用
+
+```bash
+python pdf2img2pdf.py <input.pdf> <output.pdf>
+```
+
+##### 作为模块调用
+
+```bash
+from pdf2img2pdf import convert
+# 转换 PDF 文件
+convert("example_input.pdf", "example_output.pdf")
+```
+
+### 注意事项
+
+- Poppler 必须安装：
+
+  如果未安装 poppler，程序会自动检测并提示安装方法。
+  确保 pdftoppm 或 pdfinfo 命令可在系统中运行。
+
+- 权限问题：
+
+  确保脚本对输入文件有读取权限，对输出目录有写入权限。
+
+- 临时文件：
+
+  转换过程中会在 tmp/imgs 目录下生成临时图像文件，结束后会自动清理。
+
+- PyInstaller 支持：
+
+  此工具支持打包为独立可执行文件，打包时需确保资源文件路径正确
+
+### 目录结构
+
+```bash
+pdf2img2pdf/
+├── pdf2img2pdf.py     # 主程序文件
+├── tmp/               # 临时文件目录（运行时自动生成）
+│   └── imgs/          # 存放转换过程中的图像文件
+└── README.md          # 本文档
+```

pdf2img2pdf-1.0.0/pdf2img2pdf.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+setup.py
+pdf2img2pdf/__init__.py
+pdf2img2pdf/pdf2img2pdf.py
+pdf2img2pdf.egg-info/PKG-INFO
+pdf2img2pdf.egg-info/SOURCES.txt
+pdf2img2pdf.egg-info/dependency_links.txt
+pdf2img2pdf.egg-info/entry_points.txt
+pdf2img2pdf.egg-info/requires.txt
+pdf2img2pdf.egg-info/top_level.txt
+tests/test_pdf2img2pdf.py

pdf2img2pdf-1.0.0/pdf2img2pdf.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pdf2img2pdf-1.0.0/pdf2img2pdf.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pdf2img2pdf = pdf2img2pdf.pdf2img2pdf:main

pdf2img2pdf-1.0.0/pdf2img2pdf.egg-info/requires.txt

@@ -0,0 +1,2 @@
+pdf2image
+img2pdf

pdf2img2pdf-1.0.0/pdf2img2pdf.egg-info/top_level.txt

@@ -0,0 +1 @@
+pdf2img2pdf

pdf2img2pdf-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pdf2img2pdf-1.0.0/setup.py

@@ -0,0 +1,32 @@
+# setup.py
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="pdf2img2pdf",
+    version="1.0.0",
+    author="siwen.huang",
+    author_email="594047189@qq.com",
+    description="A tool to convert PDF to images and back to PDF",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/yourusername/pdf2img2pdf",
+    packages=find_packages(),
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.6",
+    install_requires=[
+        "pdf2image",
+        "img2pdf",
+    ],
+    entry_points={
+        "console_scripts": [
+            "pdf2img2pdf=pdf2img2pdf.pdf2img2pdf:main",  # 命令行入口
+        ],
+    },
+)

pdf2img2pdf-1.0.0/tests/test_pdf2img2pdf.py

@@ -0,0 +1,64 @@
+import os
+import tempfile
+import unittest
+from unittest.mock import patch, MagicMock
+from pdf2img2pdf import convert, check_poppler_installed
+
+class TestPdf2Img2Pdf(unittest.TestCase):
+
+    def setUp(self):
+        """在每个测试前运行，准备临时文件"""
+        self.input_pdf = tempfile.NamedTemporaryFile(suffix=".pdf", delete=False)
+        self.output_pdf = tempfile.NamedTemporaryFile(suffix=".pdf", delete=False)
+        self.input_pdf.close()
+        self.output_pdf.close()
+
+    def tearDown(self):
+        """在每个测试后运行，清理临时文件"""
+        if os.path.exists(self.input_pdf.name):
+            os.unlink(self.input_pdf.name)
+        if os.path.exists(self.output_pdf.name):
+            os.unlink(self.output_pdf.name)
+
+    @patch("pdf2img2pdf.pdf2image.convert_from_path")
+    @patch("pdf2img2pdf.img2pdf.convert")
+    def test_convert_success(self, mock_img2pdf, mock_pdf2image):
+        """测试 convert 函数是否能成功执行"""
+        # 模拟 pdf2image 返回图像列表
+        mock_images = [MagicMock()]
+        mock_pdf2image.return_value = mock_images
+
+        # 模拟 img2pdf 返回二进制数据
+        mock_img2pdf.return_value = b"fake_pdf_data"
+
+        # 调用函数
+        convert(self.input_pdf.name, self.output_pdf.name)
+
+        # 断言 pdf2image 被正确调用
+        mock_pdf2image.assert_called_once_with(self.input_pdf.name)
+
+        # 断言 img2pdf 被正确调用
+        mock_img2pdf.assert_called_once_with([img.filename for img in mock_images])
+
+        # 断言输出文件被创建
+        self.assertTrue(os.path.exists(self.output_pdf.name))
+
+    @patch("shutil.which")
+    def test_check_poppler_installed_success(self, mock_which):
+        """测试 check_poppler_installed 在 Poppler 已安装时不会抛出异常"""
+        mock_which.return_value = "/usr/bin/pdftoppm"  # 模拟找到了 pdftoppm
+        try:
+            check_poppler_installed()
+        except RuntimeError:
+            self.fail("check_poppler_installed() raised RuntimeError unexpectedly!")
+
+    @patch("shutil.which")
+    def test_check_poppler_installed_failure(self, mock_which):
+        """测试 check_poppler_installed 在 Poppler 未安装时抛出异常"""
+        mock_which.return_value = None  # 模拟未找到 pdftoppm 或 pdfinfo
+        with self.assertRaises(RuntimeError) as context:
+            check_poppler_installed()
+        self.assertIn("Poppler is not installed", str(context.exception))
+
+if __name__ == "__main__":
+    unittest.main()