squared 0.7.1 → 0.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17d98e04832d29621058a1dafa1f9440f0734849aa2b68aecffed2b0c50c0e26
-  data.tar.gz: 31391a2561c19025ddd25a20c980f10cf605de2593a24e793eee87ee3d1ccc67
+  metadata.gz: 82923f41d47824239a45fb31f694e85d30c1cf0f73c099df00d2d7a210f6b156
+  data.tar.gz: e80edb54f73431248fb26d11ff53c5424ae791ef28b5a5ddcc3bb3f0da20622b
 SHA512:
-  metadata.gz: 246be3dde753890551351e232e8f804b7cf3e32ea610113983ad465dd863365f800142d18c91e732df7152e3cfdc6c8c727c980d85b1079dc7acc39ecde6a0aa
-  data.tar.gz: 3a9f07b19f697678bacf6d15914df6c33f74e2aa9a0d9b5f10b033b10c29e3460b34e2da3890ae62ed655858d499fb34dae49098096c73b9a2279bb8f9745bd1
+  metadata.gz: cbb9aaa755322f262c820b8f0cabb8e9bf6596e440e4d660311b5804b5c4f347c478c3bc2fddafdeddf4ff9643642da8c74445c118028e6ea904f59909232360
+  data.tar.gz: d0457af211645c310de59ae11cb693fbdb1c0fddd49989f805317dffb9db251693da9268fa2ad25b1739e94216b243521044502051ac8dbd111a65efdc31b1c0

data/CHANGELOG.md

@@ -1,6 +1,79 @@
 # Changelog
 
-## [0.7.1] - 2025-01-20
+## [0.7.3] - 2026-03-11
+
+### Added
+
+- Python command install action user for non-venv was implemented.
+- Ruby command version can create .ruby-version in project directory.
+- Ruby command reshim calls version manager to regenerate bin paths.
+- Git command diff can be piped to an output file.
+
+### Changed
+
+- Python command publish detects twine through the file system.
+- Git revbuild can bypass checksum by project name using GIT_FORCE.
+- Git internal data calls do not write to logs.
+- Ruby method serve uses as default port 3000 due to Errno::EACCES.
+
+### Fixed
+
+- Node command outdated using PNPM did not work in nested projects.
+
+## [0.6.11] - 2026-03-11
+
+### Changed
+
+- Git internal data calls do not write to logs.
+
+## [0.5.22] - 2026-03-11
+
+- Project base run command was not covered due to lack of type checking.
+
+## [0.4.36] - 2026-03-11
+
+### Added
+
+- Python venv initialization installs setuptools when detected.
+- Node task depend adds prod option flags when NODE_ENV=production.
+
+### Fixed
+
+- OptionPartition methods with escape parameter were reordered.
+- OptionPartition methods with quote parameter were revised.
+
+## [0.6.10] - 2025-02-23
+
+### Added
+
+- Docker command image action [ls|rm|tag|save] can be filtered.
+- Pip command options were updated to 26.1.
+
+### Changed
+
+- Ruby property autodetect was converted into an accessor.
+- Python property editable was converted into an accessor.
+
+### Fixed
+
+- Gem command install did not respond to interactive prompt.
+
+## [0.7.2] - 2026-02-09
+
+### Added
+
+- OptionPartition can parse flags with a custom switch or separator.
+- Gem command uninstall and pristine are interactive.
+- Docker command network action create was implemented.
+- Python command serve using http.server module was implemented.
+- Ruby command serve using webrick was implemented.
+- Node command serve using filename or string was implemented.
+
+### Fixed
+
+- Docker task clean does not run in parallel without ENV override.
+
+## [0.7.1] - 2026-01-20
 
 ### Added
 
@@ -14,7 +87,7 @@
 
 - Git task show was completely non-functional due to excessive formatting.
 
-## [0.7.0] - 2025-01-07
+## [0.7.0] - 2026-01-07
 
 ### Added
 
@@ -87,7 +160,7 @@
 - Project base method command_args did not append prompted value.
 - Bundler command exec did not use correct delegate for delete.
 
-## [0.6.9] - 2025-01-07
+## [0.6.9] - 2026-01-07
 
 ### Added
 
@@ -1653,7 +1726,7 @@
 - Rake did not set original rakefile when calling itself.
 - Extended tasks were not associated to their supporting class method.
 
-## [0.1.0] - 2024-12-7
+## [0.1.0] - 2024-12-07
 
 ### Added
 
@@ -1674,14 +1747,18 @@
 - Git pull did not display colors for diff bar chart.
 - Git commit did not fetch latest refs before submitting.
 
-## [0.0.12] - 2024-12-1
+## [0.0.12] - 2024-12-01
 
 ### Added
 
 - Changelog was created.
 
+[0.7.3]: https://github.com/anpham6/squared-ruby/releases/tag/v0.7.3
+[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.11]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.11
+[0.6.10]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.10
 [0.6.9]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.9
 [0.6.8]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.8
 [0.6.7]: https://github.com/anpham6/squared-ruby/releases/tag/v0.6.7
@@ -1692,6 +1769,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.22]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.22
 [0.5.21]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.21
 [0.5.20]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.20
 [0.5.19]: https://github.com/anpham6/squared-ruby/releases/tag/v0.5.19
@@ -1714,6 +1792,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.36]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.36
 [0.4.35]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.35
 [0.4.34]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.34
 [0.4.33]: https://github.com/anpham6/squared-ruby/releases/tag/v0.4.33

data/README.md

@@ -11,7 +11,7 @@
 | 2025-01-07 |   0.2.0 |        |  3.4.0 |     |
 | 2025-02-07 |   0.3.0 |        |  3.4.1 |     |
 | 2025-03-06 |   0.4.0 |        |  3.4.2 |  *  |
-| 2025-06-16 |   0.5.0 |  2.5.0 |  3.4.3 |  *  |
+| 2025-06-16 |   0.5.0 |  2.5.0 |  3.4.4 |  *  |
 | ---------- |   ----- |  ----- |  ----- | --- |
 | 2025-08-23 |   0.5.5 |        |  3.4.5 |     |
 | 2025-10-31 |   0.6.0 |        |  3.4.7 |  *  |
@@ -300,10 +300,10 @@ Workspace::Application
   end
   .with(:python) do
     doc("make html")
-    add("android-docs") do
+    add("android-docs", serve: "./build/html") do                          # Uses built-in http.server module (ruby: webrick)
       chain "all", "doc", with: "squared", after: "squared"                # step: 4
     end
-    add("chrome-docs") do
+    add("chrome-docs", serve: { root: "./build/html", port: 8000 }) do     # root | bind | port | opts[]
       chain "all", "doc", with: "squared", before: "squared:revbuild"      # Same
     end
   end
@@ -641,7 +641,7 @@ BANNER_${NAME}=0             #
 VERBOSE=0                    # console output level
 VERBOSE_${NAME}=0            # 0,1,2,n
 
-REVBUILD_FORCE=1             # Rebuild all targets
+REVBUILD_FORCE=1             # Rebuild all targets (GIT_FORCE)
 REVBUILD_FORCE_${NAME}=1     # Rebuild project
 
 PREREQS_${NAME}=build,copy   # Class method name to invoke
@@ -749,12 +749,13 @@ docker build --no-cache --label=v1 --build-arg="NODE_TAG=24" --build-arg="RUBY_V
 | compose    | run                | VERSION=s                                       |
 | compose    | publish            | TAG=s REGISTRY=s                                |
 | container  | commit             | REGISTRY=s PLATFORM=s DISABLE_CONTENT_TRUST=0,1 |
-| container  | -run -create -exec | ALL=1                                           |
+| container  | -run -create -exec | ALL=1 FILTER=s                                  |
 |            | -update -commit    |                                                 |
 | image      | rm                 | Y=1                                             |
 | image      | push               | TAG=s REGISTRY=s                                |
 | image      | -push              | ALL=1                                           |
-| network    | *                  | ALL=1                                           |
+| image      | -push -pull        | FILTER=s                                        |
+| network    | *                  | ALL=1 FILTER=s                                  |
 
 ### asdf
 

data/lib/squared/common/shell.rb

@@ -10,7 +10,9 @@ module Squared
       private_constant :QUOTE_VALUE
 
       String.define_method(:stripquote) { sub(QUOTE_VALUE, '\2') }
-      Array.define_method(:quote!) { |**kwargs| map { |s| Shell.shell_quote(s, **kwargs) } }
+      Array.define_method(:quote!) do |escape: false, **kwargs|
+        map { |s| escape && !Rake::Win32.windows? ? Shellwords.escape(s) : Shell.shell_quote(s, **kwargs) }
+      end
 
       module_function
 
@@ -73,7 +75,7 @@ module Squared
       end
 
       def shell_option(flag, val = nil, sep: '=', escape: true, quote: true, force: true, double: false, merge: false,
-                       override: false)
+                       switch: nil, override: false)
         flag = flag.to_s
         if flag =~ QUOTE_VALUE
           double = $1 == '"'
@@ -88,6 +90,9 @@ module Squared
                   else
                     merge ? '' : ' '
                   end
+                elsif switch
+                  pre = switch unless flag.start_with?(switch)
+                  merge ? '' : sep
                 elsif flag.size == 1
                   pre = '-'
                   merge ? '' : ' '

data/lib/squared/version.rb

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

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

@@ -23,7 +23,7 @@ module Squared
 
         OPTIONS = Workspace::Support.hashobj
         VAR_SET = %i[parent global script index envname desc dependfile dependname dependindex theme archive env graph
-                     dev prod timeout pass only exclude asdf].freeze
+                     dev prod timeout pass only exclude serve asdf].freeze
         BLK_SET = %i[run depend doc lint test copy clean].freeze
         SEM_VER = /\b(\d+)(?:(\.)(\d+))?(?:(\.)(\d+))?[-.]?(\S+)?\b/.freeze
         URI_SCHEME = %r{\A([a-z][a-z\d+-.]*)://[^@:\[\]\\^<>|\s]}i.freeze
@@ -117,7 +117,8 @@ module Squared
         subtasks({
           'graph' => %i[run print].freeze,
           'unpack' => %i[zip gz tar ext],
-          'asdf' => %i[set exec env current update latest where reshim]
+          'asdf' => %i[set exec env current update latest where reshim],
+          'serve' => nil
         })
 
         attr_reader :name, :workspace, :path, :theme, :group, :parent, :children, :dependfile,
@@ -276,80 +277,114 @@ module Squared
             Base.subtasks do |action, flags|
               next if task_pass?(action)
 
-              namespace action do
-                flags.each do |flag|
-                  case action
-                  when 'graph'
-                    break unless graph?
-
-                    format_desc action, flag, '(-)project*'
-                    task flag do |_, args|
-                      args = args.to_a.reject { |val| val == name }
-                      if flag == :run
-                        graph args
-                      else
-                        out = graph(args, out: [], order: {})
-                        emphasize(out, title: path, right: true, border: borderstyle, sub: [
-                          opt_style(theme[:header], /\A(#{Regexp.escape(path.to_s)})(.*)\z/),
-                          opt_style(theme[:active], /\A(#{Regexp.escape(name)})(.*)\z/),
-                          opt_style(theme[:inline], /\A((?~ \() \()(\d+)(\).*)\z/, 2)
-                        ])
+              if flags.nil?
+                case action
+                when 'serve'
+                  next unless serve?
+
+                  format_desc action, nil, 'root,port?,bind?,opts*'
+                  task action, [:root] do |_, args|
+                    if !args.root && @serve
+                      kwargs = @serve.dup
+                      root = kwargs.delete(:root)
+                      opts = kwargs.delete(:opts) || []
+                    else
+                      root = param_guard(action, 'path', args: args, key: :root)
+                      opts = args.extras
+                      unless opts.empty?
+                        port = opts.shift
+                        if port.match?(/^\d+$/)
+                          bind = opts.shift
+                        else
+                          bind = port
+                          port = nil
+                        end
+                        if bind&.start_with?('-')
+                          opts << bind
+                          bind = nil
+                        end
                       end
+                      kwargs = { port: port, bind: bind }.compact
                     end
-                  when 'unpack'
-                    format_desc(action, flag, 'tag/url,dir,digest?,f/orce?', before: ('ext' if flag == :ext))
-                    params = %i[tag dir digest force]
-                    params.unshift(:ext) if flag == :ext
-                    task flag, params do |_, args|
-                      ext = flag == :ext ? param_guard(action, flag, args: args, key: :ext) : flag.to_s
-                      tag = param_guard(action, flag, args: args, key: :tag)
-                      dir = param_guard(action, flag, args: args, key: :dir)
-                      unless tag.match?(URI_SCHEME)
-                        tag = unpack_get tag, ext
-                        tag ||= if @release
-                                  "%s.#{ext}" % [@release.include?('??') ? @release.sub('??', tag) : @release + tag]
+                    serve(basepath(root).to_s, opts, **kwargs)
+                  end
+                end
+              else
+                namespace action do
+                  flags.each do |flag|
+                    case action
+                    when 'graph'
+                      break unless graph?
+
+                      format_desc action, flag, '(-)project*'
+                      task flag do |_, args|
+                        args = args.to_a.reject { |val| val == name }
+                        if flag == :run
+                          graph args
+                        else
+                          out = graph(args, out: [], order: {})
+                          emphasize(out, title: path, right: true, border: borderstyle, sub: [
+                            opt_style(theme[:header], /\A(#{Regexp.escape(path.to_s)})(.*)\z/),
+                            opt_style(theme[:active], /\A(#{Regexp.escape(name)})(.*)\z/),
+                            opt_style(theme[:inline], /\A((?~ \() \()(\d+)(\).*)\z/, 2)
+                          ])
+                        end
+                      end
+                    when 'unpack'
+                      format_desc(action, flag, 'tag/url,dir,digest?,f/orce?', before: ('ext' if flag == :ext))
+                      params = %i[tag dir digest force]
+                      params.unshift(:ext) if flag == :ext
+                      task flag, params do |_, args|
+                        ext = flag == :ext ? param_guard(action, flag, args: args, key: :ext) : flag.to_s
+                        tag = param_guard(action, flag, args: args, key: :tag)
+                        dir = param_guard(action, flag, args: args, key: :dir)
+                        unless tag.match?(URI_SCHEME)
+                          tag = unpack_get tag, ext
+                          tag ||= if @release
+                                    "%s.#{ext}" % [@release.include?('??') ? @release.sub('??', tag) : @release + tag]
+                                  else
+                                    raise_error ArgumentError, "no base uri: #{tag}", hint: ext
+                                  end
+                        end
+                        force = case (digest = args.digest)
+                                when 'f', 'force'
+                                  digest = nil
+                                  true
                                 else
-                                  raise_error ArgumentError, "no base uri: #{tag}", hint: ext
+                                  args.fetch(:force, false)
                                 end
+                        unpack(basepath(dir), uri: tag, digest: digest, ext: ext, force: force)
                       end
-                      force = case (digest = args.digest)
-                              when 'f', 'force'
-                                digest = nil
-                                true
-                              else
-                                args.fetch(:force, false)
-                              end
-                      unpack(basepath(dir), uri: tag, digest: digest, ext: ext, force: force)
-                    end
-                  when 'asdf'
-                    break unless @asdf
-
-                    case flag
-                    when :set
-                      format_desc action, flag, 'version,dir?=u/home|p/arent'
-                      task flag, [:version] do |_, args|
-                        args = if (version = args.version)
-                                 args.extras
-                               else
-                                 version, opts = choice_index('Select a version',
-                                                              @asdf[1].children
-                                                                      .map(&:basename)
-                                                                      .sort { |a, b| b <=> a }
-                                                                      .push('latest', 'system'),
-                                                              accept: [accept_y('Confirm?')],
-                                                              values: 'Options')
-                                 OptionPartition.strip(opts)
-                               end
-                        asdf(flag, args, version: version)
-                      end
-                    else
-                      format_desc(action, flag, case flag when :exec, :env then 'command' end)
-                      task flag do |_, args|
-                        args = args.to_a
-                        if args.empty? && (flag == :exec || flag == :env)
-                          args << readline('Enter command', force: flag == :exec)
+                    when 'asdf'
+                      break unless @asdf
+
+                      case flag
+                      when :set
+                        format_desc action, flag, 'version,dir?=u/home|p/arent'
+                        task flag, [:version] do |_, args|
+                          args = if (version = args.version)
+                                   args.extras
+                                 else
+                                   version, opts = choice_index('Select a version',
+                                                                @asdf[1].children
+                                                                        .map(&:basename)
+                                                                        .sort { |a, b| b <=> a }
+                                                                        .push('latest', 'system'),
+                                                                accept: [accept_y('Confirm?')],
+                                                                values: 'Options')
+                                   OptionPartition.strip(opts)
+                                 end
+                          asdf(flag, args, version: version)
+                        end
+                      else
+                        format_desc(action, flag, case flag when :exec, :env then 'command' end)
+                        task flag do |_, args|
+                          args = args.to_a
+                          if args.empty? && (flag == :exec || flag == :env)
+                            args << readline('Enter command', force: flag == :exec)
+                          end
+                          asdf flag, args
                         end
-                        asdf flag, args
                       end
                     end
                   end
@@ -431,7 +466,7 @@ module Squared
             args[0] = instance_eval(&blk) || f
             return unless args.first
           end
-          if args.all? { |val| val.is_a?(Array) }
+          if args.all?(Array)
             var = {}
             cmd = args.each_with_object([]) do |val, out|
               case val.first
@@ -747,19 +782,18 @@ module Squared
           ensure
             if dir
               remove_entry dir
-            elsif delete && file&.exist?
+            elsif delete && file.exist?
               file.unlink
             end
           end
         end
 
-        def asdf(flag, opts = [], version: nil)
+        def asdf(flag, opts = [], name: nil, version: nil, banner: true)
           return unless @asdf
 
           cmd = flag == :update ? session('asdf', 'plugin update') : session('asdf', flag)
-          name = @asdf.first
+          name ||= @asdf.first
           legacy = @@asdf.version == 15
-          banner = true
           case flag
           when :set
             u = has_value?(opts, 'u', 'home')
@@ -782,7 +816,7 @@ module Squared
             cmd << name
             banner = false if flag == :latest || flag == :where
           end
-          success?(run(banner: banner, from: symjoin('asdf', flag)), flag == :set || flag == :reshim)
+          success?(run(banner: banner, from: symjoin('asdf', flag)), banner, flag == :set || flag == :reshim)
         end
 
         def first(key, *args, **kwargs, &blk)
@@ -959,6 +993,8 @@ module Squared
               parent_set val
             when :archive
               archive_set val
+            when :serve
+              serve_set val
             when :asdf
               asdf_set val
             when :run
@@ -1244,7 +1280,7 @@ module Squared
                    print_error e
                  end
           log[:progname] ||= @name
-          env('LOG_LEVEL', ignore: false) { |val| log[:level] = val.start_with?(/\d/) ? log_sym(val.to_i) : val }
+          env('LOG_LEVEL', ignore: false) { |s| log[:level] = s.start_with?(/\d/) ? log_sym(s.to_i) : s }
           log.delete(:file)
           @log = [file, log]
         end
@@ -1423,17 +1459,17 @@ module Squared
                            s += "#{indent || (last && data[final].last == kwargs[:context]) ? ' ' : a}   "
                            k += 1
                          end
-                         s += "#{j ? d : c}#{b * 3} #{tag.call(proj)}"
+                         s + "#{j ? d : c}#{b * 3} #{tag.call(proj)}"
                        end
               end
               if order
                 n = order.size
                 order[name] ||= if proj.parent
-                                  if order[s = proj.parent.name]
-                                    order[s] += 1
+                                  if order[key = proj.parent.name]
+                                    order[key] += 1
                                     n.pred
                                   else
-                                    order[s] = n.succ
+                                    order[key] = n.succ
                                     n
                                   end
                                 else
@@ -2007,10 +2043,12 @@ module Squared
           [shell_bin(a), b].compact.join(' ')
         end
 
-        def parse_json(val, kind: Hash, hint: nil)
+        def parse_json(val, kind: Hash, key: nil, hint: nil, &blk)
           ret = JSON.parse(val)
           raise_error 'invalid JSON'.subhint(kind.name), val, hint: hint if kind && !ret.is_a?(kind)
-          ret
+          return ret unless key
+
+          block_given? ? ret.fetch(key, &blk) : ret[key]
         rescue => e
           print_error(kind ? Logger::ERROR : Logger::INFO, e, subject: name)
         end
@@ -2384,7 +2422,7 @@ module Squared
             ret = []
             if data[:command]
               ret[0] = data[:command]
-              ret[1] = data[:opts] unless diso
+              ret[1] = data[:opts] unless noopt
               ret[3] = data[:args]
             elsif data[:script]
               ret[1] = data[:script]
@@ -2393,7 +2431,7 @@ module Squared
             else
               ret[0] = false
             end
-            ret[2] = data[:env] unless dise
+            ret[2] = data[:env] unless noenv
             ret
           end
           case global
@@ -2408,7 +2446,7 @@ module Squared
           when Hash
             @output = parse.call(data)
           when Enumerable
-            @output = if cmd.all? { |data| data.is_a?(Hash) }
+            @output = if cmd.all?(Hash)
                         noopt = false
                         noenv = false
                         cmd.map { |data| parse.call(data) }
@@ -2499,6 +2537,17 @@ module Squared
                      end
         end
 
+        def serve_set(val)
+          @serve = case val
+                   when false
+                     false
+                   when String
+                     { root: val }
+                   when Hash
+                     val if val.key?(:root)
+                   end
+        end
+
         def asdf_set(val)
           @asdf = if @@asdf && val
                     dir = @@asdf.path.join('installs', val)
@@ -2660,6 +2709,10 @@ module Squared
           level.empty? ? ex != false && ex != Logger::INFO : ex.is_a?(Numeric) && level.include?(ex)
         end
 
+        def serve?
+          false
+        end
+
         def variables
           VAR_SET
         end