Contents

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

module Listen
  module Adapter
    OPTIMIZED_ADAPTERS = %w[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 = {})
      return TCP if options[:force_tcp]
      return Polling if options[:force_polling]
      return _usable_adapter_class if _usable_adapter_class

      _warn_polling_fallback(options)
      Polling
    end

    private

    def self._usable_adapter_class
      adapters = OPTIMIZED_ADAPTERS.map { |adapter| Adapter.const_get(adapter) }
      adapters.detect { |adapter| adapter.send(:usable?) }
    end

    def self._warn_polling_fallback(options)
      return if options[:polling_fallback_message] == false

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

Version data entries

9 entries across 9 versions & 1 rubygems

Version	Path
listen-2.7.4	lib/listen/adapter.rb
listen-2.7.3	lib/listen/adapter.rb
listen-2.7.2	lib/listen/adapter.rb
listen-2.7.1	lib/listen/adapter.rb
listen-2.7.0	lib/listen/adapter.rb
listen-2.6.2	lib/listen/adapter.rb
listen-2.6.1	lib/listen/adapter.rb
listen-2.6.0	lib/listen/adapter.rb
listen-2.5.0	lib/listen/adapter.rb