run_tasks 3.2.9 → 3.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 02cf0f24a6770fba830aeace49f54bc134c3ba3d20faa2c14a478fa3f969b397
-  data.tar.gz: 95d67affde3641d9f7e1f58dcfb2fa6603d6a8d493ef842dedce3b1a2e2b262e
+  metadata.gz: db5998bcac4e11397fd0abb44484d48dc78ce538cd31a5768ddadf4f23a3a6ae
+  data.tar.gz: 8fc911ccdf1f057f3fb8c310185fdd3021eb293710b05b5cc0ce4bf16bd98c6c
 SHA512:
-  metadata.gz: 4e832f77837870e241d085d57ea19172272250ff1126a0fc493b0c88e2f06dca7c1c6a32e1c2be454c876b2ef4e6e3d03d471c11af0df7f21ae22a31ce1f4189
-  data.tar.gz: 360de4f489ffe5c3d9583eb87b266b8840439b2fe02e6f0a6a74e63addd6fd8be17f46aed0248af7c29091aa039eda8fd5f5f1100f8347ad0a2c6ceec56d27db
+  metadata.gz: 5387ed714265c8705665e5012d1186fc148c87e85d5a6441e66edabc02515eb58c62c03ba71d4451b647d2a5c02f0fbc7ac46a1d8c414734eb2803eb39222559
+  data.tar.gz: 42ace3eb70928ae2d509cbfa8b26f3696ba55f6cf2a797280957c98e0b7704cafefce72d2e375cc570360b896cc9d1905947d0bd8e8ec8892f7f5297e4067d66

data/CHEATSHEET.md

@@ -163,6 +163,26 @@ task :age do
 end
 ```
 
+```rb
+task :age do
+  age = question "What is your age?", /^\d+$/, default: "30"
+end
+```
+
+## yesno
+
+```rb
+task :deploy do
+  run :migrate if yesno "Run migrations?"
+end
+```
+
+```rb
+task :deploy do
+  run :migrate if yesno "Run migrations?", default: true
+end
+```
+
 ## wait_for_interruption
 
 ```rb

data/src/run/helper/question_helper.rb

@@ -7,17 +7,23 @@ module Run
     class QuestionHelper
       # @param question [String]
       # @param regex [Regexp, Nil]
-      def initialize(question, regex = nil)
+      # @param default [String, Nil]
+      def initialize(question, regex = nil, default: nil)
         raise ArgumentError.new("'question' must be a String") if !question.is_a?(String)
+        raise ArgumentError.new("'default' must be a String") if !default.nil? && !default.is_a?(String)
 
         @question = question
         @regex = regex
+        @default = default
       end
 
       # @return [any]
       def run
         TTY::Prompt.new.ask(@question) do |config|
           config.required true
+          if @default
+            config.default @default
+          end
           if @regex
             config.validate @regex
           end

data/src/run/helper/yesno_helper.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "tty-prompt"
+
+module Run
+  module Helper
+    class YesnoHelper
+      VALIDATION = /\A(y(es)?|no?)?\z/i
+
+      # @param question [String]
+      # @param default [Boolean, Nil]
+      def initialize(question, default: nil)
+        raise ArgumentError.new("'question' must be a String") if !question.is_a?(String)
+        raise ArgumentError.new("'default' must be a Boolean") if ![nil, true, false].include?(default)
+
+        @question = question
+        @default = default
+      end
+
+      # @return [Boolean]
+      def run
+        answer = TTY::Prompt.new.ask("#{@question} #{suffix}") do |config|
+          config.required @default.nil?
+          config.validate VALIDATION, "Please answer 'y' or 'n'."
+        end
+        return @default if answer.nil?
+
+        answer.downcase.start_with?("y")
+      end
+
+      private
+
+      # @return [String]
+      def suffix
+        case @default
+        when true then "[Yn]"
+        when false then "[yN]"
+        else "[yn]"
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: run_tasks
 version: !ruby/object:Gem::Version
-  version: 3.2.9
+  version: 3.3.0
 platform: ruby
 authors:
 - Aurélien Delogu
@@ -93,6 +93,7 @@ files:
 - src/run/helper/pause_helper.rb
 - src/run/helper/question_helper.rb
 - src/run/helper/wait_for_interruption_helper.rb
+- src/run/helper/yesno_helper.rb
 - src/run/task/block_task.rb
 - src/run/task/system_task.rb
 homepage: https://github.com/pyrsmk/run