spud 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cce5f6a59f2b4bcc19711fa385dedb9a57aa1783e4cf0d56f3bafbf03c964aeb
-  data.tar.gz: 7e00b4f4ecd4c475cbd4e4264e44f6ed28d45aedb69f728edf27f36c093fb34b
+  metadata.gz: c426d3d847aaa06b411cb1eba2e84ddf7ea45ff43d9d02781075637cac24f395
+  data.tar.gz: 2e37705b14ca816367dd038eb51d402e20d4fac00e144f263fcc8a930654023e
 SHA512:
-  metadata.gz: fd3523e631ab8f99f8a54768a4a97c0a24b726e71938c8e7fd779e738de6d8d2648d53bbadb3654f0b7e7ddf9e2c3568ce14038e1bb1b7f093044f17c4c86002
-  data.tar.gz: 37b04a554bc571547c66f88d36937e0340d6290ec9c797317bf8c1bdbe1e37241882425133f721306a83daceff8f6274d692a3a788c9b2dff08b202814b8dfcc
+  metadata.gz: 44a4bd5790ca2613a7af968fc04c7460264a83743ca68ce77513eaafa41098b4fedea9d8a95163100eef2ddb48f2f91182ba7d38df0cdf4a04ae05d8f146b641
+  data.tar.gz: 17f6f57907780792ee7606520a53a2b373b722ab88bf981eb8193663975e716583f3597835035c228e79c9b8d7c6ea43ea88ab3d63be615b1c6530949c1da7cc

data/lib/spud/build_tools/spud/dependency.rb

@@ -0,0 +1,38 @@
+module Spud
+  module BuildTools
+    module Spud
+      class Dependency
+        def initialize(source, target)
+          @sources = [source].flatten
+          @targets = [target].flatten
+        end
+
+        # @return [Boolean]
+        def need_to_update?
+          !up_to_date?
+        end
+
+        # @return [Boolean]
+        def up_to_date?
+          source_filenames = Dir[*@sources]
+          return true if source_filenames.empty?
+
+          newest_source = source_filenames
+            .map(&File.method(:stat))
+            .map(&:mtime)
+            .max
+
+          target_filenames = Dir[*@targets]
+          return false if target_filenames.empty?
+
+          oldest_target = target_filenames
+            .map(&File.method(:stat))
+            .map(&:mtime)
+            .min
+
+          newest_source < oldest_target
+        end
+      end
+    end
+  end
+end

data/lib/spud/build_tools/spud/dsl/file.rb

@@ -9,8 +9,8 @@ module Spud
             require("./#{name}")
           end
 
-          def task(name, *, &block)
-            BuildTools::Spud::Task.add_task(name, &block)
+          def task(name, dependencies = {}, &block)
+            BuildTools::Spud::Task.add_task(name, dependencies, &block)
           end
 
           def method_missing(name, *args, &block)

data/lib/spud/build_tools/spud/task.rb

@@ -1,6 +1,8 @@
+require 'stringio'
 require 'spud/error'
 require 'spud/task_args'
 require 'spud/build_tools/task'
+require 'spud/build_tools/spud/dependency'
 require 'spud/build_tools/spud/task'
 require 'spud/build_tools/spud/dsl/file'
 require 'spud/build_tools/spud/dsl/task'
@@ -27,10 +29,13 @@ module Spud
         # @param task [String]
         # @param block [Proc]
         # @return [void]
-        def self.add_task(task, &block)
-          raise "task '#{task}' somehow created without filename" unless @filename
-
-          new(name: qualified_name(@filename, task.to_s), filename: @filename, &block)
+        def self.add_task(task, dependencies, &block)
+          new(
+            name: qualified_name(@filename, task.to_s),
+            filename: @filename,
+            dependencies: dependencies,
+            &block
+          )
         end
 
         # @param filename [String]
@@ -49,10 +54,14 @@ module Spud
 
         # @param filename [String]
         # @param task [String]
+        # @return [BuildTools::Spud::Task]
         def self.task_for(filename, task)
           Runtime.tasks[qualified_name(filename, task.to_s)]
         end
 
+        # @param filename [String]
+        # @param task [String]
+        # @return [String]
         def self.qualified_name(filename, task)
           raise "task '#{task}' somehow created without filename" unless filename
 
@@ -71,8 +80,13 @@ module Spud
           (dirname.split('/') + basename_array).join('.')
         end
 
-        def initialize(name:, filename:, &block)
-          super
+        # @param name [String]
+        # @param filename [String]
+        # @param dependencies [Hash]
+        # @param block [Proc]
+        def initialize(name:, filename:, dependencies:, &block)
+          super(name: name, filename: filename)
+          @dependencies = dependencies.map { |to, from| Dependency.new(to, from) }
           @block = block
         end
 
@@ -80,7 +94,12 @@ module Spud
         # @param named [Hash]
         # @return [Object]
         def invoke(positional, named)
-          check_required!(positional)
+          if up_to_date?
+            puts "'#{name}' up to date"
+            return
+          end
+
+          check_required_args!(positional)
 
           return task_dsl.instance_exec(*positional, &@block) unless args.any_named?
 
@@ -94,11 +113,37 @@ module Spud
           @args ||= ::Spud::TaskArgs.from_block(filename, &@block)
         end
 
+        # @return [String]
+        def details
+          filename, line_cursor = @block.source_location
+          line_cursor -= 1
+
+          lines = File.read(filename).split("\n")
+          builder = StringIO.new
+
+          while lines[line_cursor - 1] && lines[line_cursor - 1].start_with?('#')
+            line_cursor -= 1
+          end
+
+          while lines[line_cursor].start_with?('#')
+            builder.puts lines[line_cursor]
+            line_cursor += 1
+          end
+
+          until lines[line_cursor].start_with?('end')
+            builder.puts lines[line_cursor]
+            line_cursor += 1
+          end
+
+          builder.puts lines[line_cursor]
+          builder.string
+        end
+
         private
 
         # @param positional [Array<String>]
         # @return [void]
-        def check_required!(positional)
+        def check_required_args!(positional)
           required_positional = args.required_positional
           missing_positional = required_positional.length - positional.length
           if missing_positional > 0
@@ -107,6 +152,13 @@ module Spud
           end
         end
 
+        # @return [Boolean]
+        def up_to_date?
+          return false if @dependencies.empty?
+
+          @dependencies.all?(&:up_to_date?)
+        end
+
         # @return [Spud::DSL::Task]
         def task_dsl
           @task_dsl ||= DSL::Task.new(filename)

data/lib/spud/build_tools/task.rb

@@ -31,6 +31,11 @@ module Spud
       def args
         @args ||= TaskArgs.new([])
       end
+
+      # @return [String]
+      def details
+        name
+      end
     end
   end
 end

data/lib/spud/cli/parser.rb

@@ -50,6 +50,7 @@ module Spud
         case flag
         when '-h', '--help' then options.help = true
         when '-f', '--files' then options.files = true
+        when '-i', '--inspect' then options.inspect = true
         when '-w', '--watch' then options.watches << take!
         when '--debug' then options.debug = true
         else raise Error, "invalid option: '#{flag}'"

data/lib/spud/help.rb

@@ -13,9 +13,10 @@ module Spud
       help.puts '  spud [options] <task> [args]'
       help.puts
       help.puts 'options:'
-      help.puts '  -h, --help   show this help dialog'
-      help.puts '  -f, --files  list parsed files'
-      help.puts '  --debug      run in debug mode'
+      help.puts '  -h, --help     show this help dialog'
+      help.puts '  -f, --files    list parsed files'
+      help.puts '  -i, --inspect  show details about a task'
+      help.puts '  --debug        run in debug mode'
 
       puts help.string
     end

data/lib/spud/options.rb

@@ -1,6 +1,6 @@
 module Spud
   class Options
-    BOOLEANS = %i[help files debug]
+    BOOLEANS = %i[help files inspect debug]
 
     BOOLEANS.each do |name|
       attr_accessor name

data/lib/spud/runtime.rb

@@ -32,6 +32,11 @@ module Spud
           return
         end
 
+        if options.inspect?
+          puts get_task(args.task).details
+          return
+        end
+
         invoke(args.task, args.positional, args.named)
       rescue Error => error
         puts error.message
@@ -45,9 +50,14 @@ module Spud
       # @param positional [Array]
       # @param named [Hash]
       def invoke(task_name, positional = [], named = {})
+        get_task(task_name).invoke(positional, named)
+      end
+
+      def get_task(task_name)
         task = tasks[task_name.to_s]
         raise Error, "no task found for '#{task_name}'" unless task
-        task.invoke(positional, named)
+
+        task
       end
 
       # @return [Hash{String->Spud::Task}]

data/lib/spud/version.rb

@@ -1,3 +1,3 @@
 module Spud
-  VERSION = '0.2.2'
+  VERSION = '0.2.3'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spud
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Andrew Booth
@@ -65,6 +65,7 @@ files:
 - lib/spud/build_tools/make/task.rb
 - lib/spud/build_tools/package.json/task.rb
 - lib/spud/build_tools/spud/block_param_info.rb
+- lib/spud/build_tools/spud/dependency.rb
 - lib/spud/build_tools/spud/dsl/file.rb
 - lib/spud/build_tools/spud/dsl/task.rb
 - lib/spud/build_tools/spud/shell/command.rb