2020-12-08 20:52:22 +00:00
R""(
2024-04-29 13:39:10 +00:00
**Note:** this command's interface is based heavily around [*installables* ](./nix.md#installables ), which you may want to read about first (`nix --help`).
2020-12-08 20:52:22 +00:00
# Examples
* Apply the build environment of GNU hello to the current shell:
```console
# . < (nix print-dev-env nixpkgs#hello)
```
2021-07-09 10:10:48 +00:00
* Get the build environment in JSON format:
```console
# nix print-dev-env nixpkgs#hello --json
```
The output will look like this:
```json
{
"bashFunctions": {
"buildPhase": " \n runHook preBuild;\n...",
...
},
"variables": {
"src": {
"type": "exported",
"value": "/nix/store/3x7dwzq014bblazs7kq20p9hyzz0qh8g-hello-2.10.tar.gz"
},
"postUnpackHooks": {
"type": "array",
"value": ["_updateSourceDateEpochFromSourceRoot"]
},
...
}
}
```
2020-12-08 20:52:22 +00:00
# Description
2021-07-09 10:10:48 +00:00
This command prints a shell script that can be sourced by `bash` and
that sets the variables and shell functions defined by the build
2022-12-01 00:57:02 +00:00
process of [*installable* ](./nix.md#installables ). This allows you to get a similar build
2020-12-08 20:52:22 +00:00
environment in your current shell rather than in a subshell (as with
`nix develop` ).
2021-07-09 10:10:48 +00:00
With `--json` , the output is a JSON serialisation of the variables and
functions defined by the build process.
2020-12-08 20:52:22 +00:00
)""