# echobash/30_days_of_data_structure architecture

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

- Interactive diagram: https://gitdiagram.com/echobash/30_days_of_data_structure
- Repository: https://github.com/echobash/30_days_of_data_structure

## Overview

##### Project type and purpose
- This is a monolithic, language-centric code library for learning and practicing Python algorithms, data structures, OOP, and design patterns.
- There is no running front end or external service—everything executes in a local Python runtime.

##### File structure
- Top-level “components” are your category folders:
– LLD (Low-Level Design): design patterns and OOP examples
– Maths, Patterns, Sorting, Array, BinarySearch, Graph, Hashing, Set, String, Tree: algorithm exercises
– Other Concepts (Loops, Recursion, Python Profiling)
- README.md describes each category and how to run code.
- No external databases or message queues; minimal dependencies.

##### Main components
a. Git Repository (source control)
b. Local Developer Machine / IDE (where code is cloned, edited, executed)
c. Python Runtime Environment (interpreter, virtualenv)
d. Code Modules (each category as a sub-component)
– LLD
– Algorithms: Maths, Patterns, Sorting, Array, BinarySearch, Graph, Hashing, Set, String, Tree
– Utilities: Loops, Recursion, Python Profiling
e. README / Documentation

##### Relationships and interactions
- The Developer clones/pulls from Git Repository.
- The Python Runtime imports files from each code module.
- The Developer runs a specific script via `python <module>/<file>.py`.
- README guides the Developer to locate and execute examples.

##### Architectural patterns or design principles
- Logical separation by topic—the “package” pattern (monolith subdivided into feature packages).
- Algorithm folders have naming conventions (brute force vs optimized variants).

##### Final checklist
- Clear, distinct labels on every component
- Call out the README as the entry point for usage guidance
- Sub-structure in LLD (e.g., “Design Patterns” vs “Oops/interface_and_abc”)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Entities
    Dev["Developer / IDE"]:::ext
    Python["Python Runtime"]:::runtime

    %% Repository Container
    subgraph "Python Practice Playground (Git Repo)" 
        Git["Git Repository"]:::repo
        README["README.md"]:::repo

        subgraph "LLD (Low-Level Design)" 
            DP["Design Patterns"]:::lld
            OOPS["Oops / Interface & ABC"]:::lld
            TTTA["Tic Tac Toe"]:::lld
        end

        subgraph "Algorithms" 
            Maths["Maths"]:::alg
            Patterns["Patterns"]:::alg
            Sorting["Sorting"]:::alg
            Array["Array"]:::alg
            BinarySearch["BinarySearch"]:::alg
            Graph["Graph"]:::alg
            Hashing["Hashing"]:::alg
            Set["Set"]:::alg
            String["String"]:::alg
            Tree["Tree"]:::alg
        end

        subgraph "Utilities"
            Loops["Loops (loops.py)"]:::util
            Recursion["Recursion"]:::util
            Profiling["Python Profiling"]:::util
        end
    end

    %% Connections
    Dev -->|"clone / pull"| Git
    Dev -->|"execute scripts"| Python
    Python -->|"imports / runs code"| DP
    Python -->|"imports / runs code"| OOPS
    Python -->|"imports / runs code"| TTTA
    Python -->|"imports / runs code"| Maths
    Python -->|"imports / runs code"| Patterns
    Python -->|"imports / runs code"| Sorting
    Python -->|"imports / runs code"| Array
    Python -->|"imports / runs code"| BinarySearch
    Python -->|"imports / runs code"| Graph
    Python -->|"imports / runs code"| Hashing
    Python -->|"imports / runs code"| Set
    Python -->|"imports / runs code"| String
    Python -->|"imports / runs code"| Tree
    Python -->|"imports / runs code"| Loops
    Python -->|"imports / runs code"| Recursion
    Python -->|"imports / runs code"| Profiling

    %% Click Events
    click Git "https://github.com/echobash/30_days_of_data_structure/blob/main/."
    click README "https://github.com/echobash/30_days_of_data_structure/blob/main/README.md"
    click DP "https://github.com/echobash/30_days_of_data_structure/tree/main/LLD/Design Patterns/"
    click OOPS "https://github.com/echobash/30_days_of_data_structure/tree/main/LLD/Oops/"
    click TTTA "https://github.com/echobash/30_days_of_data_structure/tree/main/LLD/Tic Tac Toe/"
    click Maths "https://github.com/echobash/30_days_of_data_structure/tree/main/Maths/"
    click Patterns "https://github.com/echobash/30_days_of_data_structure/tree/main/Patterns/"
    click Sorting "https://github.com/echobash/30_days_of_data_structure/tree/main/Sorting/"
    click Array "https://github.com/echobash/30_days_of_data_structure/tree/main/array/"
    click BinarySearch "https://github.com/echobash/30_days_of_data_structure/tree/main/binarysearch/"
    click Graph "https://github.com/echobash/30_days_of_data_structure/tree/main/graph/"
    click Hashing "https://github.com/echobash/30_days_of_data_structure/tree/main/hashing/"
    click Set "https://github.com/echobash/30_days_of_data_structure/tree/main/Set/"
    click String "https://github.com/echobash/30_days_of_data_structure/tree/main/string/"
    click Tree "https://github.com/echobash/30_days_of_data_structure/tree/main/tree/"
    click Loops "https://github.com/echobash/30_days_of_data_structure/blob/main/Loops/loops.py"
    click Recursion "https://github.com/echobash/30_days_of_data_structure/tree/main/recursion/"
    click Profiling "https://github.com/echobash/30_days_of_data_structure/tree/main/pythonprofiling/"

    %% Styles
    classDef ext fill:#ffd1dc,stroke:#d6336c,stroke-width:2px
    classDef runtime fill:#ffe5b4,stroke:#d9822b,stroke-width:2px
    classDef repo fill:#f0f0f0,stroke:#999999,stroke-width:2px
    classDef lld fill:#cce5ff,stroke:#3399ff,stroke-width:2px
    classDef alg fill:#d4edda,stroke:#28a745,stroke-width:2px
    classDef util fill:#fff3cd,stroke:#ffc107,stroke-width:2px
```
