Plan for v8

[antonmedv]

Here is a plan of what I'm planning to do for the next v8 release. Feel free to join, by picking one on the objectives.

v8

• Set $.verbose = false by default ∅
  • stderr should be echoed by default.
  • stdout should not be printed by default.
• Refactor $ to support const $$ = $({...}) syntax.
  • AbortController support by $.
  • Split $ into a separate package with minimum dependencies. (probably)
    • Add zx/core.
  • Remove ps-tree dependency.
  • (probably) Deprecate within().
    • Refactor process.cwd() calls
  • Add trim to ProcessOutput::valueOf(): string
  • Add $.sync API.
• Use bash by default on Windows (and fail if not found, with ZX_SHELL env config).
• Use node18 by default (but allow zx to run on node16 too).
  • Remove node-fetch dependency (node18 already has fetch, this allows to drop DOM lib in ts).
• Add some CI tests for deno.
• Bundle deps.

Future

• Better support for multiline commands.
• Better support for dotenv.
• $.log refactoring (probably)
  • todo
• Remove fs-extra dependency (probably)
• Add exit()
• Add pool()
• Add progressBar()
• Improve retry()
• Improve --install
• Add API for plugins*

Note: Before submitting PR, discuss implementation and API.
Note: * - complex task.

[stevage]

Is this the place to discuss these plans?

If so: personally I am glad that fs-extra is included by default. It includes fs.readJsonSync() which is exactly the kind of convenience that is nice in zx.

It also isn't clear whether the above addresses #636. What I (and I think others) would like is a decoupling of:

• whether the command is printed
• whether stdout is printed
• whether stderr is printed

[antonmedv]

My idea about new verbose mode for $:

• Set $.verbose = false by default
• stderr should be echoed by default.
• stdout should not be printed by default.

I also was planning to drop fs-extra by default.

[stevage]

IMHO the default behaviour should be similar to a Bash script:

• command is not echoed
• stdout is printed
• stderr is printed

If you make stdout not printed by default it will be confusing in a case like:

$`echo Hello world`

which well then of course behave differently from

echo`Hello world`

What's the rationale?

[antonmedv]

JS equivalent of echo is console.log. The problem with outputting $ by default is what we cannot distinguishes how it used:

await $`some-command`

versus

const output = await $`some-command`

So the idea is to not output anything(defaul behavior), allow to override with $.verbose =true.

Or you can simple redirect stdout:

await $`some-command`.pipe(process.stdout)

[stevage]

JS equivalent of echo is console.log.

Personally, I think of ZX as a replacement for Bash, so it's more important that it works, by default, similarly. Most of my scripts have the expectation of being a little bit noisy - running commands, and having the output go to the console, so the user can see what is happening while it is running.

Making it so that doesn't happen is the Bash equivalent of writing > /dev/null at the end of every line, which would, for me, be unusual.

I don't dispute that there are situations where it's preferable not to pass stdout to the command line, but I think the default should be around the other way. And of course, changing the default will change the behaviour of every existing script.

Perhaps you'd consider additional per-command flags in any case, which would also protect scripts against future changes to this default:

await $.noisy`some-command`

const output=$.quiet`some-command`

[antonmedv]

What is different between $.noisy and .pipe(process.stdout)?

[stevage]

I don't know, because I haven't tried the pipe method, and it wouldn't necessarily occur to me either. Thus far in my usage of zx, have not had to use .pipe() or process.stdout.

[lawrenceching]

Suggest to release the v8 document ASAP.

I take hours to find out why the default value changed for $.verbose.
npm install v8 for me by default, and I didn't aware of that. I kept checking the v7 document and feeling confused.