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

This code is based directly on the ::Gem::Text gem implementation Returns a value representing the “cost” of transforming str1 into str2.

#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. However, on Ruby 1.9.x on Windows, relative
  # paths cause all C extension builds to fail.
  #
  # As such, we convert to a relative path unless we are using Ruby 1.9.x on
  # Windows. This means that when using Ruby 1.9.x on Windows, paths with
  # spaces do not work.
  #
  # Details: https://github.com/rubygems/rubygems/issues/977#issuecomment-171544940
  tmp_dest_relative = get_relative_path(tmp_dest.clone, extension_dir)

  Tempfile.open %w[siteconf .rb], extension_dir do |siteconf|
    siteconf.puts "require 'rbconfig'"
    siteconf.puts "dest_path = #{tmp_dest_relative.dump}"
    %w[sitearchdir sitelibdir].each do |dir|
      siteconf.puts "RbConfig::MAKEFILE_CONFIG['#{dir}'] = dest_path"
      siteconf.puts "RbConfig::CONFIG['#{dir}'] = dest_path"
    end

    siteconf.close

    destdir = ENV["DESTDIR"]

    begin
      # workaround for https://github.com/oracle/truffleruby/issues/2115
      siteconf_path = RUBY_ENGINE == "truffleruby" ? siteconf.path.dup : siteconf.path
      require "shellwords"
      cmd = Gem.ruby.shellsplit << "-I" << File.expand_path("../../..", __FILE__) <<
            "-r" << get_relative_path(siteconf_path, extension_dir) << File.basename(extension)
      cmd.push(*args)

      begin
        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
        siteconf.unlink
      end

      ENV["DESTDIR"] = nil

      make dest_path, results, extension_dir

      if tmp_dest_relative
        full_tmp_dest = File.join(extension_dir, tmp_dest_relative)

        # TODO remove in RubyGems 3
        if Gem.install_extension_in_lib and 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? or FileUtils.mv(ent.path, destent.path)
        end
      end
    ensure
      ENV["DESTDIR"] = destdir
      siteconf.close!
    end
  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 94

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