make_qr.py ドキュメント

概要

make_qr.py は、コマンドライン引数として与えられた文字列(URLなど)からQRコード画像を生成し、指定されたファイル名で保存するためのPythonスクリプトです。

必要なライブラリ

本プログラムを実行するためには、以下のライブラリが必要です。

  • 標準ライブラリ

    • sys

  • 非標準ライブラリ

    • qrcode

動作原理

本プログラムはデータ処理のユーティリティツールであり、複雑な数学的計算は伴いません。外部ライブラリである qrcode の機能を利用して、入力された文字列を二次元コードに変換します。

プログラム内で指定されているQRコードの生成パラメータは以下の通りです。

  • version : 1 (21x21モジュールの最小サイズ)

  • error_correction : qrcode.constants.ERROR_CORRECT_L (約7%のデータ復元が可能なエラー訂正レベル)

  • box_size : 10 (1モジュールあたりのピクセル数)

  • border : 4 (QRコード周囲に設けられる余白のモジュール数)

  • 描画色 : 前景は black 、背景は white

入出力仕様

入力

プログラム実行時に、コマンドライン引数として以下の2つを順に指定する必要があります。引数が不足、または多すぎる場合は、使い方を示すメッセージを標準出力に表示して処理を終了します。

  1. 第1引数( <URL> ) : QRコードに埋め込むデータ(文字列やURL)

  2. 第2引数( <出力ファイル名> ) : 生成されたQRコード画像を保存する際のファイル名(例: output.png )

出力

  • 指定された文字列をエンコードしたQRコード画像ファイルが、第2引数で指定されたファイル名で保存されます。

  • 保存が正常に完了すると、保存先のファイル名を含む完了メッセージが標準出力にプリントされます。

実行例

以下は、コマンドラインから本スクリプトを実行し、QRコード画像を生成する例です。

python make_qr.py https://example.com/ sample_qr.png

このコマンドを実行すると、指定したURLのデータを含むQRコード画像が sample_qr.png というファイル名で保存され、標準出力に以下のメッセージが表示されます。

QRコードが 'sample_qr.png' に保存されました!