Skip to content

The objective of this project is for you to create a simple shell. Yes, your little bash or zsh.

License

Notifications You must be signed in to change notification settings

wwwwelton/minishell

Repository files navigation

Minishell

Minishell is the 8th project at 42. It tasks us to create a 'simple' shell. Yes, your little bash or zsh.

Demo

What is a shell?

Put simply, a shell is the outermost layer of communication between the user and operating system. Allowing us to navigate and execute tasks in human-readable language. If it breaks, you cannot talk anymore so it must be pretty reliable!

As part of the project we have implemented many features that are staple to linux shells. Those include running executables from absolute or relative path, like /usr/bin/ls or ls, which are fetched from the environment PATH. It handles pipe redirection with as many commands as needed. It supports usage of quotes and single quotes -- including nested ones -- and environment variable expansion. It handles specific signals like Ctrl-C Ctrl-\ and Ctrl-D to quit the program, in the same way as bash.

A few of the functions are "built-in", meaning we don't call the executable, but rather our own functions from inside the shell itself. It's the case for echo, pwd, cd, env, export, unset and exit. As part of the bonus, the operators &&, || and the wildcard * are supported. We have also implemented extra functionality, zsh-like redirection that handles multiple files both as input or output.

Application flow

We have created a schematic before beggining the project and updated it after completion. It shows you the broad strokes of the program and the files where you can find each feature.

Click here for the interactive link.

What we learned

This is the first project in 42's cursus where we need to work in a group, getting closer to a real life professional experience. Throughout these 45 days we have learned much about unix, how to plan a project in advance, split tasks in a way that work can be done simultaneously in multiple sections, descriptive documentation, more specialized git tools, automated testing and much more!

Badge

Objectives

  • Unix logic

Skills

  • Imperative programming
  • Rigor
  • Unix

Our grade

Getting started

Follow the steps below

# Requirements: GNU Readline Library
# To install the readline library, open the terminal window and write
sudo apt-get install libreadline-dev

# Clone the project and access the folder
git clone --recurse-submodules https://github.com/wwwwelton/minishell && cd minishell/

# Compile the program with
make

# Run the program
./minishell

# Write any shell command like
echo "hello minishell"

# Quit the program
exit

# Clean output objects with
make fclean

# Well done!

Updating

The project is regularly updated with bug fixes and code optimization.

📝 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.


Made by: João Rodriguez 👋 See my Github
Welton Leite 👋 See my linkedin

About

The objective of this project is for you to create a simple shell. Yes, your little bash or zsh.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published