# catherinjoythattil/python-program architecture

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

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

## Overview

This repository is a collection of independent Python learning exercises, not one integrated application. Its user-to-result pattern is generally direct: a script prompts for input, performs a small calculation or transformation, and prints a result. The clearest stateful workflow is the library catalogue, which adds, displays, searches, and reports on books persisted in a text file. Other distinct examples cover account operations, billing, student marks, weather reports, web scraping, browser automation, and basic data manipulation. Relationships shown below are limited to those visible in read or excerpted files; many scripts remain uninspected.

Main entry points: [`Beautifulsoup.py`](https://github.com/catherinjoythattil/python-program/blob/main/Beautifulsoup.py) (News scraper), [`exp11.py`](https://github.com/catherinjoythattil/python-program/blob/main/exp11.py) (Library catalogue), [`Selenium.py`](https://github.com/catherinjoythattil/python-program/blob/main/Selenium.py) (Browser form demo), [`area.py`](https://github.com/catherinjoythattil/python-program/blob/main/area.py) (Area exercise)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_examples["Basic exercises"]
  node_area["Area exercise<br/>[area.py]"]
  node_charfreq["Character frequency<br/>[charfreq.py]"]
  node_charreplacement["Character replacement<br/>[charreplacement.py]"]
  node_exp7["Collections exercise<br/>[exp7.py]"]
  node_factorial["Factorial exercise<br/>[factorial.py]"]
  node_fibo["Fibonacci exercise<br/>[fibo.py]"]
  node_hello["Greeting exercise<br/>[hello.py]"]
  node_leapyear["Leap-year exercise<br/>[leapyear.py]"]
  node_list["List operations<br/>[list.py]"]
  node_listtuple["List and tuple<br/>[listtuple.py]"]
  node_number["Number exercise<br/>[number.py]"]
  node_palindrome["Palindrome exercise<br/>[palindrome.py]"]
  node_prime["Prime exercise<br/>[prime.py]"]
  node_reversal["Reversal exercise<br/>[reversal.py]"]
  node_wordfreq["Word frequency<br/>[wordfreq.py]"]
end

subgraph group_applications["Small applications"]
  node_bank["Bank account demo<br/>[bank.py]"]
  node_bill["Electricity billing<br/>[bill.py]"]
  node_library["Library catalogue<br/>[exp11.py]"]
  node_libraryfile["Catalogue records<br/>[library.txt]"]
  node_marks["Student marks report<br/>[mark.py]"]
  node_registration["Input validation<br/>[registration.py]"]
  node_weather["Weather report<br/>[weather.py]"]
end

subgraph group_web["Web and media"]
  node_scraper["News scraper<br/>[Beautifulsoup.py]"]
  node_headlines["Headlines CSV<br/>[news_headlines.csv]"]
  node_browser["Browser form demo<br/>[Selenium.py]"]
  node_image["Image processing<br/>[imageprocessing.py]"]
end

node_user(("User"))
node_bbc{{"BBC news site"}}
node_demoqa{{"DemoQA site"}}

node_user -->|"enters values"| node_area
node_user -->|"enters text"| node_charfreq
node_user -->|"enters text"| node_charreplacement
node_user -->|"enters data"| node_exp7
node_user -->|"enters value"| node_factorial
node_user -->|"enters value"| node_fibo
node_user -->|"runs exercise"| node_hello
node_user -->|"enters year"| node_leapyear
node_user -->|"enters values"| node_list
node_user -->|"enters values"| node_listtuple
node_user -->|"enters value"| node_number
node_user -->|"enters text"| node_palindrome
node_user -->|"enters value"| node_prime
node_user -->|"enters text"| node_reversal
node_user -->|"enters text"| node_wordfreq
node_user -->|"enters account data"| node_bank
node_user -->|"enters usage"| node_bill
node_user -->|"chooses operation"| node_library
node_library -->|"reads and writes"| node_libraryfile
node_user -->|"enters student marks"| node_marks
node_user -->|"enters details"| node_registration
node_user -->|"enters city data"| node_weather
node_user -->|"starts scrape"| node_scraper
node_scraper -->|"requests pages"| node_bbc
node_scraper -->|"writes results"| node_headlines
node_user -->|"starts demo"| node_browser
node_browser -->|"fills and submits"| node_demoqa
node_user -->|"enters pixels"| node_image

click node_area "https://github.com/catherinjoythattil/python-program/blob/main/area.py"
click node_charfreq "https://github.com/catherinjoythattil/python-program/blob/main/charfreq.py"
click node_charreplacement "https://github.com/catherinjoythattil/python-program/blob/main/charreplacement.py"
click node_exp7 "https://github.com/catherinjoythattil/python-program/blob/main/exp7.py"
click node_factorial "https://github.com/catherinjoythattil/python-program/blob/main/factorial.py"
click node_fibo "https://github.com/catherinjoythattil/python-program/blob/main/fibo.py"
click node_hello "https://github.com/catherinjoythattil/python-program/blob/main/hello.py"
click node_leapyear "https://github.com/catherinjoythattil/python-program/blob/main/leapyear.py"
click node_list "https://github.com/catherinjoythattil/python-program/blob/main/list.py"
click node_listtuple "https://github.com/catherinjoythattil/python-program/blob/main/listtuple.py"
click node_number "https://github.com/catherinjoythattil/python-program/blob/main/number.py"
click node_palindrome "https://github.com/catherinjoythattil/python-program/blob/main/palindrome.py"
click node_prime "https://github.com/catherinjoythattil/python-program/blob/main/prime.py"
click node_reversal "https://github.com/catherinjoythattil/python-program/blob/main/reversal.py"
click node_wordfreq "https://github.com/catherinjoythattil/python-program/blob/main/wordfreq.py"
click node_bank "https://github.com/catherinjoythattil/python-program/blob/main/bank.py"
click node_bill "https://github.com/catherinjoythattil/python-program/blob/main/bill.py"
click node_library "https://github.com/catherinjoythattil/python-program/blob/main/exp11.py"
click node_libraryfile "https://github.com/catherinjoythattil/python-program/blob/main/library.txt"
click node_marks "https://github.com/catherinjoythattil/python-program/blob/main/mark.py"
click node_registration "https://github.com/catherinjoythattil/python-program/blob/main/registration.py"
click node_weather "https://github.com/catherinjoythattil/python-program/blob/main/weather.py"
click node_scraper "https://github.com/catherinjoythattil/python-program/blob/main/Beautifulsoup.py"
click node_headlines "https://github.com/catherinjoythattil/python-program/blob/main/news_headlines.csv"
click node_browser "https://github.com/catherinjoythattil/python-program/blob/main/Selenium.py"
click node_image "https://github.com/catherinjoythattil/python-program/blob/main/imageprocessing.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_area,node_charfreq,node_charreplacement,node_exp7,node_factorial,node_fibo,node_hello,node_leapyear,node_list,node_listtuple,node_number,node_palindrome,node_prime,node_reversal,node_wordfreq,node_user toneBlue
class node_bank,node_bill,node_library,node_libraryfile,node_marks,node_registration,node_weather toneAmber
class node_scraper,node_headlines,node_browser,node_image toneMint
class node_bbc,node_demoqa toneIndigo
```

## Components

### Basic exercises

- [Area exercise](https://github.com/catherinjoythattil/python-program/blob/main/area.py): `area.py`
- [Character frequency](https://github.com/catherinjoythattil/python-program/blob/main/charfreq.py): `charfreq.py`
- [Character replacement](https://github.com/catherinjoythattil/python-program/blob/main/charreplacement.py): `charreplacement.py`
- [Collections exercise](https://github.com/catherinjoythattil/python-program/blob/main/exp7.py): `exp7.py`
- [Factorial exercise](https://github.com/catherinjoythattil/python-program/blob/main/factorial.py): `factorial.py`
- [Fibonacci exercise](https://github.com/catherinjoythattil/python-program/blob/main/fibo.py): `fibo.py`
- [Greeting exercise](https://github.com/catherinjoythattil/python-program/blob/main/hello.py): `hello.py`
- [Leap-year exercise](https://github.com/catherinjoythattil/python-program/blob/main/leapyear.py): `leapyear.py`
- [List operations](https://github.com/catherinjoythattil/python-program/blob/main/list.py): `list.py`
- [List and tuple](https://github.com/catherinjoythattil/python-program/blob/main/listtuple.py): `listtuple.py`
- [Number exercise](https://github.com/catherinjoythattil/python-program/blob/main/number.py): `number.py`
- [Palindrome exercise](https://github.com/catherinjoythattil/python-program/blob/main/palindrome.py): `palindrome.py`
- [Prime exercise](https://github.com/catherinjoythattil/python-program/blob/main/prime.py): `prime.py`
- [Reversal exercise](https://github.com/catherinjoythattil/python-program/blob/main/reversal.py): `reversal.py`
- [Word frequency](https://github.com/catherinjoythattil/python-program/blob/main/wordfreq.py): `wordfreq.py`

### Small applications

- [Bank account demo](https://github.com/catherinjoythattil/python-program/blob/main/bank.py): `bank.py`
- [Electricity billing](https://github.com/catherinjoythattil/python-program/blob/main/bill.py): `bill.py`
- [Library catalogue](https://github.com/catherinjoythattil/python-program/blob/main/exp11.py): `exp11.py`
- [Catalogue records](https://github.com/catherinjoythattil/python-program/blob/main/library.txt): `library.txt`
- [Student marks report](https://github.com/catherinjoythattil/python-program/blob/main/mark.py): `mark.py`
- [Input validation](https://github.com/catherinjoythattil/python-program/blob/main/registration.py): `registration.py`
- [Weather report](https://github.com/catherinjoythattil/python-program/blob/main/weather.py): `weather.py`

### Web and media

- [News scraper](https://github.com/catherinjoythattil/python-program/blob/main/Beautifulsoup.py): `Beautifulsoup.py`
- [Headlines CSV](https://github.com/catherinjoythattil/python-program/blob/main/news_headlines.csv): `news_headlines.csv`
- [Browser form demo](https://github.com/catherinjoythattil/python-program/blob/main/Selenium.py): `Selenium.py`
- [Image processing](https://github.com/catherinjoythattil/python-program/blob/main/imageprocessing.py): `imageprocessing.py`

### Other components

- **User**
- **BBC news site**
- **DemoQA site**

## Connections

- User → Area exercise: enters values (evidence: `area.py`)
- User → Character frequency: enters text (evidence: `charfreq.py`)
- User → Character replacement: enters text (evidence: `charreplacement.py`)
- User → Collections exercise: enters data (evidence: `exp7.py`)
- User → Factorial exercise: enters value (evidence: `factorial.py`)
- User → Fibonacci exercise: enters value (evidence: `fibo.py`)
- User → Greeting exercise: runs exercise (evidence: `hello.py`)
- User → Leap-year exercise: enters year (evidence: `leapyear.py`)
- User → List operations: enters values (evidence: `list.py`)
- User → List and tuple: enters values (evidence: `listtuple.py`)
- User → Number exercise: enters value (evidence: `number.py`)
- User → Palindrome exercise: enters text (evidence: `palindrome.py`)
- User → Prime exercise: enters value (evidence: `prime.py`)
- User → Reversal exercise: enters text (evidence: `reversal.py`)
- User → Word frequency: enters text (evidence: `wordfreq.py`)
- User → Bank account demo: enters account data (evidence: `bank.py`)
- User → Electricity billing: enters usage (evidence: `bill.py`)
- User → Library catalogue: chooses operation (evidence: `exp11.py`)
- Library catalogue → Catalogue records: reads and writes (evidence: `exp11.py`)
- User → Student marks report: enters student marks (evidence: `mark.py`)
- User → Input validation: enters details (evidence: `registration.py`)
- User → Weather report: enters city data (evidence: `weather.py`)
- User → News scraper: starts scrape (evidence: `Beautifulsoup.py`)
- News scraper → BBC news site: requests pages (evidence: `Beautifulsoup.py`)
- News scraper → Headlines CSV: writes results (evidence: `Beautifulsoup.py`)
- User → Browser form demo: starts demo (evidence: `Selenium.py`)
- Browser form demo → DemoQA site: fills and submits (evidence: `Selenium.py`)
- User → Image processing: enters pixels (evidence: `imageprocessing.py`)
