@plurnk/plurnk-execs-common 2.0.1 → 2.0.2
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.
- package/docs/awk.md +1 -1
- package/docs/bun.md +1 -1
- package/docs/deno.md +1 -1
- package/docs/lua.md +1 -1
- package/docs/node.md +1 -1
- package/docs/perl.md +1 -1
- package/docs/ruby.md +1 -1
- package/docs/sh.md +3 -2
- package/docs/tcl.md +1 -1
- package/package.json +2 -2
package/docs/awk.md
CHANGED
|
@@ -4,7 +4,7 @@ The body is the AWK program, passed as the one positional argument with an
|
|
|
4
4
|
empty stdin: with no input file it only runs `BEGIN` blocks. Input files are
|
|
5
5
|
named in `[{"args": [...]}]`; a script target runs that file and receives the
|
|
6
6
|
body as stdin. Working directory, environment, channels and exit status are
|
|
7
|
-
every subprocess executor's (`sh.md`); `exit 1` in the program
|
|
7
|
+
every subprocess executor's (`sh.md`); `exit 1` in the program is a nonzero `exitCode`.
|
|
8
8
|
|
|
9
9
|
```awk [{"args": ["data.csv"]}] <!-- the body is the program -->
|
|
10
10
|
BEGIN { FS = "," }
|
package/docs/bun.md
CHANGED
|
@@ -14,5 +14,5 @@ console.log((await file.json()).name);
|
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
`console.log` streams to `#stdout`, `console.error` to `#stderr`; an uncaught
|
|
17
|
-
error or `process.exit(1)`
|
|
17
|
+
error or `process.exit(1)` is a nonzero `exitCode`. Live input
|
|
18
18
|
(`[{"stdin": "open"}]`, SEND, `[{"eof": true}]`) is as `node.md` shows.
|
package/docs/deno.md
CHANGED
|
@@ -15,5 +15,5 @@ console.log(JSON.stringify(versions));
|
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
`console.log` streams to `#stdout`, `console.error` to `#stderr`; an uncaught
|
|
18
|
-
error or `Deno.exit(1)`
|
|
18
|
+
error or `Deno.exit(1)` is a nonzero `exitCode`. Live input
|
|
19
19
|
(`[{"stdin": "open"}]`, SEND, `[{"eof": true}]`) is as `node.md` shows.
|
package/docs/lua.md
CHANGED
|
@@ -14,7 +14,7 @@ print(table.concat(t, ","))
|
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
`print` streams to `#stdout`, `io.stderr:write` to `#stderr`; `error(...)` or
|
|
17
|
-
`os.exit(1)`
|
|
17
|
+
`os.exit(1)` is a nonzero `exitCode`. The standalone interpreter is the host's
|
|
18
18
|
`lua` on PATH; project modules resolve through its ordinary `package.path` from
|
|
19
19
|
the working directory. Live input (`[{"stdin": "open"}]`, SEND,
|
|
20
20
|
`[{"eof": true}]`) is as `node.md` shows.
|
package/docs/node.md
CHANGED
|
@@ -15,7 +15,7 @@ ordinary relative filesystem paths resolve from the working directory.
|
|
|
15
15
|
Environment, working directory, channels, output on completion, exit status and lifetime
|
|
16
16
|
are every subprocess executor's, as `sh.md` states. Stdout is text, so structured
|
|
17
17
|
output is serialized (`console.log(JSON.stringify(value))`); a thrown error
|
|
18
|
-
exits nonzero
|
|
18
|
+
exits nonzero with its stack on stderr.
|
|
19
19
|
|
|
20
20
|
## Live input
|
|
21
21
|
|
package/docs/perl.md
CHANGED
|
@@ -4,7 +4,7 @@ The body is Perl code, run with `perl -e`; `-n`/`-p` have no equivalent here,
|
|
|
4
4
|
so a line loop is written in the body. A script target runs that file and
|
|
5
5
|
receives the body as stdin; `[{"args": [...]}]` passes literal arguments.
|
|
6
6
|
Environment, channels and exit status are every subprocess executor's (`sh.md`):
|
|
7
|
-
`die` or a nonzero `exit`
|
|
7
|
+
`die` or a nonzero `exit` is a nonzero `exitCode`.
|
|
8
8
|
|
|
9
9
|
```perl <!-- the body is the program -->
|
|
10
10
|
use strict; use warnings;
|
package/docs/ruby.md
CHANGED
|
@@ -13,7 +13,7 @@ puts JSON.generate(words.tally)
|
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
`puts` and `print` stream to `#stdout`, `warn` to `#stderr`; an unrescued
|
|
16
|
-
exception or `exit 1`
|
|
16
|
+
exception or `exit 1` is a nonzero `exitCode` with the backtrace on stderr. Gems
|
|
17
17
|
resolve from the project's ordinary Ruby environment; `[{"cwd": "<directory>"}]`
|
|
18
18
|
selects the working directory when the project's `Gemfile` lives elsewhere.
|
|
19
19
|
Environment metadata is every subprocess executor's (`sh.md`). Live input
|
package/docs/sh.md
CHANGED
|
@@ -47,7 +47,8 @@ terminal exit status. READ a range of the observation's `path` for any part:
|
|
|
47
47
|
```READ (sh:///ab3d5678#stdout) <17,40>
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
-
|
|
50
|
+
The observation carries the `exitCode`; a nonzero one is the command's answer,
|
|
51
|
+
not a failure. Stdout and stderr are separate channels,
|
|
51
52
|
and a diagnostic may be on either. The `log:///…/sh` receipt's own body is the
|
|
52
53
|
program exactly as sent, never output. A receipt with a non-200 status and no
|
|
53
54
|
`stream` address ran nothing; its body is still the program, and its Problem
|
|
@@ -62,7 +63,7 @@ time. This command is stopped after 30 seconds if it has not finished:
|
|
|
62
63
|
npm test
|
|
63
64
|
```
|
|
64
65
|
|
|
65
|
-
Expiry closes the stream with status 504. By contrast, `WAIT
|
|
66
|
+
Expiry closes the stream with status 504. By contrast, `WAIT [30]` limits one
|
|
66
67
|
wait to 30 seconds without stopping the command. Without `lifetime`,
|
|
67
68
|
the command is loop-bound; see `env.md` for other lifetime values.
|
|
68
69
|
|
package/docs/tcl.md
CHANGED
|
@@ -14,7 +14,7 @@ puts [dict get $count alpha]
|
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
`puts` streams to `#stdout`, `puts stderr ...` to `#stderr`; an uncaught error
|
|
17
|
-
or `exit 1`
|
|
17
|
+
or `exit 1` is a nonzero `exitCode` with the Tcl error info on stderr. tclsh
|
|
18
18
|
evaluates the script line by line, so an incomplete command at the end is an
|
|
19
19
|
error, not a silent no-op. Live input (`[{"stdin": "open"}]`, SEND,
|
|
20
20
|
`[{"eof": true}]`) is as `node.md` shows.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@plurnk/plurnk-execs-common",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.2",
|
|
4
4
|
"description": "Universal subprocess executor for plurnk-service's exec scheme — one package exposing the shell, Node.js, Python 3, and supported host interpreters.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"plurnk",
|
|
@@ -272,5 +272,5 @@
|
|
|
272
272
|
"peerDependencies": {
|
|
273
273
|
"@plurnk/plurnk-execs": "^3.0.0"
|
|
274
274
|
},
|
|
275
|
-
"gitHead": "
|
|
275
|
+
"gitHead": "70dd06512f02f66f94a1dae7702085f4980f1686"
|
|
276
276
|
}
|