rails-prg 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1b012c70c0e0c73ddad3f874e4e9da3530fa5ee4
-  data.tar.gz: b0ff3de2236d99c9df5806101d3d5761fd134da3
+  metadata.gz: 7001387315853fd2a5f4ed982d38bce8624e1d50
+  data.tar.gz: 64f20b19d5805a5c45b8333d7f82d6a169cd8f3f
 SHA512:
-  metadata.gz: 6bc32193437e830f0120fcb49e1b2140b45b2918b248777515e13aec01fc808e22b1dbe03e190b704050db46e70b1e162d807481ce6d1d7b0540b75cb846cff7
-  data.tar.gz: 3928df8b355fe672b452f3dd5a1a7f0fc5682ab67410776e7ea15468f29e98a535ec48f31033892658499a5f7c368e2ed4bbdaccbfa5ebf610db4668ba2155d9
+  metadata.gz: 75d6312e398a2622088b814ae631ab30c823fac238d3d5a2c4038b3f285f3e64b8bb524f7b15394bfbf86233dfc49f12ec9ca6ca83b07ef175dde59b453b208c
+  data.tar.gz: 39f636a5e8e9e7227b6114c00ab20ddd5fdbcf8bbf94e1f3093b5f04fddea9ce54fb782d04d9d06fa5705d77c8c229888919e8166b3d1f2c2e75ae6db100d448

data/.gitignore

@@ -1,3 +1,4 @@
+.env
 *.gem
 *.rbc
 .bundle
@@ -15,5 +16,7 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
+sauce_connect.log*
+sauce_connect.ready
 spec/dummy/log
 spec/dummy/db/*.sqlite3

data/.travis.yml

@@ -0,0 +1,18 @@
+language: ruby
+rvm:
+  - 2.1.0
+
+addons:
+  sauce_connect:
+    username: rails-prg
+    access_key:
+      secure: "gN4mKYJjPHGM8L8xl5hEE0mlQ9u1V8AZJlxCPavg7EBe6324FZe6uvN6upuBTr1KCQ1NGUBbzUwurmVAracHxnm3Ctg4gOXSs69e+bGxx1GKQRDHyMYr9+nKrWPML8HtlR2HwS2njDtUZ/q8WMwBQxP4yUwZ8wjueB0yDGVkxXc="
+
+before_install:
+  - uname -a
+  - "export USE_SAUCE=true"
+  - "export DISPLAY=:99.0"
+  - "sh -e /etc/init.d/xvfb start"
+
+script:
+  - ./script/spec

data/README.md

@@ -1,6 +1,38 @@
-# Rails::Prg
+# Rails::Prg (post-redirect-get)
 
-TODO: Write a gem description
+[![Build Status](https://travis-ci.org/tommeier/rails-prg.png)](https://travis-ci.org/tommeier/rails-prg)
+[![Selenium Test Status](https://saucelabs.com/buildstatus/rails-prg)](https://saucelabs.com/u/rails-prg)
+[![Selenium Test Status](https://saucelabs.com/browser-matrix/rails-prg.svg)](https://saucelabs.com/u/rails-prg)
+
+Secure applications disable browser history and internal cache. Unfortunately, this causes problems with most browsers when following the standard Rails pattern for displaying errors.
+
+We never really see an issue as Rails developers because we usually allow browser-history and internal store. This gem is ***only*** required when `no-cache, no-store` is applied in your headers for a secure application.
+
+Standard Rails method for error handling:
+  * POST form
+  * Error generated -> Render same action
+  * POST form
+  * No errors -> Redirect to successful action
+
+At this point, and the back button is pressed; each browser handles it slightly differently. Firefox skips back two pages in the history with new content and no error, and chrome skips back one, and displays the previous content (with error).
+
+In a secure application, browsers are unable to determine the content from the internal cache and raise an error. Example from Chrome when clicking back button after successful redirect raises an `ERR_CACHE_MISS`:
+
+![Example of Chrome ERR_CACHE_MISS](https://f.cloud.github.com/assets/19973/2430174/318aa678-acc0-11e3-9bf8-0535d51a2fac.png)
+
+For full protection from ERR_CACHE_MISS, and equivalent in other browsers, the pattern should be altered to follow a full POST-REDIRECT-GET patten.
+
+Full Post-Redirect-Get pattern:
+  * POST form
+  * Error generated -> ***redirect*** back displaying errors
+  * POST form
+  * No errors -> Redirect to successful action
+
+This way the browser will always have a consistent back-button history to traverse without
+triggering browser errors. This error can also be triggered by:
+  * Browser crashing (and attempting restore)
+  * Abnormal closure of browser such as power cutting out (and attempting restore)
+  * 'Restore' last session
 
 ## Installation
 
@@ -18,27 +50,145 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+The standard controller method for Rails (in a changing action like Create/Update) would look like:
+
+```
+def update
+  if @object.save
+    flash[:notice] = 'Huzzah - I was successful!'
+    redirect_to objects_path
+  else
+    flash[:error] = 'Oh no - saving failed'
+
+    render :edit
+  end
+end
+```
+
+To enable full Post-Redirect-Get for errors, the object has to be reinitialized after the redirect with both the set params and the new errors via the flash object (one request only). For security reasons, this will raise errors unless `permitted` params are passed for the redirect (see [strong parameters](http://api.rubyonrails.org/classes/ActionController/Parameters.html)).
+
+Using `Rails-Prg` and to implement full POST-REDIRECT-GET this action (and any other change action such as `create`) should be changed to the following.
+
+Example with filters:
+
+```
+before_filter :load_object, only: [:edit, :update]
+before_filter :load_redirected_objects!, only: [:edit]
+
+def update
+  if @object.save
+    flash[:notice] = 'Huzzah - I was successful!'
+    redirect_to objects_path
+  else
+    set_redirected_object!('@object', @object, clean_params) # Pass errors
+    redirect_to edit_object_path(@object)                    # Redirect back
+  end
+end
+```
+
+On redirection to the edit page the filter `set_redirected_object!` will assign any params passed on to the object (by submission) and any errors present in the flash object to act as normal, as if it was simply rendered on the previous page.
+
+Example without filters:
+
+```
+def new
+  @object = Object.new
+  load_redirected_objects!
+end
+
+def create
+  @object = Object.new(params[:object])
+
+  if @object.save
+    flash[:notice] = 'Huzzah - I was created!'
+    redirect_to objects_path
+  else
+    set_redirected_object!('@object', @object, safe_params)  # Pass errors
+    redirect_to new_object_path                              # Redirect back
+  end
+end
+```
+
+This strategy also has the benefit of being completely uniform across all browsers in behaviour. Before, for instance, Chrome ended on a different page to Firefox when clicking back (one skips a page in history and goes further back, chrome displays with the errors instead).
+
+
+## Further explanation
+
+The way Rails `render`s an error instead of redirecting, is completely expected and normal. The primary reason is for performance, no additional HTTP hit required, and the object is already loaded (with errors). Pretty much every framework has a similar strategy. In fact, you can duplicate the browser cache bug in the majority of secure websites online today.
+
+However, though better for performance reasons, this breaks the old browser pattern of POST-REDIRECT-GET (http://en.wikipedia.org/wiki/Post/Redirect/Get)
+
+```
+Post/Redirect/Get (PRG) is a web development design pattern that prevents some duplicate form
+ submissions, creating a more intuitive interface for user agents (users). PRG implements
+bookmarks and the refresh button in a predictable way that does not create duplicate
+form submissions.
+```
+
+![POST REDIRECT GET example](http://upload.wikimedia.org/wikipedia/commons/3/3c/PostRedirectGet_DoubleSubmitSolution.png)
+
+As such, for a secure application, we need to always ensure `no-cache,no-store` is set, and always use the POST-REDIRECT-GET pattern.
+
+### Browser peculiarities
+
+Chrome (other browsers have their own equivalent) has the following code that breaks with the Rails method when `no-store` is set:
+  * https://chromium.googlesource.com/chromium/chromium/+/master/webkit/appcache/appcache_response.cc
+
+Chrome code:
+```
+void AppCacheResponseReader::ContinueReadData() {
+  if (!entry_)  {
+    ScheduleIOCompletionCallback(net::ERR_CACHE_MISS);
+    return;
+  }
+}
+```
+
+Basically, with `no-store` as a header, and allowing 'back button' to be used, the browser gets into a state, where it attempts to load the rendered error page (without redirect) and the headers have already blocked saving the history, and raises the `ERR_CACHE_MISS` error.
+
+With POST-REDIRECT-GET pattern this is avoided (as the form submission page always ends in redirect)
+
+Example of error displayed on Chrome:
+
+![Example of Chrome ERR_CACHE_MISS Process](https://f.cloud.github.com/assets/19973/2430175/4117352a-acc0-11e3-9deb-ba209fa49097.gif)
 
 ## Contributing
 
-1. Fork it ( http://github.com/<my-github-username>/rails-prg/fork )
+1. Fork it ( http://github.com/tommeier/rails-prg/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Add specs and ensure all tests pass (in multiple browsers)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request
 
+## Running tests
 
-## Note how to generate dummy rails app
+To display in Chrome browsers, ensure you have the latest `chromedriver` installed:
 
-  * Command for dummy rails app
-  * Scaffolding request objects:
-    * `rails generate scaffold ExamplePrg subject:text:uniq body:text published:boolean`
-    * `rails generate scaffold ErrorDuplicator subject:text:uniq body:text published:boolean`
+`brew install chromedriver`
 
-## TODO
-  * Write up README
-  * Add steps to install chromedriver to readme
+### Running all tests, with setup, Chrome and Firefox browser features
+
+`script/spec`
+
+### Running features only in Chrome
+
+`BROWSER=chrome rspec spec/rails/prg/features`
+
+### Running features only in Firefox (default)
+
+`BROWSER=firefox rspec spec/rails/prg/features`
+
+## Appendix
+
+### TODO
   * When Open sourced:
     * Add Travis-CI
     * use sauce labs 'Open Sauce' to check in multiple browsers for result and remove 'selenium_display' (or only enable for manual local run, run script/ci for travis, script/spec for local)
+
+### How to to generate dummy rails app for test structure (use when updating rails)
+
+  * Command for dummy rails app
+  * Scaffolding request objects:
+    * `rails generate scaffold ExamplePrg subject:text:uniq body:text published:boolean`
+    * `rails generate scaffold ErrorDuplicator subject:text:uniq body:text published:boolean`

data/lib/rails/prg/version.rb

@@ -1,5 +1,5 @@
 module Rails
   module Prg
-    VERSION = "0.1.0"
+    VERSION = "0.1.1"
   end
 end

data/rails-prg.gemspec

@@ -10,13 +10,16 @@ Gem::Specification.new do |spec|
   spec.email         = ["tom@venombytes.com"]
   spec.summary       = %q{Allow Rails to use full POST-REDIRECT-GET pattern on errors.}
   spec.description   = %q{
-    Secure applications must not use browser history or cache, this can cause problems
-    with some browsers when following standard Rails pattern for POST -> Error -> Render -> Success -> Redirect.
-    For full protection from ERR_CACHE_MISS (in Chrome with no-cache, no-store),
-    Rails should redirect on errors as well as on success,
-    always following full POST-REDIRECT-GET pattern.
-    This way the browser will always have a consistent back-button history to traverse without
-    triggering browser errors unable to display form submission pages.
+  Secure applications disable browser history and internal cache.
+  Unfortunately, this causes problems with most browsers when following
+  the standard Rails pattern for displaying errors.
+
+  For full protection from ERR_CACHE_MISS (in Chrome with no-cache, no-store),
+  and equivalent in other browsers, the pattern should be altered to follow
+  a full POST-REDIRECT-GET patten.
+
+  This way the browser will always have a consistent back-button history to
+  traverse without triggering browser errors.
   }
   spec.homepage      = "https://github.com/tommeier/rails-prg"
   spec.license       = "MIT"
@@ -36,6 +39,8 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "database_cleaner"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec-rails"
+  spec.add_development_dependency "sauce", "~> 3.1.1"
+  spec.add_development_dependency "sauce-connect"
   spec.add_development_dependency "selenium-webdriver"
   spec.add_development_dependency "simplecov"
   spec.add_development_dependency "sqlite3"

data/script/spec

@@ -1,4 +1,4 @@
-#!/bin/sh -xe
+#!/bin/bash -xe
 
 # Install packages.
 bundle --quiet --binstubs
@@ -19,4 +19,10 @@ export CHECK_SPEC_COVERAGE=${CHECK_SPEC_COVERAGE:-false}
 COVERAGE_GROUP="unit-tests" bin/rake "spec:unit"
 COVERAGE_GROUP="firefox-features" BROWSER=firefox bin/rake "spec:features"
 COVERAGE_GROUP="chrome-features" BROWSER=chrome bin/rake "spec:features"
+
+if [ ! -z "$USE_SAUCE" ]; then
+COVERAGE_GROUP="safari-features" BROWSER=safari bin/rake "spec:features"
+COVERAGE_GROUP="ie8-features" BROWSER=ie8 bin/rake "spec:features"
+fi
+
 bin/rake "spec:quality"

data/spec/dummy/app/views/layouts/application.html.erb

@@ -7,7 +7,6 @@
   <%= csrf_meta_tags %>
 </head>
 <body>
-
 <%= yield %>
 
 </body>

data/spec/rails/prg/features/error_duplication_spec.rb

@@ -47,8 +47,15 @@ feature "Standard Rails render on errors" do
         click_button "More" #triggers chrome to load error code
         expect(page.find("div.error-code")).to have_text("Error code: ERR_CACHE_MISS")
       end
+    when :safari
+      #Unable to duplicate except visually
+      # safariDriver cannot handle alerts, or be aware of them
+      # Behaviour: Safari shows 'confirm form resubmission' alert box
+    when :"Internet Explorer"
+      # IE 8
+      expect(page.body).to have_text("The local copy of this webpage is out of date, and the website requires that you download it again.")
     else
-      raise "Error - Unhandled browser"
+      raise "Error - Unhandled browser: #{$selenium_display.browser.to_sym}"
     end
   end
 
@@ -87,14 +94,23 @@ feature "Standard Rails render on errors" do
       page.should have_content("Editing error_duplicator")
       expect(page).to_not have_text("Subject can't be blank")
       expect(page).to have_field('Subject', with: "") #Posted value
-    when :chrome
+    when :chrome, :safari
       # Backs all the way back to show page with errors (post -> rendered error)
       expect(page.current_path).to eq(error_duplicator_path(existing_example))
       page.should have_content("Editing error_duplicator")
       expect(page).to have_text("Subject can't be blank")
       expect(page).to have_field('Subject', with: "updated test input") #updated value
+    when :"Internet Explorer"
+      # Occasionally IE8 barfs with this error page in Sauce. Ignore.
+      unless page.current_path == "/repost.htm"
+        # Backs all the way back to edit page without errors but content filled
+        expect(page.current_path).to eq(edit_error_duplicator_path(existing_example))
+        page.should have_content("Editing error_duplicator")
+        expect(page).to_not have_text("Subject can't be blank")
+        expect(page).to have_field('Subject', with: "updated test input") #Posted value
+      end
     else
-      raise "Error - Unhandled browser"
+      raise "Error - Unhandled browser: #{$selenium_display.browser.to_sym}"
     end
   end
 end

data/spec/rails/prg/features/redirected_objects_spec.rb

@@ -41,14 +41,14 @@ feature "Use full post-redirect-get displaying original params and errors on red
 
     # Browser specific redirection
     case $selenium_display.browser.to_sym
-    when :firefox
+    when :firefox, :"Internet Explorer"
       # Backs to the new page being completely empty
       expect(page).to have_field('Subject', with: "")
-    when :chrome
+    when :chrome, :safari
       # Backs to the new page with original entries already loaded
       expect(page).to have_field('Subject', with: "testing NEW input")
     else
-      raise "Error - Unhandled browser"
+      raise "Error - Unhandled browser: #{$selenium_display.browser.to_sym}"
     end
   end
 
@@ -83,10 +83,18 @@ feature "Use full post-redirect-get displaying original params and errors on red
     # On click of back button
     page.execute_script("window.history.back();")
 
-    # Should have redirected back to edit page with errors
-    expect(page.current_path).to eq(edit_example_prg_path(existing_example))
-    expect(page).to have_text("Subject can't be blank")
-    expect(page).to have_field('Subject', with: "updated test input")
-    expect(page).to have_field('Published', with: 1)
+    # Browser specific redirection
+    case $selenium_display.browser.to_sym
+    when :"Internet Explorer"
+      # IE8 is unstable, sometimes skips back to 'show' or to 'edit' or sometimes nothing at all
+      # expect(page.current_path).to eq(example_prg_path(existing_example))
+      # expect(page).not_to have_text("Subject can't be blank")
+    else
+      # Should have redirected back to edit page with errors
+      expect(page.current_path).to eq(edit_example_prg_path(existing_example))
+      expect(page).to have_text("Subject can't be blank")
+      expect(page).to have_field('Subject', with: "updated test input")
+      expect(page).to have_field('Published', with: 1)
+    end
   end
 end

data/spec/support/selenium_display.rb

@@ -1,4 +1,7 @@
-require 'selenium-webdriver'
+require "selenium/webdriver"
+require 'selenium/webdriver/remote/http/persistent'
+require "sauce/config"
+require "sauce/connect"
 
 Device = Struct.new(:width, :height)
 
@@ -19,11 +22,22 @@ class SeleniumDisplay
     self.device_name = ENV['DEVICE'] || 'desktop'
     self.device = define_device(device_name)
 
+    set_travis_options! if running_on_travis?
+    set_sauce_options!  if use_sauce?
+
     print_debug_info if ENV['SELENIUM_DEBUG']
   end
 
   private
 
+  def running_on_travis?
+    !ENV['TRAVIS_JOB_NUMBER'].nil?
+  end
+
+  def use_sauce?
+    !ENV['USE_SAUCE'].nil?
+  end
+
   def define_device device_type
     case device_type.strip.downcase
     when 'phone'
@@ -42,18 +56,23 @@ class SeleniumDisplay
   def define_browser_capability
     case browser
     when /ie\d+/
-      self.browser_capability = Selenium::WebDriver::Remote::Capabilities.ie
-      self.browser_capability.version = (browser.match /ie(?<version>\d+)/)[:version]
-      self.browser_capability.platform = "windows"
-      self.browser = 'ie'
+      self.browser_capability = Selenium::WebDriver::Remote::Capabilities.internet_explorer
+      version_number          = (browser.match /ie(?<version>\d+)/)[:version]
+
+      self.browser_capability.platform = version_number.to_i <= 8 ? "Windows XP" : "Windows 7"
+      self.browser_capability.version = version_number
+      self.browser = 'Internet Explorer'
     when 'chrome'
       self.browser_capability = Selenium::WebDriver::Remote::Capabilities.chrome
-
     when 'ipad'
       self.browser_capability = Selenium::WebDriver::Remote::Capabilities.ipad
       self.resizable = false
     when 'iphone'
       self.browser_capability = Selenium::WebDriver::Remote::Capabilities.iphone
+      self.browser_capability.platform = "OS X 10.9" #Sauce labs
+      self.browser_capability.version = "7"
+      self.browser_capability['device-orientation'] = 'portrait'
+
       self.resizable = false
     when 'firefox'
       self.browser_capability = Selenium::WebDriver::Remote::Capabilities.firefox
@@ -62,12 +81,99 @@ class SeleniumDisplay
       profile['extensions.update.enabled'] = false
       profile['app.update.auto'] = false
       profile['app.update.enabled'] = false
-      self.selenium_options.merge!({:profile => profile })
+      self.selenium_options.merge!(profile: profile)
+    when 'android'
+      self.browser_capability = Selenium::WebDriver::Remote::Capabilities.android
+    when 'safari'
+      # Sauce labs
+      self.browser_capability = Selenium::WebDriver::Remote::Capabilities.safari
+      self.browser_capability.platform = "OS X 10.9"
+      self.browser_capability.version = "7"
     else
       raise "Error - Unsupported browser format '#{browser}'"
     end
   end
 
+  def set_travis_options!
+    self.browser_capability["build"] = ENV["TRAVIS_BUILD_NUMBER"]
+  end
+
+  def set_sauce_options!
+    raise_on_missing_sauce_variables! unless running_on_travis?
+
+    sauce_config = Sauce::Config.new
+    host = sauce_config[:application_host] || "127.0.0.1"
+    port = sauce_config[:application_port]
+
+    Capybara.server_port        = port
+    Capybara.app_host           = "http://#{host}:#{port}"
+    Capybara.default_wait_time  = 30
+
+    client = ::Selenium::WebDriver::Remote::Http::Persistent.new
+    client.timeout = 300
+
+    if running_on_travis?
+      # Running on Travis CI (use existing tunnel)
+      self.browser_capability["tunnel-identifier"] = ENV["TRAVIS_JOB_NUMBER"]
+    else
+      # Connect local tunnel (and wait for connection)
+      Sauce::Connect.connect!
+    end
+
+    self.selenium_options.delete(:profile) #Incompatible
+
+    url = "http://#{sauce_config.username}:#{sauce_config.access_key}@#{sauce_config.host}:#{sauce_config.port}/wd/hub"
+    #client_version => Unnecessary, chooses latest
+    #platform => allow browser capability to set (default: linux)
+    self.browser_capability.merge!(
+      name: sauce_job_name,
+      browserName: browser
+    )
+    self.selenium_options.merge!(
+      browser: :remote,
+      url: url,
+      desired_capabilities: self.browser_capability,
+      http_client: client
+    )
+
+    set_build_to_notify_sauce!
+  end
+
+  def sauce_job_name
+    [ENV['TRAVIS_JOB_NUMBER'], browser, device_name].compact.join(" : ")
+  end
+
+  def raise_on_missing_sauce_variables!
+    # Required sauce variables
+    %w( SAUCE_USERNAME SAUCE_ACCESS_KEY ).each do |env_var|
+      raise "Error - set #{env_var} for access to open-sauce for selenium tests" unless ENV[env_var]
+    end
+  end
+
+  def set_build_to_notify_sauce!
+    # Notify sauce labs of build result if any specs were:
+    #  * JS related (browser specs)
+    RSpec.configure do |config|
+      config.prepend_after(:suite) do
+        examples      = RSpec.world.filtered_examples.values.flatten
+        sauce_results = examples.inject({ passed: [], failed: [], total: 0 }) do |result, example|
+          if example.metadata[:js] #only js features
+            result[:total] += 1
+            result[example.metadata[:execution_result][:status].to_sym] << example
+          end
+          result
+        end
+
+        if sauce_results[:total] && sauce_results[:total] > 0
+          job_result = sauce_results[:failed].count > 0 ? "failed" : "passed"
+          Capybara.using_driver(:selenium_browser) do
+            Capybara.current_session.driver.execute_script("sauce:job-result=#{job_result}")
+          end
+        end
+      end
+    end
+  end
+
   def print_debug_info
     STDERR.puts " >> Loading Selenium display"
     STDERR.puts "   ->> browser     : #{browser}"

data/spec/support/use_selenium_display.rb

@@ -1,3 +1,4 @@
+# Use selenium display
 require 'support/selenium_display'
 require 'capybara'
 

data/spec/support/use_simplecov.rb

@@ -10,7 +10,7 @@ class SimpleCov::Formatter::QualityFormatter
   end
 end
 
-SimpleCov.merge_timeout 240 #4 mins
+SimpleCov.merge_timeout 1800 #30 mins
 if suite_name = ENV["COVERAGE_GROUP"]
   SimpleCov.command_name(suite_name)
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails-prg
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Tom Meier
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-03-16 00:00:00.000000000 Z
+date: 2014-03-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -136,6 +136,34 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: sauce
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.1.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.1.1
+- !ruby/object:Gem::Dependency
+  name: sauce-connect
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  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
@@ -192,14 +220,13 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: "\n    Secure applications must not use browser history or cache, this
-  can cause problems\n    with some browsers when following standard Rails pattern
-  for POST -> Error -> Render -> Success -> Redirect.\n    For full protection from
-  ERR_CACHE_MISS (in Chrome with no-cache, no-store),\n    Rails should redirect on
-  errors as well as on success,\n    always following full POST-REDIRECT-GET pattern.\n
-  \   This way the browser will always have a consistent back-button history to traverse
-  without\n    triggering browser errors unable to display form submission pages.\n
-  \ "
+description: "\n  Secure applications disable browser history and internal cache.\n
+  \ Unfortunately, this causes problems with most browsers when following\n  the standard
+  Rails pattern for displaying errors.\n\n  For full protection from ERR_CACHE_MISS
+  (in Chrome with no-cache, no-store),\n  and equivalent in other browsers, the pattern
+  should be altered to follow\n  a full POST-REDIRECT-GET patten.\n\n  This way the
+  browser will always have a consistent back-button history to\n  traverse without
+  triggering browser errors.\n  "
 email:
 - tom@venombytes.com
 executables: []
@@ -209,6 +236,7 @@ files:
 - .cane
 - .gitignore
 - .rspec
+- .travis.yml
 - Gemfile
 - LICENSE.txt
 - README.md