PyInstallerは、Pythonで書かれたスクリプトをスタンドアロンの実行ファイル（.exeや.appなど）に変換するためのツールです。これにより、Pythonのインタープリタがインストールされていない環境でも、Pythonスクリプトを実行することができます。PyInstallerの基本的な使い方と具体的な例を紹介します。
PyInstallerの基本機能
Pythonスクリプトのコンパイル
PyInstallerは、Pythonスクリプトとその依存関係を解析し、スタンドアロンの実行ファイルにパッケージします。
クロスプラットフォーム対応
Windows、macOS、Linuxの各プラットフォームで実行ファイルを生成できます。
単一ファイルの生成
スクリプトとそのすべての依存ファイルを1つの実行ファイルにまとめることができます。
カスタマイズ可能な設定
設定ファイルを使用して、アイコンの変更や追加ファイルのパッケージなど、さまざまなカスタマイズが可能です。
PyInstallerのインストール
まず、PyInstallerをインストールします。
pip install pyinstaller例題1: 基本的なPythonスクリプトのコンパイル
以下に、基本的なPythonスクリプトをコンパイルして実行ファイルを生成する例を示します。
サンプルスクリプトの作成
まず、簡単なPythonスクリプトを作成します。以下のコードをhello.pyとして保存します。
# hello.py
print("Hello, world!")PyInstallerを使用してコンパイル
以下のコマンドを実行して、hello.pyをスタンドアロンの実行ファイルに変換します。
pyinstaller --onefile hello.pyこのコマンドは、hello.pyを単一の実行ファイルに変換します。生成された実行ファイルは、distディレクトリ内に保存されます。
実行ファイルの確認
生成された実行ファイルを実行して、スクリプトが正しく動作することを確認します。
dist/hello例題2: 複数の依存関係を持つスクリプトのコンパイル
次に、外部ライブラリを使用するスクリプトをコンパイルする例を示します。ここでは、requestsライブラリを使用してWebページの内容を取得するスクリプトを作成します。
サンプルスクリプトの作成
以下のコードをfetch_page.pyとして保存します
# fetch_page.py
import requests
url = 'https://www.example.com'
response = requests.get(url)
print(response.text)依存関係のインストール
依存するライブラリ（この例ではrequests）をインストールします。
pip install requestsPyInstallerを使用してコンパイル
以下のコマンドを実行して、fetch_page.pyをスタンドアロンの実行ファイルに変換します。
pyinstaller --onefile fetch_page.py実行ファイルの確認
生成された実行ファイルを実行して、スクリプトが正しく動作することを確認します。
dist/fetch_page例題3: カスタムアイコンと追加ファイルのパッケージ
カスタムアイコンを設定し、追加のファイルをパッケージに含める方法を示します。
サンプルスクリプトの作成
以下のコードをapp.pyとして保存します。
# app.py
print("This is a sample application with a custom icon.")カスタムアイコンの準備
カスタムアイコン（icon.ico）を用意します。
PyInstallerを使用してコンパイル
以下のコマンドを実行して、app.pyをスタンドアロンの実行ファイルに変換し、カスタムアイコンを設定します。
pyinstaller --onefile --icon=icon.ico app.py追加ファイルのパッケージ
--add-dataオプションを使用して追加のファイルをパッケージに含めることもできます。
このコマンドは、config.jsonファイルを実行ファイルにパッケージします。
pyinstaller --onefile --icon=icon.ico --add-data "config.json;." app.py実行ファイルの確認
生成された実行ファイルを実行して、スクリプトが正しく動作することを確認します。
dist/app結論
PyInstallerは、Pythonスクリプトをスタンドアロンの実行ファイルに変換するための強力なツールです。PyInstallerを使用することで、Pythonスクリプトを簡単に配布および実行可能な形に変換できるため、プロジェクトの効率的な管理と配布が可能になります。基本的なスクリプトのコンパイルから、複雑な依存関係を持つスクリプトの処理、カスタムアイコンと追加ファイルのパッケージまで、PyInstallerの理解と適用は、Python開発において非常に有用です。