run_tasks 1.6.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9fa8127bba38224f6ba4c779edae6b71f8f54a00
-  data.tar.gz: f279a93debf06b7085b0d95358e7f9f1fcb34780
+  metadata.gz: 4d28b64a797694474cb625f1359e5ba0cf58316c
+  data.tar.gz: a5de99dc39b841f4a215818410803a777b558dea
 SHA512:
-  metadata.gz: 86273c44aac9a5d1b447f75f5d606dcd0e14ca365455748adcf7b27a522953b0986fbfa68e768c2cd0d3b7f93f8a2d44bc6736bc1fd29933b0d317d4486870c0
-  data.tar.gz: f8638842342a3a39744d2ff6f24b6007138d97c9ce28929fabb47754fd2bd9124619209d370614e5e7d6770f28346b80c4bcc2f69d8e532176f859fbc5c32194
+  metadata.gz: 31fa21481a39c615caa2663f9673717250a2b0ba12c52998d73ea6cbeaf69d4e1797fc0173c765f78aa0df46fbd1f7d6f6ad9d807eb2aa25c5f3b3663fd88cb8
+  data.tar.gz: 585078fa341b255f561951ed5ed9056d73c2d2e79c27d3c6a9b9bf6583facecb7f3184ed6d82799db9491d6381cb324a4996b1b8cabac9db562ad73b9535e6c7

data/src/run.rb

@@ -33,24 +33,30 @@ HOMEPAGE = GEM&.homepage
 def task(name, help = nil, &block)
   if !name.is_a?(Symbol)
     puts
-    puts "First task parameter must be a symbol".red
+    puts "'name' parameter must be a symbol".red
     exit 6
   end
-  if !help.nil? && !help.is_a?(String)
-    puts
-    puts "Second task parameter must be a string".red
-    exit 6
-  end
-  if help.nil?
+  if !help.nil?
+    if !help.is_a?(String)
+      puts
+      puts "'help' parameter must be a string".red
+      exit 6
+    end
+  else
+    # Load comments directly above the task as help verbatim.
     caller = caller_locations[0]
-    line = File.readlines(caller.absolute_path)[caller.lineno - 2]
-    match = /^\s*#\s*(?<comment>.+?)\s*$/.match(line)
-    help = match[:comment] if !match.nil?
+    lines = File.readlines(caller.absolute_path)
+    help = (0..(caller.lineno - 2)).to_a.reverse.reduce([]) do |comments, lineno|
+      match = /^\s*#\s*(?<comment>.+?)\s*$/.match(lines[lineno])
+      break comments if match.nil?
+      comments << match[:comment]
+      comments
+    end.reverse
   end
   @tasks.store(
     name,
     {
-      :help => help.nil? ? "" : Markdown::Engine.new(help).to_ansi,
+      :help => help.is_a?(String) ? [help] : help,
       :block => block
     }
   )
@@ -92,6 +98,34 @@ def are_you_sure?(text = "Are you sure?")
   exit 9 unless answer == "y"
 end
 
+def menu(text, choices)
+  labels = nil
+  values = nil
+  choice = nil
+
+  if choices.is_a?(Array)
+    labels = choices
+    values = choices
+  elsif choices.is_a?(Hash)
+    labels = choices.keys
+    values = choices.values
+  else
+    puts "menu() 'choices' parameter must be an Array or an Hash".red
+    exit 10
+  end
+
+  loop do
+    labels.each_with_index do |label, index|
+      puts "#{index + 1}. #{label}"
+    end
+    puts text
+    choice = STDIN.gets.chomp.to_i
+    break if !values[choice - 1].nil?
+  end
+
+  values[choice - 1]
+end
+
 # @param uri [String]
 def require_remote(uri)
   cache_path = "/tmp/run_cache_#{Digest::MD5.hexdigest(uri)}"
@@ -149,7 +183,18 @@ if ARGV.size == 0 || (ARGV.size == 1 && ARGV[0] == "help")
   end
   # Display each task and their help.
   @tasks.sort.to_h.each do |name, task|
-    puts " #{name}".yellow + (" " * (max_size - name.size + 4)) + task[:help]
+    if task[:help].size == 0
+      puts " #{name}".yellow
+      next
+    end
+    task[:help].each_with_index do |help, index|
+      help = Markdown::Engine.new(help).to_ansi
+      if index == 0
+        puts " #{name}".yellow + (" " * (max_size - name.size + 4)) + help
+        next
+      end
+      puts (" " * (max_size + 5)) + help
+    end
   end
   exit
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: run_tasks
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Aurélien Delogu
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-07-27 00:00:00.000000000 Z
+date: 2023-07-28 00:00:00.000000000 Z
 dependencies: []
 description:
 email: aurelien.delogu@gmail.com