squared 0.4.19 → 0.4.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7768e317ba03b32b5b8efeede15034c9c1c6bff1e6bca94e48119236a9647de4
-  data.tar.gz: 592bca71ea7b863bfdbd8896e429688b1d7b38941e7eee14388eb868f6065486
+  metadata.gz: 4d8a1b2cbf68268501ff6e6d0c93376a695f65d5d39f3e54d51fc3782869080a
+  data.tar.gz: d79358deea9e25c69c7c1e43730109b9609bb52949b367f457c972166da38485
 SHA512:
-  metadata.gz: 2eb5c090afe6a6514fa4f579e41f2f3136720cf4279d4d0464df8828e88b150e15245e5b69395abfe5af2b33f5850ca6ca9c379bd8970c4fd1e54125688e365e
-  data.tar.gz: 5f537d9f3eb00dcfe5786092cf6752393a80b8caba758152a53e65e05f6222b89fd87959d094f2b9b1677cc4a65380ac3ade95dd204239fb5c51ab789bf1d6b4
+  metadata.gz: 40f3aca8a6df314ce47bfceb7df8c4dffd00a8c05953d4e68ee104f6f33bd15ec8dfcf4d12bc23490d545982376cad0fb4aa17797d3340e120f88ef55907fcfa
+  data.tar.gz: 24833ff7f8fc10a50760959bf421371049256df809bcf9a2fe742a3d2faf4f8608cb560cefc8cae7c40eabfcc3dbf579de03f46c836f6057a2d74266329ce75f

data/CHANGELOG.md

@@ -1,5 +1,51 @@
 # Changelog
 
+## [0.4.21] - 2025-10-01
+
+### Added
+
+- Project base method variable_set was aliased to the name apply.
+
+### Changed
+
+- Project base method run visibility was changed to public.
+- OptionPartition method uniq! returns self or nil.
+
+### Fixed
+
+- Docker attribute file did not search for nearest config.
+- Project task run did not accept Proc or Method definitions.
+- Gem command options were revalidated to 3.7.2.
+- Bundler command options were revalidated to 2.7.2.
+- Ruby class method bundle did not pass through commands.
+- Ruby task ruby did not separate options and arguments.
+- Pip commands uninstall and freeze did not filter options.
+- Ruby command gem action update did not append packages.
+- OptionPartition did not detect short options with a merged value.
+- Gem commands option version did not use quotes.
+- Git command pull action all used undefined delete_prefix! method.
+- OptionPartition did not delete added values from extras.
+- Python editable projects can override requirements detection.
+- Project session method did delete short options with a merged value.
+- Gem command install did not try to resolve local paths.
+- Ruby commands did not always check for file target exists.
+
+## [0.4.20] - 2025-09-14
+
+### Changed
+
+- Project banners when requested return consistent arguments.
+
+### Fixed
+
+- Workspace global as command alias used undefined parameter.
+- Python did not separate dependency manager and build backend.
+- Gem command build did not validate gemspec was located.
+- Project class Ruby used glob methods not available in Ruby 2.4.
+- Shell options support using boolean as values.
+- Git command merge action commit failed when using interactive menu.
+- NPM command line options did not support boolean flags.
+
 ## [0.4.19] - 2025-08-30
 
 ### Added
@@ -946,6 +992,8 @@
 
 - Changelog was created.
 
+[0.4.21]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.21
+[0.4.20]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.20
 [0.4.19]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.19
 [0.4.18]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.18
 [0.4.17]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.17-ruby

data/README.md

@@ -105,9 +105,9 @@ Workspace::Application
     revbuild(include: %w[src/ framework/ types/])                            # Synchronous is recommended
   end
   .add("squared/sqd", exclude: :git, pass: [:node, "checkout", "bump"]) do   # Skip initialize(:node) + squared:checkout:* + squared:bump:*
-    variable_set :script, "build:sqd"                                        # Override detection
-    variable_set :depend, false
-    variable_set :clean, ["build/sqd/"]
+    apply :script, "build:sqd"                                               # Override detection
+    apply :depend, false                                                     #
+    apply :clean, ["build/sqd/"]                                             # variable_set (alias)
   end
   .with(:docker, only: ["build", "compose"]) do
     .add("squared", "docker", file: "Dockerfile", context: ".", tag: "latest", registry: "localhost:5000", username: "squared",
@@ -303,7 +303,7 @@ Workspace::Application
     doc(windows? ? ".\make.bat html" : "make html")                            # rake android-docs:doc | rake doc:python
     add("android-docs", "android", venv: "/home/user/.venv")                   # rake android-docs:depend
     add("chrome-docs", "chrome", graph: "android", venv: %w[.venv --clear]) do # /workspaces/chrome-docs/.venv
-      variable_set :dependindex, 1                                             # Use Poetry for dependencies (optional)
+      apply :dependindex, 1                                                    # Use Poetry for dependencies (optional)
     end
   end
   .with(:node) do
@@ -495,22 +495,23 @@ Most project classes will inherit from `Git` which enables these tasks:
 
 | Task       | Git              |  Command                                      |
 | :--------- | :--------------- | :-------------------------------------------- |
-| branch     | branch           | create set delete move copy list edit current |
+| branch     | branch           | create track delete move copy list current    |
 | checkout   | checkout         | commit branch track detach path               |
 | commit     | commit           | add all amend amend-orig fixup                |
-| diff       | diff             | head cached branch files between contain      |
+| diff       | diff             | head branch files view between contain        |
 | fetch      | fetch            | origin remote all                             |
 | files      | ls-files         | cached modified deleted others                |
-| git        |                  | add blame clean mv rm revert status           |
+| git        |                  | add blame clean mv revert rm status           |
+| log        | log              | view between contain                          |
 | merge      | merge            | commit no-commit send                         |
 | pull       | pull             | origin remote all                             |
 | rebase     | rebase           | branch onto send                              |
 | refs       | ls-remote --refs | heads tags remote                             |
-| reset      | reset            | commit index patch mode                       |
-| restore    | restore          | staged worktree                               |
-| rev        | rev              | commit output                                 |
-| show       | show             | format oneline                                |
-| stash      | stash            | push pop apply branch drop clear list all     |
+| reset      | reset            | commit index patch mode undo                  |
+| restore    | restore          | source staged worktree                        |
+| rev        | rev              | commit build output                           |
+| show       | show             | format oneline textconv                       |
+| stash      | stash            | push pop apply branch drop clear list         |
 | submodule  | submodule        | status update branch url sync                 |
 | switch     | switch           | branch create detach                          |
 | tag        | tag              | add sign delete list                          |
@@ -597,6 +598,9 @@ BUILD_${NAME}_VERSION=0.1.0  # publish + detection
 BANNER=0                     # hide banner
 BANNER_${NAME}=0             #
 
+VERBOSE=0                    # console output level
+VERBOSE_${NAME}=0            # 0,1,2,n
+
 REVBUILD_FORCE=1             # Rebuild all targets
 REVBUILD_FORCE_${NAME}=1     # Rebuild project
 
@@ -639,7 +643,7 @@ GIT_AUTOSTASH_${NAME}=0     # rebase (project only)
 | :--------- | :---------------- | :-------------------------------------------------------------------- |
 | branch     | create            | TRACK=0,1,s F|FORCE                                                   |
 | branch     | move copy         | F|FORCE                                                               |
-| branch     | set delete        | COUNT=n                                                               |
+| branch     | delete            | COUNT=n                                                               |
 | branch     | global            | SYNC                                                                  |
 | checkout   | branch            | DETACH TRACK=s COUNT=n                                                |
 | checkout   | detach            | REFLOG=1                                                              |

data/lib/squared/common/format.rb

@@ -189,7 +189,7 @@ module Squared
           emphasize(args, title: title + (subject ? " #{subject}" : ''), sub: sub, pipe: -1)
         else
           msg = [log_title(level, color: color)]
-          msg << (color ? sub_style(subject, styles: (@theme && @theme[:subject]) || :bold) : subject) if subject
+          msg << (color ? sub_style(subject.to_s, styles: (@theme && @theme[:subject]) || :bold) : subject) if subject
           msg << args.shift if msg.size == 1
           message(msg.join(' '), *args, hint: hint)
         end
@@ -223,12 +223,8 @@ module Squared
       def emphasize(val, title: nil, footer: nil, right: false, cols: nil, sub: nil, pipe: nil,
                     border: @theme && @theme[:border])
         n = 0
-        max = ->(v) { n = [n, v.max_by(&:size).size].max }
-        set = lambda do |v|
-          ret = as_a(v, :to_s)
-          max.call(ret)
-          ret
-        end
+        max = ->(a) { n = [n, a.max_by(&:size).size].max }
+        set = ->(s) { Array(s).map(&:to_s).tap { |a| max.call(a) } }
         title &&= set.call(title)
         footer &&= set.call(footer)
         if val.is_a?(::Array)

data/lib/squared/common/shell.rb

@@ -74,7 +74,7 @@ module Squared
           a = '--'
           b = '='
         end
-        "#{a}#{flag}#{if val
+        "#{a}#{flag}#{unless val.nil?
                         "#{b}#{if escape
                                  shell_escape(val, quote: quote, double: double, override: override)
                                elsif quote
@@ -94,8 +94,8 @@ module Squared
 
       def shell_bin(name, env: true)
         key = name.upcase
-        shell_quote((env && ENV["PATH_#{key}"]) || PATH[key] || PATH[key.to_sym] || name,
-                    option: false, force: false)
+        shell_quote((env && ENV["PATH_#{key}"]) || PATH[key] || PATH[key.to_sym] || name, option: false, force: false,
+                                                                                          double: true)
       end
 
       def fill_option(val, **kwargs)

data/lib/squared/common/system.rb

@@ -61,10 +61,9 @@ module Squared
               files.clear
               items.each do |file|
                 if file.exist?
-                  if file.symlink?
-                    next unless force
-                  else
+                  if !file.symlink?
                     files << file
+                  elsif !force
                     next
                   end
                 end

data/lib/squared/config.rb

@@ -213,7 +213,7 @@ module Squared
             ext[0] = mime
           elsif file
             keys.unshift(file)
-            alt = basepath("#{main}.{#{ext.join(',')}}")
+            alt = basepath "#{main}.{#{ext.join(',')}}"
             file = Dir[alt].first
           else
             alt = main
@@ -346,8 +346,8 @@ module Squared
         basepath(file = main + @ext).to_s rescue file
       end
 
-      def basepath(file)
-        project ? project.basepath(file) : Pathname.new(file).realdirpath
+      def basepath(*args)
+        project ? project.basepath(*args) : Pathname.pwd.join(*args)
       end
     end
   end

data/lib/squared/version.rb

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

data/lib/squared/workspace/application.rb

@@ -629,7 +629,9 @@ module Squared
       end
 
       def home?
-        !(proj = find(home)).nil? && proj.enabled?
+        return false unless (proj = find(home))
+
+        proj.enabled?
       end
 
       def windows?

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

@@ -9,6 +9,7 @@ module Squared
   module Workspace
     module Project
       class Base
+        include Comparable
         include Common::Format
         include System
         include Shell
@@ -16,7 +17,6 @@ module Squared
         include Utils
         include Support
         include Rake::DSL
-        include ::Comparable
 
         VAR_SET = %i[parent global script index envname desc dependfile dependindex theme archive env dev prod graph
                      pass only exclude].freeze
@@ -83,6 +83,7 @@ module Squared
           @name = name.to_s.freeze
           @project = @path.basename.to_s.freeze
           @group = group&.to_s.freeze
+          @envname = env_key(@name).freeze
           @depend = kwargs[:depend]
           @doc = kwargs[:doc]
           @lint = kwargs[:lint]
@@ -98,7 +99,7 @@ module Squared
           @ref = []
           @children = []
           @events = hashobj.update({ first: first, last: last, error: error })
-          @envname = env_key(@name).freeze
+          @as = hashobj
           @desc = (@name.include?(':') ? @name.split(':').join(ARG[:SPACE]) : @name).freeze
           @parent = nil
           @global = false
@@ -195,7 +196,7 @@ module Squared
             file &&= @workspace.home.join(env('LOG_DIR', ''), file).realdirpath
           rescue StandardError => e
             file = nil
-            warn log_message(Logger::WARN, e) if warning?
+            print_error e
           end
           log[:progname] ||= @name
           if (val = env('LOG_LEVEL', ignore: false))
@@ -287,7 +288,7 @@ module Squared
         end
 
         def verbose=(val)
-          @verbose = case val
+          @verbose = case (val = env('VERBOSE', val))
                      when NilClass
                        workspace.verbose
                      when String
@@ -362,7 +363,7 @@ module Squared
                       else
                         force = args.fetch(:force, false)
                       end
-                      unpack(path + dir, uri: tag, digest: digest, ext: ext, force: force)
+                      unpack(basepath(dir), uri: tag, digest: digest, ext: ext, force: force)
                     end
                   end
                 end
@@ -410,7 +411,6 @@ module Squared
           kwargs[:group] = group unless kwargs.key?(:group)
           kwargs[:ref] = ref unless kwargs.key?(:ref)
           parent = self
-          proj = nil
           name = case name
                  when String, Symbol
                    name.to_s
@@ -419,10 +419,9 @@ module Squared
                  end
           workspace.add(path, name, **kwargs) do
             __send__ :parent_set, parent
-            proj = self
+            @children << self
+            instance_eval(&blk) if block_given?
           end
-          @children << proj
-          proj.instance_eval(&blk) if block_given?
           self
         end
 
@@ -436,7 +435,7 @@ module Squared
 
           out = obj.link(self, *args, **kwargs, &blk) if obj.respond_to?(:link)
           if !out
-            warn log_message(Logger::WARN, 'link not compatible', subject: obj.to_s, hint: name)
+            print_error('link not compatible', subject: obj, hint: name)
           elsif out.respond_to?(:build)
             out.build
           end
@@ -476,7 +475,7 @@ module Squared
               else
                 next unless respond_to?(:compose)
 
-                cmd << a if (a = compose(as_get(b), d, script: true, args: e, from: from))
+                cmd << a if (a = compose(as_get(b, from), d, script: true, args: e, from: from))
               end
               var.merge!(c) if c.is_a?(Hash)
             end
@@ -484,8 +483,12 @@ module Squared
           else
             cmd, opts, var, flags, extra = args
           end
+          if cmd.is_a?(Proc) || cmd.is_a?(Method)
+            run_b(cmd, sync: sync, from: from)
+            return
+          end
           if cmd
-            cmd = as_get cmd
+            cmd = as_get(cmd, from)
             opts = compose(opts, script: false) if opts && respond_to?(:compose)
             flags = append_hash(flags).join(' ') if flags.is_a?(Hash)
             case opts
@@ -502,7 +505,7 @@ module Squared
           else
             return unless (opts || extra) && respond_to?(:compose)
 
-            cmd = compose(as_get(opts), flags, script: true, args: extra, from: from)
+            cmd = compose(as_get(opts, from), flags, script: true, args: extra, from: from)
             from = :script if from == :run && script?
           end
           run(cmd, var, sync: sync, from: from, banner: banner)
@@ -527,7 +530,7 @@ module Squared
                     on_error(:prereqs, e, exception: true)
                   end
                 end
-                warn log_message(Logger::WARN, name, 'method not found', subject: 'prereqs', hint: meth)
+                print_error(name, 'method not found', subject: 'prereqs', hint: meth)
               end
             elsif proj.build?
               proj.build(sync: sync)
@@ -582,7 +585,7 @@ module Squared
           else
             if @clean.is_a?(Enumerable) && !series?(@clean)
               @clean.each do |val|
-                entry = path + (val = val.to_s)
+                entry = basepath(val = val.to_s)
                 if entry.directory? && val.match?(%r{[\\/]\z})
                   log&.warn "rm -rf #{entry}"
                   rm_rf(entry, verbose: verbose)
@@ -715,7 +718,7 @@ module Squared
               delete = true
             end
             if create
-              warn log_message(Logger::WARN, 'force remove', subject: name, hint: target)
+              print_error('force remove', subject: name, hint: target)
               target.rmtree
               target.mkpath
             end
@@ -788,9 +791,8 @@ module Squared
         end
 
         def as(cmd, script, to = nil)
-          script = { "#{script}": to } if to
-          data = (@as ||= {})[cmd.to_sym] ||= {}
-          script.each { |key, val| data[key.to_s] = val }
+          data = @as[cmd.to_sym]
+          (to ? [[script, to]] : script).each { |key, val| data[key.to_s] = val }
           self
         end
 
@@ -807,6 +809,56 @@ module Squared
           self
         end
 
+        def run(cmd = @session, var = nil, exception: self.exception, sync: true, from: nil, banner: true, chdir: path,
+                interactive: nil, hint: nil, **)
+          unless cmd
+            print_error('no command given', subject: project, hint: from || 'unknown', pass: true)
+            return
+          end
+          cmd = cmd.target if cmd.is_a?(OptionPartition)
+          if interactive && (!@session || !option('y'))
+            title, y = case interactive
+                       when Array
+                         interactive
+                       when String
+                         [interactive, 'N']
+                       else
+                         ['Run', 'Y']
+                       end
+            yn = y == 'Y' ? 'Y/n' : 'y/N'
+            exit 1 unless confirm("#{title}? [#{sub_style(cmd.to_s, styles: theme[:inline])}] [#{yn}] ", y)
+          end
+          cmd = session_done cmd
+          log&.info cmd
+          on :first, from
+          begin
+            if cmd.match?(/\A[^:]+:[^:]/) && workspace.task_defined?(cmd)
+              log&.warn "ENV discarded: #{var}" if var
+              task_invoke(cmd, exception: exception, warning: warning?)
+            else
+              print_item format_banner(hint ? "#{cmd} (#{hint})" : cmd, banner: banner) if sync
+              if var != false && (pre = runenv)
+                case pre
+                when Hash
+                  var = var.is_a?(Hash) ? pre.merge(var) : pre
+                when Enumerable
+                  cmd = command(*pre.to_a, cmd)
+                else
+                  cmd = command(pre, cmd)
+                end
+              end
+              args = var.is_a?(Hash) ? [var, cmd] : [cmd]
+              ret = shell(*args, chdir: chdir, exception: exception)
+            end
+          rescue StandardError => e
+            on_error(from, e, exception: true)
+            false
+          else
+            on :last, from
+            ret
+          end
+        end
+
         def variable_set(key, *args, **kwargs, &blk)
           if variables.include?(key) || blocks.include?(key)
             val = case args.size
@@ -856,6 +908,8 @@ module Squared
           self
         end
 
+        alias apply variable_set
+
         def enabled?(ref = nil, **)
           return false if ref && !ref?(ref)
 
@@ -966,7 +1020,7 @@ module Squared
           path.parent.ascend.each do |dir|
             target = dir.join(*args)
             return target if target.exist?
-            break if (ascend.is_a?(String) && dir.join(ascend).exist?) || workspace.root == dir || parent&.path == dir
+            break if (ascend && dir.join(ascend).exist?) || workspace.root == dir || parent&.path == dir
           end
           ret
         end
@@ -993,56 +1047,6 @@ module Squared
           log_console(*args, pipe: kwargs[:pipe] || pipe)
         end
 
-        def run(cmd = @session, var = nil, exception: self.exception, sync: true, from: nil, banner: true, chdir: path,
-                interactive: nil, hint: nil, **)
-          unless cmd
-            warn log_message(Logger::WARN, 'no command given', subject: project, hint: from || 'unknown', pass: true)
-            return
-          end
-          cmd = cmd.target if cmd.is_a?(OptionPartition)
-          if interactive && (!@session || !option('y'))
-            title, y = case interactive
-                       when Array
-                         interactive
-                       when String
-                         [interactive, 'N']
-                       else
-                         ['Run', 'Y']
-                       end
-            yn = y == 'Y' ? 'Y/n' : 'y/N'
-            exit 1 unless confirm("#{title}? [#{sub_style(cmd.to_s, styles: theme[:inline])}] [#{yn}] ", y)
-          end
-          cmd = session_done cmd
-          log&.info cmd
-          on :first, from
-          begin
-            if cmd.match?(/\A[^:]+:[^:]/) && workspace.task_defined?(cmd)
-              log&.warn "ENV discarded: #{var}" if var
-              task_invoke(cmd, exception: exception, warning: warning?)
-            else
-              print_item format_banner(hint ? "#{cmd} (#{hint})" : cmd, banner: banner) if sync
-              if var != false && (pre = runenv)
-                case pre
-                when Hash
-                  var = var.is_a?(Hash) ? pre.merge(var) : pre
-                when Enumerable
-                  cmd = command(*pre.to_a, cmd)
-                else
-                  cmd = command(pre, cmd)
-                end
-              end
-              args = var.is_a?(Hash) ? [var, cmd] : [cmd]
-              ret = shell(*args, chdir: chdir, exception: exception)
-            end
-          rescue StandardError => e
-            on_error(from, e, exception: true)
-            false
-          else
-            on :last, from
-            ret
-          end
-        end
-
         def run_s(*cmd, env: nil, sync: true, from: nil, banner: verbose != false, **kwargs)
           on :first, from
           begin
@@ -1241,15 +1245,7 @@ module Squared
         end
 
         def session_delete(*args, target: @session)
-          ret = []
-          args.each do |val|
-            pat = /\A#{Regexp.escape(shell_option(val))}(?: |=|\z)/
-            if (key = target.find { |opt| opt.match?(pat) })
-              target.delete(key)
-              ret << key
-            end
-          end
-          ret
+          OptionPartition.delete(target, *args)
         end
 
         def session_output(*cmd, **kwargs)
@@ -1295,8 +1291,8 @@ module Squared
           puts 'Success'
         end
 
-        def print_error(err, loglevel: Logger::WARN, pass: false)
-          warn log_message(loglevel, err, pass: pass) if warning?
+        def print_error(*args, loglevel: Logger::WARN, **kwargs)
+          warn log_message(loglevel, *args, **kwargs) if warning?
         end
 
         def print_item(*val)
@@ -1467,7 +1463,7 @@ module Squared
             next if (key = key.to_s).start_with?('__')
 
             if val.nil? || extra || session_arg?(key, target: target)
-              session_delete(key, target: target)
+              OptionPartition.delete_key(target, key)
               next if val.nil?
             end
             case val
@@ -1601,7 +1597,7 @@ module Squared
           raise_error("invalid JSON #{kind.name}", val, hint: hint) if kind && !ret.is_a?(kind)
         rescue StandardError => e
           log&.warn e
-          warn log_message(Logger::WARN, e, subject: name) if warning?
+          print_error(e, subject: name)
         else
           ret
         end
@@ -1739,7 +1735,7 @@ module Squared
             raise_error 'pathspec not within worktree' unless pass || files.size == proj.size
             files = proj
           end
-          files.map { |val| val == '.' ? '.' : shell_quote(path + val) }
+          files.map { |val| val == '.' ? '.' : shell_quote(basepath(val)) }
         end
 
         def matchmap(list, prefix = nil)
@@ -2006,14 +2002,12 @@ module Squared
 
         def dependfile_set(list)
           @dependindex = list.index { |file| basepath(file).exist? }.tap do |index|
-            @dependfile = @path + list[index || 0]
+            @dependfile = basepath(list[index || 0])
           end
         end
 
-        def as_get(val)
-          return unless val
-
-          @global && (ret = @as && @as[from] && @as[from][val]) ? ret : val
+        def as_get(val, from)
+          (@global && @as[from][val]) || val
         end
 
         def task_build(keys)