mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
579 lines
16 KiB
Ruby
579 lines
16 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
require_relative "command_execution"
|
|
require_relative "the_bundle"
|
|
require_relative "path"
|
|
|
|
module Spec
|
|
module Helpers
|
|
include Spec::Path
|
|
|
|
def reset!
|
|
Dir.glob("#{tmp}/{gems/*,*}", File::FNM_DOTMATCH).each do |dir|
|
|
next if %w[base base_system remote1 rubocop standard gems rubygems . ..].include?(File.basename(dir))
|
|
FileUtils.rm_rf(dir)
|
|
end
|
|
FileUtils.mkdir_p(home)
|
|
FileUtils.mkdir_p(tmpdir)
|
|
reset_paths!
|
|
end
|
|
|
|
def reset_paths!
|
|
Bundler.reset!
|
|
Gem.clear_paths
|
|
end
|
|
|
|
def the_bundle(*args)
|
|
TheBundle.new(*args)
|
|
end
|
|
|
|
def command_executions
|
|
@command_executions ||= []
|
|
end
|
|
|
|
def last_command
|
|
command_executions.last || raise("There is no last command")
|
|
end
|
|
|
|
def out
|
|
last_command.stdout
|
|
end
|
|
|
|
def err
|
|
last_command.stderr
|
|
end
|
|
|
|
MAJOR_DEPRECATION = /^\[DEPRECATED\]\s*/.freeze
|
|
|
|
def err_without_deprecations
|
|
err.gsub(/#{MAJOR_DEPRECATION}.+[\n]?/, "")
|
|
end
|
|
|
|
def deprecations
|
|
err.split("\n").select {|l| l =~ MAJOR_DEPRECATION }.join("\n").split(MAJOR_DEPRECATION)
|
|
end
|
|
|
|
def exitstatus
|
|
last_command.exitstatus
|
|
end
|
|
|
|
def run(cmd, *args)
|
|
opts = args.last.is_a?(Hash) ? args.pop : {}
|
|
groups = args.map(&:inspect).join(", ")
|
|
setup = "require '#{entrypoint}' ; Bundler.ui.silence { Bundler.setup(#{groups}) }"
|
|
ruby([setup, cmd].join(" ; "), opts)
|
|
end
|
|
|
|
def load_error_run(ruby, name, *args)
|
|
cmd = <<-RUBY
|
|
begin
|
|
#{ruby}
|
|
rescue LoadError => e
|
|
warn "ZOMG LOAD ERROR" if e.message.include?("-- #{name}")
|
|
end
|
|
RUBY
|
|
opts = args.last.is_a?(Hash) ? args.pop : {}
|
|
args += [opts]
|
|
run(cmd, *args)
|
|
end
|
|
|
|
def bundle(cmd, options = {}, &block)
|
|
bundle_bin = options.delete(:bundle_bin)
|
|
bundle_bin ||= installed_bindir.join("bundle")
|
|
|
|
env = options.delete(:env) || {}
|
|
|
|
requires = options.delete(:requires) || []
|
|
realworld = RSpec.current_example.metadata[:realworld]
|
|
|
|
artifice = options.delete(:artifice) do
|
|
if realworld
|
|
"vcr"
|
|
else
|
|
"fail"
|
|
end
|
|
end
|
|
if artifice
|
|
requires << "#{Path.spec_dir}/support/artifice/#{artifice}.rb"
|
|
end
|
|
|
|
load_path = []
|
|
load_path << spec_dir
|
|
|
|
dir = options.delete(:dir) || bundled_app
|
|
raise_on_error = options.delete(:raise_on_error)
|
|
|
|
args = options.map do |k, v|
|
|
case v
|
|
when nil
|
|
next
|
|
when true
|
|
" --#{k}"
|
|
when false
|
|
" --no-#{k}"
|
|
else
|
|
" --#{k} #{v}"
|
|
end
|
|
end.join
|
|
|
|
ruby_cmd = build_ruby_cmd({ :load_path => load_path, :requires => requires })
|
|
cmd = "#{ruby_cmd} #{bundle_bin} #{cmd}#{args}"
|
|
sys_exec(cmd, { :env => env, :dir => dir, :raise_on_error => raise_on_error }, &block)
|
|
end
|
|
|
|
def bundler(cmd, options = {})
|
|
options[:bundle_bin] = system_gem_path.join("bin/bundler")
|
|
bundle(cmd, options)
|
|
end
|
|
|
|
def ruby(ruby, options = {})
|
|
ruby_cmd = build_ruby_cmd
|
|
escaped_ruby = ruby.shellescape
|
|
sys_exec(%(#{ruby_cmd} -w -e #{escaped_ruby}), options)
|
|
end
|
|
|
|
def load_error_ruby(ruby, name, opts = {})
|
|
ruby(<<-R)
|
|
begin
|
|
#{ruby}
|
|
rescue LoadError => e
|
|
warn "ZOMG LOAD ERROR" if e.message.include?("-- #{name}")
|
|
end
|
|
R
|
|
end
|
|
|
|
def build_ruby_cmd(options = {})
|
|
libs = options.delete(:load_path)
|
|
lib_option = libs ? "-I#{libs.join(File::PATH_SEPARATOR)}" : []
|
|
|
|
requires = options.delete(:requires) || []
|
|
requires << "#{Path.spec_dir}/support/hax.rb"
|
|
require_option = requires.map {|r| "-r#{r}" }
|
|
|
|
[Gem.ruby, *lib_option, *require_option].compact.join(" ")
|
|
end
|
|
|
|
def gembin(cmd, options = {})
|
|
cmd = bundled_app("bin/#{cmd}") unless cmd.to_s.include?("/")
|
|
sys_exec(cmd.to_s, options)
|
|
end
|
|
|
|
def gem_command(command, options = {})
|
|
env = options[:env] || {}
|
|
env["RUBYOPT"] = opt_add(opt_add("-r#{spec_dir}/support/hax.rb", env["RUBYOPT"]), ENV["RUBYOPT"])
|
|
options[:env] = env
|
|
sys_exec("#{Path.gem_bin} #{command}", options)
|
|
end
|
|
|
|
def rake
|
|
"#{Gem.ruby} -S #{ENV["GEM_PATH"]}/bin/rake"
|
|
end
|
|
|
|
def git(cmd, path, options = {})
|
|
sys_exec("git #{cmd}", options.merge(:dir => path))
|
|
end
|
|
|
|
def sys_exec(cmd, options = {})
|
|
env = options[:env] || {}
|
|
env["RUBYOPT"] = opt_add(opt_add("-r#{spec_dir}/support/switch_rubygems.rb", env["RUBYOPT"]), ENV["RUBYOPT"])
|
|
dir = options[:dir] || bundled_app
|
|
command_execution = CommandExecution.new(cmd.to_s, dir)
|
|
|
|
require "open3"
|
|
require "shellwords"
|
|
Open3.popen3(env, *cmd.shellsplit, :chdir => dir) do |stdin, stdout, stderr, wait_thr|
|
|
yield stdin, stdout, wait_thr if block_given?
|
|
stdin.close
|
|
|
|
stdout_read_thread = Thread.new { stdout.read }
|
|
stderr_read_thread = Thread.new { stderr.read }
|
|
command_execution.stdout = stdout_read_thread.value.strip
|
|
command_execution.stderr = stderr_read_thread.value.strip
|
|
|
|
status = wait_thr.value
|
|
command_execution.exitstatus = if status.exited?
|
|
status.exitstatus
|
|
elsif status.signaled?
|
|
exit_status_for_signal(status.termsig)
|
|
end
|
|
end
|
|
|
|
unless options[:raise_on_error] == false || command_execution.success?
|
|
raise <<~ERROR
|
|
|
|
Invoking `#{cmd}` failed with output:
|
|
----------------------------------------------------------------------
|
|
#{command_execution.stdboth}
|
|
----------------------------------------------------------------------
|
|
ERROR
|
|
end
|
|
|
|
command_executions << command_execution
|
|
|
|
command_execution.stdout
|
|
end
|
|
|
|
def all_commands_output
|
|
return "" if command_executions.empty?
|
|
|
|
"\n\nCommands:\n#{command_executions.map(&:to_s_verbose).join("\n\n")}"
|
|
end
|
|
|
|
def config(config = nil, path = bundled_app(".bundle/config"))
|
|
return Psych.load_file(path) unless config
|
|
FileUtils.mkdir_p(File.dirname(path))
|
|
File.open(path, "w") do |f|
|
|
f.puts config.to_yaml
|
|
end
|
|
config
|
|
end
|
|
|
|
def global_config(config = nil)
|
|
config(config, home(".bundle/config"))
|
|
end
|
|
|
|
def create_file(path, contents = "")
|
|
path = Pathname.new(path).expand_path(bundled_app) unless path.is_a?(Pathname)
|
|
path.dirname.mkpath
|
|
File.open(path.to_s, "w") do |f|
|
|
f.puts strip_whitespace(contents)
|
|
end
|
|
end
|
|
|
|
def gemfile(*args)
|
|
contents = args.pop
|
|
|
|
if contents.nil?
|
|
File.open(bundled_app_gemfile, "r", &:read)
|
|
else
|
|
create_file(args.pop || "Gemfile", contents)
|
|
end
|
|
end
|
|
|
|
def lockfile(*args)
|
|
contents = args.pop
|
|
|
|
if contents.nil?
|
|
File.open(bundled_app_lock, "r", &:read)
|
|
else
|
|
create_file(args.pop || "Gemfile.lock", contents)
|
|
end
|
|
end
|
|
|
|
def strip_whitespace(str)
|
|
# Trim the leading spaces
|
|
spaces = str[/\A\s+/, 0] || ""
|
|
str.gsub(/^#{spaces}/, "")
|
|
end
|
|
|
|
def install_gemfile(*args)
|
|
opts = args.last.is_a?(Hash) ? args.pop : {}
|
|
gemfile(*args)
|
|
bundle :install, opts
|
|
end
|
|
|
|
def lock_gemfile(*args)
|
|
gemfile(*args)
|
|
opts = args.last.is_a?(Hash) ? args.last : {}
|
|
bundle :lock, opts
|
|
end
|
|
|
|
def system_gems(*gems)
|
|
gems = gems.flatten
|
|
options = gems.last.is_a?(Hash) ? gems.pop : {}
|
|
path = options.fetch(:path, system_gem_path)
|
|
default = options.fetch(:default, false)
|
|
with_gem_path_as(path) do
|
|
gem_repo = options.fetch(:gem_repo, gem_repo1)
|
|
gems.each do |g|
|
|
gem_name = g.to_s
|
|
if gem_name.start_with?("bundler")
|
|
version = gem_name.match(/\Abundler-(?<version>.*)\z/)[:version] if gem_name != "bundler"
|
|
with_built_bundler(version) {|gem_path| install_gem(gem_path, default) }
|
|
elsif gem_name =~ %r{\A(?:[a-zA-Z]:)?/.*\.gem\z}
|
|
install_gem(gem_name, default)
|
|
else
|
|
install_gem("#{gem_repo}/gems/#{gem_name}.gem", default)
|
|
end
|
|
end
|
|
end
|
|
end
|
|
|
|
def install_gem(path, default = false)
|
|
raise "OMG `#{path}` does not exist!" unless File.exist?(path)
|
|
|
|
args = "--no-document --ignore-dependencies"
|
|
args += " --default --install-dir #{system_gem_path}" if default
|
|
|
|
gem_command "install #{args} '#{path}'"
|
|
end
|
|
|
|
def with_built_bundler(version = nil)
|
|
version ||= Bundler::VERSION
|
|
full_name = "bundler-#{version}"
|
|
build_path = tmp + full_name
|
|
bundler_path = build_path + "#{full_name}.gem"
|
|
|
|
Dir.mkdir build_path
|
|
|
|
begin
|
|
shipped_files.each do |shipped_file|
|
|
target_shipped_file = build_path + shipped_file
|
|
target_shipped_dir = File.dirname(target_shipped_file)
|
|
FileUtils.mkdir_p target_shipped_dir unless File.directory?(target_shipped_dir)
|
|
FileUtils.cp shipped_file, target_shipped_file, :preserve => true
|
|
end
|
|
|
|
replace_version_file(version, dir: build_path) # rubocop:disable Style/HashSyntax
|
|
|
|
Spec::BuildMetadata.write_build_metadata(dir: build_path) # rubocop:disable Style/HashSyntax
|
|
|
|
gem_command "build #{relative_gemspec}", :dir => build_path
|
|
|
|
yield(bundler_path)
|
|
ensure
|
|
build_path.rmtree
|
|
end
|
|
end
|
|
|
|
def with_gem_path_as(path)
|
|
without_env_side_effects do
|
|
ENV["GEM_HOME"] = path.to_s
|
|
ENV["GEM_PATH"] = path.to_s
|
|
ENV["BUNDLER_ORIG_GEM_HOME"] = nil
|
|
ENV["BUNDLER_ORIG_GEM_PATH"] = nil
|
|
yield
|
|
end
|
|
end
|
|
|
|
def with_path_as(path)
|
|
without_env_side_effects do
|
|
ENV["PATH"] = path.to_s
|
|
ENV["BUNDLER_ORIG_PATH"] = nil
|
|
yield
|
|
end
|
|
end
|
|
|
|
def without_env_side_effects
|
|
backup = ENV.to_hash
|
|
yield
|
|
ensure
|
|
ENV.replace(backup)
|
|
end
|
|
|
|
def with_path_added(path)
|
|
with_path_as([path.to_s, ENV["PATH"]].join(File::PATH_SEPARATOR)) do
|
|
yield
|
|
end
|
|
end
|
|
|
|
def opt_add(option, options)
|
|
[option.strip, options].compact.reject(&:empty?).join(" ")
|
|
end
|
|
|
|
def opt_remove(option, options)
|
|
return unless options
|
|
|
|
options.split(" ").reject {|opt| opt.strip == option.strip }.join(" ")
|
|
end
|
|
|
|
def break_git!
|
|
FileUtils.mkdir_p(tmp("broken_path"))
|
|
File.open(tmp("broken_path/git"), "w", 0o755) do |f|
|
|
f.puts "#!/usr/bin/env ruby\nSTDERR.puts 'This is not the git you are looking for'\nexit 1"
|
|
end
|
|
|
|
ENV["PATH"] = "#{tmp("broken_path")}:#{ENV["PATH"]}"
|
|
end
|
|
|
|
def with_fake_man
|
|
skip "fake_man is not a Windows friendly binstub" if Gem.win_platform?
|
|
|
|
FileUtils.mkdir_p(tmp("fake_man"))
|
|
File.open(tmp("fake_man/man"), "w", 0o755) do |f|
|
|
f.puts "#!/usr/bin/env ruby\nputs ARGV.inspect\n"
|
|
end
|
|
with_path_added(tmp("fake_man")) { yield }
|
|
end
|
|
|
|
def pristine_system_gems(*gems)
|
|
FileUtils.rm_rf(system_gem_path)
|
|
|
|
system_gems(*gems)
|
|
end
|
|
|
|
def realworld_system_gems(*gems)
|
|
gems = gems.flatten
|
|
opts = gems.last.is_a?(Hash) ? gems.pop : {}
|
|
path = opts.fetch(:path, system_gem_path)
|
|
|
|
with_gem_path_as(path) do
|
|
gems.each do |gem|
|
|
gem_command "install --no-document #{gem}"
|
|
end
|
|
end
|
|
end
|
|
|
|
def cache_gems(*gems)
|
|
gems = gems.flatten
|
|
|
|
FileUtils.rm_rf("#{bundled_app}/vendor/cache")
|
|
FileUtils.mkdir_p("#{bundled_app}/vendor/cache")
|
|
|
|
gems.each do |g|
|
|
path = "#{gem_repo1}/gems/#{g}.gem"
|
|
raise "OMG `#{path}` does not exist!" unless File.exist?(path)
|
|
FileUtils.cp(path, "#{bundled_app}/vendor/cache")
|
|
end
|
|
end
|
|
|
|
def simulate_new_machine
|
|
FileUtils.rm_rf bundled_app(".bundle")
|
|
pristine_system_gems :bundler
|
|
end
|
|
|
|
def simulate_platform(platform)
|
|
old = ENV["BUNDLER_SPEC_PLATFORM"]
|
|
ENV["BUNDLER_SPEC_PLATFORM"] = platform.to_s
|
|
yield if block_given?
|
|
ensure
|
|
ENV["BUNDLER_SPEC_PLATFORM"] = old if block_given?
|
|
end
|
|
|
|
def simulate_windows(platform = x86_mswin32)
|
|
old = ENV["BUNDLER_SPEC_WINDOWS"]
|
|
ENV["BUNDLER_SPEC_WINDOWS"] = "true"
|
|
simulate_platform platform do
|
|
simulate_bundler_version_when_missing_prerelease_default_gem_activation do
|
|
yield
|
|
end
|
|
end
|
|
ensure
|
|
ENV["BUNDLER_SPEC_WINDOWS"] = old
|
|
end
|
|
|
|
def simulate_bundler_version_when_missing_prerelease_default_gem_activation
|
|
return yield unless rubygems_version_failing_to_activate_bundler_prereleases
|
|
|
|
old = ENV["BUNDLER_VERSION"]
|
|
ENV["BUNDLER_VERSION"] = Bundler::VERSION
|
|
yield
|
|
ensure
|
|
ENV["BUNDLER_VERSION"] = old
|
|
end
|
|
|
|
def env_for_missing_prerelease_default_gem_activation
|
|
if rubygems_version_failing_to_activate_bundler_prereleases
|
|
{ "BUNDLER_VERSION" => Bundler::VERSION }
|
|
else
|
|
{}
|
|
end
|
|
end
|
|
|
|
def current_ruby_minor
|
|
Gem.ruby_version.segments.tap {|s| s.delete_at(2) }.join(".")
|
|
end
|
|
|
|
def next_ruby_minor
|
|
Gem.ruby_version.segments[0..1].map.with_index {|s, i| i == 1 ? s + 1 : s }.join(".")
|
|
end
|
|
|
|
# versions providing a bundler version finder but not including
|
|
# https://github.com/rubygems/rubygems/commit/929e92d752baad3a08f3ac92eaec162cb96aedd1
|
|
def rubygems_version_failing_to_activate_bundler_prereleases
|
|
Gem.rubygems_version < Gem::Version.new("3.1.0.pre.1") && Gem.rubygems_version >= Gem::Version.new("2.7.0")
|
|
end
|
|
|
|
def revision_for(path)
|
|
sys_exec("git rev-parse HEAD", :dir => path).strip
|
|
end
|
|
|
|
def with_read_only(pattern)
|
|
chmod = lambda do |dirmode, filemode|
|
|
lambda do |f|
|
|
mode = File.directory?(f) ? dirmode : filemode
|
|
File.chmod(mode, f)
|
|
end
|
|
end
|
|
|
|
Dir[pattern].each(&chmod[0o555, 0o444])
|
|
yield
|
|
ensure
|
|
Dir[pattern].each(&chmod[0o755, 0o644])
|
|
end
|
|
|
|
# Simulate replacing TODOs with real values
|
|
def prepare_gemspec(pathname)
|
|
process_file(pathname) do |line|
|
|
case line
|
|
when /spec\.metadata\["(?:allowed_push_host|homepage_uri|source_code_uri|changelog_uri)"\]/, /spec\.homepage/
|
|
line.gsub(/\=.*$/, '= "http://example.org"')
|
|
when /spec\.summary/
|
|
line.gsub(/\=.*$/, '= "A short summary of my new gem."')
|
|
when /spec\.description/
|
|
line.gsub(/\=.*$/, '= "A longer description of my new gem."')
|
|
else
|
|
line
|
|
end
|
|
end
|
|
end
|
|
|
|
def process_file(pathname)
|
|
changed_lines = pathname.readlines.map do |line|
|
|
yield line
|
|
end
|
|
File.open(pathname, "w") {|file| file.puts(changed_lines.join) }
|
|
end
|
|
|
|
def with_env_vars(env_hash, &block)
|
|
current_values = {}
|
|
env_hash.each do |k, v|
|
|
current_values[k] = ENV[k]
|
|
ENV[k] = v
|
|
end
|
|
block.call if block_given?
|
|
env_hash.each do |k, _|
|
|
ENV[k] = current_values[k]
|
|
end
|
|
end
|
|
|
|
def require_rack
|
|
# need to hack, so we can require rack
|
|
old_gem_home = ENV["GEM_HOME"]
|
|
ENV["GEM_HOME"] = Spec::Path.base_system_gem_path.to_s
|
|
require "rack"
|
|
ENV["GEM_HOME"] = old_gem_home
|
|
end
|
|
|
|
def wait_for_server(host, port, seconds = 15)
|
|
tries = 0
|
|
sleep 0.5
|
|
TCPSocket.new(host, port)
|
|
rescue StandardError => e
|
|
raise(e) if tries > (seconds * 2)
|
|
tries += 1
|
|
retry
|
|
end
|
|
|
|
def find_unused_port
|
|
port = 21_453
|
|
begin
|
|
port += 1 while TCPSocket.new("127.0.0.1", port)
|
|
rescue StandardError
|
|
false
|
|
end
|
|
port
|
|
end
|
|
|
|
def exit_status_for_signal(signal_number)
|
|
# For details see: https://en.wikipedia.org/wiki/Exit_status#Shell_and_scripts
|
|
128 + signal_number
|
|
end
|
|
|
|
private
|
|
|
|
def git_root_dir?
|
|
root.to_s == `git rev-parse --show-toplevel`.chomp
|
|
end
|
|
end
|
|
end
|