jish - A sh replica
Overview
jish is a UNIX command interpreter. It is a replica of the sh shell, built from scratch in C.
This project was developed as part of the Holberton School Low Level Systems specialization and is the second, more advanced version of the simple shell project completed in the Foundations year.
This project was written by J.I. Cruz, with assistance from Gabriel Abdul-Raheem.
Installation 🛠
Requirements
jishis only available for MacOS and Linux distributions.make
Clone this repository to your local system. Use the following to compile the program and save the executable into a file named jish:
make
Usage
Interactive shell
$ ./jish
- Run the executable file. Use the shell as if it were your normal shell. All commands-- including pipes, redirects, and aliases-- should work. That's it!
- Type
exitorCtrl-Dto exitjish.
Non-interactive mode
You can also use jish non-interactively. Use echo to pipe in a command to jish. The program will execute the inputted command(s) without re-prompting.
$ echo "ls" | ./jish
✨ Features ✨
jish can run any executables in the PATH. The following built-in commands are also available:
| Built-in | Use |
|---|---|
exit [status] |
Exit shell with specified exit status |
env |
Print list of current environment variables |
setenv |
Set an environment variable |
unsetenv |
Unset an environment variable |
cd |
Change directories |
history |
Print command history |
help |
Display help for builtin commands |
alias [ALIAS='COMMAND'] |
Alias a command as another. If no alias is given, print all aliases |
Release History 🧾
This is version 2.0 of a previous Holberton School project.
Gabriel's Previous Shell
- 1.0 - First release - 17 Apr 2020 | Written by Gabriel and Usman Abdul-Jabbar
J.I.'s Previous Shell
- 1.0 - First release - 17 Apr 2020 | Written by J.I. and Colson Scott
- 1.1 - Second release - 15 Sep 2020 | Because there was nothing better to do during COVID