run_tasks 2.1.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f7e70e3d810695cb07c97a531311bae1ee7d8a78
-  data.tar.gz: 263c45ce78aef65d05cc2c5036f6862d1b1c4558
+SHA256:
+  metadata.gz: 857247c762c39960c83e5689ec558c8e39a5b36aafc84db9a8fd08931697df22
+  data.tar.gz: 90dd7fd4183acee7232f3c881c2fe550deeb4c326ca23c0c10fd7330b60d2b54
 SHA512:
-  metadata.gz: 97893a7e2faf8f9d8cc3a0851c37efcac9fc8f12f6a57324d40c0b5af1a4fc77e38939e0c5bffdc3003497727e99230e08e9ff3d4acd8189a0d98796cec25729
-  data.tar.gz: 0f417ff1bb2c43fd099d73084f9f7b32f8a77207e84da78466c2ca60a859be4437ad73d9a6047ac6bee5f28761c21ffe5826bfb31a96c7b9e34f862ba19ae1b3
+  metadata.gz: cb448955e6889e99bdf60235edb7294af0c381a90c8dddf7d805fbcc7ce56d307dbafcf128ec2ff66f786184df5324743b4d60925894bb44012e6737f511ccc1
+  data.tar.gz: f96b6ea0d728dcaff2b851163bf173af427729dab2df12bbddaf6adef442117b88b77a4d3255d185384ffbe3521a36beb34470f4545e0a4d9b9f570216c4ae54

data/bin/run

@@ -1,3 +1,4 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
-require_relative '../src/bootstrap'
+require_relative "../src/bootstrap"

data/completions/_run

@@ -0,0 +1,11 @@
+#compdef run
+
+_run() {
+  local output
+  output="$(run --completions 2>/dev/null)" || return
+  local -a tasks
+  tasks=(${(f)output})
+  _describe 'task' tasks
+}
+
+_run "$@"

data/src/bootstrap.rb

@@ -1,21 +1,21 @@
+# frozen_string_literal: true
+
 require "digest"
 require "fileutils"
 require "io/console"
 require "readline"
 require "rubygems"
 require "securerandom"
+require "rb_monkey"
+require "rb_gemspec"
+require "rb_markdown"
 
 # Require all files.
 Dir.glob(
-  File.join(__dir__, "{monkey,gemspec,markdown,version,run}", "**", "*.rb"),
+  File.join(__dir__, "run", "**", "*.rb"),
   &method(:require)
 )
 
-# Check for new versions.
-if rand(1..5) == 5
-  Run::Core::VerifyRunVersion.run
-end
-
 # Expose global methods.
 [:task, :run].each do |name|
   define_method name do |*args, **options, &block|
@@ -27,8 +27,12 @@ end
   end
 end
 
-# Define global tasks.
-task :rspec do |path|
+define_method :version do |version|
+  Run::Core.runfile_version = version
+end
+
+# Run Rspec tests (if any).
+task :rspec do |path = "spec/src"|
   command = "bundle exec rspec"
 
   if !path
@@ -40,6 +44,39 @@ task :rspec do |path|
   end
 end
 
+# Install ZSH completions.
+task :install_completions do
+  source = File.expand_path(File.join(__dir__, '..', 'completions', '_run'))
+  dir    = File.expand_path('~/.zfunc')
+  dest   = File.join(dir, '_run')
+  zshrc  = File.expand_path('~/.zshrc')
+
+  FileUtils.mkdir_p(dir)
+  FileUtils.cp(source, dest)
+
+  content = File.exist?(zshrc) ? File.read(zshrc) : ''
+  additions = []
+  additions << 'fpath=(~/.zfunc $fpath)' unless content.include?('~/.zfunc')
+  additions << 'autoload -Uz compinit && compinit' unless content.match?(/compinit/)
+
+  if additions.any?
+    File.open(zshrc, 'a') { |f| f.puts "\n# run completions\n#{additions.join("\n")}" }
+  end
+
+  puts "ZSH completions installed."
+  puts "Run 'source ~/.zshrc' to activate."
+end
+
+# Publish the gem (if publishable).
+task :publish do
+  gemspec_files = Dir.glob(File.join(Dir.pwd, "*.gemspec"))
+  raise ".gemspec file not found in the project directory" if gemspec_files.empty?
+  gemspec = Gem::Specification::load(gemspec_files.first)
+  run "gem build #{gemspec.name}"
+  run "gem push #{gemspec.name}-#{gemspec.version}.gem"
+  `rm #{gemspec.name}-#{gemspec.version}.gem`
+end
+
 # Expose helpers.
 Dir.glob(File.join(__dir__, "run", "helper", "*.rb")) do |path|
   filename = File.basename(path, ".rb")
@@ -78,14 +115,20 @@ rescue SyntaxError => error
 rescue ArgumentError => error
   format_error error
   exit 6
-rescue Run::Error::NonExistingRunfile
-  puts "Runfile.rb does not exist in '#{Dir.pwd}'".red
+rescue Run::Error::NonExistingRunfile => error
+  puts error.message.red
   exit 7
 rescue Run::Error::Aborted => error
   exit 9
 rescue Run::Error::ExistingTask => error
   puts error.message.red
   exit 10
+rescue Run::Error::NonExistingTask => error
+  puts error.message.red
+  exit 12
+rescue Run::Error::RunfileVersionMismatch => error
+  puts error.message.red
+  exit 13
 rescue => error
   format_error error
   exit 4

data/src/run/core/help.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "ripper"
 
 module Run
@@ -16,9 +18,10 @@ module Run
 
           if help_verbatim[:comments].size > 0
             help_verbatim[:comments].each_with_index do |comment, comment_line|
+              terminal_width = (STDOUT.winsize[1] rescue 80)
               split_comment = split_verbatim(
                 comment,
-                STDOUT.winsize[1] - tasks_column_length - 2
+                terminal_width - tasks_column_length - 2
               )
               split_comment.map.with_index do |chunk, chunk_line|
                 text = comment_line == 0 && chunk_line == 0 ?
@@ -32,10 +35,17 @@ module Run
             output += "#{name_verbatim}\n"
           end
 
+          if help_verbatim[:params].any?
+            indent = " " * tasks_column_length
+            help_verbatim[:params].each do |p|
+              output += "#{indent}  - #{format_param(p)}\n"
+            end
+          end
+
           output
         end
 
-        puts output
+        output
       end
 
       private
@@ -50,6 +60,7 @@ module Run
           lines_to_scan = (0..(task[:line] - 2 < 0 ? 0 : task[:line] - 2)).to_a.reverse
           {
             names: task[:names],
+            params: task[:params],
             comments: lines_to_scan.each_with_object([]) do |current_line, comments|
               match = /^\s*#\s*(?<comment>.*?)\s*$/.match(lines[current_line])
               break comments if !match
@@ -62,8 +73,10 @@ module Run
       # @param contents [String]
       # @return [Array<Hash>]
       def self.extract_tasks(contents)
-        Ripper.sexp(contents)[1].each_with_object([]) do |(id, sexp), tasks|
-          next if id != :method_add_block || sexp.fetch(1, nil)&.fetch(1, nil) != "task"
+        Ripper.sexp(contents)[1].each_with_object([]) do |node, tasks|
+          next if node[0] != :method_add_block
+          sexp = node[1]
+          next if sexp.fetch(1, nil)&.fetch(1, nil) != "task"
 
           names = case sexp[2][1][0][0]
                   when :symbol_literal
@@ -86,12 +99,85 @@ module Run
           tasks << {
             names: names,
             line: line,
+            params: extract_params(node[2]),
           }
         end.sort do |a, b|
           a[:names].first <=> b[:names].first
         end
       end
 
+      # @param block_node [Array, nil]
+      # @return [Array<Hash>]
+      def self.extract_params(block_node)
+        return [] if block_node.nil?
+        block_var = block_node[1]
+        return [] if block_var.nil?
+        params = block_var[1]
+        return [] if params.nil?
+
+        result = []
+
+        (params[1] || []).each do |p|
+          result << { name: p[1], required: true, keyword: false, default: nil }
+        end
+
+        (params[2] || []).each do |p|
+          result << { name: p[0][1], required: false, keyword: false, default: node_to_s(p[1]) }
+        end
+
+        (params[5] || []).each do |p|
+          name = p[0][1].chomp(":")
+          if p[1] == false
+            result << { name: name, required: true, keyword: true, default: nil }
+          else
+            result << { name: name, required: false, keyword: true, default: node_to_s(p[1]) }
+          end
+        end
+
+        result
+      end
+
+      # @param node [Array, nil]
+      # @return [String]
+      def self.node_to_s(node)
+        return "nil" if node.nil?
+        case node[0]
+        when :string_literal
+          node[1][1..-1].map { |p| p[0] == :@tstring_content ? p[1] : "..." }.join
+        when :@int, :@float
+          node[1]
+        when :var_ref
+          node[1][1]
+        when :symbol_literal
+          node[1][1][1]
+        when :array
+          "[]"
+        when :hash
+          "{}"
+        else
+          "..."
+        end
+      end
+
+      # @param param [Hash]
+      # @return [String]
+      def self.format_param(param)
+        name = param[:name]
+        if param[:keyword]
+          if param[:required]
+            "<#{name}=<value>>"
+          else
+            "[#{name}=<value>] " + param[:default].bright_cyan
+          end
+        else
+          if param[:required]
+            "<#{name}>"
+          else
+            "[#{name}] " + param[:default].bright_cyan
+          end
+        end
+      end
+
       # @param tasks [Array<Hash>]
       # @return [Integer]
       def self.compute_tasks_column_length(tasks)

data/src/run/core.rb

@@ -1,14 +1,37 @@
+# frozen_string_literal: true
+
 module Run
   module Core
-    RUNFILE_FILENAME = "Runfile.rb"
+    RUNFILE_FILENAME = ENV.fetch('RUNFILE', 'Runfile.rb')
     RESERVED_TASK_NAMES = ["help", "version"]
     @@tasks = []
+    @@runfile_version = nil
+
+    # @param version [Integer]
+    # @return [void]
+    def self.runfile_version=(version)
+      @@runfile_version = version.to_i
+    end
 
     # @return [void]
     def self.run_run
-      raise Run::Error::NonExistingRunfile.new if !File.exist?(RUNFILE_FILENAME)
-      require "./#{RUNFILE_FILENAME}"
-      run_requested_task if !display_help_if_needed
+      if ARGV.size == 1 && ARGV[0] == "--completions"
+        require File.expand_path(RUNFILE_FILENAME) if File.exist?(RUNFILE_FILENAME)
+        puts completions.join("\n")
+        return
+      end
+      raise Run::Error::NonExistingRunfile.new if !File.file?(RUNFILE_FILENAME)
+      if ARGV.size == 1 && ARGV[0] == "version"
+        puts version
+      elsif ARGV.size == 0 || (ARGV.size == 1 && ARGV[0] == "help")
+        require File.expand_path(RUNFILE_FILENAME)
+        check_runfile_version!
+        display_help
+      else
+        require File.expand_path(RUNFILE_FILENAME)
+        check_runfile_version!
+        run_requested_task
+      end
     end
 
     # @param task_name_or_command [Symbol, String]
@@ -16,10 +39,13 @@ module Run
     # @param options [Hash] Optional options sent to the task.
     # @return [void]
     def self.run(task_name_or_command, *arguments, **options)
-      if task_name_or_command.is_a?(Symbol)
-        run_block_task(task_name_or_command, *arguments, **options)
-      else
-        run_system_task(task_name_or_command)
+      quiet = options.delete(:quiet) || quiet?
+      with_quiet_context(quiet) do
+        if task_name_or_command.is_a?(Symbol)
+          run_block_task(task_name_or_command, *arguments, **options)
+        else
+          run_system_task(task_name_or_command)
+        end
       end
     end
 
@@ -45,16 +71,39 @@ module Run
 
     private
 
-    # @return [Boolean]
-    def self.display_help_if_needed
-      if ARGV.size == 0 || (ARGV.size == 1 && ["help", "version"].include?(ARGV[0]))
+    # @return [void]
+    def self.check_runfile_version!
+      if (@@runfile_version || 2) != version.to_s.split(".").first.to_i
+        raise Run::Error::RunfileVersionMismatch.new
+      end
+    end
+
+    # @return [void]
+    def self.display_version
+      puts Gemspec::Metadata.new("run_tasks").read.version
+    end
+
+    # @return [void]
+    def self.completions
+      (@@tasks.flat_map{ |t| t[:names] }.map(&:to_s) + RESERVED_TASK_NAMES).sort.uniq
+    end
+
+    # @return [void]
+    def self.display_help
+      puts
+      puts " Run v#{version}".bright_blue
+      contents = Run::Core::Help.run(File.read(File.join(Dir.pwd, RUNFILE_FILENAME)))
+      if contents.strip.size > 0
         puts
-        puts " Run v#{Gemspec::Metadata.new("run_tasks").read.version}".bright_blue
+        puts " Project tasks:".magenta
         puts
-        Run::Core::Help.run(File.read("./#{RUNFILE_FILENAME}"))
-        return true
+        puts contents
       end
-      false
+      puts
+      puts " Global tasks:".magenta
+      puts
+      puts Run::Core::Help.run(File.read(File.join(__dir__, "..", "bootstrap.rb")))
+      puts
     end
 
     # @return [void]
@@ -62,17 +111,25 @@ module Run
       name = ARGV[0].gsub('-', '_').to_sym # Auto-replace hyphens to underscores.
       raise Run::Error::UnknownTask.new(name) if !task_exist?(name)
 
-      # Cast value to the right type.
-      args = ARGV.slice(1, ARGV.size - 1).map do |arg|
-        value = Float(arg) rescue nil
-        next value if !value.nil?
-        next true if arg == "true"
-        next false if arg == "false"
-        next arg.to_sym if arg.match?(/^\w+$/)
-        arg
+      args = []
+      options = {}
+
+      ARGV.slice(1, ARGV.size - 1).each do |arg|
+        if (match = arg.match(/^\+(\w+)$/))
+          options[match[1].to_sym] = true
+        elsif (match = arg.match(/^-(\w+)$/))
+          options[match[1].to_sym] = false
+        else
+          value = Float(arg) rescue nil
+          next args << value if !value.nil?
+          next args << true if arg == "true"
+          next args << false if arg == "false"
+          next args << arg.to_sym if arg.match?(/^\w+$/)
+          args << arg
+        end
       end
 
-      run name, *args
+      run name, *args, **options
     end
 
     # @param name [Symbol]
@@ -86,13 +143,61 @@ module Run
     # @param options [Hash]
     # @return [void]
     def self.run_block_task(name, *args, **options)
-      @@tasks.find{ |item| item[:names].include? name }[:task].run(*args, **options)
+      task = @@tasks.find{ |item| item[:names].include? name }
+      raise Error::NonExistingTask.new(name) if task.nil?
+
+      task[:task].run(*args, **options)
     end
 
-    # @param name [Symbol]
+    # @param command [String]
+    # @return [void]
+    def self.run_system_task(command)
+      Run::Task::SystemTask.new(command).run
+    end
+
+    # @return [String]
+    def self.version
+      gemspec_files = Dir.glob(File.join(Dir.pwd, "*.gemspec"))
+
+      if gemspec_files.first
+        Gem::Specification::load(gemspec_files.first).version.to_s
+      else
+        Gemspec::Metadata.new("run_tasks").read.version
+      end
+    end
+
+    # @return [Boolean]
+    def self.quiet?
+      !!Thread.current[:quiet]
+    end
+
+    # @param quiet [Boolean]
     # @return [void]
-    def self.run_system_task(name)
-      Run::Task::SystemTask.new(name).run
+    def self.with_quiet_context(quiet)
+      already_quiet = quiet?
+      Thread.current[:quiet] = quiet || already_quiet
+
+      prev_stdout = nil
+      prev_stderr = nil
+
+      if quiet && !already_quiet
+        prev_stdout = $stdout.dup
+        prev_stderr = $stderr.dup
+        $stdout.reopen(File::NULL)
+        $stderr.reopen(File::NULL)
+      end
+
+      yield
+    rescue Interrupt
+      raise unless Thread.current[:quiet]
+    ensure
+      if prev_stdout
+        $stdout.reopen(prev_stdout)
+        $stderr.reopen(prev_stderr)
+        prev_stdout.close
+        prev_stderr.close
+      end
+      Thread.current[:quiet] = already_quiet
     end
   end
 end

data/src/run/error/aborted.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Run
   module Error
     class Aborted < StandardError

data/src/run/error/existing_task.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Run
   module Error
     class ExistingTask < StandardError

data/src/run/error/non_existing_runfile.rb

@@ -1,6 +1,12 @@
+# frozen_string_literal: true
+
 module Run
   module Error
     class NonExistingRunfile < StandardError
+      def initialize
+        path = ENV['RUNFILE'] || 'Runfile.rb'
+        super File.file?(path) ? "Runfile.rb does not exist in '#{Dir.pwd}'" : "'#{path}' is not a valid Runfile"
+      end
     end
   end
 end

data/src/run/error/non_existing_task.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Run
+  module Error
+    class NonExistingTask < StandardError
+      # @param name [String]
+      def initialize(name)
+        super "'#{name}' does not exist"
+      end
+    end
+  end
+end

data/src/run/error/reserved_task_name.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Run
   module Error
     class ReservedTaskName < StandardError

data/src/run/error/runfile_version_mismatch.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Run
+  module Error
+    class RunfileVersionMismatch < StandardError
+      def initialize
+        super "Runfile version mismatches Run version"
+      end
+    end
+  end
+end

data/src/run/error/unknown_task.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Run
   module Error
     class UnknownTask < StandardError

data/src/run/helper/are_you_sure_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Run
   module Helper
     class AreYouSureHelper
@@ -17,7 +19,7 @@ module Run
 
       # @return [String, Nil]
       def answer
-        STDIN.gets.chomp.downcase.chars.first
+        STDIN.gets&.chomp&.downcase&.chars&.first || "n"
       end
     end
   end

data/src/run/helper/bind_helper.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Run
+  module Helper
+    class BindHelper
+      TERM_TIMEOUT = 3
+      COLORS = %i[cyan magenta yellow green blue]
+
+      def initialize(*names)
+        @names = names
+      end
+
+      def run
+        pgids = {}
+        threads = []
+        mutex = Mutex.new
+        shutting_down = false
+
+        shutdown = lambda do
+          return if shutting_down
+          shutting_down = true
+          pgids.each_value { |pgid| Process.kill('TERM', -pgid) rescue nil }
+          Thread.new do
+            sleep TERM_TIMEOUT
+            pgids.each_value { |pgid| Process.kill('KILL', -pgid) rescue nil }
+          end
+        end
+
+        Signal.trap('INT')  { shutdown.call }
+        Signal.trap('TERM') { shutdown.call }
+
+        @names.each_with_index do |name, index|
+          prefix = "[#{name}]".send(COLORS[index % COLORS.size])
+          rd, wr = IO.pipe
+
+          pid = fork do
+            rd.close
+            $stdout.reopen(wr)
+            $stderr.reopen(wr)
+            wr.close
+            Process.setpgrp
+            Signal.trap('TERM') { exit 0 }
+            begin
+              Run::Core.run(name)
+              exit 0
+            rescue SystemExit => e
+              exit e.status
+            rescue Exception
+              exit 1
+            end
+          end
+
+          wr.close
+          pgids[name] = pid
+
+          threads << Thread.new(rd, prefix) do |pipe, pre|
+            pipe.each_line { |line| mutex.synchronize { STDOUT.write("#{pre} #{line}") } }
+            pipe.close
+          end
+        end
+
+        begin
+          loop do
+            Process.wait(-1)
+            shutdown.call
+          end
+        rescue Errno::ECHILD
+        end
+
+        threads.each(&:join)
+      end
+    end
+  end
+end

data/src/run/helper/catch_interruption_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Run
   module Helper
     class CatchInterruptionHelper

data/src/run/helper/expand_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "shellwords"
 
 module Run

data/src/run/helper/menu_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "tty-prompt"
 
 module Run

data/src/run/helper/pause_helper.rb

@@ -1,10 +1,22 @@
+# frozen_string_literal: true
+
 module Run
   module Helper
     class PauseHelper
+      DEFAULT_TEXT = "Press enter to continue"
+
+      # @param text [String]
+      def initialize(text = DEFAULT_TEXT)
+        raise ArgumentError.new("'text' must be a String") if !text.is_a?(String)
+
+        @text = text
+      end
+
       # @return [void]
       def run
+        print "#{@text}..."
         STDIN.gets("\n")
       end
     end
   end
-end
+end

data/src/run/helper/question_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "tty-prompt"
 
 module Run

data/src/run/helper/wait_for_interruption_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Run
   module Helper
     class WaitForInterruptionHelper

data/src/run/task/block_task.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Run
   module Task
     class BlockTask

data/src/run/task/system_task.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Run
   module Task
     class SystemTask
@@ -6,10 +8,8 @@ module Run
         @command = command
       end
 
-      # @param arguments [Array] (unused)
-      # @param options [Hash] (unused)
       # @return [void]
-      def run(*arguments, **options)
+      def run
         puts ">".bright_blue + " #{@command}".bright_white
         puts
 

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: run_tasks
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Aurélien Delogu
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-05 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tty-prompt
@@ -24,7 +23,48 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.23.1
-description:
+- !ruby/object:Gem::Dependency
+  name: rb_monkey
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: rb_gemspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: rb_markdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
 email: aurelien.delogu@gmail.com
 executables:
 - run
@@ -32,23 +72,19 @@ extensions: []
 extra_rdoc_files: []
 files:
 - bin/run
+- completions/_run
 - src/bootstrap.rb
-- src/gemspec/metadata.rb
-- src/markdown/abstract_tag.rb
-- src/markdown/bold_tag.rb
-- src/markdown/code_tag.rb
-- src/markdown/engine.rb
-- src/markdown/italic_tag.rb
-- src/monkey/string.rb
 - src/run/core.rb
 - src/run/core/help.rb
-- src/run/core/verify_run_version.rb
 - src/run/error/aborted.rb
 - src/run/error/existing_task.rb
 - src/run/error/non_existing_runfile.rb
+- src/run/error/non_existing_task.rb
 - src/run/error/reserved_task_name.rb
+- src/run/error/runfile_version_mismatch.rb
 - src/run/error/unknown_task.rb
 - src/run/helper/are_you_sure_helper.rb
+- src/run/helper/bind_helper.rb
 - src/run/helper/catch_interruption_helper.rb
 - src/run/helper/expand_helper.rb
 - src/run/helper/menu_helper.rb
@@ -57,15 +93,10 @@ files:
 - src/run/helper/wait_for_interruption_helper.rb
 - src/run/task/block_task.rb
 - src/run/task/system_task.rb
-- src/version/local_gemspec_version.rb
-- src/version/remote_gemspec_version.rb
-- src/version/semver.rb
-- src/version/unreachable_error.rb
 homepage: https://github.com/pyrsmk/run
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -80,9 +111,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project:
-rubygems_version: 2.6.14.4
-signing_key:
+rubygems_version: 4.0.11
 specification_version: 4
-summary: Easy project management for the masses
+summary: Task runner for the masses
 test_files: []

data/src/gemspec/metadata.rb

@@ -1,23 +0,0 @@
-module Gemspec
-  class Metadata
-    # @param lib_name [String]
-    def initialize(lib_name)
-      @lib_name = lib_name
-    end
-
-    # @return [Hash]
-    def read
-      @_read ||= (
-        path = "#{__dir__}/../../#{@lib_name}.gemspec"
-
-        # Development.
-        if File.exist?(path)
-          Gem::Specification::load(path)
-        # Production.
-        else
-          Gem::Specification::find_by_name(@lib_name) rescue nil
-        end
-      )
-    end
-  end
-end

data/src/markdown/abstract_tag.rb

@@ -1,47 +0,0 @@
-module Markdown
-  module AbstractTag
-    def initialize(value)
-      case value
-      when String
-        @string = value
-      when AbstractTag
-        @tag = value
-      else
-        raise ArgumentError.new("Invalid value of '#{value.class.name}' class")
-      end
-    end
-
-    def to_ansi
-      string = @string || @tag.to_ansi
-      pattern = Regexp.new(
-        "(^|.+?)" \
-        "(?:#{tokens.map{ |token| "\\" + token.chars.join("\\") }.join('|')})" \
-        "(.+?)" \
-        "(?:#{tokens.map{ |token| "\\" + token.chars.join("\\") }.join('|')})" \
-        "($|.+)"
-      )
-
-      loop do
-        string = string.sub(pattern) do
-          Regexp.last_match[1] + convert(Regexp.last_match[2]) + Regexp.last_match[3]
-        end
-        break if !Regexp.last_match
-      end
-
-      string
-    end
-
-    protected
-
-    # @return [Array<String>]
-    def tokens
-      raise NotImplementedError.new
-    end
-
-    # @param string [String]
-    # @return [String]
-    def convert(string)
-      raise NotImplementedError.new
-    end
-  end
-end

data/src/markdown/bold_tag.rb

@@ -1,20 +0,0 @@
-require_relative "./abstract_tag"
-
-module Markdown
-  class BoldTag
-    include AbstractTag
-
-    protected
-
-    # @return [Array<String>]
-    def tokens
-      ["**", "__"]
-    end
-
-    # @param string [String]
-    # @return [String]
-    def convert(string)
-      string.bold
-    end
-  end
-end

data/src/markdown/code_tag.rb

@@ -1,20 +0,0 @@
-require_relative "./abstract_tag"
-
-module Markdown
-  class CodeTag
-    include AbstractTag
-
-    protected
-
-    # @return [Array<String>]
-    def tokens
-      ["`"]
-    end
-
-    # @param string [String]
-    # @return [String]
-    def convert(string)
-      string.cyan
-    end
-  end
-end

data/src/markdown/engine.rb

@@ -1,17 +0,0 @@
-require_relative "./bold_tag"
-require_relative "./code_tag"
-require_relative "./italic_tag"
-
-module Markdown
-  class Engine
-    def initialize(string)
-      @string = string
-    end
-
-    def to_ansi
-      # The tags are ordered by priority.
-      # For example: `Bold` should run before `Italic`.
-      CodeTag.new(ItalicTag.new(BoldTag.new(@string))).to_ansi
-    end
-  end
-end

data/src/markdown/italic_tag.rb

@@ -1,20 +0,0 @@
-require_relative "./abstract_tag"
-
-module Markdown
-  class ItalicTag
-    include AbstractTag
-
-    protected
-
-    # @return [Array<String>]
-    def tokens
-      ["*", "_"]
-    end
-
-    # @param string [String]
-    # @return [String]
-    def convert(string)
-      string.italic
-    end
-  end
-end

data/src/monkey/string.rb

@@ -1,55 +0,0 @@
-# https://gist.github.com/fnky/458719343aabd01cfb17a3a4f7296797
-class String
-  @@styles = {
-    :bold              => "1",
-    :dim               => "2",
-    :italic            => "3",
-    :underline         => "4",
-    :inverse           => "7",
-    :strikethrough     => "9",
-    :fg_black          => "30",
-    :fg_red            => "31",
-    :fg_green          => "32",
-    :fg_yellow         => "33",
-    :fg_blue           => "34",
-    :fg_magenta        => "35",
-    :fg_cyan           => "36",
-    :fg_white          => "37",
-    :fg_bright_black   => "30;1",
-    :fg_bright_red     => "31;1",
-    :fg_bright_green   => "32;1",
-    :fg_bright_yellow  => "33;1",
-    :fg_bright_blue    => "34;1",
-    :fg_bright_magenta => "35;1",
-    :fg_bright_cyan    => "36;1",
-    :fg_bright_white   => "37;1",
-  }
-
-  # To be able to handle more styles (with method chaining) we should refactor this.
-  def stylize(style)
-    "\033[#{@@styles[style.to_sym]}m#{self}\033[0m"
-  end
-
-  def bold;              stylize(:bold); end
-  def dim;               stylize(:dim); end
-  def italic;            stylize(:italic); end
-  def underline;         stylize(:underline); end
-  def inverse;           stylize(:inverse); end
-  def strikethrough;     stylize(:strikethrough); end
-  def black;             stylize(:fg_black); end
-  def red;               stylize(:fg_red); end
-  def green;             stylize(:fg_green); end
-  def yellow;            stylize(:fg_yellow); end
-  def blue;              stylize(:fg_blue); end
-  def magenta;           stylize(:fg_magenta); end
-  def cyan;              stylize(:fg_cyan); end
-  def white;             stylize(:fg_white); end
-  def bright_black;      stylize(:fg_bright_black); end
-  def bright_red;        stylize(:fg_bright_red); end
-  def bright_green;      stylize(:fg_bright_green); end
-  def bright_yellow;     stylize(:fg_bright_yellow); end
-  def bright_blue;       stylize(:fg_bright_blue); end
-  def bright_magenta;    stylize(:fg_bright_magenta); end
-  def bright_cyan;       stylize(:fg_bright_cyan); end
-  def bright_white;      stylize(:fg_bright_white); end
-end

data/src/run/core/verify_run_version.rb

@@ -1,23 +0,0 @@
-module Run
-  module Core
-    module VerifyRunVersion
-      REMOTE_GEMSPEC_URL = "https://raw.githubusercontent.com/pyrsmk/run/master/run_tasks.gemspec"
-
-      # @return [void]
-      def self.run
-        local_version = Version::Semver.new(
-          Version::LocalGemspecVersion.new(Gemspec::Metadata.new("run_tasks")).extract
-        )
-        remote_version = Version::Semver.new(
-          Version::RemoteGemspecVersion.new(REMOTE_GEMSPEC_URL).extract
-        )
-        if local_version.major == remote_version.major && local_version < remote_version
-          puts
-          puts " A new version of Run is available: #{remote_version.major}.#{remote_version.minor}.#{remote_version.patch}".bright_yellow
-          puts " Please update with: `gem update run_tasks`".bright_yellow
-        end
-      rescue Version::UnreachableError
-      end
-    end
-  end
-end

data/src/version/local_gemspec_version.rb

@@ -1,13 +0,0 @@
-module Version
-  class LocalGemspecVersion
-    # @param gemspec [Gemspec::Metadata]
-    def initialize(gemspec)
-      @gemspec = gemspec
-    end
-
-    # @return [String]
-    def extract
-      @gemspec.read.version.to_s
-    end
-  end
-end

data/src/version/remote_gemspec_version.rb

@@ -1,23 +0,0 @@
-require "open-uri"
-require "socket"
-
-module Version
-  class RemoteGemspecVersion
-    # @param url [String]
-    def initialize(url)
-      @url = url
-    end
-
-    # @return [String]
-    def extract
-      # `mode` and `perm` options are not used, but we need to set them in order to set
-      # options...
-      contents = URI.parse(@url).open("r", 0666, open_timeout: 1, read_timeout: 1).read
-      matches = /^\s*s.version\s*=\s*"(.+?)"\s*$/.match(contents)
-      raise UnreachableError.new if matches.nil?
-      matches[1]
-    rescue SocketError
-      raise UnreachableError.new
-    end
-  end
-end

data/src/version/semver.rb

@@ -1,62 +0,0 @@
-module Version
-  class Semver
-    # @return [String]
-    def initialize(version)
-      match = /^(\d+)\.(\d+)\.(\d+)$/.match(version)
-      raise ArgumentError.new("Invalid SEMVER number") if match.nil?
-
-      @major = match[1].to_i
-      @minor = match[2].to_i
-      @patch = match[3].to_i
-    end
-
-    # @return [Integer]
-    def major
-      @major
-    end
-
-    # @return [Integer]
-    def minor
-      @minor
-    end
-
-    # @return [Integer]
-    def patch
-      @patch
-    end
-
-    # @return [Boolean]
-    def <(semver)
-      is_a_semver?(semver)
-
-      @major < semver.major ||
-      (@major == semver.major && @minor < semver.minor) ||
-      (@major == semver.major && @minor == semver.minor && @patch < semver.patch)
-    end
-
-    # @return [Boolean]
-    def >(semver)
-      is_a_semver?(semver)
-
-      @major > semver.major ||
-      (@major == semver.major && @minor > semver.minor) ||
-      (@major == semver.major && @minor == semver.minor && @patch > semver.patch)
-    end
-
-    # @return [Boolean]
-    def ==(semver)
-      is_a_semver?(semver)
-
-      @major == semver.major && @minor == semver.minor && @patch == semver.patch
-    end
-
-    private
-
-    # @return [Boolean]
-    def is_a_semver?(semver)
-      if !semver.respond_to?(:major) || !semver.respond_to?(:minor) || !semver.respond_to?(:patch)
-        raise ArgumentError.new("SemVer compatible object expected")
-      end
-    end
-  end
-end

data/src/version/unreachable_error.rb

@@ -1,4 +0,0 @@
-module Version
-  class UnreachableError < StandardError
-  end
-end