MiniDevil documentation

What is MiniDevil?

MiniDevil is a POSIX inspired shell written in C as a 42 school project.
It reads a line from terminal then breaks it into tokens and parses them into an AST (Abstract Syntax Tree) & executes the tree.

How does it work?

Entry point

main() in src/main.c initialises t_shell, calls main_loop().
main_loop() is a REPL that sets up signals, reads one line of input, passes it to handle_input(), frees it, and repeats until the shell exits.

Where to start

• File list
• Signal handling strategy
• Execution model
• Memory ownership rules
• File descriptors lifecycle
• Exit status rules

Module index

• Lexer (Tokenizer + expander)
• Parser (AST construction)
• Executor (commands, pipes & redirections)
• Builtin commands
• Environment management
• Signal handling
• UI Mode (optional)

External links

• Allowed external functions explained
• Bonus part explained w/ examples

Authors

• zotaj-di (github @L3awdman)
• baelgadi (github @baderelg)