<!DOCTYPE html PUBLIC β€œ-//W3C//DTD XHTML 1.0 Transitional//EN” β€œwww.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”> <html lang='en' xml:lang='en' xmlns='www.w3.org/1999/xhtml'>

<head>
  <title>rcov/ruby/1.8/gems/rspec-expectations-2.5.0/lib/rspec/matchers/have.rb</title>
  <link href="screen.css" media="all" rel="stylesheet" type="text/css" />
  <link href="print.css" media="print" rel="stylesheet" type="text/css" />

  <meta http-equiv="Content-type" content="text/html;charset=UTF-8" />
  <script type="text/javascript" src="rcov.js"></script>
</head>
<body>
  <h1>Rspec Steps C0 Coverage Information - RCov</h1>
  <h2>rcov/ruby/1.8/gems/rspec-expectations-2.5.0/lib/rspec/matchers/have.rb</h2>

  <div class="report_table_wrapper">
    <table class='report' id='report_table'>
      <thead>
        <tr>
          <th class="left_align">Name</th>
          <th class="right_align">Total Lines</th>
          <th class="right_align">Lines of Code</th>
          <th class="left_align">Total Coverage</th>
          <th class="left_align">Code Coverage</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td class="left_align"><a href="rcov-ruby-1_8-gems-rspec-expectations-2_5_0-lib-rspec-matchers-have_rb.html">rcov/ruby/1.8/gems/rspec-expectations-2.5.0/lib/rspec/matchers/have.rb</a></td>
          <td class='right_align'><tt>151</tt></td>
          <td class='right_align'><tt>91</tt></td>
          <td class="left_align"><div class="percent_graph_legend"><tt class=''>65.56%</tt></div>
        <div class="percent_graph">
          <div class="covered" style="width:66px"></div>
          <div class="uncovered" style="width:34px"></div>
        </div></td>
          <td class="left_align"><div class="percent_graph_legend"><tt class=''>42.86%</tt></div>
        <div class="percent_graph">
          <div class="covered" style="width:43px"></div>
          <div class="uncovered" style="width:57px"></div>
        </div></td>
        </tr>
      </tbody>
    </table>
  </div>

  <h3>Key</h3>

  <div class="key"><pre><span class='marked'>Code reported as executed by Ruby looks like this...</span><span class='marked1'>and this: this line is also marked as covered.</span><span class='inferred'>Lines considered as run by rcov, but not reported by Ruby, look like this,</span><span class='inferred1'>and this: these lines were inferred by rcov (using simple heuristics).</span><span class='uncovered'>Finally, here's a line marked as not executed.</span></pre></div>

  <h3>Coverage Details</h3>

  <table class="details">
    <tbody>

        <tr class="marked">
          <td><pre><a name="line1">1</a> module RSpec</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line2">2</a>   module Matchers</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line3">3</a>     class Have #:nodoc:</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line4">4</a>       def initialize(expected, relativity=:exactly)</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line5">5</a>         @expected = (expected == :no ? 0 : expected)</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line6">6</a>         @relativity = relativity</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line7">7</a>         @actual = @collection_name = @plural_collection_name = nil</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line8">8</a>       end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line9">9</a>     </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line10">10</a>       def relativities</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line11">11</a>         @relativities ||= {</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line12">12</a>           :exactly =&gt; &quot;&quot;,</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line13">13</a>           :at_least =&gt; &quot;at least &quot;,</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line14">14</a>           :at_most =&gt; &quot;at most &quot;</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line15">15</a>         }</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line16">16</a>       end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line17">17</a>     </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line18">18</a>       def matches?(collection_owner)</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line19">19</a>         if collection_owner.respond_to?(@collection_name)</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line20">20</a>           collection = collection_owner.__send__(@collection_name, *@args, &amp;@block)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line21">21</a>         elsif (@plural_collection_name &amp;&amp; collection_owner.respond_to?(@plural_collection_name))</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line22">22</a>           collection = collection_owner.__send__(@plural_collection_name, *@args, &amp;@block)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line23">23</a>         elsif (collection_owner.respond_to?(:length) || collection_owner.respond_to?(:size))</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line24">24</a>           collection = collection_owner</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line25">25</a>         else</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line26">26</a>           collection_owner.__send__(@collection_name, *@args, &amp;@block)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line27">27</a>         end</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line28">28</a>         @actual = collection.size if collection.respond_to?(:size)</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line29">29</a>         @actual = collection.length if collection.respond_to?(:length)</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line30">30</a>         raise not_a_collection if @actual.nil?</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line31">31</a>         return @actual &gt;= @expected if @relativity == :at_least</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line32">32</a>         return @actual &lt;= @expected if @relativity == :at_most</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line33">33</a>         return @actual == @expected</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line34">34</a>       end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line35">35</a>       </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line36">36</a>       def not_a_collection</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line37">37</a>         &quot;expected #{@collection_name} to be a collection but it does not respond to #length or #size&quot;</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line38">38</a>       end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line39">39</a>     </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line40">40</a>       def failure_message_for_should</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line41">41</a>         &quot;expected #{relative_expectation} #{@collection_name}, got #{@actual}&quot;</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line42">42</a>       end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line43">43</a> </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line44">44</a>       def failure_message_for_should_not</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line45">45</a>         if @relativity == :exactly</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line46">46</a>           return &quot;expected target not to have #{@expected} #{@collection_name}, got #{@actual}&quot;</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line47">47</a>         elsif @relativity == :at_most</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line48">48</a>           return &lt;&lt;-EOF</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line49">49</a> Isn't life confusing enough?</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line50">50</a> Instead of having to figure out the meaning of this:</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line51">51</a>   should_not have_at_most(#{@expected}).#{@collection_name}</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line52">52</a> We recommend that you use this instead:</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line53">53</a>   should have_at_least(#{@expected + 1}).#{@collection_name}</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line54">54</a> EOF</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line55">55</a>         elsif @relativity == :at_least</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line56">56</a>           return &lt;&lt;-EOF</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line57">57</a> Isn't life confusing enough?</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line58">58</a> Instead of having to figure out the meaning of this:</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line59">59</a>   should_not have_at_least(#{@expected}).#{@collection_name}</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line60">60</a> We recommend that you use this instead:</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line61">61</a>   should have_at_most(#{@expected - 1}).#{@collection_name}</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line62">62</a> EOF</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line63">63</a>         end</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line64">64</a>       end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line65">65</a>       </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line66">66</a>       def description</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line67">67</a>         &quot;have #{relative_expectation} #{@collection_name}&quot;</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line68">68</a>       end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line69">69</a>       </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line70">70</a>       def respond_to?(sym)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line71">71</a>         @expected.respond_to?(sym) || super</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line72">72</a>       end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line73">73</a>     </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line74">74</a>       private</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line75">75</a>       </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line76">76</a>       def method_missing(method, *args, &amp;block)</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line77">77</a>         @collection_name = method</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line78">78</a>         if inflector = (defined?(ActiveSupport::Inflector) &amp;&amp; ActiveSupport::Inflector.respond_to?(:pluralize) ? ActiveSupport::Inflector : (defined?(Inflector) ? Inflector : nil))</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line79">79</a>           @plural_collection_name = inflector.pluralize(method.to_s)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line80">80</a>         end</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line81">81</a>         @args = args</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line82">82</a>         @block = block</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line83">83</a>         self</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line84">84</a>       end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line85">85</a>       </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line86">86</a>       def relative_expectation</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line87">87</a>         &quot;#{relativities[@relativity]}#{@expected}&quot;</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line88">88</a>       end</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line89">89</a>     end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line90">90</a> </pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line91">91</a>     # :call-seq:</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line92">92</a>     #   should have(number).named_collection__or__sugar</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line93">93</a>     #   should_not have(number).named_collection__or__sugar</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line94">94</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line95">95</a>     # Passes if receiver is a collection with the submitted</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line96">96</a>     # number of items OR if the receiver OWNS a collection</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line97">97</a>     # with the submitted number of items.</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line98">98</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line99">99</a>     # If the receiver OWNS the collection, you must use the name</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line100">100</a>     # of the collection. So if a &lt;tt&gt;Team&lt;/tt&gt; instance has a</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line101">101</a>     # collection named &lt;tt&gt;#players&lt;/tt&gt;, you must use that name</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line102">102</a>     # to set the expectation.</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line103">103</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line104">104</a>     # If the receiver IS the collection, you can use any name</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line105">105</a>     # you like for &lt;tt&gt;named_collection&lt;/tt&gt;. We'd recommend using</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line106">106</a>     # either &quot;elements&quot;, &quot;members&quot;, or &quot;items&quot; as these are all</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line107">107</a>     # standard ways of describing the things IN a collection.</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line108">108</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line109">109</a>     # This also works for Strings, letting you set an expectation</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line110">110</a>     # about its length</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line111">111</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line112">112</a>     # == Examples</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line113">113</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line114">114</a>     #   # Passes if team.players.size == 11</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line115">115</a>     #   team.should have(11).players</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line116">116</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line117">117</a>     #   # Passes if [1,2,3].length == 3</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line118">118</a>     #   [1,2,3].should have(3).items #&quot;items&quot; is pure sugar</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line119">119</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line120">120</a>     #   # Passes if &quot;this string&quot;.length == 11</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line121">121</a>     #   &quot;this string&quot;.should have(11).characters #&quot;characters&quot; is pure sugar</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line122">122</a>     def have(n)</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line123">123</a>       Matchers::Have.new(n)</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line124">124</a>     end</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line125">125</a>     alias :have_exactly :have</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line126">126</a> </pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line127">127</a>     # :call-seq:</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line128">128</a>     #   should have_at_least(number).items</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line129">129</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line130">130</a>     # Exactly like have() with &gt;=.</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line131">131</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line132">132</a>     # == Warning</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line133">133</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line134">134</a>     # +should_not+ +have_at_least+ is not supported</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line135">135</a>     def have_at_least(n)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line136">136</a>       Matchers::Have.new(n, :at_least)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line137">137</a>     end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line138">138</a> </pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line139">139</a>     # :call-seq:</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line140">140</a>     #   should have_at_most(number).items</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line141">141</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line142">142</a>     # Exactly like have() with &lt;=.</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line143">143</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line144">144</a>     # == Warning</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line145">145</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line146">146</a>     # +should_not+ +have_at_most+ is not supported</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line147">147</a>     def have_at_most(n)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line148">148</a>       Matchers::Have.new(n, :at_most)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line149">149</a>     end</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line150">150</a>   end</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line151">151</a> end</pre></td>
        </tr>

    </tbody>
  </table>

  <p>Generated on Fri Apr 22 17:22:42 -0700 2011 with <a href="http://github.com/relevance/rcov">rcov 0.9.8</a></p>

</body>

</html>