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,
#builder_for

Chooses the extension builder class for extension

#write_gem_make_out

Writes output to gem_make.out in the extension install directory.

::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 git.io/JJgZI.

#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)

[ GitHub ]

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

def self.build(extension, dest_path, results, args=[], lib_dir=nil, extension_dir=Dir.pwd)
  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
    require "shellwords"
    cmd = Gem.ruby.shellsplit << "-I" << File.expand_path("../..", __dir__) << File.basename(extension)
    cmd.push(*args)

    run(cmd, results, class_name, extension_dir) do |s, r|
      mkmf_log = File.join(extension_dir, "mkmf.log")
      if File.exist? mkmf_log
        unless s.success?
          r << "To see why this extension failed to compile, please check" \
            " the mkmf.log which can be found here:\n"
          r << "  " + File.join(dest_path, "mkmf.log") + "\n"
        end
        FileUtils.mv mkmf_log, dest_path
      end
    end

    ENV["DESTDIR"] = nil

    make dest_path, results, extension_dir, tmp_dest_relative

    full_tmp_dest = File.join(extension_dir, tmp_dest_relative)

    # TODO remove in RubyGems 4
    if Gem.install_extension_in_lib && lib_dir
      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
  ensure
    ENV["DESTDIR"] = destdir
  end

  results
ensure
  FileUtils.rm_rf tmp_dest if tmp_dest
end

.get_relative_path(path, base) (private)

[ GitHub ]

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

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