Adds a configurable Cuprite driver (#327)

Author: zedtux

README.md

@@ -65,6 +65,7 @@ Capybara.javascript_driver = :selenium_billy # Uses Firefox
 # Capybara.javascript_driver = :apparition_billy
 # Capybara.javascript_driver = :webkit_billy
 # Capybara.javascript_driver = :poltergeist_billy
+# Capybara.javascript_driver = :cuprite_billy
 ```
 
 > __Note__: `:poltergeist_billy` doesn't support proxying any localhosts, so you must use
@@ -154,6 +155,20 @@ And /^a stub for google$/ do
 end
 ```
 
+### Setup remote Chrome
+
+In the case you are using a Chrome instance, running on another machine, or in
+another Docker container, you need to :
+* Fix the Billy proxy host and port
+* Passes the `--proxy-server=<billy host>:<billy port>`
+
+#### WebSockets
+
+Puffing billy doesn't support websockets, so if you are using them,
+or ActionCable for the Ruby On Rails developers, you can tell Chrome to bypass
+the proxy for websockets by adding the flag `--proxy-bypass-list=ws://*` to
+your remote chrome intance or Docker container.
+
 ## Minitest Usage
 
 Please see [this link](https://gist.github.com/sauy7/1b081266dd453a1b737b) for

lib/billy/browsers/capybara.rb

@@ -8,7 +8,8 @@ class Capybara
         poltergeist: 'capybara/poltergeist',
         webkit: 'capybara/webkit',
         selenium: 'selenium/webdriver',
-        apparition: 'capybara/apparition'
+        apparition: 'capybara/apparition',
+        cuprite: 'capybara/cuprite'
       }
 
       def self.register_drivers
@@ -108,6 +109,20 @@ def self.register_apparition_driver
         end
       end
 
+      def self.register_cuprite_driver
+        driver_otions = {
+          browser_options: {
+            'ignore-certificate-errors' => nil
+          }
+        }.deep_merge(Billy.config.cuprite_options)
+
+        ::Capybara.register_driver :cuprite_billy do |app|
+          ::Capybara::Cuprite::Driver.new(app, **driver_otions).tap do |driver|
+            driver.set_proxy(Billy.proxy.host, Billy.proxy.port)
+          end
+        end
+      end
+
       def self.build_selenium_options_for_firefox
         profile = Selenium::WebDriver::Firefox::Profile.new.tap do |prof|
           prof.proxy = Selenium::WebDriver::Proxy.new(

lib/billy/config.rb

@@ -11,7 +11,8 @@ class Config
                   :non_whitelisted_requests_disabled, :cache_path, :certs_path, :verify_peer, :proxy_host, :proxy_port, :proxied_request_inactivity_timeout,
                   :proxied_request_connect_timeout, :dynamic_jsonp, :dynamic_jsonp_keys, :dynamic_jsonp_callback_name, :merge_cached_responses_whitelist,
                   :strip_query_params, :proxied_request_host, :proxied_request_port, :cache_request_body_methods, :after_cache_handles_request,
-                  :cache_simulates_network_delays, :cache_simulates_network_delay_time, :record_requests, :record_stub_requests, :use_ignore_params, :before_handle_request
+                  :cache_simulates_network_delays, :cache_simulates_network_delay_time, :record_requests, :record_stub_requests, :use_ignore_params,
+                  :before_handle_request, :cuprite_options
 
     def initialize
       @logger = defined?(Rails) ? Rails.logger : Logger.new(STDOUT)
@@ -53,6 +54,7 @@ def reset
       @record_stub_requests = false
       @use_ignore_params = true
       @before_handle_request = nil
+      @cuprite_options = {}
     end
   end