Pythonスクリプトのexe化 #Python

はじめに

先人に作ってもらったデータ変換用のPythonスクリプトを部署内で使用していたのだが、Python環境のないメンバーに展開するためにexe化することにした。
ひとまずPyinstallerを試したのだがエラー出るし重いしで、Py2exeも試すことにした。
結論から言うと、Excelの範囲で済むようなデータ処理は、マクロを組んだ方が…

前提

配布先はPython環境のない、プログラムになじみのないメンバーとする。(＝簡単にexeを起動するだけにしたい)
exe作成側の環境は以下の通り。

OS：Windows10
Docker：v20.10.6
Python：3.9.5
Pyinstaller：4.3
Py2exe：0.10.4.0

exe作成環境の準備

Anaconda環境でのexe作成はやめたほうがよい

Anacondaで多数のライブラリをインストールした状態だと、あちこちのライブラリを取り込んで巨大化したexeが生成される。
【悲報】PyInstallerさん、300MBのexeファイルを吐き出すようになる

一度自分の現環境で試したら500MBを超えた。

ので、Anacondaを削除するか、クリーンなWindows環境を用意するべき。
(Anaconda全削除は避けたい…)

Docker上のWindows環境を用意する

Docker上に、Python以外インストールされていない環境を用意し、随時必要なライブラリをインストールするのが無難。
主な手順は以下の通り。

Docker Desktopのインストール(＋Windowsモードに切り替え)
Pythonイメージの取得
Docker上でpip、Pyinstaller、Py2exeをインストール
exeを作成しながら、都度ライブラリを追加

Docker環境についてはこちらの記事参照。

Pyinstallerで作成

インストール

Docker上で以下を実施。

pip install pyinstaller

実行

Pyinstallerを実行するフォルダにexe化したいPythonコードを集めておき、メインのコードに対してPyinstallerを実行する。

pyinstaller hogehoge.py --onefile --noconsole

--onefileで、一つのexeとして出力するよう指示する。ないとpy2exeのように大量のファイル＋起動用のexeの形式で出力されるので注意。(exe単体では動作しない)
--noconsoleは、exe起動時にプロンプト画面を同時に開かないようにする。

エラーが出る

Failed to execute script

pip listでコードでimportしているライブラリが全てインストールされているか確認し、不足しているものをpipでインストールする。

原因不明な場合、一応2回実行してみるのもいいかもしれない。
一度目失敗したが、pyinstaller実行後に.specファイルができた後だとなぜか成功したということがあったので。

参考：
“Failed to execute script XX” エラー対処: PyinstallerでPygameをexe化するときの注意点
 【自動化】Pythonコードをexeファイル化する

成功したら

Pythonのソースファイルと同じフォルダにdistフォルダが出来ており、そこにexeファイルが入っているので、それを配布すればOK。

exeがうまく動かない

--noconsole"を外して、--debug allをつけた状態でexeを作成し、exe実行時のコンソールのメッセージからerrorを探すのが早い。
意外とコード上のエラーが出てくる。

参考：
pyinstallerでpythonファイルをexeファイルにする
 PyInstallerで作成した実行可能ファイル(.exe)が動かないときの調査方法

Py2exeで作成

参考：
py2exeのインストール【Pythonプログラムのexe化】

インストール

pip install py2exe

setup.pyを作成して保存

以下のコードをsetup.pyとして、py2exeを実行するフォルダに保存する。

setup.py

from distutils.core import setup
import py2exe

setup(console=['hogehoge.py'])

console=[ ]の部分にexe化したいメインのソースファイル名称を入れる。

実行

exe化したいPythonコード一式＋setup.pyが入った状態で以下を実行

python setup.py py2exe

成功したら

実行フォルダにできたdistの中にあるexeファイルを実行するとアプリが起動する。
exe単体では動かないので、distフォルダを丸ごと配布する必要がある。

exeが動かない

日本語名のフォルダの中で実行するとうまく動かないことがあるので、distフォルダをデスクトップ(C:\Users\username\Desktop)などに置いて起動するのが無難。

比較

PyinstallerとPy2exeでできたexeの比較。

生成するファイルの総サイズはほぼ同じ。
だいたい30MB程度だったが、これは何のパッケージを使うか次第。Pandasが入ったので重くなったかもしれない。
起動は圧倒的にPy2exeで生成したexeが早い
Py2exeだとすぐ起動するが、Pyinstallerは30秒くらいかかる。
Pyinstallerはexe一つの配布で済むがPy2exeはフォルダごと配布が必要

3.について、exeのショートカットをフォルダの外に作ってもらえばよいのだが、プログラムになれていない人に敷居が高いと感じたので、今回はPyinstallerで作ったexeを配布した。(週一くらいしか使わないので。毎日使う、とかなら話は別だが)

Pyinstallerでも軽量・高速化はできるらしいが、今回は行なっていない。
参考：
pyhon.py→exe化→軽量化→高速化忘備録（pyinstaller py2exe）

(参考)インストールしたライブラリ

C:\>pip list
Package                   Version
------------------------- ---------
altgraph                  0.17
cachetools                4.2.2
configparser              5.0.2
DateTime                  4.3
future                    0.18.2
numpy                     1.21.0
pandas                    1.2.5
pefile                    2021.5.24
pip                       21.1.2
py2exe                    0.10.4.0
pyinstaller               4.3
pyinstaller-hooks-contrib 2021.1
python-dateutil           2.8.1
pytz                      2021.1
pywin32-ctypes            0.2.0
setuptools                57.0.0
six                       1.16.0
tk                        0.1.0
wheel                     0.36.2
xlrd                      2.0.1
zope.interface            5.4.0