rsh-crate 0.3.2

A simple shell written in rust, build for educational purpose. My goal is to learn more about rust and how interpreters work under the hood.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

# RSH 

RSH is a simple shell written in rust, build for educational purpose. My goal is to learn more about rust and how interpreters work under the hood.

## Feature
- [x] exit 
- [x] cd 
- [x] ls
- [x] pwd 
- [x] echo 
- [x] variables
- [x] touch 
- [x] cat 
- [x] mkdir 
- [x] arithmetic 
- [x] external commands 
- [x] comparisons 
- [x] command substitution 
- [x] pipeline
- [x] config file
- [x] alias
- [x] history
- [x] execute file
- [x] if else
- [x] comments
- [ ] command/filename/argument completion

 
## Installation Guide

Make sure you have rust installed.
```
rustc --version
```

### Install through cargo

```
cargo install rsh-crate
```

### Manual installed

```
# clone & open this repo
git clone https://github.com/Nattakit92/rsh.git && cd rsh

# build the from source
cargo build --release

# move rsh to cargo/bin
mv target/release/rsh $HOME/.cargo/bin

# cleaning up
cd .. && rm -rf rsh

```
## Usage

To use rsh simply open the terminal and run `rsh`

## Troubleshooting
> Unknown command: rsh

Check if bin directory exist
```
ls $HOME/.cargo/bin/
```
If .cargo/bin did not exist 
```
mkdir $HOME/.cargo $HOME.cargo/bin
```

Check if bin directory is in PATH environment variable
```
env| grep .cargo/bin
```
If bin directory is not in PATH environment variable.
Add the following line to your shell configuration file and restart your terminal:
```
export $HOME/.cargo/bin
```