# pyhelper

**Repository Path**: hanzhi-code/pyhelper

## Basic Information

- **Project Name**: pyhelper
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-13
- **Last Updated**: 2025-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pyhelper

pyhelper 是一个实用的 Python 工具集，目前包含图片转 PDF 功能，支持将指定文件夹中的所有图片合并为一个 PDF 文件。

## 功能特性

### 图片转 PDF
- 支持多种图片格式：JPG、JPEG、PNG、BMP、GIF、TIFF
- 自动处理 PNG 透明背景（转为白色）
- 保持图片宽高比，自动适应 A4 页面
- 图片居中显示
- 支持按文件名排序
- 默认将 PDF 输出在原图片文件夹下
- 支持自定义输出路径

## 环境要求

- Python 3.7+
- 依赖库：
  - Pillow (图片处理)
  - reportlab (PDF 生成)

## 运行说明

### 安装依赖


1. 克隆或下载项目：
   ```bash
   git clone <repository-url>
   ```

2. 激活虚拟环境（请确保已安装 uv 包管理器，[安装方法详见](https://uv.doczh.com/getting-started/installation/)）：


- 进入项目根目录，执行以下命令
   ```bash
    uv sync
   ```
   说明：
   - `uv sync`：会自动查找或下载合适的 Python 版本，创建并设置项目的虚拟环境，将依赖同步到虚拟环境中。

### 打包可执行文件

-  方式一：使用命令行一键打包脚本为可执行文件：
   ```bash
      pyinstaller --onefile --windowed ./src/xxx.py
   ```
   说明：
   - `--onefile`：将所有依赖打包到一个单独的可执行文件中
   - `--windowed`：生成不带控制台窗口的 GUI 应用
   - `xxx.py`：替换为你的 Python 脚本文件名
- 方式二：使用.spec文件打包
   ```bash
      pyinstaller --clean xxx.spec
   ```