module HMap::Executable

Public Class Methods

capture_command(executable, command, capture: :merge, env: {}, **kwargs) click to toggle source

Runs the given command, capturing the desired output.

@param [String] executable

The binary to use.

@param [Array<#to_s>] command

The command to send to the binary.

@param [Symbol] capture

Whether it should raise if the command fails.

@param [Hash] env

Environment variables to be set for the command.

@raise If the executable could not be located.

@return [(String, Process::Status)]

The desired captured output from the command, and the status from
running the command.
# File lib/cocoapods-hmap/executable.rb, line 127
def self.capture_command(executable, command, capture: :merge, env: {}, **kwargs)
  bin = which!(executable)

  require 'open3'
  command = command.map(&:to_s)
  case capture
  when :merge then Open3.capture2e(env, [bin, bin], *command, **kwargs)
  when :both then Open3.capture3(env, [bin, bin], *command, **kwargs)
  when :out then Open3.capture3(env, [bin, bin], *command, **kwargs).values_at(0, -1)
  when :err then Open3.capture3(env, [bin, bin], *command, **kwargs).drop(1)
  when :none then Open3.capture3(env, [bin, bin], *command, **kwargs).last
  end
end
capture_command!(executable, command, **kwargs) click to toggle source

(see Executable.capture_command)

@raise If running the command fails

# File lib/cocoapods-hmap/executable.rb, line 145
def self.capture_command!(executable, command, **kwargs)
  capture_command(executable, command, **kwargs).tap do |result|
    result = Array(result)
    status = result.last
    unless status.success?
      output = result[0..-2].join
      raise Informative, "#{executable} #{command.join(' ')}\n\n#{output}".strip
    end
  end
end
execute_command(executable, command, raise_on_failure = true) click to toggle source

Executes the given command displaying it if in verbose mode.

@param [String] executable

The binary to use.

@param [Array<#to_s>] command

The command to send to the binary.

@param [Bool] raise_on_failure

Whether it should raise if the command fails.

@raise If the executable could not be located.

@raise If the command fails and the `raise_on_failure` is set to true.

@return [String] the output of the command (STDOUT and STDERR).

# File lib/cocoapods-hmap/executable.rb, line 37
def self.execute_command(executable, command, raise_on_failure = true)
  bin = which!(executable)

  command = command.map(&:to_s)
  if File.basename(bin) == 'tar.exe'
    # Tar on Windows needs --force-local
    command.push('--force-local')
  end
  full_command = "#{bin} #{command.join(' ')}"

  if Pod::Config.instance.verbose?
    p("$ #{full_command}")
    stdout = Indenter.new(STDOUT)
    stderr = Indenter.new(STDERR)
  else
    stdout = Indenter.new
    stderr = Indenter.new
  end

  status = popen3(bin, command, stdout, stderr)
  stdout = stdout.join
  stderr = stderr.join
  output = stdout + stderr
  unless status.success?
    if raise_on_failure
      raise Informative, "#{full_command}\n\n#{output}"
    else
      p("[!] Failed: #{full_command}".red)
    end
  end

  stdout
end
popen3(bin, command, stdout, stderr) click to toggle source
# File lib/cocoapods-hmap/executable.rb, line 156
def self.popen3(bin, command, stdout, stderr)
  require 'open3'
  Open3.popen3(bin, *command) do |i, o, e, t|
    reader(o, stdout)
    reader(e, stderr)
    i.close

    status = t.value

    o.flush
    e.flush
    sleep(0.01)

    status
  end
end
reader(input, output) click to toggle source
# File lib/cocoapods-hmap/executable.rb, line 173
def self.reader(input, output)
  Thread.new do
    buf = ''
    begin
      loop do
        buf << input.readpartial(4096)
        loop do
          string, separator, buf = buf.partition(/[\r\n]/)
          if separator.empty?
            buf = string
            break
          end
          output << (string << separator)
        end
      end
    rescue EOFError, IOError
      output << (buf << $/) unless buf.empty?
    end
  end
end
which(program) click to toggle source

Returns the absolute path to the binary with the given name on the current `PATH`, or `nil` if none is found.

@param [String] program

The name of the program being searched for.

@return [String,Nil] The absolute path to the given program, or `nil` if

it wasn't found in the current `PATH`.
# File lib/cocoapods-hmap/executable.rb, line 80
def self.which(program)
  program = program.to_s
  paths = ENV.fetch('PATH') { '' }.split(File::PATH_SEPARATOR)
  paths.unshift('./')
  paths.uniq!
  paths.each do |path|
    bin = File.expand_path(program, path)
    bin += '.exe' if Gem.win_platform?
    return bin if File.file?(bin) && File.executable?(bin)
  end
  nil
end
which!(program) click to toggle source

Returns the absolute path to the binary with the given name on the current `PATH`, or raises if none is found.

@param [String] program

The name of the program being searched for.

@return [String] The absolute path to the given program.

# File lib/cocoapods-hmap/executable.rb, line 101
def self.which!(program)
  which(program).tap do |bin|
    raise Informative, "Unable to locate the executable `#{program}`" unless bin
  end
end

Public Instance Methods

executable(name) click to toggle source

Creates the methods for the executable with the given name.

@param [Symbol] name

the name of the executable.

@return [void]

# File lib/cocoapods-hmap/executable.rb, line 10
def executable(name)
  define_method(name) do |*command|
    Executable.execute_command(name, Array(command).flatten, false)
  end

  define_method(name.to_s + '!') do |*command|
    Executable.execute_command(name, Array(command).flatten, true)
  end
end