capybara-screenshot-nocolor 1.0.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: debcd0f6b147d7d43971537748912f05f4ec56f9
+  data.tar.gz: e59b5fd4cc7d9cb383f449f0df6d676553000d6e
+SHA512:
+  metadata.gz: dbe69f576c94d13a97d0ec0dea4fc7fb0a9280689b1c6c9509ef4ada996b7d95a18d8dbb3c3897f5c40e9ac3a654f7474953a7971130944d1db049fc61b3e082
+  data.tar.gz: 83f83cc3d6683d389906c5e3e4a90a4e058e672a5a38dd95d2dece211089fab1632c66b91ec2fe6d274decf94a2642a64d9638775647bb273a179a2635eec61c

data/.gitignore

@@ -0,0 +1,7 @@
+*.gem
+.bundle
+Gemfile.lock
+gemfiles/*.lock
+pkg/*
+.rvmrc
+bin

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/.travis.yml

@@ -0,0 +1,17 @@
+language: ruby
+script: "rake travis:ci"
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.2
+  - jruby-19mode
+  - jruby-1.7.13
+gemfile:
+  - gemfiles/cucumber.1.2.gemfile
+  - gemfiles/cucumber.1.3.0.gemfile
+  - gemfiles/latest.gemfile
+  - gemfiles/rspec.2.14.gemfile
+  - gemfiles/rspec.2.99.gemfile
+  - gemfiles/rspec.3.0.gemfile
+  - gemfiles/spinach.0.7.gemfile
+  - gemfiles/spinach.0.8.0.gemfile

data/Appraisals

@@ -0,0 +1,31 @@
+appraise "rspec.2.14" do
+  gem "rspec", "2.14"
+end
+
+appraise "rspec.2.99" do
+  gem "rspec", "2.99"
+end
+
+appraise "rspec.3.0" do
+  gem "rspec", "3.0"
+end
+
+appraise "cucumber.1.2" do
+  gem "cucumber", "1.2"
+end
+
+appraise "cucumber.1.3.0" do
+  gem "cucumber", "1.3.0"
+end
+
+appraise "spinach.0.7" do
+  gem "spinach", "0.7"
+end
+
+appraise "spinach.0.8.0" do
+  gem "spinach", "0.8.0"
+end
+
+appraise "latest" do
+  # will get latest versions of all gems
+end

data/CHANGELOG.md

@@ -0,0 +1,198 @@
+10 Feburary 2015 - 1.04 -> 1.0.5
+-----------
+
+* Added support for appending a random string to the filename
+
+Thanks to [Brad Wedell](https://github.com/streetlogics)
+
+5 January 2015 - 1.0.3 -> 1.0.4
+-----------
+
+* Added support for Poltergeist Billy
+* Don't initialize a new Capybara::Session in after hook
+
+Thanks to [Neodude](https://github.com/neodude) and [Dominik Masur](https://github.com/dmasur)
+
+1 October 2014 - 1.0.2 -> 1.0.3
+-----------
+
+* Added ability to prune screenshots automatically, see https://github.com/mattheworiordan/capybara-screenshot/pull/100
+
+Thanks to [Anton Kolomiychuk](https://github.com/akolomiychuk) for his contribution.
+
+27 September 2014 - 1.0.1 -> 1.0.2
+-----------
+
+* Improved documentation to cover RSpec 3's new approach to using `rails_helper` in place of `spec_helper` for Rails tests
+* Updated documentation to use Ruby formatting in language blocks
+* Removed need to manually `require 'capybara-screenshot'` for RSpec
+
+18 September 2014 - 1.0.0 -> 1.0.1
+-----------
+
+* Hot fix for RSpec version issue that assumed RSpec base library was always available, now uses `RSpec::Core::VERSION`
+* Improve Travis CI performance and stability
+
+18 September 2014 - 0.3.22 -> 1.0.0
+-----------
+
+Because of the broad test coverage now across RSpec, Cucumber, Spinach, Minitest and TestUnit using [Aruba](https://github.com/cucumber/aruba), I feel that this gem is ready for its first major release.  New features and refactoring can now reliably be done  without the fear of regressions.
+
+The major changes in this 1.0 release are:
+
+* Acceptance test coverage for RSpec, Cucumber, Spinach, Minitest and TestUnit
+* Travis CI test coverage across a matrix of old and new versions of the aforementioned testing frameworks, see https://github.com/mattheworiordan/capybara-screenshot/blob/master/.travis.yml
+* Support for RSpec 3 using the custom formatters
+* Support for sessions using `using_session`, see https://github.com/mattheworiordan/capybara-screenshot/pull/91 for more info
+* Support for RSpec DocumentationFormatter
+* Considerable refactoring of the test suite
+
+Special thanks goes to [Andrew Brown](https://github.com/dontfidget) who has contributed a huge amount of the code that has helped enable this Gem to have its stable major version release.
+
+22 July 2014 - 0.3.21 -> 0.3.22
+-----------
+
+Replaced [colorize](https://rubygems.org/gems/colorize) gem with [colored](https://rubygems.org/gems/colored) due to license issue, see https://github.com/mattheworiordan/capybara-screenshot/issues/93.
+
+22 July 2014 - 0.3.20 -> 0.3.21
+-----------
+
+As a result of recent merges and insufficient test coverage, it seems that for test suites other than RSpec the HTML or Image screenshot path was no longer being outputted in the test results.  This has now been fixed, and screenshot output format for RSpec and all other test suites has been standardised.
+
+11 July 2014 - 0.3.19 -> 0.3.20
+-----------
+
+* Added reporters to improve screenshot info in RSpec output
+* Added support for Webkit options such as width and height
+
+Thanks to https://github.com/multiplegeorges and https://github.com/noniq
+
+2 April 2014 - 0.3.18 -> 0.3.19
+-----------
+
+* Added support Spinach, thanks to https://github.com/suchitpuri
+
+2 March 2014 - 0.3.16 -> 0.3.17
+-----------
+
+* Added support for RSpec 3 and cleaned up the logging so there is less noise within the test results when a driver does not support a particular format.
+* Updated Travis to test against Ruby 2.0 and Ruby 2.1
+
+Thanks to https://github.com/noniq
+
+7 January 2014
+-----------
+
+Bug fix for Minitest 5, thanks to https://github.com/cschramm
+
+
+12 September 2013
+-----------
+
+Added support for Test Unit, fixed RSpec deprecation warnings and fixed a dependency issue.
+
+Thanks to:
+
+* https://github.com/budnik
+* https://github.com/jkraemer
+* https://github.com/mariovisic
+
+
+23 July 2013
+-----------
+
+https://github.com/stevenwilkin contributed code to display a warning for [Mechanize](http://mechanize.rubyforge.org/) users.
+
+3 June 2013
+-----------
+
+Dropped Ruby 1.8 support for this Gem because of conflicts with Nokogiri requiring a later version of Ruby.  Instead, there is a new branch https://github.com/mattheworiordan/capybara-screenshot/tree/ruby-1.8-support which can be used if requiring backwards compatabiltiy.
+
+18 Apr 2013
+-----------
+
+Improved documentation, Ruby 1.8.7 support by not allowing Capybara 2.1 to be used, improved Sinatra support.
+RSpec screenshot fix to only screenshot when applicable: https://github.com/mattheworiordan/capybara-screenshot/issues/44
+
+07 Jan 2013
+-----------
+
+Support for Terminus, thanks to https://github.com/jamesotron
+
+27 Dec 2012
+-----------
+
+Previos version bump broke Ruby 1.8.7 support, so Travis CI build added to this Gem and Ruby 1.8.7 support along with JRuby support added.
+
+30 Oct 2012 - Significant version bump 0.3
+-----------
+
+After some consideration, and continued problems with load order of capybara-screenshot in relation to other required gems, the commits from @adzap in the pull request https://github.com/mattheworiordan/capybara-screenshot/pull/29 have been incorporated.  Moving forwards, for every testing framework you use, you will be required to add an explicit require.
+
+
+15 Feb 2012
+-----------
+
+Merged pull request https://github.com/mattheworiordan/capybara-screenshot/pull/14 to limit when capybara-screenshot is fired for RSpec
+
+30 Jan 2012
+-----------
+
+Merged pull request from https://github.com/hlascelles to support Padrino
+
+15 Jan 2012
+-----------
+
+Removed unnecessary and annoying warning that a screen shot cannot be taken.  This message was being shown when RSpec tests were run that did not even invoke Capybara
+
+13 Jan 2012
+-----------
+
+Updated documentation to reflect support for more frameworks, https://github.com/mattheworiordan/capybara-screenshot/issues/9
+
+3 Jan 2012
+----------
+
+Removed Cucumber dependency https://github.com/mattheworiordan/capybara-screenshot/issues/7
+Allowed PNG save path to be configured using capybara.save_and_open_page_path
+
+3 December 2011
+---------------
+
+More robust handling of Minitest for users who have it installed as a dependency
+https://github.com/mattheworiordan/capybara-screenshot/issues/5
+
+
+2 December 2011
+---------------
+
+Fixed bug related to teardown hook not being available in Minitest for some reason (possibly version issues).
+https://github.com/mattheworiordan/capybara-screenshot/issues/5
+
+24 November 2011
+----------------
+
+Added support for:
+
+ * More platforms (Poltergeist)
+ * Removed Rails dependencies (bug)
+ * Added screenshot capability for Selenium
+ * Added support for embed for HTML reports
+
+Thanks to [https://github.com/rb2k](https://github.com/rb2k) for 2 [great commits](https://github.com/mattheworiordan/capybara-screenshot/pull/4)
+
+16 November 2011
+----------------
+
+Added support for Minitest using teardown hooks
+
+
+16 November 2011
+----------------
+
+Added support for RSpec by adding a RSpec configuration after hook and checking if Capybara is being used.
+
+15 November 2011
+----------------
+
+Ensured that tests run other than Cucumber won't fail.  Prior to this Cucumber was required.

data/Gemfile

@@ -0,0 +1,7 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in capybara-screenshot.gemspec
+gemspec
+
+gem 'rake'
+gem 'appraisal'

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 Matthew O'Riordan, inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,240 @@
+capybara-screenshot gem
+=======================
+
+[![Build Status](https://travis-ci.org/mattheworiordan/capybara-screenshot.png)](https://travis-ci.org/mattheworiordan/capybara-screenshot)
+[![Code Climate](https://d3s6mut3hikguw.cloudfront.net/github/mattheworiordan/capybara-screenshot.png)](https://codeclimate.com/github/mattheworiordan/capybara-screenshot)
+[![Gem Version](https://badge.fury.io/rb/capybara-screenshot.svg)](http://badge.fury.io/rb/capybara-screenshot)
+
+#### Capture a screen shot for every test failure automatically!
+
+`capybara-screenshot` used with [Capybara](https://github.com/jnicklas/capybara) and [Cucumber](http://cukes.info/), [Rspec](https://www.relishapp.com/rspec) or [Minitest](https://github.com/seattlerb/minitest), will capture a screen shot for each failure in your test suite.  The HTML for the failed page, and a screenshot image (when using [capybara-webkit](https://github.com/thoughtbot/capybara-webkit), [Selenium](http://seleniumhq.org/) or [poltergeist](https://github.com/jonleighton/poltergeist)) is saved into `$APPLICATION_ROOT/tmp/capybara`.
+
+Having screenshots readily available for each test failure is incredibly helpful when trying to quickly diagnose a problem in your failing steps.  You can view the source code, and have a screen shot of the page (when applicable), at the time of each failure.
+
+_Please note that Ruby 1.9+ is required to use this Gem.  For Ruby 1.8 support, please see the [capybara-screenshot Ruby 1.8 branch](https://github.com/mattheworiordan/capybara-screenshot/tree/ruby-1.8-support)_
+
+Installation
+-----
+
+### Step 1: install the gem
+
+Using Bundler, add the following to your Gemfile
+
+```ruby
+gem 'capybara-screenshot', :group => :test
+```
+
+or install manually using Ruby Gems:
+
+```
+gem install capybara-screenshot
+```
+
+### Step 2: load capybara-screenshot into your tests
+
+#### Cucumber
+
+In env.rb or a support file, please add:
+
+```ruby
+require 'capybara-screenshot/cucumber'
+```
+
+#### RSpec
+
+In rails_helper.rb, spec_helper.rb, or a support file, after the require for 'capybara/rspec', please add:
+
+```ruby
+# remember: you must require 'capybara/rspec' first
+require 'capybara-screenshot/rspec'
+```
+
+*Note: As of RSpec Rails 3.0, it is recommended that all your Rails environment code is loaded into `rails_helper.rb` instead of `spec_helper.rb`, and as such, the capybara-screenshot require should be located in `rails_helper.rb`.  See the [RSpec Rails 3.0 upgrade notes](https://www.relishapp.com/rspec/rspec-rails/v/3-0/docs/upgrade) for more info.*
+
+#### Minitest
+
+Typically in 'test/test_helper.rb', please add:
+
+```ruby
+require 'capybara-screenshot/minitest'
+```
+
+#### Test::Unit
+
+Typically in 'test/test_helper.rb', please add:
+
+```ruby
+require 'capybara-screenshot/testunit'
+```
+
+By default, screenshots will be captured for `Test::Unit` tests in the path 'test/integration'.  You can add additional paths as:
+
+```ruby
+Capybara::Screenshot.testunit_paths << 'test/feature'
+```
+
+
+Manual screenshots
+----
+
+If you require more control, you can generate the screenshot on demand rather than on failure. This is useful
+if the failure occurs at a point where the screen shot is not as useful for debugging a rendering problem. This
+can be more useful if you disable the auto-generate on failure feature with the following config
+
+```ruby
+Capybara::Screenshot.autosave_on_failure = false
+```
+
+Anywhere the Capybara DSL methods (visit, click etc.) are available so too are the screenshot methods.
+
+```ruby
+screenshot_and_save_page
+```
+
+Or for screenshot only, which will automatically open the image.
+
+```ruby
+screenshot_and_open_image
+```
+
+These are just calls on the main library methods.
+
+```ruby
+Capybara::Screenshot.screenshot_and_save_page
+Capybara::Screenshot.screenshot_and_open_image
+```
+
+
+Driver configuration
+--------------------
+
+The gem supports the default rendering method for Capybara to generate the screenshot, which is:
+
+```ruby
+page.driver.render(path)
+```
+
+There are also some specific driver configurations for Selenium, Webkit, and Poltergeist. See [the definitions here](https://github.com/mattheworiordan/capybara-screenshot/blob/master/lib/capybara-screenshot.rb). The Rack::Test driver, Rails' default, does not allow
+rendering, so it has a driver definition as a noop.
+
+Capybara-webkit defaults to a screenshot size of 1000px by 10px. To specify a custom size, use the following option:
+
+```ruby
+Capybara::Screenshot.webkit_options = { width: 1024, height: 768 }
+```
+
+If a driver is not found the default rendering will be used. If this doesn't work with your driver, then you can
+add another driver configuration like so
+
+```ruby
+# The driver name should match the Capybara driver config name.
+Capybara::Screenshot.register_driver(:exotic_browser_driver) do |driver, path|
+  driver.super_dooper_render(path)
+end
+```
+
+If your driver is based on existing browser driver, like Firefox, instead of `.super_dooper_render` do `driver.browser.save_screenshot path`.
+
+
+Custom screenshot filename
+--------------------------
+
+If you want to control the screenshot filename for a specific test library, to inject the test name into it for example,
+you can override how the basename is generated for the file like so
+
+```ruby
+Capybara::Screenshot.register_filename_prefix_formatter(:rspec) do |example|
+  "screenshot_#{example.description.gsub(' ', '-').gsub(/^.*\/spec\//,'')}"
+end
+```
+
+By default capybara-screenshot will append a timestamp to the basename. If you want to disable this behavior set the following option:
+
+```ruby
+Capybara::Screenshot.append_timestamp = false
+```
+
+
+Custom screenshot directory
+--------------------------
+By default screenshots are saved into `$APPLICATION_ROOT/tmp/capybara`. If you want to customize the location, override the file path as:
+
+```ruby
+Capybara.save_and_open_page_path = "/file/path"
+```
+
+
+Pruning old screenshots automatically
+--------------------------
+By default screenshots are saved indefinitely, if you want them to be automatically pruned on a new failure, then you can specify one of the following prune strategies as follows:
+
+```ruby
+# Keep only the screenshots generated from the last failing test suite
+Capybara::Screenshot.prune_strategy = :keep_last_run
+
+# Keep up to the number of screenshots specified in the hash
+Capybara::Screenshot.prune_strategy = { keep: 20 }
+```
+
+
+Information about screenshots in RSpec output
+---------------------------------------------
+
+By default, capybara-screenshot extend RSpec’s formatters to include a link to the screenshot and/or saved html page for each failed spec. If you want to disable this feature completely (eg. to avoid problems with CI tools), use:
+
+```ruby
+Capybara::Screenshot::RSpec.add_link_to_screenshot_for_failed_examples = false
+```
+
+It’s also possible to directly embed the screenshot image in the output if you’re using RSpec’s HtmlFormatter:
+
+```ruby
+Capybara::Screenshot::RSpec::REPORTERS["RSpec::Core::Formatters::HtmlFormatter"] = Capybara::Screenshot::RSpec::HtmlEmbedReporter
+```
+
+If you want to further customize the information added to RSpec’s output, just implement your own reporter class and customize `Capybara::Screenshot::RSpec::REPORTERS` accordingly. See [rspec.rb](lib/capybara-screenshot/rspec.rb) for more info.
+
+
+Common problems
+---------------
+
+If you have recently upgraded from v0.2, or you find that screen shots are not automatically being generated, then it's most likely you have not included the necessary `require` statement for your testing framework described above.  As of version 0.3, without the explicit require, Capybara-Screenshot will not automatically take screen shots.  Please re-read the installation instructions above.
+
+Also make sure that you're not calling `Capybara.reset_sessions!` before the screenshot hook runs. For RSpec you want to make sure that you're using `append_after` instead of `after`, for instance:
+
+```ruby
+config.append_after(:each) do
+  Capybara.reset_sessions!
+end
+```
+
+[Raise an issue on the Capybara-Screenshot issue tracker](https://github.com/mattheworiordan/capybara-screenshot/issues) if you are still having problems.
+
+Repository & Contributing to this Gem
+-------------------------------------
+
+#### Bugs
+
+Please raise an issue at [https://github.com/mattheworiordan/capybara-screenshot/issues](https://github.com/mattheworiordan/capybara-screenshot/issues) and ensure you provide sufficient detail to replicate the problem.
+
+#### Contributions
+
+Contributions are welcome.  Please fork this gem, and submit a pull request.  New features must include test coverage and must pass on all versions of the testing frameworks supported.  Run `appraisal "bundle exec rspec && bundle exec cucumber"` locally to test your changes against all versions of testing framework gems supported.
+
+#### Rubygems
+
+The gem details on RubyGems.org can be found at [https://rubygems.org/gems/capybara-screenshot](https://rubygems.org/gems/capybara-screenshot)
+
+About
+-----
+
+This gem was written by **Matthew O'Riordan**, with contributions from [many kind people](https://github.com/mattheworiordan/capybara-screenshot/network/members).
+
+ - [http://mattheworiordan.com](http://mattheworiordan.com)
+ - [@mattheworiordan](http://twitter.com/#!/mattheworiordan)
+ - [Linked In](http://www.linkedin.com/in/lemon)
+
+License
+-------
+
+Copyright © 2014 Matthew O'Riordan, inc. It is free software, and may be redistributed under the terms specified in the LICENSE file.