squared 0.8.2 → 0.8.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53991d0e40acab903d9e2715fcc37a2f69853bcbc25ba610c04c1a7331ac865c
-  data.tar.gz: fa4913add4c429e7bbceda66f75721af58620b54549591a911bb7b4b4081e913
+  metadata.gz: 037121270d4c460552bc1b0c24580e95dc6d70c678ab2d82f3339567ab652c84
+  data.tar.gz: 7d7bdbb4164fe03ddfdc64ae0d5b0640cd6d688fa8660f0193399d816f418de1
 SHA512:
-  metadata.gz: 5a81aadedff0d5e4288879f31f80aa0cc3c1d2997958278e0724067da6faa0452223660829870349334d35f37d6936b6ea83313c76981f67b5d095a3f8f85202
-  data.tar.gz: 84a885286b2abad87cd7b381e1fb2b71c0f7619b0486b6647b5b766eccae2fc8bb9ae845853f42115ff019e10b9d15e225b4f19d480288b9b9d194a4730b2fd3
+  metadata.gz: f96c91ee8cc22e2b81159529e6037b72c07047d7b5fe86834f7fbcf4e89ad884141002d2e47bc121f04c1041a3eb8abc10514f79509e4ee83a1d561dad6d5155
+  data.tar.gz: 5984989ccad4013691a522196eaee92d047a1a2ab0636731952143fde8ac20b96ae9789fcde670586f46c474217443840bee1e22b54b8b49991cd3032717ef0d

data/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## [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]
+
+### Added
+
+- NPM command install can bypass engines with ENV and engine-strict=false.
+
+### 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 +2028,11 @@
 
 - Changelog was created.
 
+[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.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 +2043,7 @@
 [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.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
@@ -2041,6 +2087,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.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                                                |
@@ -702,7 +703,7 @@ GIT_COUNT=50                 # list display limit
 | 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,6 +715,7 @@ 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                                                |
@@ -737,7 +739,7 @@ GIT_COUNT=50                 # list display limit
 
 ### 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

data/lib/squared/common/base.rb

@@ -91,6 +91,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/prompt.rb

@@ -55,19 +55,23 @@ 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'
         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)
@@ -81,7 +85,7 @@ module Squared
                                                                 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!

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.3'
 end

data/lib/squared/workspace/project/base.rb

@@ -1175,6 +1175,18 @@ module Squared
           ret
         end
 
+        def emptypath(val, create: true)
+          ret = basepath(val).realdirpath
+          if ret.exist?
+            raise Errno::EEXIST, message(val, hint: 'not empty') unless ret.directory? && ret.empty?
+
+            ret.rmdir unless create
+          elsif create
+            ret.mkpath
+          end
+          ret
+        end
+
         def localname
           workspace.task_localname(name)
         end
@@ -1556,7 +1568,7 @@ module Squared
         def env(key, default = nil, suffix: nil, strict: false, ignore: nil, **kwargs, &blk)
           name = "#{key}_#{envname_get}"
           ret = if suffix
-                  ENV.fetch("#{name}_#{suffix}", '')
+                  ENV["#{name}_#{suffix}"] || (ignore == false && ENV["#{key}_#{suffix}"]) || ''
                 elsif strict
                   ENV[name].to_s
                 else
@@ -1908,7 +1920,7 @@ module Squared
         end
 
         def append_hash(data, target: @session || [], build: false)
-          if build && (type = env('BUILD', suffix: 'TYPE') || ENV['BUILD_TYPE'])
+          if build && (type = env('BUILD', suffix: 'TYPE', ignore: false))
             if (extra = data[type = "__#{type}__"] || data[type.to_sym]).is_a?(Hash)
               data = data.merge(extra)
             else
@@ -2092,8 +2104,8 @@ module Squared
           args
         end
 
-        def confirm_basic(msg, hint, accept = 'Y', style: :inline, target: @session, prefix: nil, **kwargs)
-          return true if prefix ? option('y', prefix: prefix) : target && option('y', target: target)
+        def confirm_basic(msg, hint, accept = 'Y', style: :inline, target: @session, prefix: target&.first, **kwargs)
+          return true if option('y', prefix: prefix)
 
           confirm("#{msg} [#{sub_style(hint.to_s, style.is_a?(Symbol) ? theme[style] : style)}]", accept, **kwargs)
         end
@@ -2715,6 +2727,10 @@ module Squared
           end
         end
 
+        def dryrun?(target: @session, prefix: target&.first, **)
+          Array(target).include?('--dry-run') || !option('dry-run', target: target, prefix: prefix).nil?
+        end
+
         def pwd?
           path == Pathname.pwd
         end

data/lib/squared/workspace/project/docker.rb

@@ -13,11 +13,11 @@ module Squared
           buildx: {
             common: %w[builder=b D|debug],
             build: %w[add-host=q annotation=q attest=q build-arg=qq build-context=qq cache-from=q cache-to=q
-                      cgroup-parent=b iidfile=p label=q network=b no-cache-filter=b o|output=q platform=q
-                      q|quiet secret=qq shm-size=b ssh=qq t|tag=b target=b ulimit=q].freeze,
-            bake: %w[print list=q set=q].freeze,
-            shared: %w[check load no-cache pull push allow=q call=b? f|file=p metadata-file=p progress=b provenance=q
-                       sbom=q].freeze
+                      cgroup-parent=b iidfile=p label=q network=b no-cache-filter=b o|output=q platform=q q|quiet
+                      resource=q secret=qq shm-size=b ssh=qq t|tag=b target=b ulimit=q].freeze,
+            bake: %w[print list=q set=qq var=qq].freeze,
+            shared: %w[check load no-cache pull push allow=q call=b? f|file=p metadata-file=p policy=q progress=b
+                       provenance=q sbom=q].freeze
           }.freeze,
           compose: {
             common: %w[all-resources ansi=b compatibility dry-run env-file=p f|file=p parallel=n profile=b progress=b
@@ -34,7 +34,8 @@ module Squared
                    quiet-pull remove-orphans V|renew-anon-volumes timestamps wait w|watch y|yes attach=b
                    exit-code-from=b no-attach=b pull=b scale=i t|timeout=i wait-timeout=i].freeze,
             down: %w[remove-orphans v|volumes rmi=b t|timeout=i].freeze,
-            publish: %w[app resolve-image-digests with-env y|yes oci-version=b].freeze
+            publish: %w[app resolve-image-digests with-env y|yes oci-version=b].freeze,
+            logs: %w[dry-run f|follow no-color no-log-prefix t|timestamps index=i since=q n|tail=b until=q].freeze
           }.freeze,
           container: {
             create: %w[init i|interactive no-healthcheck oom-kill-disable privileged P|publish-all q|quiet read-only
@@ -55,7 +56,8 @@ module Squared
                        restart=q].freeze,
             exec: %w[d|detach i|interactive privileged t|tty detach-keys=q e|env=qq env-file=p u|user=e
                      w|workdir=q].freeze,
-            commit: %w[no-pause a|author=q c|change=q m|message=q pause=b?].freeze,
+            commit: %w[no-pause a|author=q c|change=q m|message=q].freeze,
+            logs: %w[details f|follow t|timestamps since=q n|tail=b until=q].freeze,
             inspect: %w[s|size f|format=q].freeze,
             start: %w[a|attach i|interactive detach-keys=q].freeze,
             stop: %w[s|signal=b t|timeout=i].freeze,
@@ -115,10 +117,10 @@ module Squared
 
         subtasks({
           'build' => %i[tag context].freeze,
-          'compose' => %i[build create publish run exec up down service].freeze,
+          'compose' => %i[build create publish run exec up down logs service].freeze,
           'bake' => %i[build compose check].freeze,
           'image' => %i[ls rm pull push tag save inspect history].freeze,
-          'container' => %i[attach commit create diff exec inspect kill pause restart rm run start stats stop top
+          'container' => %i[attach commit create diff exec logs top inspect kill pause restart rm run start stats stop
                             unpause update].freeze,
           'network' => %i[connect disconnect create].freeze,
           'ls' => nil
@@ -299,7 +301,11 @@ module Squared
                           end
                         end
                       else
-                        format_desc action, flag, "opts*,id/name#{flag == :update || flag == :inspect ? '+' : '*'}"
+                        format_desc action, flag, "opts*,id/name#{case flag
+                                                                  when :stats then '*'
+                                                                  when :logs, :diff, :attach, :top then nil
+                                                                  else '+'
+                                                                  end}"
                         task flag do |_, args|
                           container flag, args.to_a
                         end
@@ -411,11 +417,9 @@ module Squared
             when String
               ret << quote_option('secret', @secrets, double: true)
             when Hash
-              append = lambda do |key|
+              %i[file env].each do |key|
                 ret.merge(Array(@secrets[key]).map { |arg| quote_option('secret', "type=#{key},#{arg}", double: true) })
               end
-              append.call(:file)
-              append.call(:env)
             else
               ret.merge(Array(@secrets).map { |arg| quote_option('secret', arg) })
             end
@@ -443,7 +447,7 @@ module Squared
             .parse(data[flag == :bake ? :bake : :build] + (shared || data[:shared]))
           case flag
           when :build, :context
-            append_tag(tag || option('tag', ignore: false) || self.tag)
+            append_tag tag || option('tag', ignore: false) || self.tag
             if shared
               op.add_quote(context, preserve: false)
             else
@@ -460,7 +464,7 @@ module Squared
                 context = basepath context
                 op.each { |name| op.add_option('set', "#{name}.context=#{context}", escape: false) }
               end
-              op.append(escape: true, strip: /^:/, clear: true)
+              op.append(escape: true, strip: ':', clear: true)
             end
           end
           op.clear(pass: false)
@@ -502,7 +506,7 @@ module Squared
               end
               if multiple
                 op.concat(service) if service
-                op.append(delim: true, escape: true, strip: /^:/)
+                op.append(delim: true, escape: true, strip: ':')
               else
                 raise ArgumentError, message('no service was selected', hint: flag) unless service
 
@@ -570,7 +574,7 @@ module Squared
           when :update, :inspect
             raise ArgumentError, message('missing container', hint: flag) if op.empty?
 
-            op.append(escape: true, strip: /^:/)
+            op.append(escape: true, strip: ':')
           when :commit
             latest = op.shift || tagmain
             cmd << id << latest
@@ -600,7 +604,17 @@ module Squared
               end
               return
             end
-            op.append(escape: true, strip: /^:/)
+            case flag
+            when :logs, :diff, :attach, :top
+              op.add_first(escape: true, strip: ':')
+              if flag == :top
+                op.append(delim: true)
+              else
+                op.clear
+              end
+            else
+              op.append(escape: true, strip: ':')
+            end
           end
           run(from: from)
         end
@@ -691,10 +705,10 @@ module Squared
             raise ArgumentError, message('missing image', hint: flag) if op.empty?
 
             if flag == :history
-              op.add_first(escape: true, strip: /^:/)
+              op.add_first(escape: true, strip: ':')
                 .clear
             else
-              op.append(escape: true, strip: /^:/)
+              op.append(escape: true, strip: ':')
             end
           end
           success?(run(sync: sync, exception: exception, banner: banner, from: from), flag == :tag || flag == :save)