# pedroferreira50/minishell_acabado architecture

> Architecture diagram of the GitHub repository pedroferreira50/minishell_acabado, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pedroferreira50/minishell_acabado
- Repository: https://github.com/pedroferreira50/minishell_acabado

## Overview

##### Project Type & Purpose
- Project Type: A command‐line interpreter (“mini shell”) written in C
- Purpose: Read user commands, parse and expand them, execute built-in or external programs, manage I/O redirection and pipelines, and handle environment and signals.

##### File Structure & Key Modules
Top‐level files:
- main.c + main_utils.c         → application entry point and loop
- minishell.h                   → central type definitions, constants

Major directories/modules:
- parse_input/                  → tokenize raw input into command segments
- parse_command/                → build command AST or data structures, syntax validation
- expand_vars/                  → variable and quote expansion logic
- builtins/                     → implementations of shell built‐ins (cd, echo, export, etc.)
- pipes_and_execution/          → fork/exec logic, pipelines, redirections, heredoc
- libft/                        → common utility functions (strings, memory, printing, lists)

Supporting files:
- signal.c                      → signal handling (SIGINT, SIGQUIT)
- error.c, free_*.c             → error reporting and memory cleanup
- find_command_path.c           → $PATH lookup for external commands

##### README
The README only provides the project name. All architectural details must be inferred from the file tree and naming conventions.

##### Core Components
a. User Interface (CLI Frontend)
– Reads input via readline or custom routines
– Sends raw string to parsing module

b. Parsing Layer
– parse_input: splits raw input into tokens/commands
– parse_command: validates syntax, constructs command structures

c. Expansion Layer
– expand_vars: performs environment‐variable and quote expansion

d. Dispatcher & Executor
– Determines if a command is built‐in or external
– builtins/*: runs built‐in functions in‐process
– pipes_and_execution/*: forks child processes, sets up pipes & redirections, execs external binaries

e. Environment Manager
– Maintains envp list, manipulated by export/unset
– print_env, env built‐in

f. Signal Handling
– signal.c: configures SIGINT/SIGQUIT behavior in parent and child processes

g. Utility Library
– libft: string, memory, list, I/O helpers reused by all modules

##### Relationships & Interactions
- Data Flow:
User Input → parse_input → parse_command → expand_vars → dispatcher
↳ If built‐in: builtins module → environment updates → return status
↳ Else external: pipes_and_execution → fork & exec → collect status
→ Loop back for next prompt

- Dependency Graph:
main
↳ parse_input
↳ parse_command
↳ expand_vars
↳ dispatcher ↔ builtins
↔ pipes_and_execution
↳ libft (used by all modules)
↳ signal

##### Architectural Patterns & Principles
– Modular separation (lexing, parsing, expansion, execution)
– Single responsibility per module
– In‐process built‐in vs. fork‐exec for external commands
– Explicit memory management and cleanup

##### Essential Elements
– Clear, concise labels for each module
– Note the signal handler’s influence on both parent and child process flows

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Nodes
    Main["CLI Frontend\n(main.c, main_utils.c)"]:::frontend
    CoreDef["Core Definitions & Types\n(minishell.h)"]:::core
    subgraph "Parsing Layer"
        ParserInput["Input Tokenizer\n(parse_input)"]:::parser
        ParserCmd["Command Builder & Validator\n(parse_command)"]:::parser
    end
    Expander["Expansion Layer\n(expand_vars)"]:::expansion
    Dispatcher["Dispatcher & Executor"]:::execution
    Builtins["Built-ins Module\n(builtins)"]:::builtin
    Executor["External Executor\n(pipes_and_execution)"]:::execution
    EnvManager["Environment Manager"]:::builtin
    SignalHandler["Signal Handler\n(signal.c)"]:::system
    Libft["Utility Library\n(libft/)"]:::util

    %% Flow
    Main -->|"reads input"| ParserInput
    ParserInput -->|"tokens"| ParserCmd
    ParserCmd -->|"AST / cmds"| Expander
    Expander -->|"expanded cmds"| Dispatcher
    Dispatcher -->|"built-in detection"| Builtins
    Dispatcher -->|"external cmd"| Executor
    Builtins -->|"status/env update"| Main
    Executor -->|"status"| Main

    %% Dependencies
    Main --> CoreDef
    Main --> SignalHandler
    ParserInput --> Libft
    ParserCmd --> Libft
    Expander --> Libft
    Dispatcher --> Libft
    Builtins --> Libft
    Executor --> Libft
    Builtins --> EnvManager

    SignalHandler -.-> Main
    SignalHandler -.-> Executor

    %% Click events
    click Main "https://github.com/pedroferreira50/minishell_acabado/blob/main/main.c"
    click Main "https://github.com/pedroferreira50/minishell_acabado/blob/main/main_utils.c"
    click CoreDef "https://github.com/pedroferreira50/minishell_acabado/blob/main/minishell.h"
    click ParserInput "https://github.com/pedroferreira50/minishell_acabado/tree/main/parse_input/"
    click ParserCmd "https://github.com/pedroferreira50/minishell_acabado/tree/main/parse_command/"
    click Expander "https://github.com/pedroferreira50/minishell_acabado/tree/main/expand_vars/"
    click Dispatcher "https://github.com/pedroferreira50/minishell_acabado/tree/main/pipes_and_execution/"
    click Builtins "https://github.com/pedroferreira50/minishell_acabado/tree/main/builtins/"
    click EnvManager "https://github.com/pedroferreira50/minishell_acabado/blob/main/builtins/env.c"
    click Executor "https://github.com/pedroferreira50/minishell_acabado/tree/main/pipes_and_execution/"
    click SignalHandler "https://github.com/pedroferreira50/minishell_acabado/blob/main/signal.c"
    click Libft "https://github.com/pedroferreira50/minishell_acabado/tree/main/libft/"

    %% Styles
    classDef frontend fill:#D8BFD8,stroke:#9370DB,stroke-width:2px
    classDef core fill:#EEE8AA,stroke:#DAA520,stroke-width:2px
    classDef parser fill:#ADD8E6,stroke:#1E90FF,stroke-width:2px
    classDef expansion fill:#E0FFFF,stroke:#20B2AA,stroke-width:2px
    classDef execution fill:#90EE90,stroke:#2E8B57,stroke-width:2px
    classDef builtin fill:#FFA500,stroke:#FF8C00,stroke-width:2px
    classDef util fill:#D3D3D3,stroke:#A9A9A9,stroke-width:2px
    classDef system fill:#FFDAB9,stroke:#FF6347,stroke-width:2px
```
