mattock 0.1.2 → 0.1.3

data/doc/coverage/index.html

@@ -23,14 +23,14 @@
       <img src="./assets/0.5.3/loading.gif" alt="loading"/>
     </div>
     <div id="wrapper" style="display:none;">
-      <div class="timestamp">Generated <abbr class="timeago" title="2012-02-04T10:44:02-08:00">2012-02-04T10:44:02-08:00</abbr></div>
+      <div class="timestamp">Generated <abbr class="timeago" title="2012-02-06T14:11:35-08:00">2012-02-06T14:11:35-08:00</abbr></div>
       <ul class="group_tabs"></ul>
 
       <div id="content">
         <div class="file_list_container" id="AllFiles">
   <h2>
     <span class="group_name">All Files</span>
-    (<span class="covered_percent"><span class="green">92.15%</span></span>
+    (<span class="covered_percent"><span class="green">92.31%</span></span>
      covered at
      <span class="covered_strength">
        <span class="green">
@@ -41,8 +41,8 @@
   <a name="AllFiles"></a>
   <div>
     <b>12</b> files in total.
-    <b>433</b> relevant lines. 
-    <span class="green"><b>399</b> lines covered</span> and
+    <b>442</b> relevant lines. 
+    <span class="green"><b>408</b> lines covered</span> and
     <span class="red"><b>34</b> lines missed </span>
   </div>
   <table class="file_list">
@@ -106,7 +106,7 @@
         <td>93</td>
         <td>89</td>
         <td>4</td>
-        <td>8.0</td>
+        <td>7.9</td>
       </tr>
       
       <tr>
@@ -121,12 +121,12 @@
       
       <tr>
         <td class="strong"><a href="#7cc8f09739f0b95d0fd16321baf73b5d3c6eb35b" class="src_link" title="lib/mattock/task.rb">lib/mattock/task.rb</a></td>
-        <td class="yellow strong">86.67 %</td>
-        <td>53</td>
-        <td>30</td>
-        <td>26</td>
+        <td class="yellow strong">89.74 %</td>
+        <td>74</td>
+        <td>39</td>
+        <td>35</td>
         <td>4</td>
-        <td>0.9</td>
+        <td>1.0</td>
       </tr>
       
       <tr>
@@ -1817,14 +1817,14 @@
           <code class="ruby">        default_values.each_pair do |name,value|</code>
         </li>
       
-        <li class="covered" data-hits="44" data-linenumber="26">
-          <span class="hits">44</span>
+        <li class="covered" data-hits="42" data-linenumber="26">
+          <span class="hits">42</span>
           
           <code class="ruby">          instance.__send__(&quot;#{name}=&quot;, value)</code>
         </li>
       
-        <li class="covered" data-hits="44" data-linenumber="27">
-          <span class="hits">44</span>
+        <li class="covered" data-hits="42" data-linenumber="27">
+          <span class="hits">42</span>
           
           <code class="ruby">          if Configurable === value</code>
         </li>
@@ -1895,14 +1895,14 @@
           <code class="ruby">        default_values.each_pair do |name,value|</code>
         </li>
       
-        <li class="covered" data-hits="37" data-linenumber="39">
-          <span class="hits">37</span>
+        <li class="covered" data-hits="35" data-linenumber="39">
+          <span class="hits">35</span>
           
           <code class="ruby">          set_value = instance.__send__(name)</code>
         </li>
       
-        <li class="covered" data-hits="37" data-linenumber="40">
-          <span class="hits">37</span>
+        <li class="covered" data-hits="35" data-linenumber="40">
+          <span class="hits">35</span>
           
           <code class="ruby">          if value == RequiredField and set_value == RequiredField</code>
         </li>
@@ -1925,8 +1925,8 @@
           <code class="ruby">          end</code>
         </li>
       
-        <li class="covered" data-hits="34" data-linenumber="44">
-          <span class="hits">34</span>
+        <li class="covered" data-hits="32" data-linenumber="44">
+          <span class="hits">32</span>
           
           <code class="ruby">          if Configurable === set_value</code>
         </li>
@@ -2009,14 +2009,14 @@
           <code class="ruby">        default_values.keys.each do |field|</code>
         </li>
       
-        <li class="covered" data-hits="9" data-linenumber="58">
-          <span class="hits">9</span>
+        <li class="covered" data-hits="7" data-linenumber="58">
+          <span class="hits">7</span>
           
           <code class="ruby">          begin</code>
         </li>
       
-        <li class="covered" data-hits="9" data-linenumber="59">
-          <span class="hits">9</span>
+        <li class="covered" data-hits="7" data-linenumber="59">
+          <span class="hits">7</span>
           
           <code class="ruby">            to.__send__(&quot;#{field}=&quot;, from.__send__(field))</code>
         </li>
@@ -2303,8 +2303,8 @@
           <code class="ruby">      def included(mod)</code>
         </li>
       
-        <li class="covered" data-hits="5" data-linenumber="107">
-          <span class="hits">5</span>
+        <li class="covered" data-hits="7" data-linenumber="107">
+          <span class="hits">7</span>
           
           <code class="ruby">        mod.extend ClassMethods</code>
         </li>
@@ -2844,10 +2844,10 @@
         <div class="source_table" id="7cc8f09739f0b95d0fd16321baf73b5d3c6eb35b">
   <div class="header">
     <h3>lib/mattock/task.rb</h3>
-    <h4><span class="yellow">86.67 %</span> covered</h4>
+    <h4><span class="yellow">89.74 %</span> covered</h4>
     <div>
-      <b>30</b> relevant lines. 
-      <span class="green"><b>26</b> lines covered</span> and
+      <b>39</b> relevant lines. 
+      <span class="green"><b>35</b> lines covered</span> and
       <span class="red"><b>4</b> lines missed.</span>
     </div>
   </div>
@@ -2867,307 +2867,433 @@
           <code class="ruby">require 'rake/task'</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="3">
+        <li class="covered" data-hits="1" data-linenumber="3">
+          <span class="hits">1</span>
+          
+          <code class="ruby">require 'rake/file_task'</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="4">
           
           
           <code class="ruby"></code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="4">
+        <li class="covered" data-hits="1" data-linenumber="5">
           <span class="hits">1</span>
           
           <code class="ruby">module Mattock</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="5">
+        <li class="never" data-hits="" data-linenumber="6">
+          
+          
+          <code class="ruby">  # A configurable subclass of Rake::Task, such that you can use a</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="7">
+          
+          
+          <code class="ruby">  # configuration block to change how a common task behaves, while still</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="8">
+          
+          
+          <code class="ruby">  # overriding Rake API methods like Task#needed? and Task#timestamp</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="9">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="10">
           <span class="hits">1</span>
           
-          <code class="ruby">  class Task &lt; Rake::Task</code>
+          <code class="ruby">  module TaskMixin</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="6">
+        <li class="covered" data-hits="1" data-linenumber="11">
           <span class="hits">1</span>
           
           <code class="ruby">    include CascadingDefinition</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="7">
+        <li class="never" data-hits="" data-linenumber="12">
           
           
           <code class="ruby"></code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="8">
+        <li class="covered" data-hits="1" data-linenumber="13">
           <span class="hits">1</span>
           
           <code class="ruby">    setting :task_name</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="9">
+        <li class="covered" data-hits="1" data-linenumber="14">
           <span class="hits">1</span>
           
           <code class="ruby">    setting :task_args</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="10">
+        <li class="never" data-hits="" data-linenumber="15">
           
           
           <code class="ruby"></code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="11">
+        <li class="covered" data-hits="1" data-linenumber="16">
+          <span class="hits">1</span>
+          
+          <code class="ruby">    module ClassMethods</code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="17">
           <span class="hits">1</span>
           
-          <code class="ruby">    def self.default_taskname(name)</code>
+          <code class="ruby">      def default_taskname(name)</code>
         </li>
       
-        <li class="missed" data-hits="0" data-linenumber="12">
+        <li class="missed" data-hits="0" data-linenumber="18">
           
           
-          <code class="ruby">      setting(:task_name, name)</code>
+          <code class="ruby">        setting(:task_name, name)</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="13">
+        <li class="never" data-hits="" data-linenumber="19">
+          
+          
+          <code class="ruby">      end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="20">
           
           
           <code class="ruby">    end</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="14">
+        <li class="never" data-hits="" data-linenumber="21">
           
           
           <code class="ruby"></code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="15">
+        <li class="covered" data-hits="1" data-linenumber="22">
+          <span class="hits">1</span>
+          
+          <code class="ruby">    def self.included(mod)</code>
+        </li>
+      
+        <li class="covered" data-hits="4" data-linenumber="23">
+          <span class="hits">4</span>
+          
+          <code class="ruby">      mod.class_eval{ extend ClassMethods }</code>
+        </li>
+      
+        <li class="covered" data-hits="2" data-linenumber="24">
+          <span class="hits">2</span>
+          
+          <code class="ruby">      super</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="25">
+          
+          
+          <code class="ruby">    end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="26">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="27">
           <span class="hits">1</span>
           
           <code class="ruby">    def initialize(*args)</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="16">
+        <li class="covered" data-hits="1" data-linenumber="28">
           <span class="hits">1</span>
           
           <code class="ruby">      configs = args.take_while{|arg| Configurable === arg}</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="17">
+        <li class="covered" data-hits="1" data-linenumber="29">
           <span class="hits">1</span>
           
           <code class="ruby">      @extracted_task_args = args[configs.length..-1]</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="18">
+        <li class="covered" data-hits="1" data-linenumber="30">
           <span class="hits">1</span>
           
           <code class="ruby">      if @extracted_task_args.any?{|arg| Configurable === arg}</code>
         </li>
       
-        <li class="missed" data-hits="0" data-linenumber="19">
+        <li class="missed" data-hits="0" data-linenumber="31">
           
           
           <code class="ruby">        raise &quot;Mattock::Task classes should be created with parent configs, then Rake task args&quot;</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="20">
+        <li class="never" data-hits="" data-linenumber="32">
           
           
           <code class="ruby">      end</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="21">
+        <li class="covered" data-hits="1" data-linenumber="33">
           <span class="hits">1</span>
           
           <code class="ruby">      super(*configs)</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="22">
+        <li class="never" data-hits="" data-linenumber="34">
           
           
           <code class="ruby">    end</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="23">
+        <li class="never" data-hits="" data-linenumber="35">
           
           
           <code class="ruby"></code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="24">
+        <li class="covered" data-hits="1" data-linenumber="36">
           <span class="hits">1</span>
           
           <code class="ruby">    def resolve_configuration</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="25">
+        <li class="covered" data-hits="1" data-linenumber="37">
           <span class="hits">1</span>
           
           <code class="ruby">      if @extracted_task_args.empty?</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="26">
+        <li class="covered" data-hits="1" data-linenumber="38">
           <span class="hits">1</span>
           
           <code class="ruby">        self.task_args = [task_name]</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="27">
+        <li class="never" data-hits="" data-linenumber="39">
           
           
           <code class="ruby">      else</code>
         </li>
       
-        <li class="missed" data-hits="0" data-linenumber="28">
+        <li class="missed" data-hits="0" data-linenumber="40">
           
           
           <code class="ruby">        self.task_args = @extracted_task_args</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="29">
+        <li class="never" data-hits="" data-linenumber="41">
           
           
           <code class="ruby">      end</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="30">
+        <li class="never" data-hits="" data-linenumber="42">
           
           
           <code class="ruby">    end</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="31">
+        <li class="never" data-hits="" data-linenumber="43">
           
           
           <code class="ruby"></code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="32">
+        <li class="covered" data-hits="1" data-linenumber="44">
           <span class="hits">1</span>
           
           <code class="ruby">    def action</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="33">
+        <li class="never" data-hits="" data-linenumber="45">
           
           
           <code class="ruby">    end</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="34">
+        <li class="never" data-hits="" data-linenumber="46">
           
           
           <code class="ruby"></code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="35">
+        <li class="never" data-hits="" data-linenumber="47">
+          
+          
+          <code class="ruby">    # I continue to look for an alternative here.</code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="48">
           <span class="hits">1</span>
           
           <code class="ruby">    def task_class</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="36">
+        <li class="covered" data-hits="1" data-linenumber="49">
           <span class="hits">1</span>
           
           <code class="ruby">      return @task_class if @task_class</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="37">
+        <li class="covered" data-hits="1" data-linenumber="50">
           <span class="hits">1</span>
           
           <code class="ruby">      @task_class = Class.new(self.class) do</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="38">
+        <li class="covered" data-hits="1" data-linenumber="51">
           <span class="hits">1</span>
           
           <code class="ruby">        define_method :initialize, Rake::Task.instance_method(:initialize)</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="39">
+        <li class="never" data-hits="" data-linenumber="52">
           
           
           <code class="ruby">      end</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="40">
+        <li class="never" data-hits="" data-linenumber="53">
           
           
           <code class="ruby">    end</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="41">
+        <li class="never" data-hits="" data-linenumber="54">
           
           
           <code class="ruby"></code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="42">
+        <li class="covered" data-hits="1" data-linenumber="55">
           <span class="hits">1</span>
           
           <code class="ruby">    def inspect</code>
         </li>
       
-        <li class="missed" data-hits="0" data-linenumber="43">
+        <li class="missed" data-hits="0" data-linenumber="56">
           
           
           <code class="ruby">      &quot;#{self.class.name}: #{self.task_args.inspect}&quot;</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="44">
+        <li class="never" data-hits="" data-linenumber="57">
           
           
           <code class="ruby">    end</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="45">
+        <li class="never" data-hits="" data-linenumber="58">
           
           
           <code class="ruby"></code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="46">
+        <li class="covered" data-hits="1" data-linenumber="59">
           <span class="hits">1</span>
           
           <code class="ruby">    def define</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="47">
+        <li class="covered" data-hits="1" data-linenumber="60">
           <span class="hits">1</span>
           
           <code class="ruby">      task = task_class.define_task(*task_args) do</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="48">
+        <li class="covered" data-hits="1" data-linenumber="61">
           <span class="hits">1</span>
           
           <code class="ruby">        action</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="49">
+        <li class="never" data-hits="" data-linenumber="62">
           
           
           <code class="ruby">      end</code>
         </li>
       
-        <li class="covered" data-hits="1" data-linenumber="50">
+        <li class="covered" data-hits="1" data-linenumber="63">
           <span class="hits">1</span>
           
           <code class="ruby">      copy_settings_to(task)</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="51">
+        <li class="never" data-hits="" data-linenumber="64">
           
           
           <code class="ruby">    end</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="52">
+        <li class="never" data-hits="" data-linenumber="65">
           
           
           <code class="ruby">  end</code>
         </li>
       
-        <li class="never" data-hits="" data-linenumber="53">
+        <li class="never" data-hits="" data-linenumber="66">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="67">
+          <span class="hits">1</span>
+          
+          <code class="ruby">  class Task &lt; Rake::Task</code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="68">
+          <span class="hits">1</span>
+          
+          <code class="ruby">    include TaskMixin</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="69">
+          
+          
+          <code class="ruby">  end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="70">
+          
+          
+          <code class="ruby"></code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="71">
+          <span class="hits">1</span>
+          
+          <code class="ruby">  class FileTask &lt; Rake::FileTask</code>
+        </li>
+      
+        <li class="covered" data-hits="1" data-linenumber="72">
+          <span class="hits">1</span>
+          
+          <code class="ruby">    include TaskMixin</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="73">
+          
+          
+          <code class="ruby">  end</code>
+        </li>
+      
+        <li class="never" data-hits="" data-linenumber="74">
           
           
           <code class="ruby">end</code>

data/lib/mattock/task.rb

@@ -1,15 +1,27 @@
 require 'mattock/cascading-definition'
 require 'rake/task'
+require 'rake/file_task'
 
 module Mattock
-  class Task < Rake::Task
+  # A configurable subclass of Rake::Task, such that you can use a
+  # configuration block to change how a common task behaves, while still
+  # overriding Rake API methods like Task#needed? and Task#timestamp
+
+  module TaskMixin
     include CascadingDefinition
 
     setting :task_name
     setting :task_args
 
-    def self.default_taskname(name)
-      setting(:task_name, name)
+    module ClassMethods
+      def default_taskname(name)
+        setting(:task_name, name)
+      end
+    end
+
+    def self.included(mod)
+      mod.class_eval{ extend ClassMethods }
+      super
     end
 
     def initialize(*args)
@@ -32,6 +44,7 @@ module Mattock
     def action
     end
 
+    # I continue to look for an alternative here.
     def task_class
       return @task_class if @task_class
       @task_class = Class.new(self.class) do
@@ -50,4 +63,12 @@ module Mattock
       copy_settings_to(task)
     end
   end
+
+  class Task < Rake::Task
+    include TaskMixin
+  end
+
+  class FileTask < Rake::FileTask
+    include TaskMixin
+  end
 end

metadata

@@ -2,7 +2,7 @@
 name: mattock
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors: 
 - Judson Lester
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-02-04 00:00:00 Z
+date: 2012-02-06 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: corundum
@@ -189,7 +189,7 @@ rdoc_options:
 - --main
 - doc/README
 - --title
-- mattock-0.1.2 RDoc
+- mattock-0.1.3 RDoc
 require_paths: 
 - lib/
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -197,7 +197,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 684090449
+      hash: 184575953
       segments: 
       - 0
       version: "0"