squared 0.5.11 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56af2850e96c00e48e1511b20fc61c5f0d9969220b4b070a6c61c02ce6489e97
-  data.tar.gz: 83749c3414fa0496dfa64fb3ec0846af2205b1c4483ecbd44e72ed2d976c7852
+  metadata.gz: ed078210213186745643650b4a73f7f376b5aba7033643c850b48d555c198501
+  data.tar.gz: d4d8c0e6308f3bdc3aca66891980259ad52ce11f3a53112c7a22ae4de9e31f40
 SHA512:
-  metadata.gz: 4fbc69f9efe06c1d2ceba44c58854ca31b0a7e50a6fe89c01e3aeff05830efae2f7bf07f068163352f6c54f9d347a5db11b308a8f0b3f3b64914ac6b0035743b
-  data.tar.gz: 7aada08d98786700e652f0a78e5ddeda72ada420ec9d89cffc937f706b27da4800374231d086b67be8ae748199d0229a02fb95a9dfaac349fff6c40997ab5099
+  metadata.gz: fcf308f894ee49566103575561b74459afc1aa7e03af8d5c5397c7bb7432dfce996cbb1291f4f81af792d5b1dd8ed6a9075ce7b2fab6f41dca0c56431e38b78c
+  data.tar.gz: 19f25542363b33fa567cbfcb0267c79fbc55a313ce0fba8ab25ec17dd43f276b004b00304e8bfe38dba1338a2e554170a8f1535d1bdc5981407fae6e9bff2bf8

data/CHANGELOG.md

@@ -1,5 +1,129 @@
 # Changelog
 
+## [0.6.0] - 2025-10-31
+
+### Added
+
+- Docker command compose action create was implemented.
+- Docker command compose action ps was implemented.
+- Docker command compose action ps is interactive.
+- Project base asdf commands [latest|where|update] were implemented.
+- Pip command options were updated to 25.2.
+- Command line programs who do not assign with equals are supported.
+- Docker command ls with column formatting was implemented.
+- Git command stash action staged and worktree were implemented.
+- Git command diff action files can output to a patch file.
+- Repo task init with REPO_Y can auto-accept overwrite confirmation.
+- Caller locations for errors can be excluded using ARG[:BACKTRACE].
+- Node command package action reinstall was implemented.
+- Node class method and command tsc was implemented.
+- Python command pip action reinstall was implemented.
+- Project command options can be stored by class ref and project name.
+- Bundler command config is interactive.
+- Ruby method bundle supports stored command options.
+- Ruby method rake supports stored command options.
+- Ruby method ruby supports stored command options.
+- Ruby method gem supports stored command options.
+- Python method pip supports stored command options.
+- Python command pip action wheel was implemented.
+- Ruby method irb supports stored command options.
+- Ruby command gem action command was implemented.
+- ENV supplementary command options can be space delimited.
+- Project command options can extend other stored options.
+- Ruby command gem action outdated can update without being interactive.
+- Ruby command gem action update system can accept a specific version.
+- Ruby command gem action outdated supports threading.
+- Git command grep was implemented.
+- Common format bright colors fallback to standard colors when not enabled.
+- Project base command unpack action gz was implemented.
+- Common format defined String instance method subhint.
+- Application readers [exception|pipe|verbose|warning] were converted into accessors.
+- Node private projects can publish entire workspace with tags.
+- Node command outdated can select a range of packages to update.
+- Gem command outdated can select a range of packages to update.
+- Python command outdated can select a range of packages to update.
+- Node command outdated option diff was implemented.
+- Bundler command outdated can select a range of packages to update.
+- Common prompt method choice can select all items with "\*".
+- Node command bump can auto-commit package.json using GIT_MESSAGE.
+- Git command options were updated to version 2.51.
+
+### Changed
+
+- Git method source will raise error when checking exit status.
+- Date gem is no longer globally required.
+- Global task git:all was removed.
+- Common base method as_a was relocated to Utils.
+- Python command build and publish detects only one backend.
+- Docker command compose action ps was renamed service.
+- Docker command image action list was renamed ls.
+- Project base method success? conditionally calls print_success method.
+- Error classes were not specified for invalid operation.
+- Common format methods stripstyle and stripext are String instance methods.
+- Common format method alias puts_oe was removed.
+- Git commands without a valid action will exit with error status.
+- Errno exceptions are used in place of SystemCallError.
+- Common format method raise_error defaults to RuntimeError.
+- OptionPartition delegator method delete_at was renamed remove_at.
+- Node event name "publish" was renamed to "npm:publish".
+- Project task run with a Method passes self as first argument.
+- Ruby command check was removed.
+- Ruby method gem! was renamed gem.
+- Ruby methods ruby and irb first argument was converted into kwargs.
+- Ruby method rake executes all tasks in one run command.
+- Ruby project file methods return nil instead of false.
+- Ruby commands [exec|cache|config] were relocated under bundle namespace.
+- Ruby command gem action update without arguments is not modified.
+- Ruby command install was replaced with reinstall under bundle namespace.
+- Ruby command update was relocated under bundle namespace.
+- Common prompt confirm timeout was revised for non-immediate responses.
+- Project relative paths are stripped from banner when context is displayed.
+- Workspace module Support extend submodules private methods.
+- Workspace method add passes parent through Project constructor.
+- Project base method run_s uses last argument for ENV hash.
+- Project base method inject does not exit program when raised.
+- Reline gem is installed only when using at least Ruby 3.0.
+- Python method install arguments strategy and user were removed.
+- Project command outdated does not support threading when interactive.
+- Project base accessor global was converted into a reader and setter.
+- Repo build can simultaneously use script and run through REPO_BUILD.
+- Repo static method read_manifest was made an instance method named repo_manifest.
+
+### Fixed
+
+- Node task update did not check equivalent ENV install options.
+
+## [0.5.12] - 2025-10-31
+
+### Changed
+
+- Ruby task depend does not override bundle config without setting.
+
+### Fixed
+
+- Node command run did nothing at all when called upon.
+
+## [0.4.26] - 2025-10-31
+
+### Added
+
+- Docker command options were updated to 28.5.
+
+### Changed
+
+- Node package manager does not override package.json with NODE_INSTALL.
+- Node workspaces can specify more than one package manager through NODE_INSTALL.
+
+### Fixed
+
+- Node command add did not provide optional save argument.
+- Python command outdated did not detect synchronous output.
+- Node command outdated auto-commit was completely dysfunctional.
+- Project workspaces caused a complete meltdown on TruffleRuby.
+- Project build initialization global flag was always incoherent.
+- Project base setters did not accept direct values.
+- Project base global graph tasks are not definable by a sub-project.
+
 ## [0.5.11] - 2025-10-18
 
 ### Fixed
@@ -1153,6 +1277,8 @@
 
 - Changelog was created.
 
+[0.6.0]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.0
+[0.5.12]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.12
 [0.5.11]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.11
 [0.5.10]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.10
 [0.5.9]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.9
@@ -1165,6 +1291,7 @@
 [0.5.2]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.2-ruby
 [0.5.1]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.1-ruby
 [0.5.0]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.0-ruby
+[0.4.26]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.26
 [0.4.25]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.25
 [0.4.24]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.24
 [0.4.23]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.23

data/README.md

@@ -1,4 +1,4 @@
-# squared 0.5
+# squared 0.6
 
 * [source](https://github.com/anpham6/squared-ruby)
 * [docs](https://squared.readthedocs.io)
@@ -14,6 +14,7 @@
 | 2025-06-16 |   0.5.0 |  2.5.0 |  3.4.3 |
 | ---------- |   ----- |  ----- |  ----- |
 | 2025-08-23 |   0.5.5 |        |  3.4.5 |
+| 2025-10-31 |   0.6.0 |        |  3.4.7 |
 
 The range chart indicates the latest Ruby tested against at the time of release.
 
@@ -142,20 +143,59 @@ Workspace::Application
 # android   = /workspaces/android-docs
 # chrome    = /workspaces/chrome-docs
 
+# ...symbol?, string, ...string?, ...symbol?
+#    extend     name       args     project
+
+Node = Workspace::Project::Node                                      # tsc
+Node.options("build:dev", "target=es2022", project: "tsconfig.json") # :node (ref)
+Node.options("build:dev", "outDir=tmp", :squared)                    # squared (project name)
+
+Ruby = Workspace::Project::Ruby                                      # ruby | gem | rake | bundle | irb
+Ruby.options("lint", "rubocop", opts: ["gemfile=Gemfile"])           # :ruby
+Ruby.options("lint", "--parallel", :squared)
+
+Python = Workspace::Project::Python                                   # pip
+Python.options("build", opts: ["r=requirements.txt"])                 # :python
+Python.options(:build, "build:dev", opts: ["no-deps"])
+
 Workspace::Application
-  .new(ENV["SQUARED_HOME"], prefix: "rb", common: false) # Local styles
+  .new(ENV["SQUARED_HOME"], prefix: "rb", common: false)             # Local styles
   .group("ruby", "default", run: "rake build", copy: "rake install", clean: "rake clean", ref: :ruby, override: {
     pathname: {
-      run: "rake compile"                                # rake rb:pathname:build
+      run: "rake compile"                                            # rake rb:pathname:build
     }
   })
-  .with(:python, editable: false) do                     # ref=Symbol | group=String
-    banner([:name, ": ", :version], "path")              # chrome-docs: 0.1.0 | /workspaces/chrome-docs
-    doc("make html")                                     # rake rb:doc:python
-    run(false)                                           # rake rb:build:python (disabled)
-    exclude(%i[base git])                                # Project::Git.ref (superclass)
-    add("android-docs", "android")                       # rake rb:android:doc
-    add("chrome-docs", "chrome")                         # rake rb:chrome:doc
+  .add("squared") do
+    apply :run, proc {                                               # rake rb:squared:build
+      tsc(with: scriptname || "build:dev", verbose: true)            # Repo (global)
+      # OR
+      tsc("target=es2022", "outDir=tmp", project: "tsconfig.json")   # 1
+      tsc("clean=true", "./sqd/tsconfig.json", build: true)          # 2
+      run("npm run build:dev", { "RUBYOPT" => "-W2" }, from: :run)   # 3
+
+      # Parallel
+      [
+        Thread.new { tsc(sync: false) },
+        Thread.new { tsc(sync: false) },
+        Thread.new { run(sync: false) }
+      ]
+      .each(&:join)
+    }
+    apply :lint, proc {
+      bundle("exec", "-A --cache=true", with: "lint", verbose: true) # bundle exec --gemfile='/squared/Gemfile' rubocop --parallel -A --cache=true
+    }
+  end
+  .with(:python, editable: false) do                                 # ref=Symbol | group=String
+    banner([:name, ": ", :version], "path")                          # chrome-docs: 0.1.0 | /workspaces/chrome-docs
+    doc("make html")                                                 # rake rb:doc:python
+    run(false)                                                       # rake rb:build:python (disabled)
+    exclude(%i[base git])                                            # Project::Git.ref (superclass)
+    add("android-docs", "android")                                   # rake rb:android:doc
+    add("chrome-docs", "chrome") do                                  # rake rb:chrome:doc
+      apply :run, proc {
+        pip("wheel", with: "build:dev")                              # pip wheel -r '/chrome-docs/requirements.txt' --no-deps
+      }
+    end
   end
   .style("inline", "bold")
   .build
@@ -496,28 +536,28 @@ Non-task:
 
 Most project classes will inherit from `Git` which enables these tasks:
 
-| Task       | Git              | Command                                       |
-| :--------- | :--------------- | :-------------------------------------------- |
-| branch     | branch           | create track delete move copy list current    |
-| checkout   | checkout         | commit branch track detach path               |
-| commit     | commit           | add all amend amend-orig fixup                |
-| diff       | diff             | head branch files view between contain        |
-| fetch      | fetch            | origin remote all                             |
-| files      | ls-files         | cached modified deleted others                |
-| git        |                  | add blame clean mv revert rm status           |
-| log        | log              | view between contain                          |
-| merge      | merge            | commit no-commit send                         |
-| pull       | pull             | origin remote all                             |
-| rebase     | rebase           | branch onto send                              |
-| refs       | ls-remote --refs | heads tags remote                             |
-| reset      | reset            | commit index patch mode undo                  |
-| restore    | restore          | source staged worktree                        |
-| rev        | rev              | commit build output                           |
-| show       | show             | format oneline textconv                       |
-| stash      | stash            | push pop apply branch drop clear list all     |
-| submodule  | submodule        | status update branch url sync                 |
-| switch     | switch           | branch create detach                          |
-| tag        | tag              | add sign delete list                          |
+| Task       | Git              | Command                                                   |
+| :--------- | :--------------- | :-------------------------------------------------------- |
+| branch     | branch           | create track delete move copy list current                |
+| checkout   | checkout         | commit branch track detach path                           |
+| commit     | commit           | add all amend amend-orig fixup                            |
+| diff       | diff             | head branch files view between contain                    |
+| fetch      | fetch            | origin remote all                                         |
+| files      | ls-files         | cached modified deleted others                            |
+| git        |                  | add blame clean grep mv revert rm status                  |
+| log        | log              | view between contain                                      |
+| merge      | merge            | commit no-commit send                                     |
+| pull       | pull             | origin remote all                                         |
+| rebase     | rebase           | branch onto send                                          |
+| refs       | ls-remote --refs | heads tags remote                                         |
+| reset      | reset            | commit index patch mode undo                              |
+| restore    | restore          | source staged worktree                                    |
+| rev        | rev              | commit build output                                       |
+| show       | show             | format oneline textconv                                   |
+| stash      | stash            | push pop apply branch drop clear list all staged worktree |
+| submodule  | submodule        | status update branch url sync                             |
+| switch     | switch           | branch create detach                                      |
+| tag        | tag              | add sign delete list                                      |
 
 You can disable all of them at once using the `exclude` property.
 
@@ -632,7 +672,7 @@ LOG_LEVEL                    # See gem "logger"
 
 ### Git
 
-* Version: [2.50](https://github.com/git/git/blob/v2.50.0/Documentation/RelNotes/2.50.0.adoc)
+* Version: [2.51](https://github.com/git/git/blob/v2.51.0/Documentation/RelNotes/2.51.0.adoc)
 
 ```sh
 GIT_OPTIONS=q,strategy=ort  # all
@@ -688,7 +728,7 @@ GIT_AUTOSTASH_${NAME}=0     # rebase (project only)
 
 ### Docker
 
-* Version: [28.3](https://docs.docker.com/engine/release-notes/28)
+* Version: [28.5](https://docs.docker.com/engine/release-notes/28)
 
 ```sh
 DOCKER_OPTIONS=q,no-cache                # all
@@ -735,7 +775,7 @@ These global options also can target the application main suffix `${NAME}`. (e.g
 ```sh
 REPO_ROOT            # parent dir
 REPO_HOME            # project dir (main)
-REPO_BUILD           # run,script
+REPO_BUILD           # script,run (e.g. build:dev | build:dev,make install | make)
 REPO_GROUP           # string
 REPO_REF             # e.g. ruby,node
 REPO_DEV             # pattern,0,1
@@ -747,6 +787,7 @@ REPO_MANIFEST        # e.g. latest,nightly,prod
 REPO_GROUPS          # e.g. base,prod,docs
 REPO_STAGE           # 0,1,2,3,4
 REPO_SUBMODULLES     # 0,1
+REPO_Y               # 0,1
 REPO_TIMEOUT         # confirm dialog (seconds)
 ```
 

data/lib/squared/common/base.rb

@@ -17,6 +17,7 @@ module Squared
       GRAPH: ['|', '-', '|', '\\', '-'].freeze,
       BORDER: ['|', '-', '-', '-', '-', '-', '|', '|', '-', '-'].freeze,
       VIEW: 'view',
+      BACKTRACE: $DEBUG || !$VERBOSE.nil?,
       LEVEL: ENV.fetch('LOG_LEVEL', 0).to_i,
       COLOR: ENV.fetch('NO_COLOR', '').empty?
     }
@@ -97,27 +98,5 @@ module Squared
       VAR[:theme].each_value { |val| val.freeze.each_value(&:freeze) }
       VAR.freeze
     end
-
-    module_function
-
-    def as_a(obj, *meth, flat: nil, compact: false, &blk)
-      return [] if obj.nil?
-
-      unless obj.is_a?(::Array)
-        obj = if obj.respond_to?(:to_ary)
-                obj.to_ary
-              elsif obj.respond_to?(:to_a) && !obj.is_a?(::Hash) && (val = obj.to_a).is_a?(::Array)
-                val
-              else
-                [obj]
-              end
-      end
-      obj = flat.is_a?(::Numeric) ? obj.flatten(flat) : obj.flatten if flat
-      obj = obj.compact if compact
-      obj = obj.map(&meth.shift) until meth.empty?
-      return obj unless block_given?
-
-      obj.select(&blk)
-    end
   end
 end

data/lib/squared/common/format.rb

@@ -39,6 +39,10 @@ module Squared
       TEXT_STYLE = [:bold, :dim, :italic, :underline, :blinking, nil, :inverse, :hidden, :strikethrough].freeze
       private_constant :AIX_TERM, :BOX_GRAPH, :BOX_BORDER, :TEXT_STYLE
 
+      String.define_method(:stripstyle) { gsub(/\x1B\[(?:\d+;?)+m/, '') }
+      String.define_method(:stripext) { File.basename(self, '.*') }
+      String.define_method(:subhint) { |s| s.nil? || (s.is_a?(::String) && s.empty?) ? self : "#{self} (#{s})" }
+
       def enable_aixterm
         unless (colors = __get__(:colors)).frozen?
           colors.update(AIX_TERM)
@@ -85,7 +89,7 @@ module Squared
             end
           else
             t = type.to_sym
-            if (c = __get__(:colors)[t])
+            if (c = __get__(:colors)[t] || __get__(:colors)[t.to_s.sub('bright_', '').to_sym])
               if index == -1
                 s = wrap.call(s, [c])
               else
@@ -94,7 +98,7 @@ module Squared
             else
               next unless (n = TEXT_STYLE.index(t))
 
-              s = "\x1B[#{n + 1}m#{s}\x1B[#{n == 0 ? 22 : n + 21}m"
+              s = "\x1B[#{n.succ}m#{s}\x1B[#{n == 0 ? 22 : n + 21}m"
             end
           end
           if index == -1
@@ -108,7 +112,7 @@ module Squared
         ret = wrap.call(ret, code) unless code.empty?
         return ret unless data
 
-        out = ''.dup
+        out = +''
         data.to_a.each_with_index do |group, i|
           next if i == 0
 
@@ -126,8 +130,8 @@ module Squared
         colors = __get__(:colors)
         Array(args).flatten.compact.each do |val|
           if !val.is_a?(::Numeric)
-            val = val.to_sym
-            ret << val if colors.key?(val) || TEXT_STYLE.include?(val)
+            k = val.to_sym
+            ret << k if colors.key?(k) || colors.key?(k.to_s.sub('bright_', '').to_sym) || TEXT_STYLE.include?(k)
           elsif val.between?(0, 256)
             ret << val
           elsif val < 0 && (b = val.to_s.split('.')[1])
@@ -151,6 +155,10 @@ module Squared
         end
       end
 
+      def opt_style(styles, pat = nil, index = 1)
+        { styles: styles, pat: pat, index: index }
+      end
+
       def log_sym(level)
         if level.is_a?(::Numeric)
           case level
@@ -188,8 +196,12 @@ module Squared
         end
         if (args.size > 1 && !hint) || hint == false
           title = log_title(level, color: false)
-          sub = [pat: /\A(#{Regexp.escape(title)})(.*)\z/m, styles: __get__(:theme)[:logger][log_sym(level)]] if color
-          emphasize(args, title: title + (subject ? " #{subject}" : ''), sub: sub, pipe: -1)
+          emphasize(args,
+                    title: title + (subject ? " #{subject}" : ''),
+                    pipe: -1,
+                    sub: if color
+                           opt_style(__get__(:theme)[:logger][log_sym(level)], /\A(#{Regexp.escape(title)})(.*)\z/m)
+                         end)
         else
           msg = [log_title(level, color: color)]
           msg << (color ? sub_style(subject.to_s, styles: (@theme && @theme[:subject]) || :bold) : subject) if subject
@@ -205,7 +217,7 @@ module Squared
           begin
             File.open(pipe, 'a') do |f|
               br = File::SEPARATOR == '\\' ? "\r\n" : "\n"
-              args.flatten.each { |val| f.write(strip_style(val.chomp) + br) }
+              args.flatten.each { |val| f.write(val.chomp.stripstyle + br) }
             end
             return
           rescue StandardError
@@ -215,13 +227,12 @@ module Squared
         (pipe == 2 ? $stderr : $stdout).puts(*args)
       end
 
-      alias puts_oe log_console
-
       module_function
 
       def message(*args, hint: nil, empty: false, space: ARG[:SPACE])
         (empty ? args.reject { |val| val.nil? || (val.respond_to?(:empty?) && val.empty?) } : args)
-          .join(space) + (hint ? " (#{hint})" : '')
+          .join(space)
+          .subhint(hint)
       end
 
       def emphasize(val, title: nil, footer: nil, right: false, cols: nil, sub: nil, pipe: nil,
@@ -237,7 +248,7 @@ module Squared
           lines = val.to_s.lines(chomp: true)
           lines[0] = "#{val.class}: #{lines.first}" if (err = val.is_a?(::StandardError))
         end
-        n = cols || max.call(lines)
+        n = (cols.is_a?(::Array) ? cols.map(&:size).max : cols) || max.call(lines)
         if $stdout.tty?
           require 'io/console'
           (n = [n, $stdout.winsize[1] - 4].min) rescue nil
@@ -255,14 +266,14 @@ module Squared
           sub.each { |h| s = sub_style(s, **h) }
           s = "#{b0} #{s} #{b0}"
           if border
-            s = sub_style(s, pat: /\A(#{Regexp.escape(b0)})(.+)\z/m, styles: border)
-            s = sub_style(s, pat: /\A(.+)(#{Regexp.escape(b0)})\z/m, styles: border, index: 2)
+            s = sub_style(s, **opt_style(border, /\A(#{Regexp.escape(b0)})(.+)\z/m))
+            s = sub_style(s, **opt_style(border, /\A(.+)(#{Regexp.escape(b0)})\z/m, 2))
           end
           s
         end
         out << draw.call(b2, b3)
         if title
-          out.concat(title.map { |t| pr.call(t) })
+          out.concat(title.map! { |t| pr.call(t) })
           out << draw.call(b6, b7)
         end
         lines.each { |line| out << pr.call(line) }
@@ -296,16 +307,13 @@ module Squared
         end
       end
 
-      def strip_style(val)
-        val.gsub(/\x1B\[(\d+;?)+m/, '')
-      end
-
-      def stripext(val)
-        File.basename(val, '.*')
-      end
-
-      def raise_error(*args, hint: nil, kind: ArgumentError)
-        raise kind, message(*args, hint: hint, empty: true), caller_locations(1).map(&:to_s)
+      def raise_error(*args, hint: nil, kind: RuntimeError, start: 0)
+        kind = args.shift if args.first.is_a?(::Class) && args.first < ::Exception
+        raise kind, message(*args, hint: hint, empty: true), if ARG[:BACKTRACE]
+                                                               caller(start.succ)
+                                                             else
+                                                               caller_locations(start.succ, 1).first&.base_label
+                                                             end
       end
     end
   end

data/lib/squared/common/prompt.rb

@@ -1,12 +1,25 @@
 # frozen_string_literal: true
 
+unless defined?(Readline)
+  if RUBY_ENGINE == 'ruby' && RUBY_VERSION < '2.7'
+    require 'readline'
+  else
+    begin
+      require 'reline'
+      Object.send(:remove_const, :Readline) if Object.const_defined?(:Readline)
+      Readline = Reline
+    rescue LoadError
+      require 'readline'
+    end
+  end
+end
+
 module Squared
   module Common
     module Prompt
       module_function
 
-      def confirm(msg, default = nil, agree: 'Y', cancel: 'N', attempts: 5, timeout: 30)
-        require 'readline'
+      def confirm(msg, default = nil, agree: 'Y', cancel: 'N', attempts: 3, timeout: 60)
         require 'timeout'
         if agree == 'Y' && cancel == 'N' && !msg.match?(%r{\[(?:Yn|nY|Y/n|y/N)\]})
           case default
@@ -38,9 +51,8 @@ module Squared
         end
       end
 
-      def choice(msg, list = nil, min: 1, max: 1, multiple: false, force: true, grep: nil, auto: true,
-                 attempts: 5, timeout: 0)
-        require 'readline'
+      def choice(msg, list = nil, min: 1, max: 1, multiple: false, index: false, grep: nil, border: nil, auto: true,
+                 force: true, attempts: 3, timeout: 0)
         require 'timeout'
         if list
           grep &&= Array(grep).map { |val| Regexp.new(val) }
@@ -52,40 +64,51 @@ module Squared
             puts '%2d. %s' % [items.size, val]
           end
           max = items.size
-          raise_error 'empty selection list' if max == 0
-          min = [min, max].min
+          raise ArgumentError, 'empty selection list' if max == 0
+
+          min = grep ? 1 : [min, max].min
           if auto
-            msg = "#{msg}: [1-#{max}#{if multiple
-                                        "|,#{multiple.is_a?(::Numeric) ? "{#{multiple}}" : ''}"
-                                      end}] "
+            auto.times { puts } if auto.is_a?(::Numeric)
+            if border == true
+              puts print_footer
+            elsif border
+              puts print_footer(border: border)
+            end
+            msg = "#{msg + (force ? ':' : '?')} [#{min}-#{max}#{if (n = multiple)
+                                                                  "|,#{n.is_a?(::Numeric) ? "{#{n}}" : '*'}"
+                                                                end}] "
           end
         end
-        valid = ->(s) { s.match?(/^\d+$/) && s.to_i.between?(min, max) }
+        between = ->(s) { s.match?(/^\d+$/) && s.to_i.between?(min, max) }
         Timeout.timeout(timeout) do
           while (ch = Readline.readline(msg))
             unless (ch = ch.strip).empty?
               if multiple
-                a = ch.split(/\s*,\s*/)
-                b = a.map do |s|
-                  if s =~ /^(\d+)-(\d+)$/
-                    next unless valid.call($1) && valid.call($2)
+                k = if ch == '*'
+                      (min..max).to_a
+                    else
+                      ch.split(/\s*,\s*/).map! do |s|
+                        if s =~ /^(\d+)-(\d+)$/
+                          next unless between.call($1) && between.call($2)
 
-                    c = $1.to_i
-                    d = $2.to_i
-                    next (c..d).to_a if c < d
-                  elsif valid.call(s)
-                    s.to_i
+                          i = $1.to_i
+                          j = $2.to_i
+                          next (i..j).to_a if i < j
+                        elsif between.call(s)
+                          s.to_i
+                        end
+                      end
+                    end
+                unless k.include?(nil)
+                  k.flatten!
+                  k.uniq!
+                  k.sort!
+                  unless multiple.is_a?(::Numeric) && multiple != k.size
+                    return index || !items ? k : k.map! { |i| items[i.pred] }
                   end
                 end
-                unless b.include?(nil)
-                  b.flatten!
-                  b.uniq!
-                  b.sort!
-                  return b unless items
-                  return b.map! { |i| items[i - 1] } unless multiple.is_a?(::Numeric) && multiple != b.size
-                end
-              elsif valid.call(ch)
-                return items ? items[ch.to_i - 1] : ch.to_i
+              elsif between.call(ch)
+                return index || !items ? ch.to_i : items[ch.to_i.pred]
               end
             end
             attempts -= 1
@@ -98,12 +121,11 @@ module Squared
           puts
           exit 0
         else
-          multiple ? [] : nil
+          [] if multiple
         end
       end
 
       def readline(msg, history = false, force: nil, multiline: nil, &blk)
-        require 'readline'
         multiline = if multiline && Readline.respond_to?(:readmultiline)
                       multiline.is_a?(::Enumerable) || block_given? ? multiline : [multiline.to_s]
                     end
@@ -118,11 +140,11 @@ module Squared
         end
         case force
         when ::TrueClass, ::FalseClass
-          msg = "#{msg} %s " % if multiline
-                                 multiline.is_a?(::Enumerable) ? "{#{multiline.to_a.join('|')}}" : multiline
-                               else
-                                 "(#{force ? 'required' : 'optional'}):"
-                               end
+          msg = "#{msg}%s%s " % if multiline
+                                  [' ', multiline.is_a?(::Enumerable) ? "{#{multiline.to_a.join('|')}}" : multiline]
+                                else
+                                  [force ? ':' : '?', '']
+                                end
           ret = (prompt.call || '').strip
           multiline.each { |val| break if ret.delete_suffix!(val.to_s) } if multiline.is_a?(::Enumerable)
           exit 1 if force && ret.empty?