Contents

require 'listen/adapter/base'
require 'listen/adapter/bsd'
require 'listen/adapter/darwin'
require 'listen/adapter/linux'
require 'listen/adapter/polling'
require 'listen/adapter/windows'

module Listen
  module Adapter
    OPTIMIZED_ADAPTERS = [Darwin, Linux, BSD, Windows]
    POLLING_FALLBACK_MESSAGE = 'Listen will be polling for changes.'\
      'Learn more at https://github.com/guard/listen#polling-fallback.'

    def self.select(options = {})
      _log :debug, 'Adapter: considering TCP ...'
      return TCP if options[:force_tcp]
      _log :debug, 'Adapter: considering polling ...'
      return Polling if options[:force_polling]
      _log :debug, 'Adapter: considering optimized backend...'
      return _usable_adapter_class if _usable_adapter_class
      _log :debug, 'Adapter: falling back to polling...'
      _warn_polling_fallback(options)
      Polling
    rescue
      _log :warn, format('Adapter: failed: %s:%s', $ERROR_POSITION.inspect,
                         $ERROR_POSITION * "\n")
      raise
    end

    private

    def self._usable_adapter_class
      OPTIMIZED_ADAPTERS.detect(&:usable?)
    end

    def self._warn_polling_fallback(options)
      msg = options.fetch(:polling_fallback_message, POLLING_FALLBACK_MESSAGE)
      Kernel.warn "[Listen warning]:\n  #{msg}" if msg
    end

    def self._log(type, message)
      Celluloid::Logger.send(type, message)
    end
  end
end

Version data entries

5 entries across 5 versions & 1 rubygems

Version	Path
listen-2.8.3	lib/listen/adapter.rb
listen-2.8.2	lib/listen/adapter.rb
listen-2.8.1	lib/listen/adapter.rb
listen-2.8.0	lib/listen/adapter.rb
listen-2.7.12	lib/listen/adapter.rb