Almost done. Update plz 'man' and docs too.

Man updated. I'll update docs in the morning

Almost done. Update plz 'man' and docs too.

Docs updated

https://github.com/google/zx/actions/runs/12478218485

/usr/bin/bash: line 1: BAR: unbound variable
Error: /usr/bin/bash: line 1: BAR: unbound variable
    at Proxy.set (/home/runner/work/zx/zx/build/core.cjs:274:18)
    exit code: 1
    # Subtest: supports `--env` options with file
    not ok 12 - supports `--env` options with file
      ---
      duration_ms: 143.932467
      location: '/home/runner/work/zx/zx/test/cli.test.js:153:3'
      failureType: 'testCodeFailure'
      error: |-
        /usr/bin/bash: line 1: BAR: unbound variable
        Error: /usr/bin/bash: line 1: BAR: unbound variable
            at Proxy.set (/home/runner/work/zx/zx/build/core.cjs:274:18)
            exit code: 1
            at Proxy.set (/home/runner/work/zx/zx/build/core.cjs:274:18)
            exit code: 1
      code: 'ERR_TEST_FAILURE'

https://github.com/google/zx/actions/runs/12478218485

/usr/bin/bash: line 1: BAR: unbound variable
Error: /usr/bin/bash: line 1: BAR: unbound variable
    at Proxy.set (/home/runner/work/zx/zx/build/core.cjs:274:18)
    exit code: 1
    # Subtest: supports `--env` options with file
    not ok 12 - supports `--env` options with file
      ---
      duration_ms: 143.932467
      location: '/home/runner/work/zx/zx/test/cli.test.js:153:3'
      failureType: 'testCodeFailure'
      error: |-
        /usr/bin/bash: line 1: BAR: unbound variable
        Error: /usr/bin/bash: line 1: BAR: unbound variable
            at Proxy.set (/home/runner/work/zx/zx/build/core.cjs:274:18)
            exit code: 1
            at Proxy.set (/home/runner/work/zx/zx/build/core.cjs:274:18)
            exit code: 1
      code: 'ERR_TEST_FAILURE'

Yeap, I fixed.

Fix prettier

Why a custom implementation and not dotenv?

Why a custom implementation and not dotenv?

I figured that would be enough weight for simple logic.

@easymikey dotenv has none own dependencies, and the whole code is 360 lines of code.

It is simple today, tomorrow people will request variable expansion and what's your plan? Copy dotenv logic?

It is simple today, tomorrow people will request variable expansion and what's your plan? Copy dotenv logic?

I believe that if people demand it, then it can be done. Premature optimization is not needed here. But it's better for you to communicate with the mentainers.

Strictly speaking, passing custom env file is not required, as you can simple use dotenv explicitly in your script:

#!/usr/bin/env zx

import "dotenv/config";

await $`env`.pipe(process.stdout);

Strictly speaking, passing custom env file is not required, as you can simple use dotenv explicitly in your script:

#!/usr/bin/env zx

import "dotenv/config";

await $`env`.pipe(process.stdout);

Or this

#!/usr/bin/env zx

import "dotenv/config";

await $({
  preferLocal,
  env: process.env,
});