2019-05-17 18:59:25 +02:00
# Nu Shell
A shell for the GitHub era. A shell you can hack on.
# Status
This project has little of what will eventually be necessary for Nu to serve as your day-to-day shell. It already works well enough for contributors to dogfood it as their daily driver, but there are too many basic deficiencies for it to be useful for most people.
At the moment, executing a command that isn't identified as a built-in new command will fall back to running it as a shell command (using cmd on Windows or bash on Linux and MacOS), correctly passing through stdin, stdout and stderr, so things like your daily git workflows and even `vim` will work just fine.
There is not yet support for piping external commands to each other; piping is limited to Nu commands at the moment.
Nu currently has the following built-in commands:
2019-05-29 06:07:03 +02:00
- cd directory
2019-05-17 18:59:25 +02:00
- ls
- ps
2019-05-29 06:07:03 +02:00
- column ...fields
2019-05-17 18:59:25 +02:00
- reject ...fields
- sort-by ...fields
- where condition
- skip amount
2019-05-29 06:07:03 +02:00
- first amount
2019-05-17 18:59:25 +02:00
- to-array
2019-05-29 06:07:03 +02:00
- to-json
2019-06-01 20:27:56 +02:00
- to-toml
2019-05-29 06:07:03 +02:00
- from-json
2019-06-01 09:06:28 +02:00
- from-toml
2019-05-29 06:07:03 +02:00
- open filename
2019-05-31 22:34:15 +02:00
- split-column sep ...fields
- split-row sep ...fields
2019-05-29 06:07:03 +02:00
- select field
2019-06-01 05:46:13 +02:00
- trim
2019-05-17 18:59:25 +02:00
# Goals
Prime Directive: Cross platform workflows, with first-class consistent support for Windows, OSX and Linux.
Priority #1: direct compatibility with existing platform-specific executables that make up people's workflows
Priority #2: Create workflow tools that more closely match the day-to-day experience of using a shell in 2019 (and beyond)
Priority #3: It's an object shell like PowerShell.
> These goals are all critical, project-defining priorities. Priority #1 is "direct compatibility" because any new shell absolutely needs a way to use existing executables in a direct and natural way.
2019-06-02 18:49:56 +02:00
# License
The project is made available under the MIT license. See "LICENSE" for more information.
2019-05-17 18:59:25 +02:00
# A Taste of Nu
2019-06-02 19:18:24 +02:00
Nu has built-in commands for ls and ps, loading these results into a table you can work with.
2019-05-17 18:59:25 +02:00
```text
2019-05-18 05:18:17 +02:00
~\Code\nushell> ps | where cpu > 0
2019-06-02 19:18:24 +02:00
C:\Source\Play\nushell(master)> ps | where cpu > 0
------------------------------------------------
name cmd cpu pid status
------------------------------------------------
msedge.exe - 0.77 26472 Runnable
------------------------------------------------
nu.exe - 7.83 15473 Runnable
------------------------------------------------
SearchIndexer.exe - 82.17 23476 Runnable
------------------------------------------------
BlueJeans.exe - 4.54 10000 Runnable
------------------------------------------------
```
Commands are linked together with pipes, allowing you to select the data you want to use.
```text
~\Code\nushell> ps | where name == chrome.exe | first 5
----------------------------------------
name cmd cpu pid status
----------------------------------------
chrome.exe - 0.00 22092 Runnable
----------------------------------------
chrome.exe - 0.00 17324 Runnable
----------------------------------------
chrome.exe - 0.00 16376 Runnable
----------------------------------------
chrome.exe - 0.00 21876 Runnable
----------------------------------------
chrome.exe - 0.00 13432 Runnable
----------------------------------------
```
The name of the columns in the table can be used to sort the table.
2019-05-17 18:59:25 +02:00
2019-06-02 19:18:24 +02:00
```text
2019-05-17 18:59:25 +02:00
~\Code\nushell> ls | sort-by "file type" size
2019-06-02 19:18:24 +02:00
----------------------------------------------------------------------------------------
file name file type readonly size created accessed modified
----------------------------------------------------------------------------------------
.cargo Directory Empty a week ago a week ago a week ago
----------------------------------------------------------------------------------------
.git Directory Empty 2 weeks ago 9 hours ago 9 hours ago
----------------------------------------------------------------------------------------
images Directory Empty 2 weeks ago 2 weeks ago 2 weeks ago
----------------------------------------------------------------------------------------
src Directory Empty 2 weeks ago 10 hours ago 10 hours ago
----------------------------------------------------------------------------------------
target Directory Empty 10 hours ago 10 hours ago 10 hours ago
----------------------------------------------------------------------------------------
tests Directory Empty 14 hours ago 10 hours ago 10 hours ago
----------------------------------------------------------------------------------------
tmp Directory Empty 2 days ago 2 days ago 2 days ago
----------------------------------------------------------------------------------------
rustfmt.toml File 16 B a week ago a week ago a week ago
----------------------------------------------------------------------------------------
.gitignore File 32 B 2 weeks ago 2 weeks ago 2 weeks ago
----------------------------------------------------------------------------------------
.editorconfig File 156 B 2 weeks ago 2 weeks ago 2 weeks ago
----------------------------------------------------------------------------------------
```
2019-05-17 18:59:25 +02:00
2019-06-02 19:18:24 +02:00
You can also use the names of the columns to down-select to only the data you want.
```text
2019-05-29 06:07:03 +02:00
~\Code\nushell> ls | column "file name" "file type" size | sort-by "file type"
2019-06-02 19:18:24 +02:00
------------------------------------
file name file type size
------------------------------------
.cargo Directory Empty
------------------------------------
.git Directory Empty
------------------------------------
images Directory Empty
------------------------------------
src Directory Empty
------------------------------------
target Directory Empty
------------------------------------
tests Directory Empty
------------------------------------
rustfmt.toml File 16 B
------------------------------------
.gitignore File 32 B
------------------------------------
.editorconfig File 156 B
------------------------------------
2019-05-17 18:59:25 +02:00
```
2019-06-02 19:18:24 +02:00
Some file times can be loaded as tables.
```text
~\Code\nushell> open Cargo.toml
----------------------------------------------------
dependencies dev-dependencies package
----------------------------------------------------
[object Object] [object Object] [object Object]
----------------------------------------------------
~\Code\nushell> open Cargo.toml | select package
--------------------------------------------------------------------------
authors description edition license name version
--------------------------------------------------------------------------
[list List] A shell for the GitHub era 2018 MIT nu 0.1.1
--------------------------------------------------------------------------
```
2019-05-17 18:59:25 +02:00
Nu currently has fish-style completion of previous commands, as well ctrl-r reverse search.
![autocompletion][fish-style]
[fish-style]: ./images/nushell-autocomplete.gif "Fish-style autocomplete"
