Packaging with PyInstaller Glenn Ramsey Kiwi Pycon 2014 

What it does Makes the application independent Gathers python files and dependencies Embeds python interpreter and libraries Source is not included Does not actually create an installer! 

Where it can be used Windows + OS X + Linux + … Licensing PyInstaller itself – GPL >=2 Packaged program – Your choice Python 2.4 – 2.7 ( 3 - real soon now) Well documented 

Alternatives Py2exe - Windows Py2app - OS X BbFreeze - Win + OS X + Linux CxFreeze – Win + OS X + Linux (Python 3) 

How it works When launched a bootloader is started first. Bootloader Creates Python environment Starts Python interpreter Runs your program 

How to use it onefile and onedir (default) modes python -o pyinstaller.py /path/to/main.py On first run it will create a spec file, then use: python -o pyinstaller.py /path/to/main.spec 

A .spec file – analysis a = Analysis(myscript.py,...) Analyses imports Produces: a.scripts the python scripts named on the command line a.pure pure python modules needed by the scripts a.binaries non-python modules needed by the scripts 

A .spec file – pyz and exe pyz = PYZ(a.pure) Creates a compressed archive containing pure python modules exe = EXE(pyz, a.scripts + options, ...) Creates an executable with the embedded python interpreter 

A .spec file – Collect and Bundle coll = Collect(exe, a.binaries, a.zipfiles, a.datas, ...) Collects all files into a single directory app = Bundle(coll, name='MyApp' icon='/path/to/icon') OSX only – creates the app bundle 

The TOC class (name, path, typecode) Typecodes: “DATA”, “BINARY”, “OPTION” Use to add or remove Modules Options 

Including files Create a TOC – a tuple will suffice extra = [("defaults.cfg", os.path.join('..', 'GUI', 'defaults.cfg'), "DATA")] coll = collect(..., a.datas + extra) Can't include files outside the app dir Problem for OS X therefore use the build system 

Excluding files a.binaries - [('badmodule', None, None)] a.binaries = [x for x in a.binaries if \ not x[0].startswith("scipy")] a.binaries = [x for x in a.binaries if \ Not os.path.dirname(x[1]).startswith( "C:\\Windows\\system32")] 

Accessing files from a frozen app import sys import os ... if getattr(sys, 'frozen', False): # we are running in a |PyInstaller| bundle basedir = sys._MEIPASS if is_osx: res_path = os.path.join( sys._MEIPASS, "..", "Resources") else: # we are running in a normal Python env basedir = os.path.dirname(__file__) 

OSX specific my.app Contents Frameworks Info.plist MacOS (executable) (shared libs) Resources Plugins 

OSX specific files outside the bin dir e.g. plugins - use Cmake - use install_name_tool Info.plist LSBackgroundOnly 

Hooks Example: countrycode module Collects the file countrycode_data.csv from site-packages from PyInstaller.hooks.hookutils import collect_data_files datas = collect_data_files('countrycode') 

Hidden Imports For imports that PyInstaller can't find e.g. inside a function definition Can be used to workaround broken hooks Or just to force an import 

Setting an icon Pass the icon path as a parameter to: the EXE class - Windows The Bundle class – OSX ..., icon = '/path/to/icon', ... 

Actually creating an installer OSX – Drag'n'Drop or PackageMaker Windows - NSIS installer Linux - deb, rpm, bin Cmake / CPack 

Using with a build system Cmake Use template to create main.spec with correct paths Create rules to run PyInstaller 

Debugging 1. Check the log 2. -d – bootloader writes messages to stdout In spec file: Exe = EXE(..., debug = True, console = True) 3. If that doesn't work, then panic and get out the debugger. Live example - Simple PyQt5 application (wish me luck!) https://github.com/glennra/kpc2014 

Support / Contributing Pyinstaller.org Mailing list Active development Patches accepted https://github.com/pyinstaller/pyinstaller 

Thank you Acknowledgements PyInstaller team DigitalRowing Ltd