<!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-core-2.5.1/lib/rspec/core/subject.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-core-2.5.1/lib/rspec/core/subject.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-core-2_5_1-lib-rspec-core-subject_rb.html">rcov/ruby/1.8/gems/rspec-core-2.5.1/lib/rspec/core/subject.rb</a></td> <td class='right_align'><tt>177</tt></td> <td class='right_align'><tt>64</tt></td> <td class="left_align"><div class="percent_graph_legend"><tt class=''>74.01%</tt></div> <div class="percent_graph"> <div class="covered" style="width:74px"></div> <div class="uncovered" style="width:26px"></div> </div></td> <td class="left_align"><div class="percent_graph_legend"><tt class=''>29.69%</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> require 'ostruct'</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line2">2</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line3">3</a> module RSpec</pre></td> </tr> <tr class="marked"> <td><pre><a name="line4">4</a> module Core</pre></td> </tr> <tr class="marked"> <td><pre><a name="line5">5</a> module Subject</pre></td> </tr> <tr class="marked"> <td><pre><a name="line6">6</a> module InstanceMethods</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line7">7</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line8">8</a> # Returns the subject defined by the example group. The subject block is</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line9">9</a> # only executed once per example, the result of which is cached and</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line10">10</a> # returned by any subsequent calls to +subject+.</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line11">11</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line12">12</a> # If a class is passed to +describe+ and no subject is explicitly</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line13">13</a> # declared in the example group, then +subject+ will return a new</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line14">14</a> # instance of that class.</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line15">15</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line16">16</a> # == Examples</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line17">17</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line18">18</a> # # explicit subject defined by the subject method</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line19">19</a> # describe Person do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line20">20</a> # subject { Person.new(:birthdate => 19.years.ago) }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line21">21</a> # it "should be eligible to vote" do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line22">22</a> # subject.should be_eligible_to_vote</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line23">23</a> # end</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> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line26">26</a> # # implicit subject => { Person.new }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line27">27</a> # describe Person do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line28">28</a> # it "should be eligible to vote" do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line29">29</a> # subject.should be_eligible_to_vote</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line30">30</a> # end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line31">31</a> # end</pre></td> </tr> <tr class="marked"> <td><pre><a name="line32">32</a> def subject</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line33">33</a> if defined?(@original_subject)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line34">34</a> @original_subject</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line35">35</a> else</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line36">36</a> @original_subject = instance_eval(&self.class.subject)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line37">37</a> end</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> begin</pre></td> </tr> <tr class="marked"> <td><pre><a name="line41">41</a> require 'rspec/expectations/extensions/kernel'</pre></td> </tr> <tr class="marked"> <td><pre><a name="line42">42</a> alias_method :__should_for_example_group__, :should</pre></td> </tr> <tr class="marked"> <td><pre><a name="line43">43</a> alias_method :__should_not_for_example_group__, :should_not</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line44">44</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line45">45</a> # When +should+ is called with no explicit receiver, the call is</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line46">46</a> # delegated to the object returned by +subject+. Combined with</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line47">47</a> # an implicit subject (see +subject+), this supports very concise</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line48">48</a> # expressions.</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line49">49</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line50">50</a> # == Examples</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line51">51</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line52">52</a> # describe Person do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line53">53</a> # it { should be_eligible_to_vote }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line54">54</a> # end</pre></td> </tr> <tr class="marked"> <td><pre><a name="line55">55</a> def should(matcher=nil, message=nil)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line56">56</a> self == subject ? self.__should_for_example_group__(matcher) : subject.should(matcher,message)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line57">57</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line58">58</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line59">59</a> # Just like +should+, +should_not+ delegates to the subject (implicit or</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line60">60</a> # explicit) of the example group.</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> # describe Person do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line65">65</a> # it { should_not be_eligible_to_vote }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line66">66</a> # end</pre></td> </tr> <tr class="marked"> <td><pre><a name="line67">67</a> def should_not(matcher=nil, message=nil)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line68">68</a> self == subject ? self.__should_not_for_example_group__(matcher) : subject.should_not(matcher,message)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line69">69</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line70">70</a> rescue LoadError</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line71">71</a> end</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> module ClassMethods</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line75">75</a> # Creates a nested example group named by the submitted +attribute+,</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line76">76</a> # and then generates an example using the submitted block.</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line77">77</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line78">78</a> # # This ...</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line79">79</a> # describe Array do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line80">80</a> # its(:size) { should == 0 }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line81">81</a> # end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line82">82</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line83">83</a> # # ... generates the same runtime structure as this:</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line84">84</a> # describe Array do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line85">85</a> # describe "size" do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line86">86</a> # it "should == 0" do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line87">87</a> # subject.size.should == 0</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> # end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line90">90</a> # end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line91">91</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line92">92</a> # The attribute can be a +Symbol+ or a +String+. Given a +String+</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line93">93</a> # with dots, the result is as though you concatenated that +String+</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line94">94</a> # onto the subject in an expression.</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line95">95</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line96">96</a> # describe Person do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line97">97</a> # subject do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line98">98</a> # Person.new.tap do |person|</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line99">99</a> # person.phone_numbers << "555-1212"</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line100">100</a> # end</pre></td> </tr> <tr class="inferred"> <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="inferred"> <td><pre><a name="line103">103</a> # its("phone_numbers.first") { should == "555-1212" }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line104">104</a> # end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line105">105</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line106">106</a> # When the subject is a +Hash+, you can refer to the Hash keys by</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line107">107</a> # specifying a +Symbol+ or +String+ in an array.</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> # describe "a configuration Hash" do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line110">110</a> # subject do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line111">111</a> # { :max_users => 3,</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line112">112</a> # 'admin' => :all_permissions }</pre></td> </tr> <tr class="inferred"> <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="inferred"> <td><pre><a name="line115">115</a> # its([:max_users]) { should == 3 }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line116">116</a> # its(['admin']) { should == :all_permissions }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line117">117</a> #</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line118">118</a> # # You can still access to its regular methods this way:</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line119">119</a> # its(:keys) { should include(:max_users) }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line120">120</a> # its(:count) { should == 2 }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line121">121</a> # end</pre></td> </tr> <tr class="marked"> <td><pre><a name="line122">122</a> def its(attribute, &block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line123">123</a> describe(attribute) do</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line124">124</a> example do</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line125">125</a> self.class.class_eval do</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line126">126</a> define_method(:subject) do</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line127">127</a> @_subject ||= if super().is_a?(Hash) && attribute.is_a?(Array)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line128">128</a> OpenStruct.new(super()).send(attribute.first)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line129">129</a> else</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line130">130</a> attribute.to_s.split('.').inject(super()) do |target, method|</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line131">131</a> target.send(method)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line132">132</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line133">133</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line134">134</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line135">135</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line136">136</a> instance_eval(&block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line137">137</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line138">138</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line139">139</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line140">140</a> </pre></td> </tr> <tr class="inferred"> <td><pre><a name="line141">141</a> # Defines an explicit subject for an example group which can then be the</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line142">142</a> # implicit receiver (through delegation) of calls to +should+.</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> # == Examples</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> # describe CheckingAccount, "with $50" do</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line147">147</a> # subject { CheckingAccount.new(:amount => 50, :currency => :USD) }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line148">148</a> # it { should have_a_balance_of(50, :USD) }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line149">149</a> # it { should_not be_overdrawn }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line150">150</a> # end</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> # See +ExampleMethods#should+ for more information about this approach.</pre></td> </tr> <tr class="marked"> <td><pre><a name="line153">153</a> def subject(&block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line154">154</a> block ? @explicit_subject_block = block : explicit_subject || implicit_subject</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line155">155</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line156">156</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line157">157</a> attr_reader :explicit_subject_block # :nodoc:</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line158">158</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line159">159</a> private</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line160">160</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line161">161</a> def explicit_subject</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line162">162</a> group = self</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line163">163</a> while group.respond_to?(:explicit_subject_block)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line164">164</a> return group.explicit_subject_block if group.explicit_subject_block</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line165">165</a> group = group.superclass</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line166">166</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line167">167</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line168">168</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line169">169</a> def implicit_subject</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line170">170</a> described = describes || description</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line171">171</a> Class === described ? proc { described.new } : proc { described }</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line172">172</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line173">173</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line174">174</a> </pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line175">175</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line176">176</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line177">177</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>