@mizchi/actrun 0.12.1 → 0.13.1

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 (3) hide show
  1. package/README.md +27 -0
  2. package/dist/actrun.js +211 -187
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -74,6 +74,10 @@ nix_packages = ["python312", "jq"]
74
74
  # Container runtime: docker, podman, container, lima, nerdctl
75
75
  container_runtime = "docker"
76
76
 
77
+ # Override actions with local commands
78
+ # [override."actions/setup-node"]
79
+ # run = "echo 'using local node' && node --version"
80
+
77
81
  # Affected file patterns per workflow
78
82
  # [affected."ci.yml"]
79
83
  # patterns = ["src/**", "package.json"]
@@ -239,6 +243,29 @@ steps:
239
243
 
240
244
  On GitHub Actions, `ACTRUN_LOCAL` is not set, so `!env.ACTRUN_LOCAL` evaluates to `true` and all steps run normally.
241
245
 
246
+ ## Action Overrides
247
+
248
+ Replace specific `uses:` action steps with custom `run:` commands via `actrun.toml`. This is useful when you have tools installed locally and want to skip the action's setup logic.
249
+
250
+ ```toml
251
+ [override."actions/setup-node"]
252
+ run = "echo 'using local node' && node --version"
253
+ ```
254
+
255
+ When a workflow step matches `uses: actions/setup-node@*`, actrun replaces it with the specified `run:` command before execution.
256
+
257
+ Combine with `local_skip_actions` for full control:
258
+
259
+ ```toml
260
+ local_skip_actions = ["actions/checkout"]
261
+
262
+ [override."actions/setup-node"]
263
+ run = "echo 'using local node'"
264
+
265
+ [override."actions/setup-python"]
266
+ run = "python3 --version"
267
+ ```
268
+
242
269
  ## Secrets & Variables
243
270
 
244
271
  ```bash