class Rscons::Builders::Object
A default Rscons
builder which knows how to produce an object file from various types of source files.
Constants
- KNOWN_SUFFIXES
Mapping of known sources from which to build object files.
Public Instance Methods
default_variables(env)
click to toggle source
Return default construction variables for the builder.
@param env [Environment] The Environment
using the builder.
@return [Hash] Default construction variables for the builder.
# File lib/rscons/builders/object.rb, line 20 def default_variables(env) { 'OBJSUFFIX' => ['.o'], 'DEPFILESUFFIX' => '.mf', 'CPPDEFPREFIX' => '-D', 'INCPREFIX' => '-I', 'AS' => '${CC}', 'ASFLAGS' => [], 'ASSUFFIX' => ['.S'], 'ASPPPATH' => '${CPPPATH}', 'ASPPFLAGS' => '${CPPFLAGS}', 'ASDEPGEN' => ['-MMD', '-MF', '${_DEPFILE}'], 'ASCMD' => ['${AS}', '-c', '-o', '${_TARGET}', '${ASDEPGEN}', '${INCPREFIX}${ASPPPATH}', '${ASPPFLAGS}', '${ASFLAGS}', '${_SOURCES}'], 'CPPFLAGS' => ['${CPPDEFPREFIX}${CPPDEFINES}'], 'CPPDEFINES' => [], 'CPPPATH' => [], 'CCFLAGS' => [], 'CC' => 'gcc', 'CFLAGS' => [], 'CSUFFIX' => ['.c'], 'CCDEPGEN' => ['-MMD', '-MF', '${_DEPFILE}'], 'CCCMD' => ['${CC}', '-c', '-o', '${_TARGET}', '${CCDEPGEN}', '${INCPREFIX}${CPPPATH}', '${CPPFLAGS}', '${CFLAGS}', '${CCFLAGS}', '${_SOURCES}'], 'CXX' => 'g++', 'CXXFLAGS' => [], 'CXXSUFFIX' => ['.cc', '.cpp', '.cxx', '.C'], 'CXXDEPGEN' => ['-MMD', '-MF', '${_DEPFILE}'], 'CXXCMD' =>['${CXX}', '-c', '-o', '${_TARGET}', '${CXXDEPGEN}', '${INCPREFIX}${CPPPATH}', '${CPPFLAGS}', '${CXXFLAGS}', '${CCFLAGS}', '${_SOURCES}'], 'DC' => 'gdc', 'DFLAGS' => [], 'DSUFFIX' => ['.d'], 'DDEPGEN' => ['-MMD', '-MF', '${_DEPFILE}'], 'D_IMPORT_PATH' => [], 'DCCMD' => ['${DC}', '-c', '-o', '${_TARGET}', '${DDEPGEN}', '${INCPREFIX}${D_IMPORT_PATH}', '${DFLAGS}', '${_SOURCES}'], } end
finalize(options)
click to toggle source
Finalize the build operation.
@param options [Hash] Builder
finalize options.
@return [String, nil]
Name of the target file on success or nil on failure.
# File lib/rscons/builders/object.rb, line 114 def finalize(options) if options[:command_status] target, deps, cache, env, vars = options.values_at(:target, :sources, :cache, :env, :vars) if File.exists?(vars['_DEPFILE']) deps += Environment.parse_makefile_deps(vars['_DEPFILE']) FileUtils.rm_f(vars['_DEPFILE']) end cache.register_build(target, options[:tc].command, deps.uniq, env) target end end
produces?(target, source, env)
click to toggle source
Return whether this builder object is capable of producing a given target file name from a given source file name.
@param target [String]
The target file name.
@param source [String]
The source file name.
@param env [Environment]
The Environment.
@return [Boolean]
Whether this builder object is capable of producing a given target file name from a given source file name.
# File lib/rscons/builders/object.rb, line 76 def produces?(target, source, env) target.end_with?(*env['OBJSUFFIX']) and KNOWN_SUFFIXES.find do |compiler, suffix_var| source.end_with?(*env[suffix_var]) end end
run(options)
click to toggle source
Run the builder to produce a build target.
@param options [Hash] Builder
run options.
@return [String, ThreadedCommand]
Target file name if target is up to date or a {ThreadedCommand} to execute to build the target.
# File lib/rscons/builders/object.rb, line 90 def run(options) target, sources, cache, env, vars = options.values_at(:target, :sources, :cache, :env, :vars) vars = vars.merge({ '_TARGET' => target, '_SOURCES' => sources, '_DEPFILE' => Rscons.set_suffix(target, env.expand_varref("${DEPFILESUFFIX}", vars)), }) com_prefix = KNOWN_SUFFIXES.find do |compiler, suffix_var| sources.first.end_with?(*env.expand_varref("${#{suffix_var}}", vars)) end.tap do |v| v.nil? and raise "Error: unknown input file type: #{sources.first.inspect}" end.first command = env.build_command("${#{com_prefix}CMD}", vars) # Store vars back into options so new keys are accessible in #finalize. options[:vars] = vars standard_threaded_build("#{com_prefix} #{target}", target, command, sources, env, cache) end