42-minishell

The objective of this project is to create a simple shell, like an own little bash.
It is the first group project in the 42 core curriculum.

Project specifications

For the project we were allowed to use GNU's readline library which handles the terminal interaction (history & input reading). For everything else the subject allows only to use a few low-level functions and a few POSIX system calls.

Allowed functions: readline, rl_clear_history, rl_on_new_line,rl_replace_line, rl_redisplay, add_history, printf, malloc, free, write, access, open, read,close, fork, wait, waitpid, wait3, wait4, signal, sigaction, sigemptyset, sigaddset, kill, exit, getcwd, chdir, stat, lstat, fstat, unlink, execve, dup, dup2, pipe, opendir, readdir, closedir, strerror, perror, isatty, ttyname, ttyslot, ioctl, getenv, tcsetattr, tcgetattr, tgetent, tgetflag, tgetnum, tgetstr, tgoto, tputs

Features

Basics:

History of previous entered commands
Search and launch the right executable (based on the PATH variable, using a relative or an absolute path)
Environment variables ($ followed by a sequence of characters) expand to their values
ctrl-C, ctrl-D and ctrl-\ behave like in bash
’ (single quotes - prevent from interpreting meta-characters in quoted sequence)
" (double quotes - prevent from interpreting meta-characters in quoted sequence except for $)
$? expands to the last exit status
| connect cmds or groups with pipes; output of a cmd is connected to the input of the next cmd via a pipe

Builtins:

echo with option -n
cd (relative or absolute path, - for OLDPWD, without arg for HOME)
pwd without options
export without options
unset without options
env without options
exit [exit_status] without options

Redirections:

[n] (optional) specifies the file descriptor, if not specified it is stdout/stdin

[n]< file Redirecting Input
[n]<< limiter Here Documents
[n]> file Redirecting Output
[n]>> file Appending Redirected Output

How to use

The current version of minishell is developed and tested on macOS, but it should work on all UNIX/LINUX based systems as well.

Requirements:

GCC / CLANG Compiler
GNU Make
GNU Readline library

git clone https://github.com/Asrasal47/42-minishell.git minishell

cd minishell && make

./minishell

Dependencies

Install readline with brew

brew install readline

brew link --force readline

Add the path to the lib

Replace ~/.zshrc with ~/.bashrc if you use zsh instead of bash

echo 'export C_INCLUDE_PATH="/usr/local/opt/readline/include:$C_INCLUDE_PATH"' >> ~/.zshrc

echo 'export LIBRARY_PATH="/usr/local/opt/readline/lib:$LIBRARY_PATH"' >> ~/.zshrc

source ~/.zshrc

Install readline on 42 Macs

Install Brew, only if it is not already installed:

rm -rf $HOME/.brew && git clone --depth=1 https://github.com/Homebrew/brew $HOME/.brew && echo 'export PATH=$HOME/.brew/bin:$PATH' >> $HOME/.zshrc && source $HOME/.zshrc && brew update

Install Readline library:

brew install readline

brew link --force readline

echo 'export C_INCLUDE_PATH="$HOME/.brew/include:$C_INCLUDE_PATH"' >> ~/.zshrc

echo 'export LIBRARY_PATH="$HOME/.brew/lib:$LIBRARY_PATH"' >> ~/.zshrc

source ~/.zshrc

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Fork the Project

Create your Feature Branch (git checkout -b feature/AmazingFeature)

Commit your Changes (git commit -m 'Add some AmazingFeature')

Push to the Branch (git push origin feature/AmazingFeature)

Open a Pull Request