squared 0.8.2 → 0.8.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53991d0e40acab903d9e2715fcc37a2f69853bcbc25ba610c04c1a7331ac865c
-  data.tar.gz: fa4913add4c429e7bbceda66f75721af58620b54549591a911bb7b4b4081e913
+  metadata.gz: 8864164b082f5ec20e4e23ec0cea81a0d2ad0cde6977a0d484b113e72058421a
+  data.tar.gz: 2b46eca82d45c97c5a5e3ee5881e40429967916e2d569a6cf16271a0d0851a94
 SHA512:
-  metadata.gz: 5a81aadedff0d5e4288879f31f80aa0cc3c1d2997958278e0724067da6faa0452223660829870349334d35f37d6936b6ea83313c76981f67b5d095a3f8f85202
-  data.tar.gz: 84a885286b2abad87cd7b381e1fb2b71c0f7619b0486b6647b5b766eccae2fc8bb9ae845853f42115ff019e10b9d15e225b4f19d480288b9b9d194a4730b2fd3
+  metadata.gz: 0d03eca41b747dc5fe16d9767870b83733cf475e60df90358631aed94fe4fa1dbc07b00fe6bfea7e845d9b6cf361e028504c3e6302e17564fcbad5e5c3ea7a80
+  data.tar.gz: 20e7c2931780199d66ac670a4fa5b74e6a3a2b71215b1edb32cd48d0c1ca0c0622ee7bdabca21291d10add12231540092936f1e9aa3ffd8f065170ad3c65630f

data/CHANGELOG.md

@@ -1,5 +1,107 @@
 # Changelog
 
+## [0.8.4] - 2026-09-04
+
+### Added
+
+- Common module Host for capabilities was created.
+- OptionPartition can parse option values with a Regexp.
+- OptionPartition can parse option values with a set group.
+- Docker property registry was converted into an accessor.
+- Docker banner arguments [context|registry|tag] were implemented.
+- OptionPartition can parse single flags with a quoted merged value.
+- Docker command image action push is interactive.
+- Docker accessor tag can be initialized through ENV with TAG_${NAME}.
+- OptionPartition can parse option values with an explicit boolean.
+
+### Changed
+
+- Git command log action view with interactive supports exclusions.
+- OptionPartition static method union returns a copy of original target.
+
+## [0.7.11]
+
+### Added
+
+- Node command package action [approve|deny] is interactive.
+
+### Fixed
+
+- Docker container commands [run|exec] did not sanitize input prompt.
+
+## [0.6.18]
+
+### Added
+
+- Docker command bake action buildx with first arg "-" inherits base args.
+
+### Fixed
+
+- Git action grep did not recognize format and max-count.
+- Node command nvm did not quote executable path.
+
+## [0.5.26]
+
+### Fixed
+
+- Node command nvm did not quote executable path.
+
+## [0.4.41]
+
+### Added
+
+- Common base argument SUCCESS for command confirmation was created.
+
+### Changed
+
+- Program options prefer using quotes instead of escape.
+- Docker container run arguments with a leading dash are concatenated.
+
+### Fixed
+
+- Common prompt method choice did not grep list items.
+- OptionPartition static method strip did not parse flags with dashes.
+- Project base method choice_index did not support multiple selections.
+
+## [0.8.3] - 2026-08-18
+
+### Added
+
+- Docker command options were updated to 29.6.
+- Git command clone was implemented.
+- Docker command [container|compose] action logs was implemented.
+- Git command [refs|files] action remote is interactive.
+- Git command push was implemented.
+- Git command commit action head was implemented.
+
+### Changed
+
+- Python virtual environment will use a detected package manager.
+- Git command argument ref was renamed commit with interactive.
+
+### Fixed
+
+- Common prompt method choice did not grep list items.
+
+## [0.7.10] - 2026-08-06
+
+### Fixed
+
+- See `0.6.17`.
+
+## [0.6.17]
+
+### Fixed
+
+- Ruby command gem action push interactive file selector did nothing.
+- Git choice prompt did not permit optional empty values.
+
+## [0.4.40]
+
+### Changed
+
+- Series method exclude? was made compatible with v0.8 signature.
+
 ## [0.8.2] - 2026-07-05
 
 ### Added
@@ -1985,9 +2087,13 @@
 
 - Changelog was created.
 
+[0.8.4]: https://github.com/anpham6/squared-ruby/releases/tag/v0.8.4
+[0.8.3]: https://github.com/anpham6/squared-ruby/releases/tag/v0.8.3
 [0.8.2]: https://github.com/anpham6/squared-ruby/releases/tag/v0.8.2
 [0.8.1]: https://github.com/anpham6/squared-ruby/releases/tag/v0.8.1
 [0.8.0]: https://github.com/anpham6/squared-ruby/releases/tag/v0.8.0
+[0.7.11]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.11
+[0.7.10]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.10
 [0.7.9]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.9
 [0.7.8]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.8
 [0.7.7]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.7
@@ -1998,6 +2104,8 @@
 [0.7.2]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.2
 [0.7.1]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.1
 [0.7.0]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.0
+[0.6.18]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.18
+[0.6.17]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.17
 [0.6.16]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.16
 [0.6.15]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.15
 [0.6.14]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.14
@@ -2015,6 +2123,7 @@
 [0.6.2]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.2
 [0.6.1]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.1
 [0.6.0]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.0
+[0.5.26]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.26
 [0.5.25]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.25
 [0.5.24]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.24
 [0.5.23]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.23
@@ -2041,6 +2150,8 @@
 [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.41]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.41
+[0.4.40]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.40
 [0.4.39]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.39
 [0.4.38]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.38
 [0.4.37]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.37

data/README.md

@@ -548,6 +548,7 @@ Most project classes will inherit from `Git` which enables these tasks:
 | log             | log              | view between contain                                      |
 | merge           | merge            | commit no-commit send                                     |
 | pull            | pull             | origin remote all                                         |
+| push            | push             | origin remote commit all tags                             |
 | range-diff      | range-diff       | view between contain                                      |
 | rebase          | rebase           | branch onto send                                          |
 | remote          | remote           | add select                                                |
@@ -692,17 +693,15 @@ GIT_COUNT=50                 # list display limit
 | :--------- | :---------------- | :------------------------------------------------------------------ |
 | branch     | create            | TRACK=0,1,s F|FORCE                                                 |
 | branch     | move copy         | F|FORCE                                                             |
-| branch     | delete            | COUNT=n                                                             |
 | branch     | global            | SYNC                                                                |
-| checkout   | branch            | DETACH TRACK=s COUNT=n                                              |
+| checkout   | branch            | D|DETACH TRACK=s                                                    |
 | checkout   | detach            | REFLOG=1                                                            |
-| checkout   | track             | COUNT=n                                                             |
 | checkout   | global path       | HEAD=s PATHSPEC=s                                                   |
 | checkout   | *                 | F|FORCE MERGE                                                       |
 | clone      | *                 | DEPTH=n ORIGIN=s BRANCH=s REVISION=s BARE=1 LOCAL=0,1               |
 |            |                   | SINGLE_BRANCH=0,1 NO_CHECKOUT=1 NO_TAGS=1 QUIET=1                   |
 | commit     | amend             | F|FORCE                                                             |
-| commit     | *                 | UPSTREAM=s DRY_RUN EDIT=0 M|MESSAGE=s                               |
+| commit     | *                 | UPSTREAM|ORIGIN=s DRY_RUN EDIT=0 M|MESSAGE=s                        |
 | diff       | head branch       | INDEX=n                                                             |
 | diff       | *                 | PATHSPEC=s                                                          |
 | fetch      | -remote           | ALL                                                                 |
@@ -714,15 +713,16 @@ GIT_COUNT=50                 # list display limit
 | pull       | -remote           | REBASE=0,1 ALL                                                      |
 | pull       | all               | FF_ONLY=0                                                           |
 | pull       | *                 | AUTOSTASH F|FORCE RECURSE_SUBMODULES=0,1,s                          |
+| push       | all,tags          | ORIGIN=s                                                            |
 | range-diff | *                 | PATHSPEC=s                                                          |
 | rebase     | branch            | HEAD=s                                                              |
 | rebase     | onto              | INTERACTIVE I HEAD=s                                                |
 | reset      | mode (mixed)      | N REFRESH=0                                                         |
 | reset      | index             | PATHSPEC=s                                                          |
-| reset      | commit            | COUNT=n REFLOG=1                                                    |
+| reset      | commit            | REFLOG=1                                                            |
 | reset      | -commit           | HEAD=s                                                              |
 | restore    | *                 | PATHSPEC=s                                                          |
-| revbuild   | global            | UNTRACKED_FILES=s IGNORE_SUBMODULES=s IGNORED=s (status)            |
+| revbuild   | global (status)   | UNTRACKED_FILES=s IGNORE_SUBMODULES=s IGNORED=s                     |
 | 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                      |
@@ -730,14 +730,12 @@ GIT_COUNT=50                 # list display limit
 | switch     | detach            | REFLOG=1                                                            |
 | switch     | -detach           | HEAD=s                                                              |
 | switch     | *                 | F|FORCE                                                             |
-| tag        | add               | SIGN FORCE HEAD=s M|MESSAGE=s TRAILER=s                             |
-| tag        | sign              | F|FORCE HEAD=s M|MESSAGE=s TRAILER=s                                |
-| tag        | delete            | COUNT=n                                                             |
+| tag        | add sign          | F|FORCE HEAD=s M|MESSAGE=s TRAILER=s                                |
 | rev        | commit branch     | HEAD=s                                                              |
 
 ### Docker
 
-* Version: [29.1](https://docs.docker.com/engine/release-notes/29)
+* Version: [29.6](https://docs.docker.com/engine/release-notes/29)
 
 ```sh
 DOCKER_OPTIONS=q,no-cache                # all
@@ -747,6 +745,8 @@ DOCKER_TAG_${NAME}=v0.1.0                # project only (override)
 DOCKER_ALL=1                             # list every image/container
 DOCKER_Y=1                               # confirm all
 
+TAG_${NAME}=1.0.0                        # initialize
+
 BUILD_SQUARED_OPTS="NODE_TAG=24 RUBY_VERSION=4.0.0" DOCKER_SQUARED_OPTS="--no-cache --label=v1" rake squared:build
 docker build --no-cache --label=v1 --build-arg="NODE_TAG=24" --build-arg="RUBY_VERSION=4.0.0" .
 ```

data/lib/squared/common/base.rb

@@ -15,6 +15,7 @@ module Squared
       CHOICE: 25,
       QUOTE: "'",
       SPACE: ' => ',
+      SUCCESS: 'Success',
       GRAPH: %w[| - | \\ -].freeze,
       BORDER: %w[| - - - - - | | - -].freeze,
       VIEW: 'view',
@@ -91,6 +92,13 @@ module Squared
       VAR[key.is_a?(::String) ? key.to_sym : key] = val
     end
 
+    def __arg__(key, name = nil, &blk)
+      ret = ARG[key.to_sym]
+      return ret unless name && ret.is_a?(::Hash)
+
+      ret[name = name.downcase] || (block_given? ? ret.fetch(name.to_sym, &blk) : ret[name.to_sym])
+    end
+
     def __freeze__
       PATH.freeze
       ARG.freeze

data/lib/squared/common/format.rb

@@ -89,7 +89,8 @@ module Squared
             end
           else
             t = type.to_sym
-            if (c = __get__(:colors)[t] || __get__(:colors)[t.to_s.sub('bright_', '').to_sym])
+            c = __get__(:colors)[t] || __get__(:colors)[t.to_s.sub('bright_', '').to_sym]
+            if c
               if index == -1
                 s = wrap.call(s, [c])
               else

data/lib/squared/common/host.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'rake'
+
+module Squared
+  module Common
+    module Host
+      module_function
+
+      def windows?
+        !!Rake::Win32.windows?
+      end
+
+      def mri?
+        RUBY_ENGINE == 'ruby'
+      end
+
+      def docker?
+        !Dir['/.dockerenv', '/docker-*.{sh,d}'].empty?
+      end
+
+      def powershell?
+        return true if ENV['SHELL']&.end_with?(File.join('', 'pwsh'))
+        return false unless windows?
+
+        case ENV['TERM_PROGRAM']
+        when 'powershell.exe', 'vscode'
+          true
+        else
+          ENV.fetch('PSModulePath', '').split(';', 2).size > 1
+        end
+      end
+    end
+  end
+end

data/lib/squared/common/prompt.rb

@@ -55,19 +55,24 @@ module Squared
       end
 
       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)
+                 force: true, attempts: 3, timeout: 0, empty: nil)
         require 'timeout'
+        multiple = Array(multiple) if multiple.is_a?(::Numeric)
         if list
           grep &&= Array(grep).map { |val| Regexp.new(val) }
           items = list.each_with_object([]) do |val, out|
-            next if grep&.none? { |pat| pat.match?(line) }
+            next if grep&.none? { |pat| pat.match?(val) }
 
             out << val.to_s.chomp
             puts '%2d. %s' % [out.size, val]
           end
           max = items.size
-          raise ArgumentError, 'empty selection list' if max == 0
+          if max == 0
+            raise ArgumentError, 'empty selection list' unless empty
 
+            puts empty
+            exit 1
+          end
           min = grep ? 1 : [min, max].min
           if auto
             auto.times { puts } if auto.is_a?(::Numeric)
@@ -77,11 +82,11 @@ module Squared
               puts print_footer(border: border)
             end
             msg = "#{msg + (force ? ':' : '?')} [#{min}-#{max}#{if (n = multiple)
-                                                                  "|,#{n.is_a?(::Numeric) ? "{#{n}}" : '*'}"
+                                                                  "|,#{n.is_a?(::Array) ? "{#{n.join(',')}}" : '*'}"
                                                                 end}] "
           end
         end
-        between = ->(s) { s.match?(/^\d+$/) && s.to_i.between?(min, max) }
+        between = ->(s) { s.match?(/^\d+$/) && s.to_i.between?(min, max <= min ? Float::INFINITY : max) }
         Timeout.timeout(timeout) do
           while (ch = Prompt.reline.readline(msg))
             ch.strip!
@@ -106,7 +111,7 @@ module Squared
                 unless k.include?(nil)
                   k.uniq!
                   k.sort!
-                  unless multiple.is_a?(::Numeric) && multiple != k.size
+                  unless multiple.is_a?(::Array) && !multiple.include?(k.size)
                     return index || !items ? k : k.map { |i| items[i.pred] }
                   end
                 end

data/lib/squared/common/shell.rb

@@ -41,12 +41,12 @@ module Squared
 
           "#{$1}=%s" % if $2.include?(' ')
                          shell_quote($2, option: false)
-                       elsif Rake::Win32.windows?
+                       elsif windows?
                          $2
                        else
                          Shellwords.escape($2)
                        end
-        elsif Rake::Win32.windows?
+        elsif windows?
           quote ? shell_quote(val, force: force, double: double) : val
         else
           val.empty? ? '' : Shellwords.escape(val)
@@ -61,7 +61,7 @@ module Squared
         if val =~ QUOTE_VALUE
           if pass == '"' || pass == "'"
             return val if pass == $1
-          elsif pass || ($1 == '"' && Rake::Win32.windows? && val.match?(/([#{File::SEPARATOR} ]|\\")/o))
+          elsif pass || ($1 == '"' && windows? && val.match?(/([#{File::SEPARATOR} ]|\\")/o))
             return val
           end
           case preserve
@@ -74,7 +74,7 @@ module Squared
           end
         end
         q = -> { (base || val).gsub("'\\\\''", "'") }
-        if double || Rake::Win32.windows? || (ARG[:QUOTE] == '"' && !override)
+        if double || windows? || (ARG[:QUOTE] == '"' && !override)
           "\"#{q.call.gsub(/(?<!\\)"/, '\\"')}\""
         else
           "'#{q.call.gsub("'", "'\\\\''")}'"
@@ -82,7 +82,7 @@ module Squared
       end
 
       def shell_option(flag, val = nil, sep: '=', escape: true, quote: true, force: true, double: false, merge: false,
-                       switch: nil, override: false)
+                       switch: nil, explicit: false, override: false)
         flag = flag.to_s
         if flag =~ QUOTE_VALUE
           double = $1 == '"'
@@ -91,18 +91,15 @@ module Squared
           override = true
         end
         sep = unless flag.empty?
+                single = merge ? '' : explicit.is_a?(::String) ? explicit : ' '
                 if flag[0] == '-'
-                  if flag[1] == '-'
-                    sep
-                  else
-                    merge ? '' : ' '
-                  end
+                  flag[1] == '-' ? sep : single
                 elsif switch
                   pre = switch unless flag.start_with?(switch)
                   merge ? '' : sep
                 elsif flag.size == 1
                   pre = '-'
-                  merge ? '' : ' '
+                  single
                 else
                   pre = '--'
                   sep
@@ -164,7 +161,7 @@ module Squared
       def shell_bin(name, env: true)
         path = defined?(PATH) ? PATH : {}
         key = name.to_s.upcase
-        key = File.basename(key, '.*') if Rake::Win32.windows?
+        key = File.basename(key, '.*') if windows?
         shell_quote((env && ENV["PATH_#{key}"]) || path[key] || path[key.to_sym] || path[key = key.downcase] ||
                     path[key.to_sym] || name, option: false, force: false, double: true)
       end
@@ -187,6 +184,10 @@ module Squared
       def basic_option(flag, val, **kwargs)
         shell_option(flag, val, escape: false, force: false, **kwargs)
       end
+
+      def windows?
+        !!Rake::Win32.windows?
+      end
     end
   end
 end

data/lib/squared/common/utils.rb

@@ -105,18 +105,21 @@ module Squared
           time << "#{d}d"
           epoch -= d * dd
         end
-        if (h = epoch / hh) > 0
+        h = epoch / hh
+        if h > 0
           time << (clock ? h.to_s : "#{h}h")
           epoch -= h * hh
         end
-        if (m = epoch / mm) > 0
+        m = epoch / mm
+        if m > 0
           time << (clock ? m.to_s.rjust(2, '0') : "#{m}m")
           epoch -= m * mm
         elsif clock
           time << '00'
         end
         unless hm
-          if (s = epoch / ss) > 0
+          s = epoch / ss
+          if s > 0
             time << (clock ? s.to_s.rjust(2, '0') : "#{s}s")
             epoch -= s * ss
           elsif clock
@@ -144,7 +147,7 @@ module Squared
       end
 
       def env_key(*val)
-        val.join('_').gsub(/\W+/, '_').upcase
+        val.join('_').sub(/\A\d+\W*/, '__').gsub(/\W+/, '_').upcase
       end
 
       def env_bool(key, default = false, index: false, **kwargs)

data/lib/squared/common.rb

@@ -4,6 +4,7 @@ require 'set'
 
 require_relative 'common/base'
 require_relative 'common/format'
+require_relative 'common/host'
 require_relative 'common/prompt'
 require_relative 'common/shell'
 require_relative 'common/system'

data/lib/squared/config.rb

@@ -324,8 +324,7 @@ module Squared
           'yaml'
         when 'js'
           'json'
-        when ''
-          nil
+        when '' then nil
         else
           ret
         end

data/lib/squared/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Squared
-  VERSION = '0.8.2'
+  VERSION = '0.8.4'
 end

data/lib/squared/workspace/application.rb

@@ -5,6 +5,7 @@ module Squared
     class Application
       include Enumerable
       include Common::Format
+      include Host
       include Utils
       include Rake::DSL
 
@@ -13,8 +14,8 @@ module Squared
 
       class << self
         def implement(*objs, base: nil)
-          objs.each_with_index do |obj, index|
-            if base && index == 0
+          objs.each_with_index do |obj, i|
+            if base && i == 0
               case base
               when 0, true
                 @kind_extend[0] = obj
@@ -215,7 +216,7 @@ module Squared
             end
             raise 'method not found'
           rescue => e
-            warn log_message(Logger::WARN, e, subject: main, hint: hint || args)
+            warn log_warn(e, subject: main, hint: hint || args)
           end
         end
         @group = nil
@@ -740,30 +741,6 @@ module Squared
         !!find(home)&.enabled?
       end
 
-      def windows?
-        Rake::Win32.windows?
-      end
-
-      def mri?
-        RUBY_ENGINE == 'ruby'
-      end
-
-      def docker?
-        !Dir['/.dockerenv', '/docker-*.{sh,d}'].empty?
-      end
-
-      def powershell?
-        return true if ENV['SHELL']&.end_with?(File.join('', 'pwsh'))
-        return false unless windows?
-
-        case ENV['TERM_PROGRAM']
-        when 'powershell.exe', 'vscode'
-          true
-        else
-          ENV.fetch('PSModulePath', '').split(';', 2).size > 1
-        end
-      end
-
       def rootpath(*args)
         root.join(*args)
       end
@@ -797,6 +774,7 @@ module Squared
       end
 
       public :task_join
+      public(*Host.private_instance_methods(false))
 
       private