An implementation of a very small shell [a 42 project].
This project follows Minishell and aims at getting a better grasp of the parsing theories, job control and general programming in Unix environment.
21sh implements some features such as multiple commands on the same line, redirections as well as multi-line edition that allows users to navigate through typed input.
Only the following functions were allowed for this project:
malloc, free, access, open, close, read, write, opendir, readdir, closedir, getcwd, chdir, stat, lstat, fstat, fork, execve, wait, waitpid, wait3, wait4, signal, kill, exit, pipe, dup, dup2, isatty, ttyname, ttyslot, ioctl, getenv, tcsetattr, tcgetattr, tgetent, tgetflag, tgetnum, tgetstr, tgoto, tputs
The command line edition feature uses only the termcaps library. It mimics as mush as possible the emacs and vim binding and edition mode can be modified using the set -o utility.
21sh implements:
-
Basic redirections such as
<>>>&>>&&< -
Pipes
| -
Command separators and background operator
;& -
Command line autocompletion using
<TAB> -
Command line history and lookup using arrows and
C-r -
hashbuiltin -
aliasutilities
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See below sections for notes on how to build and run the project on a live system.
git clone https://github.com/Ant0wan/21sh
Here are the things you need to build and use 21sh.
A C compiler and some utilities:
apt-get install -y gcc make
The Termcap library
apt-get install -y libncurses5-dev
In order to run the automated tests some additional utilities are required or need to be updated
apt-get install -y bash perl
There is only one step to build 21sh
make -j
In order to run the automated tests on your system make sure prerequisites are met, then simply execute the command
make test