Skip to content

Latest commit

 

History

History
99 lines (68 loc) · 3.21 KB

README.md

File metadata and controls

99 lines (68 loc) · 3.21 KB
Raw

The ReShell Project

Warning

This project is under heavy development. The syntax, builtin library and REPL features are constantly being updated and may encounter breaking changes without notice. Please use this project at your own risks!

The ReShell project aims to provide a complete alternative to popular Linux shells such as the sh family (sh, bash, zsh, ksh, ...), as well as Windows' PowerShell and Batch (COMMAND.COM).

It is designed to be as easy to use as possible, and feature many functions that are not available in most shells: functions returning values, lambdas, optional typechecking, nested arrays, complete error handling, etc.

Everything is designed to work out-of-the-box: completion, syntax highlighting, history handling, etc.

Here is an example:

let num = randInt(1, 100)
let mut lives = 10

while true {
    let guess = ask("Guess the number: ")

    let guess = try { $guess.parseInt() } catch _ { null }

    if $guess == null {
        continue
    }

    if $guess > $num {
        echo "Lower!"
    } else if $guess < $num {
        echo "Higher!"
    } else {
        echo "You win! :D"
        break
    }

    $lives = $lives - 1

    if $lives > 0 {
        echo "Too bad... You have $lives attempt(s) left!"
    } else {
        echo "Too bad... You've lost :("
        break
    }
}

Tutorial

You can find a guide to learn about the language here.

Features

  • Fits in a single binary with zero dependency
  • Cross-platform (currently tested on Linux and Windows)
  • Powerful scripting language
  • Exhaustive native library
  • Complete REPL with prompt customization, pretty error handling, syntax highlighting and completions

Limitations

  • Typing is dynamic, meaning there isn't optional ahead-of-time typechecking like NuShell
  • Strings are always valid UTF-8, which brings lots of advantages but will make dealing with some non-UTF-8 filenames more complicated or straight up impossible

vs. NuShell

Compared to NuShell, the latter is designed as an alternative way to interact with data. As it is mostly based on tables and functional data processing, it may be more suited to your needs depending on what you want. ReShell's scripting language provides some functional programming features as well, but remains an imperative language at core.

Installing

Start by installing Rust. Then, run:

cargo install --git https://github.com/ClementNerma/ReShell

This will install a reshell binary globally in your system.

You can also build from scratch:

# Clone the repository
git clone https://github.com/ClementNerma/ReShell

# Build with optimizations
cargo build --release

# Run the produced binary
./target/release/reshell

Code structure

The code is divided into several crates:

  • parser: complete parser based on Parsy's combinators
  • checker: performs code checking and collect data to accelerate runtime
  • runtime: executes a parsed and checked program
  • builtins: contains all of the native library
  • repl: interactive REPL with support for scope re-use