capybara-screenshot-nocolor 1.0.5

data/spec/cucumber/step_definitions/step_definitions.rb

@@ -0,0 +1,18 @@
+When(/^I click on a missing link$/) do
+  click_on "you'll never find me"
+end
+
+When(/^I click on a missing link on a different page in a different session$/) do
+  using_session :different_session do
+    visit '/different_page'
+    click_on "you'll never find me"
+  end
+end
+
+When(/^I visit "([^"]*)"$/) do |path|
+  visit path
+end
+
+Then(/^I trigger an unhandled exception/) do
+  raise "you can't handle me"
+end

data/spec/cucumber/support/env.rb

@@ -0,0 +1,17 @@
+require 'capybara/cucumber'
+require 'capybara-screenshot'
+require 'capybara-screenshot/cucumber'
+require 'aruba/cucumber'
+require 'aruba/jruby'
+
+Capybara::Screenshot.register_filename_prefix_formatter(:cucumber) do |fault|
+  'my_screenshot'
+end
+
+Before do
+  @aruba_timeout_seconds = 60
+end if RUBY_PLATFORM == 'java'
+
+After('@restore-capybara-default-session') do
+  Capybara.session_name = nil
+end

data/spec/feature/minitest_spec.rb

@@ -0,0 +1,110 @@
+require "spec_helper"
+
+describe "Using Capybara::Screenshot with MiniTest" do
+  include CommonSetup
+
+  before do
+    clean_current_dir
+  end
+
+  def run_failing_case(code)
+    write_file('test_failure.rb', <<-RUBY)
+      #{ensure_load_paths_valid}
+      require 'minitest/autorun'
+      require 'capybara'
+      require 'capybara-screenshot'
+      require 'capybara-screenshot/minitest'
+
+      #{setup_test_app}
+      Capybara::Screenshot.register_filename_prefix_formatter(:minitest) do |test_case|
+        test_name = test_case.respond_to?(:name) ? test_case.name : test_case.__name__
+        raise "expected fault" unless test_name.include? 'test_failure'
+        'my_screenshot'
+      end
+
+      #{code}
+    RUBY
+
+    cmd = 'bundle exec ruby test_failure.rb'
+    run_simple_with_retry cmd, false
+    expect(output_from(cmd)).to include %q{Unable to find link or button "you'll never find me"}
+  end
+
+  it 'saves a screenshot on failure' do
+    run_failing_case <<-RUBY
+      module ActionDispatch
+        class IntegrationTest < Minitest::Unit::TestCase; end
+      end
+
+      class TestFailure < ActionDispatch::IntegrationTest
+        include Capybara::DSL
+
+        def test_failure
+          visit '/'
+          assert(page.body.include?('This is the root page'))
+          click_on "you'll never find me"
+        end
+      end
+    RUBY
+    check_file_content 'tmp/my_screenshot.html', 'This is the root page', true
+  end
+
+  it "does not save a screenshot for tests that don't inherit from ActionDispatch::IntegrationTest" do
+    run_failing_case <<-RUBY
+      class TestFailure < MiniTest::Unit::TestCase
+        include Capybara::DSL
+
+        def test_failure
+          visit '/'
+          assert(page.body.include?('This is the root page'))
+          click_on "you'll never find me"
+        end
+      end
+    RUBY
+    check_file_presence(%w{tmp/my_screenshot.html}, false)
+  end
+
+  it 'saves a screenshot for the correct session for failures using_session' do
+    run_failing_case <<-RUBY
+      module ActionDispatch
+        class IntegrationTest < Minitest::Unit::TestCase; end
+      end
+
+      class TestFailure < ActionDispatch::IntegrationTest
+        include Capybara::DSL
+
+        def test_failure
+          visit '/'
+          assert(page.body.include?('This is the root page'))
+          using_session :different_session do
+            visit '/different_page'
+            assert(page.body.include?('This is a different page'))
+            click_on "you'll never find me"
+          end
+        end
+      end
+    RUBY
+    check_file_content 'tmp/my_screenshot.html', 'This is a different page', true
+  end
+
+  it 'prunes screenshots on failure' do
+    create_screenshot_for_pruning
+    configure_prune_strategy :last_run
+    run_failing_case <<-RUBY
+      module ActionDispatch
+        class IntegrationTest < Minitest::Unit::TestCase; end
+      end
+
+      class TestFailure < ActionDispatch::IntegrationTest
+        include Capybara::DSL
+
+        def test_failure
+          visit '/'
+          assert(page.body.include?('This is the root page'))
+          click_on "you'll never find me"
+        end
+      end
+    RUBY
+    assert_screenshot_pruned
+  end
+end

data/spec/feature/testunit_spec.rb

@@ -0,0 +1,81 @@
+require "spec_helper"
+
+describe "Using Capybara::Screenshot with Test::Unit" do
+  include CommonSetup
+
+  before do
+    clean_current_dir
+  end
+
+  def run_failing_case(code, integration_path = '.')
+    write_file("#{integration_path}/test_failure.rb", <<-RUBY)
+      #{ensure_load_paths_valid}
+      require 'test/unit'
+      require 'capybara'
+      require 'capybara/rspec'
+      require 'capybara-screenshot'
+      require 'capybara-screenshot/testunit'
+
+      #{setup_test_app}
+      Capybara::Screenshot.register_filename_prefix_formatter(:testunit) do | fault |
+        raise "expected fault" unless fault.exception.message.include? %q{Unable to find link or button "you'll never find me"}
+        'my_screenshot'
+      end
+
+      class TestFailure < Test::Unit::TestCase
+        include Capybara::DSL
+
+        def test_failure
+          #{code}
+        end
+      end
+    RUBY
+
+    cmd = "bundle exec ruby #{integration_path}/test_failure.rb"
+    run_simple_with_retry cmd, false
+    expect(output_from(cmd)).to include %q{Unable to find link or button "you'll never find me"}
+  end
+
+  it "saves a screenshot on failure for any test in path 'test/integration'" do
+    run_failing_case <<-RUBY, 'test/integration'
+      visit '/'
+      assert(page.body.include?('This is the root page'))
+      click_on "you'll never find me"
+    RUBY
+    check_file_content 'tmp/my_screenshot.html', 'This is the root page', true
+  end
+
+  it "does not generate a screenshot for tests that are not in 'test/integration'" do
+    run_failing_case <<-RUBY, 'test/something-else'
+      visit '/'
+      assert(page.body.include?('This is the root page'))
+      click_on "you'll never find me"
+    RUBY
+
+    check_file_presence(%w{tmp/my_screenshot.html}, false)
+  end
+
+  it 'saves a screenshot for the correct session for failures using_session' do
+    run_failing_case <<-RUBY, 'test/integration'
+      visit '/'
+      assert(page.body.include?('This is the root page'))
+      using_session :different_session do
+        visit '/different_page'
+        assert(page.body.include?('This is a different page'))
+        click_on "you'll never find me"
+      end
+    RUBY
+    check_file_content 'tmp/my_screenshot.html', 'This is a different page', true
+  end
+
+  it 'prunes screenshots on failure' do
+    create_screenshot_for_pruning
+    configure_prune_strategy :last_run
+    run_failing_case <<-RUBY, 'test/integration'
+      visit '/'
+      assert(page.body.include?('This is the root page'))
+      click_on "you'll never find me"
+    RUBY
+    assert_screenshot_pruned
+  end
+end

data/spec/rspec/rspec_spec.rb

@@ -0,0 +1,159 @@
+require 'spec_helper'
+
+describe Capybara::Screenshot::RSpec do
+  describe "used with RSpec" do
+    include CommonSetup
+
+    before do
+      clean_current_dir
+    end
+
+    def run_failing_case(code, error_message, format=nil)
+      run_case code, format: format
+
+      cmd = cmd_with_format(format)
+      if error_message.kind_of?(Regexp)
+        expect(output_from(cmd)).to match(error_message)
+      else
+        expect(output_from(cmd)).to include(error_message)
+      end
+    end
+
+    def run_case(code, options = {})
+      write_file('spec/test_failure.rb', <<-RUBY)
+        #{ensure_load_paths_valid}
+        require 'rspec'
+        require 'capybara'
+        require 'capybara/rspec'
+        require 'capybara-screenshot'
+        require 'capybara-screenshot/rspec'
+
+        #{setup_test_app}
+        #{code}
+      RUBY
+
+      cmd = cmd_with_format(options[:format])
+      run_simple_with_retry cmd, false
+
+      expect(output_from(cmd)).to include('0 failures') if options[:assert_all_passed]
+    end
+
+    def cmd_with_format(format)
+      "bundle exec rspec #{"--format #{format} " if format}spec/test_failure.rb"
+    end
+
+    it 'saves a screenshot on failure' do
+      run_failing_case <<-RUBY, %q{Unable to find link or button "you'll never find me"}
+        feature 'screenshot with failure' do
+          scenario 'click on a missing link' do
+            visit '/'
+            expect(page.body).to include('This is the root page')
+            click_on "you'll never find me"
+          end
+        end
+      RUBY
+      check_file_content('tmp/screenshot.html', 'This is the root page', true)
+    end
+
+    formatters = {
+      progress:      'HTML screenshot:',
+      documentation: 'HTML screenshot:',
+      html:          %r{<a href="file://\./tmp/screenshot\.html"[^>]*>HTML page</a>}
+    }
+
+    # Textmate formatter is only included in RSpec 2
+    if RSpec::Core::Version::STRING.to_i == 2
+      formatters[:textmate] = %r{TextMate\.system\(.*open file://\./tmp/screenshot.html}
+    end
+
+    formatters.each do |formatter, error_message|
+      it "uses the associated #{formatter} formatter" do
+        run_failing_case <<-RUBY, error_message, formatter
+          feature 'screenshot with failure' do
+            scenario 'click on a missing link' do
+              visit '/'
+              click_on "you'll never find me"
+            end
+          end
+        RUBY
+        check_file_content('tmp/screenshot.html', 'This is the root page', true)
+      end
+    end
+
+    it "does not save a screenshot for tests that don't use Capybara" do
+      run_failing_case <<-RUBY, %q{expected: false}
+        describe 'failing test' do
+          it 'fails intentionally' do
+            expect(true).to eql(false)
+          end
+        end
+      RUBY
+      check_file_presence(%w{tmp/screenshot.html}, false)
+    end
+
+    it 'saves a screenshot for the correct session for failures using_session' do
+      run_failing_case <<-RUBY, %q{Unable to find link or button "you'll never find me"}
+        feature 'screenshot with failure' do
+          scenario 'click on a missing link' do
+            visit '/'
+            expect(page.body).to include('This is the root page')
+            using_session :different_session do
+              visit '/different_page'
+              expect(page.body).to include('This is a different page')
+              click_on "you'll never find me"
+            end
+          end
+        end
+      RUBY
+      check_file_content('tmp/screenshot.html', 'This is a different page', true)
+    end
+
+    context 'pruning' do
+      before do
+        create_screenshot_for_pruning
+        configure_prune_strategy :last_run
+      end
+
+      it 'on failure it prunes previous screenshots when strategy is set' do
+        run_failing_case <<-RUBY, 'HTML screenshot:', :progress
+          feature 'screenshot with failure' do
+            scenario 'click on a missing link' do
+              visit '/'
+              click_on "you'll never find me"
+            end
+          end
+        RUBY
+        assert_screenshot_pruned
+      end
+
+      it 'on success it never prunes' do
+        run_case <<-CUCUMBER, assert_all_passed: true
+          feature 'screenshot without failure' do
+            scenario 'click on a link' do
+              visit '/'
+            end
+          end
+        CUCUMBER
+        assert_screenshot_not_pruned
+      end
+    end
+
+    context 'no pruning by default' do
+      before do
+        create_screenshot_for_pruning
+      end
+
+      it 'on failure it leaves existing screenshots' do
+        run_failing_case <<-RUBY, 'HTML screenshot:', :progress
+          feature 'screenshot with failure' do
+            scenario 'click on a missing link' do
+              visit '/'
+              click_on "you'll never find me"
+            end
+          end
+        RUBY
+        assert_screenshot_not_pruned
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,29 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper.rb"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+$: << '../lib'
+require 'rspec'
+require 'capybara-screenshot'
+require 'capybara-screenshot/rspec'
+require 'timecop'
+require 'aruba/api'
+require 'aruba/jruby'
+
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |f| require f }
+
+RSpec.configure do |config|
+  if RSpec::Core::Version::STRING.to_i == 2
+    config.treat_symbols_as_metadata_keys_with_true_values = true
+  end
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+  config.before do
+    @aruba_timeout_seconds = 60
+  end if RUBY_PLATFORM == 'java'
+end
+
+Capybara.app = lambda { |env| [200, {}, ["OK"]] }

data/spec/spinach/spinach_spec.rb

@@ -0,0 +1,64 @@
+require "spec_helper"
+
+describe "Using Capybara::Screenshot with Spinach" do
+  include CommonSetup
+
+  before do
+    clean_current_dir
+  end
+
+  def run_failing_case(failure_message, code)
+    write_file('steps/failure.rb', <<-RUBY)
+      #{ensure_load_paths_valid}
+      require 'spinach/support/spinach_failure.rb'
+      #{setup_test_app}
+    RUBY
+
+    write_file('spinach.feature', code)
+    cmd = 'bundle exec spinach -f .'
+    run_simple_with_retry cmd, false
+    expect(output_from(cmd)).to match failure_message
+  end
+
+  it "saves a screenshot on failure" do
+    run_failing_case(%q{Unable to find link or button "you'll never find me"}, <<-GHERKIN)
+      Feature: Failure
+        Scenario: Failure
+          Given I visit "/"
+          And I click on a missing link
+    GHERKIN
+    check_file_content('tmp/my_screenshot.html', 'This is the root page', true)
+  end
+
+  it "saves a screenshot on an error" do
+    run_failing_case(%q{you can't handle me}, <<-GHERKIN)
+      Feature: Failure
+        Scenario: Failure
+          Given I visit "/"
+          And I trigger an unhandled exception
+    GHERKIN
+    check_file_content('tmp/my_screenshot.html', 'This is the root page', true)
+  end
+
+  it "saves a screenshot for the correct session for failures using_session" do
+    run_failing_case(%q{Unable to find link or button "you'll never find me"}, <<-GHERKIN)
+      Feature: Failure
+        Scenario: Failure in different session
+          Given I visit "/"
+          And I click on a missing link on a different page in a different session
+    GHERKIN
+    check_file_content('tmp/my_screenshot.html', 'This is a different page', true)
+  end
+
+  it 'on failure it prunes previous screenshots when strategy is set' do
+    create_screenshot_for_pruning
+    configure_prune_strategy :last_run
+    run_failing_case(%q{Unable to find link or button "you'll never find me"}, <<-GHERKIN)
+      Feature: Failure
+        Scenario: Failure
+          Given I visit "/"
+          And I click on a missing link
+    GHERKIN
+    assert_screenshot_pruned
+  end
+end