squared 0.4.15 → 0.4.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0cf3c1ed045970581434b5e6571a75ccb21a8ea564d83b1f85c6deca107424d5
-  data.tar.gz: 2300104c9cf7fcd5babbe2989c9a68af8f8b024546baf3969198df1973ab98fe
+  metadata.gz: 4e41d76a0edb3135560234d2a7faf8eba688365316cad1dc9ca38d7fb353759d
+  data.tar.gz: b59fa903ae6e7282ef8d3b36039141c9b29f43c0f7d5fdc64063cd191e7cb409
 SHA512:
-  metadata.gz: 5983d6fa81ba44335c2af020292f6260a02ffd4c6a8c9c9213b68d50606a14aa33fd4df032a5abfcc0677d44f5e30e69d726b3c5dcc2ac0dfbb378bdd9fa0618
-  data.tar.gz: dcd11eb155202c2dbbcb1d7a533516c4c0d16381caccb49a0b67612e915297242b7caa74d684afcb9db08530d68a1f0a693512189f8e6b7d9fe6579f2c5e444a
+  metadata.gz: 7118f35ce60a5a8008c3163b636b7acbcbfeb637b2cea7aab9fb3be87b5a4701d0f28c8edbe2510a9e596077f578875bea537acebedc4177223a63d377ea418f
+  data.tar.gz: '025669293a2bf52bed8c2a25135264faa04363e646f2bd217a1a26e89fddaa4cab84cafedd4c31ba82045c1471d4c82da39e4c15fd353201bcc2b789bcbb0c1d'

data/CHANGELOG.md

@@ -1,5 +1,63 @@
 # Changelog
 
+## [0.4.17] - 2025-08-09
+
+### Added
+
+- Node repos can be initialized with specific package manager.
+- Docker Engine options were updated to 28.0.
+- Git commands pull and fetch action all was implemented.
+- Git command reset action undo was implemented.
+- Python command pip action upgrade was implemented.
+- Git commands refs and files can use both pathspec and pattern.
+- Git command submodule was implemented.
+- Git command status was implemented.
+- Git command switch action branch was implemented.
+
+### Changed
+
+- Project task events can be assigned to a single proc.
+- Ruby task copy uses require paths from gem specification.
+- Docker task build:bake was renamed bake:build.
+- Project global tasks can be hidden and still expose subtasks.
+- Repo command line options can be overriden with class method.
+- Repo task all variable REPO_DRYRUN was replaced with REPO_STAGE.
+- Repo command sync option no-fail was renamed fail.
+
+### Fixed
+
+- Gem command outdated did not work outside main project folder.
+- Node command bump did not reset major and minor trailing digits.
+- Docker image status message was displayed backwards.
+
+## [0.4.16] - 2025-07-27
+
+### Added
+
+- Git command blame was implemented.
+- Project property only for task filtering was implemented.
+- Node command copy uses NPM pack to refresh development packages.
+- Docker command bake action check was implemented.
+- Ruby uses gem specification for name and version.
+- Ruby constructor parameter gemspec was implemented.
+
+### Changed
+
+- Project boolean property readers were converted into accessors.
+- Workspace hash singleton methods were relocated under Support.
+- Project property version uses setter method for validation.
+- Node command publish will prompt when tag is not semantic.
+- Gem command push without args uses gemspec to locate archive.
+- Prompts will exit process without raising a generic error.
+
+### Fixed
+
+- Gem command exec did not separate command and arguments.
+- Project warning messages were not displayed for errors.
+- Python command outdated did not load virtual env in Windows.
+- Python virtual env original options are not modified.
+- Node could not compare semantic versions above double digits.
+
 ## [0.4.15] - 2025-07-16
 
 ### Added
@@ -833,6 +891,8 @@
 
 - Changelog was created.
 
+[0.4.17]: https://github.com/anpham6/squared/releases/tag/v0.4.17-ruby
+[0.4.16]: https://github.com/anpham6/squared/releases/tag/v0.4.16-ruby
 [0.4.15]: https://github.com/anpham6/squared/releases/tag/v0.4.15-ruby
 [0.4.14]: https://github.com/anpham6/squared/releases/tag/v0.4.14-ruby
 [0.4.13]: https://github.com/anpham6/squared/releases/tag/v0.4.13-ruby

data/README.md

@@ -1,4 +1,4 @@
-# squared 5.5
+# squared 5.6
 
 ## Documentation
 
@@ -140,13 +140,13 @@ rake clone               # node + docs
 # PIPE_FAIL={0,1}
 # PORT=3000
 docker build -t squared --build-arg MANIFEST=prod --build-arg NODE_ENV=production .
-docker build -t node --build-arg NODE_TAG=22 --build-arg NODE_INSTALL=pnpm -f slim.Dockerfile .
+docker build -t node --build-arg NODE_TAG=22 --build-arg NODE_INSTALL=pnpm -f Dockerfile.slim .
 NODE=22 docker buildx bake node
 # OR
-docker build -t ruby --build-arg RUBY_TAG=3.4.0 --build-arg NODE_VERSION=22 --build-arg PIPE_FAIL=0 -f ruby.Dockerfile .
+docker build -t ruby --build-arg RUBY_TAG=3.4.0 --build-arg NODE_VERSION=22 --build-arg PIPE_FAIL=0 -f Dockerfile.ruby .
 RUBY=3.4.0 docker buildx bake ruby
 # OR
-docker build -t nginx --build-arg NGINX_VERSION=1.27 --build-arg PORT=3000 --build-arg NODE_VERSION=20 -f nginx.Dockerfile .
+docker build -t nginx --build-arg NGINX_VERSION=1.27 --build-arg PORT=3000 --build-arg NODE_VERSION=20 -f Dockerfile.nginx .
 NGINX=1.27 docker buildx bake nginx
 
 # Express
@@ -175,6 +175,9 @@ docker run -it --name debian squared /bin/bash # irb
 > * https://unpkg.com/squared/dist/squared.min.js
 > * https://unpkg.com/squared/dist/vdom-lite.framework.min.js
 
+> [!WARNING]
+> Safari is completely untested and is not an officially supported browser.
+
 ## Usage
 
 Library files are in the `/dist` folder. A minimum of **two** files are required to run *squared*.
@@ -378,7 +381,7 @@ Used primarly for developing single page layouts but can also bundle assets usin
 
 ### Example: vdom
 
-The most minimal framework possible (*55kb gzipped*) and can be useful when debugging through DevTools. The `lite` version is about half the bundle size and is recommended for most browser applications.
+The most minimal framework possible (*80kb gzipped*) and can be useful when debugging through DevTools. The `lite` version is about half the bundle size and is recommended for most browser applications.
 
 * ES2018
 
@@ -416,6 +419,7 @@ squared.settings = {
     targetAPI: 35,
     supportRTL: true,
     supportNegativeLeftTop: true,
+    supportUnicode: ["emoji"], // true | "utf-16" | "emoji"
     preloadImages: true,
     preloadFonts: true,
     preloadLocalFonts: true, // Chromium
@@ -464,6 +468,7 @@ squared.settings = {
     outputMainFileName: "activity_main.xml",
     outputFragmentFileName: "fragment_main.xml",
     /* Project - parseDocument (first only) */
+    supportUnicode: "utf-16",
     resourceQualifier: "", // "land" -> "res/layout-land" | "port" -> "res/layout-port" (appended to every "res" folder)
     resourceSystemColors: {
         "system_accent1_100": "white", // Will be converted to ARGB

data/README.ruby.md

@@ -65,6 +65,7 @@ require "squared/app"                                # All workspace related mod
 # log       = /workspaces/logger
 # emc       = /workspaces/e-mc
 # pir       = /workspaces/pi-r
+# pir2      = /workspaces/pi-r2
 # squared   = /workspaces/squared
 # cli       = /workspaces/squared/publish/sqd-cli
 # sqd-serve = /workspaces/squared/publish/sqd-serve
@@ -82,11 +83,12 @@ Workspace::Application
   .add("pathname", run: "rake compile", copy: "rake install", test: "rake test", group: "default", env: { # Ruby (with C extensions)
     "CFLAGS" => "-fPIC -O1"
   })
-  .add("optparse", doc: "rake rdoc", group: "default") # Uses bundler/gem_tasks (without C extensions)
+  .add("optparse", doc: "rake rdoc", gemspec: "optparse.gemspec", group: "default") # Uses bundler/gem_tasks (without C extensions)
   .add("logger", copy: { from: "lib", glob: "**/*.rb", into: "~/.rvm/gems/ruby-3.4.0/gems/logger-1.6.1" }, clean: ["tmp/"]) # autodetect: true | "rvm" | "rbenv" | "asdf" | "bundler"
   .add("e-mc", "emc", copy: { from: "publish", scope: "@e-mc", also: [:pir, "squared-express/"] }, ref: :node) # Node
   .add("pi-r", "pir", copy: { from: "publish", scope: "@pi-r" }, clean: ["publish/**/*.js", "tmp/"]) # Trailing slash required for directories
-  .add("squared", script: ["build:stage1", "build:stage2"], group: "app") do # Copy target (main)
+  .add("pi-r2", "pir2", copy: { from: :npm, also: %i[squared express], files: ["LICENSE", ["README.md.ruby", "README.md"]] }) # Uses dist files from NPM package spec
+  .add("squared", init: 'pnpm', script: ["build:stage1", "build:stage2"], group: "app") do # Use pnpm/yarn/berry for depend + Copy target (main)
     # Repo (global)
     as(:run, "build:dev", "dev")                                             # npm run build:dev -> npm run dev
     as(:run, { "build:dev": "dev", "build:prod": "prod" })
@@ -107,7 +109,7 @@ Workspace::Application
     variable_set :depend, false
     variable_set :clean, ["build/sqd/"]
   end
-  .with(:docker, pass: ["unpack"]) do
+  .with(:docker, only: ["build", "compose"]) do
     .add("squared", "docker", file: "Dockerfile", context: ".", tag: "latest", registry: "localhost:5000", username: "squared",
                               args: "--ssh=default",
                               secrets: ["id=github,env=GITHUB_TOKEN"],
@@ -497,11 +499,11 @@ Most project classes will inherit from `Git` which enables these tasks:
 | checkout   | checkout         | commit branch track detach path               |
 | commit     | commit           | add all amend amend-orig fixup                |
 | diff       | diff             | head cached branch files between contain      |
-| fetch      | fetch            | origin remote                                 |
+| fetch      | fetch            | origin remote all                             |
 | files      | ls-files         | cached modified deleted others                |
-| git        |                  | add clean mv rm revert                        |
+| git        |                  | add blame clean mv rm revert                  |
 | merge      | merge            | commit no-commit send                         |
-| pull       | pull             | origin remote                                 |
+| pull       | pull             | origin remote all                             |
 | rebase     | rebase           | branch onto send                              |
 | refs       | ls-remote --refs | heads tags remote                             |
 | reset      | reset            | commit index patch mode                       |
@@ -509,7 +511,7 @@ Most project classes will inherit from `Git` which enables these tasks:
 | rev        | rev              | commit output                                 |
 | show       | show             | format oneline                                |
 | stash      | stash            | push pop apply branch drop clear list         |
-| switch     | switch           | create detach merge                           |
+| switch     | switch           | branch create detach                          |
 | tag        | tag              | add sign delete list                          |
 
 You can disable all of them at once using the `exclude` property.
@@ -623,6 +625,8 @@ LOG_LEVEL                    # See gem "logger"
 
 ### Git
 
+* Version: 2.50
+
 ```sh
 GIT_OPTIONS=q,strategy=ort  # all
 GIT_OPTIONS_${NAME}=v,ff    # project only
@@ -632,15 +636,15 @@ GIT_AUTOSTASH_${NAME}=0     # rebase (project only)
 
 | Command    | Flag              |  ENV                                                                  |
 | :--------- | :---------------- | :-------------------------------------------------------------------- |
-| branch     | create            | TRACK=0,1,s FORCE                                                     |
-| branch     | move copy         | FORCE                                                                 |
+| branch     | create            | TRACK=0,1,s F|FORCE                                                   |
+| branch     | move copy         | F|FORCE                                                               |
 | branch     | set delete        | COUNT=n                                                               |
 | branch     | global            | SYNC                                                                  |
 | checkout   | branch            | DETACH TRACK=s COUNT=n                                                |
 | checkout   | detach            | REFLOG=1                                                              |
 | checkout   | track             | COUNT=n                                                               |
 | checkout   | global path       | HEAD=s PATHSPEC=s                                                     |
-| checkout   | *                 | FORCE MERGE                                                           |
+| checkout   | *                 | F|FORCE MERGE                                                         |
 | clone      | *                 | DEPTH=n ORIGIN=s BRANCH=s REVISION=s LOCAL=0,1                        |
 | commit     | *                 | UPSTREAM=s DRY_RUN EDIT=0 M|MESSAGE=s                                 |
 | diff       | -between -contain | MERGE_BASE                                                            |
@@ -648,13 +652,13 @@ GIT_AUTOSTASH_${NAME}=0     # rebase (project only)
 | diff       | *                 | PATHSPEC=s                                                            |
 | fetch      | -remote           | ALL                                                                   |
 | fetch      | remote            | REFSPEC=s                                                             |
-| fetch      | *                 | FORCE RECURSE_SUBMODULES=0,1,s                                        |
+| fetch      | *                 | F|FORCE RECURSE_SUBMODULES=0,1,s                                      |
 | git        | rm                | PATHSPEC=s                                                            |
 | log        | *                 | PATHSPEC=s                                                            |
 | pull       | rebase            | AUTOSTASH                                                             |
 | pull       | remote            | REFSPEC=s                                                             |
 | pull       | -remote           | ALL                                                                   |
-| pull       | *                 | REBASE=0,1 FORCE RECURSE_SUBMODULES=0,1,s                             |
+| pull       | *                 | REBASE=0,1 F|FORCE RECURSE_SUBMODULES=0,1,s                           |
 | rebase     | branch            | HEAD=s                                                                |
 | rebase     | onto              | INTERACTIVE I HEAD=s                                                  |
 | reset      | mode (mixed)      | N REFRESH=0                                                           |
@@ -668,14 +672,16 @@ GIT_AUTOSTASH_${NAME}=0     # rebase (project only)
 | status     | global            | BRANCH LONG IGNORE_SUBMODULES=s,0-3 PATHSPEC=s                        |
 | switch     | detach            | REFLOG=1                                                              |
 | switch     | -detach           | HEAD=s                                                                |
-| switch     | *                 | FORCE                                                                 |
+| switch     | *                 | F|FORCE                                                               |
 | tag        | add               | SIGN FORCE HEAD=s M|MESSAGE=s                                         |
-| tag        | sign              | FORCE HEAD=s M|MESSAGE=s                                              |
+| tag        | sign              | F|FORCE HEAD=s M|MESSAGE=s                                            |
 | tag        | delete            | COUNT=n                                                               |
 | rev        | commit branch     | HEAD=s                                                                |
 
 ### Docker
 
+* Version: 28.3
+
 ```sh
 DOCKER_OPTIONS=q,no-cache                # all
 DOCKER_OPTIONS_${NAME}=v,no-cache=false  # project only (override)
@@ -710,7 +716,7 @@ REPO_WARN            # 0,1
 REPO_SYNC            # 0,1
 REPO_URL             # manifest repository
 REPO_MANIFEST        # e.g. latest,nightly,prod
-REPO_DRYRUN          # 0,1,2
+REPO_STAGE           # 0,1,2,3
 REPO_TIMEOUT         # confirm dialog (seconds)
 ```
 

data/lib/squared/common/prompt.rb

@@ -73,9 +73,9 @@ module Squared
               end
               attempts -= 1
               next if attempts > 0
-              break unless force
 
-              exit 1
+              exit 1 if force
+              break
             end
           rescue Interrupt
             puts
@@ -109,7 +109,7 @@ module Squared
                                end
           ret = (prompt.call || '').strip
           multiline.each { |val| break if ret.delete_suffix!(val) } if multiline.is_a?(::Enumerable)
-          raise_error 'user cancelled' if force && ret.empty?
+          exit 1 if force && ret.empty?
           ret
         else
           prompt.call

data/lib/squared/common/shell.rb

@@ -86,8 +86,7 @@ module Squared
       end
 
       def shell_split(val, quote: false, force: false, join: nil)
-        ret = val.shellsplit
-        ret.map! { |opt| shell_escape(opt, quote: quote, force: force, double: true, option: true) }
+        ret = val.shellsplit.map! { |opt| shell_escape(opt, quote: quote, force: force, double: true, option: true) }
         return ret unless join
 
         ret.join(join.is_a?(::String) ? join : ' ')

data/lib/squared/common/system.rb

@@ -12,9 +12,9 @@ module Squared
         if RUBY_ENGINE == 'jruby' && Rake::Win32.windows?
           e = kwargs[:exception]
           if (dir = kwargs[:chdir]) && ((pwd = Dir.pwd) != dir)
-            Dir.chdir(dir)
+            Dir.chdir dir
             ret = Kernel.send(name, *args)
-            Dir.chdir(pwd)
+            Dir.chdir pwd
           else
             ret = Kernel.send(name, *args)
           end
@@ -57,23 +57,24 @@ module Squared
         soft = 0
         subdir.each do |dir, files|
           if link
-            items = files.dup
-            files.clear
-            items.each do |file|
-              if file.exist?
-                if file.symlink?
-                  next unless force
+            files.dup.tap do |items|
+              files.clear
+              items.each do |file|
+                if file.exist?
+                  if file.symlink?
+                    next unless force
+                  else
+                    files << file
+                    next
+                  end
+                end
+                if link == 'hard'
+                  FileUtils.ln(file, dir, force: force, verbose: false)
                 else
-                  files << file
-                  next
+                  FileUtils.ln_s(file, dir, force: force, verbose: false)
                 end
+                soft += 1
               end
-              if link == 'hard'
-                FileUtils.ln(file, dir, force: force, verbose: false)
-              else
-                FileUtils.ln_s(file, dir, force: force, verbose: false)
-              end
-              soft += 1
             end
           end
           next if files.empty?

data/lib/squared/common/utils.rb

@@ -105,6 +105,15 @@ module Squared
         Time.now.utc.strftime(s).to_i - Time.parse(val).utc.strftime(s).to_i
       end
 
+      def rand_s(size)
+        if RUBY_VERSION >= '3.1'
+          require 'random/formatter'
+          Random.new.alphanumeric(size)
+        else
+          (0...size).map { rand(97..122).chr }.join
+        end
+      end
+
       def env(key, default = nil, suffix: nil, strict: false, equals: nil, ignore: nil)
         ret = env_value(key, suffix: suffix, strict: strict)
         return ret == equals.to_s unless equals.nil?

data/lib/squared/version.rb

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

data/lib/squared/workspace/application.rb

@@ -26,7 +26,7 @@ module Squared
             next unless base || obj < impl_project
 
             if base
-              @impl_project = obj
+              self.impl_project = obj
               impl_series.base_set(obj)
             else
               kind_project.unshift(obj)
@@ -39,7 +39,7 @@ module Squared
               impl_series.alias(*args)
             end
             if (args = obj.bannerargs)
-              @attr_banner.merge(args)
+              attr_banner.merge(args)
             end
           end
         end
@@ -92,7 +92,7 @@ module Squared
         @prefix = prefix
         @series = Application.series_wrap(self)
         @project = {}
-        @kind = Workspace.hashlist
+        @kind = Support.hashlist
         @extensions = []
         @envname = env_key(@main).freeze
         @pipe = env_pipe(pipe, (ARG[:OUT] && env(ARG[:OUT])) || 1, root: @home)
@@ -106,20 +106,20 @@ module Squared
         else
           @theme = {}
         end
-        @chain = Workspace.hashlist
+        @chain = Support.hashlist
         @script = {
-          group: Workspace.hashobj,
-          ref: Workspace.hashobj,
+          group: Support.hashobj,
+          ref: Support.hashobj,
           group!: {},
           ref!: {}
         }.freeze
         @events = {
-          group: Workspace.hashobj,
-          ref: Workspace.hashobj
+          group: Support.hashobj,
+          ref: Support.hashobj
         }.freeze
         @pass = {
-          group: Workspace.hashobj,
-          ref: Workspace.hashobj,
+          group: Support.hashobj,
+          ref: Support.hashobj,
           global: {},
           pattern: []
         }.freeze
@@ -630,12 +630,16 @@ module Squared
         Rake::Win32.windows?
       end
 
+      def mri?
+        RUBY_ENGINE == 'ruby'
+      end
+
       def jruby?
         RUBY_ENGINE == 'jruby'
       end
 
-      def jruby_win?
-        jruby? && windows?
+      def truffleruby?
+        RUBY_ENGINE == 'truffleruby'
       end
 
       def docker?
@@ -687,9 +691,14 @@ module Squared
       private
 
       def __build__(default: nil, **)
-        return unless default && task_defined?(out = task_name(default))
-
-        task Rake.application.default_task_name => out
+        unless task_defined?('squared:version')
+          task 'squared:version' do
+            puts Squared::VERSION
+          end
+        end
+        if default && task_defined?(out = task_name(default))
+          task Rake.application.default_task_name => out
+        end
       end
 
       def __chain__(*)