squared 0.8.1 → 0.8.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 258af4963cc0c6951fd5f14a96218cbb9cd3016714ba8b03d1fc016a7fb6d894
-  data.tar.gz: 58211867320953b6bd4c7fae463195e65590754369bd3cbb8896fd46e41f18d4
+  metadata.gz: 037121270d4c460552bc1b0c24580e95dc6d70c678ab2d82f3339567ab652c84
+  data.tar.gz: 7d7bdbb4164fe03ddfdc64ae0d5b0640cd6d688fa8660f0193399d816f418de1
 SHA512:
-  metadata.gz: 5f0026e471c3dcfd8f75eae152732a9ce7b12347f1e5a86464434adc1fbc4ea87e3fb627c456db49145ec534255155c1e3600c623159d4420e5ab0c5c33233d0
-  data.tar.gz: f692395f2fdc71738669010a392cbf5fe4793edc71b920dd7873748a97bc0e5bef8cc6e17d2af93ec16d92480b86b554204fd5f4a2ce04e52d2704988cb2b3a6
+  metadata.gz: f96c91ee8cc22e2b81159529e6037b72c07047d7b5fe86834f7fbcf4e89ad884141002d2e47bc121f04c1041a3eb8abc10514f79509e4ee83a1d561dad6d5155
+  data.tar.gz: 5984989ccad4013691a522196eaee92d047a1a2ab0636731952143fde8ac20b96ae9789fcde670586f46c474217443840bee1e22b54b8b49991cd3032717ef0d

data/CHANGELOG.md

@@ -1,5 +1,95 @@
 # 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
+
+- Docker client global options can be preconfigured for every session.
+- Docker command image action history was implemented.
+- NPM command install can bypass engines with ENV and engine-strict=false.
+
+### Changed
+
+- OptionPartition method uniq! parameter pass was converted into keyword.
+- Project global ENV for BANNER and STRICT can accept boolean values.
+- Series method exclude? parameter empty was converted into keyword.
+
+## [0.7.9] - 2026-07-04
+
+### Added
+
+- Docker command image action inspect was implemented.
+
+### Changed
+
+- Project global ENV for BANNER and STRICT can accept boolean values.
+
+## [0.6.16]
+
+### Added
+
+- Git command pull action all supports filter pattern negation.
+
+## [0.5.25]
+
+### Fixed
+
+- See `0.4.39`.
+
+## [0.4.39]
+
+### Changed
+
+- Common global argument OUT with a file separator overrides PIPE.
+
+### Fixed
+
+- Git output list results did not hide footer when banner was disabled.
+- Project banners which were empty were being printed.
+
 ## [0.8.1] - 2026-06-17
 
 ### Fixed
@@ -1938,8 +2028,12 @@
 
 - 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
 [0.7.6]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.6
@@ -1949,6 +2043,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.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
 [0.6.13]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.13
@@ -1965,6 +2061,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.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
 [0.5.22]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.22
@@ -1990,6 +2087,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.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
 [0.4.36]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.36

data/README.md

@@ -98,6 +98,7 @@ Workspace::Application
   .with(:docker, only: ["build", "compose"], hide: [:windows?]) do           # When true hide entire group (formerly pass 0.6.0)
     .add("squared", "docker", file: "Dockerfile", context: ".", tag: "latest", registry: "localhost:5000", username: "squared", # compose publish => { oci: "oci://docker.io" }
                               args: "--ssh=default",
+                              client: { config: '/home/user/.docker', tls: true },           # global options
                               secrets: ["id=github,env=GITHUB_TOKEN"],
                               mounts: ["src=.,dst=/project,ro,bind-propagation=rshared"]) do # Docker
       series(:clean) do                                                                      # run | depend | doc | lint | test | copy | clean
@@ -547,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                                                |
@@ -701,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                                                                 |
@@ -713,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                                                |
@@ -736,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
@@ -871,44 +874,44 @@ Features can be enabled through ENV when calling global tasks such as through *C
 
 * Prefix: BUNDLE/GEM/RBS
 
-| Command    | Flag      | ENV                                                         |
-| :--------- | :-------- | :---------------------------------------------------------- |
-| depend     | -         | BINSTUBS=s JOBS=n                                           |
-| depend     | update    | VERSION=major|minor|patch STRICT CONSERVATIVE               |
-| outdated   | -         | U|UPDATE=major|minor|patch ONLY_EXPLICIT DRY_RUN            |
-| gem        | outdated  | DOCUMENT=0,1 USER_INSTALL=0,1                               |
-| rbs        | prototype | Y=0,1                                                       |
+| Command    | Flag      | ENV                                                                  |
+| :--------- | :-------- | :------------------------------------------------------------------- |
+| depend     | -         | BINSTUBS=s JOBS=n                                                    |
+| depend     | update    | VERSION=major|minor|patch STRICT CONSERVATIVE                        |
+| outdated   | -         | U|UPDATE=major|minor|patch ONLY_EXPLICIT DRY_RUN                     |
+| gem        | outdated  | DOCUMENT=0,1 USER_INSTALL=0,1                                        |
+| rbs        | prototype | Y=0,1                                                                |
 
 #### Node
 
 * Prefix: NPM/PNPM/YARN
 
-| Command        | Flag           | ENV                                                |
-| :------------- | :------------- | :------------------------------------------------- |
-| depend         | -              | FORCE CI IGNORE_SCRIPTS                            |
-| outdated       | -              | U|UPDATE=major|minor|patch SAVE_EXACT DIFF DRY_RUN |
-| publish        | -              | OTP=s TAG=s ACCESS=0,1,s DRY_RUN Y                 |
-| depend package | *              | PACAKGE_LOCK|LOCKFILE=0 NO_LOCKFILE=1 Y            |
-| npm            | depend         | APPROVE_SCRIPTS=s                                  |
-| npm            | package        | SAVE IGNORE_SCRIPTS STRICT_PEER_DEPS               |
-| pnpm           | depend         | PUBLIC_HOIST_PATTERN=s APPROVE_BUILDS              |
-| pnpm           | depend:add     | ALLOW_BUILD=s                                      |
-| yarn           | depend package | IGNORE_ENGINES                                     |
-| yarn           | depend:add     | W|IGNORE_WORKSPACE_ROOT_CHECK=0                    |
-| npm pnpm       | depend package | CPU=s OS=s LIBC=s                                  |
+| Command        | Flag           | ENV                                                         |
+| :------------- | :------------- | :---------------------------------------------------------- |
+| depend         | -              | FORCE CI IGNORE_SCRIPTS                                     |
+| outdated       | -              | U|UPDATE=major|minor|patch SAVE_EXACT DIFF DRY_RUN          |
+| publish        | -              | OTP=s TAG=s ACCESS=0,1,s DRY_RUN Y                          |
+| depend package | *              | PACAKGE_LOCK|LOCKFILE=0 NO_LOCKFILE=1 Y                     |
+| npm            | depend         | APPROVE_SCRIPTS=0,1,s ALLOW_SCRIPTS=0,1,s ENGINE_STRICT=0,1 |
+| npm            | package        | SAVE IGNORE_SCRIPTS STRICT_PEER_DEPS                        |
+| pnpm           | depend         | PUBLIC_HOIST_PATTERN=s APPROVE_BUILDS                       |
+| pnpm           | depend:add     | ALLOW_BUILD=s                                               |
+| yarn           | depend package | IGNORE_ENGINES                                              |
+| yarn           | depend:add     | W|IGNORE_WORKSPACE_ROOT_CHECK=0                             |
+| npm pnpm       | depend package | CPU=s OS=s LIBC=s                                           |
 
 #### Python
 
 * Prefix: PIP/POETRY
 
-| Command    | Flag      | ENV                                                         |
-| :--------- | :-------- | :---------------------------------------------------------- |
-| global     | *         | CACHE_DIR=0,s PROXY=s PYTHON=s COLOR=0                      |
-| depend     | -         | E|EDITABLE=0,s BUILD_ISOLATION=0                            |
-| outdated   | -         | U|UPDATE=major|minor|patch NOT_REQUIRED=0 L|LOCAL DRY_RUN   |
-| venv       | exec      | INTERACTIVE=0                                               |
-| poetry     | *         | PROJECT=s                                                   |
-| poetry     | depend    | NO_ROOT                                                     |
+| Command    | Flag      | ENV                                                                  |
+| :--------- | :-------- | :------------------------------------------------------------------- |
+| global     | *         | CACHE_DIR=0,s PROXY=s PYTHON=s COLOR=0                               |
+| depend     | -         | E|EDITABLE=0,s BUILD_ISOLATION=0                                     |
+| outdated   | -         | U|UPDATE=major|minor|patch NOT_REQUIRED=0 L|LOCAL DRY_RUN            |
+| venv       | exec      | INTERACTIVE=0                                                        |
+| poetry     | *         | PROJECT=s                                                            |
+| poetry     | depend    | NO_ROOT                                                              |
 
 ## LICENSE
 

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/common/utils.rb

@@ -166,11 +166,19 @@ module Squared
       end
 
       def env_pipe(key, default = 1, root: nil, **kwargs)
+        out = 1
         case key
         when ::String
           case (ret = env_value(key, **kwargs))
           when '0', '1', '2'
             return ret.to_i
+          else
+            out = default if default.is_a?(::Numeric)
+            if ret.include?(File::SEPARATOR)
+              default = ret
+            elsif key.include?(File::SEPARATOR)
+              default = key
+            end
           end
         when ::Numeric
           return key if key.between?(0, 2)
@@ -181,7 +189,7 @@ module Squared
           (root ? Pathname.new(root) + default : Pathname.new(default)).realdirpath
         rescue => e
           warn e
-          1
+          out
         end
       end
 

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.1'
+  VERSION = '0.8.3'
 end

data/lib/squared/workspace/application.rb

@@ -115,7 +115,13 @@ module Squared
         @stage = Support.hashlist
         self.home = home
         self.exception = env_bool exception
-        self.pipe = $DEBUG ? 2 : env_pipe(pipe, (ARG[:OUT] && env(ARG[:OUT])) || 1, root: home)
+        self.pipe = if $DEBUG
+                      2
+                    elsif (out = ARG[:OUT]) && out.include?(File::SEPARATOR)
+                      env_pipe(out, pipe, root: home)
+                    else
+                      env_pipe(pipe, (out && env(out)) || 1, root: home)
+                    end
         self.verbose = if $VERBOSE.nil?
                          false
                        elsif verbose.nil?

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
@@ -1612,7 +1624,7 @@ module Squared
             append_keys(kwargs, b, :opts)
             with.concat(c)
           end
-          OptionPartition.uniq!(args, pass) if pass
+          OptionPartition.uniq!(args, pass: pass) if pass
           [args, kwargs, with]
         end
 
@@ -1633,7 +1645,7 @@ module Squared
           end
           if args
             args.unshift(*a)
-            OptionPartition.uniq!(args, pass) if pass
+            OptionPartition.uniq!(args, pass: pass) if pass
           end
           kwargs&.update(b) { |_, obj| obj }
           nil
@@ -1703,7 +1715,13 @@ module Squared
             ret += 1
             break out if first
           end
-          print_item banner, lines if banner && (ret > 0 || (!pass && !first))
+          if banner && (ret > 0 || (!pass && !first))
+            if banner.empty?
+              print_item(*lines)
+            else
+              print_item(banner, *lines)
+            end
+          end
           ret
         end
 
@@ -1729,7 +1747,7 @@ module Squared
         end
 
         def print_run(cmd, banner = true, verbose: nil, **)
-          return if banner || !stdout? || verbose == false || env('BANNER', equals: '0')
+          return if banner || !stdout? || verbose == false || env('BANNER', equals: %w[0 false])
 
           puts "\n> #{cmd}"
           printsucc
@@ -1738,7 +1756,7 @@ module Squared
         def print_item(*val, series: false)
           puts unless printfirst?
           printsucc unless series
-          puts val unless val.empty? || (val.size == 1 && !val.first)
+          puts val unless val.empty? || (val.size == 1 && (!val.first || val.first.empty?))
         end
 
         def print_banner(*lines, client: false, styles: theme[:banner], border: borderstyle)
@@ -1902,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
@@ -2086,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
@@ -2701,7 +2719,16 @@ module Squared
         end
 
         def banner?
-          ARG[:BANNER] && env('BANNER', notequals: '0')
+          case (val = env('BANNER', ignore: false))
+          when '0', 'false'
+            false
+          else
+            !val.nil? || ARG[:BANNER]
+          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?
@@ -2736,7 +2763,12 @@ module Squared
         end
 
         def strict?
-          (ARG[:STRICT] || exception?(Logger::FATAL)) && env('STRICT', notequals: '0')
+          case (val = env('STRICT', ignore: false))
+          when '0', 'false'
+            false
+          else
+            !val.nil? || ARG[:STRICT] || exception?(Logger::FATAL)
+          end
         end
 
         def serve?