sass 3.7.4 → 4.0.0.alpha.1

data/vendor/listen/Rakefile

@@ -0,0 +1,5 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec

data/vendor/listen/Vagrantfile

@@ -0,0 +1,96 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+Vagrant::Config.run do |config|
+  # All Vagrant configuration is done here. The most common configuration
+  # options are documented and commented below. For a complete reference,
+  # please see the online documentation at vagrantup.com.
+
+  # Every Vagrant virtual environment requires a box to build off of.
+  config.vm.box = "lucid32"
+
+  # The url from where the 'config.vm.box' box will be fetched if it
+  # doesn't already exist on the user's system.
+  # config.vm.box_url = "http://domain.com/path/to/above.box"
+
+  # Boot with a GUI so you can see the screen. (Default is headless)
+  # config.vm.boot_mode = :gui
+
+  # Assign this VM to a host-only network IP, allowing you to access it
+  # via the IP. Host-only networks can talk to the host machine as well as
+  # any other machines on the same network, but cannot be accessed (through this
+  # network interface) by any external networks.
+  # config.vm.network :hostonly, "33.33.33.10"
+
+  # Assign this VM to a bridged network, allowing you to connect directly to a
+  # network using the host's network device. This makes the VM appear as another
+  # physical device on your network.
+  # config.vm.network :bridged
+
+  # Forward a port from the guest to the host, which allows for outside
+  # computers to access the VM, whereas host only networking does not.
+  # config.vm.forward_port 80, 8080
+
+  # Share an additional folder to the guest VM. The first argument is
+  # an identifier, the second is the path on the guest to mount the
+  # folder, and the third is the path on the host to the actual folder.
+  # config.vm.share_folder "v-data", "/vagrant_data", "../data"
+
+  # Enable provisioning with Puppet stand alone.  Puppet manifests
+  # are contained in a directory path relative to this Vagrantfile.
+  # You will need to create the manifests directory and a manifest in
+  # the file lucid32.pp in the manifests_path directory.
+  #
+  # An example Puppet manifest to provision the message of the day:
+  #
+  # # group { "puppet":
+  # #   ensure => "present",
+  # # }
+  # #
+  # # File { owner => 0, group => 0, mode => 0644 }
+  # #
+  # # file { '/etc/motd':
+  # #   content => "Welcome to your Vagrant-built virtual machine!
+  # #               Managed by Puppet.\n"
+  # # }
+  #
+  # config.vm.provision :puppet do |puppet|
+  #   puppet.manifests_path = "manifests"
+  #   puppet.manifest_file  = "lucid32.pp"
+  # end
+
+  # Enable provisioning with chef solo, specifying a cookbooks path (relative
+  # to this Vagrantfile), and adding some recipes and/or roles.
+  #
+  # config.vm.provision :chef_solo do |chef|
+  #   chef.cookbooks_path = "cookbooks"
+  #   chef.add_recipe "mysql"
+  #   chef.add_role "web"
+  #
+  #   # You may also specify custom JSON attributes:
+  #   chef.json = { :mysql_password => "foo" }
+  # end
+
+  # Enable provisioning with chef server, specifying the chef server URL,
+  # and the path to the validation key (relative to this Vagrantfile).
+  #
+  # The Opscode Platform uses HTTPS. Substitute your organization for
+  # ORGNAME in the URL and validation key.
+  #
+  # If you have your own Chef Server, use the appropriate URL, which may be
+  # HTTP instead of HTTPS depending on your configuration. Also change the
+  # validation key to validation.pem.
+  #
+  # config.vm.provision :chef_client do |chef|
+  #   chef.chef_server_url = "https://api.opscode.com/organizations/ORGNAME"
+  #   chef.validation_key_path = "ORGNAME-validator.pem"
+  # end
+  #
+  # If you're using the Opscode platform, your validator client is
+  # ORGNAME-validator, replacing ORGNAME with your organization name.
+  #
+  # IF you have your own Chef Server, the default validation client name is
+  # chef-validator, unless you changed the configuration.
+  #
+  #   chef.validation_client_name = "ORGNAME-validator"
+end

data/vendor/listen/lib/listen.rb

@@ -0,0 +1,54 @@
+require 'listen/turnstile'
+require 'listen/listener'
+require 'listen/directory_record'
+require 'listen/adapter'
+
+module Listen
+
+  module Adapters
+    Adapter::ADAPTERS.each do |adapter|
+      require "listen/adapters/#{adapter.downcase}"
+    end
+  end
+
+  # Listens to file system modifications on a either single directory or multiple directories.
+  # When calling this method, the current thread is not blocked.
+  #
+  # @param (see Listen::Listener#new)
+  #
+  # @yield [modified, added, removed] the changed files
+  # @yieldparam [Array<String>] modified the list of modified files
+  # @yieldparam [Array<String>] added the list of added files
+  # @yieldparam [Array<String>] removed the list of removed files
+  #
+  # @return [Listen::Listener] the file listener if no block given
+  #
+  def self.to(*args, &block)
+    listener = _init_listener(*args, &block)
+
+    block ? listener.start : listener
+  end
+
+  # Listens to file system modifications on a either single directory or multiple directories.
+  # When calling this method, the current thread is blocked.
+  #
+  # @param (see Listen::Listener#new)
+  #
+  # @yield [modified, added, removed] the changed files
+  # @yieldparam [Array<String>] modified the list of modified files
+  # @yieldparam [Array<String>] added the list of added files
+  # @yieldparam [Array<String>] removed the list of removed files
+  #
+  # @since 1.0.0
+  #
+  def self.to!(*args, &block)
+    _init_listener(*args, &block).start!
+  end
+
+  # @private
+  #
+  def self._init_listener(*args, &block)
+    Listener.new(*args, &block)
+  end
+
+end

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

@@ -0,0 +1,327 @@
+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