capybara_minitest_spec 0.2.0 → 0.2.1

data/README.md

@@ -1,10 +1,8 @@
-Capybara MiniTest Spec
-======================
+# Capybara MiniTest Spec
 
 Define MiniTest::Spec expectations for Capybara node matchers.
 
-Description
------------
+## Description
 
 If you like using Capybara and RSpec, you're used to matchers like:
 
@@ -14,19 +12,45 @@ Now you can have similar functionality while using MiniTest::Spec:
 
     page.must_have_content('Title')
 
-Install
--------
+## Install
 
     gem install caypbara_minitest_spec
 
-Compatibility
--------------
+## Usage
+
+The gem iterates through all of Capybara::Node's matcher methods and defines these things for each one:
+
+* positive assertion:   assert_page_has_css(page, 'h1')
+* positive expectation: page.must_have_css('h1')
+* negative assertion:   refute_page_has_css(page, 'h1')
+* negative expectation: page.wont_have_css('h1')
+
+### Custom Expectations
+
+If you want to add your own custom page expectations, it's easy.
+
+```ruby
+# First define a Capybara session method so that
+# page.has_flash_message?(message) is available.
+class Capybara::Session
+  def has_flash_message?(message)
+    within '#flash' do
+      has_content? message
+    end
+  end
+end
+# Then create a new CapybaraMiniTestSpec::Matcher.
+CapybaraMiniTestSpec::Matcher.new(:has_flash_message?)
+```
+
+Now you can do `page.must_have_flash_message('Successfully created')`
+
+## Compatibility
 
 In theory, this should work with any version of Capybara, so the runtime dependency is not version specific. At the time of this writing, it was tested with Capybara 1.1.1.
 
 
-Testing
--------
+## Testing
 
 This gem was tested by basically copying the Capybara spec located in 'spec/rspec/matchers_spec.rb' and altering the test to run with MiniTest.
 Capybara uses xpath as a submodule of the git repository. When adding this gem to gemtesters (http://test.rubygems.org/gems/capybara_minitest_spec), it sounded like too much trouble to check out the submodule, so I just used the regular gem.

data/lib/capybara_minitest_spec/matcher.rb

@@ -5,6 +5,7 @@ module CapybaraMiniTestSpec
 
     def initialize(node_matcher_name)
       @name = Name.new(node_matcher_name, true)
+      define_expectations
     end
 
     def define_expectations

data/lib/capybara_minitest_spec/version.rb

@@ -1,3 +1,3 @@
 module CapybaraMiniTestSpec
-  VERSION = '0.2.0'
+  VERSION = '0.2.1'
 end

data/lib/capybara_minitest_spec.rb

@@ -7,6 +7,5 @@ require "capybara_minitest_spec/version"
 # define positive and negative MiniTest::Unit assertions and
 # infect it both assertions to create MiniTest::Spec expectations.
 Capybara::Node::Matchers.public_instance_methods.each do |matcher_name|
-  matcher = CapybaraMiniTestSpec::Matcher.new(matcher_name)
-  matcher.define_expectations
+  CapybaraMiniTestSpec::Matcher.new(matcher_name)
 end

data/test/custom_matcher_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+class Capybara::Session
+  def has_flash_message?(message)
+    within '#flash' do
+      has_content? message
+    end
+  end
+end
+CapybaraMiniTestSpec::Matcher.new(:has_flash_message?)
+
+describe 'Custom matcher' do
+  include Capybara::DSL
+
+  before :each do
+    Capybara.default_selector = :css
+    visit '/flash_message'
+  end
+
+  after { Capybara.default_selector = :xpath }
+
+  it 'works with positive expectation' do
+    page.must_have_flash_message 'Barry Allen'
+  end
+
+  it 'works with negative expectation' do
+    page.wont_have_flash_message 'The Blob'
+  end
+end

data/test/spec_helper.rb

@@ -12,12 +12,3 @@ MiniTest::Spec.register_spec_type //, MiniTest::Spec
 $LOAD_PATH << File.join(__FILE__, '../../test_app')
 require 'test_app'
 Capybara.app = TestApp
-
-# Set Capybara default selector to xpath.
-class MiniTest::Spec
-  before :each do
-    Capybara.configure do |config|
-      config.default_selector = :xpath
-    end
-  end
-end

data/test_app/test_app.rb

@@ -6,6 +6,10 @@ class TestApp < Sinatra::Base
   set :root, File.dirname(__FILE__)
   set :static, true
 
+  get '/flash_message' do
+    '<div id="flash">Barry Allen</div>'
+  end
+
   get '/' do
     'Hello world! <a href="with_html">Relative</a>'
   end

metadata

@@ -2,7 +2,7 @@
 name: capybara_minitest_spec
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors: 
 - Jared Ning
@@ -68,6 +68,7 @@ files:
 - lib/capybara_minitest_spec/matcher.rb
 - lib/capybara_minitest_spec/version.rb
 - test/capybara_node_matchers_spec.rb
+- test/custom_matcher_spec.rb
 - test/matcher_spec.rb
 - test/spec_helper.rb
 - test_app/driver.rb
@@ -157,5 +158,6 @@ specification_version: 3
 summary: MiniTest::Spec expectations for Capybara node matchers.
 test_files: 
 - test/capybara_node_matchers_spec.rb
+- test/custom_matcher_spec.rb
 - test/matcher_spec.rb
 - test/spec_helper.rb