barcode-pao-native

高性能バーコード生成ライブラリ for Python（C++ネイティブ拡張版）

概要

barcode-pao-native は、C++で実装されたバーコードライブラリをPythonから利用できるようにしたパッケージです。pybind11を使用してC++コードを直接呼び出すため、高速なバーコード生成が可能です。

対応バーコード（18種）

1次元バーコード（11種）

• Code39 - 英数字対応の汎用バーコード
• Code93 - Code39の拡張版
• Code128 - 全ASCII文字対応の高密度バーコード
• GS1-128 - 物流・流通向けバーコード（コンビニ収納代行対応）
• NW-7 (Codabar) - 血液銀行・宅配便向けバーコード
• Matrix 2 of 5 - 工業用バーコード
• NEC 2 of 5 - NECが開発した2 of 5系バーコード
• JAN-8 - 日本の商品コード（8桁）
• JAN-13 - 日本の商品コード（13桁）
• UPC-A - 北米の商品コード（12桁）
• UPC-E - UPC-Aの短縮版（8桁）

GS1 DataBar（3種）

• GS1 DataBar 14 - 標準型（オムニ/スタック対応）
• GS1 DataBar Limited - 限定型
• GS1 DataBar Expanded - 拡張型（スタック対応）

2次元バーコード（3種）

• QRコード - 日本発の2次元コード
• DataMatrix - 工業用途の2次元コード
• PDF417 - 運転免許証等で使用される2次元コード

特殊バーコード（1種）

• 郵便カスタマバーコード - 日本郵便の住所表示バーコード

インストール

pip install barcode-pao-native

使用例

QRコード生成

from barcode_pao_native import QR

# QRコードインスタンスを作成
qr = QR()

# エラー訂正レベルを設定（L/M/Q/H）
qr.set_error_correction_level("H")

# 日本語をエンコードする場合
qr.set_string_encoding("shift-jis")

# Base64エンコードされた画像を取得
base64_image = qr.draw("https://example.com", 200)

# バイナリデータとして取得
image_bytes = qr.draw_bytes("Hello, World!", 200)

# ファイルに保存
qr.draw_to_file("Hello, World!", 200, "qrcode.png")

Code128バーコード生成

from barcode_pao_native import Code128

# Code128インスタンスを作成
code128 = Code128()

# テキスト表示を有効化
code128.set_show_text(True)

# 出力フォーマットをSVGに設定
code128.set_output_format("svg")

# コードモードを設定（AUTO/A/B/C）
code128.set_code_mode("AUTO")

# バーコード生成
svg_data = code128.draw("ABC-12345", 300, 100)

色のカスタマイズ

from barcode_pao_native import Code39

code39 = Code39()

# 前景色（バーの色）をRGBAで設定
code39.set_foreground_color(0, 0, 128, 255)  # 紺色

# 背景色をRGBAで設定
code39.set_background_color(255, 255, 200, 255)  # 薄黄色

base64_image = code39.draw("12345", 200, 80)

GS1-128 コンビニ収納代行バーコード

from barcode_pao_native import GS1_128

gs1 = GS1_128()
gs1.set_show_text(True)

# 標準料金代理収納用バーコード
# 43桁または44桁の数字を指定
convenience_code = "9101234567890123456789012345678901234567890123"
base64_image = gs1.draw_convenience(convenience_code, 400, 100)

郵便カスタマバーコード

from barcode_pao_native import YubinCustomer

yubin = YubinCustomer()

# 郵便番号 + 住所表示番号
# 例: 〒100-0001 東京都千代田区1-2-3
code = "1000001-1-2-3"
base64_image = yubin.draw(code, 50)  # 高さのみ指定（幅は自動）

API リファレンス

共通メソッド（全バーコードクラス）

1次元バーコード固有メソッド

2次元バーコード固有メソッド

出力フォーマット

動作環境

• Python 3.8以上
• Windows / macOS / Linux

ライセンス

MIT License

関連パッケージ

• barcode-pao-wasm - WebAssembly版（ポータブル）