<!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/change.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/change.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-change_rb.html">rcov/ruby/1.8/gems/rspec-expectations-2.5.0/lib/rspec/matchers/change.rb</a></td> <td class='right_align'><tt>190</tt></td> <td class='right_align'><tt>102</tt></td> <td class="left_align"><div class="percent_graph_legend"><tt class=''>61.05%</tt></div> <div class="percent_graph"> <div class="covered" style="width:61px"></div> <div class="uncovered" style="width:39px"></div> </div></td> <td class="left_align"><div class="percent_graph_legend"><tt class=''>30.39%</tt></div> <div class="percent_graph"> <div class="covered" style="width:30px"></div> <div class="uncovered" style="width:70px"></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="inferred"> <td><pre><a name="line4">4</a> #Based on patch from Wilson Bilkovich</pre></td> </tr> <tr class="marked"> <td><pre><a name="line5">5</a> class Change #:nodoc:</pre></td> </tr> <tr class="marked"> <td><pre><a name="line6">6</a> def initialize(receiver=nil, message=nil, &block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line7">7</a> @message = message</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line8">8</a> @value_proc = block || lambda {receiver.__send__(message)}</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line9">9</a> @to = @from = @minimum = @maximum = @amount = nil</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line10">10</a> @given_from = @given_to = false</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line11">11</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line12">12</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line13">13</a> def matches?(event_proc)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line14">14</a> raise_block_syntax_error if block_given?</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> @before = evaluate_value_proc</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line17">17</a> event_proc.call</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line18">18</a> @after = evaluate_value_proc</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line19">19</a> </pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line20">20</a> (!change_expected? || changed?) && matches_before? && matches_after? && matches_amount? && matches_min? && matches_max?</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line21">21</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line22">22</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line23">23</a> def raise_block_syntax_error</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line24">24</a> raise MatcherError.new(<<-MESSAGE</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line25">25</a> block passed to should or should_not change must use {} instead of do/end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line26">26</a> MESSAGE</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line27">27</a> )</pre></td> </tr> <tr class="inferred"> <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 evaluate_value_proc</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line31">31</a> @value_proc.call</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> def failure_message_for_should</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line35">35</a> if @given_from && @before != @from</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line36">36</a> "#{message} should have initially been #{@from.inspect}, but was #{@before.inspect}"</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line37">37</a> elsif @given_to && @to != @after</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line38">38</a> "#{message} should have been changed to #{@to.inspect}, but is now #{@after.inspect}"</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line39">39</a> elsif @amount</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line40">40</a> "#{message} should have been changed by #{@amount.inspect}, but was changed by #{actual_delta.inspect}"</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line41">41</a> elsif @minimum</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line42">42</a> "#{message} should have been changed by at least #{@minimum.inspect}, but was changed by #{actual_delta.inspect}"</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line43">43</a> elsif @maximum</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line44">44</a> "#{message} should have been changed by at most #{@maximum.inspect}, but was changed by #{actual_delta.inspect}"</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line45">45</a> else</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line46">46</a> "#{message} should have changed, but is still #{@before.inspect}"</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line47">47</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line48">48</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line49">49</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line50">50</a> def actual_delta</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line51">51</a> @after - @before</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 failure_message_for_should_not</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line55">55</a> "#{message} should not have changed, but did change from #{@before.inspect} to #{@after.inspect}"</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="marked"> <td><pre><a name="line58">58</a> def by(amount)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line59">59</a> @amount = amount</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line60">60</a> self</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line61">61</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line62">62</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line63">63</a> def by_at_least(minimum)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line64">64</a> @minimum = minimum</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line65">65</a> self</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line66">66</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line67">67</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line68">68</a> def by_at_most(maximum)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line69">69</a> @maximum = maximum</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line70">70</a> self</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line71">71</a> end </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line72">72</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line73">73</a> def to(to)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line74">74</a> @given_to = true</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line75">75</a> @to = to</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line76">76</a> self</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line77">77</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line78">78</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line79">79</a> def from (from)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line80">80</a> @given_from = true</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line81">81</a> @from = from</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line82">82</a> self</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="marked"> <td><pre><a name="line85">85</a> def description</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line86">86</a> "change ##{message}"</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line87">87</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line88">88</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line89">89</a> private</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line90">90</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line91">91</a> def message</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line92">92</a> @message || "result"</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="marked"> <td><pre><a name="line95">95</a> def change_expected?</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line96">96</a> @amount != 0</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line97">97</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line98">98</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line99">99</a> def changed?</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line100">100</a> @before != @after</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line101">101</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line102">102</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line103">103</a> def matches_before?</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line104">104</a> @given_from ? @from == @before : true</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line105">105</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line106">106</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line107">107</a> def matches_after?</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line108">108</a> @given_to ? @to == @after : true</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line109">109</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line110">110</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line111">111</a> def matches_amount?</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line112">112</a> @amount ? (@before + @amount == @after) : true</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line113">113</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line114">114</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line115">115</a> def matches_min?</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line116">116</a> @minimum ? (@after - @before >= @minimum) : true</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line117">117</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line118">118</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line119">119</a> def matches_max?</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line120">120</a> @maximum ? (@after - @before <= @maximum) : true</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line121">121</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line122">122</a> </pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line123">123</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line124">124</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line125">125</a> # :call-seq:</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line126">126</a> # should change(receiver, message)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line127">127</a> # should change(receiver, message).by(value)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line128">128</a> # should change(receiver, message).from(old).to(new)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line129">129</a> # should_not change(receiver, message)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line130">130</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line131">131</a> # should change {...}</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line132">132</a> # should change {...}.by(value)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line133">133</a> # should change {...}.from(old).to(new)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line134">134</a> # should_not change {...}</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line135">135</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line136">136</a> # Applied to a proc, specifies that its execution will cause some value to</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line137">137</a> # change.</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> # You can either pass <tt>receiver</tt> and <tt>message</tt>, or a block,</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line140">140</a> # but not both.</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> # When passing a block, it must use the <tt>{ ... }</tt> format, not</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line143">143</a> # do/end, as <tt>{ ... }</tt> binds to the +change+ method, whereas do/end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line144">144</a> # would errantly bind to the +should+ or +should_not+ method.</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> # == Examples</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line147">147</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line148">148</a> # lambda {</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line149">149</a> # team.add_player(player) </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line150">150</a> # }.should change(roster, :count)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line151">151</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line152">152</a> # lambda {</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line153">153</a> # team.add_player(player) </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line154">154</a> # }.should change(roster, :count).by(1)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line155">155</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line156">156</a> # lambda {</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line157">157</a> # team.add_player(player) </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line158">158</a> # }.should change(roster, :count).by_at_least(1)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line159">159</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line160">160</a> # lambda {</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line161">161</a> # team.add_player(player)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line162">162</a> # }.should change(roster, :count).by_at_most(1) </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line163">163</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line164">164</a> # string = "string"</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line165">165</a> # lambda {</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line166">166</a> # string.reverse!</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line167">167</a> # }.should change { string }.from("string").to("gnirts")</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line168">168</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line169">169</a> # lambda {</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line170">170</a> # person.happy_birthday</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line171">171</a> # }.should change(person, :birthday).from(32).to(33)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line172">172</a> # </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line173">173</a> # lambda {</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line174">174</a> # employee.develop_great_new_social_networking_app</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line175">175</a> # }.should change(employee, :title).from("Mail Clerk").to("CEO")</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line176">176</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line177">177</a> # == Notes</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line178">178</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line179">179</a> # Evaluates <tt>receiver.message</tt> or <tt>block</tt> before and after it</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line180">180</a> # evaluates the proc object (generated by the lambdas in the examples</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line181">181</a> # above).</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line182">182</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line183">183</a> # <tt>should_not change</tt> only supports the form with no subsequent</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line184">184</a> # calls to <tt>by</tt>, <tt>by_at_least</tt>, <tt>by_at_most</tt>,</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line185">185</a> # <tt>to</tt> or <tt>from</tt>.</pre></td> </tr> <tr class="marked"> <td><pre><a name="line186">186</a> def change(receiver=nil, message=nil, &block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line187">187</a> Matchers::Change.new(receiver, message, &block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line188">188</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line189">189</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line190">190</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>