create your handytool.py:

import sys
import pygtk
if not sys.platform == 'win32':
    pygtk.require('2.0')
import gtk

from mainwindow import MainWindow

if __name__ == '__main__':
    # enable threading
    gtk.threads_init()
    gtk.threads_enter()

    # create the main window
    myapp = MainWindow()

    # start the program loop
    gtk.main()

    # cleanup
    gtk.threads_leave()

create your setup.py file:

from distutils.core import setup
import py2exe

setup(
    name = 'handytool',
    description = 'Some handy tool',
    version = '1.0',

    windows = [
                  {
                      'script': 'handytool.py',
                      'icon_resources': [(1, "handytool.ico")],
                  }
              ],

    options = {
                  'py2exe': {
                      'packages':'encodings',
                      'includes': 'cairo, pango, pangocairo, atk, gobject',
                  }
              },

    data_files=[
                   'handytool.glade',
                   'readme.txt'
               ]
)

run setup.py py2exe. You'll get a warning:

The following modules appear to be missing
['gdk', 'ltihooks']

Ignore it

Once that's done, you'll need to copy the etc, lib and share directories from your GTK+ install (not the pygtk install) to the dist dir py2exe created. Optionaly, you can clean the share\locale dir to include only the locales you need for GTK+. Same thing for share\themes (I left both Default and MS-Windows).

• it seems that from lib/ only all the *.dlls in the subtree are needed, and from share/ only themes/ and locale/. saves lots of space

If you are using GtkBuilder and later versions of GTK+ and PyGTK, you may get the following error message:

Y:\my_handytool\dist\library.zip\gtk\_gtk.py:10: RuntimeWarning: tp_compare didn't return -1 or -2 for exception
ImportError: could not import gio
ImportError: could not import gio
Traceback (most recent call last):
  File "my_handytool.py", line 88, in <module>
  File "my_handytool.py", line 75, in __init__
AttributeError: 'module' object has no attribute 'Builder'

This issue can be resolved by adding the 'gio' module to the py2exe includes option in the setup.py file:

--- setup.py.org        2010-11-13 22:35:20.000000000 +0100
+++ setup.py    2010-11-13 20:26:02.000000000 +0100
@@ -14,7 +14,7 @@
     options = {
         'py2exe': {
             'dist_dir':'dist',
-            'includes': 'cairo, pango, pangocairo, atk, gobject',
+            'includes': 'cairo, pango, pangocairo, atk, gobject, gio',
             }
         },

If you are using kiwi, you will also have to copy the contents of the (path to python)/share/kiwi directory (and (path to python)/share/gazpacho, if you used gazpacho) to the dist dir. And you will have to create an empty 'kiwi' directory in the dist/pixmaps directory that you just copied there. (note: I have not tested kiwi with the Innosetup installer, but if you try it and it works edit this page and remove this note )

Note you'll want to set the working directory (Start in:) for any shortcut you create to the application directory containing the executable.

(Optional) an Innosetup .iss file to create an installer for handytool:

[Setup]
AppName=handytool
AppVerName=handytool 1.0
AppPublisher=me
AppPublisherURL=http://www.localhost.me
DefaultDirName={pf}\handytool
DefaultGroupName=handytool
DisableProgramGroupPage=true
OutputBaseFilename=setup
Compression=lzma
SolidCompression=true
AllowUNCPath=false
VersionInfoVersion=1.0
VersionInfoCompany=me inc
VersionInfoDescription=handytool
PrivilegeRequired=admin

[Dirs]
Name: {app}; Flags: uninsalwaysuninstall;

[Files]
Source: dist\*; DestDir: {app}; Flags: ignoreversion recursesubdirs createallsubdirs

[Icons]
Name: {group}\handytool; Filename: {app}\handytool.exe; WorkingDir: {app}

[Run]
Filename: {app}\handytool.exe; Description: {cm:LaunchProgram,handytool}; Flags: nowait postinstall skipifsilent

This Recipe has been tested with:

• Windows XP SP2

• Python 2.4.3

• gtk-win32 2.8.14-rc1

• pycairo 1.0.2-1

• pygtk 2.8.4-1

• kiwi 1.9.20 optional

• py2exe 0.6.5

• Inno Setup 5.1.6