cli_class_tool 0.5.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 79f28a830c3277c28e747b142fb6a12d40c8a69e5b868c4fef7f58e296f79dce
-  data.tar.gz: ca5b3535463ee163b56c2cdda397dd925111ea325d6695268c78acf5091b19cc
+  metadata.gz: 645eabaadb2f9f7b6497f524dc2e847bbe6fa2b3bd0085449e7a5c6e49e6d943
+  data.tar.gz: 94cb2bfe852dce7a0f1a55a7888a813e4beea307f0a41c056c69d26f0914e4e7
 SHA512:
-  metadata.gz: 467252b31976d4fcb70cc795dc5ceaa06d2ad24576cd75a8b5ffaef3c3d5ef93f945da0f45414dfa40a80aeb7e3f5f882308ac8e48f5b2d4629267a6254eb078
-  data.tar.gz: 8abc7831b9c862d928ca3632a7b9d9f99e289b5058af2fe7c095cec6845a617de7d6111f8357f879b95c79711733ede70a93e86127abaa65e3e43e0861605bb9
+  metadata.gz: 576fc426eedf2ed6578dce762fae533432cee75c1dce31d31ebf1c44b2b6c82b0a6418d74670fb5b6a6812b278c0444cc8295adb79d5fa2be4507cbbc9136d16
+  data.tar.gz: 4c6544ef6d4eecb54d5f2e7de75106e33936523d3e2bcea82ad729e0a388d9e33b193727b67637ef9901f29c23fccfa5ee9caed484043c4b2e7e8f60da7ca7db

data/CHANGELOG

@@ -1,3 +1,15 @@
+------------------
+1.1.0  (2026-09-09)
+------------------
+
+* Extend String class with support for all 16 standard/high-intensity ANSI colors and a chainable `.bold` method that merges ANSI escape sequences
+
+------------------
+1.0.0  (2026-09-09)
+------------------
+
+* Switch confirm to optional hash-style arguments (:ignored_default, :allowed_reps, :usage), dropping legacy positional arguments
+
 ------------------
 0.5.1  (2026-09-07)
 ------------------

data/README.md

@@ -179,6 +179,34 @@ By inheriting from `CLIClassTool::Common`, your action classes have access to a
 
 ---
 
+## User Confirmation (`confirm`)
+
+`CLIClassTool::Common` provides an inherited `confirm(opts, msg, confirm_opts = {})` helper method to prompt the user for interactive confirmation or automatically reply when `-y`/`--yes` or `-n`/`--no` CLI flags are set.
+
+```ruby
+# Basic confirmation
+confirm(opts, "delete this branch")
+# => Do you wish to delete this branch ? (y/n):
+
+# Custom usage string printed in the prompt
+confirm(opts, "apply changes", usage: "y/N")
+# => Do you wish to apply changes ? (y/N):
+
+# Custom allowed responses and custom usage
+confirm(opts, "select conflict resolution", allowed_reps: ["y", "n", "a"], usage: "y/n/all")
+# => Do you wish to select conflict resolution ? (y/n/all):
+
+# Ignore CLI -y/--yes and -n/--no options to force interactive input
+confirm(opts, "format the disk", ignored_default: true)
+```
+
+### Supported Options:
+- `:usage` (`String` or `Array<String>`): Custom usage string to display instead of `#{allowed_reps.join("/")}`.
+- `:ignored_default` / `:ignore_default` (`Boolean`, default: `false`): If `true`, ignores `opts[:yn_default]` set by `--yes` or `--no`.
+- `:allowed_reps` (`Array<String>`, default: `["y", "n"]`): List of acceptable user responses.
+
+---
+
 ## Dynamic Class Overrides (Addons)
 
 `CLIClassTool` natively supports dynamic class overrides (addons). This allows projects to load repository-specific or custom subclasses that extend or override base action behaviors without modifying the core codebase.
@@ -393,4 +421,28 @@ rescue MyProjectError => e
 end
 ```
 
+---
+
+## String Colorization & Styling Extension
+
+`CLIClassTool` extends the core Ruby `String` class with standard ANSI escape sequence methods for terminal colorization and formatting.
+
+### 16-Color Palette Support
+
+The following color methods are available on any string:
+
+* **Standard Colors**: `.black`, `.red`, `.green`, `.brown` (alias `.yellow`), `.blue`, `.magenta`, `.cyan`, `.white`
+* **High-Intensity / Bright Colors**: `.gray` (alias `.grey`), `.light_red`, `.light_green`, `.light_yellow`, `.light_blue`, `.light_magenta`, `.light_cyan`, `.light_white`
+
+### Bold Mode and Method Chaining
+
+You can style text as bold using the `.bold` method. All methods support seamless chaining/merging, meaning ANSI escape sequences are parsed and merged into a single escape code (e.g., `\e[1;31m`) rather than nested redundantly.
+
+```ruby
+puts "Success!".green            # Green text
+puts "Warning!".brown.bold       # Bold brown (yellow) text
+puts "Fatal Error!".bold.red     # Bold red text
+puts "System Message".bold       # Bold text using default terminal color
 ```
+
+These methods automatically check if `$stdout` is a TTY and safely fall back to standard, unformatted strings if output is piped or redirected (non-TTY mode).

data/lib/cli_class_tool/common.rb

@@ -77,14 +77,29 @@ module CLIClassTool
         #
         # @param opts [Hash] Options hash
         # @param msg [String] Confirmation message
-        # @param ignore_default [Boolean] Ignore default yes/no options
-        # @param allowed_reps [Array<String>] Allowed responses
+        # @param confirm_opts [Hash] Optional confirmation options
+        # @option confirm_opts [Boolean] :ignored_default (false) Ignore default yes/no options
+        # @option confirm_opts [Boolean] :ignore_default (false) Alias for :ignored_default
+        # @option confirm_opts [Array<String>] :allowed_reps (["y", "n"]) Allowed responses
+        # @option confirm_opts [String, Array<String>] :usage Custom usage string or list to display instead of allowed_reps.join("/")
         # @return [String] User response
-        def confirm(opts, msg, ignore_default=false, allowed_reps=[ "y", "n" ])
-            rep = 't'
+        def confirm(opts, msg, confirm_opts = {})
+            raise ArgumentError, "confirm options must be a Hash" unless confirm_opts.is_a?(Hash)
+
+            conf_opts = confirm_opts.transform_keys(&:to_sym)
+
+            ignored_default = conf_opts[:ignored_default]
+            ignored_default = conf_opts[:ignore_default] if ignored_default.nil?
+            ignored_default = false if ignored_default.nil?
+
+            allowed_reps = (conf_opts[:allowed_reps] || [ "y", "n" ]).map(&:to_s)
+            usage = conf_opts[:usage]
+            usage_str = usage ? (usage.is_a?(Array) ? usage.join("/") : usage.to_s) : allowed_reps.join("/")
+
+            rep = nil
             while allowed_reps.index(rep) == nil && rep != '' do
-                puts "Do you wish to #{msg} ? (#{allowed_reps.join("/")}): "
-                case (ignore_default == true ? nil : opts[:yn_default])
+                puts "Do you wish to #{msg} ? (#{usage_str}): "
+                case (ignored_default == true ? nil : opts&.[](:yn_default))
                 when :no
                     puts "Auto-replying no due to --no option"
                     rep = 'n'

data/lib/cli_class_tool/string.rb

@@ -10,12 +10,33 @@ class String
     def colorize(color_code)
         @@is_a_tty = $stdout.isatty() if @@is_a_tty == nil
         if @@is_a_tty then
-            return "\e[#{color_code}m#{self}\e[0m"
+            if self =~ /\A\e\[([\d;]+)m(.*)\e\[0m\z/
+                codes = $1.split(';')
+                content = $2
+                new_codes = codes.dup
+                if color_code.to_i == 1
+                    new_codes.unshift("1") unless new_codes.include?("1")
+                else
+                    new_codes.reject! { |c| (30..37).include?(c.to_i) || (90..97).include?(c.to_i) }
+                    new_codes << color_code.to_s
+                end
+                new_codes.uniq!
+                new_codes.sort_by! { |c| c.to_i }
+                return "\e[#{new_codes.join(';')}m#{content}\e[0m"
+            else
+                return "\e[#{color_code}m#{self}\e[0m"
+            end
         else
             return self
         end
     end
 
+    # Make the string black
+    # @return [String] Black string
+    def black
+        colorize(30)
+    end
+
     # Make the string red
     # @return [String] Red string
     def red
@@ -34,6 +55,12 @@ class String
         colorize(33)
     end
 
+    # Make the string yellow
+    # @return [String] Yellow string
+    def yellow
+        colorize(33)
+    end
+
     # Make the string blue
     # @return [String] Blue string
     def blue
@@ -45,4 +72,71 @@ class String
     def magenta
         colorize(35)
     end
+
+    # Make the string cyan
+    # @return [String] Cyan string
+    def cyan
+        colorize(36)
+    end
+
+    # Make the string white
+    # @return [String] White string
+    def white
+        colorize(37)
+    end
+
+    # Make the string bold
+    # @return [String] Bold string
+    def bold
+        colorize(1)
+    end
+
+    # Make the string gray/grey / light black
+    # @return [String] Gray string
+    def gray
+        colorize(90)
+    end
+    alias grey gray
+
+    # Make the string light red
+    # @return [String] Light red string
+    def light_red
+        colorize(91)
+    end
+
+    # Make the string light green
+    # @return [String] Light green string
+    def light_green
+        colorize(92)
+    end
+
+    # Make the string light yellow
+    # @return [String] Light yellow string
+    def light_yellow
+        colorize(93)
+    end
+
+    # Make the string light blue
+    # @return [String] Light blue string
+    def light_blue
+        colorize(94)
+    end
+
+    # Make the string light magenta
+    # @return [String] Light magenta string
+    def light_magenta
+        colorize(95)
+    end
+
+    # Make the string light cyan
+    # @return [String] Light cyan string
+    def light_cyan
+        colorize(96)
+    end
+
+    # Make the string light white
+    # @return [String] Light white string
+    def light_white
+        colorize(97)
+    end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: cli_class_tool
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Nicolas Morey
 bindir: bin
 cert_chain: []
-date: 2026-09-07 00:00:00.000000000 Z
+date: 2026-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake