212 lines
7.8 KiB
Python
Executable File
212 lines
7.8 KiB
Python
Executable File
'''
|
|
Created on 20 oct. 2012
|
|
|
|
@author: coissac
|
|
'''
|
|
|
|
import os
|
|
|
|
from distutils.core import Command
|
|
from distutils.sysconfig import customize_compiler
|
|
from distutils.errors import DistutilsSetupError
|
|
from distutils import log
|
|
from distutils.ccompiler import show_compilers
|
|
|
|
class build_exe(Command):
|
|
|
|
description = "build an executable -- Abstract command "
|
|
|
|
user_options = [
|
|
('build-cexe', 'x',
|
|
"directory to build C/C++ libraries to"),
|
|
('build-temp', 't',
|
|
"directory to put temporary build by-products"),
|
|
('debug', 'g',
|
|
"compile with debugging information"),
|
|
('force', 'f',
|
|
"forcibly build everything (ignore file timestamps)"),
|
|
('compiler=', 'c',
|
|
"specify the compiler type"),
|
|
]
|
|
|
|
boolean_options = ['debug', 'force']
|
|
|
|
help_options = [
|
|
('help-compiler', None,
|
|
"list available compilers", show_compilers),
|
|
]
|
|
|
|
def initialize_options(self):
|
|
self.build_cexe = None
|
|
self.build_temp = None
|
|
|
|
# List of executables to build
|
|
self.executables = None
|
|
|
|
# Compilation options for all libraries
|
|
self.include_dirs = None
|
|
self.define = None
|
|
self.undef = None
|
|
self.extra_compile_args = None
|
|
self.debug = None
|
|
self.force = 0
|
|
self.compiler = None
|
|
self.sse = None
|
|
self.built_files=None
|
|
|
|
def finalize_options(self):
|
|
# This might be confusing: both build-cexe and build-temp default
|
|
# to build-temp as defined by the "build" command. This is because
|
|
# I think that C libraries are really just temporary build
|
|
# by-products, at least from the point of view of building Python
|
|
# extensions -- but I want to keep my options open.
|
|
self.set_undefined_options('build',
|
|
('build_temp', 'build_temp'),
|
|
('compiler', 'compiler'),
|
|
('debug', 'debug'),
|
|
('force', 'force'))
|
|
|
|
if self.include_dirs is None:
|
|
self.include_dirs = self.distribution.include_dirs or []
|
|
|
|
if isinstance(self.include_dirs, str):
|
|
self.include_dirs = self.include_dirs.split(os.pathsep)
|
|
|
|
self.sse = self.distribution.sse
|
|
|
|
if self.sse is not None:
|
|
if self.extra_compile_args is None:
|
|
self.extra_compile_args=['-m%s' % self.sse]
|
|
else:
|
|
self.extra_compile_args.append('-m%s' % self.sse)
|
|
|
|
# XXX same as for build_ext -- what about 'self.define' and
|
|
# 'self.undef' ?
|
|
|
|
def run(self):
|
|
|
|
if not self.executables:
|
|
return
|
|
|
|
self.mkpath(self.build_cexe)
|
|
|
|
# Yech -- this is cut 'n pasted from build_ext.py!
|
|
from distutils.ccompiler import new_compiler
|
|
self.compiler = new_compiler(compiler=self.compiler,
|
|
dry_run=self.dry_run,
|
|
force=self.force)
|
|
customize_compiler(self.compiler)
|
|
|
|
if self.include_dirs is not None:
|
|
self.compiler.set_include_dirs(self.include_dirs)
|
|
if self.define is not None:
|
|
# 'define' option is a list of (name,value) tuples
|
|
for (name,value) in self.define:
|
|
self.compiler.define_macro(name, value)
|
|
|
|
if self.undef is not None:
|
|
for macro in self.undef:
|
|
self.compiler.undefine_macro(macro)
|
|
|
|
self.build_executables(self.executables)
|
|
|
|
|
|
def check_executable_list(self, executables):
|
|
"""Ensure that the list of executables is valid.
|
|
|
|
`executable` is presumably provided as a command option 'executables'.
|
|
This method checks that it is a list of 2-tuples, where the tuples
|
|
are (executable_name, build_info_dict).
|
|
|
|
Raise DistutilsSetupError if the structure is invalid anywhere;
|
|
just returns otherwise.
|
|
"""
|
|
if not isinstance(executables, list):
|
|
raise DistutilsSetupError("'executables' option must be a list of tuples")
|
|
|
|
for exe in executables:
|
|
if not isinstance(exe, tuple) and len(exe) != 2:
|
|
raise DistutilsSetupError("each element of 'executables' must a 2-tuple")
|
|
|
|
name, build_info = exe
|
|
|
|
if not isinstance(name, str):
|
|
raise DistutilsSetupError(
|
|
"first element of each tuple in 'executables' "
|
|
"must be a string (the executables name)")
|
|
|
|
if '/' in name or (os.sep != '/' and os.sep in name):
|
|
raise DistutilsSetupError(
|
|
"bad executable name '%s': "
|
|
"may not contain directory separators" % exe[0])
|
|
|
|
if not isinstance(build_info, dict):
|
|
raise DistutilsSetupError(
|
|
"second element of each tuple in 'executables' "
|
|
"must be a dictionary (build info)")
|
|
|
|
def get_executable_names(self):
|
|
# Assume the executables list is valid -- 'check_executable_list()' is
|
|
# called from 'finalize_options()', so it should be!
|
|
if not self.executables:
|
|
return None
|
|
|
|
exe_names = []
|
|
for (exe_name, build_info) in self.executables: # @UnusedVariable
|
|
exe_names.append(exe_name)
|
|
return exe_names
|
|
|
|
|
|
def get_source_files(self):
|
|
self.check_executable_list(self.executables)
|
|
filenames = []
|
|
for (exe_name, build_info) in self.executables: # @UnusedVariable
|
|
sources = build_info.get('sources')
|
|
if sources is None or not isinstance(sources, (list, tuple)):
|
|
raise DistutilsSetupError(
|
|
"in 'executables' option (library '%s'), "
|
|
"'sources' must be present and must be "
|
|
"a list of source filenames" % exe_name)
|
|
|
|
filenames.extend(sources)
|
|
return filenames
|
|
|
|
def substitute_sources(self,exe_name,sources):
|
|
return list(sources)
|
|
|
|
def build_executables(self, executables):
|
|
for (exe_name, build_info) in executables:
|
|
sources = build_info.get('sources')
|
|
if sources is None or not isinstance(sources, (list, tuple)):
|
|
raise DistutilsSetupError(
|
|
"in 'executables' option (library '%s'), "
|
|
"'sources' must be present and must be "
|
|
"a list of source filenames" % exe_name)
|
|
|
|
sources = self.substitute_sources(exe_name,sources)
|
|
|
|
log.info("building '%s' program", exe_name)
|
|
|
|
# First, compile the source code to object files in the library
|
|
# directory. (This should probably change to putting object
|
|
# files in a temporary build directory.)
|
|
macros = build_info.get('macros')
|
|
include_dirs = build_info.get('include_dirs')
|
|
extra_args = self.extra_compile_args or []
|
|
|
|
objects = self.compiler.compile(sources,
|
|
output_dir=self.build_temp,
|
|
macros=macros,
|
|
include_dirs=include_dirs,
|
|
extra_postargs=extra_args,
|
|
debug=self.debug)
|
|
|
|
# Now "link" the object files together into a static library.
|
|
# (On Unix at least, this isn't really linking -- it just
|
|
# builds an archive. Whatever.)
|
|
self.compiler.link_executable(objects, exe_name,
|
|
output_dir=self.build_cexe,
|
|
debug=self.debug)
|
|
|
|
|