QRFlex 0.1.1

A flexible QR code generator supporting UTF-8, Kanji, and hybrid modes.

A flexible QR code generator that supports UTF-8, Kanji (Chinese/Japanese), and automatic hybrid encoding modes.

Features

• Three encoding modes: UTF‑8 (byte), Kanji (efficient for CJK characters), and Auto (smart hybrid)

• Pre‑check capacity before generation to avoid overflow

• Supports plain text or `.txt` file input

• Output as PNG or SVG (via segno)

• Returns PIL Image for further processing

Installation

pip install QRFlex

Quick Start

from QRFlex import QRMaker

# Create generator with auto mode and low error correction
maker = QRMaker(mode='auto', error='L')

# Generate from text and save to file
maker.from_text("Hello 世界", output="hello.png")

# Or from a .txt file
maker.from_file("my_content.txt", output="my_qr.png")

# Check capacity first
info = maker.check_capacity("Your long text...")
if info['can_fit']:
    img = maker.from_text("Your long text...")

Modes

Mode	Description
utf8	Standard byte encoding – safest, supports all characters but uses 3 bytes per Chinese char.
kanji	Efficient CJK encoding – uses 13 bits per character, but only supports JIS X 0208 characters.
auto	Recommended – automatically segments content into the most compact encoding (numbers, letters, kanji).

Error Correction Levels

• L – 7% recovery

• M – 15% recovery

• Q – 25% recovery

• H – 30% recovery (smallest data capacity)

License

This project is licensed under the AGPL License - see the LICENSE file for details.

Author

[jzm3] ([[e-mail]])

Project Home

• PyPI: https://pypi.org/project/qrflex/