python-escpos でレシート印刷を Python から制御する、プロファイル運用の実態

ESC/POS を Python から扱うための選択肢

レシートプリンタの制御は、ベンダーごとに異なるコマンド体系が障壁になります。python-escpos は Epson が定義する ESC/POS コマンドセットを Python から操作するライブラリで、テキスト、画像、バーコード、QR コードの印字に対応します。対象読者は、POS システムや在庫管理、キオスク端末などで、Python から直接プリンタを叩きたい開発者です。C や Java の SDK に縛られず、Python のスクリプト内で完結させたい場合に有力な選択肢になります。

接続方法は USB、ネットワーク、シリアルの 3 系統

README には 3 つの接続クラスが示されています。Usb は pyusb 経由でベンダー ID とプロダクト ID を指定します。例では Epson TM-T88III を 0x04b8, 0x0202 で指定し、profile 引数に機種名を渡しています。Network はプリンタの IP アドレスを渡すだけで、シリアルは pyserial を使ってデバイスファイル、ボーレート、パリティなどを細かく設定します。シリアルの例では 9600 ボー、8N1、フロー制御有効とあり、実際の接続に合わせてパラメータを調整する必要があります。この 3 系統をカバーしている点は、実務で困りがちな接続形態を一通り押さえていると言えます。

プロファイルが機種差を吸収する仕組み

ESC/POS は共通規格ですが、プリンタごとにサポートするコマンドが異なります。python-escpos は escpos-printer-db という外部データベースを参照し、指定したプロファイルに応じて設定を自動適用します。README は「profile を指定することを強く推奨する」と明記しており、機種に合ったプロファイルを渡さないと、印字が崩れたりコマンドが無視されたりする可能性があります。この設計は、ライブラリ本体に機種別の設定を埋め込まず、データベース側で管理するという方針です。一方で、プロファイルが未登録の新機種や特殊な設定を持つ機種では、自分でプロファイルを定義するか、既存のものを流用するしかありません。その点は導入前に確認すべきです。

印字機能の実装と依存ライブラリの関係

テキストの整列やフォント変更に加え、画像、バーコード、QR コードの印字ができます。画像は Pillow、QR コードは qrcode、バーコードは python-barcode がそれぞれ生成を担います。つまり、python-escpos 自体は印刷コマンドの組み立てに集中し、データ生成は外部ライブラリに委ねる構成です。この分離は、画像処理を差し替えたい場合に利点ですが、依存が増えるため、導入環境で Pillow や qrcode のバージョン互換性に注意が必要です。特に、画像を頻繁に印刷する業務では、Pillow の処理時間がボトルネックになる可能性がありますが、README には性能に関する記述がないため、実測は各自で行うべきです。

コードの実際の流れ、コマンド送信の具体例

基本的な使い方は、プリンタオブジェクトを生成し、text や image、barcode、qr などのメソッドを呼び、最後に cut で用紙を切るという流れです。Usb の例では、p.text("Hello World\n") でテキストを送り、p.image("logo.gif") で画像を、p.barcode('4006381333931', 'EAN13', 64, 2, '', '') でバーコードを出力しています。引数の 64 と 2 は高さと幅の指定と推測されますが、README には詳細な説明がありません。ドキュメントを参照する必要があります。Network の例では、kitchen = Network("192.168.1.100", profile="TM-T88III") と IP を直接渡しており、シリアルでは Serial クラスにデバイスファイルと通信パラメータを渡します。どの接続でも、最後に cut() を呼ぶ点は共通です。

制限と失敗モード、プロファイル不足のリスク

このライブラリの最大の制限は、プロファイルが escpos-printer-db に依存していることです。プロファイルが存在しない機種では、自動設定が効かず、コマンドが正しく送信されない可能性があります。また、ESC/POS はプリンタの状態を返すステータス確認が限定的で、python-escpos がどの程度ステータス読み取りに対応しているかは README からは不明です。紙切れやカバーオープンなどの検知が必要な業務では、別途プリンタステータスのポーリングを実装する必要があるかもしれません。さらに、画像印刷は Pillow に依存するため、大きな画像や高解像度のロゴを扱うと処理時間がかかります。大量印刷の現場では、この点がボトルネックになり得ます。

代替案との比較、escpos-php との関係

類似プロジェクトとして escpos-php が挙げられます。README は、escpos-php も同じ escpos-printer-db を使用していると明記しています。つまり、プロファイルのデータベースを共有しているため、機種対応の考え方は共通です。違いは言語で、PHP で動く点が大きいです。既存の POS システムが PHP で構築されているなら escpos-php が自然ですが、Python で統一したいなら python-escpos を選ぶことになります。別のアプローチとしては、プリンタベンダーが提供する独自 SDK や、CUPS 経由の印刷も考えられますが、ESC/POS の低レベル制御という点では、このライブラリは直接的な手段を提供します。

メンテナンスとライセンス、導入前に確認すべきこと

最終リリースは v3.1 で 2023 年 12 月、v3.0 が 2023 年 11 月と、比較的最近まで開発が続いています。ただし、リポジトリのアーカイブ状況は「Archived: no」ですが、今後の更新頻度は README からは判断できません。ライセンスは MIT で、商用利用や改変は自由ですが、プロファイルの追加やバグ修正を行う場合は、escpos-printer-db へのコントリビュートも視野に入れるべきです。導入前に、使用予定のプリンタが escpos-printer-db に登録されているか、また、Python のバージョンとの互換性を確認することをお勧めします。依存ライブラリのバージョンが古い場合、新しい Python 環境で動かない可能性もあります。

編集部の結論

python-escpos は、Python でレシートやラベルを印刷する必要がある開発者に向いています。特に、USB 接続の Epson 製プリンタを固定機種で使う場合は、プロファイルを指定するだけで素直に動くでしょう。一方、独自コマンドや特殊な印字モードを多用する機種、あるいは大量の画像処理を伴う用途では、プロファイルの不足や Pillow 依存の処理に制約を感じるかもしれません。導入前に、対象プリンタのプロファイルが escpos-printer-db に存在するか確認し、存在しない場合は profile 引数に独自の設定を渡すか、プリンタのマニュアルと突き合わせて拡張する覚悟が必要です。ライセンスは MIT で商用利用も可能ですが、プロファイルの追加やバグ修正は自前で行う前提で運用計画を立ててください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes