class Rscons::Builders::SharedObject
A default Rscons
builder which knows how to produce an object file which is capable of being linked into a shared library from various types of source files.
Constants
- KNOWN_SUFFIXES
Mapping of known sources from which to build object files.
Public Instance Methods
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/shared_object.rb, line 21 def default_variables(env) pic_flags = (RUBY_PLATFORM =~ /mingw/ ? [] : ['-fPIC']) { 'SHCCFLAGS' => ['${CCFLAGS}'] + pic_flags, 'SHCC' => '${CC}', 'SHCFLAGS' => ['${CFLAGS}'], 'SHCCCMD' => ['${SHCC}', '-c', '-o', '${_TARGET}', '${CCDEPGEN}', '${INCPREFIX}${CPPPATH}', '${CPPFLAGS}', '${SHCFLAGS}', '${SHCCFLAGS}', '${_SOURCES}'], 'SHCXX' => '${CXX}', 'SHCXXFLAGS' => ['${CXXFLAGS}'], 'SHCXXCMD' => ['${SHCXX}', '-c', '-o', '${_TARGET}', '${CXXDEPGEN}', '${INCPREFIX}${CPPPATH}', '${CPPFLAGS}', '${SHCXXFLAGS}', '${SHCCFLAGS}', '${_SOURCES}'], 'SHDC' => 'gdc', 'SHDFLAGS' => ['${DFLAGS}'] + pic_flags, 'SHDCCMD' => ['${SHDC}', '-c', '-o', '${_TARGET}', '${INCPREFIX}${D_IMPORT_PATH}', '${SHDFLAGS}', '${_SOURCES}'], } end
Return a set of build features that this builder provides.
@return [Array<String>]
Set of build features that this builder provides.
# File lib/rscons/builders/shared_object.rb, line 44 def features %w[shared] end
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/shared_object.rb, line 99 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
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/shared_object.rb, line 61 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 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/shared_object.rb, line 75 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