<!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/matcher.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/matcher.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-matcher_rb.html">rcov/ruby/1.8/gems/rspec-expectations-2.5.0/lib/rspec/matchers/matcher.rb</a></td> <td class='right_align'><tt>161</tt></td> <td class='right_align'><tt>117</tt></td> <td class="left_align"><div class="percent_graph_legend"><tt class=''>71.43%</tt></div> <div class="percent_graph"> <div class="covered" style="width:71px"></div> <div class="uncovered" style="width:29px"></div> </div></td> <td class="left_align"><div class="percent_graph_legend"><tt class=''>60.68%</tt></div> <div class="percent_graph"> <div class="covered" style="width:61px"></div> <div class="uncovered" style="width:39px"></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 Matcher</pre></td> </tr> <tr class="marked"> <td><pre><a name="line4">4</a> include RSpec::Matchers::InstanceExec</pre></td> </tr> <tr class="marked"> <td><pre><a name="line5">5</a> include RSpec::Matchers::Pretty</pre></td> </tr> <tr class="marked"> <td><pre><a name="line6">6</a> include RSpec::Matchers</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line7">7</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line8">8</a> attr_reader :expected, :actual, :rescued_exception</pre></td> </tr> <tr class="marked"> <td><pre><a name="line9">9</a> def initialize(name, *expected, &declarations)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line10">10</a> @name = name</pre></td> </tr> <tr class="marked"> <td><pre><a name="line11">11</a> @expected = expected</pre></td> </tr> <tr class="marked"> <td><pre><a name="line12">12</a> @actual = nil</pre></td> </tr> <tr class="marked"> <td><pre><a name="line13">13</a> @diffable = false</pre></td> </tr> <tr class="marked"> <td><pre><a name="line14">14</a> @expected_exception, @rescued_exception = nil, nil</pre></td> </tr> <tr class="marked"> <td><pre><a name="line15">15</a> @match_for_should_not_block = nil</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line16">16</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line17">17</a> @messages = {</pre></td> </tr> <tr class="marked"> <td><pre><a name="line18">18</a> :description => lambda {"#{name_to_sentence}#{expected_to_sentence}"},</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line19">19</a> :failure_message_for_should => lambda {|actual| "expected #{actual.inspect} to #{name_to_sentence}#{expected_to_sentence}"},</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line20">20</a> :failure_message_for_should_not => lambda {|actual| "expected #{actual.inspect} not to #{name_to_sentence}#{expected_to_sentence}"}</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line21">21</a> }</pre></td> </tr> <tr class="marked"> <td><pre><a name="line22">22</a> making_declared_methods_public do</pre></td> </tr> <tr class="marked"> <td><pre><a name="line23">23</a> instance_exec(*@expected, &declarations)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line24">24</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line25">25</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line26">26</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line27">27</a> #Used internally by +should+ and +should_not+.</pre></td> </tr> <tr class="marked"> <td><pre><a name="line28">28</a> def matches?(actual)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line29">29</a> @actual = actual</pre></td> </tr> <tr class="marked"> <td><pre><a name="line30">30</a> if @expected_exception</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line31">31</a> begin</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line32">32</a> instance_exec(actual, &@match_block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line33">33</a> true</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line34">34</a> rescue @expected_exception => @rescued_exception</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line35">35</a> false</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line36">36</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line37">37</a> else</pre></td> </tr> <tr class="marked"> <td><pre><a name="line38">38</a> begin</pre></td> </tr> <tr class="marked"> <td><pre><a name="line39">39</a> instance_exec(actual, &@match_block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line40">40</a> rescue RSpec::Expectations::ExpectationNotMetError</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line41">41</a> false</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line42">42</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line43">43</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line44">44</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line45">45</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line46">46</a> # Used internally by +should_not+</pre></td> </tr> <tr class="marked"> <td><pre><a name="line47">47</a> def does_not_match?(actual)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line48">48</a> @actual = actual</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line49">49</a> @match_for_should_not_block ?</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line50">50</a> instance_exec(actual, &@match_for_should_not_block) :</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line51">51</a> !matches?(actual)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line52">52</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line53">53</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line54">54</a> def define_method(name, &block) # :nodoc:</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line55">55</a> singleton_class.__send__(:define_method, name, &block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line56">56</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line57">57</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line58">58</a> # See RSpec::Matchers</pre></td> </tr> <tr class="marked"> <td><pre><a name="line59">59</a> def match(&block)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line60">60</a> @match_block = block</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line61">61</a> end</pre></td> </tr> <tr class="marked"> <td><pre><a name="line62">62</a> alias match_for_should match</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> # See RSpec::Matchers</pre></td> </tr> <tr class="marked"> <td><pre><a name="line65">65</a> def match_for_should_not(&block)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line66">66</a> @match_for_should_not_block = block</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line67">67</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line68">68</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line69">69</a> # See RSpec::Matchers</pre></td> </tr> <tr class="marked"> <td><pre><a name="line70">70</a> def match_unless_raises(exception=Exception, &block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line71">71</a> @expected_exception = exception</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line72">72</a> match(&block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line73">73</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line74">74</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line75">75</a> # See RSpec::Matchers</pre></td> </tr> <tr class="marked"> <td><pre><a name="line76">76</a> def failure_message_for_should(&block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line77">77</a> cache_or_call_cached(:failure_message_for_should, &block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line78">78</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line79">79</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line80">80</a> # See RSpec::Matchers</pre></td> </tr> <tr class="marked"> <td><pre><a name="line81">81</a> def failure_message_for_should_not(&block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line82">82</a> cache_or_call_cached(:failure_message_for_should_not, &block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line83">83</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line84">84</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line85">85</a> # See RSpec::Matchers</pre></td> </tr> <tr class="marked"> <td><pre><a name="line86">86</a> def description(&block)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line87">87</a> cache_or_call_cached(:description, &block)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line88">88</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line89">89</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line90">90</a> #Used internally by objects returns by +should+ and +should_not+.</pre></td> </tr> <tr class="marked"> <td><pre><a name="line91">91</a> def diffable?</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line92">92</a> @diffable</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line93">93</a> end</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> # See RSpec::Matchers</pre></td> </tr> <tr class="marked"> <td><pre><a name="line96">96</a> def diffable</pre></td> </tr> <tr class="marked"> <td><pre><a name="line97">97</a> @diffable = true</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line98">98</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line99">99</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line100">100</a> # See RSpec::Matchers</pre></td> </tr> <tr class="marked"> <td><pre><a name="line101">101</a> def chain(method, &block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line102">102</a> define_method method do |*args|</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line103">103</a> block.call(*args)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line104">104</a> self</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line105">105</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line106">106</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line107">107</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line108">108</a> private</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line109">109</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line110">110</a> def method_missing(method, *args, &block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line111">111</a> if $matcher_execution_context.respond_to?(method)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line112">112</a> $matcher_execution_context.send method, *args, &block</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line113">113</a> else</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line114">114</a> super(method, *args, &block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line115">115</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line116">116</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line117">117</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line118">118</a> def making_declared_methods_public # :nodoc:</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line119">119</a> # Our home-grown instance_exec in ruby 1.8.6 results in any methods</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line120">120</a> # declared in the block eval'd by instance_exec in the block to which we</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line121">121</a> # are yielding here are scoped private. This is NOT the case for Ruby</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line122">122</a> # 1.8.7 or 1.9.</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line123">123</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line124">124</a> # Also, due some crazy scoping that I don't understand, these methods</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line125">125</a> # are actually available in the specs (something about the matcher being</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line126">126</a> # defined in the scope of RSpec::Matchers or within an example), so not</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line127">127</a> # doing the following will not cause specs to fail, but they *will*</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line128">128</a> # cause features to fail and that will make users unhappy. So don't.</pre></td> </tr> <tr class="marked"> <td><pre><a name="line129">129</a> orig_private_methods = private_methods</pre></td> </tr> <tr class="marked"> <td><pre><a name="line130">130</a> yield</pre></td> </tr> <tr class="marked"> <td><pre><a name="line131">131</a> (private_methods - orig_private_methods).each {|m| singleton_class.__send__ :public, m}</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line132">132</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line133">133</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line134">134</a> def cache_or_call_cached(key, &block)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line135">135</a> block ? cache(key, &block) : call_cached(key)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line136">136</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line137">137</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line138">138</a> def cache(key, &block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line139">139</a> @messages[key] = block</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line140">140</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line141">141</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line142">142</a> def call_cached(key)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line143">143</a> @messages[key].arity == 1 ? @messages[key].call(@actual) : @messages[key].call</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line144">144</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line145">145</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line146">146</a> def name_to_sentence</pre></td> </tr> <tr class="marked"> <td><pre><a name="line147">147</a> split_words(@name)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line148">148</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line149">149</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line150">150</a> def expected_to_sentence</pre></td> </tr> <tr class="marked"> <td><pre><a name="line151">151</a> to_sentence(@expected)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line152">152</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line153">153</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line154">154</a> unless method_defined?(:singleton_class)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line155">155</a> def singleton_class</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line156">156</a> class << self; self; end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line157">157</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line158">158</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line159">159</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line160">160</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line161">161</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>