pyinstaller

Configure and build y PyInstaller project in one run

Author: Giovanni Bajo
Copyright: 2005-2011 by Giovanni Bajo, based on previous work under copyright 2002 McMillan Enterprises, Inc.
Version: PyInstaller 2.1.1dev-3607bf4
Manual section:1

SYNOPSIS

pyinstaller <options> SCRIPT

DESCRIPTION

Automatically calls pyi-configure, pyi-makespec and pyi-build in one run. In most cases, running pyinstaller will be all you have to do.

Please see the PyInstaller Manual for more information.

OPTIONS

-h, --help show this help message and exit
-v, --version Show program version info and exit.
--distpath=DIR Where to put the bundled app (default: /home/hartmut/p rojekte/software/pyinstaller/doc/source/dist)
--workpath=WORKPATH
 Where to put all the temporary work files, .log, .pyz and etc. (default: /home/hartmut/projekte/software/pyi nstaller/doc/source/build)
-y, --noconfirm
 Replace output directory (default: SPECPATH/dist/SPECNAME) without asking for confirmation
--upx-dir=UPX_DIR
 Path to UPX utility (default: search the execution path)
-a, --ascii Do not include unicode encoding support (default: included if available)
--clean Clean PyInstaller cache and remove temporary files before building.
--log-level=LOGLEVEL
 Amount of detail in build-time console messages (default: INFO, choose one of DEBUG, INFO, WARN, ERROR, CRITICAL)

What to generate

-F, --onefile Create a one-file bundled executable.
-D, --onedir Create a one-folder bundle containing an executable (default)
--specpath=DIR Folder to store the generated spec file (default: current directory)
-n NAME, --name=NAME
 Name to assign to the bundled app and spec file (default: first script's basename)

How to generate

-d, --debug Tell the bootloader to issue progress messages while initializing and starting the bundled app. Used to diagnose problems with missing imports.
-s, --strip Apply a symbol-table strip to the executable and shared libs (not recommended for Windows)
--noupx Do not use UPX even if it is available (works differently between Windows and *nix)

Windows and Mac OS X specific options

-c, --console, --nowindowed
 Open a console window for standard i/o (default)
-w, --windowed, --noconsole
 Windows and Mac OS X: do not provide a console window for standard i/o. On Mac OS X this also triggers building an OS X .app bundle.This option is ignored in *NIX systems.
-i <FILE.ico or FILE.exe,ID or FILE.icns>, --icon=<FILE.ico or FILE.exe,ID or FILE.icns>
 FILE.ico: apply that icon to a Windows executable. FILE.exe,ID, extract the icon with ID from an exe. FILE.icns: apply the icon to the .app bundle on Mac OS X

Windows specific options

--version-file=FILE
 add a version resource from FILE to the exe
-m <FILE or XML>, --manifest=<FILE or XML>
 add manifest FILE or XML to the exe
-r <FILE[,TYPE[,NAME[,LANGUAGE]]]>, --resource=<FILE[,TYPE[,NAME[,LANGUAGE]]]>
 Add or update a resource of the given type, name and language from FILE to a Windows executable. FILE can be a data file or an exe/dll. For data files, at least TYPE and NAME must be specified. LANGUAGE defaults to 0 or may be specified as wildcard * to update all resources of the given TYPE and NAME. For exe/dll files, all resources from FILE will be added/updated to the final executable if TYPE, NAME and LANGUAGE are omitted or specified as wildcard *.This option can be used multiple times.
--uac-admin Using this option creates a Manifest which will request elevation upon application restart.
--uac-uiaccess Using this option allows an elevated application to work with Remote Desktop.

Mac OS X specific options

--osx-bundle-identifier=BUNDLE_IDENTIFIER
 Mac OS X .app bundle identifier is used as the default unique program name for code signing purposes. The usual form is a hierarchical name in reverse DNS notation. For example: com.mycompany.department.appname (default: first script's basename)

SEE ALSO

pyi-configure(1), pyi-makespec(1), pyi-build(1), The PyInstaller Manual, pyinstaller(1)

Project Homepage http://www.pyinstaller.org