# pranavbhattarai/linux101 architecture

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

- Interactive diagram: https://gitdiagram.com/pranavbhattarai/linux101
- Repository: https://github.com/pranavbhattarai/linux101

## Overview

##### Main Components
- Repository Root: Think of this as the central “control hub” that organizes various scripts and configurations.
- Script & Automation Components: These include Python scripts (e.g., “Patch GNS3VM for Cisco Routers.py”, “Remove Background Image.py”) and numerous bash scripting directories (such as “bash_scripting”, “console script to download pdf”, etc.).
- Configuration/Customization Modules: Directories like “configure shell & terminal”, “custom perferences for GNOME”, “boot”, and distro-specific folders like “fedora-34-begans” and “ubuntu-18.04-begans” indicate targeted customizations for particular Linux distributions.
- DevOps/Networking & System Administration: Folders such as “DevOps”, “networking”, “security”, “sysAdmin-Linux”, “sysAdmin-Windows”, and “tracking-bugs” cover broader system management and troubleshooting aspects.
- External Tools Integration: Files like “Patch GNS3VM for Cisco Routers.py” hint at integration with virtual network setups, demonstrating the project’s use in handling external network systems.

##### Relationships and Interactions
- At the center, the repository aggregates all the scripts and configuration modules.
- The automation scripts are designed to be executed (manually or via scheduling) to apply certain changes or customizations; thus, they “read from” the configuration directories and “apply” modifications on the system.
- Some components (like DevOps and sysAdmin directories) interact with external systems or environments (e.g., bug tracking tools, network devices in GNS3).

##### Architectural Patterns and Design Principles
- Modular Organization: The file tree indicates a highly modular, loosely coupled design where each directory groups scripts relevant to a particular domain or task. This is akin to a micro-module approach, making maintenance and upgrades easier.
- Separation of Concerns: There’s a clear separation between operating system customizations (GNOME, shell configurations) and more operational tasks (DevOps, networking, security).
- Reusability & Backup Philosophy: The README reinforces that this is a backup repository and a personal record of “commands that make things work.” Thus, the design embraces reusability and version tracking of custom configurations.

##### Relevant Technologies, Frameworks, and Libraries
- OS Focus: Primarily on Linux with Fedora and Ubuntu customizations.
- Scripting Languages: Both Python and shell scripting are predominantly used.
- Networking & Virtualization: Elements such as GNS3 indicate familiarity with network emulation.
- Community Integrations: Although not a software component per se, the README’s links to Askubuntu, FedoraProject, etc., can be noted as external sources that influence development and troubleshooting.

- Branch from the central node into clusters:
- A “Customization Cluster” (with sub-nodes for GNOME, shell settings, boot, etc.)
- A “Scripting & Automation Cluster” (include all Python and Bash scripts here, linking them to their relevant configuration sources)
- A “DevOps & Admin Cluster” (link folders related to networking, security, sysAdmin on Linux/Windows, and bug tracking)
- Optionally, an “External Integrations” node (for GNS3 VM patching and any community influences)

## Diagram (Mermaid)

```mermaid
graph TD
    A["Repository Root"]:::repo

    subgraph "Customization Cluster"
        C1["Shell & Terminal Configuration"]:::customization
        C2["GNOME Customizations"]:::customization
        C3["Boot Configurations"]:::customization
        C4["Fedora 34 Begans"]:::customization
        C5["Fedora Packet Tracer"]:::customization
        C6["Ubuntu Customizations"]:::customization
    end

    subgraph "Scripting & Automation Cluster"
        SA1["Python Scripts"]:::automation
        subgraph "Python Scripts"
            SA1a["Patch GNS3VM for Cisco Routers.py"]:::automation
            SA1b["Remove Background Image.py"]:::automation
        end
        SA2["Bash Scripts"]:::automation
        subgraph "Bash Scripts"
            SA2a["bash_scripting"]:::automation
            SA2b["console script to download pdf"]:::automation
        end
    end

    subgraph "DevOps & Admin Cluster"
        D1["DevOps Tasks"]:::devops
        D2["Networking Configurations"]:::devops
        D3["Security Settings"]:::devops
        D4["Linux Administration"]:::devops
        D5["Windows Administration"]:::devops
        D6["Bug Tracking"]:::devops
    end

    subgraph "External Integration"
        EX["GNS3 VM Patching"]:::external
    end

    %% Relationships from Repository Root to clusters
    A -->|"organizes"| C1
    A -->|"organizes"| C2
    A -->|"organizes"| C3
    A -->|"organizes"| C4
    A -->|"organizes"| C5
    A -->|"organizes"| C6
    A -->|"organizes"| SA1a
    A -->|"organizes"| SA1b
    A -->|"organizes"| SA2a
    A -->|"organizes"| SA2b
    A -->|"organizes"| D1
    A -->|"organizes"| D2
    A -->|"organizes"| D3
    A -->|"organizes"| D4
    A -->|"organizes"| D5
    A -->|"organizes"| D6
    A -->|"organizes"| EX

    %% Cross-Cluster Relationships
    C1 -->|"configures"| SA1a
    C2 -->|"configures"| SA1b
    SA1a -->|"patches"| EX
    SA2 -->|"executes"| D1
    SA2 -->|"executes"| D2
    SA2 -->|"executes"| D3
    C3 -->|"influences"| SA2a
    C4 -->|"influences"| SA2b
    C6 -->|"influences"| D4

    %% Click Events
    click A "https://github.com/pranavbhattarai/linux101/tree/master/Repository Root Directory"
    click SA1a "https://github.com/pranavbhattarai/linux101/blob/master/Patch GNS3VM for Cisco Routers.py"
    click SA1b "https://github.com/pranavbhattarai/linux101/blob/master/Remove Background Image.py"
    click SA2a "https://github.com/pranavbhattarai/linux101/tree/master/bash_scripting"
    click SA2b "https://github.com/pranavbhattarai/linux101/tree/master/console script to download pdf"
    click C1 "https://github.com/pranavbhattarai/linux101/tree/master/configure shell & terminal"
    click C2 "https://github.com/pranavbhattarai/linux101/tree/master/custom perferences for GNOME"
    click C3 "https://github.com/pranavbhattarai/linux101/tree/master/boot"
    click C4 "https://github.com/pranavbhattarai/linux101/tree/master/fedora-34-begans"
    click C5 "https://github.com/pranavbhattarai/linux101/tree/master/making Packet Tracer work in Fedora"
    click C6 "https://github.com/pranavbhattarai/linux101/blob/master/ubuntu-18.04-begans"
    click D1 "https://github.com/pranavbhattarai/linux101/tree/master/DevOps"
    click D2 "https://github.com/pranavbhattarai/linux101/tree/master/networking"
    click D3 "https://github.com/pranavbhattarai/linux101/tree/master/security"
    click D4 "https://github.com/pranavbhattarai/linux101/tree/master/sysAdmin-Linux"
    click D5 "https://github.com/pranavbhattarai/linux101/tree/master/sysAdmin-Windows"
    click D6 "https://github.com/pranavbhattarai/linux101/tree/master/tracking-bugs"
    click EX "https://github.com/pranavbhattarai/linux101/blob/master/Patch GNS3VM for Cisco Routers.py"

    %% Styles
    classDef repo fill:#f2b880,stroke:#333,stroke-width:2px
    classDef customization fill:#cce5ff,stroke:#333,stroke-width:2px
    classDef automation fill:#d4edda,stroke:#333,stroke-width:2px
    classDef devops fill:#fff3cd,stroke:#333,stroke-width:2px
    classDef external fill:#f8d7da,stroke:#333,stroke-width:2px
```
