# prof-rajeshs/level_1-python-programs architecture
> Architecture diagram of the GitHub repository prof-rajeshs/level_1-python-programs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-08-13). It is an AI-made overview: check details against the source.
- Interactive diagram: https://gitdiagram.com/prof-rajeshs/level_1-python-programs
- Repository: https://github.com/prof-rajeshs/level_1-python-programs
## Overview
#### Purpose and Shape
This is a collection of standalone Python learning exercises with solutions, organized into two difficulty tiers. It is not an integrated application or package: each `.py` file is an independent executable example/problem solution.
#### Entry Points
Each problem file is a direct Python entry point, intended to be run individually with the Python interpreter. Representative files include:
- `Level_1_Python Program with solutions/Level_1_Problem_01.py`
- `Level_1_Python Program with solutions/Level_1_problem_27.py`
- `Level 2 Python Program with solutions/Level_2_Program_01.py`
There is no visible central launcher, importable application module, CLI dispatcher, or orchestration layer.
#### Level 1 Exercise Set
The primary beginner curriculum resides in `Level_1_Python Program with solutions/`. It contains numbered problem implementations, largely spanning 1–35:
- `Level_1_Python Program with solutions/Level_1_Problem_01.py`
- `Level_1_Python Program with solutions/Level_1_Problem_16.py`
- `Level_1_Python Program with solutions/Level_1_Problem_35.py`
Numbering is convention-based rather than enforced by a manifest; problem 27 uses a lowercase filename segment (`Level_1_problem_27.py`), which matters for case-sensitive paths.
#### Level 2 Exercise Set
More advanced exercises are isolated in `Level 2 Python Program with solutions/`, with programs numbered 1–16:
- `Level 2 Python Program with solutions/Level_2_Program_01.py`
- `Level 2 Python Program with solutions/Level_2_Program_08.py`
- `Level 2 Python Program with solutions/Level_2_Program_16.py`
This directory is a peer collection to Level 1, not a dependency layer or package extension.
#### Execution and Data Flow
The expected control flow is per-file: a user selects an exercise, executes its script, supplies any runtime input requested by that script, and receives output through the terminal. Inputs, intermediate values, and outputs are local to a single program invocation; no shared persistence, inter-problem data flow, or reusable domain model is evident from the repository layout.
#### Boundaries and Runtime
The material runtime is Python. The repository contains no dependency manifest, framework structure, container/deployment assets, database schema, API client layer, cloud infrastructure, or external-service integration. `README.md` is present but supplied without content, so the directory names and script naming establish the usable navigation and curriculum boundaries.
#### Maintenance Implications
Treat every numbered script as independently owned and runnable. Cross-cutting changes—such as a common runner, shared utilities, tests, or packaging—would be new architecture rather than modification of an existing platform. Preserve directory names with spaces and the Level 1/Level 2 separation because they are the repository’s effective organization and discovery mechanism.
Main entry points: [`README.md`](https://github.com/prof-rajeshs/level_1-python-programs/blob/main/README.md) (README), [`Level_1_Python Program with solutions/Level_1_Problem_01.py`](https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level_1_Python%20Program%20with%20solutions/Level_1_Problem_01.py) (Problem 01), [`Level_1_Python Program with solutions/Level_1_Problem_16.py`](https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level_1_Python%20Program%20with%20solutions/Level_1_Problem_16.py) (Problem 16), [`Level_1_Python Program with solutions/Level_1_problem_27.py`](https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level_1_Python%20Program%20with%20solutions/Level_1_problem_27.py) (Problem 27)
## Diagram (Mermaid)
```mermaid
flowchart TD
subgraph group_level1["Level 1 exercises"]
node_level1_set["Numbered problem set
exercise collection"]
node_level1_01["Problem 01
Python entry point"]
node_level1_16["Problem 16
Python entry point"]
node_level1_27["Problem 27
Python entry point"]
node_level1_35["Problem 35
Python entry point"]
end
subgraph group_level2["Level 2 exercises"]
node_level2_set["Numbered program set
exercise collection"]
node_level2_01["Program 01
Python entry point"]
node_level2_08["Program 08
Python entry point"]
node_level2_16["Program 16
Python entry point"]
end
node_user(("Learner
user"))
node_python{{"Python interpreter
runtime"}}
node_terminal["Terminal I/O
interface"]
node_readme["README
documentation
[README.md]"]
node_readme -.->|"documents"| node_level1_set
node_readme -.->|"documents"| node_level2_set
node_level1_set -->|"contains"| node_level1_01
node_level1_set -->|"contains"| node_level1_16
node_level1_set -->|"contains"| node_level1_27
node_level1_set -->|"contains"| node_level1_35
node_level2_set -->|"contains"| node_level2_01
node_level2_set -->|"contains"| node_level2_08
node_level2_set -->|"contains"| node_level2_16
node_user -->|"selects exercise"| node_level1_set
node_user -->|"selects exercise"| node_level2_set
node_level1_01 -->|"executed by"| node_python
node_level1_16 -->|"executed by"| node_python
node_level1_27 -->|"executed by"| node_python
node_level1_35 -->|"executed by"| node_python
node_level2_01 -->|"executed by"| node_python
node_level2_08 -->|"executed by"| node_python
node_level2_16 -->|"executed by"| node_python
node_python -->|"reads input and writes output"| node_terminal
click node_readme "https://github.com/prof-rajeshs/level_1-python-programs/blob/main/README.md"
click node_level1_01 "https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level_1_Python%20Program%20with%20solutions/Level_1_Problem_01.py"
click node_level1_16 "https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level_1_Python%20Program%20with%20solutions/Level_1_Problem_16.py"
click node_level1_27 "https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level_1_Python%20Program%20with%20solutions/Level_1_problem_27.py"
click node_level1_35 "https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level_1_Python%20Program%20with%20solutions/Level_1_Problem_35.py"
click node_level2_01 "https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level%202%20Python%20Program%20with%20solutions/Level_2_Program_01.py"
click node_level2_08 "https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level%202%20Python%20Program%20with%20solutions/Level_2_Program_08.py"
click node_level2_16 "https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level%202%20Python%20Program%20with%20solutions/Level_2_Program_16.py"
classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_level1_set,node_level1_01,node_level1_16,node_level1_27,node_level1_35 toneBlue
class node_level2_set,node_level2_01,node_level2_08,node_level2_16 toneAmber
class node_user,node_python,node_terminal,node_readme toneNeutral
```
## Components
### Level 1 exercises
Beginner standalone Python problems.
- **Numbered problem set**: exercise collection · Conventionally numbered Level 1 scripts, largely 1–35.
- [Problem 01](https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level_1_Python%20Program%20with%20solutions/Level_1_Problem_01.py): Python entry point · `Level_1_Python Program with solutions/Level_1_Problem_01.py`
- [Problem 16](https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level_1_Python%20Program%20with%20solutions/Level_1_Problem_16.py): Python entry point · `Level_1_Python Program with solutions/Level_1_Problem_16.py`
- [Problem 27](https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level_1_Python%20Program%20with%20solutions/Level_1_problem_27.py): Python entry point · Lowercase filename segment is intentional. · `Level_1_Python Program with solutions/Level_1_problem_27.py`
- [Problem 35](https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level_1_Python%20Program%20with%20solutions/Level_1_Problem_35.py): Python entry point · `Level_1_Python Program with solutions/Level_1_Problem_35.py`
### Level 2 exercises
Advanced standalone Python problems.
- **Numbered program set**: exercise collection · Conventionally numbered Level 2 scripts, 1–16.
- [Program 01](https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level%202%20Python%20Program%20with%20solutions/Level_2_Program_01.py): Python entry point · `Level 2 Python Program with solutions/Level_2_Program_01.py`
- [Program 08](https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level%202%20Python%20Program%20with%20solutions/Level_2_Program_08.py): Python entry point · `Level 2 Python Program with solutions/Level_2_Program_08.py`
- [Program 16](https://github.com/prof-rajeshs/level_1-python-programs/blob/main/Level%202%20Python%20Program%20with%20solutions/Level_2_Program_16.py): Python entry point · `Level 2 Python Program with solutions/Level_2_Program_16.py`
### Other components
- **Learner**: user
- **Python interpreter**: runtime · Runs each selected script independently.
- **Terminal I/O**: interface · Accepts script input and displays output.
- [README](https://github.com/prof-rajeshs/level_1-python-programs/blob/main/README.md): documentation · Repository navigation context. · `README.md`
## Connections
- README → Numbered problem set: documents
- README → Numbered program set: documents
- Numbered problem set → Problem 01: contains
- Numbered problem set → Problem 16: contains
- Numbered problem set → Problem 27: contains
- Numbered problem set → Problem 35: contains
- Numbered program set → Program 01: contains
- Numbered program set → Program 08: contains
- Numbered program set → Program 16: contains
- Learner → Numbered problem set: selects exercise
- Learner → Numbered program set: selects exercise
- Problem 01 → Python interpreter: executed by
- Problem 16 → Python interpreter: executed by
- Problem 27 → Python interpreter: executed by
- Problem 35 → Python interpreter: executed by
- Program 01 → Python interpreter: executed by
- Program 08 → Python interpreter: executed by
- Program 16 → Python interpreter: executed by
- Python interpreter → Terminal I/O: reads input and writes output · All values remain local to one script invocation.