mirror of
https://github.com/Fechin/reference.git
synced 2026-11-20 21:23:11 +03:00
feat: add nix cheatsheet
This commit is contained in:
1 file changed
+314
@@ -0,0 +1,314 @@
|
||||
---
|
||||
title: Nix
|
||||
date: 2025-08-24 23:33:40
|
||||
background: bg-[#304673]
|
||||
tags:
|
||||
categories:
|
||||
- Programming
|
||||
intro: |
|
||||
The Nix quick reference cheat sheet that aims at providing help on writing basic nix code.
|
||||
plugins:
|
||||
- copyCode
|
||||
---
|
||||
|
||||
## Types & Syntax
|
||||
|
||||
### String
|
||||
|
||||
```nix
|
||||
let
|
||||
x = "single-line string";
|
||||
y = ''
|
||||
multi-line string
|
||||
'';
|
||||
in
|
||||
```
|
||||
|
||||
### Integer
|
||||
|
||||
```nix
|
||||
let
|
||||
x = -123;
|
||||
y - 123;
|
||||
in
|
||||
```
|
||||
|
||||
### Float
|
||||
|
||||
```nix
|
||||
let
|
||||
x = -0.32;
|
||||
y = 0.45;
|
||||
in
|
||||
```
|
||||
|
||||
### Boolean
|
||||
|
||||
```nix
|
||||
let
|
||||
x = true;
|
||||
y = false;
|
||||
in
|
||||
```
|
||||
|
||||
### Null
|
||||
|
||||
```nix
|
||||
let
|
||||
x = null;
|
||||
in
|
||||
```
|
||||
|
||||
### Path
|
||||
|
||||
```nix
|
||||
let
|
||||
x = /absolute/path;
|
||||
y = ./relative/path;
|
||||
in
|
||||
```
|
||||
|
||||
### Attribute Set
|
||||
|
||||
```nix
|
||||
let
|
||||
x = {
|
||||
a = 1;
|
||||
b = 2;
|
||||
};
|
||||
y = { c = 3; };
|
||||
in
|
||||
```
|
||||
|
||||
see [Attribute Sets](#attribute-sets)
|
||||
|
||||
### List
|
||||
|
||||
```nix
|
||||
let
|
||||
x = [ 1 2.0 ];
|
||||
y = [
|
||||
1
|
||||
"this is a string"
|
||||
23.0
|
||||
null
|
||||
];
|
||||
in
|
||||
```
|
||||
|
||||
### Comment
|
||||
|
||||
#### ↓ single-line comment
|
||||
|
||||
```nix
|
||||
# your comment
|
||||
```
|
||||
|
||||
#### ↓ multi-line comment
|
||||
|
||||
```nix
|
||||
/*
|
||||
your comment
|
||||
*/
|
||||
```
|
||||
|
||||
## Scoping
|
||||
|
||||
### Define Local Variable
|
||||
|
||||
```nix
|
||||
let
|
||||
x = 1;
|
||||
y = 2;
|
||||
in
|
||||
x + y # -> returns 3
|
||||
```
|
||||
|
||||
### Add Variables Into Scope
|
||||
|
||||
```nix
|
||||
let
|
||||
x = 1;
|
||||
in
|
||||
{ inherit x; }
|
||||
```
|
||||
|
||||
#### ↓ desugars to
|
||||
|
||||
```nix
|
||||
let
|
||||
x = 1;
|
||||
in
|
||||
{ x = x; }
|
||||
```
|
||||
|
||||
### Add Attributes Into Scope
|
||||
|
||||
```nix
|
||||
let
|
||||
x = { y = 1; };
|
||||
in
|
||||
{ inherit (x) y; }
|
||||
```
|
||||
|
||||
#### ↓ desugars to
|
||||
|
||||
```nix
|
||||
let
|
||||
x = { y = 1; };
|
||||
in
|
||||
{ y = x.y; }
|
||||
```
|
||||
|
||||
### Add All Attributes Into Scope
|
||||
|
||||
```nix
|
||||
let
|
||||
x = { y = 1; z = 2; };
|
||||
in
|
||||
with x;
|
||||
y + z # -> returns 3
|
||||
```
|
||||
|
||||
## Conditionals
|
||||
|
||||
### Define Conditionals
|
||||
|
||||
```nix
|
||||
if x > 0
|
||||
then 1
|
||||
else -1
|
||||
```
|
||||
|
||||
## Attribute Sets
|
||||
|
||||
### Define Attribute Sets
|
||||
|
||||
```nix
|
||||
let
|
||||
x = {
|
||||
a = 1;
|
||||
b = 2;
|
||||
};
|
||||
y = { c = 3; };
|
||||
in
|
||||
```
|
||||
|
||||
### Update Attribute Sets
|
||||
|
||||
```nix
|
||||
{ x = 1; } // { y = 2; } # -> returns { x = 1; y = 2; }
|
||||
{ x = 1; } // { x = 2; } # -> returns { x = 2; }
|
||||
```
|
||||
|
||||
### Check For Attribute
|
||||
|
||||
```nix
|
||||
let
|
||||
x = { y = 1; };
|
||||
in
|
||||
x ? y # -> returns true
|
||||
```
|
||||
|
||||
### Reference Attirbute Keys
|
||||
|
||||
```nix
|
||||
let
|
||||
x = { y = 1; };
|
||||
in
|
||||
x.y # -> returns 1
|
||||
```
|
||||
|
||||
#### ↓ optional
|
||||
|
||||
```nix
|
||||
let
|
||||
x = { y = 1; };
|
||||
in
|
||||
x.z or 2 # -> returns 2
|
||||
```
|
||||
|
||||
## Concatenation & Interpolation
|
||||
|
||||
### Concatenate Lists
|
||||
|
||||
```nix
|
||||
[ 1 2 ] ++ [ 3 4 ] # -> returns [ 1 2 3 4 ]
|
||||
```
|
||||
|
||||
### Concatenate Paths & Strings
|
||||
|
||||
```nix
|
||||
/bin + /sh # -> returns /bin/sh
|
||||
/bin + "/sh" # -> returns /bin/sh
|
||||
"/bin" + "/sh" # -> returns "/bin/sh"
|
||||
```
|
||||
|
||||
### Interpolate Strings
|
||||
|
||||
```nix
|
||||
let
|
||||
x = "bar";
|
||||
in
|
||||
"foo ${x} baz" # -> returns "foo bar baz"
|
||||
```
|
||||
|
||||
## Functions
|
||||
|
||||
### Simple Function
|
||||
|
||||
```nix
|
||||
let
|
||||
f = x: x + 1;
|
||||
in
|
||||
f 1 # -> returns 2
|
||||
```
|
||||
|
||||
### Multiple Arguments
|
||||
|
||||
```nix
|
||||
let
|
||||
f = x: y: [ x y ];
|
||||
in
|
||||
f 1 2 # -> returns [ 1 2 ]
|
||||
```
|
||||
|
||||
### Named Arguments
|
||||
|
||||
```nix
|
||||
let
|
||||
f = {x, y}: x + y;
|
||||
in
|
||||
f { x=1; y=2; } # -> returns 3
|
||||
```
|
||||
|
||||
#### ↓ ignoring arguments
|
||||
|
||||
```nix
|
||||
let
|
||||
f = {x, y, ... }: x + y;
|
||||
in
|
||||
f { x=1; y=2; z=3; } # -> returns 3
|
||||
```
|
||||
|
||||
#### ↓ default values
|
||||
|
||||
```nix
|
||||
let
|
||||
f = {x, y ? 2 }: x + y;
|
||||
in
|
||||
f { x=1; } # -> returns 3
|
||||
```
|
||||
|
||||
#### ↓ bind to variable
|
||||
|
||||
```nix
|
||||
let
|
||||
f = {x, y}@args: args.x + args.y;
|
||||
in
|
||||
f { x=1; y=2; } # -> returns 3
|
||||
```
|
||||
|
||||
## Sources
|
||||
|
||||
- [NixOS/marketing](https://github.com/nixos/marketing) _(github.com)_
|
||||
Reference in new issue
Block a user