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       = 1      # 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                'VER_FLAGS',
 276                ]:
 277     for x in range(len(sys.argv)):
 278         if sys.argv[x].find(option) == 0:
 279             pos = sys.argv[x].find('=') + 1
 280             if pos > 0:
 281                 vars()[option] = sys.argv[x][pos:]
 282                 sys.argv[x] = ''
 283
 284 sys.argv = filter(None, sys.argv)
 285
 286
 287 #----------------------------------------------------------------------
 288 # some helper functions
 289 #----------------------------------------------------------------------
 290
 291 def Verify_WX_CONFIG():
 292     """ Called below for the builds that need wx-config, if WX_CONFIG
 293         is not set then determines the flags needed based on build
 294         options and searches for wx-config on the PATH.
 295     """
 296     # if WX_CONFIG hasn't been set to an explicit value then construct one.
 297     global WX_CONFIG
 298     if WX_CONFIG is None:
 299         WX_CONFIG='wx-config'
 300         port = WXPORT
 301         if port == "x11":
 302             port = "x11univ"
 303         flags =  ' --toolkit=%s' % port
 304         flags += ' --unicode=%s' % (UNICODE and 'yes' or 'no')
 305         flags += ' --version=%s.%s' % (VER_MAJOR, VER_MINOR)
 306
 307         searchpath = os.environ["PATH"]
 308         for p in searchpath.split(':'):
 309             fp = os.path.join(p, 'wx-config')
 310             if os.path.exists(fp) and os.access(fp, os.X_OK):
 311                 # success
 312                 msg("Found wx-config: " + fp)
 313                 msg("    Using flags: " + flags)
 314                 WX_CONFIG = fp + flags
 315                 if hasattr(sys, 'setup_is_main') and not sys.setup_is_main:
 316                     WX_CONFIG += " 2>/dev/null "
 317                 break
 318         else:
 319             msg("ERROR: WX_CONFIG not specified and wx-config not found on the $PATH")
 320             # should we exit?
 321
 322         # TODO:  execute WX_CONFIG --list and verify a matching config is found
 323
 324
 325 def run_swig(files, dir, gendir, package, USE_SWIG, force, swig_args,
 326              swig_deps=[], add_under=False):
 327     """Run SWIG the way I want it done"""
 328
 329     if USE_SWIG and not os.path.exists(os.path.join(dir, gendir)):
 330         os.mkdir(os.path.join(dir, gendir))
 331
 332     sources = []
 333
 334     if add_under:  pre = '_'
 335     else:          pre = ''
 336
 337     for file in files:
 338         basefile = os.path.splitext(file)[0]
 339         i_file   = os.path.join(dir, file)
 340         py_file  = os.path.join(dir, gendir, pre+basefile+'.py')
 341         cpp_file = os.path.join(dir, gendir, pre+basefile+'_wrap.cpp')
 342
 343         if add_under:
 344             interface = ['-interface', '_'+basefile+'_']
 345         else:
 346             interface = []
 347
 348         sources.append(cpp_file)
 349
 350         if not cleaning and USE_SWIG:
 351             for dep in swig_deps:
 352                 # this may fail for external builds, but it's not
 353                 # a fatal error, so keep going.
 354                 try:
 355                     if newer(dep, py_file) or newer(dep, cpp_file):
 356                         force = 1
 357                         break
 358                 except:
 359                     pass
 360
 361             if force or newer(i_file, py_file) or newer(i_file, cpp_file):
 362                 ## we need forward slashes here, even on win32
 363                 #cpp_file = opj(cpp_file) #'/'.join(cpp_file.split('\\'))
 364                 #i_file = opj(i_file)     #'/'.join(i_file.split('\\'))
 365
 366                 if BUILD_RENAMERS:
 367                     xmltemp = tempfile.mktemp('.xml')
 368
 369                     # First run swig to produce the XML file, adding
 370                     # an extra -D that prevents the old rename
 371                     # directives from being used
 372                     cmd = [ swig_cmd ] + swig_args + \
 373                           [ '-DBUILDING_RENAMERS', '-xmlout', xmltemp ] + \
 374                           ['-I'+dir, '-o', cpp_file, i_file]
 375                     msg(' '.join(cmd))
 376                     spawn(cmd)
 377
 378                     # Next run build_renamers to process the XML
 379                     myRenamer = BuildRenamers()
 380                     myRenamer.run(dir, pre+basefile, xmltemp)
 381                     os.remove(xmltemp)
 382
 383                 # Then run swig for real
 384                 cmd = [ swig_cmd ] + swig_args + interface + \
 385                       ['-I'+dir, '-o', cpp_file, i_file]
 386                 msg(' '.join(cmd))
 387                 spawn(cmd)
 388
 389
 390         # copy the generated python file to the package directory
 391         copy_file(py_file, package, update=not force, verbose=0)
 392         CLEANUP.append(opj(package, os.path.basename(py_file)))
 393
 394     return sources
 395
 396
 397 def swig_version():
 398     # It may come on either stdout or stderr, depending on the
 399     # version, so read both.
 400     i, o, e = os.popen3(SWIG + ' -version', 't')
 401     stext = o.read() + e.read()
 402     import re
 403     match = re.search(r'[0-9]+\.[0-9]+\.[0-9]+$', stext, re.MULTILINE)
 404     if not match:
 405         raise 'NotFound'
 406     SVER = match.group(0)
 407     return SVER
 408
 409
 410 # Specializations of some distutils command classes
 411 class wx_smart_install_data(distutils.command.install_data.install_data):
 412     """need to change self.install_dir to the actual library dir"""
 413     def run(self):
 414         install_cmd = self.get_finalized_command('install')
 415         self.install_dir = getattr(install_cmd, 'install_lib')
 416         return distutils.command.install_data.install_data.run(self)
 417
 418
 419 class wx_extra_clean(distutils.command.clean.clean):
 420     """
 421     Also cleans stuff that this setup.py copies itself.  If the
 422     --all flag was used also searches for .pyc, .pyd, .so files
 423     """
 424     def run(self):
 425         from distutils import log
 426         from distutils.filelist import FileList
 427         global CLEANUP
 428
 429         distutils.command.clean.clean.run(self)
 430
 431         if self.all:
 432             fl = FileList()
 433             fl.include_pattern("*.pyc", 0)
 434             fl.include_pattern("*.pyd", 0)
 435             fl.include_pattern("*.so", 0)
 436             CLEANUP += fl.files
 437
 438         for f in CLEANUP:
 439             if os.path.isdir(f):
 440                 try:
 441                     if not self.dry_run and os.path.exists(f):
 442                         os.rmdir(f)
 443                     log.info("removing '%s'", f)
 444                 except IOError:
 445                     log.warning("unable to remove '%s'", f)
 446
 447             else:
 448                 try:
 449                     if not self.dry_run and os.path.exists(f):
 450                         os.remove(f)
 451                     log.info("removing '%s'", f)
 452                 except IOError:
 453                     log.warning("unable to remove '%s'", f)
 454
 455
 456
 457 class wx_install(distutils.command.install.install):
 458     """
 459     Turns off install_path_file
 460     """
 461     def initialize_options(self):
 462         distutils.command.install.install.initialize_options(self)
 463         self.install_path_file = 0
 464
 465
 466 class wx_install_headers(distutils.command.install_headers.install_headers):
 467     """
 468     Install the header files to the WXPREFIX, with an extra dir per
 469     filename too
 470     """
 471     def initialize_options(self):
 472         self.root = None
 473         distutils.command.install_headers.install_headers.initialize_options(self)
 474
 475     def finalize_options(self):
 476         self.set_undefined_options('install', ('root', 'root'))
 477         distutils.command.install_headers.install_headers.finalize_options(self)
 478
 479     def run(self):
 480         if os.name == 'nt':
 481             return
 482         headers = self.distribution.headers
 483         if not headers:
 484             return
 485
 486         root = self.root
 487         if root is None or WXPREFIX.startswith(root):
 488             root = ''
 489         for header, location in headers:
 490             install_dir = os.path.normpath(root +
 491                                            WXPREFIX +
 492                                            '/include/wx-%d.%d/wx' % (VER_MAJOR, VER_MINOR) +
 493                                            location)
 494             self.mkpath(install_dir)
 495             (out, _) = self.copy_file(header, install_dir)
 496             self.outfiles.append(out)
 497
 498
 499
 500
 501 def build_locale_dir(destdir, verbose=1):
 502     """Build a locale dir under the wxPython package for MSW"""
 503     moFiles = glob.glob(opj(WXDIR, 'locale', '*.mo'))
 504     for src in moFiles:
 505         lang = os.path.splitext(os.path.basename(src))[0]
 506         dest = opj(destdir, lang)
 507         mkpath(dest, verbose=verbose)
 508         copy_file(src, opj(dest, 'wxstd.mo'), update=1, verbose=verbose)
 509         CLEANUP.append(opj(dest, 'wxstd.mo'))
 510         CLEANUP.append(dest)
 511
 512
 513 def build_locale_list(srcdir):
 514     # get a list of all files under the srcdir, to be used for install_data
 515     def walk_helper(lst, dirname, files):
 516         for f in files:
 517             filename = opj(dirname, f)
 518             if not os.path.isdir(filename):
 519                 lst.append( (dirname, [filename]) )
 520     file_list = []
 521     os.path.walk(srcdir, walk_helper, file_list)
 522     return file_list
 523
 524
 525 def find_data_files(srcdir, *wildcards):
 526     # get a list of all files under the srcdir matching wildcards,
 527     # returned in a format to be used for install_data
 528
 529     def walk_helper(arg, dirname, files):
 530         names = []
 531         lst, wildcards = arg
 532         for wc in wildcards:
 533             for f in files:
 534                 filename = opj(dirname, f)
 535                 if fnmatch.fnmatch(filename, wc) and not os.path.isdir(filename):
 536                     names.append(filename)
 537         if names:
 538             lst.append( (dirname, names ) )
 539
 540     file_list = []
 541     os.path.walk(srcdir, walk_helper, (file_list, wildcards))
 542     return file_list
 543
 544
 545 def makeLibName(name):
 546     if os.name == 'posix':
 547         libname = '%s_%s-%s' % (WXBASENAME, name, WXRELEASE)
 548     elif name:
 549         libname = 'wxmsw%s%s_%s' % (WXDLLVER, libFlag(), name)
 550     else:
 551         libname = 'wxmsw%s%s' % (WXDLLVER, libFlag())
 552     return [libname]
 553
 554
 555
 556 def adjustCFLAGS(cflags, defines, includes):
 557     '''Extract the raw -I, -D, and -U flags and put them into
 558        defines and includes as needed.'''
 559     newCFLAGS = []
 560     for flag in cflags:
 561         if flag[:2] == '-I':
 562             includes.append(flag[2:])
 563         elif flag[:2] == '-D':
 564             flag = flag[2:]
 565             if flag.find('=') == -1:
 566                 defines.append( (flag, None) )
 567             else:
 568                 defines.append( tuple(flag.split('=')) )
 569         elif flag[:2] == '-U':
 570             defines.append( (flag[2:], ) )
 571         else:
 572             newCFLAGS.append(flag)
 573     return newCFLAGS
 574
 575
 576
 577 def adjustLFLAGS(lflags, libdirs, libs):
 578     '''Extract the -L and -l flags and put them in libdirs and libs as needed'''
 579     newLFLAGS = []
 580     for flag in lflags:
 581         if flag[:2] == '-L':
 582             libdirs.append(flag[2:])
 583         elif flag[:2] == '-l':
 584             libs.append(flag[2:])
 585         else:
 586             newLFLAGS.append(flag)
 587
 588     # remove any flags for universal binaries, we'll get those from
 589     # distutils instead
 590     return [flag for flag in newLFLAGS
 591             if flag not in ['-isysroot', '-arch', 'ppc', 'i386'] and
 592             not flag.startswith('/Developer') ]
 593
 594
 595
 596 def getExtraPath(shortVer=True, addOpts=False):
 597     """Get the dirname that wxPython will be installed under."""
 598
 599     if shortVer:
 600         # short version, just Major.Minor
 601         ep = "wx-%d.%d" % (VER_MAJOR, VER_MINOR)
 602
 603         # plus release if minor is odd
 604         if VER_MINOR % 2 == 1:
 605             ep += ".%d" % VER_RELEASE
 606
 607     else:
 608         # long version, full version
 609         ep = "wx-%d.%d.%d.%d" % (VER_MAJOR, VER_MINOR, VER_RELEASE, VER_SUBREL)
 610
 611     if addOpts:
 612         port = WXPORT
 613         if port == "msw": port = "win32"
 614         ep += "-%s-%s" % (WXPORT, (UNICODE and 'unicode' or 'ansi'))
 615
 616     if FLAVOUR:
 617         ep += "-" + FLAVOUR
 618
 619     return ep
 620
 621 #----------------------------------------------------------------------
 622 # sanity checks
 623
 624 if CORE_ONLY:
 625     BUILD_GLCANVAS = 0
 626     BUILD_OGL = 0
 627     BUILD_STC = 0
 628     BUILD_GIZMOS = 0
 629     BUILD_DLLWIDGET = 0
 630     BUILD_ACTIVEX = 0
 631     BUILD_ANIMATE = 0
 632
 633 if debug:
 634     FINAL  = 0
 635     HYBRID = 0
 636
 637 if FINAL:
 638     HYBRID = 0
 639
 640 if UNICODE and WXPORT not in ['msw', 'gtk2', 'mac']:
 641     raise SystemExit, "UNICODE mode not currently supported on this WXPORT: "+WXPORT
 642
 643
 644 if CONTRIBS_INC:
 645     CONTRIBS_INC = [ CONTRIBS_INC ]
 646 else:
 647     CONTRIBS_INC = []
 648
 649
 650 #----------------------------------------------------------------------
 651 # Setup some platform specific stuff
 652 #----------------------------------------------------------------------
 653
 654 if os.name == 'nt':
 655     # Set compile flags and such for MSVC.  These values are derived
 656     # from the wxWidgets makefiles for MSVC, other compilers settings
 657     # will probably vary...
 658     if os.environ.has_key('WXWIN'):
 659         WXDIR = os.environ['WXWIN']
 660     else:
 661         msg("WARNING: WXWIN not set in environment.")
 662         WXDIR = '..'  # assumes in CVS tree
 663     WXPLAT = '__WXMSW__'
 664     GENDIR = 'msw'
 665
 666     includes = ['include', 'src',
 667                 opj(WXDIR, 'lib', 'vc_dll', 'msw'  + libFlag()),
 668                 opj(WXDIR, 'include'),
 669                 opj(WXDIR, 'contrib', 'include'),
 670                 ]
 671
 672     defines = [ ('WIN32', None),
 673                 ('_WINDOWS', None),
 674
 675                 (WXPLAT, None),
 676                 ('WXUSINGDLL', '1'),
 677
 678                 ('SWIG_TYPE_TABLE', WXPYTHON_TYPE_TABLE),
 679                 ('SWIG_PYTHON_OUTPUT_TUPLE', None),
 680                 ('WXP_USE_THREAD', '1'),
 681                 ]
 682
 683     if UNDEF_NDEBUG:
 684         defines.append( ('NDEBUG',) )  # using a 1-tuple makes it do an undef
 685
 686     if HYBRID:
 687         defines.append( ('__NO_VC_CRTDBG__', None) )
 688
 689     if not FINAL or HYBRID:
 690         defines.append( ('__WXDEBUG__', None) )
 691
 692     if UNICODE:
 693         defines.append( ('wxUSE_UNICODE', 1) )
 694
 695     libdirs = [ opj(WXDIR, 'lib', 'vc_dll') ]
 696     if MONOLITHIC:
 697         libs = makeLibName('')
 698     else:
 699         libs = [ 'wxbase' + WXDLLVER + libFlag(),
 700                  'wxbase' + WXDLLVER + libFlag() + '_net',
 701                  'wxbase' + WXDLLVER + libFlag() + '_xml',
 702                  makeLibName('core')[0],
 703                  makeLibName('adv')[0],
 704                  makeLibName('html')[0],
 705                  ]
 706
 707     libs = libs + ['kernel32', 'user32', 'gdi32', 'comdlg32',
 708             'winspool', 'winmm', 'shell32', 'oldnames', 'comctl32',
 709             'odbc32', 'ole32', 'oleaut32', 'uuid', 'rpcrt4',
 710             'advapi32', 'wsock32']
 711
 712
 713     cflags = [ '/Gy',
 714              # '/GX-'  # workaround for internal compiler error in MSVC on some machines
 715              ]
 716     lflags = None
 717
 718     # Other MSVC flags...
 719     # Too bad I don't remember why I was playing with these, can they be removed?
 720     if FINAL:
 721         pass #cflags = cflags + ['/O1']
 722     elif HYBRID :
 723         pass #cflags = cflags + ['/Ox']
 724     else:
 725         pass # cflags = cflags + ['/Od', '/Z7']
 726              # lflags = ['/DEBUG', ]
 727
 728
 729
 730 #----------------------------------------------------------------------
 731
 732 elif os.name == 'posix':
 733     WXDIR = '..'
 734     includes = ['include', 'src']
 735     defines = [('SWIG_TYPE_TABLE', WXPYTHON_TYPE_TABLE),
 736                ('SWIG_PYTHON_OUTPUT_TUPLE', None),
 737                ('WXP_USE_THREAD', '1'),
 738                ]
 739     if UNDEF_NDEBUG:
 740         defines.append( ('NDEBUG',) )  # using a 1-tuple makes it do an undef
 741
 742     Verify_WX_CONFIG()
 743
 744     libdirs = []
 745     libs = []
 746
 747     # If you get unresolved symbol errors on Solaris and are using gcc, then
 748     # uncomment this block to add the right flags to the link step and build
 749     # again.
 750     ## if os.uname()[0] == 'SunOS':
 751     ##     import commands
 752     ##     libs.append('gcc')
 753     ##     libdirs.append(commands.getoutput("gcc -print-search-dirs | grep '^install' | awk '{print $2}'")[:-1])
 754
 755     cflags = os.popen(WX_CONFIG + ' --cxxflags', 'r').read()[:-1]
 756     cflags = cflags.split()
 757     if debug:
 758         cflags.append('-g')
 759         cflags.append('-O0')
 760     else:
 761         cflags.append('-O3')
 762
 763     lflags = os.popen(WX_CONFIG + ' --libs', 'r').read()[:-1]
 764     MONOLITHIC = (lflags.find("_xrc") == -1)
 765     lflags = lflags.split()
 766
 767     WXBASENAME = os.popen(WX_CONFIG + ' --basename').read()[:-1]
 768     WXRELEASE  = os.popen(WX_CONFIG + ' --release').read()[:-1]
 769     WXPREFIX   = os.popen(WX_CONFIG + ' --prefix').read()[:-1]
 770
 771
 772     if sys.platform[:6] == "darwin" and WXPORT == 'mac':
 773         # Flags and such for a Darwin (Max OS X) build of Python
 774         WXPLAT = '__WXMAC__'
 775         GENDIR = 'mac'
 776         libs = ['stdc++']
 777         NO_SCRIPTS = 1
 778
 779
 780     else:
 781         # Set flags for other Unix type platforms
 782         GENDIR = WXPORT
 783
 784         if WXPORT == 'gtk':
 785             WXPLAT = '__WXGTK__'
 786             portcfg = os.popen('gtk-config --cflags', 'r').read()[:-1]
 787         elif WXPORT == 'gtk2':
 788             WXPLAT = '__WXGTK__'
 789             GENDIR = 'gtk' # no code differences so use the same generated sources
 790             portcfg = os.popen('pkg-config gtk+-2.0 --cflags', 'r').read()[:-1]
 791             BUILD_BASE = BUILD_BASE + '-' + WXPORT
 792         elif WXPORT == 'x11':
 793             WXPLAT = '__WXX11__'
 794             portcfg = ''
 795             BUILD_BASE = BUILD_BASE + '-' + WXPORT
 796         else:
 797             raise SystemExit, "Unknown WXPORT value: " + WXPORT
 798
 799         cflags += portcfg.split()
 800
 801         # Some distros (e.g. Mandrake) put libGLU in /usr/X11R6/lib, but
 802         # wx-config doesn't output that for some reason.  For now, just
 803         # add it unconditionally but we should really check if the lib is
 804         # really found there or wx-config should be fixed.
 805         libdirs.append("/usr/X11R6/lib")
 806
 807
 808     # Move the various -I, -D, etc. flags we got from the *config scripts
 809     # into the distutils lists.
 810     cflags = adjustCFLAGS(cflags, defines, includes)
 811     lflags = adjustLFLAGS(lflags, libdirs, libs)
 812
 813
 814 #----------------------------------------------------------------------
 815 else:
 816     raise 'Sorry, platform not supported...'
 817
 818
 819 #----------------------------------------------------------------------
 820 # build options file
 821 #----------------------------------------------------------------------
 822
 823 if SYS_WX_CONFIG is None:
 824     SYS_WX_CONFIG = WX_CONFIG
 825
 826 build_options_template = """
 827 UNICODE=%d
 828 UNDEF_NDEBUG=%d
 829 INSTALL_MULTIVERSION=%d
 830 FLAVOUR="%s"
 831 EP_ADD_OPTS=%d
 832 EP_FULL_VER=%d
 833 WX_CONFIG="%s"
 834 WXPORT="%s"
 835 MONOLITHIC=%d
 836 FINAL=%d
 837 HYBRID=%d
 838 """ % (UNICODE, UNDEF_NDEBUG, INSTALL_MULTIVERSION, FLAVOUR, EP_ADD_OPTS,
 839        EP_FULL_VER, SYS_WX_CONFIG, WXPORT, MONOLITHIC, FINAL, HYBRID)
 840
 841 try:
 842     from build_options import *
 843 except:
 844     build_options_file = os.path.join(os.path.dirname(__file__), "build_options.py")
 845     if not os.path.exists(build_options_file):
 846         try:
 847             myfile = open(build_options_file, "w")
 848             myfile.write(build_options_template)
 849             myfile.close()
 850         except:
 851             print "WARNING: Unable to create build_options.py."
 852
 853
 854 #----------------------------------------------------------------------
 855 # post platform setup checks and tweaks, create the full version string
 856 #----------------------------------------------------------------------
 857
 858 if UNICODE:
 859     BUILD_BASE = BUILD_BASE + '.unicode'
 860     ##VER_FLAGS += 'u'
 861
 862 if os.path.exists('DAILY_BUILD'):
 863
 864     VER_FLAGS += '.' + open('DAILY_BUILD').read().strip()
 865
 866 VERSION = "%s.%s.%s.%s%s" % (VER_MAJOR, VER_MINOR, VER_RELEASE,
 867                              VER_SUBREL, VER_FLAGS)
 868
 869
 870 #----------------------------------------------------------------------
 871 # SWIG defaults
 872 #----------------------------------------------------------------------
 873
 874 # *.i files could live in the wxWidgets/wxPython/src dir, or in
 875 # a subdirectory of the devel package. Let's specify both
 876 # dirs as includes so we don't have to guess which is correct.
 877
 878 wxfilesdir = ""
 879 i_subdir = opj("include", getExtraPath(), "wx", "wxPython", "i_files")
 880 if os.name != "nt":
 881     wxfilesdir = opj(WXPREFIX, i_subdir)
 882 else:
 883     wxfilesdir = opj(WXPY_SRC, i_subdir)
 884
 885 i_files_includes = [ '-I' + opj(WXPY_SRC, 'src'),
 886                      '-I' + wxfilesdir ]
 887
 888 swig_cmd = SWIG
 889 swig_force = force
 890 swig_args = ['-c++',
 891              #'-Wall',
 892              '-python',
 893              '-new_repr',
 894              '-modern',
 895              '-D'+WXPLAT,
 896              ] + i_files_includes
 897
 898 if USE_SWIG:
 899     SVER = swig_version()
 900     if int(SVER[-2:]) >= 29:
 901         swig_args += [ '-fastdispatch',
 902                        '-fvirtual',
 903                        '-fastinit',
 904                        '-fastunpack',
 905                        #'-outputtuple',  Currently setting this with a -D define above
 906                        ]
 907
 908 if UNICODE:
 909     swig_args.append('-DwxUSE_UNICODE')
 910
 911 if FULL_DOCS:
 912     swig_args.append('-D_DO_FULL_DOCS')
 913
 914
 915 swig_deps = [ opj(WXPY_SRC, 'src/my_typemaps.i'),
 916               opj(WXPY_SRC, 'src/pyfragments.swg'),
 917               ]
 918
 919 depends = [ #'include/wx/wxPython/wxPython.h',
 920             #'include/wx/wxPython/wxPython_int.h',
 921             #'src/pyclasses.h',
 922             ]
 923
 924 #----------------------------------------------------------------------
 925
 926 ####################################
 927 # BuildRenamers
 928 ####################################
 929
 930 import pprint, shutil
 931 try:
 932     import libxml2
 933     FOUND_LIBXML2 = True
 934 except ImportError:
 935     FOUND_LIBXML2 = False
 936
 937 #---------------------------------------------------------------------------
 938
 939 renamerTemplateStart = """\
 940 // A bunch of %rename directives generated by BuildRenamers in config.py
 941 // in order to remove the wx prefix from all global scope names.
 942
 943 #ifndef BUILDING_RENAMERS
 944
 945 """
 946
 947 renamerTemplateEnd = """
 948 #endif
 949 """
 950
 951 wxPythonTemplateStart = """\
 952 ## This file reverse renames symbols in the wx package to give
 953 ## them their wx prefix again, for backwards compatibility.
 954 ##
 955 ## Generated by BuildRenamers in config.py
 956
 957 # This silly stuff here is so the wxPython.wx module doesn't conflict
 958 # with the wx package.  We need to import modules from the wx package
 959 # here, then we'll put the wxPython.wx entry back in sys.modules.
 960 import sys
 961 _wx = None
 962 if sys.modules.has_key('wxPython.wx'):
 963     _wx = sys.modules['wxPython.wx']
 964     del sys.modules['wxPython.wx']
 965
 966 import wx.%s
 967
 968 sys.modules['wxPython.wx'] = _wx
 969 del sys, _wx
 970
 971
 972 # Now assign all the reverse-renamed names:
 973 """
 974
 975 wxPythonTemplateEnd = """
 976
 977 """
 978
 979
 980
 981 #---------------------------------------------------------------------------
 982 class BuildRenamers:
 983     def run(self, destdir, modname, xmlfile, wxPythonDir="wxPython"):
 984
 985         assert FOUND_LIBXML2, "The libxml2 module is required to use the BuildRenamers functionality."
 986
 987         if not os.path.exists(wxPythonDir):
 988             os.mkdir(wxPythonDir)
 989
 990         swigDest = os.path.join(destdir, "_"+modname+"_rename.i")
 991         pyDest = os.path.join(wxPythonDir, modname + '.py')
 992
 993         swigDestTemp = tempfile.mktemp('.tmp')
 994         swigFile = open(swigDestTemp, "w")
 995         swigFile.write(renamerTemplateStart)
 996
 997         pyDestTemp = tempfile.mktemp('.tmp')
 998         pyFile = open(pyDestTemp, "w")
 999         pyFile.write(wxPythonTemplateStart % modname)
1000
1001         print "Parsing XML and building renamers..."
1002         self.processXML(xmlfile, modname, swigFile, pyFile)
1003
1004         self.checkOtherNames(pyFile, modname,
1005                         os.path.join(destdir, '_'+modname+'_reverse.txt'))
1006         pyFile.write(wxPythonTemplateEnd)
1007         pyFile.close()
1008
1009         swigFile.write(renamerTemplateEnd)
1010         swigFile.close()
1011
1012         # Compare the files just created with the existing one and
1013         # blow away the old one if they are different.
1014         for dest, temp in [(swigDest, swigDestTemp),
1015                            (pyDest, pyDestTemp)]:
1016             # NOTE: we don't use shutil.move() because it was introduced
1017             # in Python 2.3. Eventually we can switch to it when people
1018             # stop building using 2.2.
1019             if not os.path.exists(dest):
1020                 shutil.copyfile(temp, dest)
1021             elif open(dest).read() != open(temp).read():
1022                 os.unlink(dest)
1023                 shutil.copyfile(temp, dest)
1024             else:
1025                 print dest + " not changed."
1026                 os.unlink(temp)
1027
1028     #---------------------------------------------------------------------------
1029
1030
1031     def GetAttr(self, node, name):
1032         path = "./attributelist/attribute[@name='%s']/@value" % name
1033         n = node.xpathEval2(path)
1034         if len(n):
1035             return n[0].content
1036         else:
1037             return None
1038
1039
1040     def processXML(self, xmlfile, modname, swigFile, pyFile):
1041
1042         topnode = libxml2.parseFile(xmlfile).children
1043
1044         # remove any import nodes as we don't need to do renamers for symbols found therein
1045         imports = topnode.xpathEval2("*/import")
1046         for n in imports:
1047             n.unlinkNode()
1048             n.freeNode()
1049
1050         # do a depth first iteration over what's left
1051         for node in topnode:
1052             doRename = False
1053             addWX = False
1054             revOnly = False
1055
1056
1057             if node.name == "class":
1058                 lastClassName = name = self.GetAttr(node, "name")
1059                 lastClassSymName = sym_name = self.GetAttr(node, "sym_name")
1060                 doRename = True
1061                 if sym_name != name:
1062                     name = sym_name
1063                     addWX = True
1064
1065             # renamed constructors
1066             elif node.name == "constructor":
1067                 name     = self.GetAttr(node, "name")
1068                 sym_name = self.GetAttr(node, "sym_name")
1069                 if sym_name != name:
1070                     name = sym_name
1071                     addWX = True
1072                     doRename = True
1073
1074             # only enumitems at the top level
1075             elif node.name == "enumitem" and node.parent.parent.name == "include":
1076                 name     = self.GetAttr(node, "name")
1077                 sym_name = self.GetAttr(node, "sym_name")
1078                 doRename = True
1079
1080
1081             elif node.name in ["cdecl", "constant"]:
1082                 name      = self.GetAttr(node, "name")
1083                 sym_name  = self.GetAttr(node, "sym_name")
1084                 toplevel  = node.parent.name == "include"
1085
1086                 # top-level functions
1087                 if toplevel and self.GetAttr(node, "view") == "globalfunctionHandler":
1088                     doRename = True
1089
1090                 # top-level global vars
1091                 elif toplevel and self.GetAttr(node, "feature_immutable") == "1":
1092                     doRename = True
1093
1094                 # static methods
1095                 elif self.GetAttr(node, "view") == "staticmemberfunctionHandler":
1096                     name     = lastClassName + '_' + name
1097                     sym_name = lastClassSymName + '_' + sym_name
1098                     # only output the reverse renamer in this case
1099                     doRename = revOnly = True
1100
1101                 if doRename and name != sym_name:
1102                     name = sym_name
1103                     addWX = True
1104
1105
1106             if doRename and name:
1107                 old = new = name
1108                 if old.startswith('wx') and not old.startswith('wxEVT_'):
1109                     # remove all wx prefixes except wxEVT_ and write a %rename directive for it
1110                     new = old[2:]
1111                     if not revOnly:
1112                         swigFile.write("%%rename(%s)  %35s;\n" % (new, old))
1113
1114                 # Write assignments to import into the old wxPython namespace
1115                 if addWX and not old.startswith('wx'):
1116                     old = 'wx'+old
1117                 pyFile.write("%s = wx.%s.%s\n" % (old, modname, new))
1118
1119
1120     #---------------------------------------------------------------------------
1121
1122     def checkOtherNames(self, pyFile, moduleName, filename):
1123         if os.path.exists(filename):
1124             prefixes = []
1125             for line in file(filename):
1126                 if line.endswith('\n'):
1127                     line = line[:-1]
1128                 if line and not line.startswith('#'):
1129                     if line.endswith('*'):
1130                         prefixes.append(line[:-1])
1131                     elif line.find('=') != -1:
1132                         pyFile.write("%s\n" % line)
1133                     else:
1134                         wxname = 'wx' + line
1135                         if line.startswith('wx') or line.startswith('WX') or line.startswith('EVT'):
1136                             wxname = line
1137                         pyFile.write("%s = wx.%s.%s\n" % (wxname, moduleName, line))
1138
1139             if prefixes:
1140                 pyFile.write(
1141                     "\n\nd = globals()\nfor k, v in wx.%s.__dict__.iteritems():"
1142                     % moduleName)
1143                 first = True
1144                 for p in prefixes:
1145                     if first:
1146                         pyFile.write("\n    if ")
1147                         first = False
1148                     else:
1149                         pyFile.write("\n    elif ")
1150                     pyFile.write("k.startswith('%s'):\n        d[k] = v" % p)
1151                 pyFile.write("\ndel d, k, v\n\n")
1152
1153
1154 #---------------------------------------------------------------------------