interactor.rb

module Guard

  # The Guard interactor is a Pry REPL with a Guard
  # specific command set.
  #
  class Interactor

    require 'pry'

    require 'guard'
    require 'guard/ui'

    require 'guard/commands/all'
    require 'guard/commands/change'
    require 'guard/commands/notification'
    require 'guard/commands/pause'
    require 'guard/commands/reload'
    require 'guard/commands/show'
    GUARD_RC = '~/.guardrc'
    HISTORY_FILE = '~/.guard_history'

    def initialize
      Pry.config.hooks.add_hook :when_started, :load_guard_rc do
        if File.exist? File.expand_path GUARD_RC
          load GUARD_RC
        else
          example_guard_rc_url = 'https://gist.github.com/da7f4b2f8465a3d75cd4'
          Pry.output.puts <<-EOT
- No ~/.guardrc found, so commands will be more verbose.
(See tersifying example at #{example_guard_rc_url} )
          EOT
        end
      end
      Pry.config.history.file = HISTORY_FILE
      Pry.config.prompt = [
        proc do |target_self, nest_level, pry|
          "[#{pry.input_array.size}] #{ ::Guard.listener.paused? ? 'pause' : 'guard' }(#{Pry.view_clip(target_self)})#{":#{nest_level}" unless nest_level.zero?}> "
        end,
        proc do |target_self, nest_level, pry|
          "[#{pry.input_array.size}] #{ ::Guard.listener.paused? ? 'pause' : 'guard' }(#{Pry.view_clip(target_self)})#{":#{nest_level}" unless nest_level.zero?}* "
        end
      ]
    end

    # Start the line reader in its own thread.
    #
    def start
      return if ENV['GUARD_ENV'] == 'test'

      if !@thread || !@thread.alive?
        ::Guard::UI.debug 'Start interactor'

        @thread = Thread.new do
          Pry.start
          ::Guard.stop
          exit
        end
      end
    end

    # Kill interactor thread if not current
    #
    def stop
      return if !@thread || ENV['GUARD_ENV'] == 'test'

      unless Thread.current == @thread
        ::Guard::UI.debug 'Stop interactor'
        @thread.kill
      end
    end

    # Converts and validates a plain text scope
    # to a valid plugin or group scope.
    #
    # @param [String] entries the text scope
    # @return [Array<Hash}, Array] the plugin or group scope, the unknown entries
    #
    def self.convert_scope(entries)
      scopes  = { }
      unknown = []

      entries.each do |entry|
        if guard = ::Guard.guards(entry)
          scopes[:guard] ||= guard
        elsif group = ::Guard.groups(entry)
          scopes[:group] ||= group
        else
          unknown << entry
        end
      end

      [scopes, unknown]
    end
  end
end