CheatNushell Structured data shell
Light · Postcard
102 × 152 mm · PDF
Dark · Postcard
102 × 152 mm · PDF
Ink saver · Postcard
102 × 152 mm · PDF
Light · A4 landscape
297 × 210 mm · PDF
Dark · A4 landscape
297 × 210 mm · PDF
Ink saver · A4 landscape
297 × 210 mm · PDF
Light · A3 landscape
420 × 297 mm · PDF
Dark · A3 landscape
420 × 297 mm · PDF
Ink saver · A3 landscape
420 × 297 mm · PDF
Start here
ls | where size > 1mb
Filter rows
open <file>
Load as data
select <col> ...
Pick columns
sort-by <col>
Sort rows
get <col>Extract a value
let <name> = <value>
Set a variable
def <name> [args] { }
Custom command
help <command>
Built-in docs
Concepts
- Source ls, open, ps
- Table rows + columns
- Filtered still structured
- Output text or file
Navigate & files
lsList files as a table
ls -aInclude hidden files
ls **/*.rsGlob recursively
cd <dir>Change directory
mkdir <dir>
Create directory with parents
cp -r <src> <dst>
Copy recursively
mv <src> <dst>
Move or rename
rm -r <path>
Remove recursively
rm sends to trash by default on most platforms; use -p to
delete permanently
Open & convert
open <file>
Load file, parsed by extension
open --raw <file>
Read as plain text
save <file>
Write pipeline to file
from json / from yaml / from csv
Parse text into data
to json / to yaml / to csv
Render data as text
http get <url>
Fetch URL, parse JSON
Filter & shape
where <col> == <val>
Keep matching rows
where {|r| $r.size > 1kb }
Filter with a closure
select <col> <col>
Keep columns
reject <col>
Drop columns
get <col>Pull out column or field
get a.b.0Cell path into nested data
sort-by <col>
Sort rows
sort-by -r <col>
Sort descending
first <n> / last <n>
Take rows from either end
skip <n>Drop first rows
each {|x| ... }Map over items
lengthCount items
update <col> {|r| ... }
Change a column
insert <col> {|r| ... }
Add a new column
Strings & text
$"hello ($name)"
Interpolate expressions
str replace <a> <b>
Replace text
str replace -r <re> <b>
Replace by regex
str contains <text>
Substring test
split row <sep>
String to list
linesSplit text into lines
=~ / !~Regex match operators
Variables & flow
let <name> = <value>
Immutable variable
mut <name> = <value>
Mutable variable
if <cond> { } else { }
Conditional (an expression)
for i in 1..5 { print $i }
Loop over range or list
try { } catch { }
Handle errors
$inPipeline input inside a block
{a: 1, b: 2}Record literal
[1 2 3]List literal, space separated
Commands & modules
def <name> [x: int] { }
Custom command
def <name> [--flag, --opt: string] { }
Flags and options
def <name> [x?: int] { }
Optional parameter
{|x| $x * 2 }Closure
alias <name> = <cmd>
Short alias
use <module>
Load a module
nu <script.nu>
Run a script file
help commandsSearch all commands
help <command>
Help for one command
Environment & config
$env.FOO = "bar"
Set environment variable
$env.FOO?Read variable, null if unset
$env.PATH ++= ["~/bin"]
Append to PATH
config nuEdit config.nu
Externals & I/O
^<cmd>Force the external command
Use ^ssh or ^ls to bypass a same-named built-in
cmd | completeCapture stdout, stderr, exit code
Bash to Nushell
| Bash | Nushell |
|---|---|
export FOO=bar |
$env.FOO = "bar" |
echo $FOO |
$env.FOO |
a && b |
a; b |
a || b |
try { a } catch { b } |
echo "x $(cmd)" |
$"x (cmd)" |
cmd | head -5 |
cmd | first 5 |
cat file |
open --raw file |
unset FOO |
hide-env FOO |
find . -name '*.rs' |
ls **/*.rs |
cmd > file 2>&1 |
cmd o+e> file |
Recipes
ls **/* | where type == file | sort-by size | reverse | first 10 | select name sizeopen package.json | update version "2.0.0" | save -f package.jsonhttp get https://api.github.com/repos/nushell/nushell/releases | select tag_name published_at | first 5 | to csvdef greet [name: string, --loud] { if $loud { $name | str upcase } else { $name }}
