Freezing Your Code¶

bbFreeze¶

Prerequisite is to install Python, Setuptools and pywin32 dependency on Windows.

1. Install bbfreeze:

$ pip install bbfreeze

2. Write most basic bb_setup.py

from bbfreeze import Freezer

freezer = Freezer(distdir='dist')
freezer.addScript('foobar.py', gui_only=True)
freezer()

freezer = Freezer(distdir='dist', includes=['my_code'], excludes=['docs'])

3. (Optionally) include icon

freezer.setIcon('my_awesome_icon.ico')

4. Provide the Microsoft Visual C++ runtime DLL for the freezer. It might be possible to append your sys.path with the Microsoft Visual Studio path but I find it easier to drop msvcp90.dll in the same folder where your script resides.

5. Freeze!

$ python bb_setup.py

py2exe¶

Prerequisite is to install Python on Windows. The last release of py2exe is from the year 2014. There is not active development.

1. Download and install http://sourceforge.net/projects/py2exe/files/py2exe/
2. Write setup.py (List of configuration options):

from distutils.core import setup
import py2exe

setup(
    windows=[{'script': 'foobar.py'}],
)

3. (Optionally) include icon
4. (Optionally) one-file mode
5. Generate .exe into dist directory:

$ python setup.py py2exe

6. Provide the Microsoft Visual C++ runtime DLL. Two options: globally install dll on target machine or distribute dll alongside with .exe.

PyInstaller¶

Prerequisite is to have installed Python, Setuptools and pywin32 dependency on Windows.

• Most basic tutorial
• Manual

py2app¶

PyInstaller¶

PyInstaller can be used to build Unix executables and windowed apps on Mac OS X 10.6 (Snow Leopard) or newer.

To install PyInstaller, use pip:

$ pip install pyinstaller

To create a standard Unix executable, from say script.py, use:

$ pyinstaller script.py

This creates:

• a script.spec file, analogous to a make file
• a build folder, that holds some log files
• a dist folder, that holds the main executable script, and some dependent Python libraries

all in the same folder as script.py. PyInstaller puts all the Python libraries used in script.py into the dist folder, so when distributing the executable, distribute the whole dist folder.

The script.spec file can be edited to customise the build, with options such as:

• bundling data files with the executable
• including run-time libraries (.dll or .so files) that PyInstaller can’t infer automatically
• adding Python run-time options to the executable

Now script.spec can be run with pyinstaller (instead of using script.py again):

$ pyinstaller script.spec

To create a standalone windowed OS X application, use the --windowed option:

$ pyinstaller --windowed script.spec

This creates a script.app in the dist folder. Make sure to use GUI packages in your Python code, like PyQt or PySide, to control the graphical parts of the app.

There are several options in script.spec related to Mac OS X app bundles here. For example, to specify an icon for the app, use the icon=\path\to\icon.icns option.

bbFreeze¶

bbFreeze can be used with all distributions that has Python installed along with pip2 and/or easy_install.

For pip2, use the following:

$ pip2 install bbfreeze

Or, for easy_install:

$ easy_install bbfreeze

With bbFreeze installed, you’re ready to freeze your applications.

Let’s assume you have a script, say, “hello.py” and a module called “module.py” and you have a function in it that’s being used in your script. No need to worry, you can just ask to freeze the main entrypoint of your script and it should freeze entirely:

$ bbfreeze script.py

With this, it creates a folder called dist/, of which contains the executable of the script and required .so (shared objects) files linked against libraries used within the Python script.

Alternatively, you can create a script that does the freezing for you. An API for the freezer is available from the library within:

from bbfreeze import Freezer

freezer = Freezer(distdir='dist')
freezer.addScript('script.py', gui_only=True) # Enable gui_only kwarg for app that uses GUI packages.
freezer()

PyInstaller¶

PyInstaller can be used in a similar fashion as in OS X. The installation goes in the same manner as shown in the OS X section.

Don’t forget to have dependencies such as Python and pip installed for usage.