text: """distutils.cygwinccompiler
  
  Provides the CygwinCCompiler class, a subclass of UnixCCompiler that
  handles the Cygwin port of the GNU C compiler to Windows.  It also contains
  the Mingw32CCompiler class which handles the mingw32 port of GCC (same as
  cygwin in no-cygwin mode).
  """
  
  # problems:
  #
  # * if you use a msvc compiled python version (1.5.2)
  #   1. you have to insert a __GNUC__ section in its config.h
  #   2. you have to generate a import library for its dll
  #      - create a def-file for python??.dll
  #      - create a import library using
  #             dlltool --dllname python15.dll --def python15.def \
  #                       --output-lib libpython15.a
  #
  #   see also http://starship.python.net/crew/kernr/mingw32/Notes.html
  #
  # * We put export_symbols in a def-file, and don't use
  #   --export-all-symbols because it doesn't worked reliable in some
  #   tested configurations. And because other windows compilers also
  #   need their symbols specified this no serious problem.
  #
  # tested configurations:
  #
  # * cygwin gcc 2.91.57/ld 2.9.4/dllwrap 0.2.4 works
  #   (after patching python's config.h and for C++ some other include files)
  #   see also http://starship.python.net/crew/kernr/mingw32/Notes.html
  # * mingw32 gcc 2.95.2/ld 2.9.4/dllwrap 0.2.4 works
  #   (ld doesn't support -shared, so we use dllwrap)
  # * cygwin gcc 2.95.2/ld 2.10.90/dllwrap 2.10.90 works now
  #   - its dllwrap doesn't work, there is a bug in binutils 2.10.90
  #     see also http://sources.redhat.com/ml/cygwin/2000-06/msg01274.html
  #   - using gcc -mdll instead dllwrap doesn't work without -static because
  #     it tries to link against dlls instead their import libraries. (If
  #     it finds the dll first.)
  #     By specifying -static we force ld to link against the import libraries,
  #     this is windows standard and there are normally not the necessary symbols
  #     in the dlls.
  #   *** only the version of June 2000 shows these problems
  # * cygwin gcc 3.2/ld 2.13.90 works
  #   (ld supports -shared)
  # * mingw gcc 3.2/ld 2.13 works
  #   (ld supports -shared)
  
  # This module should be kept compatible with Python 2.1.
  
  __revision__ = "$Id: cygwinccompiler.py 65834 2008-08-18 19:23:47Z amaury.forgeotdarc $"
  
  import os,sys,copy
  from distutils.ccompiler import gen_preprocess_options, gen_lib_options
  from distutils.unixccompiler import UnixCCompiler
  from distutils.file_util import write_file
  from distutils.errors import DistutilsExecError, CompileError, UnknownFileError
  from distutils import log
  
  def get_msvcr():
      """Include the appropriate MSVC runtime library if Python was built
      with MSVC 7.0 or later.
      """
      msc_pos = sys.version.find('MSC v.')
      if msc_pos != -1:
          msc_ver = sys.version[msc_pos+6:msc_pos+10]
          if msc_ver == '1300':
              # MSVC 7.0
              return ['msvcr70']
          elif msc_ver == '1310':
              # MSVC 7.1
              return ['msvcr71']
          elif msc_ver == '1400':
              # VS2005 / MSVC 8.0
              return ['msvcr80']
          elif msc_ver == '1500':
              # VS2008 / MSVC 9.0
              return ['msvcr90']
          else:
              raise ValueError("Unknown MS Compiler version %i " % msc_Ver)
  
  
  class CygwinCCompiler (UnixCCompiler):
  
      compiler_type = 'cygwin'
      obj_extension = ".o"
      static_lib_extension = ".a"
      shared_lib_extension = ".dll"
      static_lib_format = "lib%s%s"
      shared_lib_format = "%s%s"
      exe_extension = ".exe"
  
      def __init__ (self, verbose=0, dry_run=0, force=0):
  
          UnixCCompiler.__init__ (self, verbose, dry_run, force)
  
          (status, details) = check_config_h()
          self.debug_print("Python's GCC status: %s (details: %s)" %
                           (status, details))
          if status is not CONFIG_H_OK:
              self.warn(
                  "Python's pyconfig.h doesn't seem to support your compiler. "
                  "Reason: %s. "
                  "Compiling may fail because of undefined preprocessor macros."
                  % details)
  
          self.gcc_version, self.ld_version, self.dllwrap_version = \
              get_versions()
          self.debug_print(self.compiler_type + ": gcc %s, ld %s, dllwrap %s\n" %
                           (self.gcc_version,
                            self.ld_version,
                            self.dllwrap_version) )
  
          # ld_version >= "2.10.90" and < "2.13" should also be able to use
          # gcc -mdll instead of dllwrap
          # Older dllwraps had own version numbers, newer ones use the
          # same as the rest of binutils ( also ld )
          # dllwrap 2.10.90 is buggy
          if self.ld_version >= "2.10.90":
              self.linker_dll = "gcc"
          else:
              self.linker_dll = "dllwrap"
  
          # ld_version >= "2.13" support -shared so use it instead of
          # -mdll -static
          if self.ld_version >= "2.13":
              shared_option = "-shared"
          else:
              shared_option = "-mdll -static"
  
          # Hard-code GCC because that's what this is all about.
          # XXX optimization, warnings etc. should be customizable.
          self.set_executables(compiler='gcc -mcygwin -O -Wall',
                               compiler_so='gcc -mcygwin -mdll -O -Wall',
                               compiler_cxx='g++ -mcygwin -O -Wall',
                               linker_exe='gcc -mcygwin',
                               linker_so=('%s -mcygwin %s' %
                                          (self.linker_dll, shared_option)))
  
          # cygwin and mingw32 need different sets of libraries
          if self.gcc_version == "2.91.57":
              # cygwin shouldn't need msvcrt, but without the dlls will crash
              # (gcc version 2.91.57) -- perhaps something about initialization
              self.dll_libraries=["msvcrt"]
              self.warn(
                  "Consider upgrading to a newer version of gcc")
          else:
              # Include the appropriate MSVC runtime library if Python was built
              # with MSVC 7.0 or later.
              self.dll_libraries = get_msvcr()
  
      # __init__ ()
  
  
      def _compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts):
          if ext == '.rc' or ext == '.res':
              # gcc needs '.res' and '.rc' compiled to object files !!!
              try:
                  self.spawn(["windres", "-i", src, "-o", obj])
              except DistutilsExecError, msg:
                  raise CompileError, msg
          else: # for other files use the C-compiler
              try:
                  self.spawn(self.compiler_so + cc_args + [src, '-o', obj] +
                             extra_postargs)
              except DistutilsExecError, msg:
                  raise CompileError, msg
  
      def link (self,
                target_desc,
                objects,
                output_filename,
                output_dir=None,
                libraries=None,
                library_dirs=None,
                runtime_library_dirs=None,
                export_symbols=None,
                debug=0,
                extra_preargs=None,
                extra_postargs=None,
                build_temp=None,
                target_lang=None):
  
          # use separate copies, so we can modify the lists
          extra_preargs = copy.copy(extra_preargs or [])
          libraries = copy.copy(libraries or [])
          objects = copy.copy(objects or [])
  
          # Additional libraries
          libraries.extend(self.dll_libraries)
  
          # handle export symbols by creating a def-file
          # with executables this only works with gcc/ld as linker
          if ((export_symbols is not None) and
              (target_desc != self.EXECUTABLE or self.linker_dll == "gcc")):
              # (The linker doesn't do anything if output is up-to-date.
              # So it would probably better to check if we really need this,
              # but for this we had to insert some unchanged parts of
              # UnixCCompiler, and this is not what we want.)
  
              # we want to put some files in the same directory as the
              # object files are, build_temp doesn't help much
              # where are the object files
              temp_dir = os.path.dirname(objects[0])
              # name of dll to give the helper files the same base name
              (dll_name, dll_extension) = os.path.splitext(
                  os.path.basename(output_filename))
  
              # generate the filenames for these files
              def_file = os.path.join(temp_dir, dll_name + ".def")
              lib_file = os.path.join(temp_dir, 'lib' + dll_name + ".a")
  
              # Generate .def file
              contents = [
                  "LIBRARY %s" % os.path.basename(output_filename),
                  "EXPORTS"]
              for sym in export_symbols:
                  contents.append(sym)
              self.execute(write_file, (def_file, contents),
                           "writing %s" % def_file)
  
              # next add options for def-file and to creating import libraries
  
              # dllwrap uses different options than gcc/ld
              if self.linker_dll == "dllwrap":
                  extra_preargs.extend(["--output-lib", lib_file])
                  # for dllwrap we have to use a special option
                  extra_preargs.extend(["--def", def_file])
              # we use gcc/ld here and can be sure ld is >= 2.9.10
              else:
                  # doesn't work: bfd_close build\...\libfoo.a: Invalid operation
                  #extra_preargs.extend(["-Wl,--out-implib,%s" % lib_file])
                  # for gcc/ld the def-file is specified as any object files
                  objects.append(def_file)
  
          #end: if ((export_symbols is not None) and
          #        (target_desc != self.EXECUTABLE or self.linker_dll == "gcc")):
  
          # who wants symbols and a many times larger output file
          # should explicitly switch the debug mode on
          # otherwise we let dllwrap/ld strip the output file
          # (On my machine: 10KB < stripped_file < ??100KB
          #   unstripped_file = stripped_file + XXX KB
          #  ( XXX=254 for a typical python extension))
          if not debug:
              extra_preargs.append("-s")
  
          UnixCCompiler.link(self,
                             target_desc,
                             objects,
                             output_filename,
                             output_dir,
                             libraries,
                             library_dirs,
                             runtime_library_dirs,
                             None, # export_symbols, we do this in our def-file
                             debug,
                             extra_preargs,
                             extra_postargs,
                             build_temp,
                             target_lang)
  
      # link ()
  
      # -- Miscellaneous methods -----------------------------------------
  
      # overwrite the one from CCompiler to support rc and res-files
      def object_filenames (self,
                            source_filenames,
                            strip_dir=0,
                            output_dir=''):
          if output_dir is None: output_dir = ''
          obj_names = []
          for src_name in source_filenames:
              # use normcase to make sure '.rc' is really '.rc' and not '.RC'
              (base, ext) = os.path.splitext (os.path.normcase(src_name))
              if ext not in (self.src_extensions + ['.rc','.res']):
                  raise UnknownFileError, \
                        "unknown file type '%s' (from '%s')" % \
                        (ext, src_name)
              if strip_dir:
                  base = os.path.basename (base)
              if ext == '.res' or ext == '.rc':
                  # these need to be compiled to object files
                  obj_names.append (os.path.join (output_dir,
                                              base + ext + self.obj_extension))
              else:
                  obj_names.append (os.path.join (output_dir,
                                              base + self.obj_extension))
          return obj_names
  
      # object_filenames ()
  
  # class CygwinCCompiler
  
  
  # the same as cygwin plus some additional parameters
  class Mingw32CCompiler (CygwinCCompiler):
  
      compiler_type = 'mingw32'
  
      def __init__ (self,
                    verbose=0,
                    dry_run=0,
                    force=0):
  
          CygwinCCompiler.__init__ (self, verbose, dry_run, force)
  
          # ld_version >= "2.13" support -shared so use it instead of
          # -mdll -static
          if self.ld_version >= "2.13":
              shared_option = "-shared"
          else:
              shared_option = "-mdll -static"
  
          # A real mingw32 doesn't need to specify a different entry point,
          # but cygwin 2.91.57 in no-cygwin-mode needs it.
          if self.gcc_version <= "2.91.57":
              entry_point = '--entry _DllMain@12'
          else:
              entry_point = ''
  
          self.set_executables(compiler='gcc -mno-cygwin -O -Wall',
                               compiler_so='gcc -mno-cygwin -mdll -O -Wall',
                               compiler_cxx='g++ -mno-cygwin -O -Wall',
                               linker_exe='gcc -mno-cygwin',
                               linker_so='%s -mno-cygwin %s %s'
                                          % (self.linker_dll, shared_option,
                                             entry_point))
          # Maybe we should also append -mthreads, but then the finished
          # dlls need another dll (mingwm10.dll see Mingw32 docs)
          # (-mthreads: Support thread-safe exception handling on `Mingw32')
  
          # no additional libraries needed
          self.dll_libraries=[]
  
          # Include the appropriate MSVC runtime library if Python was built
          # with MSVC 7.0 or later.
          self.dll_libraries = get_msvcr()
  
      # __init__ ()
  
  # class Mingw32CCompiler
  
  # Because these compilers aren't configured in Python's pyconfig.h file by
  # default, we should at least warn the user if he is using a unmodified
  # version.
  
  CONFIG_H_OK = "ok"
  CONFIG_H_NOTOK = "not ok"
  CONFIG_H_UNCERTAIN = "uncertain"
  
  def check_config_h():
  
      """Check if the current Python installation (specifically, pyconfig.h)
      appears amenable to building extensions with GCC.  Returns a tuple
      (status, details), where 'status' is one of the following constants:
        CONFIG_H_OK
          all is well, go ahead and compile
        CONFIG_H_NOTOK
          doesn't look good
        CONFIG_H_UNCERTAIN
          not sure -- unable to read pyconfig.h
      'details' is a human-readable string explaining the situation.
  
      Note there are two ways to conclude "OK": either 'sys.version' contains
      the string "GCC" (implying that this Python was built with GCC), or the
      installed "pyconfig.h" contains the string "__GNUC__".
      """
  
      # XXX since this function also checks sys.version, it's not strictly a
      # "pyconfig.h" check -- should probably be renamed...
  
      from distutils import sysconfig
      import string
      # if sys.version contains GCC then python was compiled with
      # GCC, and the pyconfig.h file should be OK
      if string.find(sys.version,"GCC") >= 0:
          return (CONFIG_H_OK, "sys.version mentions 'GCC'")
  
      fn = sysconfig.get_config_h_filename()
      try:
          # It would probably better to read single lines to search.
          # But we do this only once, and it is fast enough
          f = open(fn)
          s = f.read()
          f.close()
  
      except IOError, exc:
          # if we can't read this file, we cannot say it is wrong
          # the compiler will complain later about this file as missing
          return (CONFIG_H_UNCERTAIN,
                  "couldn't read '%s': %s" % (fn, exc.strerror))
  
      else:
          # "pyconfig.h" contains an "#ifdef __GNUC__" or something similar
          if string.find(s,"__GNUC__") >= 0:
              return (CONFIG_H_OK, "'%s' mentions '__GNUC__'" % fn)
          else:
              return (CONFIG_H_NOTOK, "'%s' does not mention '__GNUC__'" % fn)
  
  
  
  def get_versions():
      """ Try to find out the versions of gcc, ld and dllwrap.
          If not possible it returns None for it.
      """
      from distutils.version import LooseVersion
      from distutils.spawn import find_executable
      import re
  
      gcc_exe = find_executable('gcc')
      if gcc_exe:
          out = os.popen(gcc_exe + ' -dumpversion','r')
          out_string = out.read()
          out.close()
          result = re.search('(\d+\.\d+(\.\d+)*)',out_string)
          if result:
              gcc_version = LooseVersion(result.group(1))
          else:
              gcc_version = None
      else:
          gcc_version = None
      ld_exe = find_executable('ld')
      if ld_exe:
          out = os.popen(ld_exe + ' -v','r')
          out_string = out.read()
          out.close()
          result = re.search('(\d+\.\d+(\.\d+)*)',out_string)
          if result:
              ld_version = LooseVersion(result.group(1))
          else:
              ld_version = None
      else:
          ld_version = None
      dllwrap_exe = find_executable('dllwrap')
      if dllwrap_exe:
          out = os.popen(dllwrap_exe + ' --version','r')
          out_string = out.read()
          out.close()
          result = re.search(' (\d+\.\d+(\.\d+)*)',out_string)
          if result:
              dllwrap_version = LooseVersion(result.group(1))
          else:
              dllwrap_version = None
      else:
          dllwrap_version = None
      return (gcc_version, ld_version, dllwrap_version)
  