fluid_cli 0.1.2

data/vendor/deps/listen/lib/listen/fsm.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+# Code copied from https://github.com/celluloid/celluloid-fsm
+
+module Listen
+  module FSM
+    # Included hook to extend class methods
+    def self.included(klass)
+      klass.send :extend, ClassMethods
+    end
+
+    module ClassMethods
+      # Obtain or set the start state
+      # Passing a state name sets the start state
+      def start_state(new_start_state = nil)
+        if new_start_state
+          new_start_state.is_a?(Symbol) or raise ArgumentError, "state name must be a Symbol (got #{new_start_state.inspect})"
+          @start_state = new_start_state
+        else
+          defined?(@start_state) or raise ArgumentError, "`start_state :<state>` must be declared before `new`"
+          @start_state
+        end
+      end
+
+      # The valid states for this FSM, as a hash with state name symbols as keys and State objects as values.
+      def states
+        @states ||= {}
+      end
+
+      # Declare an FSM state and optionally provide a callback block to fire on state entry
+      # Options:
+      # * to: a state or array of states this state can transition to
+      def state(state_name, to: nil, &block)
+        state_name.is_a?(Symbol) or raise ArgumentError, "state name must be a Symbol (got #{state_name.inspect})"
+        states[state_name] = State.new(state_name, to, &block)
+      end
+    end
+
+    # NOTE: including classes must call initialize_fsm from their initialize method.
+    def initialize_fsm
+      @fsm_initialized = true
+      @state = self.class.start_state
+      @mutex = ::Mutex.new
+      @state_changed = ::ConditionVariable.new
+    end
+
+    # Current state of the FSM, stored as a symbol
+    attr_reader :state
+
+    # checks for one of the given states to wait for
+    # if not already, waits for a state change (up to timeout seconds--`nil` means infinite)
+    # returns truthy iff the transition to one of the desired state has occurred
+    def wait_for_state(*wait_for_states, timeout: nil)
+      wait_for_states.each do |state|
+        state.is_a?(Symbol) or raise ArgumentError, "states must be symbols (got #{state.inspect})"
+      end
+      @mutex.synchronize do
+        if !wait_for_states.include?(@state)
+          @state_changed.wait(@mutex, timeout)
+        end
+        wait_for_states.include?(@state)
+      end
+    end
+
+    private
+
+    def transition(new_state_name)
+      new_state_name.is_a?(Symbol) or raise ArgumentError, "state name must be a Symbol (got #{new_state_name.inspect})"
+      if (new_state = validate_and_sanitize_new_state(new_state_name))
+        transition_with_callbacks!(new_state)
+      end
+    end
+
+    # Low-level, immediate state transition with no checks or callbacks.
+    def transition!(new_state_name)
+      new_state_name.is_a?(Symbol) or raise ArgumentError, "state name must be a Symbol (got #{new_state_name.inspect})"
+      @fsm_initialized or raise ArgumentError, "FSM not initialized. You must call initialize_fsm from initialize!"
+      @mutex.synchronize do
+        yield if block_given?
+        @state = new_state_name
+        @state_changed.broadcast
+      end
+    end
+
+    def validate_and_sanitize_new_state(new_state_name)
+      return nil if @state == new_state_name
+
+      if current_state && !current_state.valid_transition?(new_state_name)
+        valid = current_state.transitions.map(&:to_s).join(', ')
+        msg = "#{self.class} can't change state from '#{@state}' to '#{new_state_name}', only to: #{valid}"
+        raise ArgumentError, msg
+      end
+
+      unless (new_state = self.class.states[new_state_name])
+        new_state_name == self.class.start_state or raise ArgumentError, "invalid state for #{self.class}: #{new_state_name}"
+      end
+
+      new_state
+    end
+
+    def transition_with_callbacks!(new_state)
+      transition! new_state.name
+      new_state.call(self)
+    end
+
+    def current_state
+      self.class.states[@state]
+    end
+
+    class State
+      attr_reader :name, :transitions
+
+      def initialize(name, transitions, &block)
+        @name = name
+        @block = block
+        @transitions = if transitions
+          Array(transitions).map(&:to_sym)
+        end
+      end
+
+      def call(obj)
+        obj.instance_eval(&@block) if @block
+      end
+
+      def valid_transition?(new_state)
+        # All transitions are allowed if none are expressly declared
+        !@transitions || @transitions.include?(new_state.to_sym)
+      end
+    end
+  end
+end

data/vendor/deps/listen/lib/listen/listener/config.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Listen
+  class Listener
+    class Config
+      DEFAULTS = {
+        # Listener options
+        debug: false, # TODO: is this broken?
+        wait_for_delay: nil, # NOTE: should be provided by adapter if possible
+        relative: false,
+
+        # Backend selecting options
+        force_polling: false,
+        polling_fallback_message: nil
+      }.freeze
+
+      def initialize(opts)
+        @options = DEFAULTS.merge(opts)
+        @relative = @options[:relative]
+        @min_delay_between_events = @options[:wait_for_delay]
+        @silencer_rules = @options # silencer will extract what it needs
+      end
+
+      def relative?
+        @relative
+      end
+
+      attr_reader :min_delay_between_events, :silencer_rules
+
+      def adapter_instance_options(klass)
+        valid_keys = klass.const_get('DEFAULTS').keys
+        Hash[@options.select { |key, _| valid_keys.include?(key) }]
+      end
+
+      def adapter_select_options
+        valid_keys = %w[force_polling polling_fallback_message].map(&:to_sym)
+        Hash[@options.select { |key, _| valid_keys.include?(key) }]
+      end
+    end
+  end
+end

data/vendor/deps/listen/lib/listen/listener.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+require 'English'
+
+require 'listen/version'
+
+require 'listen/backend'
+
+require 'listen/silencer'
+require 'listen/silencer/controller'
+
+require 'listen/queue_optimizer'
+
+require 'listen/fsm'
+
+require 'listen/event/loop'
+require 'listen/event/queue'
+require 'listen/event/config'
+
+require 'listen/listener/config'
+
+module Listen
+  class Listener
+    include Listen::FSM
+
+    # Initializes the directories listener.
+    #
+    # @param [String] directory the directories to listen to
+    # @param [Hash] options the listen options (see Listen::Listener::Options)
+    #
+    # @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
+    #
+    # rubocop:disable Metrics/MethodLength
+    def initialize(*dirs, &block)
+      options = dirs.last.is_a?(Hash) ? dirs.pop : {}
+
+      @config = Config.new(options)
+
+      eq_config = Event::Queue::Config.new(@config.relative?)
+      queue = Event::Queue.new(eq_config)
+
+      silencer = Silencer.new
+      rules = @config.silencer_rules
+      @silencer_controller = Silencer::Controller.new(silencer, rules)
+
+      @backend = Backend.new(dirs, queue, silencer, @config)
+
+      optimizer_config = QueueOptimizer::Config.new(@backend, silencer)
+
+      pconfig = Event::Config.new(
+        self,
+        queue,
+        QueueOptimizer.new(optimizer_config),
+        @backend.min_delay_between_events,
+        &block)
+
+      @processor = Event::Loop.new(pconfig)
+
+      initialize_fsm
+    end
+    # rubocop:enable Metrics/MethodLength
+
+    start_state :initializing
+
+    state :initializing, to: [:backend_started, :stopped]
+
+    state :backend_started, to: [:processing_events, :stopped] do
+      @backend.start
+    end
+
+    state :processing_events, to: [:paused, :stopped] do
+      @processor.start
+    end
+
+    state :paused, to: [:processing_events, :stopped] do
+      @processor.pause
+    end
+
+    state :stopped, to: [:backend_started] do
+      @backend.stop # halt events ASAP
+      @processor.stop
+    end
+
+    # Starts processing events and starts adapters
+    # or resumes invoking callbacks if paused
+    def start
+      case state
+      when :initializing
+        transition :backend_started
+        transition :processing_events
+      when :paused
+        transition :processing_events
+      else
+        raise ArgumentError, "cannot start from state #{state.inspect}"
+      end
+    end
+
+    # Stops both listening for events and processing them
+    def stop
+      transition :stopped
+    end
+
+    # Stops invoking callbacks (messages pile up)
+    def pause
+      transition :paused
+    end
+
+    # processing means callbacks are called
+    def processing?
+      state == :processing_events
+    end
+
+    def paused?
+      state == :paused
+    end
+
+    def stopped?
+      state == :stopped
+    end
+
+    def ignore(regexps)
+      @silencer_controller.append_ignores(regexps)
+    end
+
+    def ignore!(regexps)
+      @silencer_controller.replace_with_bang_ignores(regexps)
+    end
+
+    def only(regexps)
+      @silencer_controller.replace_with_only(regexps)
+    end
+  end
+end

data/vendor/deps/listen/lib/listen/logger.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Listen
+  @logger = nil
+
+  # Listen.logger will always be present.
+  # If you don't want logging, set Listen.logger = ::Logger.new('/dev/null', level: ::Logger::UNKNOWN)
+
+  @adapter_warn_behavior = :warn
+
+  class << self
+    attr_writer :logger
+    attr_accessor :adapter_warn_behavior
+
+    def logger
+      @logger ||= default_logger
+    end
+
+    def adapter_warn(message)
+      case ENV['LISTEN_GEM_ADAPTER_WARN_BEHAVIOR']&.to_sym || adapter_warn_behavior_callback(message)
+      when :log
+        logger.warn(message)
+      when :silent, nil, false
+        # do nothing
+      else # :warn
+        warn(message)
+      end
+    end
+
+    private
+
+    def default_logger
+      level =
+        case ENV['LISTEN_GEM_DEBUGGING'].to_s
+        when /debug|2/i
+          ::Logger::DEBUG
+        when /info|true|yes|1/i
+          ::Logger::INFO
+        when /warn/i
+          ::Logger::WARN
+        when /fatal/i
+          ::Logger::FATAL
+        else
+          ::Logger::ERROR
+        end
+
+      ::Logger.new(STDERR, level: level)
+    end
+
+    def adapter_warn_behavior_callback(message)
+      if adapter_warn_behavior.respond_to?(:call)
+        case behavior = adapter_warn_behavior.call(message)
+        when Symbol
+          behavior
+        when false, nil
+          :silent
+        else
+          :warn
+        end
+      else
+        adapter_warn_behavior
+      end
+    end
+  end
+end

data/vendor/deps/listen/lib/listen/monotonic_time.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Listen
+  module MonotonicTime
+    class << self
+      if defined?(Process::CLOCK_MONOTONIC)
+
+        def now
+          Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        end
+
+      elsif defined?(Process::CLOCK_MONOTONIC_RAW)
+
+        def now
+          Process.clock_gettime(Process::CLOCK_MONOTONIC_RAW)
+        end
+
+      else
+
+        def now
+          Time.now.to_f
+        end
+
+      end
+    end
+  end
+end

data/vendor/deps/listen/lib/listen/options.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Listen
+  class Options
+    def initialize(opts, defaults)
+      @options = {}
+      given_options = opts.dup
+      defaults.each_key do |key|
+        @options[key] = given_options.delete(key) || defaults[key]
+      end
+
+      given_options.empty? or raise ArgumentError, "Unknown options: #{given_options.inspect}"
+    end
+
+    def respond_to_missing?(name, *_)
+      @options.has_key?(name)
+    end
+
+    def method_missing(name, *_)
+      respond_to_missing?(name) or raise NameError, "Bad option: #{name.inspect} (valid:#{@options.keys.inspect})"
+      @options[name]
+    end
+  end
+end

data/vendor/deps/listen/lib/listen/queue_optimizer.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+module Listen
+  class QueueOptimizer
+    class Config
+      def initialize(adapter_class, silencer)
+        @adapter_class = adapter_class
+        @silencer = silencer
+      end
+
+      def exist?(path)
+        Pathname(path).exist?
+      end
+
+      def silenced?(path, type)
+        @silencer.silenced?(path, type)
+      end
+
+      def debug(*args, &block)
+        Listen.logger.debug(*args, &block)
+      end
+    end
+
+    def smoosh_changes(changes)
+      # TODO: adapter could be nil at this point (shutdown)
+      cookies = changes.group_by do |_, _, _, _, options|
+        (options || {})[:cookie]
+      end
+      _squash_changes(_reinterpret_related_changes(cookies))
+    end
+
+    def initialize(config)
+      @config = config
+    end
+
+    private
+
+    attr_reader :config
+
+    # groups changes into the expected structure expected by
+    # clients
+    def _squash_changes(changes)
+      # We combine here for backward compatibility
+      # Newer clients should receive dir and path separately
+      changes = changes.map { |change, dir, path| [change, dir + path] }
+
+      actions = changes.group_by(&:last).map do |path, action_list|
+        [_logical_action_for(path, action_list.map(&:first)), path.to_s]
+      end
+
+      config.debug("listen: raw changes: #{actions.inspect}")
+
+      { modified: [], added: [], removed: [] }.tap do |squashed|
+        actions.each do |type, path|
+          squashed[type] << path unless type.nil?
+        end
+        config.debug("listen: final changes: #{squashed.inspect}")
+      end
+    end
+
+    def _logical_action_for(path, actions)
+      actions << :added if actions.delete(:moved_to)
+      actions << :removed if actions.delete(:moved_from)
+
+      modified = actions.find { |x| x == :modified }
+      _calculate_add_remove_difference(actions, path, modified)
+    end
+
+    def _calculate_add_remove_difference(actions, path, default_if_exists)
+      added = actions.count { |x| x == :added }
+      removed = actions.count { |x| x == :removed }
+      diff = added - removed
+
+      # TODO: avoid checking if path exists and instead assume the events are
+      # in order (if last is :removed, it doesn't exist, etc.)
+      if config.exist?(path)
+        if diff > 0
+          :added
+        elsif diff.zero? && added > 0
+          :modified
+        else
+          default_if_exists
+        end
+      else
+        diff < 0 ? :removed : nil
+      end
+    end
+
+    # remove extraneous rb-inotify events, keeping them only if it's a possible
+    # editor rename() call (e.g. Kate and Sublime)
+    def _reinterpret_related_changes(cookies)
+      table = { moved_to: :added, moved_from: :removed }
+      cookies.flat_map do |_, changes|
+        if (editor_modified = editor_modified?(changes))
+          [[:modified, *editor_modified]]
+        else
+          not_silenced = changes.reject do |type, _, _, path, _|
+            config.silenced?(Pathname(path), type)
+          end
+          not_silenced.map do |_, change, dir, path, _|
+            [table.fetch(change, change), dir, path]
+          end
+        end
+      end
+    end
+
+    def editor_modified?(changes)
+      return unless changes.size == 2
+
+      from_type = from = nil
+      to_type = to_dir = to = nil
+
+      changes.each do |data|
+        case data[1]
+        when :moved_from
+          from_type, _from_change, _, from, = data
+        when :moved_to
+          to_type, _to_change, to_dir, to, = data
+        end
+      end
+
+      # Expect an ignored moved_from and non-ignored moved_to
+      # to qualify as an "editor modify"
+      if from && to && config.silenced?(Pathname(from), from_type) && !config.silenced?(Pathname(to), to_type)
+        [to_dir, to]
+      end
+    end
+  end
+end

data/vendor/deps/listen/lib/listen/record/entry.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Listen
+  # @private api
+  class Record
+    # Represents a directory entry (dir or file)
+    class Entry
+      # file: "/home/me/watched_dir", "app/models", "foo.rb"
+      # dir, "/home/me/watched_dir", "."
+      def initialize(root, relative, name = nil)
+        @root = root
+        @relative = relative
+        @name = name
+      end
+
+      attr_reader :root, :relative, :name
+
+      def children
+        child_relative = _join
+        (_entries(sys_path) - %w[. ..]).map do |name|
+          Entry.new(@root, child_relative, name)
+        end
+      end
+
+      def meta
+        lstat = ::File.lstat(sys_path)
+        { mtime: lstat.mtime.to_f, mode: lstat.mode, size: lstat.size }
+      end
+
+      # record hash is e.g.
+      # if @record["/home/me/watched_dir"]["project/app/models"]["foo.rb"]
+      # if @record["/home/me/watched_dir"]["project/app"]["models"]
+      # record_dir_key is "project/app/models"
+      def record_dir_key
+        ::File.join(*[@relative, @name].compact)
+      end
+
+      def sys_path
+        # Use full path in case someone uses chdir
+        ::File.join(*[@root, @relative, @name].compact)
+      end
+
+      def real_path
+        @real_path ||= ::File.realpath(sys_path)
+      end
+
+      private
+
+      def _join
+        args = [@relative, @name].compact
+        args.empty? ? nil : ::File.join(*args)
+      end
+
+      def _entries(dir)
+        return Dir.entries(dir) unless RUBY_ENGINE == 'jruby'
+
+        # JRuby inconsistency workaround, see:
+        # https://github.com/jruby/jruby/issues/3840
+        exists = ::File.exist?(dir)
+        directory = ::File.directory?(dir)
+        return Dir.entries(dir) unless exists && !directory
+        raise Errno::ENOTDIR, dir
+      end
+    end
+  end
+end

data/vendor/deps/listen/lib/listen/record/symlink_detector.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'set'
+require 'listen/error'
+
+module Listen
+  # @private api
+  class Record
+    class SymlinkDetector
+      README_URL = 'https://github.com/guard/listen/blob/master/README.md'
+
+      SYMLINK_LOOP_ERROR = <<-EOS.freeze
+        ** ERROR: directory is already being watched! **
+
+        Directory: %s
+
+        is already being watched through: %s
+
+        MORE INFO: #{README_URL}
+      EOS
+
+      Error = ::Listen::Error # for backward compatibility
+
+      def initialize
+        @real_dirs = Set.new
+      end
+
+      def verify_unwatched!(entry)
+        real_path = entry.real_path
+        @real_dirs.add?(real_path) or _fail(entry.sys_path, real_path)
+      end
+
+      # Leaving this stub here since some warning work-arounds were referring to it.
+      # Deprecated. Will be removed in Listen v4.0.
+      def warn(message)
+        Listen.adapter_warn(message)
+      end
+
+      private
+
+      def _fail(symlinked, real_path)
+        warn(format(SYMLINK_LOOP_ERROR, symlinked, real_path))
+        raise ::Listen::Error::SymlinkLoop, 'Failed due to looped symlinks'
+      end
+    end
+  end
+end