capybara-minitest 0.9.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4b1cd121160c99cd542ea847802338679aa51728
+  data.tar.gz: 08c55103d678da5813148afd32d6e49dd879f41e
+SHA512:
+  metadata.gz: 6cf690e631a6f76e599e2b23d621cf34ba710ad732d97fe4d3a26df2cacb96ce599bfc41c3d3dd7ff00ec535e1dd67e41c2724af27a8381dd593a080da73613b
+  data.tar.gz: 9d995ed346f53c4d396de8bb425376ec4e580a2f2ee3751cc11ad6fdc3133b19303f5171f4fb220da2dd8f3edd64fd40d736fd2c67ab57e41600246c3bc7a572

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Dennis Stevense
+
+MIT License
+
+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,74 @@
+Capybara::Minitest
+==================
+
+[![Gem Version](https://badge.fury.io/rb/capybara-minitest.svg)](http://badge.fury.io/rb/capybara-minitest)
+[![Dependency Status](https://gemnasium.com/decafdennis/capybara-minitest.svg)](https://gemnasium.com/decafdennis/capybara-minitest)
+[![Build Status](https://travis-ci.org/decafdennis/capybara-minitest.svg?branch=master)](https://travis-ci.org/decafdennis/capybara-minitest)
+[![Code Climate](https://codeclimate.com/github/decafdennis/capybara-minitest/badges/gpa.svg)](https://codeclimate.com/github/decafdennis/capybara-minitest)
+[![Coverage Status](https://coveralls.io/repos/decafdennis/capybara-minitest/badge.png)](https://coveralls.io/r/decafdennis/capybara-minitest)
+[![Inline docs](http://inch-ci.org/github/decafdennis/capybara-minitest.svg?branch=master)](http://inch-ci.org/github/decafdennis/capybara-minitest)
+
+If you're using `Minitest::Test` with the `Capybara::DSL` for your tests, this
+gem will allow you to do:
+
+```ruby
+# With Capybara::Minitest::Assertions included
+assert_has_text page, 'Squeak', 'optional message'
+```
+
+instead of:
+
+```ruby
+# Without Capybara::Minitest
+assert page.has_text?('Squeak'), 'optional message'
+```
+
+The assertions are dynamically generated from Capybara's RSpec matchers. You can
+optionally provide custom failure messages and the backtrace will be cleaned up
+for you.
+
+You can see the full list of assertions (and refutations) in the
+[auto-generated RDoc](https://github.com/decafdennis/capybara-minitest/blob/master/lib/capybara/minitest/assertions/rdoc.rb).
+
+## Install
+
+```ruby
+# Gemfile
+gem 'capybara-minitest'
+```
+
+## Usage
+
+```ruby
+require 'capybara/minitest/assertions'
+
+class AcceptanceTest < Minitest::Test
+  include Capybara::DSL
+  include Capybara::Minitest::Assertions
+end
+```
+
+Or, if you're using Rails:
+
+```ruby
+require 'capybara/minitest/assertions'
+
+class AcceptanceTest < ActionDispatch::IntegrationTest
+  include Capybara::DSL
+  include Capybara::Minitest::Assertions
+end
+```
+
+## Example
+
+```ruby
+class RodentTest < Minitest::Test
+  include Capybara::DSL
+  include Capybara::Minitest::Assertions
+
+  def test_squeak
+    visit '/rodent'
+    assert_has_text page, 'Squeak', 'optional message'
+  end
+end
+```

data/lib/capybara-minitest.rb

@@ -0,0 +1,4 @@
+require 'capybara-minitest/version'
+
+module CapybaraMinitest
+end

data/lib/capybara-minitest/version.rb

@@ -0,0 +1,3 @@
+module CapybaraMinitest
+  VERSION = '0.9.2'
+end

data/lib/capybara/minitest.rb

@@ -0,0 +1,5 @@
+module Capybara
+  # Provides minitest extensions for Capybara.
+  module Minitest
+  end
+end

data/lib/capybara/minitest/assertions.rb

@@ -0,0 +1,42 @@
+require 'capybara/minitest/assertions/matcher'
+require 'capybara/minitest/assertions/rdoc'
+
+module Capybara
+  module Minitest
+    # Include this module in your minitest tests to get assertions based on
+    # Capybara's RSpec matchers.
+    module Assertions
+      # Define assertions for each of the RSpec matchers that come with
+      # Capybara.
+      Matcher.all.each do |matcher|
+        matcher.assertions.each do |assertion|
+          define_method assertion.name do |*args|
+            # We typically get a minimum of 2 arguments: the test subject and
+            # some test value. Sometimes that is followed by a hash of options.
+            # Assume if the last argument is a string, then it's a custom
+            # message.
+            if args.length > 2 && args.last.is_a?(String)
+              custom_message = args.pop
+            else
+              custom_message = nil
+            end
+
+            test_result, failure_message = assertion.test(*args)
+
+            begin
+              assert test_result, message(custom_message) { failure_message }
+            rescue Exception => e
+              # Exclude ourselves from the backtrace, so that assertion failure
+              # messages show the right file and line number.
+              if e.class.name.include?('::Assertion')
+                e.backtrace.reject! { |item| item.include?(__FILE__) }
+              end
+
+              raise e
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/capybara/minitest/assertions/matcher.rb

@@ -0,0 +1,125 @@
+require 'capybara/rspec/matchers'
+
+module Capybara
+  module Minitest
+    module Assertions
+      # Represents one of the Capybara RSpec matchers.
+      class Matcher
+        include Capybara::RSpecMatchers
+
+        # Returns an array of matchers representing the recognized Capybara
+        # RSpec matchers.
+        def self.all
+          Capybara::RSpecMatchers.public_instance_methods.map do |matcher_name|
+            new(matcher_name) if recognizes_name?(matcher_name)
+          end.compact
+        end
+
+        # Determines whether the given RSpec matcher is recognized by this
+        # class.
+        def self.recognizes_name?(name)
+          name.to_s.match(/^have_/)
+        end
+
+        # The name of the RSpec matcher, e.g. have_text.
+        attr_reader :name
+
+        # Initializes a new matcher based on the given RSpec matcher name.
+        def initialize(name)
+          unless self.class.recognizes_name?(name)
+            fail ArgumentError, 'Unrecognized matcher name.'
+          end
+
+          @name = name.to_s
+        end
+
+        # Returns the matcher's name in third person.
+        #
+        #   matcher.name              # => have_text (infinitive form)
+        #   matcher.third_person_name # => has_text  (third person form)
+        #
+        def third_person_name
+          @third_person_name ||= @name.gsub(/^have_/, 'has_')
+        end
+
+        # Returns a new Capybara RSpec matcher object for the given matcher
+        # arguments. This is what would be returned by have_text('Foo'), for
+        # example.
+        def matcher(*args)
+          send(@name, *args)
+        end
+
+        # Returns a new array of assertions for this matcher.
+        def assertions
+          [MatcherAssertion.new(self), MatcherRefutation.new(self)]
+        end
+      end
+
+      # Represents an assertion based on a Capybara RSpec matcher.
+      class MatcherAssertion
+        # The matcher this assertion is based on.
+        attr_reader :matcher
+
+        # Initializes a new assertion with the given matcher.
+        def initialize(matcher)
+          @matcher = matcher
+        end
+
+        # The name of the assertion.
+        #
+        #   assertion.matcher.name # => have_text
+        #   assertion.name         # => assert_has_text
+        #
+        def name
+          "#{self.class.name_prefix}_#{@matcher.third_person_name}"
+        end
+
+        # Executes the assertion by testing it against the matcher on the given
+        # test subject and with the provided arguments. Returns an array with
+        # the test result (as a boolean) and the failure message.
+        def test(subject, *args)
+          # Create an RSpec matcher object.
+          matcher = @matcher.matcher(*args)
+          # Perform the match.
+          test_result = matcher.send(self.class.matcher_test_method, subject)
+          # Get the failure message, which has to be done after the matching.
+          failure_message = matcher.send(self.class.matcher_failure_message_method)
+
+          [test_result, failure_message]
+        end
+
+        # The prefix for method names of this kind of assertion.
+        def self.name_prefix
+          'assert'
+        end
+
+        # The test method called on the RSpec matcher for this kind of
+        # assertion.
+        def self.matcher_test_method
+          :matches?
+        end
+
+        # The failure message method called on the RSpec matcher for this kind
+        # of assertion.
+        def self.matcher_failure_message_method
+          :failure_message
+        end
+      end
+
+      # Represents a refutation based on a Capybara RSpec matcher.
+      class MatcherRefutation < MatcherAssertion
+        def self.name_prefix
+          'refute'
+        end
+
+        def self.matcher_test_method
+          :does_not_match?
+        end
+
+        def self.matcher_failure_message_method
+          :failure_message_when_negated
+        end
+      end
+    end
+  end
+end

data/lib/capybara/minitest/assertions/rdoc.rake

@@ -0,0 +1,31 @@
+require 'erb'
+require 'capybara/minitest/assertions/matcher'
+
+BASE_FILE = __FILE__.chomp('.rake')
+TEMPLATE_FILE = "#{BASE_FILE}.rb.erb"
+OUTPUT_FILE = "#{BASE_FILE}.rb"
+
+module Capybara
+  module Minitest
+    module Assertions
+      # Context for rdoc.rb.erb.
+      class RDocTemplate
+        extend ERB::DefMethod
+        def_erb_method 'render', TEMPLATE_FILE
+
+        def initialize
+          @assertion_names = Matcher.all.map do |matcher|
+            matcher.assertions.map(&:name)
+          end.flatten
+        end
+      end
+    end
+  end
+end
+
+desc 'Regenerate the RDoc for the Capybara assertions.'
+task OUTPUT_FILE do
+  File.open(OUTPUT_FILE, 'w') do |f|
+    f.write(Capybara::Minitest::Assertions::RDocTemplate.new.render)
+  end
+end

data/lib/capybara/minitest/assertions/rdoc.rb

@@ -0,0 +1,37 @@
+# This file is auto-generated. To regenerate:
+# $ rake lib/capybara/minitest/assertions/rdoc.rb
+
+module Capybara
+  module Minitest
+    module Assertions
+      # Provide documentation for dynamically defined assertion methods.
+      # :method: assert_has_selector
+      # :method: refute_has_selector
+      # :method: assert_has_xpath
+      # :method: refute_has_xpath
+      # :method: assert_has_css
+      # :method: refute_has_css
+      # :method: assert_has_text
+      # :method: refute_has_text
+      # :method: assert_has_content
+      # :method: refute_has_content
+      # :method: assert_has_title
+      # :method: refute_has_title
+      # :method: assert_has_link
+      # :method: refute_has_link
+      # :method: assert_has_button
+      # :method: refute_has_button
+      # :method: assert_has_field
+      # :method: refute_has_field
+      # :method: assert_has_checked_field
+      # :method: refute_has_checked_field
+      # :method: assert_has_unchecked_field
+      # :method: refute_has_unchecked_field
+      # :method: assert_has_select
+      # :method: refute_has_select
+      # :method: assert_has_table
+      # :method: refute_has_table
+      
+    end
+  end
+end

data/lib/capybara/minitest/assertions/rdoc.rb.erb

@@ -0,0 +1,12 @@
+# This file is auto-generated. To regenerate:
+# $ rake lib/capybara/minitest/assertions/rdoc.rb
+
+module Capybara
+  module Minitest
+    module Assertions
+      # Provide documentation for dynamically defined assertion methods.
+      <% @assertion_names.each do |assertion_name| %># :method: <%= assertion_name %>
+      <% end %>
+    end
+  end
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: capybara-minitest
+version: !ruby/object:Gem::Version
+  version: 0.9.2
+platform: ruby
+authors:
+- Dennis Stevense
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-10-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.4'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+description: Provides assertions for minitest based on Capybara's RSpec matchers.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/capybara-minitest.rb
+- lib/capybara-minitest/version.rb
+- lib/capybara/minitest.rb
+- lib/capybara/minitest/assertions.rb
+- lib/capybara/minitest/assertions/matcher.rb
+- lib/capybara/minitest/assertions/rdoc.rake
+- lib/capybara/minitest/assertions/rdoc.rb
+- lib/capybara/minitest/assertions/rdoc.rb.erb
+homepage: https://github.com/decafdennis/capybara-minitest
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- - lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Capybara assertions for minitest.
+test_files: []