sass 3.4.25 → 3.5.0

data/vendor/listen/lib/listen/adapter.rb

@@ -1,327 +0,0 @@
-require 'rbconfig'
-require 'thread'
-require 'set'
-require 'fileutils'
-
-module Listen
-  class Adapter
-    attr_accessor :directories, :callback, :stopped, :paused,
-                  :mutex, :changed_directories, :turnstile, :latency,
-                  :worker, :worker_thread, :poller_thread
-
-    # The list of existing optimized adapters.
-    OPTIMIZED_ADAPTERS = %w[Darwin Linux BSD Windows]
-
-    # The list of existing fallback adapters.
-    FALLBACK_ADAPTERS = %w[Polling]
-
-    # The list of all existing adapters.
-    ADAPTERS = OPTIMIZED_ADAPTERS + FALLBACK_ADAPTERS
-
-    # The default delay between checking for changes.
-    DEFAULT_LATENCY = 0.25
-
-    # The default warning message when falling back to polling adapter.
-    POLLING_FALLBACK_MESSAGE = <<-EOS.gsub(/^\s*/, '')
-      Listen will be polling for changes. Learn more at https://github.com/guard/listen#polling-fallback.
-    EOS
-
-    # Selects the appropriate adapter implementation for the
-    # current OS and initializes it.
-    #
-    # @param [String, Array<String>] directories the directories to watch
-    # @param [Hash] options the adapter options
-    # @option options [Boolean] force_polling to force polling or not
-    # @option options [String, Boolean] polling_fallback_message to change polling fallback message or remove it
-    # @option options [Float] latency the delay between checking for changes in seconds
-    #
-    # @yield [changed_directories, options] callback the callback called when a change happens
-    # @yieldparam [Array<String>] changed_directories the changed directories
-    # @yieldparam [Hash] options callback options (like recursive: true)
-    #
-    # @return [Listen::Adapter] the chosen adapter
-    #
-    def self.select_and_initialize(directories, options = {}, &callback)
-      forced_adapter_class = options.delete(:force_adapter)
-      force_polling = options.delete(:force_polling)
-
-      if forced_adapter_class
-        forced_adapter_class.load_dependent_adapter
-        return forced_adapter_class.new(directories, options, &callback)
-      end
-
-      return Adapters::Polling.new(directories, options, &callback) if force_polling
-
-      OPTIMIZED_ADAPTERS.each do |adapter|
-        namespaced_adapter = Adapters.const_get(adapter)
-        if namespaced_adapter.send(:usable_and_works?, directories, options)
-          return namespaced_adapter.new(directories, options, &callback)
-        end
-      end
-
-      self.warn_polling_fallback(options)
-      Adapters::Polling.new(directories, options, &callback)
-    end
-
-    # Initializes the adapter.
-    #
-    # @param [String, Array<String>] directories the directories to watch
-    # @param [Hash] options the adapter options
-    # @option options [Float] latency the delay between checking for changes in seconds
-    #
-    # @yield [changed_directories, options] callback Callback called when a change happens
-    # @yieldparam [Array<String>] changed_directories the changed directories
-    # @yieldparam [Hash] options callback options (like recursive: true)
-    #
-    # @return [Listen::Adapter] the adapter
-    #
-    def initialize(directories, options = {}, &callback)
-      @directories         = Array(directories)
-      @callback            = callback
-      @stopped             = true
-      @paused              = false
-      @mutex               = Mutex.new
-      @changed_directories = Set.new
-      @turnstile           = Turnstile.new
-      @latency             = options.fetch(:latency, default_latency)
-      @worker              = initialize_worker
-    end
-
-    # Starts the adapter and don't block the current thread.
-    #
-    # @param [Boolean] blocking whether or not to block the current thread after starting
-    #
-    def start
-      mutex.synchronize do
-        return unless stopped
-        @stopped = false
-      end
-
-      start_worker
-      start_poller
-    end
-
-    # Starts the adapter and block the current thread.
-    #
-    # @since 1.0.0
-    #
-    def start!
-      start
-      blocking_thread.join
-    end
-
-    # Stops the adapter.
-    #
-    def stop
-      mutex.synchronize do
-        return if stopped
-        @stopped = true
-        turnstile.signal # ensure no thread is blocked
-      end
-
-      worker.stop if worker
-      Thread.kill(worker_thread) if worker_thread
-      if poller_thread
-        poller_thread.kill
-        poller_thread.join
-      end
-    end
-
-    # Pauses the adapter.
-    #
-    def pause
-      @paused = true
-    end
-
-    # Unpauses the adapter.
-    #
-    def unpause
-      @paused = false
-    end
-
-    # Returns whether the adapter is started or not.
-    #
-    # @return [Boolean] whether the adapter is started or not
-    #
-    def started?
-      !stopped
-    end
-
-    # Returns whether the adapter is paused or not.
-    #
-    # @return [Boolean] whether the adapter is paused or not
-    #
-    def paused?
-      paused
-    end
-
-    # Blocks the main thread until the poll thread
-    # runs the callback.
-    #
-    def wait_for_callback
-      turnstile.wait unless paused
-    end
-
-    # Blocks the main thread until N changes are
-    # detected.
-    #
-    def wait_for_changes(threshold = 0)
-      changes = 0
-
-      loop do
-        mutex.synchronize { changes = changed_directories.size }
-
-        return if paused || stopped
-        return if changes >= threshold
-
-        sleep(latency)
-      end
-    end
-
-    # Checks if the adapter is usable and works on the current OS.
-    #
-    # @param [String, Array<String>] directories the directories to watch
-    # @param [Hash] options the adapter options
-    # @option options [Float] latency the delay between checking for changes in seconds
-    #
-    # @return [Boolean] whether the adapter is usable and work or not
-    #
-    def self.usable_and_works?(directories, options = {})
-      usable? && Array(directories).all? { |d| works?(d, options) }
-    end
-
-    # Checks if the adapter is usable on target OS.
-    #
-    # @return [Boolean] whether usable or not
-    #
-    def self.usable?
-      load_dependent_adapter if RbConfig::CONFIG['target_os'] =~ target_os_regex
-    end
-
-    # Load the adapter gem
-    #
-    # @return [Boolean] whether loaded or not
-    #
-    def self.load_dependent_adapter
-      return true if @loaded
-      require adapter_gem
-      return @loaded = true
-    rescue LoadError
-      false
-    end
-
-    # Runs a tests to determine if the adapter can actually pick up
-    # changes in a given directory and returns the result.
-    #
-    # @note This test takes some time depending on the adapter latency.
-    #
-    # @param [String, Pathname] directory the directory to watch
-    # @param [Hash] options the adapter options
-    # @option options [Float] latency the delay between checking for changes in seconds
-    #
-    # @return [Boolean] whether the adapter works or not
-    #
-    def self.works?(directory, options = {})
-      work      = false
-      test_file = "#{directory}/.listen_test"
-      callback  = lambda { |*| work = true }
-      adapter   = self.new(directory, options, &callback)
-      adapter.start
-
-      FileUtils.touch(test_file)
-
-      t = Thread.new { sleep(adapter.latency * 5); adapter.stop }
-
-      adapter.wait_for_callback
-      work
-    ensure
-      Thread.kill(t) if t
-      FileUtils.rm(test_file, :force => true)
-      adapter.stop if adapter && adapter.started?
-    end
-
-    # Runs the callback and passes it the changes if there are any.
-    #
-    def report_changes
-      changed_dirs = nil
-
-      mutex.synchronize do
-        return if @changed_directories.empty?
-        changed_dirs = @changed_directories.to_a
-        @changed_directories.clear
-      end
-
-      callback.call(changed_dirs, {})
-      turnstile.signal
-    end
-
-    private
-
-    # The default delay between checking for changes.
-    #
-    # @note This method can be overriden on a per-adapter basis.
-    #
-    def default_latency
-      DEFAULT_LATENCY
-    end
-
-    # The thread on which the main thread should wait
-    # when the adapter has been started in blocking mode.
-    #
-    # @note This method can be overriden on a per-adapter basis.
-    #
-    def blocking_thread
-      worker_thread
-    end
-
-    # Initialize the adpater' specific worker.
-    #
-    # @note Each adapter must override this method
-    #   to initialize its own @worker.
-    #
-    def initialize_worker
-      nil
-    end
-
-    # Should start the worker in a new thread.
-    #
-    # @note Each adapter must override this method
-    #   to start its worker on a new @worker_thread thread.
-    #
-    def start_worker
-      raise NotImplementedError, "#{self.class} cannot respond to: #{__method__}"
-    end
-
-    # This method starts a new thread which poll for changes detected by
-    # the adapter and report them back to the user.
-    #
-    def start_poller
-      @poller_thread = Thread.new { poll_changed_directories }
-    end
-
-    # Warn of polling fallback unless the :polling_fallback_message
-    # has been set to false.
-    #
-    # @param [String] warning an existing warning message
-    # @param [Hash] options the adapter options
-    # @option options [Boolean] polling_fallback_message to change polling fallback message or remove it
-    #
-    def self.warn_polling_fallback(options)
-      return if options[:polling_fallback_message] == false
-
-      warning = options[:polling_fallback_message] || POLLING_FALLBACK_MESSAGE
-      Kernel.warn "[Listen warning]:\n#{warning.gsub(/^(.*)/, '  \1')}"
-    end
-
-    # Polls changed directories and reports them back when there are changes.
-    #
-    # @note This method can be overriden on a per-adapter basis.
-    #
-    def poll_changed_directories
-      until stopped
-        sleep(latency)
-        report_changes
-      end
-    end
-  end
-end

data/vendor/listen/lib/listen/adapters/bsd.rb

@@ -1,75 +0,0 @@
-module Listen
-  module Adapters
-
-    # Listener implementation for BSD's `kqueue`.
-    #
-    class BSD < Adapter
-      # Watched kqueue events
-      #
-      # @see http://www.freebsd.org/cgi/man.cgi?query=kqueue
-      # @see https://github.com/nex3/rb-kqueue/blob/master/lib/rb-kqueue/queue.rb
-      #
-      EVENTS = [:delete, :write, :extend, :attrib, :link, :rename, :revoke]
-
-      def self.target_os_regex; /freebsd/i; end
-      def self.adapter_gem; 'rb-kqueue'; end
-
-      private
-
-      # Initializes a kqueue Queue and adds a watcher for each files in
-      # the directories passed to the adapter.
-      #
-      # @return [INotify::Notifier] initialized kqueue
-      #
-      # @see Listen::Adapter#initialize_worker
-      #
-      def initialize_worker
-        require 'find'
-
-        callback = lambda do |event|
-          path = event.watcher.path
-          mutex.synchronize do
-            # kqueue watches everything, but Listen only needs the
-            # directory where stuffs happens.
-            @changed_directories << (File.directory?(path) ? path : File.dirname(path))
-
-            # If it is a directory, and it has a write flag, it means a
-            # file has been added so find out which and deal with it.
-            # No need to check for removed files, kqueue will forget them
-            # when the vfs does.
-            if File.directory?(path) && event.flags.include?(:write)
-              queue = event.watcher.queue
-              Find.find(path) do |file|
-                unless queue.watchers.detect { |k,v| v.path == file.to_s }
-                  queue.watch_file(file, *EVENTS, &callback)
-                end
-              end
-            end
-          end
-        end
-
-        KQueue::Queue.new.tap do |queue|
-          directories.each do |directory|
-            Find.find(directory) do |path|
-              queue.watch_file(path, *EVENTS, &callback)
-            end
-          end
-        end
-      end
-
-      # Starts the worker in a new thread.
-      #
-      # @see Listen::Adapter#start_worker
-      #
-      def start_worker
-        @worker_thread = Thread.new do
-          until stopped
-            worker.poll
-            sleep(latency)
-          end
-        end
-      end
-    end
-
-  end
-end

data/vendor/listen/lib/listen/adapters/darwin.rb

@@ -1,48 +0,0 @@
-module Listen
-  module Adapters
-
-    # Adapter implementation for Mac OS X `FSEvents`.
-    #
-    class Darwin < Adapter
-      LAST_SEPARATOR_REGEX = /\/$/
-
-
-      def self.target_os_regex; /darwin(1.+)?$/i; end
-      def self.adapter_gem; 'rb-fsevent'; end
-
-      private
-
-      # Initializes a FSEvent worker and adds a watcher for
-      # each directory passed to the adapter.
-      #
-      # @return [FSEvent] initialized worker
-      #
-      # @see Listen::Adapter#initialize_worker
-      #
-      def initialize_worker
-        FSEvent.new.tap do |worker|
-          worker.watch(directories.dup, :latency => latency) do |changes|
-            next if paused
-
-            mutex.synchronize do
-              changes.each { |path| @changed_directories << path.sub(LAST_SEPARATOR_REGEX, '') }
-            end
-          end
-        end
-      end
-
-      # Starts the worker in a new thread and sleep 0.1 second.
-      #
-      # @see Listen::Adapter#start_worker
-      #
-      def start_worker
-        @worker_thread = Thread.new { worker.run }
-        # The FSEvent worker needs some time to start up. Turnstiles can't
-        # be used to wait for it as it runs in a loop.
-        # TODO: Find a better way to block until the worker starts.
-        sleep 0.1
-      end
-    end
-
-  end
-end

data/vendor/listen/lib/listen/adapters/linux.rb

@@ -1,81 +0,0 @@
-module Listen
-  module Adapters
-
-    # Listener implementation for Linux `inotify`.
-    #
-    class Linux < Adapter
-      # Watched inotify events
-      #
-      # @see http://www.tin.org/bin/man.cgi?section=7&topic=inotify
-      # @see https://github.com/nex3/rb-inotify/blob/master/lib/rb-inotify/notifier.rb#L99-L177
-      #
-      EVENTS = [:recursive, :attrib, :create, :delete, :move, :close_write]
-
-      # The message to show when the limit of inotify watchers is not enough
-      #
-      INOTIFY_LIMIT_MESSAGE = <<-EOS.gsub(/^\s*/, '')
-        Listen error: unable to monitor directories for changes.
-
-        Please head to https://github.com/guard/listen/wiki/Increasing-the-amount-of-inotify-watchers
-        for information on how to solve this issue.
-      EOS
-
-      def self.target_os_regex; /linux/i; end
-      def self.adapter_gem; 'rb-inotify'; end
-
-      # Initializes the Adapter.
-      #
-      # @see Listen::Adapter#initialize
-      #
-      def initialize(directories, options = {}, &callback)
-        super
-      rescue Errno::ENOSPC
-        abort(INOTIFY_LIMIT_MESSAGE)
-      end
-
-      private
-
-      # Initializes a INotify worker and adds a watcher for
-      # each directory passed to the adapter.
-      #
-      # @return [INotify::Notifier] initialized worker
-      #
-      # @see Listen::Adapter#initialize_worker
-      #
-      def initialize_worker
-        callback = lambda do |event|
-          if paused || (
-            # Event on root directory
-            event.name == ""
-          ) || (
-            # INotify reports changes to files inside directories as events
-            # on the directories themselves too.
-            #
-            # @see http://linux.die.net/man/7/inotify
-            event.flags.include?(:isdir) and (event.flags & [:close, :modify]).any?
-          )
-            # Skip all of these!
-            next
-          end
-
-          mutex.synchronize do
-            @changed_directories << File.dirname(event.absolute_name)
-          end
-        end
-
-        INotify::Notifier.new.tap do |worker|
-          directories.each { |dir| worker.watch(dir, *EVENTS, &callback) }
-        end
-      end
-
-      # Starts the worker in a new thread.
-      #
-      # @see Listen::Adapter#start_worker
-      #
-      def start_worker
-        @worker_thread = Thread.new { worker.run }
-      end
-    end
-
-  end
-end

data/vendor/listen/lib/listen/adapters/polling.rb

@@ -1,58 +0,0 @@
-module Listen
-  module Adapters
-
-    DEFAULT_POLLING_LATENCY = 1.0
-
-    # Polling Adapter that works cross-platform and
-    # has no dependencies. This is the adapter that
-    # uses the most CPU processing power and has higher
-    # file IO than the other implementations.
-    #
-    class Polling < Adapter
-      private
-
-      # The default delay between checking for changes.
-      #
-      # @see Listen::Adapter#default_latency
-      #
-      def default_latency
-        1.0
-      end
-
-      # The thread on which the main thread should wait
-      # when the adapter has been started in blocking mode.
-      #
-      # @see Listen::Adapter#blocking_thread
-      #
-      def blocking_thread
-        poller_thread
-      end
-
-      # @see Listen::Adapter#start_worker
-      #
-      # @see Listen::Adapter#start_worker
-      #
-      def start_worker
-        # The polling adapter has no worker! Sad panda! :'(
-      end
-
-      # Poll listener directory for file system changes.
-      #
-      # @see Listen::Adapter#poll_changed_directories
-      #
-      def poll_changed_directories
-        until stopped
-          next if paused
-
-          start = Time.now.to_f
-          callback.call(directories.dup, :recursive => true)
-          turnstile.signal
-          nap_time = latency - (Time.now.to_f - start)
-          sleep(nap_time) if nap_time > 0
-        end
-      rescue Interrupt
-      end
-    end
-
-  end
-end

data/vendor/listen/lib/listen/adapters/windows.rb

@@ -1,91 +0,0 @@
-require 'set'
-require 'rubygems'
-
-module Listen
-  module Adapters
-
-    # Adapter implementation for Windows `wdm`.
-    #
-    class Windows < Adapter
-
-      BUNDLER_DECLARE_GEM = <<-EOS.gsub(/^ {6}/, '')
-        Please add the following to your Gemfile to avoid polling for changes:
-          require 'rbconfig'
-          gem 'wdm', '>= 0.1.0' if RbConfig::CONFIG['target_os'] =~ /mswin|mingw/i
-      EOS
-
-      def self.target_os_regex; /mswin|mingw/i; end
-      def self.adapter_gem; 'wdm'; end
-
-      # Checks if the adapter is usable on target OS.
-      #
-      # @return [Boolean] whether usable or not
-      #
-      def self.usable?
-        super if mri? && at_least_ruby_1_9?
-      end
-
-      # Load the adapter gem
-      #
-      # @return [Boolean] whether required or not
-      #
-      def self.load_dependent_adapter
-        super
-      rescue Gem::LoadError
-        Kernel.warn BUNDLER_DECLARE_GEM
-      end
-
-      private
-
-      # Checks if Ruby engine is MRI.
-      #
-      # @return [Boolean]
-      #
-      def self.mri?
-        defined?(RUBY_ENGINE) && RUBY_ENGINE == 'ruby'
-      end
-
-      # Checks if Ruby engine is MRI.
-      #
-      # @return [Boolean]
-      #
-      def self.at_least_ruby_1_9?
-        Gem::Version.new(RUBY_VERSION.dup) >= Gem::Version.new('1.9.2')
-      end
-
-      # Initializes a WDM monitor and adds a watcher for
-      # each directory passed to the adapter.
-      #
-      # @return [WDM::Monitor] initialized worker
-      #
-      # @see Listen::Adapter#initialize_worker
-      #
-      def initialize_worker
-        callback = Proc.new do |change|
-          next if paused
-
-          mutex.synchronize do
-            @changed_directories << File.dirname(change.path)
-          end
-        end
-
-        WDM::Monitor.new.tap do |worker|
-          directories.each { |dir| worker.watch_recursively(dir, &callback) }
-        end
-      end
-
-      # Start the worker in a new thread and sleep 0.1 second.
-      #
-      # @see Listen::Adapter#start_worker
-      #
-      def start_worker
-        @worker_thread = Thread.new { worker.run! }
-        # Wait for the worker to start. This is needed to avoid a deadlock
-        # when stopping immediately after starting.
-        sleep 0.1
-      end
-
-    end
-
-  end
-end