master/lib/guard.rb

module Guard

  autoload :UI,         'guard/ui'
  autoload :Dsl,        'guard/dsl'
  autoload :Interactor, 'guard/interactor'
  autoload :Listener,   'guard/listener'
  autoload :Watcher,    'guard/watcher'
  autoload :Notifier,   'guard/notifier'
  autoload :Hook,       'guard/hook'

  class << self
    attr_accessor :options, :guards, :listener

    # initialize this singleton
    def setup(options = {})
      @options  = options
      @listener = Listener.select_and_init
      @guards   = []

      Notifier.turn_off unless options[:notify]

      self
    end

    def start(options = {})
      setup(options)

      Interactor.init_signal_traps
      Dsl.evaluate_guardfile(options)

      if guards.empty?
        UI.error "No guards found in Guardfile, please add at least one."
      else
        listener.on_change do |files|
          run { run_on_change_for_all_guards(files) } if Watcher.match_files?(guards, files)
        end

        UI.info "Guard is now watching at '#{Dir.pwd}'"
        guards.each { |guard| supervised_task(guard, :start) }
        listener.start
      end
    end

    def run_on_change_for_all_guards(files)
      guards.each do |guard|
        paths = Watcher.match_files(guard, files)
        supervised_task(guard, :run_on_change, paths) unless paths.empty?
      end

      # Reparse the whole directory to catch new files modified during the guards run
      new_modified_files = listener.modified_files([Dir.pwd + '/'], :all => true)
      listener.update_last_event
      if !new_modified_files.empty? && Watcher.match_files?(guards, new_modified_files)
        run { run_on_change_for_all_guards(new_modified_files) }
      end
    end

    # Let a guard execute its task but
    # fire it if his work leads to a system failure
    def supervised_task(guard, task_to_supervise, *args)
      guard.hook("#{task_to_supervise}_begin", *args)
      result = guard.send(task_to_supervise, *args)
      guard.hook("#{task_to_supervise}_end", result)
      result
    rescue Exception
      UI.error("#{guard.class.name} guard failed to achieve its <#{task_to_supervise}> command: #{$!}")
      ::Guard.guards.delete guard
      UI.info("Guard #{guard.class.name} has just been fired")
      return $!
    end

    def run
      listener.stop
      UI.clear if options[:clear]
      begin
        yield
      rescue Interrupt
      end
      listener.start
    end

    def add_guard(name, watchers = [], callbacks = [], options = {})
      guard_class = get_guard_class(name)
      watchers = watchers.map { |watcher| ::Guard::Watcher.new(watcher[:pattern], watcher[:action]) }
      @guards << guard_class.new(watchers, options)
      callbacks.each { |callback| ::Guard::Hook.add_callback(callback[:listener], guard_class, callback[:events]) }
    end

    def get_guard_class(name)
      try_to_load_gem name
      self.const_get(self.constants.find{|klass_name| klass_name.to_s.downcase == name.downcase })
    rescue TypeError
      UI.error "Could not find load find gem 'guard-#{name}' or find class Guard::#{name}"
    end

    def try_to_load_gem(name)
      require "guard/#{name.downcase}"
    rescue LoadError
    end

    def locate_guard(name)
      Gem.source_index.find_name("guard-#{name}").last.full_gem_path
    rescue
      UI.error "Could not find 'guard-#{name}' gem path."
    end

  end
end