forked from lix-project/lix
raito
b8cb7abcf0
Here's my guide so far:
$ rg '((?!(recursive).*) Nix
(?!(daemon|store|expression|Rocks!|Packages|language|derivation|archive|account|user|sandbox|flake).*))'
-g '!doc/' --pcre2
All items from this query have been tackled. For the documentation side:
that's for lix-project/lix#162.
Additionally, all remaining references to github.com/NixOS/nix which
were not relevant were also replaced.
Fixes: lix-project/lix#148.
Fixes: lix-project/lix#162.
Change-Id: Ib3451fae5cb8ab8cd9ac9e4e4551284ee6794545
Signed-off-by: Raito Bezarius <raito@lix.systems>
96 lines
2.3 KiB
Markdown
96 lines
2.3 KiB
Markdown
R""(
|
|
|
|
**Note:** this command's interface is based heavily around [*installables*](./nix.md#installables), which you may want to read about first (`nix --help`).
|
|
|
|
# Examples
|
|
|
|
* Run the default app from the `blender-bin` flake:
|
|
|
|
```console
|
|
# nix run blender-bin
|
|
```
|
|
|
|
* Run a non-default app from the `blender-bin` flake:
|
|
|
|
```console
|
|
# nix run blender-bin#blender_2_83
|
|
```
|
|
|
|
Tip: you can find apps provided by this flake by running `nix flake
|
|
show blender-bin`.
|
|
|
|
* Run `vim` from the `nixpkgs` flake:
|
|
|
|
```console
|
|
# nix run nixpkgs#vim
|
|
```
|
|
|
|
Note that `vim` (as of the time of writing of this page) is not an
|
|
app but a package. Thus, Lix runs the eponymous file from the `vim`
|
|
package.
|
|
|
|
* Run `vim` with arguments:
|
|
|
|
```console
|
|
# nix run nixpkgs#vim -- --help
|
|
```
|
|
|
|
# Description
|
|
|
|
`nix run` builds and runs [*installable*](./nix.md#installables), which must evaluate to an
|
|
*app* or a regular Nix derivation.
|
|
|
|
If *installable* evaluates to an *app* (see below), it executes the
|
|
program specified by the app definition.
|
|
|
|
If *installable* evaluates to a derivation, it will try to execute the
|
|
program `<out>/bin/<name>`, where *out* is the primary output store
|
|
path of the derivation, and *name* is the first of the following that
|
|
exists:
|
|
|
|
* The `meta.mainProgram` attribute of the derivation.
|
|
* The `pname` attribute of the derivation.
|
|
* The name part of the value of the `name` attribute of the derivation.
|
|
|
|
For instance, if `name` is set to `hello-1.10`, `nix run` will run
|
|
`$out/bin/hello`.
|
|
|
|
# Flake output attributes
|
|
|
|
If no flake output attribute is given, `nix run` tries the following
|
|
flake output attributes:
|
|
|
|
* `apps.<system>.default`
|
|
|
|
* `packages.<system>.default`
|
|
|
|
If an attribute *name* is given, `nix run` tries the following flake
|
|
output attributes:
|
|
|
|
* `apps.<system>.<name>`
|
|
|
|
* `packages.<system>.<name>`
|
|
|
|
* `legacyPackages.<system>.<name>`
|
|
|
|
# Apps
|
|
|
|
An app is specified by a flake output attribute named
|
|
`apps.<system>.<name>`. It looks like this:
|
|
|
|
```nix
|
|
apps.x86_64-linux.blender_2_79 = {
|
|
type = "app";
|
|
program = "${self.packages.x86_64-linux.blender_2_79}/bin/blender";
|
|
};
|
|
```
|
|
|
|
The only supported attributes are:
|
|
|
|
* `type` (required): Must be set to `app`.
|
|
|
|
* `program` (required): The full path of the executable to run. It
|
|
must reside in the Nix store.
|
|
|
|
)""
|