# sarismejiasanchez/python-programming architecture

> Architecture diagram of the GitHub repository sarismejiasanchez/python-programming, 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/sarismejiasanchez/python-programming
- Repository: https://github.com/sarismejiasanchez/python-programming

## Overview

##### Main Components
- Lesson Modules: Since the project is organized as multiple Python scripts with numeric prefixes (e.g., 1_hello_world.py, 2_python_syntax.py, … 29_file_ops.py), consider each file (or grouping related files) as a module covering a specific topic or exercise.
- Supporting Material: There are ancillary text files (newfile.txt, petnames.txt, sampletext.txt) that likely serve as sample inputs or resources for some lessons.
- Configuration/Repository: Although minimal, the .gitignore and README provide additional project context and should be noted as meta-information supporting the project structure.

##### Structure and Relationships
- Basics & Syntax: Files like 1_hello_world.py, 2_python_syntax.py, 3_variables.py, 4_data_types.py, 5_strings.py, etc.
- Control Flow and Logic: Files dealing with conditionals, loops, error handling (10_conditional.py, 12_loops.py, 13_nesteed_loops.py, 14_exercise_control_flows_loops.py, 25_errors_exceptions.py).
- Functions and Data Structures: Files such as 15_functions.py, 16_variable_scope.py, 17_data_structures.py, 18_lists.py, 19_tuples.py, 20_sets.py, 21_dictionaries.py, 22_args.py, 22_kwargs.py, 23_choose_use_data_structures.py.
- File Handling: Files like 26_file_handling.py, 27_creating_files.py, 28_reading_files.py, 29_file_ops.py.
- Advanced or Special Topics: For instance, 11_match.py and 24_ordering_system.py, which might introduce newer language features or a comprehensive example.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Introduction & Setup
    subgraph "Introduction & Setup"
        intro1["1_hello_world.py"]:::lesson
        intro2["2_python_syntax.py"]:::lesson
    end

    %% Basics & Syntax
    subgraph "Basics & Syntax"
        basics3["3_variables.py"]:::lesson
        basics4["4_data_types.py"]:::lesson
        basics5["5_strings.py"]:::lesson
        basics6["6_type_casting.py"]:::lesson
        basics7["7_input_output.py"]:::lesson
        basics8["8_exercise1.py"]:::lesson
        basics8b["8_exercise2.py"]:::lesson
        basics9["9_operators.py"]:::lesson
    end

    %% Control Flow and Logic
    subgraph "Control Flow and Logic"
        cf10["10_conditional.py"]:::lesson
        cf12["12_loops.py"]:::lesson
        cf13["13_nesteed_loops.py"]:::lesson
        cf14["14_exercise_control_flows_loops.py"]:::lesson
        cf25["25_errors_exceptions.py"]:::lesson
    end

    %% Functions and Data Structures
    subgraph "Functions and Data Structures"
        fd15["15_functions.py"]:::lesson
        fd16["16_variable_scope.py"]:::lesson
        fd17["17_data_structures.py"]:::lesson
        fd18["18_lists.py"]:::lesson
        fd19["19_tuples.py"]:::lesson
        fd20["20_sets.py"]:::lesson
        fd21["21_dictionaries.py"]:::lesson
        fd22a["22_args.py"]:::lesson
        fd22b["22_kwargs.py"]:::lesson
        fd23["23_choose_use_data_structures.py"]:::lesson
    end

    %% File Handling
    subgraph "File Handling"
        fh26["26_file_handling.py"]:::lesson
        fh27["27_creating_files.py"]:::lesson
        fh28["28_reading_files.py"]:::lesson
        fh29["29_file_ops.py"]:::lesson
    end

    %% Advanced or Special Topics
    subgraph "Advanced or Special Topics"
        adv11["11_match.py"]:::lesson
        adv24["24_ordering_system.py"]:::lesson
    end

    %% Supporting Material
    subgraph "Supporting Material"
        supp_new["newfile.txt"]:::resource
        supp_pet["petnames.txt"]:::resource
        supp_sample["sampletext.txt"]:::resource
    end

    %% Configuration/Repository
    subgraph "Configuration/Repository"
        config_git[".gitignore"]:::resource
        config_readme["README.md"]:::resource
    end

    %% Learning Flow Connections
    intro2 -->|"next"| basics3
    basics9 -->|"next"| cf10
    cf25 -->|"next"| fd15
    fd23 -->|"next"| fh26
    fh29 -->|"next"| adv11

    %% Supporting resources linked to the learning modules
    config_git --- intro1
    config_readme --- intro1
    supp_new --- basics3
    supp_pet --- basics3
    supp_sample --- basics3

    %% Click Events for Introduction & Setup
    click intro1 "https://github.com/sarismejiasanchez/python-programming/blob/main/1_hello_world.py"
    click intro2 "https://github.com/sarismejiasanchez/python-programming/blob/main/2_python_syntax.py"

    %% Click Events for Basics & Syntax
    click basics3 "https://github.com/sarismejiasanchez/python-programming/blob/main/3_variables.py"
    click basics4 "https://github.com/sarismejiasanchez/python-programming/blob/main/4_data_types.py"
    click basics5 "https://github.com/sarismejiasanchez/python-programming/blob/main/5_strings.py"
    click basics6 "https://github.com/sarismejiasanchez/python-programming/blob/main/6_type_casting.py"
    click basics7 "https://github.com/sarismejiasanchez/python-programming/blob/main/7_input_output.py"
    click basics8 "https://github.com/sarismejiasanchez/python-programming/blob/main/8_exercise1.py"
    click basics8b "https://github.com/sarismejiasanchez/python-programming/blob/main/8_exercise2.py"
    click basics9 "https://github.com/sarismejiasanchez/python-programming/blob/main/9_operators.py"

    %% Click Events for Control Flow and Logic
    click cf10 "https://github.com/sarismejiasanchez/python-programming/blob/main/10_conditional.py"
    click cf12 "https://github.com/sarismejiasanchez/python-programming/blob/main/12_loops.py"
    click cf13 "https://github.com/sarismejiasanchez/python-programming/blob/main/13_nesteed_loops.py"
    click cf14 "https://github.com/sarismejiasanchez/python-programming/blob/main/14_exercise_control_flows_loops.py"
    click cf25 "https://github.com/sarismejiasanchez/python-programming/blob/main/25_errors_exceptions.py"

    %% Click Events for Functions and Data Structures
    click fd15 "https://github.com/sarismejiasanchez/python-programming/blob/main/15_functions.py"
    click fd16 "https://github.com/sarismejiasanchez/python-programming/blob/main/16_variable_scope.py"
    click fd17 "https://github.com/sarismejiasanchez/python-programming/blob/main/17_data_structures.py"
    click fd18 "https://github.com/sarismejiasanchez/python-programming/blob/main/18_lists.py"
    click fd19 "https://github.com/sarismejiasanchez/python-programming/blob/main/19_tuples.py"
    click fd20 "https://github.com/sarismejiasanchez/python-programming/blob/main/20_sets.py"
    click fd21 "https://github.com/sarismejiasanchez/python-programming/blob/main/21_dictionaries.py"
    click fd22a "https://github.com/sarismejiasanchez/python-programming/blob/main/22_args.py"
    click fd22b "https://github.com/sarismejiasanchez/python-programming/blob/main/22_kwargs.py"
    click fd23 "https://github.com/sarismejiasanchez/python-programming/blob/main/23_choose_use_data_structures.py"

    %% Click Events for File Handling
    click fh26 "https://github.com/sarismejiasanchez/python-programming/blob/main/26_file_handling.py"
    click fh27 "https://github.com/sarismejiasanchez/python-programming/blob/main/27_creating_files.py"
    click fh28 "https://github.com/sarismejiasanchez/python-programming/blob/main/28_reading_files.py"
    click fh29 "https://github.com/sarismejiasanchez/python-programming/blob/main/29_file_ops.py"

    %% Click Events for Advanced or Special Topics
    click adv11 "https://github.com/sarismejiasanchez/python-programming/blob/main/11_match.py"
    click adv24 "https://github.com/sarismejiasanchez/python-programming/blob/main/24_ordering_system.py"

    %% Click Events for Supporting Material
    click supp_new "https://github.com/sarismejiasanchez/python-programming/blob/main/newfile.txt"
    click supp_pet "https://github.com/sarismejiasanchez/python-programming/blob/main/petnames.txt"
    click supp_sample "https://github.com/sarismejiasanchez/python-programming/blob/main/sampletext.txt"

    %% Click Events for Configuration/Repository
    click config_git "https://github.com/sarismejiasanchez/python-programming/blob/main/.gitignore"
    click config_readme "https://github.com/sarismejiasanchez/python-programming/blob/main/README.md"

    %% Class Styles
    classDef lesson fill:#BBDEFB,stroke:#0D47A1,stroke-width:2px;
    classDef resource fill:#FFECB3,stroke:#F57F17,stroke-width:2px;
```
