crabfarm 0.3.7 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ad185f84ecb0857bf55e397bb916a06ed1ce517d
-  data.tar.gz: c8dd7033848c5a08faeb1288ba4c58badca49198
+  metadata.gz: 808bde80c9b692ad1a374508c17848f8ccaef0a3
+  data.tar.gz: e5d400990eefba3b89b3945f3126bd2de2d34973
 SHA512:
-  metadata.gz: 544192f9a8d76b3889cbe224bd77cd7077873fb3ba1bdaed580859157804d858e333dae9e3554db151e7a87ada38ae2bbdc052415143bbcada6c0d158eb70ee1
-  data.tar.gz: 57312038cb61f112eacadeb7b91344b134f2bc1450f7615b1deb459410b8af01250a0a30e17371e548470dc3c21566234e3ef384570b06c14badfedf18fd2fe6
+  metadata.gz: 3ff92d32566d149d45fe91660548448ca66f350a55603696cc21b2cc9e72568e539ebb503c4466cf0ecba4cb37e1e60497e988033b9bd56aae3a79cf5841e5b1
+  data.tar.gz: 0442673d0120a6883c493ebc93fe92d2d95ae02e86422503bb8bc91cb50cd7d422b77de3bb1136b84bafdef7c3b415f147e7ac8ca288af862bb4c690eab63f8a

data/lib/crabfarm.rb

@@ -26,6 +26,12 @@ module Crabfarm
 
   @@config = Configuration.new
   @@logger = nil
+  @@live = nil
+  @@debug = false
+
+  def self.root
+    File.dirname __dir__
+  end
 
   def self.config
     @@config
@@ -43,6 +49,28 @@ module Crabfarm
     @@config.instance_eval File.read _path
   end
 
+  def self.install_live_backend!
+    require "crabfarm/live/manager"
+    @@live = Live::Manager.new
+  end
+
+  def self.live
+    @@live
+  end
+
+  def self.live?
+    not @@live.nil?
+  end
+
+  def self.enable_debugging!
+    require 'pry-byebug'
+    @@debug = true
+  end
+
+  def self.debug?
+    @@debug
+  end
+
   module Strategies
     # bundled browser adapters
     register :browser, :phantomjs, 'Crabfarm::Adapters::Browser::PhantomJs', dependencies: ['selenium-webdriver']

data/lib/crabfarm/adapters/browser/abstract_webdriver.rb

@@ -19,11 +19,17 @@ module Crabfarm
         end
 
         def build_driver(_session_id)
-          return wrap_driver build_webdriver_instance
+          wrap_driver(if Crabfarm.live?
+            build_live_instance _session_id
+          else
+            build_webdriver_instance
+          end)
         end
 
-        def release_driver(_driver)
-          _driver.quit rescue nil
+        def release_driver(_session_id, _driver)
+          unless Crabfarm.live? and _session_id == :default_driver
+            _driver.driver.quit rescue nil
+          end
         end
 
       private
@@ -38,6 +44,14 @@ module Crabfarm
           raise NotImplementedError.new
         end
 
+        def build_live_instance(_session_id)
+          if _session_id == :default_driver
+            Crabfarm.live.primary_driver
+          else
+            Crabfarm.live.generate_support_driver
+          end
+        end
+
         def load_driver_config
           {
             capabilities: Crabfarm.config.webdriver_capabilities,

data/lib/crabfarm/adapters/browser/phantom_js.rb

@@ -8,7 +8,7 @@ module Crabfarm
       class PhantomJs < AbstractWebdriver
 
         def prepare_driver_services
-          @phantom = load_and_start_phantom if @phantom.nil?
+          @phantom = load_and_start_phantom if @phantom.nil? and not Crabfarm.live?
         end
 
         def cleanup_driver_services

data/lib/crabfarm/adapters/driver_wrapper/watir.rb

@@ -2,18 +2,31 @@ class Watir::Browser
   def to_html
     html
   end
+
+  def webdriver_elements
+    []
+  end
 end
 
 class Watir::Element
   def to_html
     html
   end
+
+  def webdriver_elements
+    if @element then [@element] else [] end
+  end
+
 end
 
 class Watir::ElementCollection
   def to_html
     self.map(&:html).join
   end
+
+  def webdriver_elements
+    elements
+  end
 end
 
 module Crabfarm

data/lib/crabfarm/base.rb

@@ -0,0 +1,9 @@
+module Crabfarm
+  module Base
+
+    def debugger
+      binding.pry if Crabfarm.debug?
+    end
+
+  end
+end

data/lib/crabfarm/base_navigator.rb

@@ -1,10 +1,14 @@
 require 'thwait'
+require 'crabfarm/base'
+require 'crabfarm/assertion/context'
+require 'crabfarm/live/interactable'
 require 'crabfarm/forked_navigator'
-require "crabfarm/assertion/context"
 
 module Crabfarm
   class BaseNavigator
+    include Base
     include Assertion::Context
+    include Live::Interactable
     extend Forwardable
 
     attr_reader :params

data/lib/crabfarm/base_reducer.rb

@@ -1,8 +1,12 @@
-require "crabfarm/assertion/fields"
+require 'crabfarm/base'
+require 'crabfarm/assertion/fields'
+require 'crabfarm/live/interactable'
 
 module Crabfarm
   class BaseReducer < Delegator
+    include Base
     include Assertion::Fields
+    include Live::Interactable
 
     attr_reader :raw_document, :document, :params
 

data/lib/crabfarm/base_struct.rb

@@ -1,7 +1,9 @@
-require "crabfarm/assertion/fields"
+require 'crabfarm/base'
+require 'crabfarm/assertion/context'
 
 module Crabfarm
   class BaseStruct
+    include Base
     include Assertion::Fields
 
     def initialize(_values={})
@@ -13,5 +15,9 @@ module Crabfarm
       field_hash
     end
 
+    def to_json(_options={})
+      field_hash.to_json(_options)
+    end
+
   end
 end

data/lib/crabfarm/cli.rb

@@ -27,6 +27,16 @@ module Crabfarm
       end
     end
 
+    desc "Starts the crawler in live mode"
+    command [:live, :i] do |c|
+      c.action do |global_options,options,args|
+        next puts "This command can only be ran inside a crabfarm application" unless GlobalState.inside_crawler_app?
+
+        require "crabfarm/modes/live"
+        Crabfarm::Modes::Live.start_watch
+      end
+    end
+
     desc "Starts the crawler in server mode"
     command [:server, :s] do |c|
       c.desc "Set the server host, defaults to 0.0.0.0"

data/lib/crabfarm/configuration.rb

@@ -65,7 +65,7 @@ module Crabfarm
         phantom_ssl: 'any',
         phantom_bin_path: 'phantomjs',
         crabtrap_bin_path: 'crabtrap',
-        recorder_driver: :chrome
+        recorder_driver: :firefox
       }
     end
 

data/lib/crabfarm/crabtrap_context.rb

@@ -72,7 +72,7 @@ module Crabfarm
 
     def stop_daemon
       unless @runner.nil?
-        @runner.stop
+        @runner.kill
         @runner = nil
       else nil end
     end

data/lib/crabfarm/crabtrap_runner.rb

@@ -38,6 +38,15 @@ module Crabfarm
       end
     end
 
+    def kill
+      unless @process.nil?
+        logger.info "Killing crabtrap (PID: #{@process.pid})"
+        @process.stop 0
+        @process = nil
+        logger.info "Crabtrap stopped"
+      end
+    end
+
   private
 
     def spawn_crabtrap
@@ -59,6 +68,7 @@ module Crabfarm
       cmd << mode.to_s
       cmd << @config[:bucket_path] if mode != :pass
       cmd << "--port=#{port}"
+      cmd << "--virtual=#{@config[:virtual]}" if @config.key? :virtual
       cmd
     end
 

data/lib/crabfarm/driver_pool.rb

@@ -15,12 +15,12 @@ module Crabfarm
 
     def reset(_session_id=nil)
       if _session_id.nil?
-        @drivers.values.each { |d| @factory.release_driver d }
+        @drivers.each { |k, d| @factory.release_driver(k, d) }
         @drivers = Hash.new
       else
         _session_id = _session_id.to_sym
         driver = @drivers.delete _session_id
-        @factory.release_driver driver unless driver.nil?
+        @factory.release_driver(_session_id, driver) unless driver.nil?
       end
     end
 

data/lib/crabfarm/dsl/surfer/search_context.rb

@@ -16,6 +16,10 @@ module Crabfarm
           @parent = _parent
         end
 
+        def webdriver_elements
+          @elements
+        end
+
         def root
           @parent.root
         end

data/lib/crabfarm/http_client.rb

@@ -25,7 +25,10 @@ module Crabfarm
     attr_reader :proxy_addr, :proxy_port
 
     def initialize(_proxy=nil)
-      if _proxy.nil?
+      if Crabfarm.live?
+        @proxy_addr = '127.0.0.1'
+        @proxy_port = Crabfarm.live.proxy_port
+      elsif _proxy.nil?
         @proxy_addr = nil
         @proxy_port = nil
       else

data/lib/crabfarm/live/controller.rb

@@ -0,0 +1,127 @@
+require 'benchmark'
+require 'rainbow'
+require 'rainbow/ext/string'
+require 'crabfarm/modes/console'
+
+require 'crabfarm/support/webdriver_factory'
+require 'crabfarm/crabtrap_runner'
+
+require 'crabfarm/live/helpers.rb'
+require 'crabfarm/live/navigator_runner.rb'
+require 'crabfarm/live/reducer_runner.rb'
+
+module Crabfarm
+  module Live
+    class Controller
+
+      Colors = Crabfarm::Modes::Console::Colors
+
+      class LiveWarning < StandardError; end
+
+      def initialize(_manager)
+        @manager = _manager
+      end
+
+      def execute_live(_class)
+        begin
+          runner = build_runner_for _class
+          prepare_session_for runner
+          elapsed = Benchmark.measure { runner.execute }
+          display_feedback runner, elapsed
+        rescue LiveWarning => exc
+          display_warning_feedback exc
+        rescue Exception => exc
+          display_error_feedback exc
+        ensure
+          clean_up_session
+        end
+      end
+
+    private
+
+      def build_runner_for(_class)
+        raise LiveWarning.new "'#{_class.to_s} is not Interactable" unless _class < Interactable
+
+        puts "Launching #{_class.to_s}".color Colors::NOTICE
+
+        runner = if _class.live_delegate
+          build_runner_for _class.live_delegate
+        else
+          if _class < BaseNavigator
+            NavigatorRunner
+          elsif _class < BaseReducer
+            ReducerRunner
+          else
+            raise LiveWarning.new "Don't know how to run #{_class.to_s}, you should provide a navigator or reducer as delegate."
+          end.new _class
+        end
+
+        runner.dsl.instance_eval(&_class.live_setup) if _class.live_setup
+        runner
+      end
+
+      def prepare_session_for(_runner)
+        @manager.stop_crabtrap
+        if _runner.memento
+          @manager.start_crabtrap :replay, memento_path(_runner.memento)
+        else
+          @manager.start_crabtrap :pass
+        end
+      end
+
+      def clean_up_session
+        # leave crabtrap running for debugging purposes.
+      end
+
+      def display_feedback(_runner, _elapsed)
+        load_web_ui
+
+        @manager.primary_driver.execute_script(
+          "window.crabfarm.showResults(arguments[0], arguments[1]);",
+          _runner.output,
+          _elapsed.real
+        );
+
+        puts _runner.output.to_s.color Colors::RESULT
+        puts "Completed in #{_elapsed.real} s".color Colors::NOTICE
+      end
+
+      def display_error_feedback(_exc)
+        load_web_ui
+
+        @manager.primary_driver.execute_script(
+          "window.crabfarm.showError(arguments[0], arguments[1]);",
+          "#{_exc.class.to_s}: #{_exc.to_s}",
+          _exc.backtrace.join("\n")
+        );
+
+        puts "#{_exc.class.to_s}: #{_exc.to_s}".color Colors::ERROR
+        puts _exc.backtrace
+      end
+
+      def display_warning_feedback(_exc)
+        load_web_ui
+        puts "Warning: #{_exc.to_s}".color Colors::WARNING
+      end
+
+      def load_web_ui
+        Helpers.inject_style @manager.primary_driver, 'https://www.crabtrap.io/selectorgadget_combined.css'
+        Helpers.inject_style @manager.primary_driver, 'https://www.crabtrap.io/tools.css'
+        Helpers.inject_script @manager.primary_driver, 'https://www.crabtrap.io/selectorgadget_combined.js'
+        Helpers.inject_script @manager.primary_driver, 'https://www.crabtrap.io/tools.js'
+        wait_for_injection
+      end
+
+      def wait_for_injection
+        while @manager.primary_driver.execute_script "return (typeof window.crabfarm === 'undefined');"
+          sleep 1.0
+        end
+      end
+
+      def memento_path(_name)
+        File.join(GlobalState.mementos_path, _name + '.json.gz')
+      end
+
+    end
+  end
+end

data/lib/crabfarm/live/helpers.rb

@@ -0,0 +1,42 @@
+module Crabfarm
+  module Live
+    module Helpers
+      extend self
+
+      def inject_script(_driver, _path)
+        _driver.execute_script("
+          (function() {
+            var script = document.createElement('script');
+            script.async = false;
+            script.src = '#{_path}';
+            document.head.appendChild(script);
+          })();
+        ")
+      end
+
+      def inject_style(_driver, _path)
+        _driver.execute_script("
+          (function() {
+            var link  = document.createElement('link');
+            link.setAttribute('rel','stylesheet');
+            link.setAttribute('type','text/css');
+            link.setAttribute('href','#{_path}');
+            link.setAttribute('media','all');
+            document.head.appendChild(link);
+          })();
+        ")
+      end
+
+      def set_style(_elements, _style)
+        return if _elements.size == 0
+        # Not sure about using a bridge method directly here...
+        _elements.first.send(:bridge).executeScript("
+          for(var i = 0, l = arguments[0].length; i < l; i++) {
+            arguments[0][i].setAttribute('style', arguments[1]);
+          }
+        ", _elements, _style)
+      end
+
+    end
+  end
+end

data/lib/crabfarm/live/interactable.rb

@@ -0,0 +1,46 @@
+require 'crabfarm/live/helpers'
+
+module Crabfarm
+  module Live
+    module Interactable
+
+      def self.included(klass)
+        klass.extend ClassMethods
+      end
+
+      module ClassMethods
+
+        def live(_options={}, &_setup)
+          @delegate = _options[:delegate]
+          @setup = _setup
+        end
+
+        def live_delegate
+          @delegate
+        end
+
+        def live_setup
+          @setup
+        end
+
+      end
+
+      # Tooling
+
+      def highlight(_elements)
+        if Crabfarm.live?
+          if _elements.respond_to? :webdriver_elements
+            _elements = _elements.webdriver_elements
+          end
+
+          if _elements.is_a? String
+            _elements = Crabfarm.live.primary_driver.find_elements(css: _elements)
+          end
+
+          Helpers.set_style _elements, "border: 3px solid yellow;"
+        end
+      end
+
+    end
+  end
+end

data/lib/crabfarm/live/manager.rb

@@ -0,0 +1,90 @@
+require 'crabfarm/support/webdriver_factory'
+require 'crabfarm/crabtrap_runner'
+
+module Crabfarm
+  module Live
+    class Manager
+
+      def initialize
+        @port = Utils::PortDiscovery.find_available_port
+        @driver = Crabfarm.config.recorder_driver
+      end
+
+      def proxy_port
+        @port
+      end
+
+      def start
+        load_primary_driver
+      end
+
+      def stop
+        stop_crabtrap
+        release_primary_driver
+      end
+
+      def primary_driver
+        @driver
+      end
+
+      def generate_support_driver
+        # TODO: improve on this mechanics, maybe use a frame in the same driver for this
+        build_driver
+      end
+
+      def start_crabtrap(_mode, _memento_path=nil)
+
+        raise ConfigurationError.new "No memento found at #{_memento_path}" unless File.exists? _memento_path
+
+        if @crabtrap.nil?
+          options = {
+            mode: _mode,
+            bucket_path: _memento_path,
+            port: @port,
+            virtual: File.expand_path('./assets/live-tools', Crabfarm.root)
+          }
+
+          @crabtrap = CrabtrapRunner.new config.crabtrap_config.merge(options)
+          @crabtrap.start
+        end
+      end
+
+      def stop_crabtrap
+        unless @crabtrap.nil?
+          @crabtrap.kill
+          @crabtrap = nil
+        else nil end
+      end
+
+    private
+
+      def load_primary_driver
+        @driver = build_driver
+      end
+
+      def release_primary_driver
+        @driver.quit rescue nil unless @driver.nil?
+      end
+
+      def build_driver
+        case @driver
+        when :firefox
+          Crabfarm::Support::WebdriverFactory.build_firefox_driver driver_config
+        when :chrome
+          Crabfarm::Support::WebdriverFactory.build_chrome_driver driver_config
+        else return nil end
+      end
+
+      def driver_config
+        {
+          proxy: "127.0.0.1:#{@port}"
+        }
+      end
+
+      def config
+        Crabfarm.config
+      end
+
+    end
+  end
+end

data/lib/crabfarm/live/navigator_runner.rb

@@ -0,0 +1,68 @@
+require 'json'
+
+module Crabfarm
+  module Live
+    class NavigatorRunner
+
+      class Dsl
+        extend Forwardable
+
+        def initialize(_runner)
+          @runner = _runner
+        end
+
+        def_delegators :@runner, :use_memento, :use_params, :clear_params, :navigate_to
+      end
+
+      def initialize(_target)
+        @target = _target
+        @params = {}
+      end
+
+      def dsl
+        @dsl ||= Dsl.new self
+      end
+
+      def memento
+        if @memento.nil? then memento_for(@target) else @memento end
+      end
+
+      def use_memento(_memento)
+        @memento = _memento
+      end
+
+      def use_params(_params={})
+        @params = @params.merge _params
+      end
+
+      def clear_params
+        @params = {}
+      end
+
+      def navigate_to(_navigator, _params={})
+      end
+
+      def execute
+        context = Crabfarm::Context.new
+        begin
+          # TODO: execute prerequisites
+          @transition = TransitionService.transition context, @target, @params
+        ensure
+          context.release
+        end
+      end
+
+      def output
+        return nil if @transition.document.nil?
+        JSON.pretty_generate(@transition.document).gsub(/(^|\\n)/, '  ')
+      end
+
+    private
+
+      def memento_for(_class)
+        Utils::Naming.route_from_constant(_class.to_s).join(File::SEPARATOR)
+      end
+
+    end
+  end
+end

data/lib/crabfarm/live/reducer_runner.rb

@@ -0,0 +1,22 @@
+module Crabfarm
+  module Live
+    class ReducerRunner < NavigatorRunner
+
+      def initialize(_target)
+        # use navigator runner for now.
+        super navigator_from_reducer _target
+      end
+
+      def navigator_from_reducer _reducer
+        m = _reducer.to_s.match(/^(.*?)Reducer$/)
+        if m
+          navigator = m[1].constantize rescue nil
+          return navigator if navigator and navigator < BaseNavigator
+        end
+
+        raise Controller::LiveWarning.new "Could not find a matching navigator for reducer #{_reducer.to_s}"
+      end
+
+    end
+  end
+end

data/lib/crabfarm/live/watcher.rb

@@ -0,0 +1,67 @@
+require 'listen'
+
+module Crabfarm
+  module Live
+    class Watcher
+
+      PATH_RGX = /^\/[^\/]+\/(.*?)\.rb$/i
+
+      def initialize(_controller)
+        @controller = _controller
+        @candidates = nil
+      end
+
+      def watch(_sleep)
+        begin
+          start_listener
+          loop do
+            execute_pending
+            sleep _sleep
+          end
+        ensure
+          stop_listener
+        end
+      end
+
+    private
+
+      def start_listener
+        base_path = File.join CF_PATH, 'app'
+        @listener = Listen.to(base_path) do |modified, added, removed|
+          @candidates = (added + modified).map do |path|
+            class_from_path path[base_path.length..-1]
+          end.reject &:nil?
+        end
+        @listener.start
+      end
+
+      def stop_listener
+        @listener.stop if @listener
+      end
+
+      def execute_pending
+        unless @candidates.nil?
+          ActiveSupport::Dependencies.clear
+          @candidates.each do |class_name|
+            target = class_name.constantize rescue nil
+            if target and target < Crabfarm::Live::Interactable
+              @controller.execute_live target
+              break
+            end
+          end
+
+          @candidates = nil
+        end
+      end
+
+      def class_from_path(_filename)
+        _filename = _filename.gsub File::SEPARATOR, '/'
+        m = _filename.match PATH_RGX
+        return nil if m.nil?
+        Utils::Naming.decode_crabfarm_uri m[1]
+      end
+
+    end
+
+  end
+end

data/lib/crabfarm/modes/live.rb

@@ -0,0 +1,32 @@
+require 'crabfarm/live/watcher'
+require 'crabfarm/live/controller'
+
+module Crabfarm
+  module Modes
+    module Live
+      extend self
+
+      def start_watch
+        begin
+          Crabfarm.enable_debugging!
+          Crabfarm.install_live_backend!
+          Crabfarm.live.start
+
+          controller = Crabfarm::Live::Controller.new Crabfarm.live
+          watcher = Crabfarm::Live::Watcher.new controller
+          watcher.watch 0.2
+
+        rescue SystemExit, Interrupt
+          # nothing
+        rescue Exception => e
+          puts "Fatal error: #{e.to_s}".color Console::Colors::ERROR
+          puts e.backtrace
+        ensure
+          puts 'Exiting'
+          Crabfarm.live.stop rescue nil
+        end
+      end
+
+    end
+  end
+end

data/lib/crabfarm/modes/recorder/memento.rb

@@ -28,11 +28,12 @@ module Crabfarm
             begin
               puts "Press Ctrl-C or close browser to stop #{_replay ? 'playback' : 'capturing'}."
               loop do
-                driver.current_url
+                driver.window_handle
                 sleep 1.0
               end
             rescue Exception => e
-              # noop
+              puts e
+              puts e.backtrace
             end
 
             puts "Releasing crawling context".color(:green)

data/lib/crabfarm/version.rb

@@ -1,3 +1,3 @@
 module Crabfarm
-  VERSION = "0.3.7"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: crabfarm
 version: !ruby/object:Gem::Version
-  version: 0.3.7
+  version: 0.4.0
 platform: ruby
 authors:
 - Ignacio Baixas
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-20 00:00:00.000000000 Z
+date: 2015-05-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -128,6 +128,34 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.5.5
+- !ruby/object:Gem::Dependency
+  name: listen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
   requirement: !ruby/object:Gem::Requirement
@@ -390,6 +418,7 @@ files:
 - lib/crabfarm/assertion/parsers.rb
 - lib/crabfarm/assertion/validations.rb
 - lib/crabfarm/assertion/wrapper.rb
+- lib/crabfarm/base.rb
 - lib/crabfarm/base_navigator.rb
 - lib/crabfarm/base_reducer.rb
 - lib/crabfarm/base_struct.rb
@@ -409,8 +438,16 @@ files:
 - lib/crabfarm/forked_navigator.rb
 - lib/crabfarm/global_state.rb
 - lib/crabfarm/http_client.rb
+- lib/crabfarm/live/controller.rb
+- lib/crabfarm/live/helpers.rb
+- lib/crabfarm/live/interactable.rb
+- lib/crabfarm/live/manager.rb
+- lib/crabfarm/live/navigator_runner.rb
+- lib/crabfarm/live/reducer_runner.rb
+- lib/crabfarm/live/watcher.rb
 - lib/crabfarm/modes/console.rb
 - lib/crabfarm/modes/generator.rb
+- lib/crabfarm/modes/live.rb
 - lib/crabfarm/modes/publisher.rb
 - lib/crabfarm/modes/recorder/memento.rb
 - lib/crabfarm/modes/recorder/snapshot.rb