qrcode49

一个简洁的 Python CLI 工具，用于生成和解析二维码。

功能特性

• 生成二维码：读取文本文件（.md 或 .txt），生成二维码图片（.webp 或 .jpg）
• 解析二维码：读取二维码图片，输出文本内容到终端或保存到文件

安装

使用 uv 安装（推荐）：

uv tool install /path/to/qrcode49

或者使用 pip 安装：

pip install /path/to/qrcode49

使用方法

生成二维码

qrcode49 <输入文件> <输出图片> [像素大小]

参数说明：

参数	说明	必填	默认值
输入文件	文本文件路径（.md 或 .txt）	是	-
输出图片	二维码图片路径（.webp 或 .jpg）	是	-
像素大小	图片像素边长，数字越大图片越大	否	200

示例：

# 从 text.md 生成 300x300 的 webp 二维码
qrcode49 text.md qrcode.webp 300

# 从 note.txt 生成 200x200 的 jpg 二维码（使用默认大小）
qrcode49 note.txt qrcode.jpg

解析二维码

qrcode49 <二维码图片> [输出文件]

参数说明：

参数	说明	必填	默认值
二维码图片	二维码图片路径	是	-
输出文件	文本保存路径（.md 或 .txt）	否	终端输出

示例：

# 解析二维码并在终端打印内容
qrcode49 qrcode.webp

# 解析二维码并保存到文件
qrcode49 qrcode.webp result.txt

支持的文件格式

输入文本文件：

• .md - Markdown 文件
• .txt - 纯文本文件

输出二维码图片：

• .webp - WebP 格式
• .jpg / .jpeg - JPEG 格式

解析输出文件：

• .md - Markdown 文件
• .txt - 纯文本文件

错误处理

工具会在以下情况输出错误信息并退出：

• 输入文件不存在
• 输出文件格式不支持
• 像素大小不是正整数
• 生成模式缺少输出路径
• 图片中未检测到二维码

依赖

• click - CLI 框架
• qrcode - 二维码生成
• opencv-python - 二维码解析
• Pillow - 图像处理
• numpy - 数值计算

项目结构

qrcode49/
├── pyproject.toml      # 项目配置和依赖定义
├── README.md           # 本文件
├── .gitignore          # Git 忽略规则
└── src/
    └── qrcode49/
        ├── __init__.py # 包初始化
        ├── cli.py      # CLI 入口和参数解析
        ├── generate.py # 二维码生成功能
        └── parse.py    # 二维码解析功能

开发

本地开发环境

# 克隆项目
git clone <repository-url>
cd qrcode49

# 创建虚拟环境
uv venv

# 安装依赖
uv pip install -e .

运行测试

# 生成测试
qrcode49 test_input.txt test_output.webp 300

# 解析测试
qrcode49 test_output.webp

许可证

待定