@plurnk/plurnk-execs-common 0.2.9 → 0.2.10

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 (2) hide show
  1. package/README.md +9 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -21,6 +21,15 @@ The manifest claims the subprocess runtime tags. The framework's `probe()` (per-
21
21
  | `bc` 🧮 | bc | stdin (e.g. `6 * 7`) |
22
22
  | `awk` 🪄 | awk | program arg, empty stdin (`BEGIN { … }`) |
23
23
 
24
+ ### A program with stdin — the `(target)` slot
25
+
26
+ The table above is the **inline** form: `command` is the program. Put a program in the **`(target)` slot** instead and `command` becomes its **stdin** — a shell runs `sh -c "<target>"` (the shell tokenizes it; we don't), any other interpreter runs `<interpreter> <target>` (a script file). Same two slots, each mapped to its tool's CLI (plurnk-execs#15):
27
+
28
+ ```
29
+ <<EXEC[sh](./deploy.sh --prod):yes\nyes\nno:EXEC # run a script, prompts answered on stdin
30
+ <<EXEC[python](transform.py):3\n1\n4\n1\n5:EXEC # feed a python script its stdin
31
+ ```
32
+
24
33
  All run arbitrary code → `effect: host` → **proposal-gated** (not auto-run). For the snappy auto-run tier, see the pure in-process evaluators (`calc`/`jq`/`wasm`, planned). Input-processing transforms (`sed`, input-driven `awk`) await the EXEC input-channel and aren't claimed here.
25
34
 
26
35
  ## Configuration
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@plurnk/plurnk-execs-common",
3
- "version": "0.2.9",
3
+ "version": "0.2.10",
4
4
  "description": "Universal subprocess executor for plurnk-service's exec scheme — one package exposing the shell + node + python floor plus whichever host interpreters (perl, ruby, php, lua, awk, bc, …) are present.",
5
5
  "keywords": [
6
6
  "plurnk",