<!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/metadata.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/metadata.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-metadata_rb.html">rcov/ruby/1.8/gems/rspec-core-2.5.1/lib/rspec/core/metadata.rb</a></td> <td class='right_align'><tt>187</tt></td> <td class='right_align'><tt>151</tt></td> <td class="left_align"><div class="percent_graph_legend"><tt class=''>79.14%</tt></div> <div class="percent_graph"> <div class="covered" style="width:79px"></div> <div class="uncovered" style="width:21px"></div> </div></td> <td class="left_align"><div class="percent_graph_legend"><tt class=''>79.47%</tt></div> <div class="percent_graph"> <div class="covered" style="width:79px"></div> <div class="uncovered" style="width:21px"></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 Core</pre></td> </tr> <tr class="marked"> <td><pre><a name="line3">3</a> class Metadata < Hash</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line4">4</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line5">5</a> module LocationKeys</pre></td> </tr> <tr class="marked"> <td><pre><a name="line6">6</a> def [](key)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line7">7</a> return super if has_key?(key)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line8">8</a> case key</pre></td> </tr> <tr class="marked"> <td><pre><a name="line9">9</a> when :location</pre></td> </tr> <tr class="marked"> <td><pre><a name="line10">10</a> store(:location, location)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line11">11</a> when :file_path, :line_number</pre></td> </tr> <tr class="marked"> <td><pre><a name="line12">12</a> file_path, line_number = file_and_line_number</pre></td> </tr> <tr class="marked"> <td><pre><a name="line13">13</a> store(:file_path, file_path)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line14">14</a> store(:line_number, line_number)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line15">15</a> self[key]</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line16">16</a> else</pre></td> </tr> <tr class="marked"> <td><pre><a name="line17">17</a> super</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line18">18</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line19">19</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line20">20</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line21">21</a> def location</pre></td> </tr> <tr class="marked"> <td><pre><a name="line22">22</a> "#{self[:file_path]}:#{self[:line_number]}"</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> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line25">25</a> def file_and_line_number</pre></td> </tr> <tr class="marked"> <td><pre><a name="line26">26</a> first_caller_from_outside_rspec =~ /(.+?):(\d+)(|:\d+)/</pre></td> </tr> <tr class="marked"> <td><pre><a name="line27">27</a> return [$1, $2.to_i]</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 first_caller_from_outside_rspec</pre></td> </tr> <tr class="marked"> <td><pre><a name="line31">31</a> self[:caller].detect {|l| l !~ /\/lib\/rspec\/core/}</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line32">32</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line33">33</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line34">34</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line35">35</a> def initialize(superclass_metadata=nil)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line36">36</a> @superclass_metadata = superclass_metadata</pre></td> </tr> <tr class="marked"> <td><pre><a name="line37">37</a> if @superclass_metadata</pre></td> </tr> <tr class="marked"> <td><pre><a name="line38">38</a> update(@superclass_metadata)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line39">39</a> example_group = {:example_group => @superclass_metadata[:example_group]}</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line40">40</a> else</pre></td> </tr> <tr class="marked"> <td><pre><a name="line41">41</a> example_group = {}</pre></td> </tr> <tr class="inferred"> <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> store(:example_group, example_group.extend(LocationKeys))</pre></td> </tr> <tr class="marked"> <td><pre><a name="line45">45</a> yield self if block_given?</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line46">46</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line47">47</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line48">48</a> RESERVED_KEYS = [</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line49">49</a> :description,</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line50">50</a> :example_group,</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line51">51</a> :execution_result,</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line52">52</a> :file_path,</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line53">53</a> :full_description,</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line54">54</a> :line_number,</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line55">55</a> :location</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line56">56</a> ]</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 process(*args)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line59">59</a> user_metadata = args.last.is_a?(Hash) ? args.pop : {}</pre></td> </tr> <tr class="marked"> <td><pre><a name="line60">60</a> ensure_valid_keys(user_metadata)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line61">61</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line62">62</a> self[:example_group].store(:caller, user_metadata.delete(:caller) || caller)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line63">63</a> self[:example_group].store(:describes, described_class_from(*args))</pre></td> </tr> <tr class="marked"> <td><pre><a name="line64">64</a> self[:example_group].store(:description, description_from(*args))</pre></td> </tr> <tr class="marked"> <td><pre><a name="line65">65</a> self[:example_group].store(:full_description, full_description_from(*args))</pre></td> </tr> <tr class="marked"> <td><pre><a name="line66">66</a> self[:example_group].store(:block, user_metadata.delete(:example_group_block))</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> update(user_metadata)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line69">69</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line70">70</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line71">71</a> def ensure_valid_keys(user_metadata)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line72">72</a> RESERVED_KEYS.each do |key|</pre></td> </tr> <tr class="marked"> <td><pre><a name="line73">73</a> if user_metadata.keys.include?(key)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line74">74</a> raise <<-EOM</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line75">75</a> #{"*"*50}</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line76">76</a> :#{key} is not allowed</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line77">77</a> </pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line78">78</a> RSpec reserves some hash keys for its own internal use,</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line79">79</a> including :#{key}, which is used on:</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line80">80</a> </pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line81">81</a> #{caller(0)[4]}.</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line82">82</a> </pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line83">83</a> Here are all of RSpec's reserved hash keys:</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line84">84</a> </pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line85">85</a> #{RESERVED_KEYS.join("\n ")}</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line86">86</a> #{"*"*50}</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line87">87</a> EOM</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line88">88</a> raise ":#{key} is not allowed"</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line89">89</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line90">90</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line91">91</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line92">92</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line93">93</a> def for_example(description, user_metadata)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line94">94</a> dup.extend(LocationKeys).configure_for_example(description, user_metadata)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line95">95</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line96">96</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line97">97</a> def configure_for_example(description, user_metadata)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line98">98</a> store(:description, description.to_s)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line99">99</a> store(:full_description, "#{self[:example_group][:full_description]} #{self[:description]}")</pre></td> </tr> <tr class="marked"> <td><pre><a name="line100">100</a> store(:execution_result, {})</pre></td> </tr> <tr class="marked"> <td><pre><a name="line101">101</a> store(:caller, user_metadata.delete(:caller) || caller)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line102">102</a> update(user_metadata)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line103">103</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line104">104</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line105">105</a> def apply?(predicate, filters)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line106">106</a> filters.send(predicate) do |key, value|</pre></td> </tr> <tr class="marked"> <td><pre><a name="line107">107</a> apply_condition(key, value)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line108">108</a> end</pre></td> </tr> <tr class="inferred"> <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 relevant_line_numbers(metadata)</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line112">112</a> line_numbers = [metadata[:line_number]]</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line113">113</a> if metadata[:example_group]</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line114">114</a> line_numbers + relevant_line_numbers(metadata[:example_group])</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line115">115</a> else</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line116">116</a> line_numbers</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line117">117</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line118">118</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line119">119</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line120">120</a> def apply_condition(key, value, metadata=self)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line121">121</a> case value</pre></td> </tr> <tr class="marked"> <td><pre><a name="line122">122</a> when Hash</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line123">123</a> value.all? { |k, v| apply_condition(k, v, metadata[key]) }</pre></td> </tr> <tr class="marked"> <td><pre><a name="line124">124</a> when Regexp</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line125">125</a> metadata[key] =~ value</pre></td> </tr> <tr class="marked"> <td><pre><a name="line126">126</a> when Proc</pre></td> </tr> <tr class="marked"> <td><pre><a name="line127">127</a> if value.arity == 2</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line128">128</a> # Pass the metadata hash to allow the proc to check if it even has the key.</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line129">129</a> # This is necessary for the implicit :if exclusion filter:</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line130">130</a> # { } # => run the example</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line131">131</a> # { :if => nil } # => exclude the example</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line132">132</a> # The value of metadata[:if] is the same in these two cases but</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line133">133</a> # they need to be treated differently.</pre></td> </tr> <tr class="marked"> <td><pre><a name="line134">134</a> value.call(metadata[key], metadata) rescue false</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line135">135</a> else</pre></td> </tr> <tr class="marked"> <td><pre><a name="line136">136</a> value.call(metadata[key]) rescue false</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line137">137</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line138">138</a> when Fixnum</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line139">139</a> if key == :line_number</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line140">140</a> relevant_line_numbers(metadata).include?(world.preceding_declaration_line(value))</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line141">141</a> else</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line142">142</a> metadata[key] == value</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line143">143</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line144">144</a> else</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line145">145</a> metadata[key] == value</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line146">146</a> end</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line147">147</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line148">148</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line149">149</a> private</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line150">150</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line151">151</a> def world</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line152">152</a> RSpec.world</pre></td> </tr> <tr class="uncovered"> <td><pre><a name="line153">153</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line154">154</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line155">155</a> def superclass_metadata</pre></td> </tr> <tr class="marked"> <td><pre><a name="line156">156</a> @superclass_metadata ||= { :example_group => {} }</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line157">157</a> end</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> def description_from(*args)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line160">160</a> args.inject("") do |result, a|</pre></td> </tr> <tr class="marked"> <td><pre><a name="line161">161</a> a = a.to_s.strip</pre></td> </tr> <tr class="marked"> <td><pre><a name="line162">162</a> if result == ""</pre></td> </tr> <tr class="marked"> <td><pre><a name="line163">163</a> a</pre></td> </tr> <tr class="marked"> <td><pre><a name="line164">164</a> elsif a =~ /^(#|::|\.)/</pre></td> </tr> <tr class="marked"> <td><pre><a name="line165">165</a> "#{result}#{a}"</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line166">166</a> else</pre></td> </tr> <tr class="marked"> <td><pre><a name="line167">167</a> "#{result} #{a}"</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line168">168</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line169">169</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line170">170</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line171">171</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line172">172</a> def full_description_from(*args)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line173">173</a> if superclass_metadata[:example_group][:full_description]</pre></td> </tr> <tr class="marked"> <td><pre><a name="line174">174</a> description_from(superclass_metadata[:example_group][:full_description], *args)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line175">175</a> else</pre></td> </tr> <tr class="marked"> <td><pre><a name="line176">176</a> description_from(*args)</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line177">177</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line178">178</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line179">179</a> </pre></td> </tr> <tr class="marked"> <td><pre><a name="line180">180</a> def described_class_from(*args)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line181">181</a> superclass_metadata[:example_group][:describes] || begin</pre></td> </tr> <tr class="marked"> <td><pre><a name="line182">182</a> args.first unless args.first.is_a?(String) || args.first.is_a?(Symbol)</pre></td> </tr> <tr class="marked"> <td><pre><a name="line183">183</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line184">184</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line185">185</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line186">186</a> end</pre></td> </tr> <tr class="inferred"> <td><pre><a name="line187">187</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>