module Cliver

A legacy interface for {::detect} with the option `strict: true`, ensures that the first executable on your path matches the requirements. @see Cliver::Dependency @overload (see Cliver::Dependency#initialize) @param (see Cliver::Dependency#initialize) @option options [Boolean] :strict (true) @see Cliver::Dependency::initialize @raise (see Cliver::Dependency#detect!) @return (see Cliver::Dependency#detect!)

# File lib/cliver.rb, line 46
def self.assert(*args, &block)
  options = args.last.kind_of?(Hash) ? args.pop : {}
  args << options.merge(:strict => true)
  Dependency::new(*args, &block).detect!
end

A non-raising variant of {::detect!}, simply returns false if dependency cannot be found. @see Cliver::Dependency @overload (see Cliver::Dependency#initialize) @param (see Cliver::Dependency#initialize) @raise (see Cliver::Dependency#detect) @return (see Cliver::Dependency#detect)

# File lib/cliver.rb, line 34
def self.detect(*args, &block)
  Dependency::new(*args, &block).detect
end

The primary interface for the Cliver gem allows detection of an executable on your path that matches a version requirement, or raise an appropriate exception to make resolution simple and straight-forward. @see Cliver::Dependency @overload (see Cliver::Dependency#initialize) @param (see Cliver::Dependency#initialize) @raise (see Cliver::Dependency#detect!) @return (see Cliver::Dependency#detect!)

# File lib/cliver.rb, line 23
def self.detect!(*args, &block)
  Dependency::new(*args, &block).detect!
end

Verify an absolute-path to an executable. @overload verify!(executable, *requirements, options = {})

@param executable [String] absolute path to an executable
@param requirements (see Cliver::Dependency#initialize)
@option options (see Cliver::Dependency::initialize)
@raise (see Cliver::Dependency#detect!)
@return (see Cliver::Dependency#detect!)

# File lib/cliver.rb, line 59
def self.verify!(executable, *args, &block)
  unless File.absolute_path?(executable)
    raise ArgumentError, "executable path must be absolute, " +
                         "got '#{executable.inspect}'."
  end
  options = args.last.kind_of?(Hash) ? args.pop : {}
  args << options.merge(:path => '.') # ensure path non-empty.
  Dependency::new(executable, *args, &block).detect!
end

Wraps Cliver::assert and returns truthy/false instead of raising @see Cliver::assert @overload (see Cliver::Assertion#initialize) @param (see Cliver::Assertion#initialize) @return [False,String] either returns false or the reason why the

assertion was unmet.

# File lib/cliver.rb, line 77
def dependency_unmet?(*args, &block)
  Cliver.assert(*args, &block)
  false
rescue Dependency::NotMet => error
  # Cliver::Assertion::VersionMismatch -> 'Version Mismatch'
  reason = error.class.name.split(':').last.gsub(/([a-z])([A-Z])/, '\\1 \\2')
  "#{reason}: #{error.message}"
end