sass 3.2.0.alpha.101 → 3.2.0.alpha.102

data/vendor/listen/Rakefile

@@ -0,0 +1,47 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec
+
+require 'rbconfig'
+namespace(:spec) do
+  if RbConfig::CONFIG['host_os'] =~ /mswin|mingw/i
+    desc "Run all specs on multiple ruby versions (requires pik)"
+    task(:portability) do
+      %w[187 192 161].each do |version|
+         system "cmd /c echo -----------#{version}------------ & " +
+           "pik use #{version} & " +
+           "bundle install & " +
+           "bundle exec rspec spec"
+      end
+    end
+  else
+    desc "Run all specs on multiple ruby versions (requires rvm)"
+    task(:portability) do
+      travis_config_file = File.expand_path("../.travis.yml", __FILE__)
+      begin
+        travis_options ||= YAML::load_file(travis_config_file)
+      rescue => ex
+        puts "Travis config file '#{travis_config_file}' could not be found: #{ex.message}"
+        return
+      end
+
+      travis_options['rvm'].each do |version|
+        system <<-BASH
+          bash -c 'source ~/.rvm/scripts/rvm;
+                   rvm #{version};
+                   ruby_version_string_size=`ruby -v | wc -m`
+                   echo;
+                   for ((c=1; c<$ruby_version_string_size; c++)); do echo -n "="; done
+                   echo;
+                   echo "`ruby -v`";
+                   for ((c=1; c<$ruby_version_string_size; c++)); do echo -n "="; done
+                   echo;
+                   RBXOPT="-Xrbc.db" bundle install;
+                   RBXOPT="-Xrbc.db" bundle exec rspec spec -f doc 2>&1;'
+        BASH
+      end
+    end
+  end
+end

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,38 @@
+module Listen
+
+  autoload :Turnstile,       'listen/turnstile'
+  autoload :Listener,        'listen/listener'
+  autoload :MultiListener,   'listen/multi_listener'
+  autoload :DirectoryRecord, 'listen/directory_record'
+  autoload :Adapter,         'listen/adapter'
+
+  module Adapters
+    autoload :Darwin,  'listen/adapters/darwin'
+    autoload :Linux,   'listen/adapters/linux'
+    autoload :Windows, 'listen/adapters/windows'
+    autoload :Polling, 'listen/adapters/polling'
+  end
+
+  # Listens to filesystem modifications on a either single directory or multiple directories.
+  #
+  # @param (see Listen::Listener#new)
+  # @param (see Listen::MultiListener#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 = if args.length == 1 || ! args[1].is_a?(String)
+      Listener.new(*args, &block)
+    else
+      MultiListener.new(*args, &block)
+    end
+
+    block ? listener.start : listener
+  end
+
+end

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

@@ -0,0 +1,159 @@
+require 'rbconfig'
+require 'thread'
+require 'set'
+require 'fileutils'
+
+module Listen
+  class Adapter
+    attr_accessor :directories, :latency, :paused
+
+    # The default delay between checking for changes.
+    DEFAULT_LATENCY = 0.1
+
+    # The default warning message when falling back to polling adapter.
+    POLLING_FALLBACK_MESSAGE = "WARNING: Listen has fallen back to polling, learn more at https://github.com/guard/listen#fallback."
+
+    # 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_dirs, options] callback Callback called when a change happens
+    # @yieldparam [Array<String>] changed_dirs 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)
+      return Adapters::Polling.new(directories, options, &callback) if options.delete(:force_polling)
+
+      if Adapters::Darwin.usable_and_works?(directories, options)
+        Adapters::Darwin.new(directories, options, &callback)
+      elsif Adapters::Linux.usable_and_works?(directories, options)
+        Adapters::Linux.new(directories, options, &callback)
+      elsif Adapters::Windows.usable_and_works?(directories, options)
+        Adapters::Windows.new(directories, options, &callback)
+      else
+        unless options[:polling_fallback_message] == false
+          Kernel.warn(options[:polling_fallback_message] || POLLING_FALLBACK_MESSAGE)
+        end
+        Adapters::Polling.new(directories, options, &callback)
+      end
+    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_dirs, options] callback Callback called when a change happens
+    # @yieldparam [Array<String>] changed_dirs 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
+      @latency    ||= DEFAULT_LATENCY
+      @latency      = options[:latency] if options[:latency]
+      @paused       = false
+      @mutex        = Mutex.new
+      @changed_dirs = Set.new
+      @turnstile    = Turnstile.new
+    end
+
+    # Starts the adapter.
+    #
+    # @param [Boolean] blocking whether or not to block the current thread after starting
+    #
+    def start(blocking = true)
+      @stop = false
+    end
+
+    # Stops the adapter.
+    #
+    def stop
+      @stop = true
+      @turnstile.signal # ensure no thread is blocked
+    end
+
+    # Blocks the main thread until the poll thread
+    # calls the callback.
+    #
+    def wait_for_callback
+      @turnstile.wait unless @paused
+    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 usable and work or not
+    #
+    def self.usable_and_works?(directories, options = {})
+      usable? && Array(directories).all? { |d| works?(d, options) }
+    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 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 { |changed_dirs, options| work = true }
+      adapter  = self.new(directory, options, &callback)
+      adapter.start(false)
+
+      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) if File.exists?(test_file)
+      adapter.stop
+    end
+
+    private
+
+    # Polls changed directories and reports them back
+    # when there are changes.
+    #
+    # @option [Boolean] recursive whether or not to pass the recursive option to the callback
+    #
+    def poll_changed_dirs(recursive = false)
+      until @stop
+        sleep(@latency)
+        next if @changed_dirs.empty?
+
+        changed_dirs = []
+
+        @mutex.synchronize do
+          changed_dirs = @changed_dirs.to_a
+          @changed_dirs.clear
+        end
+
+        @callback.call(changed_dirs, recursive ? {:recursive => recursive} : {})
+        @turnstile.signal
+      end
+    end
+  end
+end

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

@@ -0,0 +1,84 @@
+module Listen
+  module Adapters
+
+    # Adapter implementation for Mac OS X `FSEvents`.
+    #
+    class Darwin < Adapter
+
+      LAST_SEPARATOR_REGEX = /\/$/
+
+      # Initializes the Adapter. See {Listen::Adapter#initialize} for more info.
+      #
+      def initialize(directories, options = {}, &callback)
+        super
+        @worker = init_worker
+      end
+
+      # Starts the adapter.
+      #
+      # @param [Boolean] blocking whether or not to block the current thread after starting
+      #
+      def start(blocking = true)
+        @mutex.synchronize do
+          return if @stop == false
+          super
+        end
+
+        @worker_thread = Thread.new { @worker.run }
+        @poll_thread   = Thread.new { poll_changed_dirs }
+
+        # The FSEvent worker needs sometime to startup. 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 @latency
+        @poll_thread.join if blocking
+      end
+
+      # Stops the adapter.
+      #
+      def stop
+        @mutex.synchronize do
+          return if @stop == true
+          super
+        end
+
+        @worker.stop
+        Thread.kill(@worker_thread) if @worker_thread
+        @poll_thread.join
+      end
+
+      # Checks if the adapter is usable on the current OS.
+      #
+      # @return [Boolean] whether usable or not
+      #
+      def self.usable?
+        return false unless RbConfig::CONFIG['target_os'] =~ /darwin(1.+)?$/i
+
+        require 'rb-fsevent'
+        true
+      rescue LoadError
+        false
+      end
+
+      private
+
+      # Initializes a FSEvent worker and adds a watcher for
+      # each directory passed to the adapter.
+      #
+      # @return [FSEvent] initialized worker
+      #
+      def init_worker
+        FSEvent.new.tap do |worker|
+          worker.watch(@directories.dup, :latency => @latency) do |changes|
+            next if @paused
+            @mutex.synchronize do
+              changes.each { |path| @changed_dirs << path.sub(LAST_SEPARATOR_REGEX, '') }
+            end
+          end
+        end
+      end
+
+    end
+
+  end
+end

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

@@ -0,0 +1,99 @@
+module Listen
+  module Adapters
+
+    # 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 = %w[recursive attrib close modify move create delete delete_self move_self]
+
+    # Listener implementation for Linux `inotify`.
+    #
+    class Linux < Adapter
+
+      # Initializes the Adapter. See {Listen::Adapter#initialize} for more info.
+      #
+      def initialize(directories, options = {}, &callback)
+        super
+        @worker = init_worker
+      end
+
+      # Starts the adapter.
+      #
+      # @param [Boolean] blocking whether or not to block the current thread after starting
+      #
+      def start(blocking = true)
+        @mutex.synchronize do
+          return if @stop == false
+          super
+        end
+
+        @worker_thread = Thread.new { @worker.run }
+        @poll_thread   = Thread.new { poll_changed_dirs }
+        @poll_thread.join if blocking
+      end
+
+      # Stops the adapter.
+      #
+      def stop
+        @mutex.synchronize do
+          return if @stop == true
+          super
+        end
+
+        @worker.stop
+        Thread.kill(@worker_thread) if @worker_thread
+        @poll_thread.join
+      end
+
+      # Check if the adapter is usable on the current OS.
+      #
+      # @return [Boolean] whether usable or not
+      #
+      def self.usable?
+        return false unless RbConfig::CONFIG['target_os'] =~ /linux/i
+
+        require 'rb-inotify'
+        true
+      rescue LoadError
+        false
+      end
+
+    private
+
+      # Initializes a INotify worker and adds a watcher for
+      # each directory passed to the adapter.
+      #
+      # @return [INotify::Notifier] initialized worker
+      #
+      def init_worker
+        worker = INotify::Notifier.new
+        @directories.each do |directory|
+          worker.watch(directory, *EVENTS.map(&:to_sym)) 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] != []
+            )
+              # Skip all of these!
+              next
+            end
+
+            @mutex.synchronize do
+              @changed_dirs << File.dirname(event.absolute_name)
+            end
+          end
+        end
+        worker
+      end
+
+    end
+
+  end
+end