squared 0.8.8 → 0.9.0.pre1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (24) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +34 -78
  3. data/README.md +156 -124
  4. data/exe/sqd +224 -0
  5. data/lib/squared/common/base.rb +7 -5
  6. data/lib/squared/common/format.rb +9 -4
  7. data/lib/squared/common/prompt.rb +65 -33
  8. data/lib/squared/common/shell.rb +3 -1
  9. data/lib/squared/common/system.rb +2 -9
  10. data/lib/squared/config.rb +3 -3
  11. data/lib/squared/version.rb +1 -1
  12. data/lib/squared/workspace/application.rb +33 -44
  13. data/lib/squared/workspace/project/base.rb +105 -62
  14. data/lib/squared/workspace/project/docker.rb +95 -46
  15. data/lib/squared/workspace/project/git.rb +69 -100
  16. data/lib/squared/workspace/project/node.rb +52 -73
  17. data/lib/squared/workspace/project/python.rb +128 -96
  18. data/lib/squared/workspace/project/ruby.rb +74 -73
  19. data/lib/squared/workspace/project/support/class.rb +1 -1
  20. data/lib/squared/workspace/project/support/optionpartition.rb +33 -47
  21. data/lib/squared/workspace/repo.rb +5 -5
  22. data/lib/squared/workspace/series.rb +4 -2
  23. data/squared.gemspec +7 -5
  24. metadata +21 -5
data/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # squared 0.8
1
+ # squared 0.9
2
2
 
3
3
  * [source](https://github.com/anpham6/squared-ruby)
4
4
  * [docs](https://squared.readthedocs.io)
@@ -17,6 +17,7 @@
17
17
  | 2025-10-31 | 0.6.0 | | 3.4.7 | |
18
18
  | 2026-01-07 | 0.7.0 | 2.5.0 | 4.0.0 | * |
19
19
  | 2026-06-16 | 0.8.0 | | 4.0.5 | * |
20
+ | 2026-10-12 | 0.9.0 | 2.7.0 | 4.0.7 | * |
20
21
 
21
22
  The range chart indicates the *latest* Ruby tested against at the time of release.
22
23
 
@@ -26,6 +27,41 @@ The range chart indicates the *latest* Ruby tested against at the time of releas
26
27
  gem install squared
27
28
  ```
28
29
 
30
+ ## CLI - sqd
31
+
32
+ There is an additional program wrapper for ``rake`` to be used when running batch commands and to enable global settings more easily.
33
+
34
+ ```xml
35
+ Usage: sqd [options] [rake options] [global...] [:targets...] -- [rake targets...]
36
+
37
+ -R, --ref STR,STR Run global commands by class reference
38
+ -G, --group STR,STR Run global commands by project group
39
+
40
+ -P, --project STR,PAT Run project commands with common arguments
41
+ -a, --project-args STR,STR Provide command arguments for :targets (multiple)
42
+ -e, --project-env KEY=STR Provide command ENV variables for :targets (multiple)
43
+
44
+ -s, --[no-]strict Do not run commands with invalid arguments
45
+ --update Use update strategy for applicable commands
46
+ -F, --force [STR,STR] Enable force through ENV by application
47
+ -y, --yes [STR,STR] Enable auto-approve through ENV by application
48
+ -d, --dry-run Run commands without any modifying actions
49
+
50
+ -S, --select PAGE:CHOICE Prompt menu selection pagination limits
51
+
52
+ -p, --pipe 0|1|2 Set file descriptor for communication
53
+ -o, --pipe-out FILE Write command data stream to a file
54
+ --fail 0..4 Set application exception level
55
+ --log-level SEVERITY Set logger and exception state (debug, info, warn, error, fatal)
56
+
57
+ --[no-]banner Display executing command attributes
58
+ -x, --[no-]color Use enhanced styling for terminal output
59
+ -X, --plain Disable banner and styling for all commands
60
+ -v, --verbose Increase output verbosity (multiple)
61
+ --version Print the current version
62
+ -h, --help Print the command line options
63
+ ```
64
+
29
65
  ## Example - Rakefile
30
66
 
31
67
  Projects from any accessible folder can be added relative to the parent directory or absolutely. Missing projects will simply be excluded from the task runner.
@@ -54,7 +90,7 @@ require "squared/app" # All workspace related modules
54
90
  # sqd = /workspaces/squared/sqd
55
91
 
56
92
  # Load external Project classes (optional)
57
- Workspace::Application.load_ref("/home/user/.gem/ruby/4.0.0/gems/squared-0.7.0/lib/squared/workspace/project") # ref = :node => node.rb (absolute)
93
+ Workspace::Application.load_ref("/home/user/.gem/ruby/4.0.0/gems/squared-0.9.0/lib/squared/workspace/project") # ref = :node => node.rb (absolute)
58
94
  Workspace::Application.load_ref("lib/squared/workspace/project", gem: "squared") # bundle env (relative)
59
95
 
60
96
  Workspace::Application
@@ -69,38 +105,40 @@ Workspace::Application
69
105
  "CFLAGS" => "-fPIC -O1"
70
106
  })
71
107
  .add("optparse", doc: "rake rdoc", gemspec: "optparse.gemspec", group: "default") # Uses bundler/gem_tasks (without C extensions)
72
- .add("logger", copy: { from: "lib", glob: "**/*.rb", into: "/home/user/.local/gem/ruby/4.0.0/gems/logger-1.7.0" }, clean: ["tmp/"]) do # autodetect: true | "rvm" | "rbenv" | "asdf" | "bundler"
73
- self.gemdir = "/home/user/.local/gem/ruby/4.0.0/gems/logger-1.7.0" # Default for "into"
108
+ .add("logger", copy: { from: "lib", glob: "**/*.rb", into: "/home/user/.local/gem/ruby/4.0.0/gems/logger-1.7.0" }, clean: ["tmp/"]) do # autodetect: true | "rvm" | "rbenv" | "asdf" | "mise" | bundler"
109
+ self.gemdir = "/home/user/.local/gem/ruby/4.0.0/gems/logger-1.7.0" # Default for "into"
74
110
  end
75
- .add("e-mc", "emc", copy: { from: "publish", scope: "@e-mc", also: [:pir, "squared-express/"] }, ref: :node) # Node
111
+ .add("e-mc", "emc", copy: { from: "publish", scope: "@e-mc", also: [:pir, "squared-express/"] }, ref: :node)
76
112
  .add("pi-r", "pir", copy: { from: "publish", scope: "@pi-r" }, clean: ["publish/**/*.js", "tmp/"]) # Trailing slash required for directories
77
113
  .add("squared", init: "pnpm", script: ["build:stage1", "build:stage2"], group: "app") do # Use pnpm/yarn/berry for depend + Copy target (main)
78
114
  # Repo (global)
79
- as(:run, "build:dev", "dev") # npm run build:dev -> npm run dev
115
+ as(:run, "build:dev", "dev") # npm run build:dev -> npm run dev
80
116
  as(:run, { "build:dev": "dev", "build:prod": "prod" })
81
117
 
82
- add("publish/sqd-cli", "cli", exclude: [:git]) # rake cli:build
83
- add("publish/sqd-serve") # rake sqd-serve:build
118
+ add("publish/sqd-cli", "cli", exclude: [:git]) # rake cli:build
119
+ add("publish/sqd-serve") # rake sqd-serve:build
84
120
  add("publish/sqd-admin", group: "sqd", exclude: [:base])
85
121
  # OR
86
- with(exclude: [:base]) { add("publish/*", "packages") } # rake packages:sqd-serve:build
122
+ with(exclude: [:base]) { add("publish/*", "packages") } # rake packages:sqd-serve:publish
87
123
  # OR
88
- add(["publish/sqd-cli", "publish/sqd-serve"], true, exclude: [:base]) # rake squared:sqd-serve:build
124
+ add(["publish/sqd-cli", "publish/sqd-serve"], true, exclude: [:base]) # rake squared:sqd-serve:publish
89
125
 
90
126
  # Git
91
- revbuild(include: %w[src/ framework/ types/]) # Synchronous is recommended
127
+ revbuild(include: ["src/", "framework/", "types/"]) # Synchronous is recommended
92
128
  end
93
- .add("squared/sqd", exclude: :git, pass: [:node, "checkout", "bump"]) do # Skip initialize(:node) + squared:checkout:* + squared:bump:*
94
- apply :script, "build:sqd" # Override detection
95
- apply :depend, false #
96
- apply :clean, ["build/sqd/"] # variable_set (alias)
129
+ .add("squared/sqd", exclude: :git, pass: [:node, "checkout", "bump"]) do # Skip initialize(:node) + squared:checkout:* + squared:bump:*
130
+ apply :script, "build:sqd" # Override detection
131
+ apply :depend, false #
132
+ apply :clean, ["build/sqd/"] # variable_set (alias)
97
133
  end
98
- .with(:docker, only: ["build", "compose"], hide: [:windows?]) do # When true hide entire group (formerly pass 0.6.0)
99
- add("squared", "docker", file: "Dockerfile", context: ".", tag: "latest", registry: "localhost:5000", username: "squared", # compose publish => { oci: "oci://docker.io" }
100
- args: "--ssh=default",
101
- client: { config: '/home/user/.docker', tls: true }, # global options
102
- secrets: ["id=github,env=GITHUB_TOKEN"],
103
- mounts: ["src=.,dst=/project,ro,bind-propagation=rshared"]) do # Docker
134
+ .with(:docker, only: ["build", "compose"], hide: [:windows?]) do # When true hide entire group
135
+ .add("squared", "docker", file: "Dockerfile", tag: "latest",
136
+ registry: "localhost:5000", username: "squared", # compose publish => { oci: "oci://docker.io" }
137
+ args: "--ssh=default",
138
+ context: ".", # Optional
139
+ client: { config: '/home/user/.docker', tls: true }, # global options
140
+ secrets: ["id=github,env=GITHUB_TOKEN"],
141
+ mounts: ["src=.,dst=/project,ro,bind-propagation=rshared"]) do
104
142
  series(:clean) do # run | depend | doc | lint | test | copy | clean
105
143
  File.read(basepath("docker-bake.hcl"))
106
144
  .scan(/\btags\s+=\s+\["([^"]+)"\]/)
@@ -108,15 +146,6 @@ Workspace::Application
108
146
  end
109
147
  end
110
148
  end
111
- .assign(:ruby) do # Add or override instance methods
112
- def vmname(bin: false)
113
- bin ? ['rbenv', '/usr/bin/rbenv'] : 'rbenv'
114
- end
115
-
116
- def copy?
117
- false
118
- end
119
- end
120
149
  .pass("pull", group: "default") { test? || doc? } # rake pathname:pull optparse:pull
121
150
  .style("banner", 255.255) # 256 colors (fg | fg.bg | -0.bg)
122
151
  .build(default: "build", parallel: ["pull", "fetch", "rebase", "archive", "clean", /^outdated:/], pass: ["publish"]) do |workspace|
@@ -152,11 +181,13 @@ Python.options(:build, "build:dev", opts: ["no-deps"]) # inherits
152
181
 
153
182
  Workspace::Application
154
183
  .new(ENV["SQUARED_HOME"], prefix: "rb", common: false) # Local styles
155
- .group("ruby", "default", run: "rake build", copy: "rake install", clean: "rake clean", rubygems: 3, ref: :ruby, override: { # legacy: gem 3.6 | bundler 2.7 => ["3", "2.7"]
156
- pathname: {
157
- run: "rake compile" # rake rb:pathname:build
158
- }
159
- })
184
+ .group("ruby", "default", rubygems: 3, # legacy: gem 3.6 | bundler 2.7 => ["3", "2.7"]
185
+ run: "rake build", copy: "rake install", clean: "rake clean",
186
+ override: {
187
+ pathname: { run: "rake compile" } # rake rb:pathname:build
188
+ },
189
+ ref: :ruby
190
+ )
160
191
  .add("squared") do
161
192
  apply :run, proc { # rake rb:squared:build
162
193
  tsc(with: scriptname || "build:dev", verbose: true) # Repo (global)
@@ -174,7 +205,7 @@ Workspace::Application
174
205
  .each(&:join)
175
206
  }
176
207
  apply :lint, proc {
177
- bundle("exec", "-A --cache=true", with: "lint", verbose: true) # bundle exec --gemfile="/squared/Gemfile" rubocop --parallel -A --cache=true
208
+ bundle("exec", "-A --cache=true", with: "lint", verbose: true) # bundle exec --gemfile="/squared/Gemfile" rubocop --parallel -A --cache=true
178
209
  }
179
210
  end
180
211
  .with(:python, editable: false) do # ref=Symbol | group=String
@@ -216,8 +247,8 @@ Workspace::Application
216
247
  add("android-docs", "android", archive: "https://github.com/anpham6/android-docs/archive/refs/tags/v0.3.0.zip")
217
248
  add("chrome-docs", "chrome", archive: {
218
249
  uri: "https://github.com/anpham6/chrome-docs/archive/refs/tags/v0.5.0.tar.gz", # URI.open (required)
219
- digest: "e3d55d2004d4770dd663254c9272dc3baad0d57a5bd14ca767de6546cdf14680", # SHA1 | SHA256 | SHA384 | SHA512 | MD5
220
- digest: "rmd160:47b7790a511eed675fec1a3e742845fef058799b", # RMD160
250
+ digest: "e3d55d2004d4770dd663254c9272dc3baad0d57a5bd14ca767de6546cdf14680", # SHA1 | SHA256 | SHA384 | SHA512 | MD5 (length)
251
+ digest: "rmd160:47b7790a511eed675fec1a3e742845fef058799b", # RMD160 (prefix)
221
252
  ext: "tar.gz", # zip | tar | tar.gz | tgz | tar.xz | txz | 7z
222
253
  depth: 1, # nested directories (e.g. --strip-components)
223
254
  headers: { # URI.open
@@ -225,7 +256,7 @@ Workspace::Application
225
256
  }
226
257
  })
227
258
  end
228
- .add("squared", release: "https://github.com/anpham6/squared/archive/refs/tags/??") # squared:unpack:zip[v5.4.0,/tmp/squared]
259
+ .add("squared", release: "https://github.com/anpham6/squared/archive/refs/tags/??") # squared:unpack:zip[v5.8.4,/tmp/squared]
229
260
  ```
230
261
 
231
262
  ### Clone
@@ -238,8 +269,8 @@ Workspace::Application
238
269
  .git(
239
270
  "emc": "https://github.com/anpham6/e-mc", # rake emc:clone
240
271
  "pir": { # rake pir:clone
241
- uri: "https://github.com/anpham6/pi-r", #
242
- options: { #
272
+ uri: "https://github.com/anpham6/pi-r",
273
+ options: {
243
274
  "origin": "github", # --origin=github
244
275
  "recurse-submodules": false, # --no-recurse-submodules
245
276
  "shallow-exclude": ["v0.0.1", "v0.0.2"] # --shallow-exclude=v0.0.1 --shallow-exclude=v0.0.2
@@ -261,7 +292,7 @@ Workspace::Application
261
292
  )
262
293
  .with(:node) do # rake clone:node
263
294
  add("e-mc", "emc") do # https://github.com/anpham6/e-mc
264
- revbuild(before: %w[status squared:status], # emc:status + squared:status (always)
295
+ revbuild(before: ["status", "squared:status"], # emc:status + squared:status (always)
265
296
  after: "refresh") # emc:refresh (changed)
266
297
  end #
267
298
  add("pi-r", "pir") # https://github.com/anpham6/pi-r
@@ -304,7 +335,7 @@ Workspace::Application
304
335
  chain "all", "build", with: "pir" # step: 3
305
336
  end
306
337
  add("squared") do
307
- revbuild(include: %w[src/ framework/ types/]) # Git revision build command (optional)
338
+ revbuild(include: ["src/", "framework/", "types/"]) # Git revision build command (optional)
308
339
  chain "all", "revbuild", after: "express:build" # step: 4
309
340
  chain "publish", "bump:patch", "publish:latest", step: 0, sync: true # rake publish
310
341
  end
@@ -318,7 +349,7 @@ Workspace::Application
318
349
  chain "all", "doc", with: "squared", before: "squared:revbuild" # Same
319
350
  end
320
351
  end
321
- .chain("all", "status", with: "squared", after: "android-docs") # Global tasks (e.g. without ":")
352
+ .chain("all", "status", with: "squared", after: "android-docs") # Global tasks (without ":")
322
353
  .build
323
354
  ```
324
355
 
@@ -339,50 +370,50 @@ Threaded is the default when there are two or more tasks. Using ``with`` and eit
339
370
  ```ruby
340
371
  Workspace::Application
341
372
  .new(main: "squared")
342
- .graph(["depend"], ref: :git) # Optional
373
+ .graph(["depend"], ref: :git) # Optional
343
374
  .with(:python) do
344
- doc(windows? ? ".\make.bat html" : "make html") # rake android-docs:doc | rake doc:python
345
- add("android-docs", "android", venv: "/home/user/.venv") # rake android-docs:depend
346
- add("chrome-docs", "chrome", graph: "android", venv: %w[.venv --clear]) do # /workspaces/chrome-docs/.venv
347
- apply :dependindex, 1 # Use Poetry for dependencies (optional)
375
+ doc(windows? ? ".\make.bat html" : "make html") # rake android-docs:doc | rake doc:python
376
+ add("android-docs", "android", venv: "/home/user/.venv") # rake android-docs:depend
377
+ add("chrome-docs", "chrome", graph: "android", venv: [".venv", "--clear"]) do # /workspaces/chrome-docs/.venv
378
+ apply :dependindex, 1 # Use Poetry for dependencies
348
379
  end
349
380
  end
350
381
  .with(:node) do
351
- graph(["build", "copy"], on: { # Overrides "git"
382
+ graph(["build", "copy"], on: { # Overrides "git"
352
383
  first: proc { puts "1" },
353
384
  last: proc { puts "2" }
354
385
  })
355
- script("build:dev") # npm run build:dev
386
+ script("build:dev") # npm run build:dev
356
387
  # OR
357
- run([nil, "build:dev", { "PATH" => "~/.bin" }, "--workspace", "--silent"]) # PATH="~/.bin" npm run build:dev --workspace -- --silent
388
+ run([nil, "build:dev", { "PATH" => "~/.bin" }, "--workspace", "--silent"]) # PATH="~/.bin" npm run build:dev --workspace -- --silent
358
389
  # OR
359
- run({ # Same
360
- script: "build:dev", #
361
- env: { "PATH" => "~/.bin" }, #
362
- opts: "--workspace", #
363
- args: "--silent" #
390
+ run({
391
+ script: "build:dev",
392
+ env: { "PATH" => "~/.bin" },
393
+ opts: "--workspace",
394
+ args: "--silent"
364
395
  })
365
396
 
366
397
  add("e-mc", "emc") do
367
- first("build", "emc:clean", "emc:depend") # rake emc:clean && rake emc:depend && rake emc:build && echo "123"
368
- last("build", out: "123") { |out: nil| puts out } #
369
- error("build") { |err: nil| log.debug err } #
398
+ first("build", "emc:clean", "emc:depend") # rake emc:clean && rake emc:depend && rake emc:build && echo "123"
399
+ last("build", out: "123") { |out: nil| puts out } #
400
+ error("build") { |err: nil| log.debug err } #
370
401
  end
371
402
  add("pi-r", "pir", graph: "emc", first: {
372
- build: proc { puts self.name } # puts "pir"
403
+ build: proc { puts self.name } # puts "pir"
373
404
  })
374
405
  add("squared-express", "express", graph: "pir")
375
406
  add("squared", graph: ["chrome", "express"]) do
376
- first("git:ls-files") { puts "1" } # skipped
377
- first("git:ls-files", override: true) { puts "2" } # puts "2"
378
- last("git:ls-files") { puts workspace.root } # puts "/workspaces" (does not run when error is raised)
379
- error("git:ls-files") { |err| err.is_a?(TypeError) } # return true to suppress error
407
+ first("git:ls-files") { puts "1" } # skipped
408
+ first("git:ls-files", override: true) { puts "2" } # puts "2"
409
+ last("git:ls-files") { puts workspace.root } # puts "/workspaces" (does not run when error is raised)
410
+ error("git:ls-files") { |err| err.is_a?(TypeError) } # return true to suppress error
380
411
  end
381
412
  end
382
413
  .with(:ruby) do
383
- run("gem build") # gem build
414
+ run("gem build") # gem build
384
415
  # OR
385
- run("gem build", on: { first: -> { p "2" }, last: -> { p "4" } }) do # run | depend | graph | clean | doc | lint | test
416
+ run("gem build", on: { first: -> { p "2" }, last: -> { p "4" } }) do # run | depend | graph | clean | doc | lint | test
386
417
  p "1"
387
418
  end
388
419
  # OR
@@ -390,42 +421,42 @@ Workspace::Application
390
421
  p "1"
391
422
  end
392
423
  # OR
393
- run(["gem build", "--force", { "RUBY_VERSION" => "4.0.0" }]) # RUBY_VERSION="4.0.0" gem build --force
424
+ run(["gem build", "--force", { "RUBY_VERSION" => "4.0.0" }]) # RUBY_VERSION="4.0.0" gem build --force
394
425
  # OR
395
- run({ #
396
- command: "gem build", # RUBY_VERSION="4.0.0" gem build --silent --force
397
- opts: "--force", # composable
398
- env: { "PATH" => "~/.bin" }, #
399
- args: { silent: true } #
426
+ run({
427
+ command: "gem build", # RUBY_VERSION="4.0.0" gem build --silent --force (composable)
428
+ opts: "--force",
429
+ env: { "PATH" => "~/.bin" },
430
+ args: { silent: true }
400
431
  })
401
432
  # OR
402
- run(["gem pristine", ["gem build", "gem cleanup"], nil, "--debug"]) # gem pristine --debug && gem build --debug && gem cleanup --debug
433
+ run(["gem pristine", ["gem build", "gem cleanup"], nil, "--debug"]) # gem pristine --debug && gem build --debug && gem cleanup --debug
403
434
  #
404
435
  # All commands are either Array or Hash
405
436
  #
406
- run([ # PATH="~/.bin" GEM_HOME="~/.gems/ruby-4.0.0" (merged)
407
- ["gem pristine", "--all", { "PATH" => "~/.bin" }, "--silent"], # gem pristine --silent --all
408
- ["gem build", { strict: true }, { "GEM_HOME" => "~/.gems/ruby-4.0.0" }] # gem build --strict
409
- ]) #
437
+ run([ # PATH="~/.bin" GEM_HOME="~/.gems/ruby-4.0.0" (merged)
438
+ ["gem pristine", "--all", { "PATH" => "~/.bin" }, "--silent"], # gem pristine --silent --all
439
+ ["gem build", { strict: true }, { "GEM_HOME" => "~/.gems/ruby-4.0.0" }] # gem build --strict
440
+ ])
410
441
  # OR
411
- run([ # Same
412
- { #
413
- env: { "PATH" => "~/.bin" }, #
414
- command: "gem pristine", #
415
- opts: "--all", args: "--silent" #
416
- }, #
417
- { #
418
- env: { "GEM_HOME" => "~/.gems/ruby-4.0.0" }, #
419
- command: "gem build", #
420
- opts: { strict: true } #
421
- } #
442
+ run([
443
+ {
444
+ env: { "PATH" => "~/.bin" },
445
+ command: "gem pristine",
446
+ opts: "--all", args: "--silent"
447
+ },
448
+ {
449
+ env: { "GEM_HOME" => "~/.gems/ruby-4.0.0" },
450
+ command: "gem build",
451
+ opts: { strict: true }
452
+ }
422
453
  ])
423
454
 
424
- add("pathname", test: ["rake test", { jobs: ENV["RAKE_JOBS"] }]) # rake test --jobs 4
455
+ add("pathname", test: ["rake test", { jobs: ENV["RAKE_JOBS"] }]) # rake test --jobs 4
425
456
  add("fileutils", graph: "pathname")
426
- add("optparse", run: "gem build", env: { "PATH" => "~/.bin" }, opts: "-v") # PATH="~/.bin" gem build -v
457
+ add("optparse", run: "gem build", env: { "PATH" => "~/.bin" }, opts: "-v") # PATH="~/.bin" gem build -v
427
458
  add("rake", graph: ["fileutils", "optparse"])
428
- banner(command: false) # Always hide banner
459
+ banner(command: false) # Always hide banner
429
460
  end
430
461
  .build
431
462
  ```
@@ -545,32 +576,31 @@ Non-task:
545
576
 
546
577
  Most project classes will inherit from `Git` which enables these tasks:
547
578
 
548
- | Task | Git | Command |
549
- | :-------------- | :--------------- | :-------------------------------------------------------- |
550
- | branch | branch | create track delete move copy list current |
551
- | checkout | checkout | commit branch track detach path |
552
- | commit | commit | add all amend amend-orig fixup |
553
- | diff | diff | head branch files view between contain |
554
- | fetch | fetch | origin remote all |
555
- | files | ls-files | cached modified deleted others |
556
- | git | | add blame clean grep mv revert rm sparse-checkout status |
557
- | log | log | view between contain |
558
- | merge | merge | commit no-commit send |
559
- | pull | pull | origin remote all |
560
- | push | push | origin remote commit all tags |
561
- | range-diff | range-diff | view between contain |
562
- | rebase | rebase | branch onto send |
563
- | remote | remote | add select |
564
- | refs | ls-remote --refs | heads tags remote |
565
- | reset | reset | commit index patch mode undo |
566
- | restore | restore | source staged worktree |
567
- | rev | rev | commit branch build output |
568
- | sparse-checkout | sparse-checkout | add reapply list clean disable |
569
- | show | show | format oneline textconv |
570
- | stash | stash | push pop apply branch drop clear list all staged worktree |
571
- | submodule | submodule | status update branch url sync |
572
- | switch | switch | branch create detach |
573
- | tag | tag | add sign delete list |
579
+ | Task | Git | Command |
580
+ | :-------------- | :--------------- | :------------------------------------------------------------- |
581
+ | branch | branch | create track delete move copy list current |
582
+ | checkout | checkout | commit branch track detach path |
583
+ | commit | commit | add all amend amend-orig fixup |
584
+ | diff | diff | head branch files view between contain |
585
+ | fetch | fetch | origin remote all |
586
+ | files | ls-files | cached modified deleted others |
587
+ | git | | add blame clean grep mv revert rm show sparse-checkout status |
588
+ | log | log | view between contain |
589
+ | merge | merge | commit no-commit send |
590
+ | pull | pull | origin remote all |
591
+ | push | push | origin remote commit all tags |
592
+ | range-diff | range-diff | view between contain |
593
+ | rebase | rebase | branch onto send |
594
+ | remote | remote | add select |
595
+ | refs | ls-remote --refs | heads tags remote |
596
+ | reset | reset | commit index patch mode undo |
597
+ | restore | restore | source staged worktree |
598
+ | rev | rev | commit branch build output |
599
+ | sparse-checkout | sparse-checkout | add reapply list clean disable |
600
+ | stash | stash | push pop apply branch drop clear list all staged worktree |
601
+ | submodule | submodule | status update branch url sync |
602
+ | switch | switch | branch create detach |
603
+ | tag | tag | add sign delete list |
574
604
 
575
605
  You can disable all of them at once using the `exclude` property.
576
606
 
@@ -613,7 +643,7 @@ Common::PATH.update({
613
643
  gem: "~/.rvm/gems/ruby-4.0.0/bin/gem",
614
644
  bundle: "~/.rvm/gems/ruby-4.0.0/bin/bundle",
615
645
  rake: "~/.rvm/gems/ruby-4.0.0/bin/rake",
616
- npm: "/opt/node/v22.0.0/bin/npm",
646
+ npm: "/opt/node/v26.0.0/bin/npm",
617
647
  python: "#{ENV["PYTHONPATH"]}/bin/python"
618
648
  })
619
649
  ```
@@ -662,7 +692,9 @@ REVBUILD_FORCE=1 # Rebuild all targets (GIT_FORCE)
662
692
  REVBUILD_FORCE_${NAME}=1 # Rebuild project
663
693
 
664
694
  PREREQS_${NAME}=build,copy # Class method name to invoke
665
- PREREQS_${REF}=depend # e.g. Node
695
+ PREREQS_${REF}=depend # e.g. RUBY
696
+
697
+ DRY_RUN=true # 0,false (global: bin)
666
698
  ```
667
699
 
668
700
  ### Graph
@@ -756,8 +788,8 @@ DOCKER_Y=1 # confirm all
756
788
 
757
789
  TAG_${NAME}=1.0.0 # initialize
758
790
 
759
- BUILD_SQUARED_OPTS="NODE_TAG=24 RUBY_VERSION=4.0.0" DOCKER_SQUARED_OPTS="--no-cache --label=v1" rake squared:build
760
- docker build --no-cache --label=v1 --build-arg="NODE_TAG=24" --build-arg="RUBY_VERSION=4.0.0" .
791
+ BUILD_DOCKER_OPTS="NODE_TAG=26 RUBY_VERSION=4.0.0" DOCKER_DOCKER_OPTS="--no-cache --label=v1" rake docker:build # project: docker | ref: :docker
792
+ docker build --no-cache --label=v1 --build-arg="NODE_TAG=26" --build-arg="RUBY_VERSION=4.0.0" .
761
793
  ```
762
794
 
763
795
  | Command | Flag | ENV |
@@ -832,8 +864,8 @@ require "squared/workspace/repo"
832
864
 
833
865
  Workspace::Application
834
866
  .new(main: "squared")
835
- .repo("https://github.com/anpham6/squared-repo", "nightly", script: ["build:dev", "prod"], install: "#{ENV["HOME"]}/.bin", # install: first only
836
- ref: %i[node -docker]) # exclude: -docker
867
+ .repo("https://github.com/anpham6/squared-repo", "nightly", script: ["build:dev", "prod"], install: "/usr/local/bin", # first only (install)
868
+ ref: %i[node -docker]) # -docker (exclude)
837
869
  .repo("https://github.com/anpham6/squared-repo", name: "doc", doc: true, test: true, ref: :python)
838
870
  .add("squared", script: ["build:stage1", "build:stage2"])
839
871
  .with(:python) do