rspec-tag_matchers 0.1.0 → 0.1.1

data/README.rdoc

@@ -22,7 +22,7 @@ containing HTML (this includes Nokogiri classes). They assume Rails conventions.
 <tt>rspec-tag_matchers</tt> is tested against Ruby 1.8.7, 1.9.2, 1.9.3, REE,
 Rubinius (1.8 mode) and JRuby.
 
-{<img src="http://travis-ci.org/dcuddeback/rspec-tag_matchers.png?branch=master" />}[http://travis-ci.org/dcuddeback/rspec-tag_matchers]
+{<img src="https://secure.travis-ci.org/dcuddeback/rspec-tag_matchers.png?branch=master" />}[http://travis-ci.org/dcuddeback/rspec-tag_matchers]
 
 The library is well tested, but the collection of matchers is incomplete. I'm adding more on an
 as-needed basis.  Please feel free to fork this repository to add your own then send me a pull

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

data/lib/rspec/tag_matchers/has_date_select.rb

@@ -0,0 +1,140 @@
+require 'rspec/tag_matchers/multiple_input_matcher'
+
+module RSpec::TagMatchers
+  # Matches inputs generated by Rails' +date_select+ helper.
+  #
+  # @modifier discard
+  #   Specifies that one or more components of the date are discarded in the +date_select+ helper.
+  #   For example, <tt>discard(:day)</tt> should match the output of a +date_select+ helper that was
+  #   given the option <tt>:discard_day => true</tt>. Note that this changes the matching criteria
+  #   to expect a hidden input instead of a +<select>+ element for the components specified.
+  #
+  # @example Matching a date select for an event's +start_date+
+  #   it { should have_date_select.for(:event => :start_date) }
+  #
+  # @example Matching a date select for a credit card expiration
+  #   it { should have_date_select.discard(:day).for(:credit_card => :expiration) }
+  #
+  # @see HasDateSelect#discard
+  #
+  # @return [HasDateSelect]
+  def have_date_select
+    HasDateSelect.new
+  end
+
+  # A matcher that matches Rails' +date_select+ drop-downs.
+  class HasDateSelect < MultipleInputMatcher
+    include Helpers::SentenceHelper
+
+    # Initializes a HasDateSelect matcher.
+    def initialize
+      super('1i' => HasSelect.new, '2i' => HasSelect.new, '3i' => HasSelect.new)
+    end
+
+    # Specifies that one or more components of the date will be hidden by Rails' +date_select+
+    # helper. For example, calling +date_select+ with the option <tt>:discard_day => true</tt>
+    # produces two +<select>+ elments (for the year and month components) and one hidden input for
+    # the date component:
+    #
+    #   <select name="model[date(1i)]">...</select>
+    #   <select name="model[date(2i)]">...</select>
+    #   <input type="hidden" name="model[date(3i)]" />
+    #
+    # Since the default is to match three +<select>+ elements, one must call +discard(:day)+ to tell
+    # a HasDateSelect matcher to expect a hidden input for the third component.
+    #
+    # @note This modifier replaces the matchers for the given date components. Any modifiers that
+    #   were called before this one will be lost for those matchers. Therefor, +discard+ should be
+    #   called before other modifiers, such as +for+. For example, the following matcher
+    #   will only test the input names for the month and day components.
+    #
+    #     it { should have_date_select.for(:start_date).discard(:year) }
+    #
+    #   In order to test the input names for all three components, the +for+ modifier must come
+    #   after the +discard+ modifier:
+    #
+    #     it { should have_date_select.discard(:year).for(:start_date) }
+    #
+    # @param [Symbols]  *parts  A variable number of symbols specifying which components should be
+    #                           discarded. Valid symbols are +:year+, +:month+, and +:day+.
+    #
+    # @return [HasDateSelect] self
+    def discard(*parts)
+      @discard ||= []
+      @discard  += parts
+
+      parts.each do |part|
+        # TODO: create a HasHiddenInput matcher
+        replace_matcher(part, HasInput.new.with_attribute(:type => :hidden))
+      end
+      self
+    end
+
+    # Returns a description of the matcher's criteria.
+    #
+    # @return [String]
+    def description
+      [basic_description, extra_description].compact.reject(&:empty?).join(" ")
+    end
+
+    # Returns an explanation of why the matcher failed to match with +should+.
+    #
+    # @return [String]
+    def failure_message
+      "expected document to #{description}; got: #{@rendered}"
+    end
+
+    # Returns an explanation of why the matcher failed to match with +should_not+.
+    #
+    # @return [String]
+    def negative_failure_message
+      "expected document to not #{description}; got: #{@rendered}"
+    end
+
+    private
+
+    # Replaces the matcher for the given date component.
+    #
+    # @param [Symbol]   part          The date component whose matcher should be replaced.
+    # @param [HasInput] new_matcher   The matcher to replace the old one.
+    def replace_matcher(part, new_matcher)
+      key = key_for(part)
+      @components[key] = new_matcher.with_attribute(:name => /\(#{key}\)/)
+    end
+
+    # Looks up the key for the given date component.
+    #
+    # @param [Symbol] part  A date component (+:year+, +:month+, or +:day+).
+    #
+    # @return [String] The requested key
+    def key_for(part)
+      {
+        :year  => '1i',
+        :month => '2i',
+        :day   => '3i'
+      }[part]
+    end
+
+    # Returns a basic description.
+    #
+    # @return [String]
+    def basic_description
+      "have date select"
+    end
+
+    # Provides an extra description fragment that can be appended to the basic description.
+    #
+    # @return [String]
+    def extra_description
+      [for_description, discard_description].compact.join(" ")
+    end
+
+    def for_description
+      "for #{@for.join(".")}" if @for
+    end
+
+    def discard_description
+      "without #{make_sentence(@discard, :conjunction => "or")}" if @discard
+    end
+  end
+end

data/lib/rspec/tag_matchers/has_input.rb

@@ -6,10 +6,16 @@ module RSpec::TagMatchers
   # @modifier for
   #   Adds a criteria that the input must be for the given attribute.
   #
+  # @modifier value
+  #   Adds a criteria that the input must have a given value.
+  #
   # @example Matching an input for the +name+ attribute on +user+
   #   it { should have_input.for(:user => :name) }
   #   it { should have_input.for(:user, :name) }
   #
+  # @example Matching an input with a value of <tt>"42"</tt>.
+  #   it { should have_input.value("42") }
+  #
   # @return [HasInput]
   #
   # @see HasInput#for
@@ -88,6 +94,15 @@ module RSpec::TagMatchers
       self
     end
 
+    # Adds a criteria that the input's value must match a certain value.
+    #
+    # @param [String, Symbol, Regexp, true, false]  value
+    #
+    # @return [HasInput] self
+    def value(value)
+      with_attribute(:value => value)
+    end
+
     private
 
     # Converts an array or hash of names to a name for an input form.

data/lib/rspec/tag_matchers/has_tag.rb

@@ -90,6 +90,7 @@ module RSpec::TagMatchers
   # provide additional methods that can be chained from the matcher to provide tag-specific
   # criteria. See {HasTag#with_criteria} for how to add custom criteria to a matcher.
   class HasTag
+    include Helpers::SentenceHelper
 
     # Constructs a matcher that matches HTML tags by +name+.
     #
@@ -100,6 +101,27 @@ module RSpec::TagMatchers
       @criteria   = []
     end
 
+    # Returns a description of the matcher's criteria. The description is used in RSpec's output.
+    #
+    # @return [String]
+    def description
+      "have #{@name.inspect} tag #{extra_description}".strip
+    end
+
+    # Returns an explanation of why the matcher failed to match with +should+.
+    #
+    # @return [String]
+    def failure_message
+      "expected document to #{description}; got: #{@rendered}"
+    end
+
+    # Returns an explanation of why the matcher failed to match with +should_not+.
+    #
+    # @return [String]
+    def negative_failure_message
+      "expected document to not #{description}; got: #{@rendered}"
+    end
+
     # Answers whether or not the matcher matches any elements within +rendered+.
     #
     # @param [String] rendered    A string of HTML or an Object whose +to_s+ method returns HTML.
@@ -107,7 +129,8 @@ module RSpec::TagMatchers
     #
     # @return [Boolean]
     def matches?(rendered)
-      Nokogiri::HTML::Document.parse(rendered.to_s).css(@name).select do |element|
+      @rendered = rendered
+      Nokogiri::HTML::Document.parse(@rendered.to_s).css(@name).select do |element|
         matches_attributes?(element) && matches_criteria?(element)
       end.length > 0
     end
@@ -189,7 +212,6 @@ module RSpec::TagMatchers
 
     private
 
-
     # Answers whether or not +element+ matches the attributes in the attributes hash given to
     # {#with_attribute}.
     #
@@ -217,5 +239,85 @@ module RSpec::TagMatchers
         end
       end
     end
+
+    # Provides extra description that can be appended to the basic description.
+    #
+    # @return [String]
+    def extra_description
+      attributes_description
+    end
+
+    # Returns a description of the attribute criteria. For example, the description of an attribute
+    # criteria of <tt>with_attribute(:foo => "bar")</tt> will look like <tt>'with attribute
+    # foo="bar"'</tt>.
+    #
+    # @return [String]
+    def attributes_description
+      grouped_attributes = @attributes.group_by { |key, value| !!value }
+
+      make_sentence(
+        # Yes, this is functionally equivalent to grouped_attributes.map, except this forces the
+        # keys to be evalutated in the order [true, false]. This is necessary to maintain
+        # compatibility with Ruby 1.8.7, because hashes in 1.8.7 aren't ordered.
+        [true, false].reduce([]) do |memo, group_key|
+          attributes = grouped_attributes[group_key]
+
+          if attributes
+            memo << grouped_attributes_prefix(group_key, attributes.count > 1) +
+              grouped_attributes_description(attributes)
+          end
+
+          memo
+        end
+      )
+    end
+
+    # Provides a prefix that can be used before a list of attribute criteria. Possible oututs are
+    # <tt>"with attribute"</tt>, <tt>"with attributes"</tt>, <tt>"without attribute"</tt>, and
+    # <tt>"without attributes"</tt>.
+    #
+    # @param [Boolean] value    Whether this should prefix inclusive attributes. Selects between
+    #                           <tt>"with"</tt> and <tt>"without"</tt>.
+    # @param [Boolean] plural   Whether this prefixes multiple attributes. Selects between
+    #                           <tt>"attribute"</tt> and <tt>"attributes"</tt>.
+    #
+    # @return [String]
+    def grouped_attributes_prefix(value, plural)
+      (value ? "with " : "without ") + (plural ? "attributes " : "attribute ")
+    end
+
+    # Describes a group of attribute criteria, combining them into a sentence fragment, with
+    # punctuation and conjunctions if necessary.
+    #
+    # @param [Array] attributes   A list of <tt>[key, value]</tt> pairs that describe the attribute
+    #                             criteria.
+    #
+    # @return [String]
+    def grouped_attributes_description(attributes)
+      make_sentence(
+        attributes.sort_by{ |key, value| key.to_s }.map do |key, value|
+          attribute_description(key, value)
+        end
+      )
+    end
+
+    # Returns a string describing the criteria for matching attribute +key+ with +value+.
+    #
+    # @param [Symbol] key     The attribute's key.
+    # @param [Object] value   The attribute's expected value.
+    #
+    # @return [String]
+    def attribute_description(key, value)
+      case value
+      when true
+        "#{key}=anything"
+      when false
+        key.to_s
+      when Regexp
+        "#{key}=~#{value.inspect}"
+      else
+        "#{key}=#{value.inspect}"
+      end
+    end
   end
 end

data/lib/rspec/tag_matchers/has_time_select.rb

@@ -16,7 +16,45 @@ module RSpec::TagMatchers
 
     # Initializes a HasTimeSelect matcher.
     def initialize
-      super(4 => HasSelect.new, 5 => HasSelect.new)
+      super('4i' => HasSelect.new, '5i' => HasSelect.new)
     end
+
+    # Returns a description of the matcher's criteria.
+    #
+    # @return [String]
+    def description
+      [basic_description, extra_description].compact.join(" ")
+    end
+
+    # Returns an explanation of why the matcher failed to match with +should+.
+    #
+    # @return [String]
+    def failure_message
+      "expected document to #{description}; got: #{@rendered}"
+    end
+
+    # Returns an explanation of why the matcher failed to match with +should_not+.
+    #
+    # @return [String]
+    def negative_failure_message
+      "expected document to not #{description}; got: #{@rendered}"
+    end
+
+    private
+
+    # Returns a basic description.
+    #
+    # @return [String]
+    def basic_description
+      "have time select"
+    end
+
+    # Provides an extra description fragment that can be appended to the basic description.
+    #
+    # @return [String]
+    def extra_description
+      "for #{@for.join(".")}" if @for
+    end
+
   end
 end

data/lib/rspec/tag_matchers/helpers/sentence_helper.rb

@@ -0,0 +1,38 @@
+module RSpec::TagMatchers::Helpers
+  module SentenceHelper
+    # Joins multiple strings into a sentence with punctuation and conjunctions.
+    #
+    # @example Forming sentences
+    #   make_sentence("foo")                # => "foo"
+    #   make_sentence("foo", "bar")         # => "foo and bar"
+    #   make_sentence("foo", "bar", "baz")  # => "foo, bar, and baz"
+    #
+    # @example Overriding the conjunction
+    #   make_sentence("foo", "bar", "baz", :conjunction => "or")  # => "foo, bar, or baz"
+    #
+    # @param [Strings] *strings   A list of strings to be combined into a sentence. The last item
+    #                             can be an options hash.
+    #
+    # @option *strings.last [String] :conjunction ("and")   The conjunction to use to join sentence
+    #                                                       fragments.
+    #
+    # @return [String]
+    def make_sentence(*strings)
+      options     = strings.last.is_a?(Hash) ? strings.pop : {}
+      strings     = strings.flatten.map(&:to_s).reject(&:empty?)
+      conjunction = options[:conjunction] || "and"
+
+      case strings.count
+      when 0
+        ""
+      when 1
+        strings.first
+      else
+        last       = strings.pop
+        puncuation = strings.count > 1 ? ", " : " "
+
+        [strings, "#{conjunction} #{last}"].flatten.join(puncuation)
+      end
+    end
+  end
+end

data/lib/rspec/tag_matchers/multiple_input_matcher.rb

@@ -6,9 +6,9 @@ module RSpec::TagMatchers
   #
   # @example Building a date matcher
   #   matcher = MultipleInputMatcher.new(
-  #       1 => HasSelect.new,
-  #       2 => HasSelect.new,
-  #       3 => HasSelect.new
+  #       '1i' => HasSelect.new,
+  #       '2i' => HasSelect.new,
+  #       '3i' => HasSelect.new
   #     )
   #   matcher.for(:user => :birthday) # will match <select> tags with names
   #                                   # "user[birthday(1i)]", "user[birthday(2i)]", and
@@ -16,21 +16,20 @@ module RSpec::TagMatchers
   #
   # @example Building a time matcher
   #   MultipleInputMatcher.new(       # by default, will match <select> tags with names by regular
-  #       4 => HasSelect.new,         # expressions: /\(4i\)/ and /\(5i\)/
-  #       5 => HasSelect.new
+  #       '4i' => HasSelect.new,      # expressions: /\(4i\)/ and /\(5i\)/
+  #       '5i' => HasSelect.new
   #     )
-  #
-  #
   class MultipleInputMatcher
 
     # Initializes a matcher that matches multiple input elements.
     #
-    # @param [Hash] components  A hash of matchers. The keys serve as indices and the values are the
-    #                           matchers that must be satisfied.
+    # @param [Hash] components  A hash of matchers. The keys should be the keys used in Rails'
+    #                           multi-parameter assignment, e.g., <tt>"1i"</tt>, <tt>"2s"</tt>, etc,
+    #                           and the values are the matchers that must be satisfied.
     def initialize(components)
       @components = components
-      @components.each do |index, matcher|
-        matcher.with_attribute(:name => /\(#{index}i\)/)
+      @components.each do |key, matcher|
+        matcher.with_attribute(:name => /\(#{key}\)/)
       end
     end
 
@@ -43,6 +42,7 @@ module RSpec::TagMatchers
     #
     # @return [Boolean]
     def matches?(rendered)
+      @rendered = rendered
       @failures = matchers.reject do |matcher|
         matcher.matches?(rendered)
       end
@@ -50,14 +50,14 @@ module RSpec::TagMatchers
       @failures.empty?
     end
 
-    # Specifies the inputs names with more accuracy than the default regular expressions. It
-    # delegates to each matcher's +for+ method. But it first appends the matcher's index to the last
+    # Specifies the inputs' names with more accuracy than the default regular expressions. It
+    # delegates to each matcher's +for+ method. But it first appends the matcher's key to the last
     # component of the input's name.
     #
     # @example Input naming delegation
     #   hour_matcher   = HasSelect.new
     #   minute_matcher = HasSelect.new
-    #   time_matcher   = MultipleInputMatcher.new(4 => hour_matcher, 5 => minute_matcher)
+    #   time_matcher   = MultipleInputMatcher.new('4i' => hour_matcher, '5i' => minute_matcher)
     #
     #   time_matcher.for(:event => :start_time) # calls hour_matcher.for("event", "start_time(4i)")
     #                                           # and minute_matcher.for("event", "start_time(5i)")
@@ -66,8 +66,12 @@ module RSpec::TagMatchers
     #
     # @return [MultipleInputMatcher] self
     def for(*args)
+      @for = args.dup
+      @for.extend(DeepFlattening)
+      @for = @for.deep_flatten
+
       @components.each do |index, matcher|
-        delegated_for(index, matcher, args)
+        delegated_for(index, matcher, @for)
       end
       self
     end
@@ -95,19 +99,16 @@ module RSpec::TagMatchers
       @components.values
     end
 
-    # Set's +matcher+'s input name according to +args+ and +index+.
+    # Set's +matcher+'s input name according to +args+ and +key+.
     #
-    # @param [Integer]      index   The matcher's index.
+    # @param [String]       key     The matcher's key.
     # @param [HasInput]     matcher The matcher.
     # @param [Arrah, Hash]  args    A hierarchy of names that would normally be passed to
     #                               {HasInput#for}.
-    def delegated_for(index, matcher, args)
-      args = args.dup
-      args.extend(DeepFlattening)
-      args = args.deep_flatten
-
+    def delegated_for(key, matcher, args)
+      args      = args.dup
       args[-1]  = args[-1].to_s
-      args[-1] += "(#{index}i)"
+      args[-1] += "(#{key})"
       matcher.for(*args)
     end
   end

data/lib/rspec/tag_matchers.rb

@@ -2,6 +2,9 @@ $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', '..', 'core_ext'))
 
 module RSpec
   module TagMatchers
+    module Helpers
+      autoload :SentenceHelper, 'rspec/tag_matchers/helpers/sentence_helper'
+    end
   end
 end
 
@@ -11,3 +14,4 @@ require 'rspec/tag_matchers/has_input'
 require 'rspec/tag_matchers/has_checkbox'
 require 'rspec/tag_matchers/has_select'
 require 'rspec/tag_matchers/has_time_select'
+require 'rspec/tag_matchers/has_date_select'

data/rspec-tag_matchers.gemspec

@@ -0,0 +1,93 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{rspec-tag_matchers}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = [%q{David Cuddeback}]
+  s.date = %q{2012-02-18}
+  s.description = %q{A collection of RSpec matchers that understand Rails conventions, allowing for more concise specs.}
+  s.email = %q{david.cuddeback@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    ".travis.yml",
+    "Gemfile",
+    "Gemfile.lock",
+    "Guardfile",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "core_ext/deep_flattening.rb",
+    "lib/rspec-tag_matchers.rb",
+    "lib/rspec/tag_matchers.rb",
+    "lib/rspec/tag_matchers/has_checkbox.rb",
+    "lib/rspec/tag_matchers/has_date_select.rb",
+    "lib/rspec/tag_matchers/has_form.rb",
+    "lib/rspec/tag_matchers/has_input.rb",
+    "lib/rspec/tag_matchers/has_select.rb",
+    "lib/rspec/tag_matchers/has_tag.rb",
+    "lib/rspec/tag_matchers/has_time_select.rb",
+    "lib/rspec/tag_matchers/helpers/sentence_helper.rb",
+    "lib/rspec/tag_matchers/multiple_input_matcher.rb",
+    "rspec-tag_matchers.gemspec",
+    "spec/core_ext/deep_flattening_spec.rb",
+    "spec/lib/rspec/tag_matchers/has_checkbox_spec.rb",
+    "spec/lib/rspec/tag_matchers/has_date_select_spec.rb",
+    "spec/lib/rspec/tag_matchers/has_form_spec.rb",
+    "spec/lib/rspec/tag_matchers/has_input_spec.rb",
+    "spec/lib/rspec/tag_matchers/has_select_spec.rb",
+    "spec/lib/rspec/tag_matchers/has_tag_spec.rb",
+    "spec/lib/rspec/tag_matchers/has_time_select_spec.rb",
+    "spec/lib/rspec/tag_matchers/multiple_input_matcher_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/dcuddeback/rspec-tag_matchers}
+  s.licenses = [%q{MIT}]
+  s.require_paths = [%q{lib}]
+  s.rubygems_version = %q{1.8.6}
+  s.summary = %q{RSpec matchers for Rails views}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<nokogiri>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<guard>, [">= 0"])
+      s.add_development_dependency(%q<guard-rspec>, [">= 0"])
+      s.add_development_dependency(%q<guard-bundler>, [">= 0"])
+    else
+      s.add_dependency(%q<nokogiri>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<yard>, [">= 0"])
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<guard>, [">= 0"])
+      s.add_dependency(%q<guard-rspec>, [">= 0"])
+      s.add_dependency(%q<guard-bundler>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<nokogiri>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<yard>, [">= 0"])
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<guard>, [">= 0"])
+    s.add_dependency(%q<guard-rspec>, [">= 0"])
+    s.add_dependency(%q<guard-bundler>, [">= 0"])
+  end
+end
+

data/spec/lib/rspec/tag_matchers/has_date_select_spec.rb

@@ -0,0 +1,196 @@
+require 'spec_helper'
+
+describe RSpec::TagMatchers::HasDateSelect do
+  include RSpec::TagMatchers
+
+  # single inputs for start_date
+  let(:start_date_year)         { "<select name='event[start_date(1i)]'></select>" }
+  let(:start_date_month)        { "<select name='event[start_date(2i)]'></select>" }
+  let(:start_date_day)          { "<select name='event[start_date(3i)]'></select>" }
+
+  # single inputs for end_date
+  let(:end_date_year)           { "<select name='event[end_date(1i)]'></select>" }
+  let(:end_date_month)          { "<select name='event[end_date(2i)]'></select>" }
+  let(:end_date_day)            { "<select name='event[end_date(3i)]'></select>" }
+
+  # hidden inputs
+  let(:hidden_start_date_year)  { "<input type='hidden' name='event[start_date(1i)]' />" }
+  let(:hidden_start_date_month) { "<input type='hidden' name='event[start_date(2i)]' />" }
+  let(:hidden_start_date_day)   { "<input type='hidden' name='event[start_date(3i)]' />" }
+  let(:hidden_other)            { "<input type='hidden' name='foo' />" }
+
+  # combined inputs for start_date
+  let(:start_date_with_year_month_and_day) { start_date_year + start_date_month + start_date_day }
+  let(:start_date_with_year_and_month)     { start_date_year + start_date_month }
+
+  # combined inputs for end_date
+  let(:end_date_with_year_and_month)       { end_date_year + end_date_month }
+  let(:end_date_with_year_month_and_day)   { end_date_year + end_date_month + end_date_day }
+
+  # combined inputs for start_date with hidden inputs
+  let(:start_date_with_year_and_month_and_hidden_other)      { start_date_year + start_date_month + hidden_other }
+  let(:start_date_with_year_and_month_and_hidden_day)        { start_date_year + start_date_month + hidden_start_date_day }
+  let(:start_date_with_year_and_hidden_month_and_day)        { start_date_year + hidden_start_date_month + start_date_day }
+  let(:start_date_with_hidden_year_and_month_and_day)        { hidden_start_date_year + start_date_month + start_date_day }
+  let(:start_date_with_year_and_hidden_month_and_hidden_day) { start_date_year + hidden_start_date_month + hidden_start_date_day }
+
+  describe "date select matching" do
+    context "have_date_select" do
+      subject { have_date_select }
+
+      it      { should     match(start_date_with_year_month_and_day) }
+      it      { should_not match(start_date_with_year_and_month) }
+      it      { should_not match(start_date_year) }
+      it      { should_not match(start_date_month) }
+      it      { should_not match(start_date_day) }
+
+      it      { should     match(end_date_with_year_month_and_day) }
+      it      { should_not match(end_date_with_year_and_month) }
+      it      { should_not match(end_date_year) }
+      it      { should_not match(end_date_month) }
+      it      { should_not match(end_date_day) }
+    end
+  end
+
+  describe "matching discarded date parts" do
+    context "have_date_select.discard(:day)" do
+      subject { have_date_select.discard(:day) }
+
+      it      { should     match(start_date_with_year_and_month_and_hidden_day) }
+      it      { should_not match(start_date_with_year_and_month_and_hidden_other) }
+      it      { should_not match(start_date_with_year_month_and_day) }
+      it      { should_not match(start_date_with_year_and_month) }
+    end
+
+    context "have_date_select.discard(:month)" do
+      subject { have_date_select.discard(:month) }
+
+      it      { should     match(start_date_with_year_and_hidden_month_and_day) }
+      it      { should_not match(start_date_with_year_month_and_day) }
+    end
+
+    context "have_date_select.discard(:year)" do
+      subject { have_date_select.discard(:year) }
+
+      it      { should     match(start_date_with_hidden_year_and_month_and_day) }
+      it      { should_not match(start_date_with_year_month_and_day) }
+    end
+
+    context "have_date_select.discard(:month, :day)" do
+      subject { have_date_select.discard(:month, :day) }
+
+      it      { should     match(start_date_with_year_and_hidden_month_and_hidden_day) }
+      it      { should_not match(start_date_with_year_month_and_day) }
+    end
+  end
+
+  describe "matching input names" do
+    context "have_date_select.for(:event => :start_date)" do
+      subject { have_date_select.for(:event => :start_date) }
+
+      it      { should     match(start_date_with_year_month_and_day) }
+      it      { should_not match(start_date_with_year_and_month) }
+
+      it      { should_not match(end_date_with_year_and_month) }
+      it      { should_not match(end_date_with_year_month_and_day) }
+    end
+
+    context "have_date_select.for(:event => :end_date)" do
+      subject { have_date_select.for(:event => :end_date) }
+
+      it      { should     match(end_date_with_year_month_and_day) }
+      it      { should_not match(end_date_with_year_and_month) }
+
+      it      { should_not match(start_date_with_year_and_month) }
+      it      { should_not match(start_date_with_year_month_and_day) }
+    end
+  end
+
+  describe "#description" do
+    context "for simple date select" do
+      context "have_date_select" do
+        subject { have_date_select.description }
+        it      { should == "have date select" }
+      end
+    end
+
+    context "for date select with attribute matcher" do
+      context "have_date_select.for(:start_date)" do
+        subject { have_date_select.for(:start_date).description }
+        it      { should == "have date select for start_date" }
+      end
+
+      context "have_date_select.for(:event => :start_date)" do
+        subject { have_date_select.for(:event => :start_date).description }
+        it      { should == "have date select for event.start_date" }
+      end
+
+      context "have_date_select.for(:event, :start => :date)" do
+        subject { have_date_select.for(:event, :start => :date).description }
+        it      { should == "have date select for event.start.date" }
+      end
+    end
+
+    context "for date select with discarded components" do
+      context "have_date_select.discard(:day)" do
+        subject { have_date_select.discard(:day).description }
+        it      { should == "have date select without day" }
+      end
+
+      context "have_date_select.discard(:month)" do
+        subject { have_date_select.discard(:month).description }
+        it      { should == "have date select without month" }
+      end
+
+      context "have_date_select.discard(:year)" do
+        subject { have_date_select.discard(:year).description }
+        it      { should == "have date select without year" }
+      end
+
+      context "have_date_select.discard(:day, :month)" do
+        subject { have_date_select.discard(:day, :month).description }
+        it      { should == "have date select without day or month" }
+      end
+
+      context "have_date_select.discard(:day, :month, :year)" do
+        subject { have_date_select.discard(:day, :month, :year).description }
+        it      { should == "have date select without day, month, or year" }
+      end
+    end
+
+    context "for date select with attribute matcher and discarded components" do
+      context "have_date_select.discard(:day).for(:event => :start_date)" do
+        subject { have_date_select.discard(:day).for(:event => :start_date).description }
+        it      { should == "have date select for event.start_date without day" }
+      end
+    end
+  end
+
+  describe "#failure_message" do
+    context "for have_date_select" do
+      let(:matcher) { have_date_select }
+
+      context "matching '<bar></bar>'" do
+        let(:document) { "<bar></bar>" }
+
+        before  { matcher.matches?(document) }
+        subject { matcher.failure_message }
+        it      { should == "expected document to #{matcher.description}; got: #{document}" }
+      end
+    end
+  end
+
+  describe "#negative_failure_message" do
+    context "for have_date_select" do
+      let(:matcher) { have_date_select }
+
+      context "matching \"<select name='(4i)'><select><select name='(5i)'></select>\"" do
+        let(:document) { "<select name='(4i)'><select><select name='(5i)'></select>" }
+
+        before  { matcher.matches?(document) }
+        subject { matcher.negative_failure_message }
+        it      { should == "expected document to not #{matcher.description}; got: #{document}" }
+      end
+    end
+  end
+end

data/spec/lib/rspec/tag_matchers/has_input_spec.rb

@@ -50,4 +50,13 @@ describe RSpec::TagMatchers::HasInput do
       it      { should     match("<input name='user[name][first]' />") }
     end
   end
+
+  describe "matching input values" do
+    context "have_input.value(:foo)" do
+      subject { have_input.value(:foo) }
+      it      { should     match("<input value='foo' />") }
+      it      { should_not match("<input value='bar' />") }
+      it      { should_not match("<input />") }
+    end
+  end
 end

data/spec/lib/rspec/tag_matchers/has_tag_spec.rb

@@ -291,4 +291,88 @@ describe RSpec::TagMatchers::HasTag do
       end
     end
   end
+
+  describe "#description" do
+    context "for simple matchers" do
+      context "have_tag(:foo)" do
+        subject { have_tag(:foo) }
+        its(:description) { should == 'have "foo" tag' }
+      end
+
+      context "have_tag(:bar)" do
+        subject { have_tag(:bar) }
+        its(:description) { should == 'have "bar" tag' }
+      end
+    end
+
+    context "for matchers with attribute criteria" do
+      context "have_tag(:foo).with_attribute(:bar => :baz)" do
+        subject { have_tag(:foo).with_attribute(:bar => :baz) }
+        its(:description) { should == 'have "foo" tag with attribute bar=:baz' }
+      end
+
+      context "have_tag(:foo).with_attribute(:bar => 'baz')" do
+        subject { have_tag(:foo).with_attribute(:bar => 'baz') }
+        its(:description) { should == 'have "foo" tag with attribute bar="baz"' }
+      end
+
+      context "have_tag(:foo).with_attribute(:bar => /baz/)" do
+        subject { have_tag(:foo).with_attribute(:bar => /baz/) }
+        its(:description) { should == 'have "foo" tag with attribute bar=~/baz/' }
+      end
+
+      context "have_tag(:foo).with_attribute(:bar => true)" do
+        subject { have_tag(:foo).with_attribute(:bar => true) }
+        its(:description) { should == 'have "foo" tag with attribute bar=anything' }
+      end
+
+      context "have_tag(:foo).with_attribute(:bar => false)" do
+        subject { have_tag(:foo).with_attribute(:bar => false) }
+        its(:description) { should == 'have "foo" tag without attribute bar' }
+      end
+
+      context "have_tag(:foo).with_attributes(:bar => '1', :baz => '2')" do
+        subject { have_tag(:foo).with_attributes(:bar => '1', :baz => '2') }
+        its(:description) { should == 'have "foo" tag with attributes bar="1" and baz="2"' }
+      end
+
+      context "have_tag(:foo).with_attributes(:bar => '1', :baz => '2', :qux => '3')" do
+        subject { have_tag(:foo).with_attributes(:bar => '1', :baz => '2', :qux => '3') }
+        its(:description) { should == 'have "foo" tag with attributes bar="1", baz="2", and qux="3"' }
+      end
+
+      context "have_tag(:foo).with_attributes(:bar => true, :baz => false)" do
+        subject { have_tag(:foo).with_attributes(:bar => true, :baz => false) }
+        its(:description) { should == 'have "foo" tag with attribute bar=anything and without attribute baz' }
+      end
+    end
+  end
+
+  describe "#failure_message" do
+    context "have_tag(:foo)" do
+      let(:matcher) { have_tag(:foo) }
+
+      context "matching '<bar></bar>'" do
+        let(:document) { "<bar></bar>" }
+
+        before  { matcher.matches?(document) }
+        subject { matcher.failure_message }
+        it      { should == "expected document to #{matcher.description}; got: #{document}" }
+      end
+    end
+  end
+
+  describe "#negative_failure_message" do
+    context "have_tag(:foo)" do
+      let(:matcher) { have_tag(:foo) }
+
+      context "matching '<foo></foo>'" do
+        let(:document) { "<foo></foo>" }
+
+        before  { matcher.matches?(document) }
+        subject { matcher.negative_failure_message }
+        it      { should == "expected document to not #{matcher.description}; got: #{document}" }
+      end
+    end
+  end
 end

data/spec/lib/rspec/tag_matchers/has_time_select_spec.rb

@@ -56,4 +56,54 @@ describe RSpec::TagMatchers::HasTimeSelect do
       it      { should_not match(start_time_with_hour_minute_and_second) }
     end
   end
+
+  describe "#description" do
+    context "for have_time_select" do
+      subject { have_time_select.description }
+      it      { should == "have time select" }
+    end
+
+    context "for have_time_select.for(:start_time)" do
+      subject { have_time_select.for(:start_time).description }
+      it      { should == "have time select for start_time" }
+    end
+
+    context "for have_time_select.for(:event => :start_time)" do
+      subject { have_time_select.for(:event => :start_time).description }
+      it      { should == "have time select for event.start_time" }
+    end
+
+    context "for have_time_select.for(:event, :start => :time)" do
+      subject { have_time_select.for(:event, :start => :time).description }
+      it      { should == "have time select for event.start.time" }
+    end
+  end
+
+  describe "#failure_message" do
+    context "for have_time_select" do
+      let(:matcher) { have_time_select }
+
+      context "matching '<bar></bar>'" do
+        let(:document) { "<bar></bar>" }
+
+        before  { matcher.matches?(document) }
+        subject { matcher.failure_message }
+        it      { should == "expected document to #{matcher.description}; got: #{document}" }
+      end
+    end
+  end
+
+  describe "#negative_failure_message" do
+    context "for have_time_select" do
+      let(:matcher) { have_time_select }
+
+      context "matching \"<select name='(4i)'><select><select name='(5i)'></select>\"" do
+        let(:document) { "<select name='(4i)'><select><select name='(5i)'></select>" }
+
+        before  { matcher.matches?(document) }
+        subject { matcher.negative_failure_message }
+        it      { should == "expected document to not #{matcher.description}; got: #{document}" }
+      end
+    end
+  end
 end

data/spec/lib/rspec/tag_matchers/multiple_input_matcher_spec.rb

@@ -6,7 +6,7 @@ describe RSpec::TagMatchers::MultipleInputMatcher do
   let(:html)        { "<input name='foo' /><input name='bar' />" }
 
   let(:multiple_matcher) do
-    RSpec::TagMatchers::MultipleInputMatcher.new(2 => foo_matcher, 3 => bar_matcher)
+    RSpec::TagMatchers::MultipleInputMatcher.new('2i' => foo_matcher, '3i' => bar_matcher)
   end
 
   before do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rspec-tag_matchers
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-16 00:00:00.000000000Z
+date: 2012-02-18 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
-  requirement: &2161366360 !ruby/object:Gem::Requirement
+  requirement: &2154865400 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2161366360
+  version_requirements: *2154865400
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &2161365880 !ruby/object:Gem::Requirement
+  requirement: &2154864620 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2161365880
+  version_requirements: *2154864620
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &2161365260 !ruby/object:Gem::Requirement
+  requirement: &2154864000 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2161365260
+  version_requirements: *2154864000
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &2161364780 !ruby/object:Gem::Requirement
+  requirement: &2154863260 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2161364780
+  version_requirements: *2154863260
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &2161364300 !ruby/object:Gem::Requirement
+  requirement: &2154862600 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,10 +65,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2161364300
+  version_requirements: *2154862600
 - !ruby/object:Gem::Dependency
   name: guard
-  requirement: &2161363660 !ruby/object:Gem::Requirement
+  requirement: &2154861880 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,10 +76,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2161363660
+  version_requirements: *2154861880
 - !ruby/object:Gem::Dependency
   name: guard-rspec
-  requirement: &2161363180 !ruby/object:Gem::Requirement
+  requirement: &2154861180 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -87,10 +87,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2161363180
+  version_requirements: *2154861180
 - !ruby/object:Gem::Dependency
   name: guard-bundler
-  requirement: &2161362700 !ruby/object:Gem::Requirement
+  requirement: &2154859720 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -98,7 +98,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2161362700
+  version_requirements: *2154859720
 description: A collection of RSpec matchers that understand Rails conventions, allowing
   for more concise specs.
 email: david.cuddeback@gmail.com
@@ -122,14 +122,18 @@ files:
 - lib/rspec-tag_matchers.rb
 - lib/rspec/tag_matchers.rb
 - lib/rspec/tag_matchers/has_checkbox.rb
+- lib/rspec/tag_matchers/has_date_select.rb
 - lib/rspec/tag_matchers/has_form.rb
 - lib/rspec/tag_matchers/has_input.rb
 - lib/rspec/tag_matchers/has_select.rb
 - lib/rspec/tag_matchers/has_tag.rb
 - lib/rspec/tag_matchers/has_time_select.rb
+- lib/rspec/tag_matchers/helpers/sentence_helper.rb
 - lib/rspec/tag_matchers/multiple_input_matcher.rb
+- rspec-tag_matchers.gemspec
 - spec/core_ext/deep_flattening_spec.rb
 - spec/lib/rspec/tag_matchers/has_checkbox_spec.rb
+- spec/lib/rspec/tag_matchers/has_date_select_spec.rb
 - spec/lib/rspec/tag_matchers/has_form_spec.rb
 - spec/lib/rspec/tag_matchers/has_input_spec.rb
 - spec/lib/rspec/tag_matchers/has_select_spec.rb
@@ -152,7 +156,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -4097826557927416291
+      hash: 95040879081577537
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: