wxPython/config.py

   1 #----------------------------------------------------------------------
   2 # Name:        wx.build.config
   3 # Purpose:     Most of the contents of this module used to be located
   4 #              in wxPython's setup.py script.  It was moved here so
   5 #              it would be installed with the rest of wxPython and
   6 #              could therefore be used by the setup.py for other
   7 #              projects that needed this same info and functionality
   8 #              (most likely in order to be compatible with wxPython.)
   9 #
  10 #              This split from setup.py is still fairly rough, and
  11 #              some things may still get shuffled back and forth,
  12 #              refactored, etc.  Please send me any comments and
  13 #              suggestions about this.
  14 #
  15 # Author:      Robin Dunn
  16 #
  17 # Created:     23-March-2004
  18 # RCS-ID:      $Id$
  19 # Copyright:   (c) 2004 by Total Control Software
  20 # Licence:     wxWindows license
  21 #----------------------------------------------------------------------
  22
  23 import sys, os, glob, fnmatch, tempfile
  24 from distutils.core      import setup, Extension
  25 from distutils.file_util import copy_file
  26 from distutils.dir_util  import mkpath
  27 from distutils.dep_util  import newer
  28 from distutils.spawn     import spawn
  29
  30 import distutils.command.install
  31 import distutils.command.install_data
  32 import distutils.command.install_headers
  33 import distutils.command.clean
  34
  35 #----------------------------------------------------------------------
  36 # flags and values that affect this script
  37 #----------------------------------------------------------------------
  38
  39 VER_MAJOR        = 2      # The first three must match wxWidgets
  40 VER_MINOR        = 7
  41 VER_RELEASE      = 0
  42 VER_SUBREL       = 0      # wxPython release num for x.y.z release of wxWidgets
  43 VER_FLAGS        = "pre"  # release flags, such as prerelease or RC num, etc.
  44
  45 DESCRIPTION      = "Cross platform GUI toolkit for Python"
  46 AUTHOR           = "Robin Dunn"
  47 AUTHOR_EMAIL     = "Robin Dunn <robin@alldunn.com>"
  48 URL              = "http://wxPython.org/"
  49 DOWNLOAD_URL     = "http://wxPython.org/download.php"
  50 LICENSE          = "wxWidgets Library License (LGPL derivative)"
  51 PLATFORMS        = "WIN32,OSX,POSIX"
  52 KEYWORDS         = "GUI,wx,wxWindows,wxWidgets,cross-platform"
  53
  54 LONG_DESCRIPTION = """\
  55 wxPython is a GUI toolkit for Python that is a wrapper around the
  56 wxWidgets C++ GUI library.  wxPython provides a large variety of
  57 window types and controls, all implemented with a native look and
  58 feel (by using the native widgets) on the platforms upon which it is
  59 supported.
  60 """
  61
  62 CLASSIFIERS      = """\
  63 Development Status :: 6 - Mature
  64 Environment :: MacOS X :: Carbon
  65 Environment :: Win32 (MS Windows)
  66 Environment :: X11 Applications :: GTK
  67 Intended Audience :: Developers
  68 License :: OSI Approved
  69 Operating System :: MacOS :: MacOS X
  70 Operating System :: Microsoft :: Windows :: Windows 95/98/2000
  71 Operating System :: POSIX
  72 Programming Language :: Python
  73 Topic :: Software Development :: User Interfaces
  74 """
  75
  76 ## License :: OSI Approved :: wxWidgets Library Licence
  77
  78
  79 # Config values below this point can be reset on the setup.py command line.
  80
  81 BUILD_GLCANVAS = 1 # If true, build the contrib/glcanvas extension module
  82 BUILD_OGL = 0      # If true, build the contrib/ogl extension module
  83 BUILD_STC = 1      # If true, build the contrib/stc extension module
  84 BUILD_GIZMOS = 1   # Build a module for the gizmos contrib library
  85 BUILD_ANIMATE = 1  # Build a module for the animate contrib library
  86 BUILD_DLLWIDGET = 0# Build a module that enables unknown wx widgets
  87                    # to be loaded from a DLL and to be used from Python.
  88
  89                    # Internet Explorer wrapper (experimental)
  90 BUILD_ACTIVEX = (os.name == 'nt')  # new version of IEWIN and more
  91
  92
  93 CORE_ONLY = 0      # if true, don't build any of the above
  94
  95 PREP_ONLY = 0      # Only run the prepatory steps, not the actual build.
  96
  97 USE_SWIG = 0       # Should we actually execute SWIG, or just use the
  98                    # files already in the distribution?
  99
 100 SWIG = "swig"      # The swig executable to use.
 101
 102 BUILD_RENAMERS = 0 # Should we build the renamer modules too?
 103
 104 FULL_DOCS = 0      # Some docstrings are split into a basic docstring and a
 105                    # details string.  Setting this flag to 1 will
 106                    # cause the two strings to be combined and output
 107                    # as the full docstring.
 108
 109 UNICODE = 0        # This will pass the 'wxUSE_UNICODE' flag to SWIG and
 110                    # will ensure that the right headers are found and the
 111                    # right libs are linked.
 112
 113 UNDEF_NDEBUG = 1   # Python 2.2 on Unix/Linux by default defines NDEBUG,
 114                    # and distutils will pick this up and use it on the
 115                    # compile command-line for the extensions.  This could
 116                    # conflict with how wxWidgets was built.  If NDEBUG is
 117                    # set then wxWidgets' __WXDEBUG__ setting will be turned
 118                    # off.  If wxWidgets was actually built with it turned
 119                    # on then you end up with mismatched class structures,
 120                    # and wxPython will crash.
 121
 122 NO_SCRIPTS = 0     # Don't install the tool scripts
 123 NO_HEADERS = 0     # Don't install the wxPython *.h and *.i files
 124
 125 INSTALL_MULTIVERSION = 1 # Install the packages such that multiple versions
 126                    # can co-exist.  When turned on the wx and wxPython
 127                    # pacakges will be installed in a versioned subdir
 128                    # of site-packages, and a *.pth file will be
 129                    # created that adds that dir to the sys.path.  In
 130                    # addition, a wxselect.py module will be installed
 131                    # to site-pacakges that will allow applications to
 132                    # choose a specific version if more than one is
 133                    # installed.
 134
 135 FLAVOUR = ""       # Optional flavour string to be appended to VERSION
 136                    # in MULTIVERSION installs
 137
 138 EP_ADD_OPTS = 1    # When doing MULTIVERSION installs the wx port and
 139                    # ansi/unicode settings can optionally be added to the
 140                    # subdir path used in site-packages
 141
 142 EP_FULL_VER = 0    # When doing MULTIVERSION installs the default is to
 143                    # put only 2 or 3 (depending on stable/unstable) of
 144                    # the version compnonents into the "extra path"
 145                    # subdir of site-packages.  Setting this option to
 146                    # 1 will cause the full 4 components of the version
 147                    # number to be used instead.
 148
 149 WX_CONFIG = None   # Usually you shouldn't need to touch this, but you can set
 150                    # it to pass an alternate version of wx-config or alternate
 151                    # flags, eg. as required by the .deb in-tree build.  By
 152                    # default a wx-config command will be assembled based on
 153                    # version, port, etc. and it will be looked for on the
 154                    # default $PATH.
 155
 156 SYS_WX_CONFIG = None # When installing an in tree build, setup.py uses wx-config
 157                      # for two different purposes.  First, to determine the prefix
 158                      # where files will be installed, and secondly, to initialise
 159                      # build_options.py with the correct options for it.
 160                      # WX_CONFIG is used for the first task.  SYS_WX_CONFIG may
 161                      # be set independently, to the value that should appear in
 162                      # build_options.py, if it is different to that.  The default
 163                      # is to use the value of WX_CONFIG.
 164
 165 WXPORT = 'gtk2'    # On Linux/Unix there are several ports of wxWidgets available.
 166                    # Setting this value lets you select which will be used for
 167                    # the wxPython build.  Possibilites are 'gtk', 'gtk2' and
 168                    # 'x11'.  Curently only gtk and gtk2 works.
 169
 170 BUILD_BASE = "build" # Directory to use for temporary build files.
 171                      # This name will be appended to if the WXPORT or
 172                      # the UNICODE flags are set to non-standard
 173                      # values.  See below.
 174
 175
 176 CONTRIBS_INC = ""  # A dir to add as an -I flag when compiling the contribs
 177
 178
 179 # Some MSW build settings
 180
 181 MONOLITHIC = 0     # The core wxWidgets lib can be built as either a
 182                    # single monolithic DLL or as a collection of DLLs.
 183                    # This flag controls which set of libs will be used
 184                    # on Windows.  (For other platforms it is automatic
 185                    # via using wx-config.)
 186
 187 FINAL = 0          # Will use the release version of the wxWidgets libs on MSW.
 188
 189 HYBRID = 1         # Will use the "hybrid" version of the wxWidgets
 190                    # libs on MSW.  A "hybrid" build is one that is
 191                    # basically a release build, but that also defines
 192                    # __WXDEBUG__ to activate the runtime checks and
 193                    # assertions in the library.  When any of these is
 194                    # triggered it is turned into a Python exception so
 195                    # this is a very useful feature to have turned on.
 196
 197
 198                    # Version part of wxWidgets LIB/DLL names
 199 WXDLLVER = '%d%d' % (VER_MAJOR, VER_MINOR)
 200
 201 WXPY_SRC = '.'  # Assume we're in the source tree already, but allow the
 202                 # user to change it, particularly for extension building.
 203
 204
 205 #----------------------------------------------------------------------
 206
 207 def msg(text):
 208     if hasattr(sys, 'setup_is_main') and sys.setup_is_main:
 209         print text
 210
 211
 212 def opj(*args):
 213     path = os.path.join(*args)
 214     return os.path.normpath(path)
 215
 216
 217 def libFlag():
 218     if FINAL:
 219         rv = ''
 220     elif HYBRID:
 221         rv = 'h'
 222     else:
 223         rv = 'd'
 224     if UNICODE:
 225         rv = 'u' + rv
 226     return rv
 227
 228
 229 #----------------------------------------------------------------------
 230 # Some other globals
 231 #----------------------------------------------------------------------
 232
 233 PKGDIR = 'wx'
 234 wxpExtensions = []
 235 DATA_FILES = []
 236 CLEANUP = []
 237
 238 force = '--force' in sys.argv or '-f' in sys.argv
 239 debug = '--debug' in sys.argv or '-g' in sys.argv
 240 cleaning = 'clean' in sys.argv
 241
 242
 243 # change the PORT default for wxMac
 244 if sys.platform[:6] == "darwin":
 245     WXPORT = 'mac'
 246
 247 # and do the same for wxMSW, just for consistency
 248 if os.name == 'nt':
 249     WXPORT = 'msw'
 250
 251 WXPYTHON_TYPE_TABLE = '_wxPython_table'
 252
 253 #----------------------------------------------------------------------
 254 # Check for build flags on the command line
 255 #----------------------------------------------------------------------
 256
 257 # Boolean (int) flags
 258 for flag in [ 'BUILD_ACTIVEX', 'BUILD_ANIMATE', 'BUILD_DLLWIDGET',
 259               'BUILD_GIZMOS', 'BUILD_GLCANVAS',
 260               'BUILD_OGL', 'BUILD_STC',
 261              'CORE_ONLY', 'PREP_ONLY', 'USE_SWIG', 'UNICODE',
 262              'UNDEF_NDEBUG', 'NO_SCRIPTS', 'NO_HEADERS', 'BUILD_RENAMERS',
 263              'FULL_DOCS', 'INSTALL_MULTIVERSION', 'EP_ADD_OPTS', 'EP_FULL_VER',
 264              'MONOLITHIC', 'FINAL', 'HYBRID', ]:
 265     for x in range(len(sys.argv)):
 266         if sys.argv[x].find(flag) == 0:
 267             pos = sys.argv[x].find('=') + 1
 268             if pos > 0:
 269                 vars()[flag] = eval(sys.argv[x][pos:])
 270                 sys.argv[x] = ''
 271
 272 # String options
 273 for option in ['WX_CONFIG', 'SYS_WX_CONFIG', 'WXDLLVER', 'BUILD_BASE',
 274                'WXPORT', 'SWIG', 'CONTRIBS_INC', 'WXPY_SRC', 'FLAVOUR',
 275                ]:
 276     for x in range(len(sys.argv)):
 277         if sys.argv[x].find(option) == 0:
 278             pos = sys.argv[x].find('=') + 1
 279             if pos > 0:
 280                 vars()[option] = sys.argv[x][pos:]
 281                 sys.argv[x] = ''
 282
 283 sys.argv = filter(None, sys.argv)
 284
 285
 286 #----------------------------------------------------------------------
 287 # build options file
 288 #----------------------------------------------------------------------
 289
 290 if SYS_WX_CONFIG is None:
 291     SYS_WX_CONFIG = WX_CONFIG
 292
 293 build_options_template = """
 294 UNICODE=%d
 295 UNDEF_NDEBUG=%d
 296 INSTALL_MULTIVERSION=%d
 297 FLAVOUR="%s"
 298 EP_ADD_OPTS=%d
 299 EP_FULL_VER=%d
 300 WX_CONFIG="%s"
 301 WXPORT="%s"
 302 MONOLITHIC=%d
 303 FINAL=%d
 304 HYBRID=%d
 305 """ % (UNICODE, UNDEF_NDEBUG, INSTALL_MULTIVERSION, FLAVOUR, EP_ADD_OPTS,
 306        EP_FULL_VER, SYS_WX_CONFIG, WXPORT, MONOLITHIC, FINAL, HYBRID)
 307
 308 try:
 309     from build_options import *
 310 except:
 311     build_options_file = os.path.join(os.path.dirname(__file__), "build_options.py")
 312     if not os.path.exists(build_options_file):
 313         try:
 314             myfile = open(build_options_file, "w")
 315             myfile.write(build_options_template)
 316             myfile.close()
 317         except:
 318             print "WARNING: Unable to create build_options.py."
 319
 320
 321 #----------------------------------------------------------------------
 322 # some helper functions
 323 #----------------------------------------------------------------------
 324
 325 def Verify_WX_CONFIG():
 326     """ Called below for the builds that need wx-config, if WX_CONFIG
 327         is not set then determines the flags needed based on build
 328         options and searches for wx-config on the PATH.
 329     """
 330     # if WX_CONFIG hasn't been set to an explicit value then construct one.
 331     global WX_CONFIG
 332     if WX_CONFIG is None:
 333         WX_CONFIG='wx-config'
 334         port = WXPORT
 335         if port == "x11":
 336             port = "x11univ"
 337         flags =  ' --toolkit=%s' % port
 338         flags += ' --unicode=%s' % (UNICODE and 'yes' or 'no')
 339         flags += ' --version=%s.%s' % (VER_MAJOR, VER_MINOR)
 340
 341         searchpath = os.environ["PATH"]
 342         for p in searchpath.split(':'):
 343             fp = os.path.join(p, 'wx-config')
 344             if os.path.exists(fp) and os.access(fp, os.X_OK):
 345                 # success
 346                 msg("Found wx-config: " + fp)
 347                 msg("    Using flags: " + flags)
 348                 WX_CONFIG = fp + flags
 349                 if hasattr(sys, 'setup_is_main') and not sys.setup_is_main:
 350                     WX_CONFIG += " 2>/dev/null "
 351                 break
 352         else:
 353             msg("ERROR: WX_CONFIG not specified and wx-config not found on the $PATH")
 354             # should we exit?
 355
 356         # TODO:  execute WX_CONFIG --list and verify a matching config is found
 357
 358
 359 def run_swig(files, dir, gendir, package, USE_SWIG, force, swig_args,
 360              swig_deps=[], add_under=False):
 361     """Run SWIG the way I want it done"""
 362
 363     if USE_SWIG and not os.path.exists(os.path.join(dir, gendir)):
 364         os.mkdir(os.path.join(dir, gendir))
 365
 366     sources = []
 367
 368     if add_under:  pre = '_'
 369     else:          pre = ''
 370
 371     for file in files:
 372         basefile = os.path.splitext(file)[0]
 373         i_file   = os.path.join(dir, file)
 374         py_file  = os.path.join(dir, gendir, pre+basefile+'.py')
 375         cpp_file = os.path.join(dir, gendir, pre+basefile+'_wrap.cpp')
 376
 377         if add_under:
 378             interface = ['-interface', '_'+basefile+'_']
 379         else:
 380             interface = []
 381
 382         sources.append(cpp_file)
 383
 384         if not cleaning and USE_SWIG:
 385             for dep in swig_deps:
 386                 # this may fail for external builds, but it's not
 387                 # a fatal error, so keep going.
 388                 try:
 389                     if newer(dep, py_file) or newer(dep, cpp_file):
 390                         force = 1
 391                         break
 392                 except:
 393                     pass
 394
 395             if force or newer(i_file, py_file) or newer(i_file, cpp_file):
 396                 ## we need forward slashes here, even on win32
 397                 #cpp_file = opj(cpp_file) #'/'.join(cpp_file.split('\\'))
 398                 #i_file = opj(i_file)     #'/'.join(i_file.split('\\'))
 399
 400                 if BUILD_RENAMERS:
 401                     xmltemp = tempfile.mktemp('.xml')
 402
 403                     # First run swig to produce the XML file, adding
 404                     # an extra -D that prevents the old rename
 405                     # directives from being used
 406                     cmd = [ swig_cmd ] + swig_args + \
 407                           [ '-DBUILDING_RENAMERS', '-xmlout', xmltemp ] + \
 408                           ['-I'+dir, '-o', cpp_file, i_file]
 409                     msg(' '.join(cmd))
 410                     spawn(cmd)
 411
 412                     # Next run build_renamers to process the XML
 413                     myRenamer = BuildRenamers()
 414                     myRenamer.run(dir, pre+basefile, xmltemp)
 415                     os.remove(xmltemp)
 416
 417                 # Then run swig for real
 418                 cmd = [ swig_cmd ] + swig_args + interface + \
 419                       ['-I'+dir, '-o', cpp_file, i_file]
 420                 msg(' '.join(cmd))
 421                 spawn(cmd)
 422
 423
 424         # copy the generated python file to the package directory
 425         copy_file(py_file, package, update=not force, verbose=0)
 426         CLEANUP.append(opj(package, os.path.basename(py_file)))
 427
 428     return sources
 429
 430
 431 def swig_version():
 432     # It may come on either stdout or stderr, depending on the
 433     # version, so read both.
 434     i, o, e = os.popen3(SWIG + ' -version', 't')
 435     stext = o.read() + e.read()
 436     import re
 437     match = re.search(r'[0-9]+\.[0-9]+\.[0-9]+$', stext, re.MULTILINE)
 438     if not match:
 439         raise 'NotFound'
 440     SVER = match.group(0)
 441     return SVER
 442
 443
 444 # Specializations of some distutils command classes
 445 class wx_smart_install_data(distutils.command.install_data.install_data):
 446     """need to change self.install_dir to the actual library dir"""
 447     def run(self):
 448         install_cmd = self.get_finalized_command('install')
 449         self.install_dir = getattr(install_cmd, 'install_lib')
 450         return distutils.command.install_data.install_data.run(self)
 451
 452
 453 class wx_extra_clean(distutils.command.clean.clean):
 454     """
 455     Also cleans stuff that this setup.py copies itself.  If the
 456     --all flag was used also searches for .pyc, .pyd, .so files
 457     """
 458     def run(self):
 459         from distutils import log
 460         from distutils.filelist import FileList
 461         global CLEANUP
 462
 463         distutils.command.clean.clean.run(self)
 464
 465         if self.all:
 466             fl = FileList()
 467             fl.include_pattern("*.pyc", 0)
 468             fl.include_pattern("*.pyd", 0)
 469             fl.include_pattern("*.so", 0)
 470             CLEANUP += fl.files
 471
 472         for f in CLEANUP:
 473             if os.path.isdir(f):
 474                 try:
 475                     if not self.dry_run and os.path.exists(f):
 476                         os.rmdir(f)
 477                     log.info("removing '%s'", f)
 478                 except IOError:
 479                     log.warning("unable to remove '%s'", f)
 480
 481             else:
 482                 try:
 483                     if not self.dry_run and os.path.exists(f):
 484                         os.remove(f)
 485                     log.info("removing '%s'", f)
 486                 except IOError:
 487                     log.warning("unable to remove '%s'", f)
 488
 489
 490
 491 class wx_install(distutils.command.install.install):
 492     """
 493     Turns off install_path_file
 494     """
 495     def initialize_options(self):
 496         distutils.command.install.install.initialize_options(self)
 497         self.install_path_file = 0
 498
 499
 500 class wx_install_headers(distutils.command.install_headers.install_headers):
 501     """
 502     Install the header files to the WXPREFIX, with an extra dir per
 503     filename too
 504     """
 505     def initialize_options(self):
 506         self.root = None
 507         distutils.command.install_headers.install_headers.initialize_options(self)
 508
 509     def finalize_options(self):
 510         self.set_undefined_options('install', ('root', 'root'))
 511         distutils.command.install_headers.install_headers.finalize_options(self)
 512
 513     def run(self):
 514         if os.name == 'nt':
 515             return
 516         headers = self.distribution.headers
 517         if not headers:
 518             return
 519
 520         root = self.root
 521         if root is None or WXPREFIX.startswith(root):
 522             root = ''
 523         for header, location in headers:
 524             install_dir = os.path.normpath(root +
 525                                            WXPREFIX +
 526                                            '/include/wx-%d.%d/wx' % (VER_MAJOR, VER_MINOR) +
 527                                            location)
 528             self.mkpath(install_dir)
 529             (out, _) = self.copy_file(header, install_dir)
 530             self.outfiles.append(out)
 531
 532
 533
 534
 535 def build_locale_dir(destdir, verbose=1):
 536     """Build a locale dir under the wxPython package for MSW"""
 537     moFiles = glob.glob(opj(WXDIR, 'locale', '*.mo'))
 538     for src in moFiles:
 539         lang = os.path.splitext(os.path.basename(src))[0]
 540         dest = opj(destdir, lang, 'LC_MESSAGES')
 541         mkpath(dest, verbose=verbose)
 542         copy_file(src, opj(dest, 'wxstd.mo'), update=1, verbose=verbose)
 543         CLEANUP.append(opj(dest, 'wxstd.mo'))
 544         CLEANUP.append(dest)
 545
 546
 547 def build_locale_list(srcdir):
 548     # get a list of all files under the srcdir, to be used for install_data
 549     def walk_helper(lst, dirname, files):
 550         for f in files:
 551             filename = opj(dirname, f)
 552             if not os.path.isdir(filename):
 553                 lst.append( (dirname, [filename]) )
 554     file_list = []
 555     os.path.walk(srcdir, walk_helper, file_list)
 556     return file_list
 557
 558
 559 def find_data_files(srcdir, *wildcards):
 560     # get a list of all files under the srcdir matching wildcards,
 561     # returned in a format to be used for install_data
 562
 563     def walk_helper(arg, dirname, files):
 564         names = []
 565         lst, wildcards = arg
 566         for wc in wildcards:
 567             for f in files:
 568                 filename = opj(dirname, f)
 569                 if fnmatch.fnmatch(filename, wc) and not os.path.isdir(filename):
 570                     names.append(filename)
 571         if names:
 572             lst.append( (dirname, names ) )
 573
 574     file_list = []
 575     os.path.walk(srcdir, walk_helper, (file_list, wildcards))
 576     return file_list
 577
 578
 579 def makeLibName(name):
 580     if os.name == 'posix':
 581         libname = '%s_%s-%s' % (WXBASENAME, name, WXRELEASE)
 582     elif name:
 583         libname = 'wxmsw%s%s_%s' % (WXDLLVER, libFlag(), name)
 584     else:
 585         libname = 'wxmsw%s%s' % (WXDLLVER, libFlag())
 586     return [libname]
 587
 588
 589
 590 def adjustCFLAGS(cflags, defines, includes):
 591     '''Extract the raw -I, -D, and -U flags and put them into
 592        defines and includes as needed.'''
 593     newCFLAGS = []
 594     for flag in cflags:
 595         if flag[:2] == '-I':
 596             includes.append(flag[2:])
 597         elif flag[:2] == '-D':
 598             flag = flag[2:]
 599             if flag.find('=') == -1:
 600                 defines.append( (flag, None) )
 601             else:
 602                 defines.append( tuple(flag.split('=')) )
 603         elif flag[:2] == '-U':
 604             defines.append( (flag[2:], ) )
 605         else:
 606             newCFLAGS.append(flag)
 607     return newCFLAGS
 608
 609
 610
 611 def adjustLFLAGS(lfags, libdirs, libs):
 612     '''Extract the -L and -l flags and put them in libdirs and libs as needed'''
 613     newLFLAGS = []
 614     for flag in lflags:
 615         if flag[:2] == '-L':
 616             libdirs.append(flag[2:])
 617         elif flag[:2] == '-l':
 618             libs.append(flag[2:])
 619         else:
 620             newLFLAGS.append(flag)
 621
 622     return newLFLAGS
 623
 624
 625
 626 def getExtraPath(shortVer=True, addOpts=False):
 627     """Get the dirname that wxPython will be installed under."""
 628
 629     if shortVer:
 630         # short version, just Major.Minor
 631         ep = "wx-%d.%d" % (VER_MAJOR, VER_MINOR)
 632
 633         # plus release if minor is odd
 634         if VER_MINOR % 2 == 1:
 635             ep += ".%d" % VER_RELEASE
 636
 637     else:
 638         # long version, full version
 639         ep = "wx-%d.%d.%d.%d" % (VER_MAJOR, VER_MINOR, VER_RELEASE, VER_SUBREL)
 640
 641     if addOpts:
 642         port = WXPORT
 643         if port == "msw": port = "win32"
 644         ep += "-%s-%s" % (WXPORT, (UNICODE and 'unicode' or 'ansi'))
 645
 646     if FLAVOUR:
 647         ep += "-" + FLAVOUR
 648
 649     return ep
 650
 651 #----------------------------------------------------------------------
 652 # sanity checks
 653
 654 if CORE_ONLY:
 655     BUILD_GLCANVAS = 0
 656     BUILD_OGL = 0
 657     BUILD_STC = 0
 658     BUILD_GIZMOS = 0
 659     BUILD_DLLWIDGET = 0
 660     BUILD_ACTIVEX = 0
 661     BUILD_ANIMATE = 0
 662
 663 if debug:
 664     FINAL  = 0
 665     HYBRID = 0
 666
 667 if FINAL:
 668     HYBRID = 0
 669
 670 if UNICODE and WXPORT not in ['msw', 'gtk2', 'mac']:
 671     raise SystemExit, "UNICODE mode not currently supported on this WXPORT: "+WXPORT
 672
 673
 674 if CONTRIBS_INC:
 675     CONTRIBS_INC = [ CONTRIBS_INC ]
 676 else:
 677     CONTRIBS_INC = []
 678
 679
 680 #----------------------------------------------------------------------
 681 # Setup some platform specific stuff
 682 #----------------------------------------------------------------------
 683
 684 if os.name == 'nt':
 685     # Set compile flags and such for MSVC.  These values are derived
 686     # from the wxWidgets makefiles for MSVC, other compilers settings
 687     # will probably vary...
 688     if os.environ.has_key('WXWIN'):
 689         WXDIR = os.environ['WXWIN']
 690     else:
 691         msg("WARNING: WXWIN not set in environment.")
 692         WXDIR = '..'  # assumes in CVS tree
 693     WXPLAT = '__WXMSW__'
 694     GENDIR = 'msw'
 695
 696     includes = ['include', 'src',
 697                 opj(WXDIR, 'lib', 'vc_dll', 'msw'  + libFlag()),
 698                 opj(WXDIR, 'include'),
 699                 opj(WXDIR, 'contrib', 'include'),
 700                 ]
 701
 702     defines = [ ('WIN32', None),
 703                 ('_WINDOWS', None),
 704
 705                 (WXPLAT, None),
 706                 ('WXUSINGDLL', '1'),
 707
 708                 ('SWIG_TYPE_TABLE', WXPYTHON_TYPE_TABLE),
 709                 ('SWIG_PYTHON_OUTPUT_TUPLE', None),
 710                 ('WXP_USE_THREAD', '1'),
 711                 ]
 712
 713     if UNDEF_NDEBUG:
 714         defines.append( ('NDEBUG',) )  # using a 1-tuple makes it do an undef
 715
 716     if HYBRID:
 717         defines.append( ('__NO_VC_CRTDBG__', None) )
 718
 719     if not FINAL or HYBRID:
 720         defines.append( ('__WXDEBUG__', None) )
 721
 722     if UNICODE:
 723         defines.append( ('wxUSE_UNICODE', 1) )
 724
 725     libdirs = [ opj(WXDIR, 'lib', 'vc_dll') ]
 726     if MONOLITHIC:
 727         libs = makeLibName('')
 728     else:
 729         libs = [ 'wxbase' + WXDLLVER + libFlag(),
 730                  'wxbase' + WXDLLVER + libFlag() + '_net',
 731                  'wxbase' + WXDLLVER + libFlag() + '_xml',
 732                  makeLibName('core')[0],
 733                  makeLibName('adv')[0],
 734                  makeLibName('html')[0],
 735                  makeLibName('xrc')[0],
 736                  ]
 737
 738     libs = libs + ['kernel32', 'user32', 'gdi32', 'comdlg32',
 739             'winspool', 'winmm', 'shell32', 'oldnames', 'comctl32',
 740             'odbc32', 'ole32', 'oleaut32', 'uuid', 'rpcrt4',
 741             'advapi32', 'wsock32']
 742
 743
 744     cflags = [ '/Gy',
 745              # '/GX-'  # workaround for internal compiler error in MSVC on some machines
 746              ]
 747     lflags = None
 748
 749     # Other MSVC flags...
 750     # Too bad I don't remember why I was playing with these, can they be removed?
 751     if FINAL:
 752         pass #cflags = cflags + ['/O1']
 753     elif HYBRID :
 754         pass #cflags = cflags + ['/Ox']
 755     else:
 756         pass # cflags = cflags + ['/Od', '/Z7']
 757              # lflags = ['/DEBUG', ]
 758
 759
 760
 761 #----------------------------------------------------------------------
 762
 763 elif os.name == 'posix':
 764     WXDIR = '..'
 765     includes = ['include', 'src']
 766     defines = [('SWIG_TYPE_TABLE', WXPYTHON_TYPE_TABLE),
 767                ('SWIG_PYTHON_OUTPUT_TUPLE', None),
 768                ('WXP_USE_THREAD', '1'),
 769                ]
 770     if UNDEF_NDEBUG:
 771         defines.append( ('NDEBUG',) )  # using a 1-tuple makes it do an undef
 772
 773     Verify_WX_CONFIG()
 774
 775     libdirs = []
 776     libs = []
 777
 778     # If you get unresolved symbol errors on Solaris and are using gcc, then
 779     # uncomment this block to add the right flags to the link step and build
 780     # again.
 781     ## if os.uname()[0] == 'SunOS':
 782     ##     import commands
 783     ##     libs.append('gcc')
 784     ##     libdirs.append(commands.getoutput("gcc -print-search-dirs | grep '^install' | awk '{print $2}'")[:-1])
 785
 786     cflags = os.popen(WX_CONFIG + ' --cxxflags', 'r').read()[:-1]
 787     cflags = cflags.split()
 788     if debug:
 789         cflags.append('-g')
 790         cflags.append('-O0')
 791     else:
 792         cflags.append('-O3')
 793
 794     lflags = os.popen(WX_CONFIG + ' --libs', 'r').read()[:-1]
 795     lflags = lflags.split()
 796
 797     WXBASENAME = os.popen(WX_CONFIG + ' --basename').read()[:-1]
 798     WXRELEASE  = os.popen(WX_CONFIG + ' --release').read()[:-1]
 799     WXPREFIX   = os.popen(WX_CONFIG + ' --prefix').read()[:-1]
 800
 801
 802     if sys.platform[:6] == "darwin" and WXPORT == 'mac':
 803         # Flags and such for a Darwin (Max OS X) build of Python
 804         WXPLAT = '__WXMAC__'
 805         GENDIR = 'mac'
 806         libs = ['stdc++']
 807         NO_SCRIPTS = 1
 808
 809
 810     else:
 811         # Set flags for other Unix type platforms
 812         GENDIR = WXPORT
 813
 814         if WXPORT == 'gtk':
 815             WXPLAT = '__WXGTK__'
 816             portcfg = os.popen('gtk-config --cflags', 'r').read()[:-1]
 817         elif WXPORT == 'gtk2':
 818             WXPLAT = '__WXGTK__'
 819             GENDIR = 'gtk' # no code differences so use the same generated sources
 820             portcfg = os.popen('pkg-config gtk+-2.0 --cflags', 'r').read()[:-1]
 821             BUILD_BASE = BUILD_BASE + '-' + WXPORT
 822         elif WXPORT == 'x11':
 823             WXPLAT = '__WXX11__'
 824             portcfg = ''
 825             BUILD_BASE = BUILD_BASE + '-' + WXPORT
 826         else:
 827             raise SystemExit, "Unknown WXPORT value: " + WXPORT
 828
 829         cflags += portcfg.split()
 830
 831         # Some distros (e.g. Mandrake) put libGLU in /usr/X11R6/lib, but
 832         # wx-config doesn't output that for some reason.  For now, just
 833         # add it unconditionally but we should really check if the lib is
 834         # really found there or wx-config should be fixed.
 835         libdirs.append("/usr/X11R6/lib")
 836
 837
 838     # Move the various -I, -D, etc. flags we got from the *config scripts
 839     # into the distutils lists.
 840     cflags = adjustCFLAGS(cflags, defines, includes)
 841     lflags = adjustLFLAGS(lflags, libdirs, libs)
 842
 843
 844 #----------------------------------------------------------------------
 845 else:
 846     raise 'Sorry, platform not supported...'
 847
 848
 849 #----------------------------------------------------------------------
 850 # post platform setup checks and tweaks, create the full version string
 851 #----------------------------------------------------------------------
 852
 853 if UNICODE:
 854     BUILD_BASE = BUILD_BASE + '.unicode'
 855     ##VER_FLAGS += 'u'
 856
 857 if os.path.exists('DAILY_BUILD'):
 858
 859     VER_FLAGS += '.' + open('DAILY_BUILD').read().strip()
 860
 861 VERSION = "%s.%s.%s.%s%s" % (VER_MAJOR, VER_MINOR, VER_RELEASE,
 862                              VER_SUBREL, VER_FLAGS)
 863
 864
 865 #----------------------------------------------------------------------
 866 # SWIG defaults
 867 #----------------------------------------------------------------------
 868
 869 # *.i files could live in the wxWidgets/wxPython/src dir, or in
 870 # a subdirectory of the devel package. Let's specify both
 871 # dirs as includes so we don't have to guess which is correct.
 872
 873 wxfilesdir = ""
 874 i_subdir = opj("include", getExtraPath(), "wx", "wxPython", "i_files")
 875 if os.name != "nt":
 876     wxfilesdir = opj(WXPREFIX, i_subdir)
 877 else:
 878     wxfilesdir = opj(WXPY_SRC, i_subdir)
 879
 880 i_files_includes = [ '-I' + opj(WXPY_SRC, 'src'),
 881                      '-I' + wxfilesdir ]
 882
 883 swig_cmd = SWIG
 884 swig_force = force
 885 swig_args = ['-c++',
 886              #'-Wall',
 887              '-python',
 888              '-new_repr',
 889              '-modern',
 890              '-D'+WXPLAT,
 891              ] + i_files_includes
 892
 893 if USE_SWIG:
 894     SVER = swig_version()
 895     if int(SVER[-2:]) >= 29:
 896         swig_args += [ '-fastdispatch',
 897                        '-fvirtual',
 898                        '-fastinit',
 899                        '-fastunpack',
 900                        #'-outputtuple',  Currently setting this with a -D define above
 901                        ]
 902
 903 if UNICODE:
 904     swig_args.append('-DwxUSE_UNICODE')
 905
 906 if FULL_DOCS:
 907     swig_args.append('-D_DO_FULL_DOCS')
 908
 909
 910 swig_deps = [ opj(WXPY_SRC, 'src/my_typemaps.i'),
 911               opj(WXPY_SRC, 'src/pyfragments.swg'),
 912               ]
 913
 914 depends = [ #'include/wx/wxPython/wxPython.h',
 915             #'include/wx/wxPython/wxPython_int.h',
 916             #'src/pyclasses.h',
 917             ]
 918
 919 #----------------------------------------------------------------------
 920
 921 ####################################
 922 # BuildRenamers
 923 ####################################
 924
 925 import pprint, shutil
 926 try:
 927     import libxml2
 928     FOUND_LIBXML2 = True
 929 except ImportError:
 930     FOUND_LIBXML2 = False
 931
 932 #---------------------------------------------------------------------------
 933
 934 renamerTemplateStart = """\
 935 // A bunch of %rename directives generated by BuildRenamers in config.py
 936 // in order to remove the wx prefix from all global scope names.
 937
 938 #ifndef BUILDING_RENAMERS
 939
 940 """
 941
 942 renamerTemplateEnd = """
 943 #endif
 944 """
 945
 946 wxPythonTemplateStart = """\
 947 ## This file reverse renames symbols in the wx package to give
 948 ## them their wx prefix again, for backwards compatibility.
 949 ##
 950 ## Generated by BuildRenamers in config.py
 951
 952 # This silly stuff here is so the wxPython.wx module doesn't conflict
 953 # with the wx package.  We need to import modules from the wx package
 954 # here, then we'll put the wxPython.wx entry back in sys.modules.
 955 import sys
 956 _wx = None
 957 if sys.modules.has_key('wxPython.wx'):
 958     _wx = sys.modules['wxPython.wx']
 959     del sys.modules['wxPython.wx']
 960
 961 import wx.%s
 962
 963 sys.modules['wxPython.wx'] = _wx
 964 del sys, _wx
 965
 966
 967 # Now assign all the reverse-renamed names:
 968 """
 969
 970 wxPythonTemplateEnd = """
 971
 972 """
 973
 974
 975
 976 #---------------------------------------------------------------------------
 977 class BuildRenamers:
 978     def run(self, destdir, modname, xmlfile, wxPythonDir="wxPython"):
 979
 980         assert FOUND_LIBXML2, "The libxml2 module is required to use the BuildRenamers functionality."
 981
 982         if not os.path.exists(wxPythonDir):
 983             os.mkdir(wxPythonDir)
 984
 985         swigDest = os.path.join(destdir, "_"+modname+"_rename.i")
 986         pyDest = os.path.join(wxPythonDir, modname + '.py')
 987
 988         swigDestTemp = tempfile.mktemp('.tmp')
 989         swigFile = open(swigDestTemp, "w")
 990         swigFile.write(renamerTemplateStart)
 991
 992         pyDestTemp = tempfile.mktemp('.tmp')
 993         pyFile = open(pyDestTemp, "w")
 994         pyFile.write(wxPythonTemplateStart % modname)
 995
 996         print "Parsing XML and building renamers..."
 997         self.processXML(xmlfile, modname, swigFile, pyFile)
 998
 999         self.checkOtherNames(pyFile, modname,
1000                         os.path.join(destdir, '_'+modname+'_reverse.txt'))
1001         pyFile.write(wxPythonTemplateEnd)
1002         pyFile.close()
1003
1004         swigFile.write(renamerTemplateEnd)
1005         swigFile.close()
1006
1007         # Compare the files just created with the existing one and
1008         # blow away the old one if they are different.
1009         for dest, temp in [(swigDest, swigDestTemp),
1010                            (pyDest, pyDestTemp)]:
1011             # NOTE: we don't use shutil.move() because it was introduced
1012             # in Python 2.3. Eventually we can switch to it when people
1013             # stop building using 2.2.
1014             if not os.path.exists(dest):
1015                 shutil.copyfile(temp, dest)
1016             elif open(dest).read() != open(temp).read():
1017                 os.unlink(dest)
1018                 shutil.copyfile(temp, dest)
1019             else:
1020                 print dest + " not changed."
1021                 os.unlink(temp)
1022
1023     #---------------------------------------------------------------------------
1024
1025
1026     def GetAttr(self, node, name):
1027         path = "./attributelist/attribute[@name='%s']/@value" % name
1028         n = node.xpathEval2(path)
1029         if len(n):
1030             return n[0].content
1031         else:
1032             return None
1033
1034
1035     def processXML(self, xmlfile, modname, swigFile, pyFile):
1036
1037         topnode = libxml2.parseFile(xmlfile).children
1038
1039         # remove any import nodes as we don't need to do renamers for symbols found therein
1040         imports = topnode.xpathEval2("*/import")
1041         for n in imports:
1042             n.unlinkNode()
1043             n.freeNode()
1044
1045         # do a depth first iteration over what's left
1046         for node in topnode:
1047             doRename = False
1048             addWX = False
1049             revOnly = False
1050
1051
1052             if node.name == "class":
1053                 lastClassName = name = self.GetAttr(node, "name")
1054                 lastClassSymName = sym_name = self.GetAttr(node, "sym_name")
1055                 doRename = True
1056                 if sym_name != name:
1057                     name = sym_name
1058                     addWX = True
1059
1060             # renamed constructors
1061             elif node.name == "constructor":
1062                 name     = self.GetAttr(node, "name")
1063                 sym_name = self.GetAttr(node, "sym_name")
1064                 if sym_name != name:
1065                     name = sym_name
1066                     addWX = True
1067                     doRename = True
1068
1069             # only enumitems at the top level
1070             elif node.name == "enumitem" and node.parent.parent.name == "include":
1071                 name     = self.GetAttr(node, "name")
1072                 sym_name = self.GetAttr(node, "sym_name")
1073                 doRename = True
1074
1075
1076             elif node.name in ["cdecl", "constant"]:
1077                 name      = self.GetAttr(node, "name")
1078                 sym_name  = self.GetAttr(node, "sym_name")
1079                 toplevel  = node.parent.name == "include"
1080
1081                 # top-level functions
1082                 if toplevel and self.GetAttr(node, "view") == "globalfunctionHandler":
1083                     doRename = True
1084
1085                 # top-level global vars
1086                 elif toplevel and self.GetAttr(node, "feature_immutable") == "1":
1087                     doRename = True
1088
1089                 # static methods
1090                 elif self.GetAttr(node, "view") == "staticmemberfunctionHandler":
1091                     name     = lastClassName + '_' + name
1092                     sym_name = lastClassSymName + '_' + sym_name
1093                     # only output the reverse renamer in this case
1094                     doRename = revOnly = True
1095
1096                 if doRename and name != sym_name:
1097                     name = sym_name
1098                     addWX = True
1099
1100
1101             if doRename and name:
1102                 old = new = name
1103                 if old.startswith('wx') and not old.startswith('wxEVT_'):
1104                     # remove all wx prefixes except wxEVT_ and write a %rename directive for it
1105                     new = old[2:]
1106                     if not revOnly:
1107                         swigFile.write("%%rename(%s)  %35s;\n" % (new, old))
1108
1109                 # Write assignments to import into the old wxPython namespace
1110                 if addWX and not old.startswith('wx'):
1111                     old = 'wx'+old
1112                 pyFile.write("%s = wx.%s.%s\n" % (old, modname, new))
1113
1114
1115     #---------------------------------------------------------------------------
1116
1117     def checkOtherNames(self, pyFile, moduleName, filename):
1118         if os.path.exists(filename):
1119             prefixes = []
1120             for line in file(filename):
1121                 if line.endswith('\n'):
1122                     line = line[:-1]
1123                 if line and not line.startswith('#'):
1124                     if line.endswith('*'):
1125                         prefixes.append(line[:-1])
1126                     elif line.find('=') != -1:
1127                         pyFile.write("%s\n" % line)
1128                     else:
1129                         wxname = 'wx' + line
1130                         if line.startswith('wx') or line.startswith('WX') or line.startswith('EVT'):
1131                             wxname = line
1132                         pyFile.write("%s = wx.%s.%s\n" % (wxname, moduleName, line))
1133
1134             if prefixes:
1135                 pyFile.write(
1136                     "\n\nd = globals()\nfor k, v in wx.%s.__dict__.iteritems():"
1137                     % moduleName)
1138                 first = True
1139                 for p in prefixes:
1140                     if first:
1141                         pyFile.write("\n    if ")
1142                         first = False
1143                     else:
1144                         pyFile.write("\n    elif ")
1145                     pyFile.write("k.startswith('%s'):\n        d[k] = v" % p)
1146                 pyFile.write("\ndel d, k, v\n\n")
1147
1148
1149 #---------------------------------------------------------------------------