Sha256: 5c78e0ec4ca201ef6a04eb68f7d4a0c2a477a84d8f3d0e934247269d76d212e1

Contents?: true

Size: 1.48 KB

Versions: 12

Compression:

Stored size: 1.48 KB

Contents

module Methadone
  module ExecutionStrategy
    # Base for any ExecutionStrategy implementation.  Currently, this is nothing more than an interface
    # specification.
    class Base
      # Executes the command and returns the results back.  This
      # should do no logging or other logic other than to execute the
      # command and return the required results.  If command is an
      # array, use exec directly bypassing any tokenization, shell or
      # otherwise; otherwise use the normal shell interpretation of
      # the command string.
      #
      # command:: the command-line to run, as an Array or a String
      #
      # Returns an array of size 3:
      # <tt>[0]</tt>:: The standard output of the command as a String, never nil
      # <tt>[1]</tt>:: The standard error output of the command as a String, never nil
      # <tt>[2]</tt>:: A Process::Status-like objects that responds to <tt>exitstatus</tt> which returns
      #                the exit code of the command (e.g. 0 for success).
      def run_command(command)
        subclass_must_implement!
      end

      # Returns the class that, if caught by calling #run_command, represents the underlying command
      # not existing.  For example, in MRI Ruby, if you try to execute a non-existent command,
      # you get a Errno::ENOENT.
      def exception_meaning_command_not_found
        subclass_must_implement!
      end
    protected
      def subclass_must_implement!; raise "subclass must implement"; end
    end
  end
end

Version data entries

12 entries across 12 versions & 2 rubygems

Version Path
methadone-2.0.2 lib/methadone/execution_strategy/base.rb
methadone-2.0.1 lib/methadone/execution_strategy/base.rb
methadone-2.0.0 lib/methadone/execution_strategy/base.rb
methadone-1.9.5 lib/methadone/execution_strategy/base.rb
methadone-1.9.4 lib/methadone/execution_strategy/base.rb
methadone-1.9.3 lib/methadone/execution_strategy/base.rb
methadone-1.9.2 lib/methadone/execution_strategy/base.rb
methadone-rehab-1.9.2 lib/methadone/execution_strategy/base.rb
methadone-1.9.1 lib/methadone/execution_strategy/base.rb
methadone-1.9.0 lib/methadone/execution_strategy/base.rb
methadone-1.8.0 lib/methadone/execution_strategy/base.rb
methadone-1.7.0 lib/methadone/execution_strategy/base.rb