squared 0.4.7 → 0.4.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0cf1642a52eeb080a0aa4dadb9c7fb5a3060612904bd06a8161ab18b4e333a9a
-  data.tar.gz: 7bad82be155782b37036cc2d447395a37585ed33b4d37c5281e3ccd3f902ea33
+  metadata.gz: 81e1fa9c773a59c8cb351dec47eb27b4c858c6266c83bd14be02c621cf68ad57
+  data.tar.gz: 23ccad44a3f5fbc1ade8d5950692fd401566f862b0131debebdd9d5d1a4d6dab
 SHA512:
-  metadata.gz: 77fda3077ec4c929fad3003d7255d5aeb7b0f7fa2d14a717678772572a3a972214247aabc6911d8e717103b855ae1109c81c118ca5564f46fd4e79ecfc62cf6a
-  data.tar.gz: 29e84ae67dc2aad4ac61c99407443d65210f96af60649784c9264a75c686473b919328a9ea6d97b6bda6e4fd61aeaa97df4e196bdf87f6e32819dfea1306c76a
+  metadata.gz: '00945ddcf48ae0482bdb40f143117ae464a03491fadf6c33b2e34c9f50b4d628c4b72b43c1a388e2c8c175067f62970c7ac60721330c1340a48103c4b972b560'
+  data.tar.gz: d3846c85547ee3acb6d040703d21b7a61630f502c17da71f8d0ddf9032c67930819b933b3c3896a0e2b23c2664bfc2ed5454d95313849a9885c429d0cfacb5f1

data/CHANGELOG.md

@@ -1,5 +1,105 @@
 # Changelog
 
+## [0.4.9] - 2025-04-27
+
+### Added
+
+- Git command reset action commit is interactive.
+- Git command commit action all is interactive.
+- Git command log and diff commit based actions are interactive.
+- Git command branch action move and copy are interactive.
+- Git command rebase and merge are interactive.
+- Git command checkout action detach is interactive.
+- Git command branch action delete for remotes is interactive.
+- Git command restore action source was created.
+- Git command tag actions can choose a remote to push.
+- Git command switch was implemented.
+- Git command branch action create is interactive.
+- Git command reset action mode and patch are interactive.
+- Git command restore action staged and worktree are interactive.
+- Git command log and checkout commit based actions are interactive.
+- Ruby command ruby action script is interactive.
+- Ruby command irb is interactive.
+- Git command commit action fixup was implemented.
+- Git command commit action all can accept add command options.
+- Git command branch action create and track can upload tracking.
+- Git command add was implemented.
+- Python command venv action run is interactive.
+
+### Changed
+
+- Ruby depend with bundler excludes development group in production.
+- OptionPartition class first and pass parameters were combined.
+- Git command stash action list can accept log options.
+- Git command branch action set was renamed track.
+- Ruby autodetect can specify version manager for local project.
+- Git pattern matching for HEAD was revised.
+
+### Removed
+
+- Git command branch action edit is not commonly used.
+- Git command rev action branch only echoed valid branches.
+- Git command rev action parseopt is not relevant to a workspace.
+
+## [0.3.10] - 2025-04-27
+
+### Fixed
+
+- Git command reset action commit used invalid delimeter.
+- Git single option values were not merged as per specification.
+- Project script task did not fire first and last callbacks.
+- Git checkout action commit did not include options.
+
+### Removed
+
+- Git command files action ignored could not be used alone.
+
+## [0.2.10] - 2025-04-27
+
+### Fixed
+
+- Project run and script tasks did not fire first and last callbacks.
+- Git command clone did not read booleans for recurse-submodules.
+
+## [0.1.7] - 2025-04-27
+
+### Fixed
+
+- Project directory context method option pass was inverted.
+- Shell options with spaces and without quotes were not escaped.
+- Git task status did not display branch information.
+- Ruby copy method argument include was ignored when used directly.
+- Git commit could not push branch without same name as remote.
+
+## [0.4.8] - 2025-04-21
+
+### Added
+
+- Workspace project tasks can be executed with a block.
+- Gem command outdated supports semantic version upgrades.
+- Project task unpack supports "gem" extension.
+- Ruby command version was implemented.
+- Ruby command file and script were implemented.
+- Git global command autostash was created.
+- Workspace static method exclude for global tasks was created.
+- Git command checkout action branch and track are interactive.
+- Git command branch action set and delete are interactive.
+- Git command tag action delete is interactive.
+- Docker command image run and container exec are interactive.
+- Docker command network connect and disconnect are interactive.
+
+### Changed
+
+- Project methods with conflicting names were given "!" suffix.
+- Docker exec args are run without escape protection.
+- Format method enable_aixterm no longer accepts a block.
+
+### Fixed
+
+- Git command log action view did not parse options.
+- Project task unpack did not use custom extensions.
+- Docker did not append secrets when given a string.
+
 ## [0.4.7] - 2025-04-17
 
 ### Added
@@ -454,7 +554,7 @@
 - Node tasks without any action are not displayed.
 - Git fetch commands that do not apply to pull are rejected.
 
-## [0.1.3] - 2024-01-02
+## [0.1.3] - 2025-01-02
 
 ### Fixed
 
@@ -533,6 +633,8 @@
 
 - Changelog was created.
 
+[0.4.9]: https://github.com/anpham6/squared/releases/tag/v0.4.9-ruby
+[0.4.8]: https://github.com/anpham6/squared/releases/tag/v0.4.8-ruby
 [0.4.7]: https://github.com/anpham6/squared/releases/tag/v0.4.7-ruby
 [0.4.6]: https://github.com/anpham6/squared/releases/tag/v0.4.6-ruby
 [0.4.5]: https://github.com/anpham6/squared/releases/tag/v0.4.5-ruby
@@ -541,6 +643,7 @@
 [0.4.2]: https://github.com/anpham6/squared/releases/tag/v0.4.2-ruby
 [0.4.1]: https://github.com/anpham6/squared/releases/tag/v0.4.1-ruby
 [0.4.0]: https://github.com/anpham6/squared/releases/tag/v0.4.0-ruby
+[0.3.10]: https://github.com/anpham6/squared/releases/tag/v0.3.10-ruby
 [0.3.9]: https://github.com/anpham6/squared/releases/tag/v0.3.9-ruby
 [0.3.8]: https://github.com/anpham6/squared/releases/tag/v0.3.8-ruby
 [0.3.7]: https://github.com/anpham6/squared/releases/tag/v0.3.7-ruby
@@ -551,6 +654,7 @@
 [0.3.2]: https://github.com/anpham6/squared/releases/tag/v0.3.2-ruby
 [0.3.1]: https://github.com/anpham6/squared/releases/tag/v0.3.1-ruby
 [0.3.0]: https://github.com/anpham6/squared/releases/tag/v0.3.0-ruby
+[0.2.10]: https://github.com/anpham6/squared/releases/tag/v0.2.10-ruby
 [0.2.9]: https://github.com/anpham6/squared/releases/tag/v0.2.9-ruby
 [0.2.8]: https://github.com/anpham6/squared/releases/tag/v0.2.8-ruby
 [0.2.7]: https://github.com/anpham6/squared/releases/tag/v0.2.7-ruby
@@ -561,6 +665,7 @@
 [0.2.2]: https://github.com/anpham6/squared/releases/tag/v0.2.2-ruby
 [0.2.1]: https://github.com/anpham6/squared/releases/tag/v0.2.1-ruby
 [0.2.0]: https://github.com/anpham6/squared/releases/tag/v0.2.0-ruby
+[0.1.7]: https://github.com/anpham6/squared/releases/tag/v0.1.7-ruby
 [0.1.6]: https://github.com/anpham6/squared/releases/tag/v0.1.6-ruby
 [0.1.5]: https://github.com/anpham6/squared/releases/tag/v0.1.5-ruby
 [0.1.4]: https://github.com/anpham6/squared/releases/tag/v0.1.4-ruby

data/README.ruby.md

@@ -83,7 +83,7 @@ Workspace::Application
     "CFLAGS" => "-fPIC -O1"
   })
   .add("optparse", doc: "rake rdoc", group: "default") # Uses bundler/gem_tasks (without C extensions)
-  .add("logger", copy: { from: "lib", glob: "**/*.rb", into: "~/.rvm/gems/ruby-3.4.0/gems/logger-1.6.1" }, clean: ["tmp/"]) # autodetect: true
+  .add("logger", copy: { from: "lib", glob: "**/*.rb", into: "~/.rvm/gems/ruby-3.4.0/gems/logger-1.6.1" }, clean: ["tmp/"]) # autodetect: true | "rvm" | "rbenv" | "asdf" | "bundler"
   .add("e-mc", "emc", copy: { from: "publish", scope: "@e-mc", also: [:pir, "squared-express/"] }, ref: :node) # Node
   .add("pi-r", "pir", copy: { from: "publish", scope: "@pi-r" }, clean: ["publish/**/*.js", "tmp/"]) # Trailing slash required for directories
   .add("squared", script: ["build:stage1", "build:stage2"], group: "app") do # Copy target (main)
@@ -278,6 +278,14 @@ Workspace::Application
   .with(:ruby) do
     run("gem build")                                                           # gem build
     # OR
+    run("gem build", on: { first: -> { p "2" }, last: -> { p "4" } }) do       # run | depend | graph | clean | doc | lint | test
+      p "1"
+    end
+    # OR
+    run(on: { first: -> { p "pass" }, last: -> { p "pass" } }) do
+      p "1"
+    end
+    # OR
     run(["gem build", "--force", { "RUBY_VERSION" => "3.4.0" }])               # RUBY_VERSION="3.4.0" gem build --force
     # OR
     run({                                                                      #
@@ -429,25 +437,28 @@ Most project classes will inherit from `Git` which enables these tasks:
 | :--------- | :--------------- | :-------------------------------------------- |
 | branch     | branch           | create set delete move copy list edit current |
 | checkout   | checkout         | commit branch track detach path               |
-| commit     | commit           | add all amend amend-orig                      |
+| commit     | commit           | add all amend amend-orig fixup                |
 | diff       | diff             | head cached branch files between contain      |
 | fetch      | fetch            | origin remote                                 |
-| files      | ls-files         | cached modified deleted others ignored        |
-| git        |                  | clean mv rm                                   |
+| files      | ls-files         | cached modified deleted others                |
+| git        |                  | add clean mv rm revert                        |
 | merge      | merge            | commit no-commit send                         |
 | pull       | pull             | origin remote                                 |
 | rebase     | rebase           | branch onto send                              |
 | refs       | ls-remote --refs | heads tags remote                             |
 | reset      | reset            | commit index patch mode                       |
 | restore    | restore          | staged worktree                               |
-| rev        | rev              | commit branch output parseopt                 |
+| rev        | rev              | commit output                                 |
 | show       | show             | format oneline                                |
 | stash      | stash            | push pop apply drop list                      |
+| switch     | switch           | create detach merge                           |
 | tag        | tag              | add sign delete list                          |
 
 You can disable all of them at once using the `exclude` property.
 
 ```ruby
+Workspace::Application.exclude('autostash', 'rebase')
+
 Workspace::Application
   .new
   .add("squared", exclude: :git)
@@ -462,6 +473,16 @@ Workspace::Application
   .pass("pull", ref: :node) { read_packagemanager(:private) }
 ```
 
+### Commit Hash
+
+Commands which use commit hashes are parsed using a ":" prefix as to not be confused for an option.
+
+```sh
+rake squared:log:view[:af012345]                   # git log af012345
+rake squared:log:view[#{af012345}]                 # deprecated
+rake squared:log:view[H1,HEAD^5,all,lib,./H12345]  # git log --all @~1 @^5 -- 'lib' 'H12345'
+```
+
 ## Environment
 
 ### Path
@@ -551,39 +572,46 @@ GIT_AUTOSTASH_${NAME}=0     # rebase (project only)
 
 | Command    | Flag              |  ENV                                                                  |
 | :--------- | :---------------- | :-------------------------------------------------------------------- |
+| branch     | create            | TRACK=0,1,s FORCE                                                     |
+| branch     | move copy         | FORCE                                                                 |
+| branch     | set delete        | COUNT=n                                                               |
+| branch     | global            | SYNC                                                                  |
+| checkout   | branch            | DETACH TRACK=s COUNT=n                                                |
+| checkout   | detach            | REFLOG=1                                                              |
+| checkout   | track             | COUNT=n                                                               |
+| checkout   | global path       | HEAD=s PATHSPEC=s                                                     |
+| checkout   | *                 | FORCE MERGE                                                           |
+| clone      | *                 | DEPTH=n ORIGIN=s BRANCH=s LOCAL=0,1                                   |
+| commit     | *                 | UPSTREAM=s DRY_RUN EDIT=0 M|MESSAGE=s                                 |
+| diff       | -between -contain | MERGE_BASE                                                            |
+| diff       | head branch       | INDEX=n                                                               |
+| diff       | *                 | PATHSPEC=s                                                            |
+| fetch      | -remote           | ALL                                                                   |
+| fetch      | remote            | REFSPEC=s                                                             |
+| fetch      | *                 | FORCE RECURSE_SUBMODULES=0,1,s                                        |
+| git        | rm                | PATHSPEC=s                                                            |
+| log        | *                 | PATHSPEC=s                                                            |
 | pull       | rebase            | AUTOSTASH                                                             |
 | pull       | remote            | REFSPEC=s                                                             |
 | pull       | *                 | REBASE=0,1 FORCE RECURSE_SUBMODULES=0,1,s                             |
 | rebase     | branch            | HEAD=s                                                                |
 | rebase     | onto              | INTERACTIVE I HEAD=s                                                  |
-| fetch      | -remote           | ALL                                                                   |
-| fetch      | remote            | REFSPEC=s                                                             |
-| fetch      | *                 | FORCE RECURSE_SUBMODULES=0,1,s                                        |
-| clone      | *                 | DEPTH=n ORIGIN=s BRANCH=s LOCAL=0,1                                   |
-| stash      | push              | PATHSPEC=s                                                            |
-| stash      | global            | ALL=0,1 KEEP_INDEX=0,1 INCLUDE_UNTRACKED=0,1 STAGED=0,1 MESSAGE=s M=s |
-| status     | global            | LONG IGNORE_SUBMODULES=s,0-3 PATHSPEC=s                               |
-| revbuild   | global            | UNTRACKED_FILES=s IGNORE_SUBMODULES=s IGNORED=s (status)              |
 | reset      | mode (mixed)      | N REFRESH=0                                                           |
 | reset      | index             | PATHSPEC=s                                                            |
+| reset      | commit            | COUNT=n REFLOG=1                                                      |
 | reset      | -commit           | HEAD=s                                                                |
-| checkout   | branch            | DETACH TRACK=s                                                        |
-| checkout   | global path       | HEAD=s PATHSPEC=s                                                     |
-| checkout   | *                 | FORCE MERGE                                                           |
-| tag        | add               | SIGN FORCE HEAD=s                                                     |
-| tag        | sign              | FORCE HEAD=s                                                          |
-| log        | *                 | PATHSPEC=s                                                            |
-| diff       | -between -contain | MERGE_BASE                                                            |
-| diff       | head branch       | INDEX=n                                                               |
-| diff       | *                 | PATHSPEC=s                                                            |
-| commit     | *                 | MESSAGE=s M=s REPOSITORY=s DRY_RUN EDIT=0                             |
-| branch     | create            | TRACK=0,1,s FORCE                                                     |
-| branch     | move copy         | FORCE                                                                 |
-| branch     | global            | SYNC                                                                  |
 | restore    | *                 | PATHSPEC=s                                                            |
-| show       | -online           | ABBREV=n                                                              |
+| revbuild   | global            | UNTRACKED_FILES=s IGNORE_SUBMODULES=s IGNORED=s (status)              |
+| stash      | push              | PATHSPEC=s                                                            |
+| stash      | global            | ALL=0,1 KEEP_INDEX=0,1 INCLUDE_UNTRACKED=0,1 STAGED=0,1 M|MESSAGE=s   |
+| status     | global            | BRANCH LONG IGNORE_SUBMODULES=s,0-3 PATHSPEC=s                        |
+| switch     | detach            | REFLOG=1                                                              |
+| switch     | -detach           | HEAD=s                                                                |
+| switch     | *                 | FORCE                                                                 |
+| tag        | add               | SIGN FORCE HEAD=s M|MESSAGE=s                                         |
+| tag        | sign              | FORCE HEAD=s M|MESSAGE=s                                              |
+| tag        | delete            | COUNT=n                                                               |
 | rev        | commit branch     | HEAD=s                                                                |
-| git        | rm                | PATHSPEC=s                                                            |
 
 ### Docker
 
@@ -592,6 +620,7 @@ DOCKER_OPTIONS=q,no-cache                # all
 DOCKER_OPTIONS_${NAME}=v,no-cache=false  # project only (override)
 DOCKER_TAG=latest                        # all
 DOCKER_TAG_${NAME}=v0.1.0                # project only (override)
+DOCKER_ALL=1                             # list every image/container
 ```
 
 | Command    | Flag              |  ENV                                            |

data/lib/squared/common/base.rb

@@ -11,6 +11,7 @@ module Squared
       COMMON: true,
       VERBOSE: nil,
       BANNER: true,
+      CHOICE: 25,
       QUOTE: "'",
       SPACE: ' => ',
       GRAPH: ['|', '-', '|', '\\', '-'].freeze,

data/lib/squared/common/class.rb

@@ -12,7 +12,7 @@ module Squared
         super[/[^:]+\z/, 0]
       end
 
-      def_delegators :@data, :+, :each, :each_with_index, :entries, :merge, :to_a, :include?
+      def_delegators :@data, :+, :each, :each_with_index, :entries, :merge, :include?
 
       def initialize(data = [])
         @data = Set.new(data)
@@ -22,6 +22,10 @@ module Squared
         @data.add(val.to_sym)
       end
 
+      def to_a
+        @data.to_a.freeze
+      end
+
       def to_s
         @data.to_s.sub('Set', SymSet.to_s)
       end
@@ -71,6 +75,20 @@ module Squared
         block_given? ? ret.reject(&blk) : ret
       end
 
+      def and(*args)
+        self << '&&'
+        merge(args)
+      end
+
+      def or(*args)
+        self << '||'
+        merge(args)
+      end
+
+      def with(*args, &blk)
+        temp('&&', *args, &blk)
+      end
+
       def temp(*args, &blk)
         args.compact!
         ret = pass(&blk)

data/lib/squared/common/format.rb

@@ -28,18 +28,22 @@ module Squared
         bright_cyan!: '106',
         bright_white!: '107'
       }.freeze
-      AIX_GRAPH = ['│', '─', '├', '└', '┬'].freeze
-      AIX_BORDER = ['│', '─', '╭', '╮', '╯', '╰', '├', '┤', '┬', '┴'].freeze
+      BOX_GRAPH = ['│', '─', '├', '└', '┬'].freeze
+      BOX_BORDER = ['│', '─', '╭', '╮', '╯', '╰', '├', '┤', '┬', '┴'].freeze
       TEXT_STYLE = [:bold, :dim, :italic, :underline, :blinking, nil, :inverse, :hidden, :strikethrough].freeze
-      private_constant :AIX_TERM, :AIX_GRAPH, :AIX_BORDER, :TEXT_STYLE
+      private_constant :AIX_TERM, :BOX_GRAPH, :BOX_BORDER, :TEXT_STYLE
 
       def enable_aixterm
         unless (colors = __get__(:colors)).frozen?
           colors.merge!(AIX_TERM)
-          ARG[:GRAPH] = AIX_GRAPH
-          ARG[:BORDER] = AIX_BORDER
         end
-        block_given? ? yield(self) : self
+        self
+      end
+
+      def enable_drawing
+        ARG[:GRAPH] = BOX_GRAPH
+        ARG[:BORDER] = BOX_BORDER
+        self
       end
 
       private
@@ -57,7 +61,7 @@ module Squared
         end
         wrap = ->(s, n) { "\x1B[#{n.join(';')}m#{s}\x1B[0m" }
         code = []
-        args.concat(as_a(styles)).each_with_index do |type, i|
+        args.concat(as_a(styles)).flatten.each_with_index do |type, i|
           next unless type
 
           if index == -1
@@ -68,16 +72,16 @@ module Squared
           end
           if type.is_a?(::Numeric)
             f, b = type.to_s.split('.')
-            s = wrap.(s, ['38', '5', f]) if f[0] != '-' && f.to_i <= 255
+            s = wrap.call(s, ['38', '5', f]) if f[0] != '-' && f.to_i <= 255
             if b
               b = b[0, 3]
-              s = wrap.(s, ['48', '5', b]) unless b.to_i > 255
+              s = wrap.call(s, ['48', '5', b]) unless b.to_i > 255
             end
           else
             t = type.to_sym
             if (c = __get__(:colors)[t])
               if index == -1
-                s = wrap.(s, [c])
+                s = wrap.call(s, [c])
               else
                 code << c
               end
@@ -95,7 +99,7 @@ module Squared
         end
         return ret.join if index == -1
 
-        ret = wrap.(ret, code) unless code.empty?
+        ret = wrap.call(ret, code) unless code.empty?
         return ret unless data
 
         out = ''.dup
@@ -133,28 +137,21 @@ module Squared
 
         set = ->(k, v) { data[k] = check_style(v, empty: empty) }
         if key.is_a?(::Hash)
-          key.each { |k, v| set.(k, v || args) }
+          key.each { |k, v| set.call(k, v || args) }
         else
-          set.(key.to_sym, args)
+          set.call(key.to_sym, args)
         end
       end
 
       def log_sym(level)
         if level.is_a?(::Numeric)
           case level
-          when Logger::DEBUG
-            :debug
-          when Logger::INFO
-            :info
-          when Logger::WARN
-            :warn
-          when Logger::ERROR
-            :error
-          when Logger::FATAL
-            :fatal
-          else
-            :unknown
-          end
+          when Logger::DEBUG then :debug
+          when Logger::INFO then :info
+          when Logger::WARN then :warn
+          when Logger::ERROR then :error
+          when Logger::FATAL then :fatal
+          else :unknown end
         else
           level.to_s.downcase.to_sym
         end
@@ -181,7 +178,7 @@ module Squared
         end
         if args.size > 1 && !hint
           title = log_title(level, color: false)
-          sub = { pat: /^(#{title})(.+)$/, styles: __get__(:theme)[:logger][log_sym(level)] } if color
+          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)
         else
           msg = [log_title(level, color: color)]
@@ -219,18 +216,18 @@ module Squared
         max = ->(v) { n = [n, v.max_by(&:size).size].max }
         set = lambda do |v|
           ret = as_a(v, :to_s)
-          max.(ret)
+          max.call(ret)
           ret
         end
-        title &&= set.(title)
-        footer &&= set.(footer)
+        title &&= set.call(title)
+        footer &&= set.call(footer)
         if val.is_a?(::Array)
           lines = val.map(&:to_s)
         else
           lines = val.to_s.lines(chomp: true)
           lines[0] = "#{val.class}: #{lines.first}" if (err = val.is_a?(StandardError))
         end
-        n = cols || max.(lines)
+        n = cols || max.call(lines)
         if $stdout.tty?
           require 'io/console'
           (n = [n, $stdout.winsize[1] - 4].min) rescue nil
@@ -242,7 +239,7 @@ module Squared
           ret = sub_style(ret, styles: border) if border
           ret
         end
-        sub = as_a(sub)
+        sub = as_a sub
         pr = lambda do |line|
           s = line.ljust(n)
           sub.each { |h| s = sub_style(s, **h) }
@@ -253,13 +250,13 @@ module Squared
           end
           s
         end
-        out << draw.(b2, b3)
+        out << draw.call(b2, b3)
         if title
-          out.concat(title.map { |t| pr.(t) })
-          out << draw.(b6, b7)
+          out.concat(title.map { |t| pr.call(t) })
+          out << draw.call(b6, b7)
         end
-        lines.each { |line| out << pr.(line) }
-        out << draw.(b5, b4)
+        lines.each { |line| out << pr.call(line) }
+        out << draw.call(b5, b4)
         if footer
           unless sub.empty? && !right
             footer.map! do |s|
@@ -292,7 +289,7 @@ module Squared
       end
 
       def stripext(val)
-        File.basename(val, File.extname(val))
+        File.basename(val, '.*')
       end
 
       def raise_error(*args, hint: nil, kind: ArgumentError)

data/lib/squared/common/prompt.rb

@@ -5,14 +5,14 @@ module Squared
     module Prompt
       module_function
 
-      def confirm(msg, default = nil, agree: 'Y', cancel: 'N', attempts: 5, timeout: 15)
+      def confirm(msg, default = nil, agree: 'Y', cancel: 'N', attempts: 5, timeout: 30)
         require 'readline'
         require 'timeout'
         agree = /^#{agree}$/i if agree.is_a?(::String)
         cancel = /^#{cancel}$/i if cancel.is_a?(::String)
         Timeout.timeout(timeout) do
           begin
-            while (ch = Readline.readline(msg, true))
+            while (ch = Readline.readline(msg))
               ch = ch.chomp
               case (ch.empty? ? default : ch)
               when agree
@@ -21,7 +21,7 @@ module Squared
                 return false
               end
               attempts -= 1
-              exit 1 unless attempts >= 0
+              exit 1 unless attempts > 0
             end
           rescue Interrupt
             puts
@@ -31,6 +31,69 @@ module Squared
           end
         end
       end
+
+      def choice(msg, list = nil, min: 1, max: 1, multiple: false, auto: true, force: true, attempts: 5, timeout: 60)
+        require 'readline'
+        require 'timeout'
+        if list
+          items = []
+          list.each_with_index do |val, index|
+            puts "#{index.succ.to_s.rjust(2)}. #{val}"
+            items << val.chomp
+          end
+          max = items.size
+          if auto
+            msg = "#{msg}: [1-#{max}#{if multiple
+                                        "|,#{multiple.is_a?(Numeric) ? "{#{multiple}}" : ''}"
+                                      end}] "
+          end
+        end
+        return unless max >= min
+
+        valid = ->(s) { s.match?(/^-?\d+$/) && s.to_i.between?(min, max) }
+        Timeout.timeout(timeout) do
+          begin
+            while (ch = Readline.readline(msg))
+              unless (ch = ch.strip).empty?
+                if multiple
+                  a = ch.split(/\s*,\s*/)
+                  b = a.select { |s| valid.call(s) }.map!(&:to_i).sort
+                  next unless a.size == b.size
+                  return b unless items
+                  next if multiple.is_a?(::Numeric) && multiple != b.size
+
+                  return b.map! { |i| items[i - 1] }
+                elsif valid.call(ch)
+                  return items ? items[ch.to_i - 1] : ch.to_i
+                end
+              end
+              attempts -= 1
+              next if attempts > 0
+              break unless force
+
+              exit 1
+            end
+          rescue Interrupt
+            puts
+            exit 0
+          else
+            multiple ? [] : nil
+          end
+        end
+      end
+
+      def readline(msg, history = false, force: nil)
+        require 'readline'
+        case force
+        when ::TrueClass, ::FalseClass
+          msg = "#{msg} (#{force ? 'required' : 'optional'}): "
+          ret = Readline.readline(msg, history)&.strip || ''
+          raise_error 'user cancelled' if force && ret.empty?
+          ret
+        else
+          Readline.readline(msg, history)
+        end
+      end
     end
   end
 end