nushell/crates/nu-command/src/env
Stefan Holderbach c9e9b138eb
Improve with-env robustness (#12523)
# Description
Work for #7149

- **Error `with-env` given uneven count in list form**
- **Fix `with-env` `CantConvert` to record**
- **Error `with-env` when given protected env vars**
- **Deprecate list/table input of vars to `with-env`**
- **Remove examples for deprecated input**

# User-Facing Changes

## Deprecation of the following forms

```
> with-env [MYENV "my env value"] { $env.MYENV }
my env value

> with-env [X Y W Z] { $env.X }
Y

> with-env [[X W]; [Y Z]] { $env.W }
Z
```

## recommended standardized form

```
# Set by key-value record
> with-env {X: "Y", W: "Z"} { [$env.X $env.W] }
╭───┬───╮
│ 0 │ Y │
│ 1 │ Z │
╰───┴───╯
```

## (Side effect) Repeated definitions in an env shorthand are now
disallowed

```
> FOO=bar FOO=baz $env
Error: nu:🐚:column_defined_twice

  × Record field or table column used twice: FOO
   ╭─[entry #1:1:1]
 1 │ FOO=bar FOO=baz $env
   · ─┬─     ─┬─
   ·  │       ╰── field redefined here
   ·  ╰── field first defined here
   ╰────
```
2024-04-16 19:08:58 +08:00
..
config Rename IoStream to OutDest (#12433) 2024-04-09 16:48:32 +00:00
export_env.rs Add command_prelude module (#12291) 2024-03-26 21:17:30 +00:00
load_env.rs Disallow setting the PWD via load-env input (#12522) 2024-04-15 21:09:58 +02:00
mod.rs remove let-env, focus on mutating $env (#9574) 2023-07-01 07:57:51 +12:00
source_env.rs Add command_prelude module (#12291) 2024-03-26 21:17:30 +00:00
with_env.rs Improve with-env robustness (#12523) 2024-04-16 19:08:58 +08:00