123456789_123456789_123456789_123456789_123456789_

Class: Gem::Ext::ExtConfBuilder

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, Builder
Instance Chain:
Inherits: Gem::Ext::Builder
Defined in: lib/rubygems/ext/ext_conf_builder.rb

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Builder - Inherited

#build_extensions

Builds extensions.

#build_error

Logs the build output, then raises BuildError.

#build_extension,
#build_log_path

Where a build log of kind for this gem lives in the build_info directory.

#builder_for

Chooses the extension builder class for extension

#mkmf_log_candidates

Places a completed build may have left an mkmf.log, most specific first.

#preserve_mkmf_log

Moves the mkmf.log this build left behind into the build_info directory and returns its new path, or nil when there is none or it cannot be kept.

#write_gem_make_out

Writes output to gem_make.out in the build_info directory and returns its path, or nil when it cannot be written.

::Gem::UserInteraction - Included

#alert

Displays an alert statement.

#alert_error

Displays an error statement to the error output location.

#alert_warning

Displays a warning statement to the warning output location.

#ask

Asks a question and returns the answer.

#ask_for_password

Asks for a password with a prompt

#ask_yes_no

Asks a yes or no question.

#choose_from_list

Asks the user to answer question with an answer from the given list.

#say

Displays the given statement on the standard output (or equivalent).

#terminate_interaction

Terminates the RubyGems process with the given exit_code

#verbose

Calls say with msg or the results of the block if really_verbose is true.

::Gem::DefaultUserInteraction - Included

::Gem::Text - Included

#clean_text

Remove any non-printable characters and make the text suitable for printing.

#format_text

Wraps text to wrap characters and optionally indents by indent characters.

#levenshtein_distance

Returns a value representing the "cost" of transforming str1 into str2 Vendored version of DidYouMean::Levenshtein.distance from the ruby/did_you_mean gem @ 1.4.0 https://github.com/ruby/did_you_mean/blob/2ddf39b874808685965dbc47d344cf6c7651807c/lib/did_you_mean/levenshtein.rb#L7-L37.

#truncate_text, #min3

Constructor Details

This class inherits a constructor from Gem::Ext::Builder

Class Method Details

.build(extension, dest_path, results, args = [], lib_dir = nil, extension_dir = Dir.pwd, target_rbconfig = Gem.target_rbconfig, n_jobs: nil)

[ GitHub ]

  
# File 'lib/rubygems/ext/ext_conf_builder.rb', line 10

def self.build(extension, dest_path, results, args = [], lib_dir = nil, extension_dir = Dir.pwd,
  target_rbconfig = Gem.target_rbconfig, n_jobs: nil)
  require "fileutils"
  require "tempfile"

  tmp_dest = Dir.mktmpdir(".gem.", extension_dir)

  # Some versions of `mktmpdir` return absolute paths, which will break make
  # if the paths contain spaces.
  #
  # As such, we convert to a relative path.
  tmp_dest_relative = get_relative_path(tmp_dest.clone, extension_dir)

  destdir = ENV["DESTDIR"]

  begin
    cmd = ruby << File.basename(extension)
    cmd << "--target-rbconfig=#{target_rbconfig.path}" if target_rbconfig.path
    cmd.push(*args)

    run(cmd, results, class_name, extension_dir)

    # "clean" is the first make target, and mkmf puts mkmf.log in CLEANFILES,
    # so park the log next to the built extension before make can delete it.
    # Whether it is then dropped or kept for inspection is decided by
    # Gem::Ext::Builder#build_extension.
    mkmf_log = File.join(extension_dir, "mkmf.log")
    FileUtils.mv mkmf_log, dest_path if File.exist?(mkmf_log)

    ENV["DESTDIR"] = nil

    make dest_path, results, extension_dir, tmp_dest_relative, target_rbconfig: target_rbconfig, n_jobs: n_jobs

    full_tmp_dest = File.join(extension_dir, tmp_dest_relative)

    is_cross_compiling = target_rbconfig["platform"] != RbConfig::CONFIG["platform"]
    # Do not copy extension libraries by default when cross-compiling
    # not to conflict with the one already built for the host platform.
    if Gem.install_extension_in_lib && lib_dir && !is_cross_compiling
      FileUtils.mkdir_p lib_dir
      entries = Dir.entries(full_tmp_dest) - %w[. ..]
      entries = entries.map {|entry| File.join full_tmp_dest, entry }
      FileUtils.cp_r entries, lib_dir, remove_destination: true
    end

    FileUtils::Entry_.new(full_tmp_dest).traverse do |ent|
      destent = ent.class.new(dest_path, ent.rel)
      destent.exist? || FileUtils.mv(ent.path, destent.path)
    end

    make dest_path, results, extension_dir, tmp_dest_relative, ["clean"], target_rbconfig: target_rbconfig
  ensure
    ENV["DESTDIR"] = destdir
  end

  results
ensure
  FileUtils.rm_rf tmp_dest if tmp_dest
end

.get_relative_path(path, base)

[ GitHub ]

  
# File 'lib/rubygems/ext/ext_conf_builder.rb', line 70

def self.get_relative_path(path, base)
  path[0..base.length - 1] = "." if path.start_with?(base)
  path
end