<!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/match_array.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/match_array.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-match_array_rb.html">rcov/ruby/1.8/gems/rspec-expectations-2.5.0/lib/rspec/matchers/match_array.rb</a></td>
          <td class='right_align'><tt>71</tt></td>
          <td class='right_align'><tt>43</tt></td>
          <td class="left_align"><div class="percent_graph_legend"><tt class=''>57.75%</tt></div>
        <div class="percent_graph">
          <div class="covered" style="width:58px"></div>
          <div class="uncovered" style="width:42px"></div>
        </div></td>
          <td class="left_align"><div class="percent_graph_legend"><tt class=''>34.88%</tt></div>
        <div class="percent_graph">
          <div class="covered" style="width:35px"></div>
          <div class="uncovered" style="width:65px"></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="inferred">
          <td><pre><a name="line3">3</a> </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line4">4</a>     class MatchArray #:nodoc:</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line5">5</a>       include RSpec::Matchers::Pretty</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line6">6</a>       </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line7">7</a>       def initialize(expected)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line8">8</a>         @expected = expected</pre></td>
        </tr>

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

        <tr class="inferred">
          <td><pre><a name="line10">10</a> </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line11">11</a>       def matches?(actual)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line12">12</a>         @actual = actual        </pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line13">13</a>         @extra_items = difference_between_arrays(@actual, @expected)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line14">14</a>         @missing_items = difference_between_arrays(@expected, @actual)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line15">15</a>         @extra_items.empty? &amp; @missing_items.empty?</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 failure_message_for_should</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line19">19</a>         message =  &quot;expected collection contained:  #{safe_sort(@expected).inspect}\n&quot;</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line20">20</a>         message += &quot;actual collection contained:    #{safe_sort(@actual).inspect}\n&quot;</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line21">21</a>         message += &quot;the missing elements were:      #{safe_sort(@missing_items).inspect}\n&quot; unless @missing_items.empty?</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line22">22</a>         message += &quot;the extra elements were:        #{safe_sort(@extra_items).inspect}\n&quot;   unless @extra_items.empty?</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line23">23</a>         message</pre></td>
        </tr>

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

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

        <tr class="marked">
          <td><pre><a name="line26">26</a>       def failure_message_for_should_not</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line27">27</a>         &quot;Matcher does not support should_not&quot;</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line28">28</a>       end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line29">29</a>       </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line30">30</a>       def description</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line31">31</a>         &quot;contain exactly #{_pretty_print(@expected)}&quot;</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line32">32</a>       end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line33">33</a> </pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line34">34</a>       private</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 safe_sort(array)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line37">37</a>           array.all?{|item| item.respond_to?(:&lt;=&gt;)} ? array.sort : array</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 difference_between_arrays(array_1, array_2)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line41">41</a>           difference = array_1.dup</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line42">42</a>           array_2.each do |element|</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line43">43</a>             if index = difference.index(element)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line44">44</a>               difference.delete_at(index)</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line45">45</a>             end</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line46">46</a>           end</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line47">47</a>           difference</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line48">48</a>         end</pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line49">49</a> </pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line50">50</a> </pre></td>
        </tr>

        <tr class="uncovered">
          <td><pre><a name="line51">51</a>     end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line52">52</a> </pre></td>
        </tr>

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

        <tr class="inferred">
          <td><pre><a name="line54">54</a>     #   should =~ expected</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line55">55</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line56">56</a>     # Passes if actual contains all of the expected regardless of order. </pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line57">57</a>     # This works for collections. Pass in multiple args  and it will only </pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line58">58</a>     # pass if all args are found in collection.</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line59">59</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line60">60</a>     # NOTE: there is no should_not version of array.should =~ other_array</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line61">61</a>     # </pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line62">62</a>     # == Examples</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line63">63</a>     #</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line64">64</a>     #   [1,2,3].should   =~ [1,2,3]   # =&gt; would pass</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line65">65</a>     #   [1,2,3].should   =~ [2,3,1]   # =&gt; would pass</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line66">66</a>     #   [1,2,3,4].should =~ [1,2,3]   # =&gt; would fail</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line67">67</a>     #   [1,2,2,3].should =~ [1,2,3]   # =&gt; would fail</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line68">68</a>     #   [1,2,3].should   =~ [1,2,3,4] # =&gt; would fail</pre></td>
        </tr>

        <tr class="marked">
          <td><pre><a name="line69">69</a>     OperatorMatcher.register(Array, '=~', RSpec::Matchers::MatchArray)</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line70">70</a>   end</pre></td>
        </tr>

        <tr class="inferred">
          <td><pre><a name="line71">71</a> end</pre></td>
        </tr>

    </tbody>
  </table>

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

</body>

</html>