mattock 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4c1151f03e2d5b1b2beae2dbe83fc913acc5781d
-  data.tar.gz: 76e9f884109d43f50acfdf12683f8f8922492410
+  metadata.gz: 058ff110aa5e5ffd99da0527d769e565d2219fd1
+  data.tar.gz: 56845e99beb502e10826cd0baa17385ec49a66db
 SHA512:
-  metadata.gz: 64dd7f1524c69be09ec730ef8d12493d0f0db779a08bac00b1acbf1e17eb9d5c69040cae92e5897faf25b4fb5845d850c3d6207ca11c51ceb145adf1dd5b218f
-  data.tar.gz: 7bdd7d4d2c1010ea3fefad1fd0cf0641398207ff339dbc943bd0d2edadc6655baea1ed80f55ff1c074b40ee19f269acd958af36fd49f89d19d51fd59e34296c5
+  metadata.gz: 8c9ae840327f2fdf631b8505221b416fba46e2d635c928cfa9875225bb41ac0ace63261ad71c30891cc8f4a411a5466331da3ca325fdc107a8e3574b41392419
+  data.tar.gz: f31d1b3427076cf6fd81ec8dc4d7361bd4e4e7e949e2e0dd0b4810c6964a50654f19ffe65fa7cdcfc03ac9021aca8b58e396b594e4519a619bab9755dc055f13

data/lib/mattock/cascading-definition.rb

@@ -15,6 +15,8 @@ module Mattock
   #
   #    define
   #
+  #(see #setup_cascade)
+  #
   #Override those methods to adjust how a TaskLib processes its options
   #
   #The only method not defined here is {Configurable#setup_defaults}
@@ -63,7 +65,7 @@ module Mattock
     #Called after the configuration block has been called, so secondary
     #configurations can be set up.  For instance, consider:
     #
-    #    self.command ||= bin_dir + command_name
+    #    self.command = bin_dir + command_name if is_unset?(:command)
     #
     #The full path to the command could be set in the configuration block in
     #the Rakefile, or if bin_dir and command_name are set, we can put those

data/lib/mattock/configurable/directory-structure.rb

@@ -37,7 +37,11 @@ module Mattock
         end
         alias path_name pathname
 
-        if (false)
+        def to_s
+          fail_unless_set(:absolute_path)
+          absolute_path
+        end
+
         def inspect
           "<path: #{
             if field_unset?(:absolute_path)
@@ -51,7 +55,6 @@ module Mattock
             end
           }>"
         end
-        end
       end
 
       module ClassMethods
@@ -77,7 +80,6 @@ module Mattock
           end
           parent_field = path(field_name, rel_path)
 
-          root_paths << parent_field
           self.path_heirarchy += args.map do |child_field|
             [parent_field, child_field]
           end
@@ -117,6 +119,7 @@ module Mattock
           end
 
           path_heirarchy.reverse.each do |parent_field, child_field|
+            next if missing_relatives.include?(parent_field)
             parent = parent_field.value_on(instance)
             resolve_path_on(instance, parent, child_field, missing_relatives)
           end

data/lib/mattock/tasklib.rb

@@ -2,38 +2,49 @@ require 'rake/tasklib'
 require 'mattock/cascading-definition'
 
 module Mattock
-  #Rake::Tasklib provides a common, well known way to generalize tasks and use
-  #them in multiple projects.
+  # {Mattock::TaskLib} provides a base class to build tasklibs on so that you
+  # can get to what you care about, and get option validation as well.
   #
-  #Typically, the #initialize method for CoolTask yields itself into the block
-  #(so, 't' in the example) and then runs #define which does the heavy lifting
-  #to actually create tasks and set them up with dependencies and whatnot.
+  # The convention that's added in Mattock is that Tasklibs are passed to each
+  # other as arguments, so that behavior can be composed out of modular
+  # components.
   #
-  #Rake::Tasklib doesn't really provide much in the way of help or guidance
-  #about how to do this, though, and everyone winds up having to do a lot of
-  #the same work.
+  # To define a new task lib: subclass {TaskLib}, add some ::setting calls, and
+  # override #define to add some tasks.
   #
-  #Mattock::TaskLib provides a base class to build tasklibs on so that you can
-  #get to what you care about, and get option validation as well.
+  # To use your tasklib, instantiate with a block, optionally passing other
+  # task libs to copy configuration from.
   #
-  #The convention that's added in Mattock is that Tasklibs are passed to each
-  #other as arguments, so that behavior can be composed out of modular
-  #components.
+  # @example
+  #     class CoolTask < Mattock::TaskLib
+  #       settings :option_one, :option_two
   #
-  #@example
-  #    CoolTask.new(:args) do |t|
-  #      t.option_one = "cool"
-  #      t.option_two = "very"
-  #    end
+  #       default_namespace :be
   #
-  #@example Composition
-  #    transport = HTTPTasks.new do |t|
-  #      t.server = http://mycoolserver.com
-  #    end
+  #       def define
+  #         task :cool do
+  #           puts "I am so #{option_one} #{option_two}"
+  #         end
+  #       end
+  #     end
   #
-  #    UploadTasks.new(transport) do |t|
-  #      t.dir = "./source_dir"
-  #    end
+  #     CoolTask.new(:args) do |t|
+  #       t.option_one = "cool"
+  #       t.option_two = "very"
+  #     end
+  #
+  # @example
+  #     > rake be:cool
+  #     I am so very cool
+  #
+  # @example Composition
+  #     transport = HTTPTasks.new do |t|
+  #       t.server = http://mycoolserver.com
+  #     end
+  #
+  #     UploadTasks.new(transport) do |t|
+  #       t.dir = "./source_dir"
+  #     end
   #
   #The configuration handling is provided by {CascadingDefinition}, and
   #configuration options are built using {Configurable}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mattock
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Judson Lester
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-22 00:00:00.000000000 Z
+date: 2014-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: corundum
@@ -145,7 +145,7 @@ rdoc_options:
 - --main
 - doc/README
 - --title
-- mattock-0.8.0 RDoc
+- mattock-0.9.0 RDoc
 require_paths:
 - lib/
 required_ruby_version: !ruby/object:Gem::Requirement