nushell/docs/commands/with-env.md
JT 8c0a2d3c15
Auto-generate markdown command docs (#4451)
* Finish updating

* a couple improvements

* Update renames

* cleanup examples
2022-02-13 21:22:51 -05:00

40 lines
680 B
Markdown

---
title: with-env
layout: command
version: 0.59.0
---
Runs a block with an environment variable set.
## Signature
```> with-env (variable) (block)```
## Parameters
- `variable`: the environment variable to temporarily set
- `block`: the block to run once the variable is set
## Examples
Set the MYENV environment variable
```shell
> with-env [MYENV "my env value"] { $env.MYENV }
```
Set by primitive value list
```shell
> with-env [X Y W Z] { $env.X }
```
Set by single row table
```shell
> with-env [[X W]; [Y Z]] { $env.W }
```
Set by row(e.g. `open x.json` or `from json`)
```shell
> echo '{"X":"Y","W":"Z"}'|from json|with-env $it { echo $env.X $env.W }
```