nake 0.0.6 → 0.0.7

data/CHANGELOG

@@ -26,3 +26,6 @@
 = Version 0.0.6
   * Cucumber features
   * DSL helper rule
+
+= Version 0.0.7
+  * Added Task#boot method for setting some stuff after other tasks boot

data/bin/nake

@@ -6,22 +6,6 @@ require "nake"
 require "nake/args"
 require "nake/helpers"
 
-# TODO: what if I want to run:
-# ./bin/nake -T
-# ./bin/nake --verbose -T
-# ./examples/flags.rb --verbose
-
-# First file in arguments is separator between args for nake and for task
-# If there is no file in the arguments
-# co kdyz omezim tasky na list etc a nebudou moct mit --task etc?
-# nake --verbose list arg1 arg2 --with-something
-# => zmizi potreba aliasu
-# => potreba API pro mapovani na -T etc
-# Nake.args["-T"] = Nake::Task[:tasks]
-
-# !!!!!! --verbose neni runable task to jen switchuje naky shity, takze -T by melo fungovat tak, ze naplni Nake.parse[:task] s taskem co se ma runnout
-# First argument has to be path to file with your tasks
-
 # parse arguments
 begin
   Nake.parse

data/examples/boot.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ./bin/nake
+
+# You might want to give more useful description, however you don't have access
+# to some variables so far ... at least with Rake. Nake provides boot method which
+# run after everything is loaded, and if you specify optional dependencies for the
+# boot method, it will run the boot block of specified tasks first. This might come
+# handy time to time, but usually it's enough to use it without arguments since you
+# usually need just to load the whole task file where is all the configuration.
+
+# Typical usecases:
+# - you want to provide concrete info in description
+# - you need to access configuration of a task on other place than in the define block
+
+Task.new(:build) do |task|
+  task.boot(:release) do
+    task.description = "Release version #{Task[:release].config[:version]}"
+  end
+end

data/examples/dependencies.rb

@@ -1,5 +1,8 @@
 #!/usr/bin/env ./bin/nake
 
+# You can do the same by adding Task[name].call in the define block, but please,
+# don't use this approach. Dependencies are readable and if someone wants to,
+# he can simply remove a dependency from the dependency array.
 task(:greet1)
 task(:greet2)
 

data/features/executable.feature

@@ -1,5 +1,8 @@
 #!/usr/bin/env cucumber
 
+# ./bin/nake -T
+# ./bin/nake --verbose -T
+# ./examples/flags.rb --verbose
 Feature: Running bin/nake
   Scenario: Running bin/nake without any arguments
     When I run "./bin/nake"

data/lib/nake.rb

@@ -3,7 +3,7 @@
 require "nake/task"
 
 module Nake
-  VERSION ||= "0.0.6"
+  VERSION ||= "0.0.7"
   def self.verbose
     @@verbose
   rescue NameError
@@ -79,6 +79,7 @@ module Nake
   # @since 0.0.1
   # @author Jakub Stastny
   def self.run_task
+    Task.boot
     name, *args = Nake.parse[:task]
     task = Task[name]
     if name.nil?

data/lib/nake/args.rb

@@ -7,6 +7,8 @@ argument("-H", "--help") do
 end
 
 argument("-T", "--tasks") do |pattern = nil|
+  Task.boot
+
   tasks, options = Task.tasks.select { |name, task| not task.hidden? }.sort.partition { |key, value| not key.match(/^-/) }
   arguments = Nake.args.sort
 
@@ -31,6 +33,7 @@ argument("-T", "--tasks") do |pattern = nil|
 end
 
 argument("-i", "--interactive") do |task = nil|
+  Task.boot
   ARGV.clear # otherwise IRB will parse it
 
   require "irb"

data/lib/nake/task.rb

@@ -9,14 +9,7 @@ module Nake
 
   class Task
     def self.[](name)
-      name = name.to_s
-      self.tasks[name] || self.find_in_aliases(name)
-    end
-
-    # @private
-    def self.find_in_aliases(name)
-      _, task = self.tasks.find { |_, task| task.aliases.include?(name) }
-      return task
+      self.tasks[name.to_s]
     end
 
     def self.[]=(name, task)
@@ -28,6 +21,12 @@ module Nake
       @@tasks ||= Hash.new
     end
 
+    def self.boot
+      self.tasks.each do |name, task|
+        task.boot!
+      end
+    end
+
     # return existing task if task with given name already exist
     def self.new(name, *dependencies, &block)
       task = self[name]
@@ -35,16 +34,9 @@ module Nake
     end
 
     attr_accessor :name, :description, :dependencies, :hidden, :original_args
-    attr_reader :blocks, :aliases
+    attr_reader :blocks
     def initialize(name, *dependencies, &block)
-      @aliases, @hidden = Array.new, false
-      # This is a bit weird, but it's best solution
-      # when we want to keep API simple and keep it
-      # as one object even if it has more names
-      if name.respond_to?(:join) # array
-        name, *aliases = name
-        self.aliases.push(*aliases)
-      end
+      @hidden = false
       @name, @blocks = name.to_sym, Array.new
       @dependencies  = Array.new
       self.register
@@ -95,27 +87,48 @@ module Nake
         note "Executing task #{name} with arguments #{args.inspect} and options #{options.inspect}"
         debug "Config #{self.config.inspect}"
         self.blocks.each do |block|
-          # we can't use arity, because it returns 0 for lambda { |options = Hash.new| }.arity
-          # if we define method with one optional argument, it will returns -1
+          block.call(*args, options)
+        end
+      end
+    end
 
-          if RUBY_VERSION >= "1.9.2"
-            raise ArgumentError, "Task can't take block arguments" if args.length + 1 > block.parameters.select { |type, name| type.eql?(:req) || type.eql?(:opt) }.length
-            raise ArgumentError, "Task can't take block arguments" if block.parameters.any? { |type, name| type.eql?(:block) }
-          end
+    def bootloaders
+      @bootloaders ||= Array.new
+    end
+
+    def boot_dependencies
+      @boot_dependencies ||= Array.new
+    end
+
+    def boot(*dependencies, &block)
+      self.boot_dependencies.push(*dependencies)
+      self.bootloaders.push(block)
+    end
 
-          if RUBY_VERSION >= "1.9.2" && block.parameters.empty?
-            block.call
-          else
-            block.call(*args, options)
+    def boot!
+      unless self.boot_dependencies.empty? && self.bootloaders.empty?
+        note "Booting #{self.name}"
+      end
+      while dependency = self.boot_dependencies.shift
+        self.class[dependency].tap do |task|
+          if task.nil?
+            raise TaskNotFound, "Task #{dependency} doesn't exist!"
           end
+          task.boot!
         end
       end
+      while block = self.bootloaders.shift
+        block.call
+      end
+    end
+
+    def booted?
+      self.bootloaders.empty? && self.boot_dependencies.empty?
     end
 
     def reset!
       self.dependencies.clear
       self.blocks.clear
-      self.aliases.clear
     end
 
     protected

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: nake
 version: !ruby/object:Gem::Version 
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors: 
 - "Jakub \xC5\xA0\xC5\xA5astn\xC3\xBD aka Botanicus"
@@ -38,6 +38,7 @@ files:
 - CHANGELOG
 - examples/arguments.rb
 - examples/basic.rb
+- examples/boot.rb
 - examples/complex.rb
 - examples/configuration.rb
 - examples/default.rb
@@ -47,10 +48,10 @@ files:
 - examples/helpers.rb
 - examples/invoking.rb
 - examples/script.rb
-- examples/setup.rb
 - examples/task_arguments.rb
 - features/arguments.feature
 - features/basic.feature
+- features/boot.feature
 - features/builtin_arguments.feature
 - features/complex.feature
 - features/configuration.feature
@@ -63,7 +64,6 @@ files:
 - features/helpers.feature
 - features/invoking.feature
 - features/script.feature
-- features/setup.feature
 - features/steps.rb
 - features/task_arguments.feature
 - lib/nake/args.rb
@@ -104,8 +104,7 @@ licenses: []
 
 post_install_message: |-
   === Changes in the last Nake ===
-  - Cucumber features
-  - DSL helper rule
+  - Added Task#boot method for setting some stuff after other tasks boot
 rdoc_options: []
 
 require_paths: 

data/examples/setup.rb

@@ -1,24 +0,0 @@
-#!/usr/bin/env ./bin/nake
-
-# NOTE: this isn't implemented yet!
-# THERE MIGHT TO BE USEFUL TO HAVE BASE CLASS FOR TASK, BECAUSE FILE TASK DOESN'T HAVE ALIASES ETC
-Task.new(:build) do |task|
-  task.description = "Release version #{Task[:release].config[:version]}" # but release task might not exist yet
-end
-
-# soo ...
-Task.new(:build) do |task|
-  task.setup do |variable|
-    task.description = "Release version #{Task[:release].config[:version]}"
-  end
-end
-
-# hodi se hlavne pro descriptions a pro pushovani veci do dependencies, protoze z dependencies se daji odstranit, kdezto z procu, kde se invokujou explicitne, to jde fakt tezko
-# setup task se vola na zacatku Nake.run
-
-# advanced ...
-Task.new(:build) do |task|
-  task.setup(:release, :other_task) do |variable|
-    task.description = "Release version #{Task[:release].config[:version]}"
-  end
-end