Package distutils :: Module cygwinccompiler :: Class CygwinCCompiler
[hide private]
[frames] | no frames]

_ClassType CygwinCCompiler

    ccompiler.CCompiler --+    
                          |    
unixccompiler.UnixCCompiler --+
                              |
                             CygwinCCompiler
Known Subclasses:

Instance Methods [hide private]
 
__init__(self, verbose=0, dry_run=0, force=0)
 
_compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts)
Compile 'src' to product 'obj'.
 
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)
Link a bunch of stuff together to create an executable or shared library file.
 
object_filenames(self, source_filenames, strip_dir=0, output_dir='')

Inherited from unixccompiler.UnixCCompiler: create_static_lib, find_library_file, library_dir_option, library_option, preprocess, runtime_library_dir_option

Inherited from ccompiler.CCompiler: add_include_dir, add_library, add_library_dir, add_link_object, add_runtime_library_dir, announce, compile, debug_print, define_macro, detect_language, executable_filename, execute, has_function, library_filename, link_executable, link_shared_lib, link_shared_object, mkpath, move_file, set_executable, set_executables, set_include_dirs, set_libraries, set_library_dirs, set_link_objects, set_runtime_library_dirs, shared_object_filename, spawn, undefine_macro, warn

Class Variables [hide private]
  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'

Inherited from unixccompiler.UnixCCompiler: dylib_lib_extension, dylib_lib_format, executables, src_extensions

Inherited from ccompiler.CCompiler: EXECUTABLE, SHARED_LIBRARY, SHARED_OBJECT, language_map, language_order

Method Details [hide private]

__init__(self, verbose=0, dry_run=0, force=0)
(Constructor)

 
Overrides: ccompiler.CCompiler.__init__

_compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts)

 

Compile 'src' to product 'obj'.

Overrides: ccompiler.CCompiler._compile
(inherited documentation)

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)

 

Link a bunch of stuff together to create an executable or shared library file.

The "bunch of stuff" consists of the list of object files supplied as 'objects'. 'output_filename' should be a filename. If 'output_dir' is supplied, 'output_filename' is relative to it (i.e. 'output_filename' can provide directory components if needed).

'libraries' is a list of libraries to link against. These are library names, not filenames, since they're translated into filenames in a platform-specific way (eg. "foo" becomes "libfoo.a" on Unix and "foo.lib" on DOS/Windows). However, they can include a directory component, which means the linker will look in that specific directory rather than searching all the normal locations.

'library_dirs', if supplied, should be a list of directories to search for libraries that were specified as bare library names (ie. no directory component). These are on top of the system default and those supplied to 'add_library_dir()' and/or 'set_library_dirs()'. 'runtime_library_dirs' is a list of directories that will be embedded into the shared library and used to search for other shared libraries that *it* depends on at run-time. (This may only be relevant on Unix.)

'export_symbols' is a list of symbols that the shared library will export. (This appears to be relevant only on Windows.)

'debug' is as for 'compile()' and 'create_static_lib()', with the slight distinction that it actually matters on most platforms (as opposed to 'create_static_lib()', which includes a 'debug' flag mostly for form's sake).

'extra_preargs' and 'extra_postargs' are as for 'compile()' (except of course that they supply command-line arguments for the particular linker being used).

'target_lang' is the target language for which the given objects are being compiled. This allows specific linkage time treatment of certain languages.

Raises LinkError on failure.

Overrides: ccompiler.CCompiler.link
(inherited documentation)

object_filenames(self, source_filenames, strip_dir=0, output_dir='')

 
Overrides: ccompiler.CCompiler.object_filenames