# 522行のQR符号器を同梱

実行時の3つ目の依存関係を追加せず、GF(256)上のReed‑Solomon、固定モジュール配置、8つのマスクパターンを持つQR符号器を522行で同梱し、独立に実装した復号器で完成行列を読み戻して検証した。

8月 2026

状況. 文書にはオンライン版へのQRが必要だった。既存ライブラリはどれも可能だが、数年後も導入可能な生成器であるために、テンプレート・PDFの2依存に制限したところへ、3つ目を足すことになる。

課題. 依存を受け入れるか規格を実装するか決め、黒い四角ができるだけでなく正しい実装だと検証する必要があった。

行動. 用途に必要な部分を522行で実装した。バイトモード、256要素のGalois体上のReed‑Solomonと必要次数の生成多項式、位置検出・タイミング・位置合わせを含む固定配置、形式・版情報、4罰則で全8マスクを評価して最少を選ぶ処理だった。正当化を支えたのは検証だった。自分のロジックとの照合では証明にならないため、規格の読み順から独立に書いた復号器で完成行列を読み、入力文字列と一致させた。もっともらしい画像ではなく正しいURLに戻る符号とし、携帯で一度見るのでなく毎回検査した。

結果. 実行時依存を2つに保ち、符号器は唯一の同梱部品となった。汎用実装ではなく、文書が使うモードと版だけに対応する。成熟ライブラリより優れるという主張でなく、依存数の予算が率直な採用理由だった。

役割: Pythonエンジニア
=> /ja/categories/backend/ カテゴリー: バックエンド開発
=> /ja/categories/performance/ カテゴリー: 性能改善
=> /ja/categories/testing/ カテゴリー: テスト・品質保証
=> /ja/categories/python/ カテゴリー: Python
=> /ja/categories/documentation/ カテゴリー: 文書作成
=> /ja/services/platform-architecture/ サービス: プラットフォーム・ソリューション設計
=> /ja/services/backend-development/ サービス: バックエンド・API開発

=> https://engineer.company/ja/portfolio/vendored-a-qr-encoder-in-522-lines/ このページのウェブ版
