# zobiamatloob/python architecture

> Architecture diagram of the GitHub repository zobiamatloob/python, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zobiamatloob/python
- Repository: https://github.com/zobiamatloob/python

## Overview

This repository is a collection of standalone Python learning examples, with a grocery billing script as its most complete user-facing workflow. A shopper enters three items and quantities; the script looks up prices, calculates a subtotal and discount, and prints a receipt. Other scripts demonstrate core Python concepts rather than forming a shared application. The billing stages are represented separately but all live in one file. The broader lesson map is based on filenames; only the billing and selected lesson examples were sampled.

Main entry points: [`Grocery Billing System.py`](https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py) (Item costs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_billing["Grocery billing"]
  node_capture["Item entry"]
  node_menu["Price menu"]
  node_lookup["Price lookup"]
  node_costs["Item costs"]
  node_cart["Cart records"]
  node_discount["Discount total"]
  node_receipt["Receipt output"]
end

subgraph group_lessons["Python lessons"]
  node_values["Values and types<br/>[Data types.py]"]
  node_operators["Operators<br/>[operator.py]"]
  node_conditionals["Conditionals"]
  node_loops["Loops<br/>[For loop.py]"]
  node_functions["Functions and arguments<br/>[Functions.py]"]
  node_collections["Collections<br/>[dictionary.py]"]
  node_inputoutput["Input and output"]
  node_files["File handling<br/>[file handling.py]"]
  node_objects["Classes and objects"]
end

node_shopper(("Shopper"))

node_shopper -->|"enters items"| node_capture
node_capture -->|"provides names"| node_lookup
node_menu -->|"supplies prices"| node_lookup
node_lookup -->|"returns prices"| node_costs
node_costs -->|"records purchases"| node_cart
node_costs -->|"provides subtotal"| node_discount
node_cart -->|"prints details"| node_receipt
node_discount -->|"prints totals"| node_receipt

click node_capture "https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py"
click node_menu "https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py"
click node_lookup "https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py"
click node_costs "https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py"
click node_cart "https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py"
click node_discount "https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py"
click node_receipt "https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py"
click node_values "https://github.com/zobiamatloob/python/blob/main/Data%20types.py"
click node_operators "https://github.com/zobiamatloob/python/blob/main/operator.py"
click node_conditionals "https://github.com/zobiamatloob/python/blob/main/Conditionals%20Part%202%20.py"
click node_loops "https://github.com/zobiamatloob/python/blob/main/For%20loop.py"
click node_functions "https://github.com/zobiamatloob/python/blob/main/Functions.py"
click node_collections "https://github.com/zobiamatloob/python/blob/main/dictionary.py"
click node_inputoutput "https://github.com/zobiamatloob/python/blob/main/input%20%20and%20output%20in%20python.py"
click node_files "https://github.com/zobiamatloob/python/blob/main/file%20handling.py"
click node_objects "https://github.com/zobiamatloob/python/blob/main/classes%20and%20objects.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_capture,node_menu,node_lookup,node_costs,node_cart,node_discount,node_receipt toneBlue
class node_values,node_operators,node_conditionals,node_loops,node_functions,node_collections,node_inputoutput,node_files,node_objects toneAmber
class node_shopper toneIndigo
```

## Components

### Grocery billing

- [Item entry](https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py): `Grocery Billing System.py`
- [Price menu](https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py): `Grocery Billing System.py`
- [Price lookup](https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py): `Grocery Billing System.py`
- [Item costs](https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py): `Grocery Billing System.py`
- [Cart records](https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py): `Grocery Billing System.py`
- [Discount total](https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py): `Grocery Billing System.py`
- [Receipt output](https://github.com/zobiamatloob/python/blob/main/Grocery%20Billing%20System.py): `Grocery Billing System.py`

### Python lessons

- [Values and types](https://github.com/zobiamatloob/python/blob/main/Data%20types.py): `Data types.py`
- [Operators](https://github.com/zobiamatloob/python/blob/main/operator.py): `operator.py`
- [Conditionals](https://github.com/zobiamatloob/python/blob/main/Conditionals%20Part%202%20.py): `Conditionals Part 2 .py`
- [Loops](https://github.com/zobiamatloob/python/blob/main/For%20loop.py): `For loop.py`
- [Functions and arguments](https://github.com/zobiamatloob/python/blob/main/Functions.py): `Functions.py`
- [Collections](https://github.com/zobiamatloob/python/blob/main/dictionary.py): `dictionary.py`
- [Input and output](https://github.com/zobiamatloob/python/blob/main/input%20%20and%20output%20in%20python.py): `input and output in python.py`
- [File handling](https://github.com/zobiamatloob/python/blob/main/file%20handling.py): `file handling.py`
- [Classes and objects](https://github.com/zobiamatloob/python/blob/main/classes%20and%20objects.py): `classes and objects.py`

### Other components

- **Shopper**

## Connections

- Shopper → Item entry: enters items
- Item entry → Price lookup: provides names
- Price menu → Price lookup: supplies prices
- Price lookup → Item costs: returns prices
- Item costs → Cart records: records purchases
- Item costs → Discount total: provides subtotal
- Cart records → Receipt output: prints details
- Discount total → Receipt output: prints totals
